docs(gift): 배송지 상태와 날짜 구현을 기록한다

This commit is contained in:
2026-10-08 18:45:38 +09:00
parent 2294706d43
commit 944b3f5175
2 changed files with 283 additions and 4 deletions
@@ -0,0 +1,105 @@
# Phase 8 선물함 배송지 상태·날짜 리뷰
## 1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 리뷰 대상 | Phase 8 / `P8-T1`~`P8-GATE` |
| 기준 commit 또는 working tree | 현재 working tree의 Phase 8 미커밋 변경 |
| 리뷰 일자 | `2026-10-08` |
| 리뷰어 | Sisyphus, Oracle 및 Task별 read-only reviewer |
| 기준 문서 | `docs/20261001_선물함_리스트_페이지/prd.md`, `docs/20261001_선물함_리스트_페이지/plan-task.md` |
| 리뷰 상태 | 판정 완료 |
## 2. 리뷰 목적과 범위
### 목적
- 목록 신규 필드와 배송지 등록 여부 기반 UI 분기가 승인된 요구사항을 충족하는지 확인한다.
- UTC 날짜, 남은 일수, 취소일 fallback, 기존 UI binding과 회귀 검증 증거를 확인한다.
### 포함 범위
- 코드: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift`의 Phase 8 변경 파일.
- 테스트: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift`의 날짜·선물함·상세·운송장 테스트와 전체 Gift 회귀.
- 리소스: Address item XML과 한·영·일 선물함 문자열.
- 문서: PRD Phase 8 요구사항과 `P8-T1`~`P8-GATE`.
### 제외 범위
- API 서버 구현과 미제공 `sortAt`.
- 저장소 규칙상 요청되지 않은 기기·에뮬레이터·androidTest·스크린샷 QA.
- Phase 8과 무관한 레거시 및 다른 도메인 코드.
## 3. 판정 기준
- Blocker/High: 확정 요구사항 또는 API 계약 위반, 핵심 선물함 흐름 회귀.
- Medium: 제한 조건에서 배송지·날짜 표시가 잘못되는 문제.
- Low: 유지보수성 또는 문서 정합성 문제.
## 4. 검토한 근거
### 문서와 코드
- 요구사항: `GIFT-INBOX-UI-002`, `GIFT-INBOX-UI-006`, `GIFT-INBOX-STATUS-002~004`.
- 계획: `P8-T1`, `P8-T2`, `P8-T3`, `P8-GATE`.
- 코드: `GiftDateTime.kt`, `GiftInboxPresenter.kt`, `GiftInboxAdapter.kt`, `GiftModels.kt`, `GiftInboxModels.kt`.
- 테스트: `GiftDateTimeTest`, `GiftInboxPresenterTest`, `GiftDetailPresenterTest`, `GiftTrackingPresenterTest`, 전체 Gift package.
### 실행 환경
```text
OS: macOS
Build/Test: repository Gradle wrapper, debug variant
UI 검증: source/resource read-only 대조
```
### 실행한 검증
| 명령 또는 수동 검증 | 결과 | 핵심 증거 |
|---|---|---|
| Phase 8 focused 4개 test class | 성공 | 55개, failures/errors/skipped 0 |
| 전체 `kr.co.vividnext.sodalive.v2.gift.*` + resource/Kotlin 강제 재실행 | 성공 | 17개 class·211개 test, failures/errors/skipped 0, `BUILD SUCCESSFUL in 2m 5s` |
| `./gradlew :app:ktlintCheck --rerun-tasks` | 기존 항목으로 실패 | diff에 없는 `CreatorChannelFanTalkFragmentLayoutTest.kt`의 기존 20건이며 Phase 8 변경 파일 위반 없음 |
| `GIT_MASTER=1 git diff --check` | 성공 | 출력 없음 |
| Figma·adapter·XML read-only 대조 | 성공 | 기존 구조·스타일·클릭 유지, 동적 경고와 취소 날짜 경로 확인 |
## 5. 발견 사항 요약
확정 발견 사항 없음.
Task별 리뷰에서 소수 초·sub-millisecond 정밀도와 테스트 기본 타임존 의존을 구현 완료 전에 발견했으며, 각각 실패 테스트를 추가해 수정 후 PASS/APPROVED 판정을 받았다.
## 6. 발견 사항 상세
최종 리뷰 기준 확정 또는 보류 발견 사항 없음.
## 7. 확정 항목의 plan·goal 전환
전환 항목 없음.
## 8. 리뷰 종료 판정
| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 리뷰 범위 전체 확인 | 충족 | PRD·plan·production·test·resource diff 대조 |
| 후보 항목 판정 완료 | 충족 | Task별 발견 3건 수정·재검토 완료 |
| 확정 항목 plan 반영 | 해당 없음 | 최종 확정 발견 사항 없음 |
| 보류 항목의 담당·재개 조건 기록 | 해당 없음 | 보류 없음 |
| 검증 명령과 결과 기록 | 충족 | focused 55개, 전체 211개, build·변경 파일 lint·diff 성공; 전역 lint 기존 20건 분리 기록 |
**최종 결론:** 확정 발견 사항 없음. Phase 8 승인.
**남은 항목:** 없음.
## 9. 수정 후 검증 기록
### 1차 수정 검증 — 2026-10-08
- 무엇을: UTC 소수 초·sub-millisecond deadline 경계와 테스트 기본 타임존 의존을 수정했다.
- 왜: 남은 일수 올림과 테스트 결정성을 승인된 계약에 맞추기 위해서다.
- 어떻게:
- 각 반례를 RED로 재현한 후 focused 테스트를 GREEN으로 전환했다.
- 전체 Gift 211개와 resource/Kotlin 강제 재실행, 변경 파일 lint, diff-check를 통과했다.
- 전역 ktlint 강제 실행의 기존 fan-talk test 20건은 이번 diff와 분리해 기록했다.
- 남은 항목: 없음.