Antigravity Agent
46 lines
2.9 KiB
Markdown
46 lines
2.9 KiB
Markdown
---
|
|
id: P-REINFORCE-WIKI-ARCH-C4-MODEL
|
|
title: "C4 모델 아키텍처 시각화 프레임워크"
|
|
category: Dev
|
|
status: verified
|
|
canonical_id: ""
|
|
aliases: ["C4 Model", "계층적 아키텍처 모델링", "시스템 시각화"]
|
|
duplicate_of: ""
|
|
source_trust_level: A
|
|
confidence_score: 1.0
|
|
tags: ["Architecture", "Modeling", "C4_Model", "Visualization", "Documentation"]
|
|
raw_sources: ["Datacollector_Export_2026-05-02"]
|
|
last_reinforced: 2026-05-02
|
|
github_commit: ""
|
|
---
|
|
|
|
# [[C4 모델 아키텍처 시각화 프레임워크]]
|
|
|
|
## 1. 개요
|
|
C4 모델은 소프트웨어 아키텍처를 **컨텍스트(Context), 컨테이너(Container), 컴포넌트(Component), 코드(Code)**의 4가지 추상화 수준으로 계층화하여 표현하는 접근법이다. 지도를 확대(Zoom-in)하듯 상위 수준의 시스템 개요부터 세부 구현까지 점진적으로 시각화하여 다양한 이해관계자와 일관된 어휘로 소통할 수 있게 돕는다.
|
|
|
|
## 2. 4단계 계층 (Four Levels)
|
|
1. **L1: 시스템 컨텍스트 (Context)**: 시스템을 블랙박스로 취급하며, 사용자 및 외부 시스템과의 상호작용 경계를 정의. (경영진/비기술자 대상)
|
|
2. **L2: 컨테이너 (Container)**: 시스템 내부의 실행/배포 가능한 단위(웹 앱, DB, 모바일 앱 등)와 기술 스택, 통신 채널 명시. (개발자/운영자 대상)
|
|
3. **L3: 컴포넌트 (Component)**: 컨테이너 내부의 주요 구조적 구성 요소와 그들 간의 책임 및 의존성 기술. (개발자 대상)
|
|
4. **L4: 코드 (Code)**: 클래스 다이어그램 등 가장 낮은 수준의 뷰. 코드가 실제로 어떻게 구성되어 있는지 상세 표현. (선택적 사용)
|
|
|
|
## 3. 핵심 이점
|
|
- **인지적 부하 감소**: 필요한 만큼의 정보만 단계적으로 제공하여 복잡한 코드베이스 탐색을 용이하게 함.
|
|
- **의사소통 효율화**: 청중의 지식 수준에 맞춰 다이어그램의 깊이를 조절 가능.
|
|
- **지속 가능성**: Structurizr와 같은 도구를 통해 '코드로서의 다이어그램(Diagrams as Code)'으로 관리하여 문서 최신화 보장.
|
|
|
|
## 4. 트레이드오프 및 주의사항
|
|
- **장점**: 명확한 추상화 수준 분리, 이해관계자 간 정렬 용이.
|
|
- **단점**: 고도로 정밀한 시맨틱 명세(UML 대비)나 물리적 클라우드 인프라(VPC, 서브넷 등) 표현에는 한계가 있음.
|
|
|
|
## 5. 지식 연결 (Related)
|
|
- [[UML_Unified_Modeling_Language]]: C4의 L4(Code) 레벨에서 주로 사용되는 상세 모델링 언어.
|
|
- [[Architecture_Diagramming_Standards]]: 시스템을 시각화하는 일반적인 원칙과 기법.
|
|
- [[Hexagonal_Architecture]]: C4 모델을 통해 시각화하기 좋은 대표적인 내부 아키텍처 패턴.
|
|
|
|
## 🧪 검증 상태 (Validation)
|
|
- **정보 상태**: 검증 완료 (Verified)
|
|
- **출처 신뢰도**: A
|
|
- **검토 이유**: 시스템 구조의 명확한 전달과 문서화를 위한 현대적 시각화 표준 정립.
|