diff --git a/docs/20261001_선물함_리스트_페이지/plan-task.md b/docs/20261001_선물함_리스트_페이지/plan-task.md index b2b918f5..f0b69903 100644 --- a/docs/20261001_선물함_리스트_페이지/plan-task.md +++ b/docs/20261001_선물함_리스트_페이지/plan-task.md @@ -50,6 +50,8 @@ | 4 | 완료 | `1/1` | `P4-GATE` 통과 | API 미제공 필드/시각 QA는 기존 제외 범위 | | 5 | 완료 | `2/2` | `P5-GATE` 통과 | 기기 시각 QA는 기존 제외 범위 | | 6 | 완료 | `3/3` | `P6-GATE` 통과 | 기기·스크린샷 QA는 기존 제외 범위 | +| 7 | 완료 | `1/1` | `P7-GATE` 통과 | 전역 ktlint 기존 실패는 검증 기록 참조 | +| 8 | 완료 | `3/3` | `P8-GATE` 통과 | 기기·스크린샷 QA는 저장소 정책상 제외 | ## 범위 @@ -62,11 +64,12 @@ - 진입 관점별 empty UI와 안내 배너. - 국가 코드 `KR`·유효 언어 `ko` 조건의 마이 탭 선물함 진입점. - 두 방향 카드의 상대방 이미지·닉네임 표시와 null/blank 이미지 placeholder 처리. +- 목록의 배송지 등록 여부·입력 마감일·취소일 표시와 `v2.gift` UTC 날짜의 디바이스 타임존 변환. ### 제외 - 선물 상세 화면 신규 구현. 현재 상세 화면이 없으므로 item 터치 시 상태 표시 문구 toast만 제공한다. -- API 미제공 필드인 `canceledAt`, `recipientAddressDeadlineAt`, `sortAt`의 추정 구현. 상대방 필드 3개는 계약이 제공되어 Phase 6에 포함한다. +- API 미제공 필드인 `sortAt`의 추정 구현. 상대방 필드는 Phase 6, 배송지 등록 여부·마감일·취소일은 Phase 8 제공 계약에 포함한다. - 사용자 승인 범위인 `MyPageFragment` 선물함 진입점 최소 연결 외 레거시 파일 직접 수정. - UI/계측 테스트와 스크린샷 기반 visual QA. @@ -77,8 +80,9 @@ - API 패턴: 기존 `GiftApi`, `GiftRepository`, `GiftSendRequestViewModel`의 `ApiResponse`와 `Authorization` header 패턴을 따른다. - 테스트 범위: `app/src/test`의 local unit test만 작성한다. layout 크기·간격·constraint 자체는 직접 테스트하지 않는다. - 정렬: 서버 응답 순서를 유지하고 클라이언트 재정렬을 넣지 않는다. -- 날짜: 현재 API만 사용할 때 `createdAt` 기준 라벨을 표시한다. `CANCELED` 취소일 라벨은 `canceledAt` 제공 전까지 `createdAt` 기반 정책만 구현한다. +- 날짜: API UTC 시각은 디바이스 타임존으로 표시한다. `CANCELED`는 `canceledAt`을 사용하고 계약 위반으로 null이면 `createdAt`을 fallback으로 사용한다. - 민감정보: token, 내부 URL, 실제 사용자 닉네임을 log/fixture에 기록하지 않는다. +- 날짜: API 시각은 UTC로 파싱하고 표시 시 디바이스 기본 타임존을 사용한다. 배송지 남은 일수는 UTC instant 차이를 24시간 단위로 올림한다. ## 파일 구조 @@ -117,6 +121,22 @@ - 국가·언어 조합과 마이 탭 아이콘·순서·라우팅 연결을 검증한다. - Modify: `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt` - 승인된 레거시 최소 변경으로 기존 기능 아이콘 목록 첫 번째에 선물함을 조건부 추가한다. +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDateTime.kt` + - Gift API UTC 시각 파싱, 디바이스 타임존 날짜 형식화, 마감일까지 남은 일수 계산을 담당한다. +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftModels.kt` + - 목록 item의 배송지 등록 여부·마감일·취소일 필드를 수용한다. +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxModels.kt` + - Address 경고에 필요한 남은 일수를 카드 표시 모델에 보존한다. +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxPresenter.kt` + - 배송지 등록 여부, `UNDELIVERABLE` 예외, 취소일과 날짜 표시를 결정한다. +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenter.kt` + - 기존 공개 날짜 형식 함수는 유지하고 공용 Gift 날짜 변환기로 위임한다. +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftInboxAdapter.kt` + - Address 동적 경고와 취소 날짜를 기존 view에 바인딩한다. +- Modify: `app/src/main/res/layout/item_gift_inbox_address_banner.xml` +- Modify: `app/src/main/res/values/strings.xml`, `app/src/main/res/values-en/strings.xml`, `app/src/main/res/values-ja/strings.xml` +- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDateTimeTest.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxPresenterTest.kt` --- @@ -726,6 +746,9 @@ git diff --check HEAD - Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftModels.kt` - Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxModels.kt` - Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxPresenter.kt` +- Modify: `app/src/main/res/values/strings.xml` +- Modify: `app/src/main/res/values-en/strings.xml` +- Modify: `app/src/main/res/values-ja/strings.xml` - [x] **GREEN:** `GiftInboxItemResponse`와 두 방향 `GiftInboxCardUiModel`에 `counterpartMemberId: Long`, `counterpartNickname: String`, `counterpartProfileImageUrl: String?`를 반영한다. - [x] **GREEN:** presenter에서 ID·닉네임은 그대로 전달하고 이미지 URL은 `counterpartProfileImageUrl?.takeIf { it.isNotBlank() }`로 정규화한다. 역할 라벨 대신 API 닉네임을 사용하며 상태·날짜·direction 정책은 유지한다. @@ -831,6 +854,130 @@ GIT_MASTER=1 git diff --check HEAD --- +## Phase 8: 배송지 등록 여부·마감일·취소일 반영 + +**Phase 결과:** 선물함이 API의 배송지 등록 여부로 받은 선물을 정확히 분기하고, 동적 마감 경고와 취소 날짜를 디바이스 타임존으로 표시한다. + +**선행조건:** PRD `GIFT-INBOX-UI-002`, `GIFT-INBOX-UI-006`, `GIFT-INBOX-STATUS-002~004`, `DEC-014~016` 확정. + +**Phase 완료 조건:** `P8-T1`~`P8-T3`, `P8-GATE` 완료 및 PRD 14.8·Verification Log 갱신. + +### 시나리오 계약 + +| 구분 | 시나리오 | 통과 조건 | 검증 표면 | +|---|---|---|---| +| Happy path | 받은 선물의 배송지 미등록과 유효한 미래 마감일 | 일반 카드 없이 Address 한 건을 만들고 남은 시간을 24시간 단위 올림한 일수를 보존한다. | `GiftInboxPresenterTest` | +| Edge | 배송지 미등록 `UNDELIVERABLE`, null `canceledAt`의 `CANCELED` | `UNDELIVERABLE`은 기존 카드이며 취소일은 `createdAt`을 디바이스 타임존으로 표시한다. | `GiftInboxPresenterTest` | +| Regression | 상세·운송장의 기존 UTC 날짜 표시 | 디바이스 타임존에 따른 기존 `MM.dd`, `yyyy.MM.dd` 결과를 유지한다. | `GiftDetailPresenterTest`, `GiftTrackingPresenterTest` | +| UI binding | Address 동적 경고와 보낸 선물 취소일 | 기존 XML view에 값이 바인딩되고 한·영·일 resource merge와 Kotlin compile이 성공한다. | resource merge, compile, source 대조 | + +**중단 조건:** 위 시나리오의 RED→GREEN, 전체 Gift 회귀, resource/Kotlin/ktlint/diff 검증과 저장소 정책상 허용된 비기기 UI 대조가 모두 통과하고 문서에 실제 증거가 기록되면 즉시 종료한다. + +### Task 8.1 공용 UTC 날짜 변환 + +**Goal 실행 `P8-T1`:** Gift API UTC 시각의 디바이스 타임존 표시와 배송지 마감일까지 남은 일수 계산을 하나의 순수 변환기로 고정한다. + +**Files:** + +- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDateTimeTest.kt` +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDateTime.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenter.kt` + +**Interfaces:** + +```kotlin +internal object GiftDateTime { + fun formatDate(value: String?, pattern: String): String? + fun remainingDays(deadlineAt: String?, nowMillis: Long): Int? +} +``` + +- [x] **RED:** 고정 디바이스 타임존에서 UTC 날짜 경계가 현지 날짜로 바뀌고, 24시간·24시간 미만·24시간 초과가 각각 `1`, `1`, `2`일이 되는 테스트를 작성한다. +- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDateTimeTest"`를 실행해 `GiftDateTime` 부재로 compile 실패를 확인한다. +- [x] **GREEN:** 기존 `GiftDetailPresenter`의 엄격한 UTC 파서를 옮기고 `ceil((deadline-now)/86_400_000)`만 계산한다. null·잘못된 시각·0 이하 차이는 null을 반환하며 API 정상 계약의 대체 값을 만들지 않는다. +- [x] **GREEN:** `GiftDetailPresenter.formatProgressDate`와 `formatCardDate`는 공개 signature를 유지하고 `GiftDateTime.formatDate`로 위임한다. +- [x] **GREEN 확인:** `GiftDateTimeTest`와 `GiftDetailPresenterTest`, `GiftTrackingPresenterTest`를 함께 실행해 신규 계산과 기존 날짜 표시가 통과하는지 확인한다. +- [x] **REFACTOR:** 날짜 파서 중복만 제거하고 locale별 텍스트 형식이나 상세 UI 모델은 변경하지 않는다. + +**P8-T1 검증 기록 (2026-10-08):** 최초 focused RED에서 신규 test의 `GiftDateTime` 참조 7개가 unresolved reference로 compile 실패했다. 최소 공용 변환기와 기존 상세 formatter 위임 후 세 focused 클래스가 GREEN이었다. 명세·품질 검토에서 소수 초와 sub-millisecond 경계 누락을 각각 발견해 `.500Z`, `.0001Z` 반례를 RED로 재현하고 deadline 비교에만 정밀도를 보존했다. 최종 focused 세 클래스는 `BUILD SUCCESSFUL in 8s`, 명세 재검토 PASS, 코드 품질 재검토 APPROVED였다. + +### Task 8.2 목록 계약과 표시 정책 + +**Goal 실행 `P8-T2`:** 목록 신규 필드로 Address/일반 카드와 동적 경고, 취소 날짜를 결정한다. + +**Files:** + +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxPresenterTest.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftModels.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxModels.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxPresenter.kt` + +**Interfaces:** + +```kotlin +data class GiftInboxItemResponse( + // existing fields, + val recipientAddressRegistered: Boolean, + val recipientAddressDeadlineAt: String?, + val canceledAt: String? +) + +data class GiftInboxCardUiModel( + // existing fields, + val addressRequired: Boolean, + val addressDeadlineDays: Int? +) +``` + +- [x] **RED:** `ARRIVED_AT_MAILBOX`와 `INSPECTION_COMPLETED`도 `recipientAddressRegistered=false`이면 Address가 되고 true이면 기존 Card가 되는 테스트를 작성한다. +- [x] **RED:** `UNDELIVERABLE`은 미등록이어도 Card를 유지하고, 등록 완료·입력 불필요 상태의 null deadline은 Address 경고 계산에 사용되지 않는 테스트를 작성한다. +- [x] **RED:** 미래 deadline의 올림 일수와 `CANCELED`의 `canceledAt`, null fallback `createdAt`이 디바이스 타임존 날짜로 매핑되는 테스트를 작성한다. +- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest"`에서 신규 DTO/model 필드 또는 assertion 실패를 확인한다. +- [x] **GREEN:** DTO와 카드 모델에 승인된 필드만 추가하고 `addressRequired = received && status != "UNDELIVERABLE" && !recipientAddressRegistered`로 분기한다. +- [x] **GREEN:** Address인 경우에만 `GiftDateTime.remainingDays`를 계산하고, `CANCELED` 날짜 원본은 `canceledAt ?: createdAt`, 그 외는 `createdAt`을 사용해 디바이스 타임존으로 형식화한다. 취소 날짜 label format string은 한·영·일 리소스에 추가한다. +- [x] **GREEN 확인:** 같은 focused test를 재실행해 상태 분기·남은 일수·취소일·서버 순서가 통과하는지 확인한다. +- [x] **REFACTOR:** 기존 row type, 상세 이동, pagination, status 문구 매핑은 유지하고 status 기반 `TRACKING_REGISTERED` 주소 추정만 제거한다. + +**P8-T2 검증 기록 (2026-10-08):** 신규 DTO/model/resource 계약을 테스트에 먼저 반영해 compile RED를 확인했다. 최소 구현 후 `GiftInboxPresenterTest` 16개가 failures/errors/skipped 0으로 통과했다. 명세 검토에서 기존 상태 매핑 테스트의 기본 타임존 의존을 발견해 `TZ=America/Los_Angeles`에서 `2026.09.18`/`2026.09.17` 실패를 재현하고 테스트 내부 UTC 고정·복원을 적용했다. 같은 환경에서 16개 전체가 GREEN, 명세 재검토 PASS, 코드 품질 APPROVED였다. + +### Task 8.3 기존 view 동적 문구 바인딩 + +**Goal 실행 `P8-T3`:** 기존 Address warning과 보낸 카드 날짜 view에 Phase 8 표시 모델을 연결한다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftInboxAdapter.kt` +- Modify: `app/src/main/res/layout/item_gift_inbox_address_banner.xml` +- Modify: `app/src/main/res/values/strings.xml` +- Modify: `app/src/main/res/values-en/strings.xml` +- Modify: `app/src/main/res/values-ja/strings.xml` + +- [x] **TDD 예외 사유:** ViewBinding 연결과 정적 XML 속성은 local unit test로 레이아웃을 직접 검증하지 않는다. 표시 결정 로직과 resource ID는 `P8-T2`의 presenter test에서 검증한다. +- [x] **대체 검증 방법:** Address warning TextView에 ID를 부여하고 adapter의 해당 card 값 바인딩, 보낸 카드의 `dateLabelRes`, 한·영·일 format string을 source 대조한 뒤 resource merge와 Kotlin compile을 실행한다. +- [x] **GREEN:** 경고 resource를 일수 placeholder가 있는 문구로 교체하고 Address bind에서 해당 card의 `addressDeadlineDays`를 넣는다. +- [x] **GREEN:** `CANCELED` 카드의 기존 date view는 `gift_inbox_canceled_date`, 그 외는 기존 `gift_inbox_applied_date`를 사용한다. 신규 layout이나 view type은 만들지 않는다. +- [x] **GREEN 확인:** `./gradlew :app:mergeDebugResources :app:compileDebugKotlin`이 성공하는지 확인한다. +- [x] **REFACTOR:** 기존 XML 구조·간격·색상·클릭 callback은 변경하지 않는다. + +**P8-T3 검증 기록 (2026-10-08):** 기존 Address warning TextView에 ID만 추가하고 adapter가 각 Address card의 일수를 한·영·일 `%1$d` 문구에 바인딩했다. 보낸 카드의 기존 날짜 view와 `dateLabelRes` 경로는 유지했다. `mergeDebugResources`와 `compileDebugKotlin`은 `BUILD SUCCESSFUL in 15s`, 컨트롤러 재실행도 exit 0, `git diff --check`는 무출력이었다. XML 구조·간격·색상·클릭은 변경하지 않았으며 명세 검토 PASS, 코드 품질 APPROVED였다. 저장소 규칙에 따라 기기·에뮬레이터·androidTest·스크린샷 QA는 실행하지 않았다. + +### Phase 8 Gate + +**Goal 실행 `P8-GATE`:** 신규 목록 계약, 날짜 계산, UI binding과 기존 Gift 회귀를 최종 판정한다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDateTimeTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailPresenterTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftTrackingPresenterTest" +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin +./gradlew :app:ktlintCheck +GIT_MASTER=1 git diff --check +``` + +**Expected:** 신규 상태/날짜 테스트와 전체 Gift 회귀가 failures/errors/skipped 0이고 resource merge·Kotlin compile·변경 파일 lint·diff 검증이 성공한다. 기존 전역 ktlint 실패가 재현되면 이번 변경 파일 위반 여부를 분리해 기록한다. 저장소 규칙에 따라 기기·에뮬레이터·androidTest·스크린샷 QA는 실행하지 않는다. + +**P8-GATE 완료 증거 (2026-10-08):** focused `GiftDateTimeTest`, `GiftInboxPresenterTest`, `GiftDetailPresenterTest`, `GiftTrackingPresenterTest` 합계 55개가 `BUILD SUCCESSFUL in 10s`, failures/errors/skipped 0으로 통과했다. 전체 `kr.co.vividnext.sodalive.v2.gift.*`는 17개 클래스·211개가 failures/errors/skipped 0이고 resource merge·Kotlin compile을 포함한 강제 재실행도 `BUILD SUCCESSFUL in 2m 5s`였다. `GIT_MASTER=1 git diff --check`는 무출력으로 성공했다. `:app:ktlintCheck --rerun-tasks`는 이번 변경과 무관하고 diff에도 없는 `CreatorChannelFanTalkFragmentLayoutTest.kt`의 기존 20건만 보고해 실패했으며, ktlint 보고서에는 Phase 8 변경 파일 위반이 없다. 최종 Oracle 리뷰는 차단 사항 없이 APPROVED였다. LSP 도구는 제공되지 않아 Kotlin compile과 ktlint 보고서 대조로 대체했으며, 기기·에뮬레이터·androidTest·스크린샷 QA는 저장소 정책에 따라 실행하지 않았다. + +--- + ## 실행 순서와 의존성 | 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 | @@ -859,9 +1006,13 @@ GIT_MASTER=1 git diff --check HEAD | 22 | `P6-GATE` | Phase 6 Task 전체 | 아니요 | 실패 Task에 회귀 수정 추가 | | 23 | `P7-R1` | PRD `DEC-013` | 아니요 | 단건·다건·혼합 행 계약 재확인 | | 24 | `P7-GATE` | `P7-R1` | 아니요 | 실패 소유 Task 수정 | +| 25 | `P8-T1` | PRD `DEC-015~016` | 아니요 | UTC·남은 일수 계약 재확인 | +| 26 | `P8-T2` | `P8-T1`, 목록 신규 필드 계약 | 아니요 | 배송지·취소 상태 계약 재확인 | +| 27 | `P8-T3` | `P8-T2` | 아니요 | 기존 view binding 대조 | +| 28 | `P8-GATE` | `P8-T1`~`P8-T3` | 아니요 | 실패 소유 Task 수정 | ```text -P1-T1 → P1-T2 → P1-GATE → P2-T1 → P2-T2 → P2-T3 → P2-T4 → P2-GATE → P3-T1 → P3-T2 → P3-T3 → P3-T4/P3-T5 → P3-GATE → P4-GATE → P5-T1 → P5-T2 → P5-GATE → P6-T1 → P6-T2 → P6-T3 → P6-GATE → P7-R1 → P7-GATE +P1-T1 → P1-T2 → P1-GATE → P2-T1 → P2-T2 → P2-T3 → P2-T4 → P2-GATE → P3-T1 → P3-T2 → P3-T3 → P3-T4/P3-T5 → P3-GATE → P4-GATE → P5-T1 → P5-T2 → P5-GATE → P6-T1 → P6-T2 → P6-T3 → P6-GATE → P7-R1 → P7-GATE → P8-T1 → P8-T2 → P8-T3 → P8-GATE ``` ## 변경 금지 항목 @@ -878,7 +1029,7 @@ P1-T1 → P1-T2 → P1-GATE → P2-T1 → P2-T2 → P2-T3 → P2-T4 → P2-GATE ## 의사결정 및 중단 규칙 - PRD와 API 응답이 충돌하면 PRD Decision Log를 먼저 갱신하고, 구현은 안전한 최소 기본값으로 제한한다. -- `canceledAt`, `recipientAddressDeadlineAt`, `sortAt`이 제공되기 전에는 해당 표시를 정확히 구현했다고 완료 처리하지 않는다. `EXT-002`, `EXT-003`은 유지한다. +- `canceledAt`, `recipientAddressRegistered`, `recipientAddressDeadlineAt`은 Phase 8의 제공 계약을 사용하고, 미제공 `sortAt`은 추정하지 않는다. - `EXT-001`은 상대방 필드 3개의 계약 제공으로 해결됐다. 앱 프로필 표시는 `P6-GATE` 통과 전까지 완료 처리하지 않으며, 과거 닉네임 미제공 기록은 당시 이력으로 보존한다. - 구현 범위가 바뀌면 이 문서 체크박스를 먼저 갱신한 뒤 코드를 수정한다. - 완료된 Task와 검증 기록은 삭제하거나 덮어쓰지 않고 후속 수정 Task를 추가한다. @@ -947,6 +1098,23 @@ P1-T1 → P1-T2 → P1-GATE → P2-T1 → P2-T2 → P2-T3 → P2-T4 → P2-GATE - 향후 계약: 현재 목록 API에는 `recipientAddressDeadlineAt`이 없으므로 고정 경고를 유지한다. API 필드 제공 후 각 Address 아이템의 경고를 개별 남은 일수 문구로 바인딩한다. - 실행 위치: 사용자 요청에 따라 현재 `main` 작업 트리에서 worktree와 commit 없이 진행한다. +### 배송지 등록 여부·마감일·취소일 계획: 2026-10-08 + +- 상태: Phase 8 계획 완료, 구현 전. +- 결정: `recipientAddressRegistered`로 받은 선물 Address 여부를 판단하되 `UNDELIVERABLE`은 기존 카드를 유지한다. 마감일까지 남은 시간은 24시간 단위로 올림한다. +- 날짜: `v2.gift`의 API UTC 시각은 디바이스 타임존으로 표시하며, 목록 `CANCELED`는 `canceledAt ?: createdAt`을 사용한다. +- null 계약: 배송지 등록 완료 또는 입력 불필요 상태의 `recipientAddressDeadlineAt`은 null이며, 배송지 입력이 필요한 미등록 정상 상태에서는 유효한 미래 시각이 보장된다. +- 다음 행동: `P8-T1`의 `GiftDateTimeTest` RED부터 실행한다. + +### 배송지 등록 여부·마감일·취소일 완료: 2026-10-08 + +- 상태: `P8-T1`~`P8-T3`, `P8-GATE` 완료. +- 결과: 목록 신규 필드, 배송지 등록 여부 기반 Address 분기, 동적 마감 경고, 취소일 fallback과 Gift 공용 UTC 날짜 변환을 반영했다. +- TDD: 공용 날짜 변환 부재, 소수 초·sub-millisecond 경계, 신규 DTO/model 계약, 타임존 비결정성 실패를 각각 RED로 확인한 뒤 최소 수정으로 GREEN을 만들었다. +- 검증: focused 55개, 전체 Gift 211개 test, resource merge, Kotlin compile, 변경 파일 lint, diff-check가 성공했다. 전역 ktlint 강제 실행은 기존 fan-talk test 20건으로 실패했다. +- 리뷰: Task별 명세·품질 리뷰와 최종 Oracle 리뷰가 모두 PASS/APPROVED였다. +- 제한: LSP 도구는 제공되지 않았다. 기기·에뮬레이터·androidTest·스크린샷 QA는 저장소 정책에 따라 실행하지 않았다. + ## Decision Log | 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 | @@ -959,6 +1127,8 @@ P1-T1 → P1-T2 → P1-GATE → P2-T1 → P2-T2 → P2-T3 → P2-T4 → P2-GATE | `2026-10-01` | `DEC-006` | 확정 | 받은 선물 문의 버튼은 설정 페이지의 카카오 문의하기와 동일한 페이지로 연결한다. | 사용자 보완 요청 | `P3-T5` | | `2026-10-01` | `DEC-010` | 확정 | 상대방 ID·닉네임·이미지 계약을 반영하고 null/blank 이미지는 기존 placeholder를 사용한다. 상세 화면이 없으므로 사용자가 선택한 기존 상태 toast를 유지하며 ALL 조회·direction·pagination을 변경하지 않는다. | 사용자 제공 API 계약과 Phase 6 승인, PRD `DEC-010` | `EXT-001` 해결, `P6-T1`~`P6-GATE` | | `2026-10-06` | `DEC-011` | 정정 | 받은 선물 상단 기간 안내는 유지하고, 배송지 미입력 선물은 각자 기존 3문구 Address 아이템으로 표시한다. 첫 대상 별도 배너와 같은 선물의 일반 카드 중복은 제거한다. 현재 고정 경고는 유지하고 향후 목록 API의 아이템별 마감일로 개별 경고를 계산한다. | 사용자 요구사항 정정 및 PRD `DEC-013` | `P7-R1`, `P7-GATE` | +| `2026-10-08` | `DEC-012` | 정정 | 배송지 Address 여부를 status가 아닌 `recipientAddressRegistered`로 판단하고 `UNDELIVERABLE`은 예외로 기존 카드를 유지한다. | 승인된 PRD `DEC-014` | `P8-T2` | +| `2026-10-08` | `DEC-013` | 확정 | UTC deadline의 남은 시간을 24시간 단위로 올림하고, API UTC 날짜 표시는 디바이스 타임존을 사용한다. 취소일은 `canceledAt ?: createdAt`이다. | 승인된 PRD `DEC-015~016` | `P8-T1`~`P8-T3` | ## 발견된 문제 @@ -996,3 +1166,7 @@ P1-T1 → P1-T2 → P1-GATE → P2-T1 → P2-T2 → P2-T3 → P2-T4 → P2-GATE - 2026-10-01 P6-GATE 제한 및 경고: DTO부터 양방향 XML까지의 연결과 ALL/0/20·direction·pagination·상태 toast를 코드/테스트로 확인했다. 기기·에뮬레이터·androidTest·스크린샷 QA 및 실제 이미지 다운로드는 실행하지 않았다. LSP 도구는 제공되지 않는다. 기존 테스트 deprecated API, Gradle 9 호환성 및 `.editorconfig disabled_rules` deprecation 경고만 관찰됐으며 범위 밖 코드는 수정하지 않았다. - 2026-10-01 Phase 6 최종 리뷰: Oracle PASS, Critical/Important/Minor 각 0, 확정 발견 사항 없음. 기존 P6-GATE의 6개 클래스·55개 테스트(failures/errors/skipped=0), 전체 gift·mergeDebugResources·compileDebugKotlin·ktlint 및 `git diff --check HEAD` exit 0 증거를 `reviews/phase6-gift-inbox-counterpart-profile-review.md`에 기록했다. 회귀 수정 Task 전환과 검증 재실행은 없다. - 2026-10-06 Phase 7 완료: 배송지 미입력 단건·다건·혼합 목록의 중복 회귀 test를 추가해 기존 구현에서 13개 중 4개 실패를 확인했다. presenter의 행 조합을 아이템별 `Address`/`Card` 단일 변환으로 수정한 뒤 focused 13개와 전체 gift 회귀·resource merge·Kotlin compile이 통과했다. 전역 ktlint는 변경하지 않은 fan-talk 테스트의 기존 20건에 차단됐고 이번 변경 파일 위반은 없었다. 상단 배송지 입력 기간 안내와 고정 3문구는 유지하며, 아이템별 남은 일수는 목록 API의 `recipientAddressDeadlineAt` 제공 전까지 계산하지 않는다. +- 2026-10-08 Phase 8 TDD: `GiftDateTime` 부재 compile RED 후 UTC 날짜·남은 일수 GREEN을 만들었다. 리뷰에서 발견한 `.500Z`, `.0001Z` 정밀도 경계와 LA 기본 타임존 의존도 각각 실패를 재현한 뒤 수정했다. +- 2026-10-08 Phase 8 focused gate: `GiftDateTimeTest` 4개, `GiftInboxPresenterTest` 16개, `GiftDetailPresenterTest` 26개, `GiftTrackingPresenterTest` 9개, 합계 55개가 failures/errors/skipped 0으로 통과했다. +- 2026-10-08 Phase 8 전체 gate: 전체 Gift 17개 클래스·211개 test가 failures/errors/skipped 0이었고 resource merge·Kotlin compile 강제 재실행은 `BUILD SUCCESSFUL in 2m 5s`, diff-check는 무출력으로 성공했다. 전역 ktlint 강제 실행은 diff에 없는 `CreatorChannelFanTalkFragmentLayoutTest.kt`의 기존 20건으로 실패했으며 Phase 8 변경 파일 위반은 보고되지 않았다. +- 2026-10-08 Phase 8 최종 리뷰: 요구사항·상태 분기·UTC 정밀도·디바이스 타임존·RecyclerView binding·locale placeholder·범위 보존을 재검토해 차단 사항 없이 APPROVED 판정을 받았다. 리뷰 보고서는 `reviews/phase8-gift-inbox-address-status-review.md`에 기록했다. diff --git a/docs/20261001_선물함_리스트_페이지/reviews/phase8-gift-inbox-address-status-review.md b/docs/20261001_선물함_리스트_페이지/reviews/phase8-gift-inbox-address-status-review.md new file mode 100644 index 00000000..b1de3761 --- /dev/null +++ b/docs/20261001_선물함_리스트_페이지/reviews/phase8-gift-inbox-address-status-review.md @@ -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와 분리해 기록했다. +- 남은 항목: 없음.