---
category: Unified
tags: [Architecture, Documentation, Design, UML, C4 Model]
title: Architecture Diagrams
description: 복잡한 시스템의 구조, 컴포넌트 간 관계 및 데이터 흐름을 시각화하여 설계 의도를 명확히 전달하는 도구
last_updated: 2026-05-02
---

# Architecture Diagrams

## 📌 Brief Summary
**아키텍처 다이어그램(Architecture Diagrams)**은 소프트웨어 시스템의 청사진입니다. 텍스트만으로는 설명하기 어려운 시스템의 전체적인 구조, 논리적 구성 요소, 데이터의 흐름 및 외부 시스템과의 상호작용을 시각적 기호로 나타냅니다. 이는 개발자 간의 소통 비용을 줄이고, 기술적 의사결정을 가속화하며, 시스템의 품질 속성(성능, 확장성, 보안 등)을 검토하는 데 필수적인 문서 자산입니다.

---

## 📖 Core Content

### 1. 주요 다이어그램 유형
*   **시스템 컨텍스트 다이어그램 (System Context):** 시스템을 하나의 블랙박스로 보고, 외부 사용자 및 시스템과의 상호작용을 거시적으로 표현합니다 (C4 모델의 Level 1).
*   **컨테이너 다이어그램 (Container):** 시스템 내부의 실행 단위(웹 앱, 모바일 앱, DB, 서버 등)를 보여줍니다.
*   **컴포넌트 다이어그램 (Component):** 개별 컨테이너 내부의 주요 기능 모듈과 그들 사이의 인터페이스를 정의합니다.
*   **시퀀스 다이어그램 (Sequence):** 객체나 서비스 간의 메시지 전달 순서와 시간 흐름을 상세히 묘사합니다.

### 2. 현대적 트렌드: Diagrams as Code (DaC)
전용 드로잉 도구(Visio, Lucidchart) 대신 텍스트 기반 언어를 사용하여 다이어그램을 생성하는 방식이 선호됩니다.
*   **Mermaid:** Markdown 내에 직접 다이어그램 코드를 삽입하여 문서와 시각화를 동기화합니다.
*   **PlantUML:** 복잡한 클래스 다이어그램이나 시퀀스 다이어그램을 코드로 설계합니다.
*   **이점:** 버전 관리(Git)가 가능하고, 수정이 빠르며 문서 파편화를 방지합니다.

### 3. 좋은 다이어그램의 특징
*   **단순성:** 한 장의 그림에 너무 많은 정보를 담지 않고 추상화 수준을 유지합니다.
*   **표준화:** 일관된 기호와 범례(Legend)를 사용하여 오독의 소지를 없앱니다.
*   **최신성:** 코드의 변경 사항이 다이어그램에 즉각 반영되도록 관리합니다.

---

## ⚖️ Trade-offs & Caveats

### ✅ Benefits
*   **추상화된 시각화:** 복잡한 코드를 보지 않고도 시스템의 핵심 설계 사상을 파악할 수 있습니다.
*   **협업 가속화:** 이해관계자 간의 설계 의도 정렬(Alignment) 시간을 단축합니다.
*   **설계 검증:** 다이어그램을 그리는 과정에서 논리적 결함이나 병목 구간을 선제적으로 발견할 수 있습니다.

### ⚠️ Challenges
*   **유지보수 부담:** 시스템이 진화함에 따라 다이어그램을 수동으로 업데이트하지 않으면 '거짓 정보'가 되어 시스템 파악을 방해합니다.
*   **과도한 상세화:** 너무 세부적인 구현 내용까지 다이어그램에 담으려 하면 가독성이 떨어지고 유지보수가 불가능해집니다.

---

## 🔗 Knowledge Connections

### Related Concepts
*   [[C4_Model]]: 시스템 아키텍처를 계층적으로 설명하기 위한 표준 프레임워크입니다.
*   [[Mermaid_Diagrams]]: Markdown 환경에서 다이어그램을 코드로 관리하는 대표 도구입니다.
*   [[UML_Unified_Modeling_Language]]: 소프트웨어 설계 시각화의 전통적인 표준 언어입니다.

### Practical Application Contexts
*   **Codebase Onboarding:** 신규 개발자에게 시스템의 전체 구조를 한눈에 보여주는 용도로 사용됩니다.
*   **RFC (Request for Comments):** 새로운 기능을 제안할 때 설계 안을 시각화하여 리뷰를 받습니다.

---

## 💡 Adjacent Topics
*   [[System_Architecture_Documentation]]: 다이어그램을 포함한 포괄적인 시스템 설계 문서화 전략입니다.
*   [[Structurizr]]: C4 모델을 기반으로 아키텍처를 코드로 설계하는 강력한 도구입니다.
*   [[Infrastructure_as_Code]]: 클라우드 인프라 구성을 코드로 관리하고 이를 시각화하는 기술입니다.

---
*Last updated: 2026-05-02*