---
id: wiki-2026-0508-c4-modeling-framework
title: C4 Modeling Framework
category: 10_Wiki/Topics
status: verified
canonical_id: self
aliases: [P-REINFORCE-WIKI-ARCH-C4-MODEL, C4 Model, 계층적 아키텍처 모델링, 시스템 시각화]
duplicate_of: none
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: pending
tech_stack:
  language: unspecified
  framework: unspecified
---

# [[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
- **검토 이유**: 시스템 구조의 명확한 전달과 문서화를 위한 현대적 시각화 표준 정립.

## 📌 한 줄 통찰 (The Karpathy Summary)

> *(TODO: 한 문장으로 핵심 통찰을 작성. "X는 Y 조건에서 Z 효과를 낸다" 구조 권장.)*

## 📖 구조화된 지식 (Synthesized Content)

**추출된 패턴:**
> *(TODO)*

**세부 내용:**
- *(TODO)*

## 🤖 LLM 활용 힌트 (How to Use This Knowledge)

**언제 이 지식을 쓰는가:**
- *(TODO)*

**언제 쓰면 안 되는가:**
- *(TODO)*

## 🧬 중복 검사 (Duplicate Check)

- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
- **처리 방식:** UPDATE (자동 정규화)
- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.

## ⚠️ 모순 및 업데이트 (Contradictions & Updates)

- **과거 데이터와의 충돌:** 없음
- **정책 변화:** 없음

## 🔗 지식 연결 (Graph)

- **Parent:** [[10_Wiki/Topics]]
- **Related:** *(TODO: 최소 2개)*
- **Opposite / Trade-off:** *(TODO)*
- **Raw Source:** 직접 입력

## 🕓 변경 이력 (Changelog)

| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
|------|-----------|-----------|--------|
| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |

## 💻 코드 패턴 (Code Patterns)

**패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*

```text
# TODO
```

## 🤔 의사결정 기준 (Decision Criteria)

**선택 A를 써야 할 때:**
- *(TODO)*

**선택 B를 써야 할 때:**
- *(TODO)*

**기본값:**
> *(TODO)*

## ❌ 안티패턴 (Anti-Patterns)

- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*