feat/120 :: Orchestrator 주문 사가 오케스트레이터 구현

[lian2945]

📌 관련 이슈

• close #120

---

📝 변경 사항 요약

작업 유형

• ✨ feat: 새로운 기능 추가 (기능 단위 완료 후 PR)
• 🐛 fix: 버그 수정 (버그 1개 = PR 1개)
• ♻️ refactor: 코드 리팩토링 (작업 단위 완료 후 PR)
• ✅ test: 테스트 코드 추가/수정 (작업 단위 완료 후 PR)

변경 내용

• 도메인: 커맨드 이벤트 6종, OrchestratorCommandEventType Enum, 글로벌 예외 계층
• 애플리케이션: UseCase 11종, OutboxPort, Service 11종
• 어댑터: Kafka Listener 4종, Kafka 이벤트 DTO 11종, Inbox/Outbox Persistence, InboxProperties, KafkaConfiguration
• 설정: application-local/dev/prod.yml, build.gradle, Dockerfile, Gradle Wrapper

변경 이유

• 주문-결제-재고-배송-정산의 분산 트랜잭션을 중앙에서 조율하는 사가 오케스트레이터가 필요하며, 각 단계의 성공/실패에 따른 보상 트랜잭션을 관리

---

✅ 테스트 체크리스트

• 단위 테스트 작성 및 통과
• 통합 테스트 통과
• 기존 기능 정상 동작 확인 (Regression)
• API 응답값 확인
• 예외 케이스 처리 확인
• 로컬 환경에서 직접 테스트 완료

---

📸 스크린샷 / 로그

펼쳐보기

curl-test.sh 기반 사가 흐름 테스트 완료

---

🔄 동작 플로우 (Mermaid)

flowchart TD
    A[Order 이벤트 수신] --> B{이벤트 타입}
    B -->|order-prepare| C[재고 차감 커맨드 발행]
    B -->|order-confirmed| D[결제 승인 커맨드 발행]
    B -->|order-cancel| E[결제 취소 커맨드 발행]
    C --> F{재고 결과}
    F -->|성공| G[주문 준비 확정 커맨드]
    F -->|실패| H[주문 취소 처리]
    D --> I{결제 결과}
    I -->|성공| J[정산 준비 커맨드]
    I -->|실패| K[재고 복원 커맨드]
    L[배송 완료 이벤트] --> M[구매확정 이벤트]
    M --> N[정산 실행 커맨드]

Loading

💬 리뷰어에게

• 사가 단계별 보상 트랜잭션 흐름이 누락 없는지 검토해주세요.
• Inbox 패턴의 멱등성 보장이 모든 이벤트 핸들러에 적용되었는지 확인 부탁드립니다.
• Outbox 이벤트의 event_type 필드가 Debezium EventRouter 라우팅 규칙과 일치하는지 확인 필요합니다.

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[sonarqubecloud]

Quality Gate failed

Failed conditions
9 Security Hotspots

See analysis details on SonarQube Cloud