docs(gift): 배송지 상태와 날짜 구현을 기록한다
This commit is contained in:
@@ -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<T>`와 `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`에 기록했다.
|
||||
|
||||
@@ -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와 분리해 기록했다.
|
||||
- 남은 항목: 없음.
|
||||
Reference in New Issue
Block a user