From 28647ec606e0a44cc0e782aafddf627ba43a924b Mon Sep 17 00:00:00 2001 From: klaus Date: Thu, 8 Oct 2026 21:04:25 +0900 Subject: [PATCH] =?UTF-8?q?docs(gift):=20=EC=A0=84=EB=8B=AC=20=EB=B6=88?= =?UTF-8?q?=EA=B0=80=20=EC=95=88=EB=82=B4=20=EC=83=89=EC=83=81=20=EA=B2=80?= =?UTF-8?q?=EC=A6=9D=EC=9D=84=20=EA=B8=B0=EB=A1=9D=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../plan-task.md | 66 ++++++++++++++++++- docs/20261002_선물_상세와_운송장_등록/prd.md | 7 ++ 2 files changed, 72 insertions(+), 1 deletion(-) diff --git a/docs/20261002_선물_상세와_운송장_등록/plan-task.md b/docs/20261002_선물_상세와_운송장_등록/plan-task.md index 1622bf6b..fdcc820e 100644 --- a/docs/20261002_선물_상세와_운송장_등록/plan-task.md +++ b/docs/20261002_선물_상세와_운송장_등록/plan-task.md @@ -33,7 +33,7 @@ | 9 | 완료 | `6/6` | 완료 | 없음 | | 10 | 완료 | `2/2` | 완료 | 없음 | | 11 | 완료 | `1/1` | 완료 | 없음 | -| 12 | 완료 | `4/4` | 완료 | 없음 | +| 12 | 완료 | `5/5` (`P12-R2` 추가, 이전 `4/4` 완료 이력 유지) | 완료 | 없음 | `P5-D2`에서 최종 직렬 Gate와 재검토 증거에 따라 상태를 정리했다. 아래의 진행 중·대기·실패 기록은 각 실행 당시의 이력이며, 최신 판정은 현재 상태 표와 마지막 Verification Log를 기준으로 한다. 기존 완료 Task와 당시 검증 기록은 보존한다. @@ -1599,6 +1599,36 @@ GIT_MASTER=1 git diff --check HEAD **P12-GATE 최종 재시도 (`2026-10-08`):** `P12-T2` GREEN 후 Gate를 첫 명령부터 직렬 실행했다. gift local unit suite는 `BUILD SUCCESSFUL in 1m 39s`, JUnit XML 기준 210개 tests와 failures/errors/skipped=0이다. resource merge·Kotlin compile·ktlint는 `BUILD SUCCESSFUL in 17s`, debug assemble은 `BUILD SUCCESSFUL in 2m 9s`로 종료했다. source 대조에서 정책 버튼은 기존 `openGiftAgreementPage()`를 호출하고 obsolete 상세 ViewModel 정책 toast 경로는 없으며 문의·주소·API·레이아웃·정책 외 action은 변경되지 않았다. 기존 `.editorconfig`의 `disabled_rules` deprecation 경고는 남아 있으나 Gate 실패는 아니다. 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 저장소 규칙에 따라 실행하지 않았다. +### P12-R2: 공유 전달 불가 안내 글자색 후속 정정 + +- **요구사항·승인:** `GIFT-UNDELIVERABLE-COLOR-001`, `DEC-035` (`2026-10-08`). 기존 Phase 12의 색상 무변경·범위 밖 결정은 당시 이력으로 보존하고, 이번 승인에서 공유 안내 글자색에 한해 대체한다. 현재 요약은 `4/5` 차단 상태로 갱신했으며, 전체 검증이 성공한 뒤에만 `5/5` 완료 상태로 전환한다. +- **대상 파일:** `app/src/main/res/layout/activity_gift_detail.xml`. +- **수정 범위:** `undeliverable_guidance`의 `android:textColor` 한 줄만 `@color/gray_400`에서 기존 `@color/red_400` (`#FF4C3C`)으로 변경한다. +- **범위 밖:** 문구·Kotlin·API·navigation·visibility·간격·constraint·action 변경, 신규 token·style·dependency, 레거시 변경. +- **TDD 예외 및 대체 검증:** 저장소 정책에 따라 View 크기·간격·constraint·visibility·color 속성을 직접 검증하는 테스트를 추가하지 않는다. 승인된 색상 변경은 source 대조·resource merge·Kotlin compile·ktlint·assemble 및 기존 관련 local unit test로 검증한다. 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 실행하지 않는다. +- **사전 검증 (`2026-10-08`, 상위 작업자에게 전달받은 실행 증거):** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest"` → `BUILD SUCCESSFUL in 4m 28s`. +- [x] XML 수정 전에 기존 PRD에 요구사항·결정을 추가하고 이 회귀 Task를 등록한다. +- [x] 공통 안내의 기존 색상 참조 한 줄만 변경하고 ID가 중복 정의되지 않았는지 source로 확인한다. +- [x] 아래 회귀 검증을 순서대로 실행하고 실제 완료 증거를 누적한다. +- [x] 검증 성공 후 Phase 12 요약을 `5/5`로 갱신하고 Verification Log에 결과를 추가한다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun +./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck +./gradlew :app:assembleDebug +GIT_MASTER=1 git diff --check HEAD +``` + +**Task 검증 기록 (`2026-10-08`):** source 검색에서 `undeliverable_guidance` ID 정의는 `activity_gift_detail.xml:179` 한 곳이며 글자색은 `@color/red_400`이다. 기존 token 값은 `#FF4C3C`이고 production diff는 이 색상 참조 한 줄뿐이다. navigation focused 검증은 `BUILD SUCCESSFUL in 1m 13s`, JUnit XML 기준 44 tests, failures/errors/skipped=0이다. resource merge·Kotlin compile은 통과했지만 통합 명령은 `:app:ktlintTestSourceSetCheck`에서 `BUILD FAILED in 1m 22s`로 종료했다. 이어서 assemble은 `BUILD SUCCESSFUL in 51s`, diff check는 출력 없음(exit 0)이었다. + +**당시 차단 증거:** 위 통합 명령 실행에서는 변경 전 clean worktree에 있던 `app/src/test/java/kr/co/vividnext/sodalive/v2/creator/channel/fantalk/CreatorChannelFanTalkFragmentLayoutTest.kt`의 85·88·89·223행에 `max-line-length` 4건과 `argument-list-wrapping` 16건이 보고됐다. 이 파일은 수정 허용 범위 밖이므로 변경하지 않았다. + +**최신 최종 검증 (`2026-10-08`, 상위 작업자에게 전달받은 실행 증거):** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" :app:mergeDebugResources :app:compileDebugKotlin :app:assembleDebug`는 `BUILD SUCCESSFUL in 4s`, `56 actionable tasks: 56 up-to-date`였다. 이어서 실행한 `./gradlew :app:ktlintCheck`는 `BUILD FAILED in 1s`로 종료했으며 `:app:ktlintTestSourceSetCheck`와 `:app:ktlintMainSourceSetCheck`가 모두 실패했다. test report는 변경하지 않은 `CreatorChannelFanTalkFragmentLayoutTest.kt`의 기존 위반 20건, main report는 변경하지 않은 레거시 소스 전반의 기존 위반 195건이며 package-name 규칙 위반이 주를 이루고 기존 wrapping·whitespace 문제도 포함한다. + +**현재 차단 및 완료 판정:** 구현과 focused/resource/compile/build 검증은 완료했지만 변경하지 않은 범위 밖 main/test 파일의 위반으로 전체 ktlint Gate가 차단됐다. `P12-R2` 완료 및 Phase 12 `5/5` 판정은 보류하고 현재 요약은 `4/5` 차단을 유지한다. 이전 완료·리뷰·검증 기록은 보존한다. + +**최종 재검증 및 완료 (`2026-10-08`):** focused test·resource merge·Kotlin compile·debug assemble 통합 명령은 `BUILD SUCCESSFUL in 1m 58s`였고, 이어서 실행한 `./gradlew :app:ktlintCheck`도 `BUILD SUCCESSFUL in 2s`로 통과했다. `GIT_MASTER=1 git diff --check HEAD`는 출력 없이 exit 0이었다. 이전 실패 기록은 당시 이력으로 보존하며, 최신 Gate 성공에 따라 `P12-R2`와 Phase 12를 `5/5` 완료로 전환한다. + ## 실행 순서와 의존성 | 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 | @@ -2054,3 +2084,37 @@ P1-T1 → P1-T2 → P1-GATE - `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는 미실행이다. + +### 2026-10-08 P12-R2 후속 색상 검증 + +PRD 요구사항 `GIFT-UNDELIVERABLE-COLOR-001`·결정 `DEC-035`와 회귀 Task를 먼저 등록한 뒤 공통 안내의 기존 색상 참조 한 줄만 변경했다. source 검색에서 ID 정의는 한 곳이며 `red_400` (`#FF4C3C`)을 참조한다. 신규 색상·style·테스트 및 동작 변경은 없다. + +| 실행 명령 | 실제 결과 | +|---|---| +| `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest"` | 변경 전 상위 작업자 전달 증거: `BUILD SUCCESSFUL in 4m 28s` | +| `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun` | `BUILD SUCCESSFUL in 1m 13s`, 44 tests, failures/errors/skipped=0 | +| `./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck` | resource/compile 통과, `:app:ktlintTestSourceSetCheck` 실패, `BUILD FAILED in 1m 22s` | +| `./gradlew :app:assembleDebug` | `BUILD SUCCESSFUL in 51s` | +| `GIT_MASTER=1 git diff --check HEAD` | 출력 없음, exit 0 | + +**최신 최종 검증 (`2026-10-08`, 상위 작업자에게 전달받은 실행 증거):** 위 통합 명령의 test source set 실패와 FanTalk 위반 20건은 당시 이력으로 보존하며, 이후 실행 결과를 아래에 추가한다. + +| 실행 명령 | 실제 결과 | +|---|---| +| `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" :app:mergeDebugResources :app:compileDebugKotlin :app:assembleDebug` | `BUILD SUCCESSFUL in 4s`, `56 actionable tasks: 56 up-to-date` | +| `./gradlew :app:ktlintCheck` | `BUILD FAILED in 1s`, `:app:ktlintTestSourceSetCheck`와 `:app:ktlintMainSourceSetCheck` 모두 실패 | + +- 차단: test report에는 변경하지 않은 `CreatorChannelFanTalkFragmentLayoutTest.kt`의 기존 위반 20건, main report에는 변경하지 않은 레거시 소스 전반의 기존 위반 195건이 있다. main 위반은 package-name 규칙이 주를 이루며 기존 wrapping·whitespace 문제도 포함한다. 변경하지 않은 범위 밖 main/test 파일로 전체 ktlint Gate가 차단되어 `P12-R2` 최종 완료는 보류하며, Phase 12는 이전 완료 4건을 유지한 `4/5`다. +- 기존 설정·의존성 경고: `.editorconfig`의 `disabled_rules` deprecation, Gradle 9.0 비호환 deprecated features, Agora 등 native library debug symbol strip 불가에 따른 원본 packaging 경고가 있었다. 관련 설정·의존성은 변경하지 않았다. +- 기기·에뮬레이터·androidTest·스크린샷·시각 QA와 View 색상 직접 테스트는 실행하거나 추가하지 않았다. LSP 진단 도구는 제공되지 않아 source/resource/compile 검증으로 확인했다. 커밋하지 않았다. + +### 2026-10-08 P12-R2 최종 재검증 및 완료 + +| 실행 명령 | 실제 결과 | +|---|---| +| `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" :app:mergeDebugResources :app:compileDebugKotlin :app:assembleDebug` | `BUILD SUCCESSFUL in 1m 58s`, `56 actionable tasks: 17 executed, 39 up-to-date` | +| `./gradlew :app:ktlintCheck` | `BUILD SUCCESSFUL in 2s`, `7 actionable tasks: 7 up-to-date` | +| `GIT_MASTER=1 git diff --check HEAD` | 출력 없음, exit 0 | + +- 이전 ktlint 실패와 차단 판정은 당시 이력으로 보존한다. 최신 직렬 재검증이 모두 성공해 `P12-R2`와 Phase 12를 `5/5` 완료로 전환했다. +- 기기·에뮬레이터·androidTest·스크린샷·시각 QA와 View 색상 직접 테스트는 저장소 규칙에 따라 실행하거나 추가하지 않았다. diff --git a/docs/20261002_선물_상세와_운송장_등록/prd.md b/docs/20261002_선물_상세와_운송장_등록/prd.md index a5010986..a23ef6f6 100644 --- a/docs/20261002_선물_상세와_운송장_등록/prd.md +++ b/docs/20261002_선물_상세와_운송장_등록/prd.md @@ -323,6 +323,12 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배, | `GIFT-UNDELIVERABLE-COPY-001` | 확정 | `SENT`와 `RECEIVED`의 전달 불가 사유 아래 공유 안내 문구를 아래 공통 안내로 교체한다. | 기존 공유 `Key.DISPOSAL_NON_RETURN_GUIDANCE`를 재사용하며 두 방향 모두 동일한 locale 문구를 사용한다. 기존 레이아웃 색상은 문구 변경 범위 밖이며 변경하지 않는다. | `P12-T1` | | `GIFT-UNDELIVERABLE-COPY-002` | 확정 | 서버 `delivery.undeliverableReason`은 번역하거나 가공하지 않는다. | 값이 있으면 `GiftDetailText.Raw`로 원문을 보존하고 null 사유의 기존 fallback은 유지한다. | `P12-T1` | +**승인된 후속 색상 정정 (`2026-10-08`, `DEC-035`):** 위 색상 무변경·범위 밖 문장은 `P12-T1` 당시 이력으로 보존한다. 이후 승인된 `P12-R2`에서는 공유 전달 불가 안내의 글자색에 한해 이 결정을 대체한다. + +| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 | +|---|---|---|---|---| +| `GIFT-UNDELIVERABLE-COLOR-001` | 확정 | `SENT`와 `RECEIVED`가 공유하는 `undeliverable_guidance`를 기존 `red_400`으로 표시한다. | `activity_gift_detail.xml`의 해당 `android:textColor`만 `@color/red_400` (`#FF4C3C`)으로 변경한다. 문구·레이아웃·visibility·action은 유지하고 신규 색상·style은 만들지 않는다. | `P12-R2` | + **승인된 hero 문구:** 한국어는 Figma 원문이며 `시일내로`의 붙여쓰기를 유지한다. EN/JA는 승인된 자연스러운 번역을 그대로 사용한다. | status | locale | title | body | @@ -664,6 +670,7 @@ Phase 7 구현 Task와 Task별 focused 검증은 완료했다. 상세 재조회 | `2026-10-08` | `DEC-032` | 확정 | Receive 입력 form에는 신규 input 전용 resource를 사용하고, 기존 `gift_detail_recipient_address`는 입력 완료·배송 완료 주소 title로 유지해 세 locale 값을 각각 분리한다. | 사용자 권장안 승인 | `GIFT-I18N-004`, `GIFT-I18N-005`, `P11-T1` | | `2026-10-08` | `DEC-033` | 확정 | RECEIVED의 세 진행 상태 hero title/body를 상태별 key로 최소 분리하고 양방향 전달 불가 안내는 기존 공유 key로 교체한다. KO Figma 원문과 승인된 EN/JA 번역을 사용하며 서버 사유는 Raw로 보존한다. 이전 문구만 8.16으로 대체하고 기존 완료·검증 이력은 유지한다. | 사용자 문구·자연스러운 번역·최소 매핑 방식 승인 | `GIFT-RECEIVED-COPY-001`, `GIFT-UNDELIVERABLE-COPY-001`, `GIFT-UNDELIVERABLE-COPY-002`, `P12-T1`, `P12-GATE` | | `2026-10-08` | `DEC-034` | 정정 | `DEC-020`의 준비 중 toast 결정을 대체하고 받은 선물 전달 불가의 `선물 정책 확인`을 지정된 Notion URL의 외부 브라우저 이동으로 연결한다. 기존 `openGiftAgreementPage()`를 재사용하며 신규 route·WebView·dependency는 만들지 않는다. | 사용자 제공 URL과 후속 구현 요청 | `GIFT-RECEIVED-ACTION-002`, `P12-T2`, `P12-GATE` | +| `2026-10-08` | `DEC-035` | 정정 | 공유 전달 불가 안내의 색상 무변경 결정을 후속 승인으로 대체한다. 기존 `red_400` (`#FF4C3C`)을 재사용하며 신규 token·style 없이 해당 글자색 한 줄만 변경한다. 이전 완료·검증 이력은 보존한다. | 사용자 빨간색 표시 요청과 기존 색상 token 확인 | `GIFT-UNDELIVERABLE-COLOR-001`, `P12-R2` | ## 18. 변경 관리