Clean Architecture

📌 Brief Summary

Clean Architecture(클린 아키텍처)는 로버트 C. 마틴(Robert C. Martin)이 대중화한 설계 패턴으로, 소프트웨어를 동심원 형태의 계층으로 구성하여 비즈니스 로직을 외부 프레임워크나 인프라로부터 철저히 격리하는 구조입니다 [1]. 의존성이 항상 바깥쪽 계층에서 안쪽(중심) 계층으로만 향하도록 강제하는 '의존성 규칙(Dependency Rule)'을 따르는 것이 특징입니다 [2, 3]. 이를 통해 데이터베이스, UI, 외부 기술의 변화가 핵심 비즈니스 규칙에 영향을 주지 않도록 하여 시스템의 장기적인 유지보수성, 보안 및 테스트 용이성을 극대화합니다 [2, 4, 5].

📖 Core Content

동심원 기반의 4계층 구조 클린 아키텍처는 일반적으로 추상화 수준이 다른 네 개의 동심원 계층으로 소프트웨어를 구성합니다 [1].
- 엔티티(Entities): 애플리케이션의 핵심 비즈니스 규칙을 캡슐화합니다. 특정 유스케이스나 기술에 구애받지 않는, 가장 일반적이고 재사용 가능한 로직을 포함합니다 [6].
- 유스케이스(Use Cases): 애플리케이션에 특화된 비즈니스 규칙을 포함합니다. 엔티티와 데이터를 주고받는 흐름을 조정하며, 사용자 관점에서의 시스템 동작을 규정합니다 [6].
- 인터페이스 어댑터(Interface Adapters): 외부 에이전시(웹, 데이터베이스, UI 등)가 요구하는 형식과 내부(유스케이스 및 엔티티)에서 사용하기 가장 편리한 형식 사이에서 데이터를 변환하는 역할을 합니다 [6].
- 프레임워크 및 드라이버(Frameworks and Drivers): 가장 바깥쪽 계층으로, 웹 프레임워크, 데이터베이스, 메시징 시스템, 사용자 인터페이스 등의 외부 도구와 기술이 위치합니다 [6].
엄격한 의존성 규칙(Dependency Rule) 클린 아키텍처의 핵심은 의존성이 오직 바깥쪽 계층에서 안쪽 계층으로만 흐른다는 것입니다 [2]. 핵심 비즈니스 로직(내부)은 외부의 기술적 구현에 대해 전혀 알지 못합니다 [2]. 내부에서는 필요한 기능의 인터페이스만 정의하고, 실제 구현체는 외부(어댑터)에 위치시켜 의존성 주입(DI) 컨테이너를 통해 런타임에 해결하는 방식으로 결합도를 낮춥니다 [7].
강력한 보안 및 규정 준수 이점 입력 검증, 인증, 인가 처리 등을 인터페이스 어댑터 계층으로 집중시켜 필터링된 안전한 데이터만 비즈니스 로직에 도달하도록 합니다 [5]. 이를 통해 SQL 인젝션과 같은 외부 취약점으로부터 도메인을 보호하며 공격 표면을 줄입니다 [5]. 또한 어댑터 수준에서 암호화, 감사 로깅(Audit Logging) 등의 정책을 일관되게 강제할 수 있어 GDPR, HIPAA와 같은 규정 준수(Compliance) 체계를 단순화합니다 [8, 9].
높은 테스트 용이성과 단일 책임 핵심 비즈니스 로직이 데이터베이스나 UI 인프라에서 분리되어 있으므로, 무거운 통합 테스트 없이도 빠르고 안정적인 격리된 단위 테스트(Unit Test)가 가능합니다 [4]. 전용 매퍼, 유틸리티 클래스, 파사드(Facades) 등의 도입을 통해 자연스럽게 단일 책임 원칙(SRP)을 지향하게 됩니다 [10].

⚖️ Trade-offs & Caveats

높은 초기 복잡성과 과도한 오버헤드: 엄격한 계층화는 수명이 길고 복잡한 엔터프라이즈 시스템에서는 유지보수성의 이점을 제공하지만, 초기 MVP(Minimum Viable Product)를 구축하는 스타트업이나 단순한 프로젝트에서는 불필요한 과도한 오버헤드를 초래할 수 있습니다 [11, 12].
보일러플레이트 코드 증가: 의존성이 밖에서 안으로만 향하도록 강제하기 위해, 각 계층마다 비슷한 형태의 값 객체(POJO)나 모델을 중복해서 구현해야 하는 경우가 생깁니다 [3]. 각 계층의 모델이 시간이 지남에 따라 독립적으로 진화할지라도, 초기에는 단순히 코드를 복사해서 붙여넣은 것과 같은 많은 보일러플레이트 코드를 유발합니다 [3].
가파른 학습 곡선: 추상화 계층이 추가되고 포트, 어댑터, 의존성 역전 등의 설계 패턴을 팀원 모두가 정확히 이해하고 규율을 지켜야 하므로 주니어 개발자가 많은 팀에게는 도입이 어려울 수 있습니다 [13].

🔗 Knowledge Connections

[아키텍처/기반 기술]

Hexagonal Architecture
- 연결 이유: Clean Architecture는 도메인 로직을 외부 종속성으로부터 분리한다는 헥사고날 아키텍처(포트와 어댑터)의 철학을 정제하고 발전시킨 구조이기 때문입니다 [1, 14, 15].
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 코어 도메인이 외부 프레임워크와 어떻게 추상화된 포트(Port)와 구체적인 어댑터(Adapter)를 통해 연결되는지 그 메커니즘을 심도 있게 이해할 수 있습니다 [16].
Layered Architecture
- 연결 이유: Clean Architecture는 전통적인 계층형 아키텍처 구조의 한계를 보완하고 의존성의 방향을 역전시켜 비즈니스 도메인을 중심으로 재배치한 발전형이기 때문입니다 [17, 18].
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 프레젠테이션 -> 비즈니스 -> 데이터베이스로 흐르던 기존 하향식 의존성이 시간이 지남에 따라 어떻게 강한 결합을 유발하는지 비교 분석할 수 있습니다 [4, 19].

[설계 원칙/구현 방식]

Dependency Inversion (의존성 역전 원칙)
- 연결 이유: 외부 어댑터가 내부 엔티티 및 유스케이스에만 의존해야 하는 Clean Architecture의 핵심 규칙을 코드로 구현하는 근간 원리입니다 [18].
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 요구되는 인터페이스를 핵심 로직과 같은 위치에 두고, 구현부를 외부에 두어 런타임에 주입(DI)하는 기술적 흐름을 파악할 수 있습니다 [7].
Domain-Driven Design (DDD)
- 연결 이유: Clean Architecture에서 가장 안쪽에 위치하는 Entities(핵심 비즈니스 규칙)가 외부와 단절된 순수한 도메인 모델을 형성하는 접근법과 맞닿아 있기 때문입니다 [13, 20].
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 복잡한 엔터프라이즈 환경에서 기술적 세부사항을 배제하고 비즈니스 개념만으로 모델링을 수행하는 기법을 이해할 수 있습니다.

Deeper Research Questions

Clean Architecture의 4계층 구조에서 의존성이 무조건 외부에서 내부로만 흐르는데, 내부 계층(유스케이스)이 외부 데이터베이스의 데이터를 가져와야 할 때 의존성 역전은 구체적으로 어떤 인터페이스와 어댑터 구조를 통해 구현되는가? [7]
빠른 출시가 중요한 스타트업이 초기 MVP 단계에서 Layered Architecture로 시작한 후, 복잡도가 증가함에 따라 Clean Architecture로 점진적인 리팩토링을 수행하려면 어떤 이행 전략이 효과적인가? [5, 21]
클린 아키텍처의 의존성 규칙을 준수하는 과정에서 필연적으로 발생하는 보일러플레이트 코드(계층 간 데이터 변환 모델 중복 등)를 최소화하거나 효율적으로 관리할 수 있는 베스트 프랙티스는 무엇인가? [3, 10]
MSA(마이크로서비스 아키텍처) 기반의 분산 시스템 환경에서 개별 마이크로서비스 내부의 마이크로 아키텍처로서 Clean Architecture를 도입할 때 얻을 수 있는 장단점은 무엇인가? [21, 22]
Clean Architecture의 인터페이스 어댑터 계층을 통한 '방어적 고립'에도 불구하고 발생할 수 있는 보안적 취약점이나, 이를 우회하게 되는 잘못된 구현 사례(Anti-pattern)는 어떤 것들이 있는가? [5, 9, 23]

Practical Application Contexts

Implementation: 핵심 비즈니스 로직(Entities, Use Cases)을 작성할 때 외부 웹 프레임워크나 DB ORM 라이브러리의 의존성을 배제한 순수한 코드로 작성합니다. 이를 통해 미래에 프레임워크를 교체하더라도 도메인 코드는 그대로 유지할 수 있습니다. [2, 6, 24]
System Design: 글로벌 뱅킹 플랫폼 등 수명이 길고, 대규모 팀이 협업하며, 보안과 유지보수성이 최우선인 엔터프라이즈 시스템을 설계할 때 가장 적합합니다. [24, 25]
Operation / Maintenance: 명확한 경계(어댑터)에서 로깅과 감사(Auditing)를 수행하여 데이터 흐름을 쉽게 추적할 수 있으며, 결함 수정이나 외부 서비스(결제 PG 등) 교체 시 비즈니스 규칙이 안전하게 보호되어 운영 시 회귀 오류를 줄일 수 있습니다. [2, 9]
Learning Path: Layered Architecture로 인한 스파게티 코드의 문제점을 경험한 후, 의존성 역전(Dependency Inversion) 원리를 이해하고 Hexagonal -> Clean Architecture 순으로 학습하여 시스템을 추상화하는 기법을 체화합니다. [11, 18, 26]
My Project Relevance: 복잡한 비즈니스 로직을 가지며 장기적인 확장이 예상되는 프로젝트의 기본 뼈대로 채택을 고려할 수 있습니다. 단, 단순 CRUD 앱이나 빠른 프로토타이핑이 필요한 소규모 프로젝트에서는 과도한 복잡도를 초래하므로 신중히 저울질해야 합니다. [11, 25, 27]

Adjacent Topics

Onion Architecture
- 확장 방향: 도메인을 중심에 두고 외부로 갈수록 기술적인 종속성을 허용하는 아키텍처로, Clean Architecture와 동일한 철학(도메인 중심 설계 및 엄격한 종속성 규칙)을 공유하는 패턴과 그 차이점을 연구합니다. [1, 28]
Microservices Architecture
- 확장 방향: Clean Architecture가 개별 서비스 내부의 코드 수준(Micro) 설계에 집중한다면, 마이크로서비스는 시스템 전체의 인프라적 분할(Macro)을 다룹니다. 이 두 개념을 결합하여 각 서비스를 유연하고 독립적으로 구축하는 방안을 모색합니다. [21, 22]

Last updated: 2026-05-02

11 KiB Raw Blame History