왜 계층화가 필요할까요?
계층을 의식적으로 나누지 않고도 애플리케이션을 개발할 수 있습니다. 컴포넌트에서 데이터를 불러오고, 서비스에서 상태를 관리하고, Store에서 HTTP를 호출할 수 있습니다. 그 사이 어딘가에 비즈니스 로직이 자리 잡습니다.
이렇게 해도 동작합니다.
적어도 한동안은 그렇습니다.
하지만 애플리케이션이 커질수록 다른 질문이 더 중요해집니다. 어떤 책임을 어디에 두어야 할까요?
계층화는 바로 이 질문에서 시작합니다.
계층화는 새로운 발상이 아닙니다
섹션 제목: “계층화는 새로운 발상이 아닙니다”애플리케이션을 책임에 따라 나누는 것은 소프트웨어 아키텍처의 오랜 기본 원칙입니다.
예를 들어 Martin Fowler는 Presentation Domain Data Layering에서 화면 표현, 도메인 로직, 데이터 접근을 분리하는 방식을 설명합니다. 큰 장점은 개발자가 한 번에 시스템의 일부에 집중할 수 있다는 점입니다. 도메인 로직을 다룰 때는 UI의 세부 사항이나 데이터를 가져오는 방법까지 함께 생각할 필요가 없습니다.
Domain-Driven Design에서는 User Interface, Application, Domain, Infrastructure 같은 용어를 씁니다. Eric Evans는 DDD Reference에서 이 계층들을 설명합니다. 다른 아키텍처에서는 이를 다르게 표현합니다. 가령 Alistair Cockburn의 Hexagonal Architecture는 위아래보다 안과 밖에 주목합니다. 도메인 로직은 자신을 호출하는 쪽이 그래픽 UI인지, 테스트인지, 다른 기술적 어댑터인지에 의존해서는 안 됩니다. 특정 데이터베이스나 외부 서비스에 결합되어서도 안 됩니다.
구체적인 이름과 경계, 다이어그램은 서로 다릅니다. 기본 발상은 비슷합니다.
서로 다른 책임이 통제 없이 뒤섞여서는 안 됩니다.
영감을 얻되 절대적인 규칙으로 삼지 않습니다
섹션 제목: “영감을 얻되 절대적인 규칙으로 삼지 않습니다”제가 프론트엔드 계층화를 이해하는 데 큰 영향을 준 것은 DDD에서 착안한 Angular 및 프론트엔드 아키텍처를 다룬 Manfred Steyer의 글입니다.
이 시리즈의 구조는 그 접근법을 그대로 따르지 않습니다. 거기서 얻은 영감에 실제 프로젝트, 장기 유지보수, 개발팀 내 협업에서 얻은 경험을 더했습니다.
제 해석은 몇몇 지점에서 전통적인 DDD 모델과 의도적으로 다릅니다. 특히 +state에서 그 차이가 뚜렷합니다. 이 영역은 도메인 로직의 상당 부분을 맡습니다. 비즈니스 규칙, 도메인에서 의미 있는 값의 파생, 상태 전이가 여기에 속합니다. Application 계층은 의도적으로 얇게 유지하고 뷰에 가깝게 둡니다.
그래서 이어지는 글에서는 프론트엔드에 적용할 DDD 계층화의 유일한 정답을 정하려 하지 않습니다. DDD에서 착안해 실무에서 검증한 모델을 소개하고, 무엇보다 일상에서 마주하는 질문 하나에 답하고자 합니다.
어떤 책임을 어디에 두어야 할까요?
문제의 핵심은 폴더가 아닙니다
섹션 제목: “문제의 핵심은 폴더가 아닙니다”계층화는 흔히 디렉터리 구조에서 가장 먼저 눈에 띕니다. 예를 들어 전통적인 백엔드 애플리케이션에서 이런 구조를 본 분들이 많을 겁니다.
src/├── controllers/├── services/├── repositories/└── entities/컨트롤러는 요청을 받고, 서비스는 애플리케이션 로직을 조율하며, 리포지토리는 데이터의 영속성을 담당합니다. 이렇게 책임마다 우선 서로 다른 자리를 마련합니다.
이런 구조는 도움이 됩니다. 다만 이것만으로는 아직 아키텍처라 할 수 없습니다.
디렉터리는 어떤 책임 영역을 마련해 두었는지 보여 줄 뿐입니다. 실제로 견고한 아키텍처가 되는지는 코드에서 결정됩니다.
각 영역이 무엇을 맡고 그 책임이 어디에서 끝나는지 분명해야 합니다. 팀이 이 경계를 제대로 이해하고 일관되게 지킬 때 비로소 폴더 구조가 아키텍처로 기능합니다.
일상에서 내려야 할 결정이 줄어듭니다
섹션 제목: “일상에서 내려야 할 결정이 줄어듭니다”좋은 아키텍처가 모든 논의를 없애 주지는 않습니다. 하지만 Feature를 만들 때마다 같은 기본 문제를 다시 논의하는 일은 줄여야 합니다.
비즈니스 규칙은 어디에 두어야 할까요?
어디에서 HTTP를 호출해도 될까요?
ViewModel은 어디에서 만들까요?
컴포넌트가 Store에 직접 접근해도 될까요?
여러 도메인 데이터 스트림을 어디에서 모을까요?
기존 상태에서 값을 파생하는 로직은 어디에 두어야 할까요?
공통 규칙이 없으면 개발자마다, Feature마다 답이 달라집니다. 그러면 그때그때 내린 개별 결정이 쌓여 서서히 아키텍처가 됩니다.
계층 사이에 뚜렷한 경계가 있으면 판단의 기준이 생깁니다. 모든 결정을 매번 새로 내릴 필요가 없습니다.
논의가 줄어들고 코드베이스의 구조도 더 쉽게 예측할 수 있습니다. 낯선 Feature를 살펴볼 때도 파일 하나 열기 전에 어떤 종류의 로직을 어디에서 찾을 수 있을지 대략 짐작할 수 있어야 합니다.
한 번에 생각해야 할 범위가 줄어듭니다
섹션 제목: “한 번에 생각해야 할 범위가 줄어듭니다”흔히 이 효과를 과소평가합니다.
제가 프레젠테이션 계층에서 작업할 때 그곳에 비즈니스 규칙을 구현하지 않는다는 사실을 알면, 그 순간에는 애플리케이션의 상당 부분을 이해할 필요가 없습니다.
도메인 규칙을 바꿀 때는 현재 어떤 UI 프레임워크를 쓰는지까지 같이 고민하고 싶지 않습니다.
백엔드 데이터를 연동할 때는 나중에 그 데이터를 어느 버튼으로 바꾸는지 신경 쓸 필요가 없어야 합니다.
이렇게 계층을 나누면 변경 하나를 위해 동시에 머릿속에 담아 두어야 할 맥락이 줄어듭니다. 이는 구현뿐 아니라 디버깅, 리뷰, 온보딩, 리팩터링에도 도움이 됩니다.
어떤 책임이 어느 영역에 속하는지 알면 시스템 전체를 속속들이 알지 않아도 한 부분을 안전하게 변경할 수 있습니다.
사람에게는 물론이고, 갈수록 도구에도 해당하는 이야기입니다.
AI 에이전트가 따라야 할 기준
섹션 제목: “AI 에이전트가 따라야 할 기준”AI를 활용한 개발에서는 이 특성이 또 다른 의미를 갖습니다.
에이전트는 코드를 아주 빠르게 생성할 수 있습니다. 하지만 특정 프로젝트가 어떤 아키텍처 의사결정을 내렸는지 저절로 알지는 못합니다. 경계가 명확하지 않으면 처음에는 여러 선택지가 그럴듯해 보입니다.
Store에서 HTTP를 호출할까?비즈니스 규칙을 컴포넌트에 둘까?Facade에서 매핑할까?State에서 화면 이동을 시작할까?기술적으로는 모두 구현할 수 있습니다. 중요한 건 어느 방식이 애플리케이션의 아키텍처에 맞느냐입니다.
명확히 정의한 아키텍처는 가능한 해법의 범위를 좁힙니다.
비즈니스 규칙은 +state에 두고, Infrastructure는 기술적 외부 세계를 캡슐화하며, 프레젠테이션 계층에는 도메인 로직을 두지 않는다고 정해 두면 이 규칙을 사람에게 전달하는 데 그치지 않습니다. 아키텍처 문서, 에이전트 지침, 생성기, 의존성 제약 조건, 리뷰, 정적 검사에도 이 규칙을 반영할 수 있습니다.
그러면 코드 조각을 생성할 때마다 아키텍처를 새로 합의할 필요가 없습니다.
에이전트에게 다음 작업만 주는 게 아닙니다.
이 Feature를 구현하세요.
지켜야 할 기준도 함께 줍니다.
이 아키텍처 안에서 이 Feature를 구현하세요.
코드를 더 빠르게 생성할 수 있을수록 어떤 규칙으로 코드의 구조를 제한할 것인지가 더 중요해집니다.
책임을 나누면 선택지가 생깁니다
섹션 제목: “책임을 나누면 선택지가 생깁니다”명확한 경계는 정리하는 데만 유용한 것이 아닙니다. 선택지도 넓혀 줍니다.
비즈니스 로직이 컴포넌트에 들어 있지 않으면 서로 다른 UI에서 같은 도메인 로직을 사용할 수 있습니다. Angular Material로 만든 화면이든, Ionic으로 만든 화면이든, 그 밖의 UI든 같은 도메인 판단을 다시 구현할 필요가 없습니다.
이론으로만 가능한 이야기는 아닙니다. 제가 장기간 진행한 프로젝트 중 하나에서는 같은 도메인 기반 위에서 Angular Material과 Ionic을 오랫동안 병행해 운영했습니다.
이 방식이 가능했던 것은 경계를 일관되게 지켰기 때문입니다. 프레젠테이션 계층은 도메인 로직의 결과를 보여 주고 사용자 상호작용을 처리할 수 있었지만, 같은 비즈니스 로직을 따로 구현해서는 안 됐습니다.
교체 가능성 자체가 반드시 목표인 것은 아닙니다. 언젠가 UI 프레임워크를 바꿀 수도 있다는 이유만으로 아키텍처를 더 복잡하게 만들 필요는 없습니다.
실제로 교체할 수 있는지 따져 보는 것은 책임 경계의 품질을 검증하는 좋은 방법입니다.
화면에 보여 주는 방식만 바뀌거나 외부 시스템과 연동하는 방식만 바뀐다면, 얼마나 많은 부분을 고쳐야 할까요?
변경과 도메인상 관련이 없는 코드까지 많이 손대야 한다면 그만큼 책임이 깔끔하게 나뉘지 않았다는 뜻입니다.
시스템과 통신하는 방식에도 같은 원리가 적용됩니다. Infrastructure가 제대로 캡슐화되어 있으면 도메인 로직은 데이터가 HTTP로 들어오는지, 로컬 저장소에서 오는지, 다른 방식으로 제공되는지 알 필요가 없습니다.
도메인 상태를 둘 곳이 명확하면 파생 로직과 규칙을 컴포넌트, 서비스, 뷰에 흩어 놓을 필요가 없습니다.
이 시리즈의 프론트엔드 계층화
섹션 제목: “이 시리즈의 프론트엔드 계층화”이어지는 글에서는 프론트엔드에 맞춰 의도적으로 전통적인 DDD와 다른 모델을 사용합니다.
예를 들어 Feature의 디렉터리는 다음과 같이 구성할 수 있습니다.
my-feature/├── domain/│ ├── infrastructure/│ ├── +state/│ └── application/├── models/└── presentation/여기서 domain은 Feature에서 UI에 속하지 않는 핵심 부분을 구조상 한데 묶는 이름입니다. DDD에서 말하는 전통적인 Domain Layer와는 범위가 다릅니다.
디렉터리 구조 자체가 런타임 데이터 흐름을 나타내는 것도 아닙니다.
이어지는 글에서는 데이터가 기술적 외부 세계에서 사용자 인터페이스까지 전달되면서 어떤 경계를 거치는지 살펴봅니다.
기술적 외부 세계 ↓Infrastructure ↓ +State ↓ Application ↓ Presentation ↓ 사용자각 영역의 역할은 분명히 나뉩니다.
Infrastructure는 기술적 외부 세계를 캡슐화하고 외부와 주고받는 내용을 Feature에서 쓸 수 있는 형태로 바꿉니다.
+State는 도메인의 런타임 상태를 표현합니다. 비즈니스 규칙, 상태 전이, 도메인에서 의미 있는 값의 파생, 선택, 도메인 Intent가 이 계층에 속합니다.
Application 계층은 의도적으로 얇게 유지합니다. 뷰마다 전용 Facade 하나를 두어 기존 데이터 흐름을 모으고, 그 뷰에 맞는 안정적인 계약을 프레젠테이션 계층에 제공합니다.
Presentation은 화면 표현과 사용자 상호작용을 맡습니다. 이미 정해진 도메인 규칙을 다시 해석하지 않습니다.
models는 조금 다른 역할을 합니다. 일부 모델은 의도적으로 계층 경계를 가로지릅니다. 예를 들어 Application에서 ViewModel을 만들고 프레젠테이션 계층에서 사용할 수 있지만, 그 때문에 ViewModel이 어느 한 영역에 전적으로 속하는 것은 아닙니다.
이 모델이 보편적인 정답인 것은 아닙니다. Domain-Driven Design을 프론트엔드에 그대로 옮기려는 시도도 아닙니다.
Manfred Steyer의 글 등에서 영감을 얻고 실제 프로젝트에 오랫동안 적용한 경험을 더해, 제가 프론트엔드 계층화를 해석한 방식입니다.
무엇보다도 책임이 어디에서 시작하고 어디에서 끝나는지 판단하는 기준입니다.