From c37b42492900dc547e6c068c565fa73db51f085a Mon Sep 17 00:00:00 2001 From: klaus Date: Tue, 6 Oct 2026 15:29:56 +0900 Subject: [PATCH] =?UTF-8?q?docs(gift):=20=EC=84=A0=EB=AC=BC=20=EC=83=81?= =?UTF-8?q?=EC=84=B8=20=ED=9A=8C=EA=B7=80=20=EC=88=98=EC=A0=95=20=EA=B3=84?= =?UTF-8?q?=ED=9A=8D=EC=9D=84=20=EC=A0=95=EB=A6=AC=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../plan-task.md | 93 +++++++++++++++++++ docs/20261002_선물_상세와_운송장_등록/prd.md | 28 +++++- 2 files changed, 119 insertions(+), 2 deletions(-) diff --git a/docs/20261002_선물_상세와_운송장_등록/plan-task.md b/docs/20261002_선물_상세와_운송장_등록/plan-task.md index c0c15aac..d4aa62cb 100644 --- a/docs/20261002_선물_상세와_운송장_등록/plan-task.md +++ b/docs/20261002_선물_상세와_운송장_등록/plan-task.md @@ -29,6 +29,7 @@ | 5 | 완료 | `6/6` (`P5-GATE`, `P5-R1`, `P5-R2`, `P5-R3`, `P5-R4`, `P5-D2`) | 완료 | 없음 | | 6 | 완료 | `7/7` | 완료 | 없음 | | 7 | 완료 | `10/10` | 완료 | 없음 | +| 8 | 계획 완료 | `0/4` | `P8-R1` | 없음 | `P5-D2`에서 최종 직렬 Gate와 재검토 증거에 따라 상태를 정리했다. 아래의 진행 중·대기·실패 기록은 각 실행 당시의 이력이며, 최신 판정은 현재 상태 표와 마지막 Verification Log를 기준으로 한다. 기존 완료 Task와 당시 검증 기록은 보존한다. @@ -1173,6 +1174,90 @@ GIT_MASTER=1 git diff --check HEAD **Gate 검증 기록:** P7-R4와 Oracle 재검토 후 위 명령을 병렬 실행하지 않고 순서대로 새로 실행했다. gift/modal focused suite는 `BUILD SUCCESSFUL in 21s`, JUnit XML 16개에서 180 tests, failures/errors/skipped=0이었다. 전체 local unit suite는 `BUILD SUCCESSFUL in 1m 1s`, JUnit XML 189개에서 1,447 tests, failures/errors/skipped=0이었다. resource merge·Kotlin compile·ktlint는 `BUILD SUCCESSFUL in 1s`, `assembleDebug`는 `BUILD SUCCESSFUL in 4s`였다. `GIT_MASTER=1 git diff --check HEAD`와 `GIT_MASTER=1 git diff --cached --name-only`는 모두 무출력이다. 기존 Gradle deprecated 경고는 실패가 아니며 범위 밖이라 수정하지 않았다. 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 저장소 규칙에 따라 실행하지 않았다. `REV-P7-GATE-001`~`002`는 수정·검증 완료, Oracle P7-R4 재검토 APPROVED, 신규 차단 finding 없음으로 Phase 7을 완료한다. +## Phase 8: 상태 배지·상단 이미지·약관 터치 회귀 수정 + +**Phase 결과:** 상세 상단의 Figma 비대상 이미지를 제거하고 상태별 배지 스타일을 적용하며, 받은 사람 배송지 입력의 약관 문구에서 지정된 Notion 페이지를 외부 브라우저로 연다. + +**선행조건:** PRD `GIFT-UI-DEBUG-001`~`003`, `DEC-022`, `DEC-024` 확정. + +**Phase 완료 조건:** `P8-R1`, `P8-R2`, `P8-R3`, `P8-GATE` 완료, PRD 14.6과 Verification Log 갱신. + +### Task 8.R1 상세 상단 이미지 제거 + +**Goal 실행 `P8-R1`:** 모든 상세 상태에서 Figma에 없는 `hero_illustration`을 렌더링하지 않는다. + +**Files:** + +- Modify: `app/src/main/res/layout/activity_gift_detail.xml` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailActivity.kt` (이미지 binding 참조가 있을 때만) + +- [ ] `hero_illustration` View와 그 참조를 최소 제거한다. +- [ ] Figma 상세 노드와 XML/source를 대조해 상태 안내·progress·action의 기존 순서가 유지됨을 기록한다. +- [ ] layout 크기·visibility 직접 unit test는 작성하지 않는다. +- [ ] `:app:mergeDebugResources :app:compileDebugKotlin`으로 stale binding 참조가 없음을 검증한다. + +### Task 8.R2 상태별 배지 presentation과 binding + +**Goal 실행 `P8-R2`:** 일반 진행·전달 불가·취소 완료의 배경·전경 조합과 배지 숨김 여부를 presentation model로 결정한다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailModels.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenter.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailActivity.kt` +- Modify/Create only if needed: `app/src/main/res/drawable/bg_gift_detail_status_*.xml` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenterTest.kt` + +- [ ] **RED:** 일반 진행 상태가 흰 배경·검은 글자, `UNDELIVERABLE`이 빨간 배경·검은 글자, `CANCELED`가 회색 배경·흰 글자를 선택하는 presenter test를 작성한다. +- [ ] **RED:** label이 없는 상태는 배지 model이 null이고 빈 영역을 만들지 않는 test를 작성한다. +- [ ] **RED 확인:** 상태별 style 결정 부재 실패를 기록한다. +- [ ] **GREEN:** 최소 enum/value model로 배지 style을 표현하고 Activity는 model만 binding한다. +- [ ] **GREEN 확인:** presenter focused test PASS를 기록한다. +- [ ] **REFACTOR:** 기존 color/drawable을 우선 재사용하고 신규 공통 디자인 시스템이나 View 속성 직접 assertion을 추가하지 않는다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailPresenterTest" --rerun +``` + +### Task 8.R3 받은 사람 약관 외부 링크 + +**Goal 실행 `P8-R3`:** 배송지 입력 화면의 이용약관과 개인정보 `(필수)` 터치를 분리하고 두 경로 모두 지정된 Notion URL을 연다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailActivity.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` + +- [ ] **RED:** 두 handler가 각각 `ACTION_VIEW`와 정확한 Notion URL을 갖는 Intent를 만드는 navigation test를 작성한다. +- [ ] **RED:** 링크 실행 전후 배송지 form 입력·약관 체크·CTA 계산이 유지되는 test를 작성한다. +- [ ] **RED 확인:** 전용 handler 또는 외부 Intent 부재 실패를 기록한다. +- [ ] **GREEN:** 두 문구의 클릭 listener를 전용 함수로 분리하고 기존 외부 브라우저 Intent 패턴과 URL 상수를 재사용한다. +- [ ] **GREEN 확인:** navigation focused test PASS를 기록한다. +- [ ] **REFACTOR:** `선물 정책 확인` action의 기존 no-op/toast 정책은 변경하지 않고 신규 화면·WebView·dependency를 추가하지 않는다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun +``` + +### Task 8.4 통합 Gate + +**Goal 실행 `P8-GATE`:** Phase 8과 기존 Gift/modal 영향 범위를 직렬 검증한다. + +- [ ] gift/modal focused test를 실행한다. +- [ ] 전체 local unit test를 실행한다. +- [ ] resource merge, Kotlin compile, ktlint, debug assemble을 실행한다. +- [ ] `GIT_MASTER=1 git diff --check HEAD`를 실행한다. +- [ ] Figma/source 대조와 PRD 14.6, 현재 상태, Verification Log를 실제 증거로 갱신한다. +- [ ] 코드 리뷰에서 확정 finding이 나오면 기존 완료 Task를 다시 열지 않고 `P8-R*` 회귀 수정 Task를 먼저 추가한다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --tests "kr.co.vividnext.sodalive.v2.components.modal.*" --rerun +./gradlew :app:testDebugUnitTest --rerun +./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck +./gradlew :app:assembleDebug +GIT_MASTER=1 git diff --check HEAD +``` + ## 실행 순서와 의존성 | 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 | @@ -1212,6 +1297,10 @@ GIT_MASTER=1 git diff --check HEAD | 33 | `P7-T4` | `P7-T2`, `P7-T3` | 아니요 | Kakao 주소 검색·resource binding 재대조 | | 34 | `P7-T5` | `P7-T3`, `P7-T4` | 아니요 | 상세 reload·목록 갱신 결과 재대조 | | 35 | `P7-GATE` | Phase 7 Task 전체 | 아니요 | 실패 소유 Task에 `P7-R*` 등록 | +| 36 | `P8-R1` | 승인된 PRD `GIFT-UI-DEBUG-001` | `P8-R2` test 작성과 파일 비중복 시 가능 | Figma/XML 참조 재대조 | +| 37 | `P8-R2` | 승인된 PRD `GIFT-UI-DEBUG-002` | `P8-R1`과 파일 비중복 시 가능 | presenter style 계약 재대조 | +| 38 | `P8-R3` | 승인된 PRD `GIFT-UI-DEBUG-003` | `P8-R2` test 작성과 파일 비중복 시 가능 | 외부 Intent·form 상태 계약 재대조 | +| 39 | `P8-GATE` | `P8-R1`~`P8-R3` | 아니요 | 실패 소유 Task에 `P8-R*` 등록 | ```text P1-T1 → P1-T2 → P1-GATE @@ -1220,6 +1309,7 @@ P1-T1 → P1-T2 → P1-GATE → P4-T1 → P4-T2 → P4-T3 → P4-R2 → P4-GATE → P5-GATE → P6-T1 → P6-T2 → P6-GATE → P6-REVIEW → P6-R3 → P6-REVIEW → P7-T1 → P7-T2 → P7-R1 → P7-T3 → P7-T4 → P7-T5 → P7-GATE + → P8-R1 → P8-R2 → P8-R3 → P8-GATE ``` ## 변경 금지 항목 @@ -1529,6 +1619,8 @@ P1-T1 → P1-T2 → P1-GATE | `2026-10-02` | `PLAN-DEC-010` | 확정 | Phase 7은 기존 상세 Activity와 gift 계층을 확장해 받은 선물 상세·배송지 입력을 구현한다. 새 Activity·디자인 시스템·dependency는 만들지 않는다. | PRD `DEC-017`, `DEC-018` | `P7-T1`~`P7-GATE` | | `2026-10-02` | `PLAN-DEC-011` | 확정 | 배송지 입력 성공 후 상세 GET을 다시 조회하고 POST 응답만으로 완료 UI를 만들지 않는다. | PRD `DEC-019` | `P7-T3`, `P7-T5` | | `2026-10-02` | `PLAN-DEC-012` | 확정 | `선물 정책 확인`은 임의 URL 없이 handler만 둔다. 무동작 금지 정책이 확인되면 `준비 중입니다.` toast를 사용한다. | PRD `DEC-020` | `P7-T3`, `P7-T4` | +| `2026-10-06` | `PLAN-DEC-013` | 확정 | 상세 상단의 `hero_illustration`을 제거하고 상태 배지는 일반·전달 불가·취소 완료별 style model로 결정한다. | 승인된 PRD `DEC-021`, `DEC-022` | `P8-R1`, `P8-R2` | +| `2026-10-06` | `PLAN-DEC-014` | 확정 | 받은 사람 이용약관·개인정보 터치는 모두 지정된 Notion URL을 외부 브라우저로 연다. `선물 정책 확인` action은 변경하지 않는다. | 승인된 PRD `DEC-024` | `P8-R3` | ## 발견된 문제 @@ -1587,3 +1679,4 @@ P1-T1 → P1-T2 → P1-GATE - `2026-10-02` 종료 문서 후 fresh 검증: `./gradlew :app:testDebugUnitTest --rerun :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck :app:assembleDebug`는 `BUILD SUCCESSFUL in 1m 42s`, JUnit XML 188개에서 1,416 tests, failures/errors/skipped=0이었다. PRD·계획·Phase 6 리뷰의 미완료 체크 검색은 0건이고 `GIT_MASTER=1 git diff --check HEAD`는 무출력(exit 0)이었다. - `2026-10-02` P7-T5 완료: 성공 event의 Activity 연결 부재 RED를 확인한 뒤 기존 event 소비·Boolean 변경 marker·상세 재조회를 6줄로 연결했다. parent fresh focused 실행은 navigation 21개, detail 17개, recipient 8개, inbox 11개로 총 57개가 failures/errors/skipped=0이며 resource merge·Kotlin compile·ktlint도 성공했다. 명세·품질 리뷰는 모두 APPROVED이고 확정 finding은 없다. Phase 7은 `8/9`, 다음 Goal은 `P7-GATE`다. - `2026-10-02` P7-R4·P7-GATE 완료: 최종 리뷰의 visibility·View 순서 직접 assertion을 제거하고 AddressForm 헤더를 기존 `선물 받기` 문자열로 분기했다. 헤더 회귀 RED 후 navigation 21개 GREEN, Oracle 재검토에서 두 finding RESOLVED와 P7-R4 APPROVED를 확인했다. 수정 후 직렬 Gate는 gift/modal 180개와 전체 local unit 1,447개가 failures/errors/skipped=0이며 resource/compile/ktlint·assembleDebug 성공, 전체 diff check와 staging 확인은 무출력이다. Phase 7은 `10/10`, 남은 Goal과 blocker는 없다. +- `2026-10-06` Phase 8 계획 등록: 승인된 PRD와 Figma 대조 결과를 기준으로 `P8-R1` 상단 이미지 제거, `P8-R2` 상태별 배지 style, `P8-R3` 받은 사람 약관 외부 링크, `P8-GATE`를 추가했다. production/test/resource 코드는 아직 변경하지 않았고 RED/GREEN과 Gate는 미실행이다. diff --git a/docs/20261002_선물_상세와_운송장_등록/prd.md b/docs/20261002_선물_상세와_운송장_등록/prd.md index af18c73e..6df34a20 100644 --- a/docs/20261002_선물_상세와_운송장_등록/prd.md +++ b/docs/20261002_선물_상세와_운송장_등록/prd.md @@ -4,9 +4,9 @@ | 항목 | 내용 | |---|---| -| 문서 상태 | 기존 Phase 1~6 완료, Phase 7 받은 선물 상세·배송지 입력 문서 기준 확정 | +| 문서 상태 | 기존 Phase 1~7 완료, Phase 8 선물 UI 회귀 수정 기준 확정 | | 작성일 | `2026-10-02` | -| 최종 수정일 | `2026-10-02` | +| 최종 수정일 | `2026-10-06` | | 대상 제품 | Android 선물 상세·운송장 등록·신청 취소·받은 선물 배송지 입력 | | 작성자·결정권자 | 사용자 요청 및 인터뷰 기준 | | 관련 API Contract | 이 문서 11장 | @@ -63,6 +63,7 @@ Phase 7에서는 받는 크리에이터 관점(`direction=RECEIVED`)의 상세 - 신규 디자인 시스템, 신규 공통 dialog 또는 전역 event bus. - 상대방의 `recipientAddress` 노출. - 존재하지 않는 선물 리뷰 작성 또는 선물 정책 route 신규 구현. +- 선물 전용 이용약관·개인정보 화면 신규 구현. 이번 범위는 지정된 Notion URL 외부 브라우저 이동만 포함한다. - iOS 구현 또는 iOS 문서. Android 외 플랫폼 고려사항은 이번 문서 범위에서 제외한다. - `app/src/androidTest`, 기기·에뮬레이터 조작, 스크린샷·시각 QA. @@ -270,6 +271,14 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배, | `GIFT-DATE-001` | 확정 | 선물 상세 페이지의 모든 상세 필드 날짜는 UTC ISO를 기기 timezone 기준 `yyyy.MM.dd`로 표시한다. | 보낸 것과 받은 것 모두 timezone 경계 test가 통과한다. | `P7-T1`, `P7-T2` | | `GIFT-DATE-002` | 확정 | 날짜 값이 null이거나 파싱 실패하면 해당 row를 숨긴다. | 현재 날짜나 `-`로 대체하지 않는다. | `P7-T2` | +### 8.12 Phase 8 상태 배지·상단 이미지·약관 터치 회귀 수정 + +| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 | +|---|---|---|---|---| +| `GIFT-UI-DEBUG-001` | 확정 | 신청 상세 상단에 Figma에 없는 선물 이미지를 표시하지 않는다. | 모든 상세 상태에서 `hero_illustration`이 렌더링되지 않는다. | `P8-R1` | +| `GIFT-UI-DEBUG-002` | 확정 | 상태 배지는 Figma의 상태별 배경·전경 조합을 사용한다. | 일반 진행 상태는 흰 배경·검은 글자, `UNDELIVERABLE`은 빨간 배경·검은 글자, `CANCELED`는 회색 배경·흰 글자이며 chip이 없는 상태는 숨긴다. | `P8-R2` | +| `GIFT-UI-DEBUG-003` | 정정 | 받은 사람 배송지 입력의 이용약관과 개인정보 `(필수)` 터치 처리를 전용 함수로 분리한다. | 두 함수 모두 `ACTION_VIEW`로 `https://app.notion.com/p/3eb27b359673802b937ae741ab7b4ad3`을 열고 체크 상태·CTA 계산을 유지한다. | `P8-R3` | + ## 9. UI/UX Expectations ### 9.1 Figma 기준 @@ -303,6 +312,8 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배, - 정보 카드는 단일 multiline 문자열이 아니라 Figma의 고정 label 폭과 개별 value를 가진 행 구조로 표시한다. - Figma에만 있고 앱 route가 없는 리뷰·선물 정책 action은 이번 UI 재구현에서도 추가하지 않는다. - 받은 선물 전달 불가의 `선물 정책 확인`은 요구사항상 버튼/action handler만 만들고 임의 URL을 연결하지 않는다. 기존 앱 정책상 무동작 handler가 금지되면 `준비 중입니다.` toast를 사용한다. +- 신청 상세 상단에는 선물 이미지를 표시하지 않는다. +- 상태 배지는 일반 진행·전달 불가·취소 완료를 서로 다른 배경·전경 조합으로 표시한다. ### 9.3 취소 dialog 문구 @@ -482,6 +493,14 @@ Figma/layout 증거는 소스와 리소스 대조에 한정한다. 화면 표현 Phase 7 구현 Task와 Task별 focused 검증은 완료했다. 상세 재조회·목록 갱신까지 명세·품질 리뷰에서 승인됐으며, 전체 local unit·assemble을 포함한 최종 완료 판정은 `P7-GATE` 실행 후 기록한다. +### 14.6 Phase 8 선물 UI 회귀 수정 + +- [ ] 상세 상단의 Figma에 없는 선물 이미지가 제거된다. +- [ ] 일반 진행·전달 불가·취소 완료 배지가 각각 확정된 스타일로 표시된다. +- [ ] chip이 없는 상태는 빈 배지 영역을 남기지 않는다. +- [ ] 받은 사람 약관 2개의 `(필수)` 터치 함수가 분리되고 모두 지정된 Notion URL을 열며 기존 체크·CTA 동작이 유지된다. +- [ ] 선물함 리스트의 받는 사람/보내는 사람 카드와 배송지 미입력 배너는 Figma 대조 결과 기존 구현을 유지한다. + ## 15. Open Questions 현재 구현을 차단하는 미결 질문은 없다. API 계약 변경 또는 gift 리뷰/정책 route가 추가되면 이 문서의 Decision Log와 계획 범위를 먼저 갱신한다. @@ -504,6 +523,7 @@ Phase 7 구현 Task와 Task별 focused 검증은 완료했다. 상세 재조회 | ASCII 운송장 입력·오류·제출 차단 | 6 (`P6-T2`) | `GiftTrackingPresenterTest`, `GiftTrackingViewModelTest`, native input XML | | Phase 6 통합 품질·리뷰 | 6 (`P6-GATE`, `P6-R3`, `P6-REVIEW`) | gift/modal 149개, 전체 1,416개, resource/compile/ktlint/assemble, 5개 review 영역 PASS | | 받은 선물 상세·배송지 입력 | 7 (`P7-T1`~`P7-GATE`) | 예정: `GiftDetailPresenterTest`, `GiftRecipientAddressViewModelTest`, `GiftNavigationTest`, resource/compile/ktlint | +| 상태 배지·상단 이미지·약관 함수 회귀 수정 | 8 (`P8-R1`~`P8-GATE`) | 예정: `GiftDetailPresenterTest`, `GiftNavigationTest`, Figma·source 대조, resource/compile/ktlint/assemble | ## 17. Decision Log @@ -529,6 +549,10 @@ Phase 7 구현 Task와 Task별 focused 검증은 완료했다. 상세 재조회 | `2026-10-02` | `DEC-018` | 확정 | 받은 선물 상세·배송지 입력은 기존 `GiftDetailActivity`, gift API 계층, Kakao 우편번호 Activity, 카카오 채널 문의 패턴을 확장해 구현한다. 신규 디자인 시스템은 만들지 않는다. | 저장소 패턴 조사와 사용자 전제 | `P7-T1`~`P7-T5` | | `2026-10-02` | `DEC-019` | 확정 | 배송지 입력 성공 후 POST 응답으로 화면을 완성하지 않고 상세 GET을 다시 조회한다. | 사용자 요구와 서버 상태 source of truth | `P7-T3`, `P7-T5` | | `2026-10-02` | `DEC-020` | 확정 | 받은 선물 전달 불가의 `선물 정책 확인`은 임의 URL을 열지 않는다. 무동작이 정책상 금지되면 `준비 중입니다.` toast만 표시한다. | 사용자 명시 조건 | `GIFT-RECEIVED-ACTION-002`, `P7-T4` | +| `2026-10-06` | `DEC-021` | 확정 | 상세 상단의 선물 이미지는 Figma에 없으므로 모든 상태에서 제거한다. | 제공된 Figma 상세 5개 노드와 현행 XML·binding 대조 | `GIFT-UI-DEBUG-001`, `P8-R1` | +| `2026-10-06` | `DEC-022` | 확정 | 상태 배지는 일반 진행 흰색, 전달 불가 빨간색, 취소 완료 회색 스타일로 분리하고 chip이 없는 상태는 숨긴다. | 제공된 Figma 상세 노드와 승인된 설계 | `GIFT-UI-DEBUG-002`, `P8-R2` | +| `2026-10-06` | `DEC-023` | 확정 | 받은 사람 약관은 실제 route 없이 이용약관·개인정보 터치 함수만 분리한다. | 사용자 선택 “함수만 분리” | `GIFT-UI-DEBUG-003`, `P8-R3` | +| `2026-10-06` | `DEC-024` | 정정 | `DEC-023`을 대체하고 받은 사람의 이용약관·개인정보 터치 시 모두 지정된 Notion URL을 외부 브라우저로 연다. | 사용자 제공 URL과 후속 명시 요청 | `GIFT-UI-DEBUG-003`, `P8-R3` | ## 18. 변경 관리