DDD (Domain-Driven Design, 도메인 주도 설계)

기획자: "주문이 확정되면 정산 대상이 돼요."
개발자: (orders 테이블 status를 'CONFIRMED'로 바꾸고,
         settlement 테이블에 row를 insert 하면 되겠군)

3개월 뒤
기획자: "부분 취소된 주문도 확정은 확정이죠. 근데 정산은 남은 금액만 해야 해요."
개발자: (확정이 그런 뜻이었어?)

// 이 조건이 무슨 업무 규칙인지 코드만 봐서는 알 수 없다
if (order.status === 'PAID' && order.shippedAt == null && !order.isGift && dayjs().diff(order.paidAt, 'day') < 7) {
  // ...
}

if (order.isCancellable()) {
  // ...
}

flowchart TB
    DDD[DDD]
    DDD --> S[전략 설계<br/>Strategic Design]
    DDD --> T[전술 설계<br/>Tactical Design]

    S --> S1[유비쿼터스 언어]
    S --> S2[서브도메인]
    S --> S3[Bounded Context]
    S --> S4[Context Map]

    T --> T1[Entity]
    T --> T2[Value Object]
    T --> T3[Aggregate]
    T --> T4[Repository]
    T --> T5[Domain Service]
    T --> T6[Domain Event]

class Order {
  confirm(): void { /* 주문 확정 */ }
  confirmPurchase(): void { /* 구매 확정: 반품 기간이 끝나 정산 가능한 상태 */ }
  requestReturn(reason: ReturnReason): void { /* 반품 요청 */ }
}

requestReturn(reason: ReturnReason): void {
  if (this.isPurchaseConfirmed()) {
    throw new CannotReturnAfterPurchaseConfirmedException();
  }
  // ...
}

// 도메인 모델: 규칙이 객체 안에 있다
export class Order {
  private constructor(
    readonly id: OrderId,
    private status: OrderStatus,
    private readonly lines: OrderLine[],
  ) {}

  cancel(): void {
    if (this.status === OrderStatus.SHIPPED) {
      throw new CannotCancelShippedOrderException(this.id);
    }
    this.status = OrderStatus.CANCELLED;
  }

  totalAmount(): Money {
    return this.lines.reduce((sum, line) => sum.add(line.amount()), Money.zero());
  }
}

┌──────────────────────────────────────────┐
│ Infrastructure (DB, MQ, 외부 API)        │
│  ┌────────────────────────────────────┐  │
│  │ Application (유스케이스 조율)      │  │
│  │  ┌──────────────────────────────┐  │  │
│  │  │ Domain (도메인 모델)         │  │  │
│  │  │ 순수 TypeScript, 의존 없음   │  │  │
│  │  └──────────────────────────────┘  │  │
│  └────────────────────────────────────┘  │
└──────────────────────────────────────────┘
         의존은 바깥에서 안쪽으로만

src/
├── order/                      # 주문 Bounded Context
│   ├── domain/                 # 순수 도메인: 프레임워크 import 없음
│   │   ├── order.ts            # Aggregate Root
│   │   ├── order-line.ts       # Entity
│   │   ├── money.ts            # Value Object
│   │   ├── order.repository.ts # Repository 인터페이스
│   │   └── events/order-placed.event.ts
│   ├── application/            # 유스케이스
│   │   └── place-order.service.ts
│   ├── infrastructure/         # 기술 구현
│   │   ├── typeorm-order.repository.ts
│   │   └── order.orm-entity.ts
│   ├── presentation/
│   │   └── order.controller.ts
│   └── order.module.ts
├── payment/                    # 결제 Bounded Context
└── shipping/                   # 배송 Bounded Context