From a0fdf0441e0ee8fb6e5361673911d22a8ba89eb3 Mon Sep 17 00:00:00 2001 From: klaus Date: Tue, 6 Oct 2026 15:29:52 +0900 Subject: [PATCH] =?UTF-8?q?docs(gift):=20=EC=84=A0=EB=AC=BC=ED=95=A8=20?= =?UTF-8?q?=EB=B0=B0=EC=86=A1=EC=A7=80=20=ED=95=AD=EB=AA=A9=20=EC=9A=94?= =?UTF-8?q?=EA=B5=AC=EC=82=AC=ED=95=AD=EC=9D=84=20=EC=A0=95=EB=A6=AC?= =?UTF-8?q?=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../plan-task.md | 64 ++++++++++++++++++- docs/20261001_선물함_리스트_페이지/prd.md | 54 +++++++++++----- 2 files changed, 100 insertions(+), 18 deletions(-) diff --git a/docs/20261001_선물함_리스트_페이지/plan-task.md b/docs/20261001_선물함_리스트_페이지/plan-task.md index 65f348c7..b2b918f5 100644 --- a/docs/20261001_선물함_리스트_페이지/plan-task.md +++ b/docs/20261001_선물함_리스트_페이지/plan-task.md @@ -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` 제공 전까지 계산하지 않는다. diff --git a/docs/20261001_선물함_리스트_페이지/prd.md b/docs/20261001_선물함_리스트_페이지/prd.md index 9a56d159..4c66b215 100644 --- a/docs/20261001_선물함_리스트_페이지/prd.md +++ b/docs/20261001_선물함_리스트_페이지/prd.md @@ -6,7 +6,7 @@ |---|---| | 문서 상태 | 구현 기준 확정 | | 작성일 | `2026-10-01` | -| 최종 수정일 | `2026-10-01` | +| 최종 수정일 | `2026-10-06` | | 대상 제품 | 선물함 리스트 페이지 UI·목록 API 연동 및 마이 탭 진입점 | | 작성자·결정권자 | 사용자 요청 기준 | | 관련 API Contract | `GET /api/v2/gifts?type=ALL&page=0&size=20` | @@ -41,7 +41,7 @@ - `hasNext=true`이면 스크롤 하단에서 다음 page를 추가 조회한다. - `items[].direction == SENT`는 보낸 선물 카드로, `RECEIVED`는 받은 선물 카드로 표시한다. - 리스트는 서버 응답 순서를 유지한다. 서버는 현재 `createdAt desc, id desc`로 정렬한다. -- 카드 탭 시 현재 상세 화면 대신 item 상태 표시 문구를 toast로 보여준다. +- 카드 또는 배송지 입력 안내 배너 탭 시 item의 `applicationNo`로 선물 상세를 연다. - 한국 접속·한국어 유효 언어 조건을 모두 충족하면 마이 탭 기능 아이콘 목록의 첫 번째에 선물함 진입점을 표시한다. ### 3.2 UX 목표 @@ -57,7 +57,7 @@ - `SENT`, `RECEIVED` 별도 목록 API 호출. - 클라이언트 임의 재정렬. - 취소일, 배송지 입력 마감일을 추정해서 표시. -- 선물 상세 페이지 신규 구현. 이번 범위는 상세 이동 없이 상태 toast만 포함한다. +- 선물 상세 페이지 자체 구현. 목록은 후속 상세 구현의 `GiftDetailActivity`로 연결만 한다. - 사용자 승인을 받은 `MyPageFragment`의 선물함 진입점 최소 연결 외 레거시 코드 직접 수정. - `app/src/androidTest`, `connectedDebugAndroidTest`, 기기·에뮬레이터 UI 조작, 스크린샷 기반 시각 QA. @@ -86,14 +86,14 @@ 5. `direction=SENT` item은 보낸 선물 카드로 표시한다. 6. `direction=RECEIVED` item은 받은 선물 카드로 표시한다. 7. 하단 스크롤 도달 시 `hasNext=true`이면 다음 page를 추가 조회해 기존 목록 뒤에 붙인다. -8. 카드 탭 시 상세 이동 대신 item 상태 표시 문구를 toast로 보여준다. +8. 카드 또는 배송지 입력 안내 배너를 누르면 item의 `applicationNo`로 선물 상세를 연다. 9. API 실패 시 기존 toast/dialog 패턴과 재시도 UI를 제공하고 기존 입력/스크롤 상태를 깨지 않는다. ## 7. 정보 구조와 라우팅 ```text GiftInboxActivity - -> Toast(status display text) + -> GiftDetailActivity(applicationNo) -> 설정 페이지의 카카오 문의하기와 동일한 문의 화면 ``` @@ -104,7 +104,7 @@ GiftInboxActivity - API 호출은 진입 관점과 무관하게 항상 `type=ALL`만 사용한다. - 빈 상태 판정은 진입 관점과 사용자 유형으로 결정한다. `SENT`로 진입했고 표시할 보낸 선물이 없으면 보낸 선물 빈 상태, `RECEIVED`로 진입했고 표시할 받은 선물이 없으면 받은 선물 빈 상태를 사용한다. - `ALL` 진입에서 전체 목록이 비었을 때 현재 사용자가 크리에이터이면 받은 선물 없음 UI를 표시하고, 일반 회원이면 보낸 선물 신청 내역 없음 UI를 표시한다. 현재 선물은 크리에이터만 받을 수 있고 일반 회원은 받을 수 없다. -- 현재 선물 상세 페이지가 없으므로 카드나 배송지 입력 배너를 터치하면 상세 이동 대신 해당 item의 상태 표시 문구를 토스트로 보여준다. +- 카드나 배송지 입력 배너를 터치하면 item의 `applicationNo`만 `GiftDetailActivity`에 전달한다. - 받은 선물 empty 또는 하단 `문의하기`/`의견 남기기` 버튼은 설정 페이지의 카카오 문의하기와 동일한 화면으로 연결한다. ## 8. 기능 요구사항 @@ -123,18 +123,18 @@ GiftInboxActivity | ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 | |---|---|---|---|---| | `GIFT-INBOX-UI-001` | 확정 | `direction=SENT`는 보낸 선물 카드로 렌더링한다. | 상태명, 날짜 라벨, 상대 표시 영역, 사이즈/카테고리, chevron이 표시된다. | `P1-T2`, `P3-T1` | -| `GIFT-INBOX-UI-002` | 확정 | `direction=RECEIVED`는 받은 선물 카드로 렌더링한다. | 팬 식별 영역, 날짜 라벨, 상태 메인/서브 문구, chevron이 표시된다. | `P1-T2`, `P3-T1` | +| `GIFT-INBOX-UI-002` | 정정 | `direction=RECEIVED`는 받은 선물 아이템으로 렌더링한다. 단, 배송지 입력이 필요한 선물은 일반 받은 카드 대신 기존 3문구 Address 아이템을 사용한다. | 배송지 미입력 선물은 `팬이 보낸 선물이 있어요!`, 배송지 입력 안내, 반송 경고와 chevron을 표시하고 같은 신청번호의 일반 카드를 중복 표시하지 않는다. | `P1-T2`, `P3-T1`, `P7-R1` | | `GIFT-INBOX-UI-003` | 확정 | `신청 내역`, `선물 내역` 텍스트는 노출하지 않는다. | string/resource/layout에 화면 노출용 section title로 추가하지 않는다. | `P3-GATE` | | `GIFT-INBOX-UI-004` | 확정 | 상단 내비게이션은 고정하고 하단 콘텐츠만 스크롤한다. | root는 고정 header와 scroll/recycler content 영역으로 분리된다. | `P3-T2` | -| `GIFT-INBOX-UI-005` | 확정 | 현재 선물 상세 페이지가 없으므로 item 터치 시 상세 이동 대신 상태 표시 문구를 toast로 보여준다. | 보낸 카드와 받은 카드 터치 모두 item의 상태 문구 toast event를 발생시킨다. | `P3-T4` | +| `GIFT-INBOX-UI-005` | 정정 | 보낸 카드·받은 카드·배송지 미입력 Address 아이템 터치 시 해당 `applicationNo`로 선물 상세를 연다. | 각 목록 아이템이 자신의 신청번호로 `GiftDetailActivity`를 한 번 실행한다. | `P7-R1`, 상세 문서 `P2-T3`, `P7-T5` | ### 8.3 상태 문구 매핑 | ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 | |---|---|---|---|---| | `GIFT-INBOX-STATUS-001` | 확정 | 보낸 선물 상태 코드를 요구사항 표의 표시 문구로 매핑한다. | `RECEIVED`는 `운송장 등록 필요`, `CANCELED`는 `신청 취소`로 변환된다. | `P1-T2` | -| `GIFT-INBOX-STATUS-002` | 확정 | 받은 선물 상태 코드를 메인/서브 문구로 매핑한다. | `TRACKING_REGISTERED`는 `배송지 입력 필요`/`전달 예정`으로 변환된다. | `P1-T2` | -| `GIFT-INBOX-STATUS-003` | 외부 의존 | 배송지 입력 마감일 기반 `n일 이내` 문구는 API가 `recipientAddressDeadlineAt`을 제공해야 정확히 계산한다. | API 보강 전에는 고정 보조 문구를 쓰지 않거나 Figma 문구의 숫자 없는 버전을 사용한다. | `EXT-003`, `P3-T3` | +| `GIFT-INBOX-STATUS-002` | 정정 | 받은 선물 상태 코드를 표시 형태와 문구로 매핑한다. | `TRACKING_REGISTERED`는 일반 카드의 `배송지 입력 필요`/`전달 예정`이 아니라 기존 제목·본문·경고 3문구의 Address 아이템으로 변환된다. | `P1-T2`, `P7-R1` | +| `GIFT-INBOX-STATUS-003` | 외부 의존 | 배송지 입력 마감일 기반 `n일 이내` 경고 문구는 목록 API가 아이템별 `recipientAddressDeadlineAt`을 제공해야 정확히 계산한다. | API 보강 전에는 현재 고정 경고를 사용한다. 각 Address 아이템은 자신의 신청번호를 보존해 향후 아이템별 기한 문구를 바인딩할 수 있어야 한다. | `EXT-003`, `P7-R1` | ### 8.4 빈 상태와 배너 @@ -145,7 +145,7 @@ GiftInboxActivity | `GIFT-INBOX-EMPTY-003` | 확정 | `ALL` 진입에서 전체 목록이 비었을 때 크리에이터이면 받은 선물 없음, 일반 회원이면 보낸 선물 신청 내역 없음 형태로 표시한다. | 사용자 유형이 creator이면 `RECEIVED` empty, 아니면 `SENT` empty 정책을 적용한다. | `P3-T3` | | `GIFT-INBOX-BANNER-001` | 확정 | 보낸 선물 콘텐츠에는 안전 배송 안내 배너를 표시한다. | 제목/본문이 요구 문구와 일치한다. | `P3-T2` | | `GIFT-INBOX-BANNER-002` | 확정 | 받은 선물 콘텐츠에는 배송지 입력 기간 안내 배너를 표시한다. | 제목/본문이 요구 문구와 일치한다. | `P3-T2` | -| `GIFT-INBOX-BANNER-003` | 외부 의존 | 배송지 입력이 필요한 선물이 있으면 파란 안내 배너를 리스트 상단에 표시한다. | `TRACKING_REGISTERED` 받은 선물이 있을 때 첫 대상 상태 문구를 toast로 보여준다. 남은 일수는 API 보강 전 정확히 계산하지 않는다. | `EXT-003`, `P3-T3` | +| `GIFT-INBOX-BANNER-003` | 정정 | 배송지 입력이 필요한 받은 선물은 별도 상단 배너가 아니라 해당 선물 위치의 파란 Address 아이템으로 표시한다. | `TRACKING_REGISTERED` 받은 선물마다 Address 아이템이 하나씩 생성되고 같은 신청번호의 일반 카드는 생성되지 않는다. 각 아이템은 자신의 상세로 이동하며, 남은 일수는 API 보강 전 현재 고정 경고를 사용한다. | `EXT-003`, `P7-R1`, 상세 문서 `P7-T5` | | `GIFT-INBOX-INQUIRY-001` | 확정 | 받은 선물 empty 또는 하단 문의 버튼은 설정 페이지의 카카오 문의하기와 동일한 페이지로 연결한다. | 기존 설정 페이지 카카오 문의하기 intent/URL 패턴을 재사용한다. | `P3-T5` | ### 8.5 마이 탭 진입점 @@ -162,7 +162,7 @@ GiftInboxActivity |---|---|---|---|---| | `GIFT-INBOX-PROFILE-001` | 확정 | item의 `counterpartMemberId: Long`, `counterpartNickname: String`, `counterpartProfileImageUrl: String?`를 수용한다. `SENT`의 상대는 수신 크리에이터, `RECEIVED`의 상대는 발신 팬이다. | 두 방향의 상대 ID·닉네임·이미지 URL이 DTO에서 카드 UI 모델로 전달된다. | `EXT-001`, `P6-T1`, `P6-T2` | | `GIFT-INBOX-PROFILE-002` | 확정 | 두 카드의 프로필 행에 이미지와 상대방 닉네임을 표시한다. null/blank 이미지 URL은 null로 정규화하고 `ic_placeholder_profile`을 사용한다. | 유효 URL은 유지하고 null·빈 문자열·공백 문자열은 null로 매핑한다. 기존 Coil로 이미지와 placeholder를 바인딩한다. | `P6-T1`, `P6-T2`, `P6-T3` | -| `GIFT-INBOX-PROFILE-003` | 확정 | `SENT`는 프로필 아래 `sizeName · categoryName`을 유지하고, `RECEIVED`는 상단 프로필·날짜와 본문 상태를 유지한다. 기존 조회·direction·pagination·상태 toast 동작은 변경하지 않는다. | `ALL/0/20` 최초 조회, 다음 page append 및 카드 클릭 상태 toast 회귀 테스트가 통과한다. 상세 Activity/deeplink는 추가하지 않는다. | `P6-T3`, `P6-GATE` | +| `GIFT-INBOX-PROFILE-003` | 정정 | `SENT`는 프로필 아래 `sizeName · categoryName`을 유지하고, `RECEIVED`는 상단 프로필·날짜와 본문 상태를 유지한다. 기존 조회·direction·pagination·상세 이동을 변경하지 않는다. | `ALL/0/20` 최초 조회, 다음 page append 및 카드·배너 상세 이동 회귀 테스트가 통과한다. | `P6-T3`, `P6-GATE`, 상세 문서 `P7-T5` | ## 9. UI/UX Expectations @@ -185,7 +185,7 @@ GiftInboxActivity ### 9.3 화면 상태 - Loading: 최초 조회 중 기존 리스트 loading 또는 loading dialog/skeleton 패턴을 사용한다. -- Content: 안내 배너, 필요 시 배송지 입력 안내 배너, 카드 리스트, 하단 문의 버튼을 콘텐츠 스크롤 영역에 포함한다. +- Content: 방향별 상단 안내 배너, 배송지 미입력 선물별 Address 아이템, 나머지 카드 리스트, 하단 문의 버튼을 콘텐츠 스크롤 영역에 포함한다. - Empty: 진입 관점에 따라 보낸 선물 empty 또는 받은 선물 empty를 표시한다. `ALL` 진입의 전체 빈 목록은 사용자 유형으로 분기한다. - Error: 첫 페이지 실패는 retry UI를 표시하고, append 실패는 기존 목록을 유지하며 feedback을 표시한다. @@ -267,7 +267,7 @@ Authorization: Bearer {token} | API status | 메인 문구 | 서브 문구 | |---|---|---| -| `TRACKING_REGISTERED` | `배송지 입력 필요` | `전달 예정` | +| `TRACKING_REGISTERED` | 일반 카드 대신 `팬이 보낸 선물이 있어요!` Address 아이템 | 배송지 입력 안내와 반송 경고 | | `ARRIVED_AT_MAILBOX` | `선물 검수` | `선물 확인 중` | | `INSPECTION_COMPLETED` | `선물 검수 완료` | `배송 중` | | `DELIVERED` | `전달 완료` | 없음 | @@ -296,7 +296,7 @@ Authorization: Bearer {token} - [x] `direction=SENT` item은 보낸 선물 카드 UI 모델로 변환된다. - [x] `direction=RECEIVED` item은 받은 선물 카드 UI 모델로 변환된다. - [x] `hasNext=true`일 때 다음 page를 추가 조회한다. -- [x] 카드 탭 시 상세 이동 대신 item 상태 표시 문구 toast event가 발생한다. +- [x] 카드와 배송지 입력 배너 탭 시 item의 `applicationNo`로 상세 이동 event가 발생한다. ### 14.2 UI/UX 수용 기준 @@ -324,17 +324,32 @@ Authorization: Bearer {token} - [x] `SENT`의 수신 크리에이터와 `RECEIVED`의 발신 팬 ID·닉네임·이미지 URL이 카드 UI 모델로 전달된다. - [x] 두 카드 프로필 행에 이미지와 API 닉네임이 표시되며 null/blank 이미지에는 `ic_placeholder_profile`을 사용한다. - [x] `SENT` 프로필 아래 `sizeName · categoryName`, `RECEIVED` 상단 프로필·날짜와 본문 상태를 유지한다. -- [x] `ALL/0/20` 최초 조회, direction 렌더링, pagination, 카드 클릭 상태 toast가 유지되며 상세 화면·deeplink는 추가하지 않는다. +- [x] `ALL/0/20` 최초 조회, direction 렌더링, pagination, 카드·배너 상세 이동이 유지된다. - [x] `P6-T1`~`P6-T3`, `P6-GATE` 검증 증거를 기록한다. 기존 완료 기준은 당시 완료 이력으로 유지한다. 검증 근거 (2026-10-01): `plan-task.md`의 P6-GATE 신규 실행에서 focused 테스트와 전체 gift·resource merge·Kotlin compile·ktlint 명령 및 `git diff --check HEAD`가 모두 exit 0이었다. XML 직접 집계는 55개, failures/errors/skipped=0이다. 프로필 표시는 DTO→presenter→모델→adapter→양방향 XML 연결을 대조해 판정했으며 실제 기기·에뮬레이터 표시, 이미지 다운로드, 스크린샷·시각 QA는 수행하지 않았다. +### 14.6 2026-10-06 Figma 회귀 점검 + +- [x] 받는 사람 목록의 프로필·날짜·상태·서브 문구 구조가 Figma `2531:36237`과 일치한다. +- [x] 보내는 사람 목록의 상태·날짜·프로필·사이즈/카테고리 구조가 Figma `2481:19382`와 일치한다. +- [x] 배송지 미입력 배너 구조가 Figma `2531:36243`과 일치한다. +- [x] 목록 구현에는 수정이 필요한 확정 결함이 없어 기존 코드를 유지한다. + +### 14.7 배송지 미입력 아이템 중복 제거 + +- [x] 받은 선물 상단의 `배송지 입력 기간 안내` 배너는 유지된다. +- [x] 배송지 미입력 선물은 일반 받은 카드가 아니라 제목·본문·경고 3문구의 Address 아이템으로 표시된다. +- [x] 배송지 미입력 선물이 여러 개면 각 선물마다 Address 아이템이 하나씩 생성되고 각자 자신의 상세로 이동한다. +- [x] 같은 배송지 미입력 선물의 Address 아이템과 일반 카드가 동시에 표시되지 않는다. +- [x] 목록 API에 `recipientAddressDeadlineAt`이 추가되기 전에는 고정 경고를 유지하고 임의 남은 일수를 계산하지 않는다. + ## 15. Open Questions | ID | 상태 | 결정 필요 사항 | 현재 권고 | 결정 주체 | 결정 시점 | 영향 Goal | |---|---|---|---|---|---|---| | `OQ-001` | 확정 | `ALL` 진입에서 전체 목록이 비었을 때 보낼/받을 중 어느 empty를 보여줄지 | 크리에이터이면 받은 선물 없음, 일반 회원이면 보낸 선물 신청 내역 없음으로 표시한다. | 사용자 | `2026-10-01` | `P3-T3` | -| `OQ-002` | 확정 | 선물 상세 화면이 없을 때 카드 탭 처리 | 상세 이동 대신 item 상태 표시 문구를 toast로 보여준다. | 사용자 | `2026-10-01` | `P3-T4` | +| `OQ-002` | 정정 | 선물 상세 화면이 없을 때 카드 탭 처리 | 후속 상세 구현 완료 후 item의 `applicationNo`로 상세를 연다. | 사용자 | `2026-10-02` | 상세 문서 `P2-T3`, `P7-T5` | | `OQ-003` | 확정 | 받은 선물 하단 `문의하기` 버튼 연결 | 설정 페이지의 카카오 문의하기와 동일한 페이지로 연결한다. | 사용자 | `2026-10-01` | `P3-T5` | | `OQ-004` | 확정 | 마이 탭 진입점 구현에 필요한 레거시 `MyPageFragment` 직접 수정 | 아이콘 목록 생성부와 import만 최소 수정한다. | 사용자 | `2026-10-01` | `P5-T2` | | `OQ-005` | 확정 | 한국어 설정의 판정 기준 | 앱 선택 언어를 우선하고 미선택 시 시스템 언어를 반영하는 `LanguageManager.getEffectiveLanguage`를 사용한다. | 사용자 | `2026-10-01` | `P5-T1` | @@ -348,6 +363,8 @@ Authorization: Bearer {token} | 화면 layout/empty/banner | Figma node IDs | 3 | `P3-T1`~`P3-T5`, `P3-GATE` | mapper/source/resource test | 사용자가 요청한 경우만 수동 QA | | 마이 탭 선물함 진입점 | 국가 코드·유효 언어·기존 기능 아이콘 목록 | 5 | `P5-T1`, `P5-T2`, `P5-GATE` | 진입점 노출 정책 local unit test | 코드·리소스 read-only 대조 | | 상대방 프로필 | Response item 상대방 필드 3개 | 6 | `P6-T1`, `P6-T2`, `P6-T3`, `P6-GATE` | `GiftInboxPresenterTest`, `GiftInboxViewModelTest`, 전체 gift local unit test | XML·adapter read-only 대조 | +| 2026-10-06 Figma 회귀 점검 | Figma `2531:36237`, `2481:19382`, `2531:36243` | 6 후속 점검 | 코드 변경 없음 | 기존 gift 회귀 | Figma screenshot·XML·adapter 대조 | +| 배송지 미입력 아이템 중복 제거 | 목록 item `status=TRACKING_REGISTERED` | 7 | `P7-R1`, `P7-GATE` | `GiftInboxPresenterTest` | presenter·adapter·기존 Address XML 대조 | ## 17. Decision Log @@ -363,6 +380,9 @@ Authorization: Bearer {token} | `2026-10-01` | `DEC-008` | 확정 | 마이 탭 선물함 항목은 `countryCode=KR`과 유효 언어 `ko`를 모두 충족할 때만 첫 번째에 표시한다. | 사용자 요구 및 판정 기준 확인 | `GIFT-INBOX-ENTRY-001`, `GIFT-INBOX-ENTRY-002`, `P5-T1`, `P5-T2` | | `2026-10-01` | `DEC-009` | 확정 | 레거시 `MyPageFragment`는 선물함 항목과 클릭 연결을 위해 최소 범위로 직접 수정한다. | 사용자 명시 승인 | `GIFT-INBOX-ENTRY-003`, `P5-T2` | | `2026-10-01` | `DEC-010` | 확정 | 상대방 필드 3개로 두 방향 카드의 이미지·닉네임을 표시하고 null/blank 이미지는 기존 placeholder로 처리한다. 상세 이동과 toast의 충돌은 상세 화면이 없으므로 기존 상태 toast 유지로 확정한다. 조회·direction·pagination은 유지한다. | 사용자 제공 API 계약과 Phase 6 승인, toast 선택 | `EXT-001` 해결, `GIFT-INBOX-PROFILE-001~003`, `P6-T1`~`P6-GATE` | +| `2026-10-06` | `DEC-011` | 확정 | 받는 사람·보내는 사람 목록과 배송지 미입력 배너는 제공된 Figma와 현행 adapter/XML 대조에서 수정이 필요한 확정 결함이 없어 유지한다. 상세 이동은 후속 상세 문서의 완료 구현을 따른다. | Figma 3개 노드와 `GiftInboxAdapter`·item XML 대조 | 14.6 회귀 점검 | +| `2026-10-06` | `DEC-012` | 정정 | `DEC-006`과 `DEC-010`의 상태 toast 결정을 대체하고, 카드와 배송지 입력 배너는 후속 구현된 `GiftDetailActivity`를 `applicationNo`로 연다. | 상세 화면 구현 완료와 현행 `GiftInboxActivity`·`GiftNavigationTest` 대조 | `GIFT-INBOX-UI-005`, `GIFT-INBOX-BANNER-003`, 상세 문서 `P7-T5` | +| `2026-10-06` | `DEC-013` | 정정 | `DEC-011`의 배송지 미입력 배너 유지 결정을 대체한다. 받은 선물 상단의 배송지 입력 기간 안내는 유지하되, 배송지 미입력 선물은 별도 배너와 일반 카드로 중복 표시하지 않고 각 선물 위치의 3문구 Address 아이템으로 표시한다. 현재 목록 API에는 마감일이 없으므로 고정 경고를 유지하고, 향후 아이템별 `recipientAddressDeadlineAt` 제공 시 각 Address 아이템의 경고를 개별 계산한다. | 사용자 요구사항 정정 및 목록 API 계약 확인 | `GIFT-INBOX-UI-002`, `GIFT-INBOX-STATUS-002~003`, `GIFT-INBOX-BANNER-003`, `P7-R1`, `P7-GATE` | ## 18. 변경 관리