C&C 뷰와 그 노테이션

메인테이너가 다른 프로젝트(A-Cert)의 아키텍처 정의서를 보여 주며: “저는 C&C View가 눈에 뜨입니다. 처음 우리 문서를 보는 사람에게 전체적인 모습을 쉽게 설명할 수 있을 것 같아요.”(2026-11-17). 그때 정리한 것을 적는다. 우리 그림은 3. 실행 중의 모습에 있다.

한 줄 요약

C&C(Component & Connector) 뷰는 프로그램이 돌고 있을 때 무엇이 살아 있고(컴포넌트), 그것들이 어떤 방식으로 이야기하는지(커넥터)를 그린다. 코드가 무엇을 import하는지(모듈 뷰, 패키지 그림)와는 다른 질문에 답한다.

세 가지 뷰

아키텍처 문서는 보통 세 가지 시선으로 시스템을 그린다(SEI의 “Documenting Software Architectures”의 분류).

뷰묻는 것우리 문서
모듈 뷰코드는 어떻게 나뉘고 무엇이 무엇에 의존하나01-architecture
C&C 뷰실행 중에 무엇이 살아 있고 어떻게 이야기하나01-architecture
할당 뷰그것이 어디(기기 · 서버 · 파일)에 놓이나01-architecture

백엔드 개발자에게 익숙한 말로 빗대면, 모듈 뷰는 Maven 모듈의 의존 그림이고, C&C 뷰는 “요청이 들어오면 어느 빈이 어느 빈을 부르고 어디서 DB와 메시지 큐에 닿는가”의 그림이다.

노테이션의 낱말

  • 컴포넌트: 실행 중의 단위. 불릴 때만 일하는 수동 컴포넌트와, 자기 스레드 · 타이머 · 이벤트 리스너로 스스로 움직이는 능동 컴포넌트를 나눈다. 능동은 상자 양쪽에 이중 세로선을 긋는다.
  • 포트: 컴포넌트가 바깥과 닿는 자리. ■는 요청을 보내는 쪽, □는 받는 쪽이다.
  • 커넥터: 둘 사이의 상호작용 방식. 같은 스레드의 함수 호출, 기다리는 비동기 호출, 이벤트 알림, 메시지처럼 방식마다 선의 모양과 색을 다르게 한다. 커넥터에 ID(C-01 …)를 붙이면 시퀀스 그림과 측정 구간이 그 ID를 가리킬 수 있다.
  • 경계: 프로세스(우리에게는 브라우저 탭 하나)와 모듈(패키지)을 점선 상자로 감싼다.
  • 카탈로그: 그림만으로는 모자라, 컴포넌트와 커넥터마다 한 줄씩 표로 적는다. 그림은 보는 것, 표는 찾는 것이다.

우리 그림에서 알게 된 것

웹 앱은 브라우저의 메인 스레드 하나에서 돌고 Web Worker가 없다. 그래서 편집 응답의 길(C-01 → C-10)이 처음부터 끝까지 동기 호출이고, 그 시간이 모두 화면을 막는다. 성능 목표(AT-05)를 잴 때 이 길을 커넥터 단위로 나누면 어디가 느린지 보인다.

ATAM의 두 낱말

정의서의 평가 장에서 같이 본 말이다. ATAM(Architecture Tradeoff Analysis Method)은 SEI의 아키텍처 평가 방법이다.

  • 민감점(sensitivity point): 그 값이나 결정을 조금만 바꿔도 어떤 품질이 크게 흔들리는 곳. 예: 정의서의 하트비트 주기, 우리의 서브셋 글꼴 크기.
  • 상충점(trade-off point): 한 품질을 얻으려고 다른 품질을 내준 곳. 예: 우리는 결정적 출력을 얻으려고 글꼴을 번들했고, 첫 로딩의 크기를 내줬다.

그림을 그리는 도구

Mermaid는 글이라 diff가 되지만 포트와 커넥터의 모양을 다 그릴 수 없다. 그래서 C&C 뷰는 draw.io로 그렸다. draw.io가 내보내는 SVG에는 draw.io 원본이 들어 있어, 파일 하나가 그림이면서 원본이다. 고치는 법은 3. 문서에 있다.