---
id: P-REINFORCE-WIKI-ARCH-C4-MODEL
title: "C4 모델 아키텍처 시각화 프레임워크"
category: "10_Wiki/🏗️ Topics_Arch"
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
- **검토 이유**: 시스템 구조의 명확한 전달과 문서화를 위한 현대적 시각화 표준 정립.