Fix: Restore unified Topics folder and reorganize specialized category folders

2026-05-02 23:25:02 +09:00
parent b71a0b82d3
commit fdfbc83535
6241 changed files with 147626 additions and 194 deletions
@@ -0,0 +1,58 @@
+---
+id: P-REINFORCE-WIKI-6B819939
+category: Dev
+confidence_score: 0.95
+tags: ['static-code-analysis', 'architecture-erosion', 'architecture-recovery', 'software-intelligence', 'automated-architecture-conformance-checks', 'software-engineering']
+last_reinforced: 2026-05-02
+---
+
+# [[Static Code Analysis]]
+
+## 📌 Brief Summary
+정적 코드 분석(Static Code Analysis)은 소프트웨어 아키텍처의 의도와 실제 구현 사이의 격차가 벌어지는 '아키텍처 침식(Architecture Erosion)' 현상을 조기에 식별하고 완화하는 데 사용되는 주요 도구 및 기법이다 [1, 2]. 또한, 시스템 문서가 오래되거나 부재한 상황에서 구현된 코드를 바탕으로 소프트웨어 아키텍처를 복구(Recovery)하기 위한 정적 프로그램 분석(Static program analysis) 관행으로도 활용된다 [3].
+
+## 📖 Core Content
+* **아키텍처 침식(Architecture Erosion) 조기 탐지 및 완화**
+  시간이 지남에 따라 의도된 소프트웨어 아키텍처와 실제 구현된 아키텍처 사이에 점진적인 격차가 발생하는 것을 아키텍처 침식이라고 한다 [1]. 정적 코드 분석 도구는 자동화된 아키텍처 준수 검사(automated architecture conformance checks) 및 리팩토링 기술과 함께 이러한 아키텍처 침식을 초기에 파악하고 완화하여 아키텍처 위반이나 기술 부채의 축적을 방지하는 데 필수적인 역할을 수행한다 [2].
+* **소프트웨어 아키텍처 복구(Architecture Recovery)**
+  소프트웨어 아키텍처 복구(또는 역공학)는 구현 및 유지보수 결정이 초기 설계에서 벗어났거나 시스템 문서가 구식이 된 경우, 정보에 입각한 의사 결정을 내리기 위해 수행된다 [3]. 정적 프로그램 분석은 소프트웨어 인텔리전스(Software intelligence) 관행의 일부로서, 사용 가능한 구현 코드 등의 정보로부터 소프트웨어 시스템의 아키텍처를 성공적으로 복구해 내는 기술적 수단으로 활용된다 [3].
+
+## ⚖️ Trade-offs & Caveats
+소스에 관련 정보가 부족합니다.
+
+## 🔗 Knowledge Connections
+
+### Related Concepts
+
+#### [아키텍처 유지보수 및 품질 관리]
+- [[Architecture Erosion]] (아키텍처 침식)
+  - 연결 이유: 정적 코드 분석 도구가 아키텍처 침식을 조기에 발견하고 완화하는 핵심 예방 수단으로 활용되기 때문이다 [2].
+  - 이 개념을 통해 더 깊게 이해할 수 있는 부분: 정적 분석이 시스템 성능 저하, 유지보수 비용 증가, 품질 저하를 유발하는 아키텍처 설계와 구현 간의 불일치를 어떻게 방지하는지 이해할 수 있다 [1, 2].
+
+#### [아키텍처 역공학 및 지식 관리]
+- [[Architecture Recovery]] (아키텍처 복구)
+  - 연결 이유: 정적 프로그램 분석이 사용할 수 있는 문서가 없는 상태에서 시스템의 구현 코드만으로 원래의 소프트웨어 아키텍처를 복구하고 파악하는 데 사용되기 때문이다 [3].
+  - 이 개념을 통해 더 깊게 이해할 수 있는 부분: 정적 분석을 통한 코드 레벨의 추적이 어떻게 거시적인 시스템 구조 설계(아키텍처)를 재구성하여 의사결정을 지원하는지 이해할 수 있다 [3].
+
+### Deeper Research Questions
+- 정적 코드 분석 도구는 의도된 아키텍처와 구현된 아키텍처 간의 격차(아키텍처 침식)를 구체적으로 어떤 코드 수준의 지표를 통해 식별하는가?
+- 자동화된 아키텍처 준수 검사(Automated architecture conformance checks)는 정적 코드 분석과 결합하여 어떻게 실시간으로 아키텍처 위반을 모니터링하는가?
+- 노후화된 문서만 존재하는 레거시 시스템에서 정적 프로그램 분석을 활용하여 아키텍처를 복구할 때 직면하는 기술적 한계나 분석의 사각지대는 무엇인가?
+- 정적 코드 분석을 통해 식별된 아키텍처 침식을 해결하기 위해 리팩토링 기술(Refactoring techniques)은 어떤 절차로 적용되는가?
+- 정적 프로그램 분석으로 복구된 아키텍처 모델이 시스템의 런타임 및 동적(Dynamic) 특성을 파악하는 데에는 어떤 한계를 가지는가?
+
+### Practical Application Contexts
+- **Implementation:** 개발 과정에서 정적 코드 분석 도구를 CI/CD 파이프라인 등에 통합하여, 코드 작성 시점부터 아키텍처 규칙 위반 및 아키텍처 침식을 조기에 방지할 수 있다 [2].
+- **System Design:** 문서가 오래되거나 존재하지 않는 기존 시스템을 기반으로 새로운 설계를 추가해야 할 때, 정적 프로그램 분석을 통해 기존 시스템의 구조를 추출하고 아키텍처를 복구할 수 있다 [3].
+- **Operation / Maintenance:** 유지보수 단계에서 코드가 지속적으로 변경됨에 따라 발생하는 의도치 않은 아키텍처 변형(Erosion)을 정기적인 정적 분석을 통해 모니터링하고 리팩토링의 근거로 활용한다 [1, 2].
+- **Learning Path:** 아키텍처 패턴 지식을 실무에 적용하는 방법을 학습할 때, 설계된 패턴이 실제 코드 베이스에서 어떻게 강제되고 검증되는지(정적 분석 도구 활용)를 이해하는 단계로 연결된다.
+- **My Project Relevance:** 시간이 지나면서 프로젝트 코드베이스가 본래 의도했던 아키텍처 패턴 구조에서 벗어나는 것을 막고, 기술 부채를 통제하는 구조적 품질 검증 도구로 도입할 수 있다 [2].
+
+### Adjacent Topics
+- [[Software Intelligence]]
+  - 확장 방향: 정적 프로그램 분석을 활용한 아키텍처 복구가 포함되는 상위 관행으로, 소프트웨어 시스템의 내부 구조를 이해하고 평가하는 광범위한 분야로 확장이 가능하다 [3].
+- [[Automated Architecture Conformance Checks]]
+  - 확장 방향: 정적 코드 분석 도구와 함께 사용되어 아키텍처 침식을 조기에 완화하는 또 다른 핵심 예방 조치 기술로서, 자동화된 아키텍처 검증 파이프라인 구축에 대해 조사할 수 있다 [2].
+
+---
+*Last updated: 2026-05-02*