docs(gift): iOS 선물함 구현 프롬프트를 보강한다

2026-10-08 17:38:56 +09:00
parent 5d8e71df83
commit f5f58e44f8
3 changed files with 631 additions and 15 deletions
@@ -1406,6 +1406,30 @@ P7은 FCM 확장 후 전체 상태 전이를 연결하고 최종 회귀로 종
 - [x] 공식 `onShutdownForceStop(true)` 옵션으로 native Redis 프로세스 종료가 무기한 `waitFor()`에 걸리지 않도록 변경했다.
 - [x] 후속 요청에 따라 전체 `./gradlew --no-daemon test`를 실행해 정상 종료를 확인했다.

+## Phase 13: 선물함 리스트 표시 보강
+
+**Phase 결과:** 선물함 리스트 item이 배송지 입력 여부, 배송지 입력 기한, 취소일을 내려줘 iOS가 리스트에서 배송지 CTA와 취소일을 표시할 수 있다.
+
+**선행조건:** Phase 12 완료, 사용자 확정 요구사항 반영.
+
+### Task 13.1 문서 계약 갱신
+
+**Goal 실행 `P13-T1`:** PRD, 클라이언트 요약, 모바일 프롬프트에 리스트 item 추가 필드 3개를 반영한다.
+
+- **Files:** Modify `prd.md`, `client-api-summary.md`, `gift-list-page-prompt.md`, `ios-gift-feature-implementation-prompt.md`, `plan-task.md`.
+- [x] **RED:** 기존 리스트 응답 계약에 `recipientAddressRegistered`, `canceledAt`이 없고 배송지 deadline 규칙이 불명확함을 확인한다.
+- [x] **GREEN:** `recipientAddressRegistered`, `recipientAddressDeadlineAt`, `canceledAt`을 문서화한다. 배송지 입력 완료 후 `recipientAddressDeadlineAt=null`, 취소일은 `createdAt` 대입이 아니라 `canceledAt` 별도 필드로 내려주는 정책을 명시한다.
+
+### Task 13.2 리스트 응답 필드 구현
+
+**Goal 실행 `P13-T2`:** 사용자 선물함 리스트 응답에 추가 필드 3개를 내려준다.
+
+- **Files:** Modify `GiftQueryService.kt`, `GiftResponse.kt`.
+- **Tests:** Modify `GiftQueryServiceTest.kt`, `GiftControllerTest.kt`.
+- [x] **RED:** 배송지 미입력/입력 완료/취소 상태의 리스트 응답 필드 실패 테스트를 작성하고 실패를 확인했다.
+- [x] **GREEN:** 기존 `GiftDelivery` 정보를 재사용해 `recipientAddressRegistered`, `recipientAddressDeadlineAt`, `canceledAt`을 매핑했다.
+- [x] **검증:** focused 테스트와 `ktlintCheck`, `git diff --check`를 실행했다.
+
 ## Decision Log

 | 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 |