feat: Wiki 지식 자산 업데이트 - UX Scenarios, Frontend, Game Design, Topics 추가 [2026-05-08]

10_Wiki/Topics/AI_and_ML/Hexagonal_Architecture.md

@@ -1,13 +1,26 @@
 ---
-category: Unified
+id: wiki-2026-0508-hexagonal-architecture
+title: Hexagonal Architecture
+category: 10_Wiki/Topics
+status: needs_review
+canonical_id: self
+aliases: []
+duplicate_of: none
+source_trust_level: A
+confidence_score: 0.92
 tags: [auto-consolidated, technical-documentation]
-title: [[Hexagonal Architecture]]
-last_updated: 2026-05-02
+raw_sources: []
+last_reinforced: 2026-05-08
+github_commit: pending
+inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
+tech_stack:
+  language: unspecified
+  framework: unspecified
 ---
 
 # [[Hexagonal Architecture]]
 
-## 📌 Brief Summary
+## 📌 한 줄 통찰 (The Karpathy Summary)
 **헥사고날 아키텍처(Hexagonal Architecture)** 또는 **포트와 어댑터(Ports and Adapters) 패턴**은 비즈니스 로직을 데이터베이스, UI, 프레임워크 등 외부 시스템으로부터 분리하여 느슨하게 결합된 애플리케이션을 만드는 설계 패턴이다 [1, 2]. 알리스테어 코오번(Alistair Cockburn)이 창안한 이 구조는 의존성의 방향이 철저히 시스템 중심부를 향하도록 설계되어, 외부 기술의 변화가 핵심 비즈니스 규칙에 영향을 미치지 않게 보호한다 [2, 3]. 결과적으로 시스템의 높은 **테스트 용이성(Testability), 유지보수성, 그리고 유연한 기술 스택 교체**를 가능하게 한다 [4, 5].
 
 ---
@@ -18,7 +31,7 @@ last_updated: 2026-05-02
 
 헥사고날 아키텍처(포트와 어댑터 패턴)는 비즈니스 로직을 데이터베이스, 사용자 인터페이스(UI), 프레임워크와 같은 외부 시스템으로부터 격리하여 느슨하게 결합된 애플리케이션을 만드는 소프트웨어 아키텍처 패턴이다 [1, 2]. 알리스테어 코크번(Alistair Cockburn)이 고안한 이 방식은 핵심 비즈니스 로직을 중앙에 두고 모든 의존성이 시스템의 안쪽을 향하도록 역전시켜 설계한다 [2, 3]. 이를 통해 기술 스택이 변경되더라도 비즈니스 로직을 보호하며, 높은 테스트 용이성과 유지보수성을 제공한다 [2, 4].
 
-## 📖 Core Content
+## 📖 구조화된 지식 (Synthesized Content)
 *   **핵심 도메인(Domain/Core)**: 시스템의 중심에 위치하며, 외부 시스템(UI, 데이터베이스 등)에 대한 어떠한 의존성도 갖지 않는 순수한 비즈니스 로직과 규칙을 포함한다 [1, 3, 6]. 
 *   **포트(Ports)**: 코어 영역이 외부 세계와 소통하는 방식을 정의하는 추상화된 인터페이스 계층이다 [3, 6]. 
     *   **인바운드(Driving/Input) 포트**: 사용자의 입력이나 외부 API 호출이 코어 로직과 상호작용하는 진입점을 정의한다 [1, 6].
@@ -58,7 +71,7 @@ last_updated: 2026-05-02
 * 포트와 어댑터를 통한 엄격한 경계 설계는 보안 규칙(예: 입력 유효성 검사, 역할 기반 접근 제어)을 시스템 가장자리에서 강제할 수 있도록 하여, 컴플라이언스 준수 및 데이터 감사(Auditability) 관리에 매우 유리하다 [7-9].
 * 모놀리식 생태계 및 마이크로서비스 생태계 모두에 원활하게 적용될 수 있으며, 도메인 주도 설계(DDD) 원칙과 강하게 부합한다 [4, 10].
 
-## ⚖️ Trade-offs & Caveats
+## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
 *   **높은 초기 복잡성과 가파른 학습 곡선**: 포트와 어댑터를 설계하고 구현하는 방식은 초기에 복잡하며, 경험이 적은 개발자 팀에게는 가파른 학습 곡선을 요구한다 [4, 10]. 
 *   **보일러플레이트 코드와 성능 오버헤드**: 동일한 목적을 위해 포트 인터페이스와 어댑터 구현체를 분리하여 작성해야 하므로 보일러플레이트 코드(반복 코드)가 증가한다 [4]. 또한, 추가된 추상화 계층들로 인해 약간의 성능 오버헤드(Performance Overhead)가 발생할 수 있다 [4, 11].
 *   **단순 프로젝트 적용 시의 비효율성 (Over-engineering)**: 최소한의 비즈니스 로직만을 가진 단순한 CRUD(Create, Read, Update, Delete) 애플리케이션이나 마감 기한이 매우 촉박한 프로젝트에 도입할 경우, 아키텍처가 주는 이점보다 설정 및 설계 비용이 더 커지는 오버엔지니어링 문제가 발생한다 [12, 13].
@@ -87,7 +100,7 @@ last_updated: 2026-05-02
 **제약 사항 (Caveats)**
 * 로직이 거의 없는 단순한 CRUD 기반의 애플리케이션이나 개발 기한이 촉박한 MVP(Minimum Viable Product) 프로젝트의 경우, 이 아키텍처를 도입하는 것은 과도한 엔지니어링(Over-engineering)이 될 수 있으므로 피하는 것이 좋다 [13, 15, 16].
 
-## 🔗 Knowledge Connections
+## 🔗 지식 연결 (Graph)
 ### Related Concepts
 
 #### [아키텍처/기반 설계 철학]
@@ -221,3 +234,52 @@ last_updated: 2026-05-02
 
 ---
 *Last updated: 2026-05-02*
+
+## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
+
+**언제 이 지식을 쓰는가:**
+- *(TODO)*
+
+**언제 쓰면 안 되는가:**
+- *(TODO)*
+
+## 🧪 검증 상태 (Validation)
+
+- **정보 상태:** needs_review
+- **출처 신뢰도:** A
+- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
+
+## 🧬 중복 검사 (Duplicate Check)
+
+- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
+- **처리 방식:** UPDATE (자동 정규화)
+- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
+
+## 🕓 변경 이력 (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: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*