[D2C-58] 사용자 쿠폰함 및 쿠폰 사용 이력 조회 흐름 구현

[jjunier]

개요

본 PR은 D2C-58 사용자 쿠폰함 및 쿠폰 사용 이력 조회 흐름 구현 결과를 develop 브랜치에 반영하기 위한 PR입니다.

D2C-58에서는 로그인 사용자가 쿠폰함 화면에서 현재 사용 가능한 쿠폰과 결제 완료 주문에서 사용한 쿠폰 이력을 확인할 수 있도록 구현했습니다.

본 PR에서는 사용자 쿠폰함 조회 API, 쿠폰함 페이지, 쿠폰 사용 이력 UI, 쿠폰함 라우트 및 공통 네비게이션 링크를 추가하여 D2C-38에서 구현한 쿠폰 적용/재사용 차단 흐름을 사용자가 직접 확인할 수 있도록 보완합니다.

---

포함 범위

백엔드 쿠폰함 조회 API

• 사용자 쿠폰함 조회 API 추가
• 로그인 사용자 기준 쿠폰 목록 조회 흐름 구현
• 사용 가능한 쿠폰 목록 조회
• 결제 완료 주문에서 사용한 쿠폰 제외 처리
• 사용 완료 쿠폰 이력 조회
• 사용 완료 쿠폰의 주문번호, 사용 일시, 결제 ID 반환
• 존재하지 않는 사용자에 대한 예외 처리
• 쿠폰함 응답 스키마 추가
• 신규 쿠폰 라우터 등록

프론트엔드 쿠폰함 화면

• /coupons 라우트 추가
• 사용자 쿠폰함 페이지 추가
• 비로그인 상태 접근 안내 UI 추가
• 사용 가능한 쿠폰 섹션 추가
• 사용 완료 쿠폰 섹션 추가
• 쿠폰명, 할인 방식, 할인 값 표시
• 최소 주문 금액 표시
• 쿠폰 유효기간 표시
• 사용 완료 쿠폰의 사용 주문번호 표시
• 사용 완료 쿠폰의 사용 일시 표시
• 사용 가능한 쿠폰/사용 완료 쿠폰이 없는 경우 빈 상태 표시

네비게이션 연동

• Header에 쿠폰함 링크 추가
• Footer 서비스 영역에 쿠폰함 링크 추가
• 사용자 기능 흐름에서 쿠폰함 접근성 보완

시간 표시 보완

• 쿠폰 사용 일시 표시 로직 보완
• 서버 응답 datetime의 timezone 처리 보완
• 리뷰 생성 시간 표시 로직 보완
• 상품 상세 리뷰 작성 시간이 KST 기준으로 올바르게 표시되도록 수정

스타일 보완

• 쿠폰함 페이지 스타일 추가
• 쿠폰 카드 UI 추가
• 사용 가능/사용 완료 쿠폰 배지 스타일 추가
• 쿠폰함 2단 레이아웃 구성
• 모바일 화면에서 쿠폰함 레이아웃이 1단으로 전환되도록 반응형 처리

---

검증 결과

백엔드 전체 테스트를 실행하여 정상 통과를 확인했습니다.

cd apps/api
python -m pytest ./tests -v

프론트엔드 타입 체크를 실행하여 정상 통과를 확인했습니다.

cd apps/web
npm run typecheck

프론트엔드 빌드를 실행하여 정상 통과를 확인했습니다.

cd apps/web
npm run build

수동 확인 항목:

• /coupons 페이지 접근 확인
• 비로그인 상태에서 쿠폰함 접근 시 로그인 안내 표시 확인
• 로그인 상태에서 쿠폰함 조회 확인
• 사용 가능한 쿠폰 목록 표시 확인
• 사용 완료 쿠폰 목록 표시 확인
• WELCOME10 사용 완료 쿠폰 표시 확인
• DESK5000, OFFICE10000 사용 가능 쿠폰 표시 확인
• 쿠폰명, 할인 혜택, 최소 주문 금액, 유효기간 표시 확인
• 사용 완료 쿠폰의 주문번호 및 사용 일시 표시 확인
• 쿠폰 사용 일시가 의도한 시간 기준으로 표시되는지 확인
• Header의 쿠폰함 링크 이동 확인
• Footer의 쿠폰함 링크 이동 확인
• 모바일 화면에서 쿠폰 카드 레이아웃 확인
• 상품 상세 리뷰 생성 시간이 KST 기준으로 표시되는지 확인

---

브랜치 통합 방식

이번 PR의 통합 흐름은 아래와 같습니다.

feature/D2C-58-user-coupon-wallet-history
→ develop

develop 병합 후에는 사용자 쿠폰함 및 쿠폰 사용 이력 조회 흐름이 Sprint 2 프론트엔드 사용자 기능에 반영됩니다.

---

향후 브랜치 운영 원칙

Sprint 2에서는 아래 브랜치 운영 원칙을 유지합니다.

• Jira 이슈키별 독립 feature 브랜치 생성
• 각 feature 브랜치는 develop에서 분기
• 작업 완료 후 develop으로 개별 PR 생성
• PR 단위로 CI 검증 후 병합
• 의미 있는 사용자 흐름 단위가 완료되면 develop을 main에 병합
• main은 배포 기준 브랜치로 유지
• 기능 작업이 누적된 장기 브랜치는 지양

---

체크리스트

• D2C-58 브랜치를 develop 기준으로 분기
• 사용자 쿠폰함 조회 API 추가
• 쿠폰함 응답 스키마 추가
• 쿠폰 라우터 등록
• 사용 가능한 쿠폰 목록 조회 구현
• 사용 완료 쿠폰 이력 조회 구현
• 쿠폰함 페이지 구현
• /coupons 라우트 추가
• Header 쿠폰함 링크 추가
• Footer 쿠폰함 링크 추가
• 쿠폰 카드 UI 구현
• 쿠폰 사용 일시 표시 보완
• 리뷰 생성 시간 표시 보완
• Frontend typecheck 통과 확인
• Frontend build 통과 확인
• Backend 테스트 통과 확인