[Volume 3] 도메인 모델링 및 구현 - 양권모

[Praesentia-YKM]

📌 Summary

• 배경: Week3에서 Brand, Product, Stock 도메인 CRUD가 완료되었으나, 이커머스의 핵심인 '사용자 행동(좋아요, 주문)'과 공통 인증/인가 체계가 부재함.
• 목표: Like/Order 도메인 구현 및 커스텀 어노테이션 기반 인증 체계 구축을 통해 총 21개 API 완성.
• 결과: Customer 9개 + Admin 12개 API 구현 완료. 전 구간 TDD 적용 (Unit / Integration / E2E).

🧭 Context & Decision

문제 정의

• 현상: 인증 로직이 @RequestHeader로 컨트롤러마다 산재하여 중복 발생 및 변경 취약성 존재.
• 성공 기준: 21개 API 전체 구현 및 @LoginMember, @AdminUser를 통한 인증 로직 일원화.

주요 의사결정 및 트레이드오프

1. **좋아요 삭제 전략: Soft Delete **
   • 이유: 물리 삭제는 단순하지만, 상품 복구 시 연관 데이터(좋아요) 유실 위험이 있음. BaseEntity 패턴과의 일관성 유지.
2. **좋아요 수(likeCount) 동기화: Application Layer 직접 호출 **
   • 이유: DDD 이벤트 방식이 이상적이나 현재 규모에선 인프라 복잡도 증가. LikeFacade에서 직접 처리하여 단순성 확보.
3. **주문 재고 차감 시점: 주문 생성 시 즉시 차감 **
   • 이유: 단일 트랜잭션 내에서 All-or-Nothing 보장. 향후 결제 도입 시 Saga 패턴 등으로 확장 고려.
4. **Brand-Product Aggregate 경계: 별도 Aggregate + ID 참조 **
   • 이유: 동일 Aggregate 구성 시 상품 수 증가에 따른 성능 저하 우려. BrandFacade에서 연쇄 Soft Delete로 정합성 유지.

🏗️ Design Overview

레이어	컴포넌트	책임
Auth	@LoginMember, @AdminUser	ArgumentResolver를 통한 인증 객체 주입 및 중복 로직 제거
Like	LikeFacade, LikeModel	멱등성 보장, likeCount 동기화, Soft Delete 처리
Order	OrderFacade, OrderModel	재고 차감 및 주문/아이템 스냅샷 저장 (Atomic 처리)
Brand	BrandFacade	브랜드 삭제 시 소속 상품들에 대한 연쇄 Soft Delete 관리
Product	ProductFacade	상품 + Stock 동시 생성 및 권한별 조회 필터링

🔁 Flow Diagram

1. 주문 생성 (Order Flow)

sequenceDiagram
      autonumber
      participant Client as Customer
      participant Ctrl as OrderV1Controller
      participant Facade as OrderFacade
      participant PS as ProductService
      participant SS as StockService
      participant OS as OrderService

      Client->>Ctrl: POST /api/v1/orders (@LoginMember)
      Ctrl->>Facade: placeOrder(userId, commands)

      rect rgb(230, 240, 255)
          Note right of Facade: @Transactional
          loop 각 주문 상품
              Facade->>PS: getProduct(productId)
              Note over PS: 삭제된 상품 → NOT_FOUND
              Facade->>SS: getByProductId → stock.decrease()
              Note over SS: 재고 부족 → BAD_REQUEST (전체 롤백)
          end
          Facade->>Facade: 총액 서버 계산 (Money.add/multiply)
          Facade->>OS: Order + OrderItem 저장 (스냅샷)
      end

      OS-->>Facade: OrderResult
      Facade-->>Ctrl: OrderResult
      Ctrl-->>Client: 200 OK (주문 정보)

Loading

2. 좋아요 토글 (Like Flow)

sequenceDiagram
      autonumber
      participant Client as Customer
      participant Facade as LikeFacade
      participant PS as ProductService
      participant LS as LikeService

      Client->>Facade: like(userId, productId)
      rect rgb(230, 240, 255)
          Note right of Facade: @Transactional
          Facade->>PS: getProduct (삭제 확인)
          Facade->>LS: findByUserIdAndProductId

          alt 좋아요 없음
              Facade->>LS: save(new LikeModel)
              Facade->>PS: product.incrementLikeCount()
          else 삭제된 좋아요 존재
              Facade->>LS: restore()
              Facade->>PS: product.incrementLikeCount()
          else 이미 활성 좋아요
              Note over Facade: 무시 (멱등성)
          end
      end
      Facade-->>Client: 200 OK

Loading

3. 브랜드 삭제 연쇄 (Brand Cascade Flow)

sequenceDiagram
      autonumber
      participant Admin
      participant Facade as BrandFacade
      participant BS as BrandService
      participant PS as ProductService

      Admin->>Facade: delete(brandId) (@AdminUser)
      rect rgb(230, 240, 255)
          Note right of Facade: @Transactional
          Facade->>BS: delete(brandId) → soft delete
          Facade->>PS: deleteAllByBrandId(brandId)
          loop 소속 상품 전체
              PS->>PS: product.delete() → soft delete
          end
      end
      Facade-->>Admin: 200 OK

Loading

4. 상품 목록 조회 — 고객 vs 어드민 (Product List Flow)

sequenceDiagram
     autonumber
     participant C as Customer
     participant A as Admin
     participant F as ProductFacade
     participant PS as ProductService
     participant SS as StockService

     rect rgb(232, 245, 233)
         Note over C,SS: Customer 상품 목록 조회 (상태 중심)
         C->>F: GET /api/v1/products?sort=likes_desc
         F->>PS: 상품 목록 조회 (삭제 제외, 정렬)
         F->>SS: 재고 정보 조합
         Note over F: 재고 상태 변환 로직<br/>>10: IN_STOCK<br/>1~10: LOW_STOCK<br/>0: OUT_OF_STOCK
         F-->>C: 200 OK (상품 목록 + 재고 상태)
     end

     rect rgb(227, 242, 253)
         Note over A,SS: Admin 상품 목록 조회 (수량 중심)
         A->>F: GET /api-admin/v1/products (@AdminUser)
         F->>PS: 상품 목록 조회 (삭제 포함 가능)
         F->>SS: 재고 정보 조합
         Note over F: 정확한 재고 수량 노출
         F-->>A: 200 OK (상품 목록 + 실제 재고 수량)
     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.}