소프트웨어 제품이 성장하면 새 서비스 연동, 업무 프로세스 변경, 다른 플랫폼 지원, 더 많은 사용자 처리 등 코드가 충족해야 하는 요구사항도 늘어납니다. 구성 요소들이 서로 긴밀하게 의존하면 작은 변경도 연쇄적인 오류를 일으키고 개발 일정을 늦출 수 있습니다.
그렇다면 클린 아키텍처란 무엇이며, 왜 많은 개발팀이 이 모델에 주목할까요? 클린 아키텍처는 인터페이스, 데이터베이스, 외부 기술이 바뀌더라도 핵심 비즈니스 규칙을 보호하도록 소프트웨어를 구성하는 방식입니다. 이 글에서는 클린 아키텍처의 원칙과 구조, 소프트웨어 프로젝트에서 얻을 수 있는 실질적인 가치를 살펴보겠습니다.
클린 아키텍처란?
클린 아키텍처는 Robert C. Martin, 일명 Uncle Bob이 널리 알린 소프트웨어 아키텍처 모델입니다. 이 모델의 목표는 코드베이스를 책임이 명확한 영역으로 나누고, 중요한 비즈니스 로직을 중심에 두어 외부의 기술적 세부사항에 대한 의존성을 낮추는 것입니다.

시스템을 동심원으로 이루어진 구조라고 생각하면 이해하기 쉽습니다. 가장 안쪽에는 오랫동안 유효한 비즈니스 규칙이 자리합니다. 바깥쪽으로 갈수록 데이터베이스, 사용자 인터페이스, 결제 서비스, 프레임워크처럼 시스템이 실제 세계와 상호작용하는 구성 요소가 배치됩니다. 외부 계층은 바뀔 수 있지만, 그 변화가 핵심 로직까지 바꾸도록 해서는 안 됩니다.
클린 아키텍처는 설치해서 사용하는 프레임워크나 프로그래밍 언어, 도구 모음이 아닙니다. 시스템을 바라보고 구성하는 사고방식입니다. 비즈니스 로직과 구현 세부사항 사이의 경계를 유지한다면 다양한 기술을 활용해 적용할 수 있습니다.
중요한 차이점은 비즈니스 로직이 특정 데이터베이스나 프레임워크에 직접 의존하지 않는다는 것입니다. 예를 들어 주문 수수료 계산 규칙에는 비즈니스 요구사항이 표현되어야 하며, 특정 데이터베이스 관리 시스템에 종속된 쿼리가 포함되어서는 안 됩니다.
클린 아키텍처의 핵심 원칙
의존성은 안쪽을 향한다
가장 두드러지는 원칙은 의존성 규칙(Dependency Rule)입니다. 바깥 계층의 코드는 안쪽 계층에 의존할 수 있지만, 안쪽 계층은 바깥 계층을 알거나 이에 의존해서는 안 됩니다. 다시 말해 비즈니스 로직은 어떤 UI 라이브러리를 사용하는지, 데이터를 어디에 저장하는지, 어느 공급업체의 API를 호출하는지 몰라도 작동해야 합니다.
안쪽 구성 요소에 외부 계층이 제공하는 기능이 필요한 경우, 개발팀은 안쪽에 인터페이스를 정의할 수 있습니다. 바깥 계층의 구현체가 그 인터페이스를 구현합니다. 그 결과 비즈니스 로직은 구체적인 구현 방식에 직접 연결되지 않고 안정적인 계약을 바탕으로 동작합니다.
책임을 분리하고 비즈니스 로직을 보호한다
시스템의 각 부분은 맡은 역할을 명확하게 설명할 수 있어야 합니다. 비즈니스 규칙을 화면 표시, 데이터 접근, 네트워크 통신 처리와 섞어서는 안 됩니다. 이렇게 분리하면 새로운 요구사항이 생겼을 때 변경할 위치를 쉽게 찾을 수 있고, 한 기능을 수정하다가 다른 기능에 영향을 줄 위험도 줄어듭니다.
핵심 비즈니스 로직은 구현 기술보다 변경 주기가 느린 경우가 많습니다. 따라서 주문 승인 조건, 할인 계산 방식, 승인 권한과 같은 규칙이 프레임워크나 인프라에 종속되지 않도록 설계해야 합니다. 이는 여러 차례 업그레이드를 거쳐도 소프트웨어의 가치를 유지하는 데 도움이 됩니다.
테스트하기 쉬운 구조를 지향한다
비즈니스 로직이 데이터베이스나 외부 서비스에 덜 의존하면, 전체 시스템을 구동하지 않고도 자동화 테스트로 다양한 규칙을 검증할 수 있습니다. 테스트 중에는 외부 구성 요소를 모의 객체로 대체할 수도 있습니다.
그렇다고 모든 코드에 복잡한 테스트가 필요하다는 뜻은 아닙니다. 중요한 규칙을 빠르고 신뢰성 있게 검증할 수 있는 구조를 마련해 소프트웨어를 사용자에게 제공하기 전에 오류를 일찍 발견하는 것이 목적입니다.
일반적인 계층 구조
클린 아키텍처는 일반적으로 네 가지 계층으로 설명합니다. 프로젝트에 따라 명칭은 달라질 수 있지만 각 계층의 책임과 의존성의 방향은 일관되게 유지해야 합니다.

- 엔티티(Entities): 가장 보편적이고 안정적인 비즈니스 규칙을 담습니다. 엔티티는 고객, 주문, 계약과 같은 객체와 해당 객체에 적용되는 비즈니스 조건을 나타낼 수 있습니다.
- 유스케이스(Use Cases): 주문 생성, 환불 요청 승인, 프로필 업데이트처럼 특정 목표를 달성하기 위해 시스템이 제공하는 동작을 설명합니다. 이 계층은 엔티티 사이의 비즈니스 흐름을 조정하고 반환할 결과를 정의합니다.
- 인터페이스 어댑터(Interface Adapters): 외부 형식과 내부 계층에서 사용하는 형식 사이의 데이터 변환을 담당합니다. API 컨트롤러, 요청 처리기, 데이터 매핑 계층 등이 여기에 해당합니다.
- 프레임워크와 드라이버(Frameworks and Drivers): 데이터베이스, 웹 프레임워크, 이메일 발송 시스템, 결제 서비스, 애플리케이션 인터페이스 등 구체적인 기술을 포함합니다.
온라인 주문 기능을 예로 들어 보겠습니다. 유스케이스는 주문 요청을 받아 재고 확인과 총액 계산 같은 규칙을 실행합니다. 주문 저장을 요청할 수 있도록 저장소 인터페이스를 정의하고, 바깥 계층의 구체적인 구성 요소는 프로젝트에서 선택한 데이터베이스를 사용해 해당 인터페이스를 구현합니다. 이후 저장 기술을 바꾸더라도 비즈니스 로직을 반드시 다시 작성할 필요는 없습니다.
이 구조를 따른다고 해서 프로젝트에 반드시 네 개의 폴더를 만들거나 정해진 다이어그램을 그대로 사용해야 하는 것은 아닙니다. 중요한 것은 팀이 경계와 책임, 계층 간 통신 방식을 합의해 비즈니스 로직이 외부 기술에 의도치 않게 종속되는 상황을 막는 것입니다.
소프트웨어 프로젝트에서 클린 아키텍처가 주는 이점
유지보수와 기술 변경이 쉬워진다
비즈니스 로직을 분리하면 한 구성 요소의 변경이 전체 시스템에 미치는 영향을 줄일 수 있습니다. 예를 들어 기업은 주문이 결제 가능한지 판단하는 규칙을 다시 작성하지 않고도 결제 공급업체를 변경할 수 있습니다. 마찬가지로 인터페이스나 데이터베이스를 바꿀 때도 관련 계층에 변경을 한정할 수 있습니다.

확장성을 높인다
프로젝트에 기능이 추가될 때 명확한 경계가 있으면 해당 기능이 어느 계층에 속하고 어떤 구성 요소와 통신해야 하는지 파악하기 쉽습니다. 장기적으로 발전할 제품이나 여러 시스템을 연동하는 제품, 다수의 팀이 함께 유지보수하는 제품에 특히 유용합니다. 코드베이스가 이해하기 쉬워져 신규 팀원도 더 빠르게 적응할 수 있습니다.
테스트를 지원하고 위험을 줄인다
팀은 인터페이스나 배포 환경에 전적으로 의존하지 않고 유스케이스와 비즈니스 규칙을 개별적으로 테스트할 수 있습니다. 조기에 테스트하면 로직의 오류를 일찍 발견해 실제 운영 단계에서 문제가 발생할 가능성을 줄이고, 장애 대응 비용도 낮출 수 있습니다.
비즈니스 운영에 유연성을 제공한다
좋은 아키텍처는 개발자에게만 의미가 있는 것이 아닙니다. 기업이 새로운 업무 프로세스를 시험하거나 관리 시스템을 연동하고 다른 판매 채널로 확장할 때, 유연한 구조의 소프트웨어는 변경을 더 원활하게 구현하도록 돕습니다. 이는 장기적인 성장 계획을 가진 디지털 제품에서 고려할 만한 장점입니다.
다만 클린 아키텍처를 적용한다고 프로젝트가 자동으로 빨라지거나 모든 오류가 사라지는 것은 아닙니다. 그 가치는 팀의 적용 방식과 요구사항에 대한 적합성, 구현 품질에 따라 달라집니다. 불필요한 계층을 지나치게 많이 만들면 복잡성이 줄기는커녕 오히려 커질 수 있습니다.
언제 적용해야 하며 무엇을 유의해야 할까요?
클린 아키텍처는 비즈니스 로직이 복잡하거나 수명이 길고, 여러 시스템과 연동되거나 요구사항이 자주 바뀌는 시스템에 적합한 경우가 많습니다. 전자상거래 플랫폼, 금융 앱, 기업 관리 시스템, 여러 사용자 그룹을 지원하는 소프트웨어는 핵심 로직을 보호함으로써 이점을 얻을 수 있습니다.
반면 수명이 짧은 소규모 실험 제품이나 몇 가지 단순한 기능만 제공하는 제품이라면 처음부터 모델을 완전히 적용할 필요가 없을 수 있습니다. 팀은 소요 시간과 자원, 유지보수 역량, 요구사항의 불확실성을 함께 고려해야 합니다. 적합한 아키텍처란 계층이 가장 많은 아키텍처가 아니라 실제 문제를 해결하는 아키텍처입니다.
구현할 때 다음 사항을 유의하세요.
- 비즈니스 도메인부터 파악합니다: 폴더를 나누거나 디자인 패턴을 선택하기 전에 기업에서 사용하는 규칙과 프로세스, 용어를 명확히 합니다.
- 의미 있는 경계를 유지합니다: 책임을 분리하거나 구현을 교체하는 데 도움이 될 때 인터페이스를 만들고, 형식을 따르기 위해서만 계층을 추가하지 않습니다.
- 프레임워크에 무작정 의존하지 않습니다: 적절한 도구는 활용하되 중요한 규칙이 교체하기 어려운 기술에 고정되지 않도록 합니다.
- 필요에 따라 적용합니다: 시스템 전체를 한 번에 다시 작성하기보다 중요한 비즈니스 영역부터 단계적으로 적용할 수 있습니다.
- 정기적으로 평가합니다: 유지보수 비용, 기능 개발 속도, 테스트 편의성을 점검하고 필요에 따라 아키텍처를 조정합니다.
개발팀과 제품 소유자가 아키텍처의 목표를 함께 이해하는 것이 중요합니다. 클린 아키텍처를 단순한 폴더 구성 방식으로만 바라보면 변경 대응력과 품질 관리 측면의 이점을 얻기 어렵습니다.
결론
클린 아키텍처란 무엇일까요? 핵심 비즈니스 로직이 인터페이스, 데이터베이스, 프레임워크 같은 세부 구현에 종속되지 않도록 소프트웨어를 구성하는 방식입니다. 적절히 적용하면 시스템을 유지보수하고 테스트하기 쉬워지며 변화에도 유연하게 대응할 수 있습니다. 다만 프로젝트의 규모와 복잡성, 실제 목표에 맞춰 선택해야 하며, 무조건 적용해서는 안 됩니다.
디지털 제품을 구축하거나 기존 시스템을 고도화하고, 기술 방향에 대한 자문이 필요하시다면 LilyTech에 문의해 요구사항과 적합한 솔루션을 논의해 보세요. LilyTech는 기업의 비즈니스 목표에 맞는 소프트웨어 솔루션의 설계, 개발, 구축을 함께합니다.


