콘텐츠로 이동

Application – 뷰를 위한 도메인 API

+State 글에서는 도메인 로직과 상태의 책임을 분명히 했습니다. 도메인에서 의미 있는 상태, 비즈니스 규칙, 값의 파생, 선택, 상태 전이, 도메인 Intent는 모두 +State에 속합니다.

개별 뷰에 필요한 것은 대개 그중 일부입니다.

customers
loading
selectCustomer()
createCustomer()

여기서 Application 계층의 역할이 시작됩니다.

이 계층이 복잡해졌다면 위나 아래 계층이 맡아야 할 책임이 들어온 경우가 많습니다.

전통적인 DDD와 달리 책임을 좁힌 이유

섹션 제목: “전통적인 DDD와 달리 책임을 좁힌 이유”

전통적인 DDD 계층 모델에서는 흔히 Application 계층에 애플리케이션 서비스와 유스케이스를 두고 그 흐름을 조율합니다. 이 계층이 유스케이스를 진행하고, 실제 비즈니스 규칙은 도메인이 소유합니다.

이 모델에서는 책임 범위를 더 좁힙니다. 도메인 판단과 상태 전이, 프로젝션이 이미 +State에 있으므로 그 위에 유스케이스 오케스트레이션을 한 겹 더 두지 않습니다.

그래서 많은 전통적 DDD 아키텍처보다 Application 계층을 의도적으로 얇게 유지합니다. 이상적으로는 거의 전부가 Facade입니다.

편의상 택한 지름길이 아니라, 프론트엔드의 요구에 맞춰 내린 설계 결정입니다. 뷰에는 도메인에 접근할 안정적인 통로가 필요합니다. 새로운 도메인 로직이 생기는 곳은 여전히 +State입니다.

도메인 내부가 CustomerState, OrderState, PermissionState, SelectionState로 나뉘어 있더라도 프레젠테이션 계층이 그 사실을 알 필요는 없습니다.

Facade가 없으면 뷰가 내부의 여러 상태 영역에 직접 접근할 수 있습니다.

customerState.customers;
customerState.selectedCustomer;
orderState.canOrder;
permissionState.canEdit;

그러면 프레젠테이션 계층이 도메인 내부의 분할 구조까지 알아야 합니다.

Facade를 두면 뷰에 보이는 것은 다음뿐입니다.

facade.customers;
facade.selectedCustomer;
facade.canOrder;
facade.canEdit;

Facade는 그 아래의 구조를 압니다. 뷰는 자신에게 제공된 계약만 압니다.

고객 목록 뷰가 CustomerListFacade를 통해서만 도메인 내부의 CustomerState, OrderState, PermissionState에 접근하는 구조

별도 로직을 두지 않는 CustomerListFacade가 유일한 진입점이며, 도메인 내부의 상태 구조는 이 Facade만 압니다.

도메인 진입점 그림 원본 크기로 열기

이 발상은 고전적인 Facade 패턴에서 가져왔습니다. Facade는 복잡한 하위 시스템에 접근할 수 있는 단순한 인터페이스를 제공합니다(Design Patterns: Elements of Reusable Object-Oriented Software, Gamma/Helm/Johnson/Vlissides, 1994). 여기서는 같은 원칙을 프레젠테이션 계층과 도메인 사이의 경계에 적용합니다.

전통적인 MVC에 익숙하다면 화면과 모델 사이에 정해진 진입점을 두는, 뷰에 가까운 컨트롤러를 떠올려도 좋습니다. 다만 이 모델에서 Facade의 책임은 훨씬 좁습니다. 자체 도메인 로직이나 애플리케이션 로직을 만들지 않습니다.

Facade는 +State에 이미 있는 값과 데이터 흐름을 모아 뷰에 맞는 계약으로 제공할 수 있습니다.

export class CustomerDetailFacade {
readonly customer = this.customerState.selectedCustomer;
readonly canDelete = this.customerState.canDelete;
readonly loading = this.customerState.loading;
deleteCustomer(): void {
this.customerState.deleteSelected();
}
}

좋은 Facade의 예입니다. 기존 값을 공개하고 호출을 위임하면서 내부 구조를 감춥니다. 새로운 도메인 의미를 만들어 내지 않습니다.

기존 스트림이나 반응형 값을 여러 개 가져와 같은 계약에 나란히 둘 수도 있습니다. 그 값들을 바탕으로 새로운 도메인 판단을 내리는 일은 Facade의 몫이 아닙니다.

readonly canOrder = combineLatest([
this.customerState.customer$,
this.orderState.orders$,
this.permissionState.permissions$,
]).pipe(
map(([customer, orders, permissions]) => {
// 여기서 도메인 판단을 내립니다
}),
);

여러 데이터 소스를 종합해야 도메인 판단을 내릴 수 있다면, 그 판단은 +State에서 이미 끝나 있어야 합니다.

Application 계층은 계산된 결과만 공개합니다.

readonly canOrder = this.orderState.canOrder;

Facade는 여러 데이터 흐름을 한곳에 모을 수 있습니다. 그 흐름을 결합해 도메인 판단을 내리는 책임은 +State에 있습니다.

Facade는 판단을 내리지 않습니다.

비즈니스 규칙을 여기에 두지 않습니다.

save(): void {
if (this.customerState.customer().status === CustomerStatus.Active) {
// ...
}
}

도메인에서 의미 있는 값을 파생하는 일도 마찬가지입니다. 다음 예에서 필터링과 정렬이 상태나 도메인에서 의미 있는 프로젝션에 속한다면 Facade에서 처리하지 않습니다.

readonly visibleCustomers = computed(() =>
this.customerState.customers()
.filter(...)
.sort(...),
);

UI도 Facade의 책임 범위 밖에 있습니다.

delete(): void {
if (confirm('Really delete?')) {
// ...
}
}

Facade는 아래처럼 호출을 그대로 위임할 수 있습니다.

deleteCustomer(): void {
this.customerState.deleteSelected();
}

이미 있는 상태를 공개할 수도 있습니다.

readonly canDelete = this.customerState.canDelete;

메서드가 이렇게 단순한 데에는 이유가 있습니다. Facade 코드가 흥미로워지기 시작하면 다른 계층의 책임이 흘러들어 왔는지 살펴볼 만합니다.

Facade가 값을 공개하고 호출을 위임하기만 한다면 프레젠테이션 계층에서 +State에 바로 접근해도 될 것 같습니다.

그렇게 하면 프레젠테이션 계층이 도메인의 내부 구조까지 알게 됩니다.

오늘은 의존성이 하나뿐일 수 있습니다.

CustomerListComponent
↓
CustomerState

새로운 요구사항이 생기면 의존성이 더 늘어납니다.

CustomerListComponent
├── CustomerState
├── PermissionState
├── SelectionState
└── OrderState

이렇게 도메인의 내부 분할 구조가 뷰 계약의 일부가 됩니다.

Facade를 두면 진입점은 하나로 유지됩니다.

CustomerListView
↓
CustomerListFacade
↓
도메인 내부 구조

도메인 내부를 다시 나눠도 프레젠테이션 계층에서 그 변경을 따라갈 필요가 없습니다.

겉보기에 단순한 이 계층의 가치는 여기에 있습니다. 구조적 결합도를 낮춥니다.

이 모델의 규칙은 간단합니다.

뷰마다 그 뷰에 대응하는 Facade를 정확히 하나 둡니다.

CustomerListView ↔ CustomerListFacade
CustomerDetailView ↔ CustomerDetailFacade
CustomerEditView ↔ CustomerEditFacade

모든 고객 관련 뷰가 공통 CustomerFacade를 쓰는 방식은 처음에는 매력적으로 보입니다.

CustomerList
CustomerDetail
CustomerEditor
↓
CustomerFacade

하지만 뷰가 하나씩 늘어날 때마다 그 계약도 커집니다.

CustomerList
CustomerDetail
CustomerEditor
CustomerHistory
CustomerSearch
CustomerAdmin
CustomerExport
↓
CustomerFacade

처음에는 customers와 selectedCustomer만 있던 계약에 어느새 history, orders, permissions, search, filter, sort, create, update, delete, archive, export 등이 더해집니다. 각 항목을 필요로 하는 뷰는 그중 일부뿐입니다.

결국 Facade는 온갖 책임이 몰린 거대 서비스가 됩니다.

문제는 책임이 어디까지인지 정할 자연스러운 기준이 없다는 데 있습니다. 뷰가 3개든 5개든 10개든, 그 수 자체가 아키텍처의 경계를 정하는 기준은 아닙니다. 공유 속성의 비율을 기준으로 삼아도 일관된 규칙을 얻기 어렵습니다.

1:1 관계를 두면 간단히 결정할 수 있습니다.

뷰의 책임이 끝나는 곳에서 Facade의 책임도 끝납니다.

크기를 어림잡거나 속성 수의 상한을 논의할 필요가 없습니다. 뷰 자체가 경계를 정합니다.

왼쪽에서는 여러 고객 뷰가 하나의 CustomerFacade를 공유하고, 오른쪽에서는 뷰마다 전용 Facade를 하나씩 두는 구조

왼쪽의 공용 Facade는 사용하는 뷰가 늘수록 계약이 커집니다. 오른쪽에서는 뷰마다 더 단순하고 안정적인 계약을 유지합니다.

뷰별 Facade 비교 그림 원본 크기로 열기

위임 코드의 중복은 허용합니다

섹션 제목: “위임 코드의 중복은 허용합니다”

1:1 규칙을 따르면 비슷하거나 아예 똑같아 보이는 Facade가 생길 수밖에 없습니다.

export class CustomerListFacade {
readonly customers = this.customerState.customers;
}
export class CustomerSearchFacade {
readonly customers = this.customerState.customers;
}

의도한 결과입니다.

두 계약은 각각 독립적으로 바뀔 수 있습니다. 지금 같은 프로젝션을 공개한다는 사실만으로 두 Facade의 책임을 묶을 이유는 없습니다.

위임 코드를 중복하는 비용은 낮습니다. 책임을 서로 결합하는 비용은 높습니다.

DRY 원칙을 마음대로 무시해도 된다는 뜻은 아닙니다. 중요한 것은 변경 이유입니다. 고객 목록 뷰의 계약이 바뀌면 CustomerListFacade가 바뀝니다. 검색 뷰의 계약이 바뀌면 CustomerSearchFacade가 바뀝니다.

다음은 애플리케이션 전체에 관한 질문입니다.

우리 애플리케이션은 고객과 관련해 어떤 일들을 할 수 있나요?

Facade가 답할 질문의 범위는 뷰 하나입니다.

이 뷰가 도메인에서 필요로 하는 것은 정확히 무엇인가요?

CustomerListFacade, CustomerDetailFacade, CustomerEditFacade처럼 이름을 붙이면 그 책임이 드러납니다. Facade는 특정 뷰를 위한 도메인 API이며, 그 뷰가 사용해도 되는 것만 공개합니다.

Application 계층의 Facade가 맡을 수 있는 일은 다음과 같습니다.

  • +State 사용
  • 이미 있는 상태 값과 프로젝션 값 공개
  • 기존 스트림 수집
  • Intent와 Command를 +State에 위임
  • 해당 뷰에 맞는 계약 제공
  • 프레젠테이션 계층에서 도메인 내부 구조가 보이지 않도록 감추기
  • 도메인 내부의 여러 소스를 뷰 계약 하나로 캡슐화
  • 이미 만들어진 ViewModel이나 프로젝션 공개

Application 계층의 Facade는 다음 일을 맡지 않는 편이 좋습니다.

  • 비즈니스 규칙 구현
  • 도메인 판단
  • 도메인에서 의미 있는 파생 상태 생성
  • 여러 스트림을 결합해 도메인 의미 도출
  • 자체 상태 전이 모델링
  • DTO 파싱
  • HTTP 통신이나 외부 SDK 사용
  • 기술적 계약 해석
  • 라우터 제어
  • 다이얼로그, 토스트, 스낵바 띄우기
  • DOM이나 UI 프레임워크의 세부 사항 다루기
  • Material, Ionic, Bootstrap에 종속되는 결정 내리기
  • 재사용을 위해 여러 뷰를 하나의 거대한 공용 Facade에 묶기

뷰마다 도메인 진입점이 하나씩 생깁니다. 각각의 값이 어디에서 오는지, 계약 뒤에 Store나 프로젝션이 몇 개 있는지 뷰는 몰라도 됩니다. 도메인 내부를 다시 나누더라도 프레젠테이션 계층마다 그 변경을 따라갈 필요가 없습니다.

변경 이유도 해당 뷰에 머뭅니다. 고객 편집 뷰에 기능이 추가된다고 고객 목록 뷰의 계약까지 커지지는 않습니다. 각 Facade는 자신이 담당하는 뷰에 맞는 작은 규모를 유지합니다. 곳곳에서 위임 코드가 중복되는 정도라면 독립적인 계약을 유지하는 데 드는 비용은 낮습니다.

Application 코드가 드러내는 경계에서 실질적인 이점이 생깁니다.

실제 Application 계층은 다음과 같은 클래스로 거의 전부를 구성할 수도 있습니다.

export class CustomerListFacade {
readonly customers = this.customerState.customers;
readonly loading = this.customerState.loading;
selectCustomer(id: CustomerId): void {
this.customerState.select(id);
}
createCustomer(): void {
this.customerState.create();
}
}

이 정도로 단순해도 계층의 역할은 분명합니다. 이 계층의 가치는 뷰에 맞는 계약을 제공하고 도메인과 프레젠테이션의 구조적 결합도를 낮추는 데 있습니다.

좋은 Facade는 지루합니다. 이미 있는 도메인 로직을 정확히 하나의 뷰에서 쓸 수 있게 합니다.

도메인 로직은 +State가 소유합니다. Application 계층은 개별 뷰가 그 로직에 접근할 수 있도록 뷰에 맞는 계약을 제공합니다. 도메인은 뷰를 모릅니다. Facade는 양쪽을 알지만 새 도메인 로직을 만들지는 않습니다.

이 계약을 경계로 프레젠테이션 계층이 시작됩니다.