docs(gift): 선물함 배송지 항목 요구사항을 정리한다

This commit is contained in:
2026-10-06 15:29:52 +09:00
parent 5609b77eba
commit a0fdf0441e
2 changed files with 100 additions and 18 deletions
@@ -780,6 +780,57 @@ git diff --check HEAD
---
## Phase 7: 배송지 미입력 아이템 중복 제거
**Phase 결과:** 받은 선물 상단의 배송지 입력 기간 안내는 유지하고, 배송지 미입력 선물마다 기존 3문구 Address 아이템만 하나씩 표시한다.
**선행조건:** PRD `GIFT-INBOX-UI-002`, `GIFT-INBOX-STATUS-002~003`, `GIFT-INBOX-BANNER-003`, `DEC-013` 확정.
**Phase 완료 조건:** `P7-R1`, `P7-GATE` 완료 및 PRD 14.7·Verification Log 갱신.
### Task 7.R1 배송지 미입력 행 중복 회귀 수정
**Goal 실행 `P7-R1`:** 기존 첫 대상 전용 Address 배너와 같은 선물의 일반 카드를 동시에 생성하는 presenter 행 조합을 수정한다.
**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/GiftInboxPresenter.kt`
- [x] **RED:** 배송지 미입력 선물 한 건은 `Notice(true)`, 해당 `Address`, `Inquiry`만 만들고 같은 신청번호의 `Card`를 만들지 않는 테스트를 작성한다.
- [x] **RED:** 배송지 미입력 선물 두 건은 서버 순서대로 `Address` 두 건을 만들며 각 신청번호를 보존하고 일반 `Card`를 만들지 않는 테스트를 작성한다.
- [x] **RED:** 배송지 입력 필요/완료 선물이 섞이면 서버 순서를 유지해 각각 `Address`/`Card`로 한 번씩만 변환하는 테스트를 작성한다.
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest"`가 기존 `firstOrNull` Address 추가와 전체 Card 추가 때문에 실패하는지 확인한다.
- [x] **GREEN:** `cards.firstOrNull { it.addressRequired }` 별도 추가를 제거하고 `cards.map`에서 `addressRequired`이면 `GiftInboxRow.Address`, 아니면 `GiftInboxRow.Card`로 최소 분기한다.
- [x] **GREEN 확인:** 같은 focused test를 실행해 통과를 확인한다.
- [x] **REFACTOR:** 기존 `GiftInboxRow.Address(card)`와 `item_gift_inbox_address_banner.xml`을 그대로 재사용하고 신규 row type·layout·API field를 추가하지 않는다.
향후 계약: 현재 목록 DTO에는 `recipientAddressDeadlineAt`이 없다. API와 timezone 정책이 제공되면 각 `Address`가 보존한 개별 card/applicationNo에 마감일 또는 계산된 경고 문구를 추가한다. 이번 Task에서는 임의 날짜나 남은 일수를 계산하지 않고 기존 고정 제목·본문·경고를 유지한다.
**P7-R1 검증 기록 (2026-10-06):** 단건·다건·혼합 행 계약을 production 변경 전에 추가했다. 기존 구현에서 focused test 13개 중 4개가 행 타입·중복 assertion으로 실패해 RED를 확인했다. `firstOrNull` 별도 Address 추가와 전체 Card 추가를 아이템별 `Address`/`Card` 변환 한 줄로 교체한 뒤 같은 13개 test가 `BUILD SUCCESSFUL in 12s`로 통과했다. 기존 Address XML의 제목·본문·경고와 각 card/applicationNo를 그대로 재사용했으며 API field·layout·row type은 추가하지 않았다.
### Phase 7 Gate
**Goal 실행 `P7-GATE`:** 배송지 미입력 단건·다건·혼합 목록과 기존 선물함 회귀를 검증한다.
- [x] `GiftInboxPresenterTest`의 단건·다건·혼합 행 계약을 통과한다.
- [x] 전체 gift local unit test, resource merge, Kotlin compile을 통과한다.
- [x] 변경 파일 ktlint와 `GIT_MASTER=1 git diff --check HEAD`를 통과한다.
- [x] PRD 14.7과 Verification Log를 실제 증거로 갱신한다.
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin
./gradlew :app:ktlintCheck
GIT_MASTER=1 git diff --check HEAD
```
**Expected:** 상단 기간 안내는 유지되고 각 배송지 미입력 선물은 Address 행 한 건으로만 표시되며, 다건의 신청번호·서버 순서가 보존된다.
**P7-GATE 검증 기록 (2026-10-06):** focused `GiftInboxPresenterTest` 13개가 `BUILD SUCCESSFUL in 12s`로 통과했다. 전체 gift local unit test와 resource merge·Kotlin compile을 `--rerun-tasks`로 실행해 `BUILD SUCCESSFUL in 1m 56s`를 확인했다. `:app:ktlintCheck --rerun-tasks`는 변경하지 않은 `CreatorChannelFanTalkFragmentLayoutTest.kt`의 기존 줄바꿈·최대 길이 20건 때문에 실패했으며 보고서에는 이번 변경 파일 위반이 없다. `GIT_MASTER=1 git diff --check HEAD`와 staging 확인은 무출력으로 통과했다. 기존 Address XML의 제목·본문·경고 3문구와 클릭 binding을 재사용했고 기기·에뮬레이터·androidTest·스크린샷 QA는 실행하지 않았다.
---
## 실행 순서와 의존성
| 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 |
@@ -806,9 +857,11 @@ git diff --check HEAD
| 20 | `P6-T2` | `P6-T1` RED 확인 | 아니요 | DTO·카드 모델·매핑 대조 |
| 21 | `P6-T3` | `P6-T2` GREEN 확인 | 아니요 | XML·Coil binding 대조 |
| 22 | `P6-GATE` | Phase 6 Task 전체 | 아니요 | 실패 Task에 회귀 수정 추가 |
| 23 | `P7-R1` | PRD `DEC-013` | 아니요 | 단건·다건·혼합 행 계약 재확인 |
| 24 | `P7-GATE` | `P7-R1` | 아니요 | 실패 소유 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
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
```
## 변경 금지 항목
@@ -887,6 +940,13 @@ P1-T1 → P1-T2 → P1-GATE → P2-T1 → P2-T2 → P2-T3 → P2-T4 → P2-GATE
- 결정: 사용자 제공 상대방 필드 3개를 두 방향 카드에 반영한다. 상세 이동과 toast 충돌은 상세 화면 부재로 기존 상태 toast 유지로 확정했다.
- 다음 행동: `P6-T1`에서 프로필 매핑과 null/blank URL 정규화 RED를 확인한다. 기존 53개 테스트 통과 기록은 Phase 5 당시 증거이며 Phase 6 완료 증거로 사용하지 않는다.
### 배송지 미입력 아이템 요구사항 정정: 2026-10-06
- 상태: Phase 7 계획 등록, 구현 전.
- 결정: 상단 `배송지 입력 기간 안내`는 유지한다. 배송지 미입력 선물은 별도 첫 대상 배너와 일반 카드로 중복 표시하지 않고 각 선물마다 기존 3문구 Address 아이템 하나로 표시한다.
- 향후 계약: 현재 목록 API에는 `recipientAddressDeadlineAt`이 없으므로 고정 경고를 유지한다. API 필드 제공 후 각 Address 아이템의 경고를 개별 남은 일수 문구로 바인딩한다.
- 실행 위치: 사용자 요청에 따라 현재 `main` 작업 트리에서 worktree와 commit 없이 진행한다.
## Decision Log
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 |
@@ -898,6 +958,7 @@ P1-T1 → P1-T2 → P1-GATE → P2-T1 → P2-T2 → P2-T3 → P2-T4 → P2-GATE
| `2026-10-01` | `DEC-005` | 확정 | 현재 상세 페이지가 없으므로 item 터치 시 상태 표시 문구 toast를 보여준다. | 사용자 보완 요청 | `P3-T4` |
| `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` |
## 발견된 문제
@@ -934,3 +995,4 @@ P1-T1 → P1-T2 → P1-GATE → P2-T1 → P2-T2 → P2-T3 → P2-T4 → P2-GATE
- 2026-10-01 P6-GATE 신규 검증: focused presenter/ViewModel 명령 exit 0, `BUILD SUCCESSFUL in 22s`; `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck` exit 0, `BUILD SUCCESSFUL in 10s`. XML 직접 집계는 6개 클래스·55개 테스트(focused 대상 22개 포함), failures/errors/skipped=0이며 테스트 소스 클래스 목록과 일치했다. resource merge·Kotlin compile은 UP-TO-DATE, 전체 테스트와 main/test ktlint는 실행됐다. `git diff --check HEAD` exit 0, 출력 없음. Phase 6을 3/3 및 게이트 통과로 갱신하고 PRD 14.5를 완료 처리했다. 기존 로그는 보존했다.
- 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` 제공 전까지 계산하지 않는다.