[3주차] 도메인 주도 설계 구현 - 강담희

[dame2]

📌 Summary

• 배경: 기존 도메인 레이어가 JPA 어노테이션에 직접 의존하여 순수 DDD 원칙을 위반하고 있었으며, 테스트 시 Spring Context가 필요한 구조였음
• 목표: Domain Layer를 순수 Java로 구현하여 프레임워크 독립성 확보 및 Fake Repository를 활용한 빠른 단위 테스트 환경 구축
• 결과: Brand, Product, Like, Order 도메인을 순수 DDD 패턴으로 구현하고, Value Object, Domain Service, Application Service, REST API까지 전 계층 구현 완료

🧭 Context & Decision

문제 정의

• 현재 동작/제약: Domain Entity가 @Entity, @Table 등 JPA 어노테이션을 직접 사용하여 Infrastructure 계층에 결합됨
• 문제(또는 리스크):
  • 도메인 로직 테스트 시 DB/Spring Context 필요
  • 도메인 객체가 영속성 관심사에 오염됨
  • 계층 간 의존성 역전 원칙(DIP) 위반
• 성공 기준: Domain Layer에 jakarta.persistence.*, org.springframework.* import 금지, Fake Repository로 단위 테스트 가능

선택지와 결정

1) 도메인 모델을 어떻게 영속화할 것인가 (Domain 순수성)

• 고려한 대안
  A: Domain Entity에 JPA 어노테이션 직접 사용

  • Domain 객체가 @entity, @table 등으로 영속성 모델을 겸함
  • 빠르게 구현 가능하지만 Domain이 Infrastructure에 결합

  B: Domain Entity와 JPA Entity 분리 + Mapper(현재 선택한 방향)

  • Domain은 순수 Java, Infrastructure에 JPA Entity + Mapper + Impl Repository
  • DIP를 지키면서 테스트 격리(Fake Repo)가 쉬움

  C: Domain Entity 분리 + “도메인 친화” ORM/모듈(예: Spring Data/JPA 스펙 노출 최소화)

  • 완전 분리 대신, Repository 인터페이스/쿼리 타입만 부분적으로 활용
    -“순수성”은 일부 희생하지만 구현/운영 난이도는 낮출 수 있음 (다만 성공기준의 import 금지와 충돌 가능)

• 최종 결정

  • B안 채택: Domain ↔ JPA Entity 분리 + Mapper 패턴
  • 성공 기준(도메인 패키지에 jakarta., org.springframework. import 금지)과 Fake Repo 기반 단위 테스트 목표에 가장 부합

• 트레이드 오프

  • 코드량 증가: Mapper/Impl/Entity가 추가되어 파일 수와 변경 범위가 커짐
  • 동기화 비용: Domain과 JPA Entity 필드/규칙 불일치 위험(리팩터링 시 누락)
  • 성능/쿼리 튜닝 난이도: 매핑 계층이 늘어 최적화 포인트가 분산될 수 있음

2) “여러 Aggregate 협력”은 어디에서 조정할 것인가 (Application vs Domain Service)

• 고려한 대안
  A: 모든 규칙을 각 Aggregate(Entity) 내부에 넣기

  • 장점: 도메인 모델이 풍부해짐
  • 단점: Repository 조회가 필요한 규칙(좋아요 중복 검사 등)을 엔티티가 직접 처리하기 어려움

  B: 협력/트랜잭션은 Application Service, “정책(규칙) + Repository 필요”는 Domain Service

  • 주문: Product + Order를 Application Service에서 오케스트레이션(트랜잭션 경계)
  • 좋아요: 중복 방지/멱등성은 Domain Service로 캡슐화(Repository 조회 필요)

  C: UseCase(인터랙터) 패턴으로 더 세분화

  • PlaceOrderUseCase, LikeProductUseCase처럼 유스케이스 단위 클래스로 분리
  • 장점: 변경 영향 최소화, 테스트 더 명확
  • 단점: 클래스 수 증가(과제 범위에 비해 과도할 수 있음)

• 최종결정

  • B안 채택
  • 다중 Aggregate 조합/트랜잭션은 Application Service에서, Repository 기반 정책은 Domain Service로 분리

• 트레이드오프

  • 레이어가 늘어 복잡도 증가: “왜 서비스가 2종류인지” 팀 합의/규칙 필요
  • 분리 기준이 흐려질 위험: Domain Service가 점점 “작은 Application Service”처럼 비대해질 수 있음

3) 재고 동시성(오버셀링)을 어떤 전략으로 막을 것인가

• 고려한 대안
  A: 비관적 락(Pessimistic Lock)

  • findByIdWithLock()로 재고 차감 구간을 단일 트랜잭션으로 보호

  B: 낙관적 락(Optimistic Lock) + 재시도

  • version 기반으로 충돌 시 재시도
  • 장점: 락 경합 줄어듦
  • 단점: 재시도 정책/에러 처리/테스트가 복잡

  C: 원자적 업데이트(Atomic Update)

  • update product set stock = stock - ? where id=? and stock >= ? 같은 형태
  • 장점: DB round-trip 감소, 경합에 강함
  • 단점: 도메인 로직이 “쿼리”에 흡수되어 모델 표현력이 떨어질 수 있음(VO/불변식 강제 위치가 흔들림)

• 최종결정

  • A안 채택(비관적 락)
  • “재고 차감 + 주문 생성”을 강한 일관성으로 묶고 오버셀링을 확실히 방지하는 방향

• 트레이드오프

  • 성능/확장성 비용: 동시 주문이 많아지면 락 경합/대기 증가
  • 장애 전파 범위: 락 타임아웃/DB 병목이 주문 처리 전체에 영향
  • Fake Repo 한계: Fake에서는 락이 생략되므로 “진짜 동시성” 검증은 별도 테스트 필요(TODO로 이미 인지)

🏗️ Design Overview

변경 범위

• 영향 받는 모듈/도메인: commerce-api (Brand, Product, Like, Order)
• 신규 추가 (82 files, +5883 lines):
  • domain/common/: Money, Quantity Value Objects
  • domain/brand/: Brand Entity, Repository, DomainService
  • domain/product/: Product Entity, Stock VO, Repository, DomainService
  • domain/like/: Like Entity, LikeId VO, Repository, DomainService
  • domain/order/: Order Aggregate Root, OrderItem, Repository
  • infrastructure/persistence/jpa/*/: JPA Entities, Mappers, Repository 구현체
  • application/*/: Application Services, Result DTOs
  • interfaces/api/*/: REST API Controllers, DTOs
  • test/fake/: Fake Repositories
  • test/domain/*/: 도메인 단위 테스트
• 제거/대체: 없음 (신규 구현)

주요 컴포넌트 책임

• Money, Stock: 불변 Value Object, 생성 시점 검증, 연산 시 새 인스턴스 반환
• Brand, Product, Like, Order: 순수 Java 도메인 엔티티, 정적 팩토리 메서드 (create/reconstitute)
• *DomainService: 단일 BC 내 비즈니스 규칙 캡슐화 (중복 좋아요 방지, 멱등 취소 등)
• *ApplicationService: 트랜잭션 경계, 여러 BC 조합, 유스케이스 오케스트레이션
• *Mapper: Domain ↔ JPA Entity 변환
• Fake*Repository: 테스트용 Map 기반 in-memory 구현

🔁 Flow Diagram

주문 생성 Flow

sequenceDiagram
  participant Client
  participant OrderApplicationService
  participant ProductRepository
  participant Product
  participant OrderRepository
  participant Order

  Client->>OrderApplicationService: placeOrder(userId, items)

  loop 각 주문 항목
    OrderApplicationService->>ProductRepository: findByIdWithLock(productId)
    ProductRepository-->>OrderApplicationService: Product
    OrderApplicationService->>Product: decreaseStock(quantity)

    alt 재고 부족
      Product-->>OrderApplicationService: INSUFFICIENT_STOCK 예외
      OrderApplicationService-->>Client: 에러 응답
    else 재고 충분
      Product-->>OrderApplicationService: 성공
      OrderApplicationService->>ProductRepository: save(product)
    end
  end

  OrderApplicationService->>Order: create(userId, orderItems)
  Order-->>OrderApplicationService: Order (총액 자동 계산)
  OrderApplicationService->>OrderRepository: save(order)
  OrderRepository-->>OrderApplicationService: saved Order
  OrderApplicationService-->>Client: OrderResult

Loading

좋아요 등록 Flow

sequenceDiagram
  participant Client
  participant LikeApplicationService
  participant ProductRepository
  participant LikeDomainService
  participant LikeRepository

  Client->>LikeApplicationService: like(userId, productId)
  LikeApplicationService->>ProductRepository: findByIdActive(productId)

  alt 상품 미존재
    ProductRepository-->>LikeApplicationService: empty
    LikeApplicationService-->>Client: NOT_FOUND 예외
  else 상품 존재
    ProductRepository-->>LikeApplicationService: Product
    LikeApplicationService->>LikeDomainService: like(userId, productId)
    LikeDomainService->>LikeRepository: exists(userId, productId)

    alt 이미 좋아요함
      LikeRepository-->>LikeDomainService: true
      LikeDomainService-->>LikeApplicationService: CONFLICT 예외
      LikeApplicationService-->>Client: 에러 응답
    else 처음 좋아요
      LikeRepository-->>LikeDomainService: false
      LikeDomainService->>LikeRepository: save(Like.create())
      LikeDomainService-->>LikeApplicationService: Like
      LikeApplicationService-->>Client: LikeResult
    end
  end

Loading

상품 CRUD Flow

sequenceDiagram
  participant Client
  participant ProductAdminV1Controller
  participant ProductService
  participant ProductDomainService
  participant ProductValidator
  participant BrandRepository
  participant ProductRepository

  Client->>ProductAdminV1Controller: POST /api/admin/v1/products
  ProductAdminV1Controller->>ProductService: create(ProductInfo)
  ProductService->>ProductDomainService: create(info)
  ProductDomainService->>ProductValidator: validateBrandExists(brandId)
  ProductValidator->>BrandRepository: findByIdActive(brandId)

  alt 브랜드 미존재
    BrandRepository-->>ProductValidator: empty
    ProductValidator-->>ProductDomainService: BRAND_NOT_FOUND 예외
    ProductDomainService-->>ProductService: 예외 전파
    ProductService-->>ProductAdminV1Controller: 예외 전파
    ProductAdminV1Controller-->>Client: 에러 응답
  else 브랜드 존재
    BrandRepository-->>ProductValidator: Brand
    ProductDomainService->>ProductRepository: save(Product.create())
    ProductRepository-->>ProductDomainService: saved Product
    ProductDomainService-->>ProductService: Product
    ProductService-->>ProductAdminV1Controller: ProductResult
    ProductAdminV1Controller-->>Client: 201 Created
  end

Loading

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

Tip

Try Coding Plans. Let us write the prompt for your AI agent so you can ship faster (with fewer bugs).
Share your feedback on Discord.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}