콘텐츠로 이동

+State – 도메인 로직의 자리

Infrastructure 글에서는 외부에서 받은 "ACTIVE"를 우리가 정의한 CustomerStatus.Active로 변환했습니다.

거기까지입니다.

이 값만으로는 고객이 주문할 수 있는지 아직 알 수 없습니다. 지금 어떤 작업을 할 수 있는지, 어떤 상태 전이가 허용되는지, 도메인 작업에 어떤 선택이 필요한지도 알 수 없습니다.

여기서 +State의 역할이 시작됩니다.

Infrastructure 계층은 외부에서 받은 값을 우리가 통제할 수 있는 표현으로 변환합니다. +State는 이 값들을 서로 연결하고 우리 도메인의 맥락에서 해석합니다.

Store의 역할은 데이터 저장에서 끝나지 않습니다

섹션 제목: “Store의 역할은 데이터 저장에서 끝나지 않습니다”

+State는 처음 보면 단순해 보일 때가 많습니다.

type CustomerState = {
customers: Customer[];
selectedCustomerId?: CustomerId;
loading: boolean;
};

이렇게 보면 상태에는 값만 들어 있습니다. 중요한 것은 이 값으로 어떤 질문에 답할 수 있느냐입니다.

어떤 고객이 선택되어 있나요?
그 선택은 아직 유효한가요?
어떤 고객이 특정 조건을 충족하나요?
현재 어떤 작업이 허용되나요?
상태가 바뀌면 어떤 결과가 생기나요?

이런 질문이 모두 비즈니스 규칙에 해당하는 것은 아닙니다. Store에 들어 있는 필드라고 해서 모두 도메인 상태가 되는 것도 아닙니다. 예를 들어 loading 플래그는 기술적 런타임 상태입니다. 로딩은 불리언이 아닙니다(독일어)에서 보듯 단순한 스위치로 충분한 경우는 드뭅니다.

+State의 역할은 값을 저장하는 데서 끝나지 않습니다. 애플리케이션의 현재 상태를 바탕으로 상태 전이가 일어나고, 파생 값이 생기며, 도메인 판단이 이루어집니다.

상태의 의미는 값 사이의 관계, 적용되는 규칙, 그리고 상태에서 파생되는 값에서 생깁니다.

Infrastructure 계층에서 변환한 값을 +State가 받아 비즈니스 규칙, 값의 파생, 상태 전이를 통해 canOrder, selectedCustomer, allowedActions 등 도메인에서 의미 있는 결과를 내는 구조

+State 처리 과정 그림 원본 크기로 열기

Store는 클라이언트 캐시에 그치지 않습니다

섹션 제목: “Store는 클라이언트 캐시에 그치지 않습니다”

상태 관리를 아주 단순하게 생각하면 다음과 같습니다.

API
↓
Store가 응답을 저장
↓
컴포넌트가 응답을 읽음

이것으로 충분할 수 있습니다. 다만 아키텍처 관점에서 이 모델의 Store는 백엔드 데이터의 캐시에 가깝습니다. 값을 꺼내 쓸 수 있게 보관할 뿐, 그 값에 의미를 부여하지는 않습니다.

여기서 다루는 +State의 역할은 더 넓습니다.

Infrastructure
↓
+State
├── 상태를 소유
├── 도메인 Intent를 처리
├── 비즈니스 규칙을 적용
├── 상태 전이를 모델링
└── 파생 값을 생성

Signals, NgRx, Redux, Zustand, RxJS 중 무엇을 쓰든, 다른 방식으로 상태를 관리하든 이 책임은 달라지지 않습니다.

라이브러리는 상태를 어떻게 관리할지 정합니다. 아키텍처는 그 상태가 어떤 책임을 맡을지 정합니다.

Infrastructure 계층에서 값을 변환했습니다.

"ACTIVE"
↓
CustomerStatus.Active

이제 +State는 이 상태를 다른 정보와 함께 평가할 수 있습니다.

CustomerStatus.Active
+
CreditHold.None
+
Account.enabled
↓
canOrder

고객이 주문할 수 있는지 판단하는 일은 외부 값을 변환하는 단계를 넘어섭니다. 이 판단에는 우리 시스템의 규칙이 적용됩니다.

다음 질문도 마찬가지입니다.

  • 주문을 취소할 수 있나요?
  • 데이터 레코드를 삭제할 수 있나요?
  • 이 상태 전이가 허용되나요?
  • 현재 도메인 상황에서 어떤 작업을 할 수 있나요?
  • 엔티티가 특정 도메인 조건을 충족하나요?

비즈니스 규칙의 결과로 버튼을 비활성화한다고 해서 그 규칙이 프레젠테이션 로직이 되는 것은 아닙니다.

그런데도 비즈니스 규칙은 바로 이런 곳에 들어가기 쉽습니다.

disabled = customer.status !== CustomerStatus.Active || customer.creditHold !== CreditHold.None;

화면이 하나뿐일 때는 별문제 없어 보입니다.

하지만 Ionic 화면이나 모바일 화면, 또는 다른 곳에서도 같은 판단이 필요해지면 같은 규칙을 여러 곳에서 구현하게 됩니다.

도메인 상태에서 판단한 결과를 한곳에서 제공할 수 있습니다.

canOrder;

프레젠테이션 계층은 그 상태를 어떻게 보여 줄지 결정합니다. 버튼을 비활성화할 수도 있고, 작업을 회색으로 표시하거나 메뉴 항목을 숨길 수도 있습니다.

도메인에서 그 작업을 허용하는지는 프레젠테이션 계층이 다시 판단하지 않습니다.

모든 정보를 따로 저장할 필요는 없습니다.

customers
+
selectedCustomerId
↓
selectedCustomer

이처럼 customers와 selectedCustomerId에서 selectedCustomer를 파생할 수 있습니다.

visibleCustomers도 같은 방식으로 구할 수 있습니다.

customers
+
filter
+
sort
↓
visibleCustomers

selectedCustomer와 visibleCustomers를 원본 상태의 복사본으로 따로 저장하고, 변경될 때마다 수동으로 맞출 필요는 없습니다.

기존 상태에서 계산하면 됩니다.

이렇게 하면 같은 정보가 중복되어 생기는 동기화 문제가 줄어듭니다. 저장된 두 값이 같은 정보를 나타내는 순간, 두 값이 계속 일치하도록 유지할 장치가 필요합니다. 기존 상태에서 파생한 값에는 이런 동기화가 필요 없습니다.

고객 목록, 선택한 고객의 ID, 필터, 정렬 조건을 원본 상태로 저장하고 selectedCustomer, visibleCustomers, canOrder를 파생 상태로 계산하는 구조

원본 상태와 파생 상태 그림 원본 크기로 열기

실무에서 쿼리 상태와 파생 상태를 어떻게 구분하는지, 필터와 정렬 조건 자체가 왜 상태에 속할 수 있는지는 반응형 필터와 정렬(독일어)에서 자세히 설명합니다.

선택도 상태에 속할 수 있습니다

섹션 제목: “선택도 상태에 속할 수 있습니다”

선택한 엔티티 전체를 한 번 더 저장할 필요는 없습니다.

entities
+
selectedId
↓
selectedEntity

선택이 도메인이나 애플리케이션 전체에서 의미가 있다면, 원본 상태에는 ID만으로 충분할 수 있습니다. 선택된 엔티티는 이 ID를 사용해 파생할 수 있습니다.

선택이 +State에 속하는지는 그 선택이 무엇을 뜻하느냐에 달려 있습니다. 테이블의 행을 잠시 강조하는 것은 화면 표시만의 문제일 수 있습니다. 이후 도메인 작업의 기준이 되는 선택은 수명 주기와 책임이 다릅니다.

선택 흐름을 구체적으로 어떻게 나눌 수 있는지는 ID로 선택하기(독일어)에서 살펴봅니다.

여러 소스를 조합해 하나의 프로젝션을 만들 수 있습니다

섹션 제목: “여러 소스를 조합해 하나의 프로젝션을 만들 수 있습니다”

값을 파생할 때 소스가 하나일 필요는 없습니다.

articles
+
authors
+
categories
↓
프로젝션

여러 상태 소스를 조합해 사용하는 쪽에서 바로 쓸 수 있는 프로젝션을 만들 수 있습니다.

Store나 소스가 몇 개인지보다 중요한 것은 그렇게 만들어진 정보를 누가 책임지느냐입니다.

여러 데이터 소스로 ViewModel 만들기(독일어)에서는 여러 반응형 소스를 어떻게 조합하는지 보여 줍니다. 이벤트 기반 프로젝션(독일어)에서는 이벤트를 바탕으로 프로젝션을 만들고 갱신하는 방식을 다룹니다.

두 방식의 기본 발상은 같습니다. 프로젝션을 사용하는 쪽에서 바탕이 되는 상태의 내부 구조까지 알 필요는 없습니다.

모든 상태를 Store 하나에 담을 필요는 없습니다

섹션 제목: “모든 상태를 Store 하나에 담을 필요는 없습니다”

지금까지의 설명이 기능 하나마다 큰 +State를 정확히 하나씩 둬야 한다는 뜻은 아닙니다.

파일 크기나 여러 상태가 우연히 같은 엔티티 타입을 쓴다는 사실은 Store의 경계를 정하는 주된 기준이 아닙니다.

다음 질문이 더 중요합니다.

  • 어떤 책임을 함께 묶는 것이 자연스러운가요?
  • 상태의 수명 주기가 같은가요?
  • 같은 이유로 변경되나요?
  • 누가 그 상태를 소유하나요?
  • 누가 그 상태를 사용하나요?

두 상태가 같은 Customer 타입을 쓰더라도 서로 다른 책임을 맡을 수 있습니다.

반대로 여러 데이터 타입이 같은 도메인 상태 하나를 구성할 수도 있습니다.

Read Store가 너무 커질 때(독일어)에서 이런 경계를 자세히 다룹니다.

+State는 어떤 종류의 책임을 맡는 계층인지를 나타냅니다. 그 책임을 Store 하나에 모두 넣으라는 뜻은 아닙니다.

+State는 읽을 수 있는 상태를 소유하는 데 그치지 않습니다. 도메인 변경을 요청하는 Intent를 현재 상태에 비추어 처리하는 곳이기도 합니다.

deleteRequested
↓
현재 상태
↓
허용 여부 판단
↓
상태 변경

다음도 같은 예입니다.

completeOrder
↓
비즈니스 규칙
↓
상태 전이

Intent는 우선 무엇을 하려는지 나타냅니다.

“이 고객을 삭제해 주세요”와 “이 고객이 삭제되었습니다”는 서로 다른 말입니다.

요청한 변경이 허용되는지, 그 결과 어떤 도메인 상태가 되는지는 규칙과 현재 상태에 달려 있습니다.

이렇게 책임을 기준으로 Create, Retrieve, Update, Delete 흐름을 나누는 방법은 CRUD Slices 시리즈(독일어)에서 자세히 설명합니다.

여기서 중요한 경계는 더 간단합니다. 도메인 변경 Intent의 의미가 컴포넌트나 HTTP 서비스에 가서야 결정되어서는 안 됩니다.

ViewModel은 어디에서 만들어질까요?

섹션 제목: “ViewModel은 어디에서 만들어질까요?”

+State는 나중에 ViewModel을 만드는 데 쓸 상태와 파생 값을 제공할 수 있습니다.

모든 뷰용 프로젝션을 Store에서 완성할 필요는 없습니다.

프로젝션을 사용하면 도메인 상태를 다른 곳에서 쓸 수 있는 형태로 제공할 수 있습니다. Application 계층은 이렇게 제공된 정보를 특정 뷰에 맞게 모으거나, 그 뷰가 쓰기 좋은 API를 제공할 수 있습니다.

어디에 경계를 두는 것이 적절한지는 책임을 어떻게 나누느냐에 달려 있습니다.

ViewModel 집계(독일어)에서는 백엔드 구조나 상태의 내부 세부 사항을 프레젠테이션 계층에 그대로 넘기지 않고 여러 데이터 소스로 ViewModel을 만드는 방법을 자세히 다룹니다.

+State에서 중요한 점은 비즈니스 규칙과 도메인에서 의미 있는 파생 값이 특정 화면을 만들 때에야 비로소 생겨서는 안 된다는 것입니다.

+State가 맡을 일은 다음과 같습니다.

  • 도메인에서 의미 있는 런타임 상태 소유
  • 비즈니스 규칙 적용
  • 도메인 상태 전이 모델링
  • 도메인 Intent 처리
  • 파생 상태 생성
  • 필요한 선택 정보 제공
  • 도메인에 필요한 필터링과 프로젝션 처리
  • 도메인에서 의미 있는 이벤트에 반응
  • 특정 화면과 무관하게 적용되는 규칙을 한곳에서 관리

다음은 +State에 두지 않는 편이 좋습니다.

  • HTTP 요청 직접 구현
  • DTO 파싱
  • 외부 API 계약을 도메인 내부까지 그대로 전달
  • HttpClient, fetch 또는 특정 SDK의 API 직접 사용
  • 기술적 API 오류 코드 해석
  • 라우터 직접 제어
  • 다이얼로그 열기
  • 스낵바나 토스트 표시
  • DOM이나 UI 프레임워크의 세부 사항 다루기
  • Angular Material, Ionic, Bootstrap을 구분해 처리
  • Application 계층이 맡는 특정 뷰의 오케스트레이션 수행

경계가 모호할 때는 다음 질문이 도움이 됩니다.

내일 Material을 Ionic으로 바꿔도 이 규칙이 여전히 적용될까요?

그렇다면 +State에 둘 만한 규칙입니다.

정의라고 할 수는 없지만, 의외로 실용적인 기준입니다.

여러 화면에서 같은 도메인 로직 사용하기

섹션 제목: “여러 화면에서 같은 도메인 로직 사용하기”

여러 화면에서 같은 도메인 로직을 쓰면 이렇게 책임을 나눈 이점이 특히 잘 드러납니다.

한 장기 프로젝트에서는 동일한 도메인 기반 위에서 Angular Material과 Ionic을 수년간 함께 운영했습니다.

두 프레젠테이션 계층에 비즈니스 규칙을 따로 구현하지 않았기에 가능했습니다.

+State
/ \
/ \
Material Ionic

프레젠테이션 계층은 표현 방식을 결정합니다. +State는 도메인 판단 결과를 제공합니다.

두 프레젠테이션 계층에서 canOrder를 따로 계산했다면, 두 구현을 계속 맞춰야 했을 것입니다. 언젠가는 두 화면이 같은 도메인 질문에 서로 다른 답을 내놓을 수도 있었습니다.

공통 +State 계층이 Angular Material 화면과 Ionic 화면에 동일한 비즈니스 규칙의 판단 결과와 파생 값을 제공하는 구조

여러 화면이 도메인 로직을 공유하는 구조 그림 원본 크기로 열기

이렇게 분리하면 다른 이점도 생깁니다.

비즈니스 규칙을 찾기 쉬워집니다. 도메인 판단이 컴포넌트, 파이프, 폼 검증기, 서비스, 템플릿에 흩어져 있으면 한곳에서 추적할 수 없습니다. 여러 곳의 코드를 종합해 판단을 재구성해야 합니다.

canOrder가 도메인 상태에서 만들어진다는 사실을 알면 어디서 규칙을 찾아야 하는지도 알 수 있습니다.

같은 정보를 여러 개 복사해 수동으로 맞춰 둘 필요가 없으므로 파생 값도 일관성을 유지합니다.

또한 비즈니스 규칙을 특정 화면과 독립적으로 테스트할 수 있습니다. Material이 버튼을 그리든 Ionic이 메뉴 항목을 표시하든 canOrder 판단에는 영향이 없습니다.

이 이점을 만드는 것은 상태 관리 라이브러리가 아닙니다. 책임 경계입니다.

모든 상태가 +State에 속하지는 않습니다

섹션 제목: “모든 상태가 +State에 속하지는 않습니다”

도메인 로직을 어디에 둘지 분명히 했다고 해서 모든 변수를 Store로 옮겨야 하는 것은 아닙니다.

예를 들어 이런 값이 있습니다.

isDialogOpen
hoveredRow
activeTab
tooltipVisible
accordionExpanded

이런 값은 대개 프레젠테이션 상태입니다. 특정 화면이 지금 어떻게 표시되고 있는지를 나타냅니다.

이 경계에도 예외가 있습니다. 예를 들어 activeTab이 어느 시점부터 도메인에서 의미 있는 선택을 나타낼 수도 있습니다. 변수 이름만으로는 판단하기 어렵습니다.

다음 질문이 더 도움이 됩니다.

이 상태는 현재 표시 방식과 관계없이 의미가 있나요?

그렇지 않다면 +State에 둘 상태가 아닐 가능성이 큽니다.

+State는 도메인에서 의미 있는 상태와 비즈니스 규칙, 파생 값, 선택, 상태 전이, 도메인 Intent를 소유합니다.

그렇다고 특정 뷰가 그 상태 전체를 알아야 하는 것은 아닙니다.

고객 목록 뷰에는 다음 정도만 필요할 수 있습니다.

customers
loading
selectCustomer()
createCustomer()

상세 뷰에는 같은 도메인 로직에서 다른 부분이 필요합니다.

여기서 다음 책임 경계가 생깁니다. +State는 도메인 상태와 로직을 소유하고 도메인 상태를 해석합니다. Application 계층은 이를 바탕으로 특정 유스케이스나 뷰에 맞는 API를 제공합니다.

따라서 도메인 로직은 한곳에 머물고, 각 프레젠테이션 계층은 도메인 내부 구조 전체를 알 필요가 없습니다.