feat/119 :: Delivery 배송 서비스 구현

[lian2945]

📌 관련 이슈

• close #119

---

📝 변경 사항 요약

작업 유형

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

변경 내용

• 도메인: Delivery/TrackingHistory Aggregate, DeliveryStatus/TrackingHistoryStatus Enum, 도메인 이벤트 2종, VO 4종, 예외 3종
• 애플리케이션: UseCase 2종, Port 3종, Service 4종, DTO
• 어댑터: REST Controller, SweetTracker Feign Client 연동, JPA Persistence, Outbox, 배송 추적 스케줄러, Security
• 설정: application-local/dev/prod.yml, build.gradle, Dockerfile, Gradle Wrapper

변경 이유

• 주문 확정 후 배송 시작부터 배송 완료까지의 추적 흐름을 관리하는 독립 서비스가 필요하며, 외부 택배사 API 연동을 통해 실시간 배송 상태를 동기화

---

✅ 테스트 체크리스트

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

---

📸 스크린샷 / 로그

펼쳐보기

curl-test.sh 기반 배송 API 테스트 완료

---

🔄 동작 플로우 (Mermaid)

flowchart TD
    A[배송 시작 요청] --> B[DeliveryCommandController]
    B --> C[StartDeliveryService]
    C --> D[Delivery Aggregate 생성]
    D --> E[DeliveryOutbox 이벤트 저장]
    E --> F[Debezium CDC - Kafka 발행]
    F --> G[Order/Orchestrator 수신]
    H[DeliveryTrackingScheduler 주기 실행] --> I[SweetTracker API 조회]
    I --> J{배송 완료 여부}
    J -->|미완료| K[TrackingHistory 업데이트]
    J -->|완료| L[DeliveryStatus DELIVERED]
    L --> M[DeliveryCompleted 이벤트 발행]

Loading

💬 리뷰어에게

• SweetTracker Feign Client의 에러 디코더와 타임아웃 설정을 검토해주세요.
• DeliveryTrackingScheduler의 폴링 주기가 적절한지 확인 필요합니다.
• Outbox 이벤트 발행 시 delivery-started/delivery-completed 토픽 네이밍을 검토해주세요.

[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