[volume-4] 쿠폰 추가, 동시성 제어 적용

[hyejin0810]

📌 Summary

• 목표: 쿠폰 도메인 신규 구현, 재고/쿠폰/좋아요 동시성 추가

🧭 Context & Decision

변경 사항
쿠폰 도메인 신규 구현

• CouponTemplate — 정액(FIXED) /(RATE) 쿠폰 템플릿 엔티티
• IssuedCoupon — 발급된 쿠폰 생명주기 관리 (AVAILABLE → USED / EXPIRED)
• @Version 낙관적 락 적용 — 동일 쿠폰 동시 사용 방지
• 할인 계산 로직을 CouponTemplate 도메인에 캡슐화 (calculateDiscount(Money))

동시성 제어

• 재고: UPDATE ... WHERE stock >= quantity 방식을 통해 DB 레벨에서 원자적 차감을 수행하여 초과 차감을 방지.

• 쿠폰 사용: 충돌 가능성이 낮은 비즈니스 특성을 고려하여 @Version을 활용한 낙관적 락 사용.

• 좋아요 수: 별도의 락 없이 아토믹 업데이트를 사용하여 동시성 경쟁 상황에서도 카운트 보장.

• 좋아요 중복: 애플리케이션의 유효성 검사와 DB Unique Constraint를 결합하여 중복 데이터 생성을 완벽히 차단.

  주문-쿠폰 통합

  • OrderFacade.createOrder()에 쿠폰 검증/사용/할인 계산 통합
  • Order에 originalAmount / discountAmount / totalAmount 스냅샷 추가
  • Facade 메서드에만 단일 @transactional 적용 — 재고·쿠폰·포인트 원자성 보장

  Admin / 대고객 API (8개 추가)

Method	Endpoint	설명
POST	/api-admin/v1/coupons	쿠폰 템플릿 등록
GET	/api-admin/v1/coupons	쿠폰 템플릿 목록 조회
GET	/api-admin/v1/coupons/{couponId}	쿠폰 템플릿 상세 조회
PUT	/api-admin/v1/coupons/{couponId}	쿠폰 템플릿 수정
DELETE	/api-admin/v1/coupons/{couponId}	쿠폰 템플릿 삭제
GET	/api-admin/v1/coupons/{couponId}/issues	쿠폰별 발급 내역 조회
POST	/api/v1/coupons/{couponId}/issue	쿠폰 발급
GET	/api/v1/users/me/coupons	내 쿠폰 목록 조회

기존 주문 API에 couponId (요청), originalAmount / discountAmount / userCouponId (응답) 필드 추가.

테스트

테스트 클래스	테스트 수	검증 내용
CouponTemplateTest	12	정액/정률 할인 계산, 만료 검증, 최소주문금액 검증
IssuedCouponTest	8	발급/사용/소유자 검증 생명주기
CouponFacadeTest	7	쿠폰 발급·사용 서비스 흐름
OrderConcurrencyTest	2	비관적 락으로 동시 재고 차감 정확성 (재고 10, 10스레드 → 잔여 0)
LikeConcurrencyTest	2	유니크 제약으로 좋아요 중복 방지 (같은 회원 2번 좋아요 → 1건만 저장)

[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.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 13771b7e-cc53-4307-a808-672bd198aca9

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.}