[Release] 공통 Footer 및 사용자 쿠폰함 흐름 main 통합

[jjunier]

개요

본 PR은 develop 브랜치에 병합된 D2C-57 공통 레이아웃 Footer 및 서비스 정보 영역 구성, D2C-58 사용자 쿠폰함 및 쿠폰 사용 이력 조회 흐름 구현 결과를 main 브랜치에 반영하기 위한 PR입니다.

D2C-57에서는 전체 페이지에서 공통으로 노출되는 Footer 영역을 추가하고, 서비스 주요 화면, 구매 흐름, 구현 범위, GitHub Repository 정보를 제공하도록 공통 레이아웃을 보완했습니다.

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

본 PR에서는 develop에서 검증된 공통 Footer 레이아웃, sticky footer 개선, 사용자 쿠폰함 조회, 쿠폰 사용 이력 표시 흐름을 main에 병합하여 Sprint 2 프론트엔드 공통 레이아웃 및 쿠폰 조회 흐름의 배포 기준을 정리합니다.

---

포함 범위

D2C-57 공통 Footer 및 서비스 정보 영역

• 전체 앱 공통 Footer 추가
• 서비스 소개 문구 추가
• 주요 서비스 링크 추가
  • 상품 둘러보기
  • 장바구니
  • 주문 내역
  • 쿠폰함
• 구매 흐름 안내 영역 추가
  • 상품 선택 및 장바구니 담기
  • 쿠폰 적용 및 주문 생성
  • 결제 성공·실패 시뮬레이션
  • 구매 상품 리뷰 작성
• 구현 범위 안내 영역 추가
  • 사용자 상태 기반 화면 제어
  • 주문·결제 상태 이력 관리
  • 상품별 리뷰 데이터 조회
  • 반응형 UI 및 공통 레이아웃
• Footer 하단 저작권자 정보 추가
• GitHub Prototype Repository 링크 추가
• GitHub inline SVG 아이콘 추가

Sticky Footer 레이아웃 보완

• app-shell을 세로 flex layout으로 구성
• app-main이 남은 화면 높이를 차지하도록 수정
• 콘텐츠가 짧은 페이지에서도 Footer가 화면 하단에 위치하도록 개선
• 장바구니 빈 상태 페이지 Footer 위치 보완
• 체크아웃 빈 상태 페이지 Footer 위치 보완
• 공통 레이아웃의 Header/Main/Footer 구조 정리

D2C-58 사용자 쿠폰함 및 쿠폰 사용 이력 조회

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

프론트엔드 쿠폰함 화면

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

시간 표시 보완

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

스타일 보완

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

---

검증 결과

develop 브랜치 기준으로 백엔드 전체 테스트를 실행하여 정상 통과를 확인했습니다.

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

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

cd apps/web
npm run typecheck

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

cd apps/web
npm run build

수동 확인 항목:

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

---

브랜치 통합 방식

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

feature/D2C-57-common-footer-service-info
→ develop

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

develop
→ main

main 병합 후에는 공통 Footer, 서비스 정보 영역, 사용자 쿠폰함, 쿠폰 사용 이력 조회 흐름이 배포 기준 브랜치에 반영됩니다.

---

향후 브랜치 운영 원칙

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

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

---

체크리스트

• D2C-57 브랜치를 develop에 병합
• D2C-58 브랜치를 develop에 병합
• 공통 Footer 영역 추가
• 서비스 링크 영역 추가
• 구매 흐름 안내 영역 추가
• 구현 범위 안내 영역 추가
• GitHub Repository 링크 및 아이콘 추가
• sticky footer layout 적용
• 짧은 콘텐츠 페이지 Footer 위치 보완
• 사용자 쿠폰함 조회 API 추가
• 쿠폰함 응답 스키마 추가
• 사용 가능한 쿠폰 목록 조회 구현
• 사용 완료 쿠폰 이력 조회 구현
• 쿠폰함 페이지 구현
• /coupons 라우트 추가
• Header/Footer 쿠폰함 링크 추가
• 쿠폰 카드 UI 구현
• 쿠폰 사용 일시 표시 보완
• 리뷰 생성 시간 표시 보완
• Backend CI 통과 확인
• Frontend CI 통과 확인
• main 병합 완료
• main 기준 최종 확인