diff --git a/docs/20261002_선물_상세와_운송장_등록/plan-task.md b/docs/20261002_선물_상세와_운송장_등록/plan-task.md index d4aa62cb..40376c64 100644 --- a/docs/20261002_선물_상세와_운송장_등록/plan-task.md +++ b/docs/20261002_선물_상세와_운송장_등록/plan-task.md @@ -30,6 +30,7 @@ | 6 | 완료 | `7/7` | 완료 | 없음 | | 7 | 완료 | `10/10` | 완료 | 없음 | | 8 | 계획 완료 | `0/4` | `P8-R1` | 없음 | +| 9 | 완료 | `6/6` | 완료 | 없음 | `P5-D2`에서 최종 직렬 Gate와 재검토 증거에 따라 상태를 정리했다. 아래의 진행 중·대기·실패 기록은 각 실행 당시의 이력이며, 최신 판정은 현재 상태 표와 마지막 Verification Log를 기준으로 한다. 기존 완료 Task와 당시 검증 기록은 보존한다. @@ -1258,6 +1259,112 @@ GIT_MASTER=1 git diff --check HEAD GIT_MASTER=1 git diff --check HEAD ``` +## Phase 9: 선물 상세 딥링크와 한국어 브랜드명 + +**Phase 결과:** `${URISCHEME}://gift-detail/{applicationNo}`를 foreground와 cold start에서 동일하게 선물 상세로 라우팅하고 한국어 선물 문자열의 브랜드명만 `소다라이브`로 표시한다. + +**선행조건:** 승인된 PRD `DEC-025`~`DEC-028`, 사용자 레거시 수정 예외 승인. + +**Phase 완료 조건:** `P9-T1`~`P9-T3`, `P9-R1`, `P9-R2`, `P9-GATE` 완료, PRD와 Verification Log 갱신. + +### Task 9.1 선물 상세 딥링크 인식 + +**Goal 실행 `P9-T1`:** 중앙 `DeepLinkActivity`가 `${URISCHEME}://gift-detail/{applicationNo}`를 문자열 신청번호로 인식한다. + +**Files:** + +- Modify: `app/src/main/AndroidManifest.xml` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/MainV2Activity.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` + +- [x] **RED:** manifest가 `${URISCHEME}`의 `gift-detail` host를 수신하는지 검증한다. +- [x] **RED:** applicationNo가 없거나 blank면 상세를 열지 않는 test를 추가한다. +- [x] **RED 확인:** host/route 부재로 실패함을 기록한다. +- [x] **GREEN:** 기존 URI parse와 bundle key 전달 방식을 최소 확장한다. +- [x] **REFACTOR:** 신규 gift 전용 Activity, 숫자 변환, URI 재작성, production scheme 분기를 추가하지 않는다. + +### Task 9.2 foreground·cold start 상세 라우팅 + +**Goal 실행 `P9-T2`:** 동일 신청번호를 foreground에서는 직접, cold start에서는 `SplashActivity → MainV2Activity`를 거쳐 한 번만 `GiftDetailActivity`로 전달한다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/MainV2Activity.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` + +- [x] **RED:** foreground deep link가 문자열 신청번호를 보존해 `GiftDetailActivity.newIntent`로 전달하는 test를 추가한다. +- [x] **RED:** cold start가 동일 신청번호를 Splash/Main 전달 후 한 번만 상세로 여는 test를 추가한다. +- [x] **RED 확인:** 상세 route 부재로 실패함을 기록한다. +- [x] **GREEN:** 기존 중앙 딥링크 경로와 `GiftDetailActivity.newIntent`를 재사용한다. +- [x] **REFACTOR:** foreground와 cold start의 bundle key·blank 처리 계약을 일치시킨다. + +### Task 9.3 한국어 브랜드명 교체 + +**Goal 실행 `P9-T3`:** 한국어 선물 문자열 3개의 `SODALIVE`만 `소다라이브`로 변경하고 영문·일문은 유지한다. + +**Files:** + +- Modify: `app/src/main/res/values/strings.xml` +- Verify only: `app/src/main/res/values-en/strings.xml` +- Verify only: `app/src/main/res/values-ja/strings.xml` + +- [x] `gift_tracking_guidance`, `gift_detail_undeliverable_body`, `gift_detail_mailbox`의 기본 resource만 변경한다. +- [x] en/ja resource의 `SODALIVE` 유지 여부를 확인한다. +- [x] resource merge로 문자열 문법과 placeholder 회귀가 없음을 검증한다. + +### Task 9.4 통합 Gate + +**Goal 실행 `P9-GATE`:** Phase 9와 기존 딥링크·선물 상세 흐름을 직렬 검증한다. + +- [x] `GiftNavigationTest` focused test를 실행한다. +- [x] 전체 gift local unit test와 전체 local unit test를 실행한다. +- [x] resource merge, Kotlin compile, ktlint, debug assemble을 실행한다. +- [x] `GIT_MASTER=1 git diff --check HEAD`를 실행한다. +- [x] 실제 결과를 각 Task와 문서 하단 Verification Log에 기록한다. +- [x] 코드 리뷰 finding을 `P9-R1`, `P9-R2`로 등록하고 수정·검증한다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --rerun +./gradlew :app:testDebugUnitTest --rerun +./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck +./gradlew :app:assembleDebug +GIT_MASTER=1 git diff --check HEAD +``` + +### Task 9.R1 blank 원본 신청번호 경로 거부 + +**Goal 실행 `P9-R1`:** `REV-P9-001`에 따라 gift 딥링크는 필터링 전 첫 신청번호 segment가 blank이면 뒤 segment로 대체하지 않고 거부한다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/MainV2Activity.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` + +- [x] **RED:** `gift-detail/%20/A-1002609300001`이 foreground와 cold-start parser 모두 상세를 열지 않는 test를 추가한다. +- [x] **RED 확인:** 뒤 segment가 신청번호로 승격되어 실패함을 기록한다. +- [x] **GREEN:** gift 경로에서만 필터링 전 첫 path segment를 사용하고 blank를 거부한다. +- [x] **GREEN 확인:** `GiftNavigationTest` PASS를 기록한다. +- [x] **REFACTOR:** 기존 다른 host의 path parsing 계약은 변경하지 않는다. + +### Task 9.R2 cold-start 딥링크 재소비 방지 + +**Goal 실행 `P9-R2`:** `REV-P9-002`에 따라 처리한 gift 딥링크는 동일 Main Activity 재생성에서 다시 상세를 열지 않는다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/MainV2Activity.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` + +- [x] **RED:** gift route 처리 후 동일 진입 Intent를 다시 처리하거나 Main을 재생성해도 상세 시작이 추가되지 않는 test를 추가한다. +- [x] **RED 확인:** 원래 `EXTRA_DATA`가 남아 재실행되는 실패를 기록한다. +- [x] **GREEN:** 성공적으로 소비한 gift route의 전달 data를 최소 범위에서 제거한다. +- [x] **GREEN 확인:** focused test PASS와 일반 딥링크 회귀 없음을 기록한다. +- [x] **REFACTOR:** 전체 중앙 라우터의 기존 route 소비 정책은 변경하지 않는다. + ## 실행 순서와 의존성 | 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 | @@ -1301,6 +1408,12 @@ GIT_MASTER=1 git diff --check HEAD | 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*` 등록 | +| 40 | `P9-T1` | 승인된 PRD `DEC-025`~`DEC-027` | 아니요 | 중앙 딥링크 parse·bundle 계약 재대조 | +| 41 | `P9-T2` | `P9-T1` | 아니요 | foreground·cold start 상세 route 재대조 | +| 42 | `P9-T3` | 승인된 PRD `DEC-028` | `P9-T2` test와 파일 비중복 시 가능 | locale별 resource 범위 재대조 | +| 43 | `P9-R1` | `P9-T1`, `REV-P9-001` | 아니요 | 원본 path segment 계약 재대조 | +| 44 | `P9-R2` | `P9-T2`, `REV-P9-002` | 아니요 | 소비된 Intent 재처리 여부 재대조 | +| 45 | `P9-GATE` | `P9-T1`~`P9-T3`, `P9-R1`, `P9-R2` | 아니요 | 실패 소유 Task에 `P9-R*` 등록 | ```text P1-T1 → P1-T2 → P1-GATE @@ -1310,6 +1423,7 @@ P1-T1 → P1-T2 → P1-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 + → P9-T1 → P9-T2 → P9-T3 → P9-R1 → P9-R2 → P9-GATE ``` ## 변경 금지 항목 @@ -1323,6 +1437,7 @@ P1-T1 → P1-T2 → P1-GATE - 기존 `V2ModalDialog` 호출의 기본 자동 닫힘을 변경하지 않는다. - 레거시 파일을 직접 수정하지 않는다. - **승인된 예외 `PLAN-DEC-005`:** `P5-R2`에서만 레거시 `AppDI.kt`의 named Gift client/Retrofit 추가와 `GiftApi` 연결 변경을 허용한다. 공유 debug BODY/release NONE과 다른 API 설정은 유지한다. +- **승인된 예외 `DEC-025`:** `P9-T1`에서만 중앙 딥링크 라우팅을 위해 레거시 `DeepLinkActivity.kt`와 `MainV2Activity.kt`의 기존 경로를 최소 수정한다. - test를 삭제·skip·완화하거나 타입 오류를 우회하지 않는다. - token·실제 주소·전화번호를 log·fixture·문서에 기록하지 않는다. @@ -1638,6 +1753,8 @@ P1-T1 → P1-T2 → P1-GATE ## Verification Log +- 2026-10-08: Phase 9 RED에서 gift route/manifest 부재를 확인하고 foreground·cold-start real Robolectric test로 GREEN을 확인했다. Oracle 리뷰의 `REV-P9-001`은 blank 첫 segment 뒤 신청번호 승격 실패, `REV-P9-002`는 동일 entry Intent 재소비 실패로 각각 재현한 뒤 `P9-R1`, `P9-R2` 최소 수정으로 해결했다. 최종 `GiftNavigationTest`는 `BUILD SUCCESSFUL in 1m 25s`, gift package는 `BUILD SUCCESSFUL in 1m 34s`, 전체 local unit suite는 `BUILD SUCCESSFUL in 2m 23s`였다. `mergeDebugResources`·`compileDebugKotlin`은 `BUILD SUCCESSFUL in 3s`, `assembleDebug`는 `BUILD SUCCESSFUL in 8s`, `GIT_MASTER=1 git diff --check HEAD`는 무출력 통과했다. `ktlintCheck`는 이번 변경 외 기존 `audio_content` 등 레거시 위반으로 실패했으며 변경 파일 위반은 보고되지 않았다. 기기·에뮬레이터·androidTest·시각 QA는 저장소 규칙에 따라 실행하지 않았다. + 아래 기록은 각 실행 당시의 상태를 보존한다. 최신 종료 판정은 이 절 마지막의 최종 증거를 기준으로 한다. - `2026-10-02` context 재검토 등록: 아래 과거 이력은 보존한다. 최신 전달 결과는 goal PASS, QA PASS(privacy/repository 7개, lifecycle 38개, gift/modal 141개, 각 XML failures/errors/skipped=0), quality PASS다. quality의 `callFactory` assertion 보강은 선택적 비차단 의견이다. security lane은 team-mode 규칙을 이유로 검토를 거절해 INCONCLUSIVE이며 새 취약점 판정이 아니다. context는 일반 상세 무변경 recreate 음성 테스트와 build guide 실행 예시 누락 두 건으로 FAIL이다. 전자는 `REV-P5-004`/`P5-R4`, 후자는 `REV-P5-003`/`P5-D2`에 등록했다. diff --git a/docs/20261002_선물_상세와_운송장_등록/reviews/phase9-gift-detail-deeplink-brand-review.md b/docs/20261002_선물_상세와_운송장_등록/reviews/phase9-gift-detail-deeplink-brand-review.md new file mode 100644 index 00000000..942b8a34 --- /dev/null +++ b/docs/20261002_선물_상세와_운송장_등록/reviews/phase9-gift-detail-deeplink-brand-review.md @@ -0,0 +1,61 @@ +# Phase 9 선물 상세 딥링크·브랜드 리뷰 + +## 1. 리뷰 정보 + +| 항목 | 내용 | +|---|---| +| 리뷰 대상 | Phase 9 / `P9-T1`~`P9-GATE` | +| 기준 commit 또는 working tree | `1b3206fe` 이후 working tree | +| 리뷰 일자 | `2026-10-08` | +| 리뷰어 | Oracle, Sisyphus | +| 기준 문서 | `prd.md`, `plan-task.md` Phase 9 | +| 리뷰 상태 | 수정 검증 완료 | + +## 2. 리뷰 목적과 범위 + +- foreground/cold-start 딥링크, 문자열 신청번호, blank 거부, 한 번만 실행, 한국어 resource 범위를 검토한다. +- 사용자 소유 asset·기존 layout 변경과 기기·에뮬레이터 시각 QA는 제외한다. + +## 3. 검토한 근거 + +- 코드: `AndroidManifest.xml`, `DeepLinkActivity.kt`, `MainV2Activity.kt`, `strings.xml`. +- 테스트: `GiftNavigationTest`의 foreground/cold-start/blank route test. +- 실행 증거: focused test PASS, gift package 재실행 PASS, 전체 local unit PASS, merge/compile/assemble PASS, diff-check PASS. ktlint는 변경 외 레거시 위반으로 실패. + +## 4. 발견 사항 요약 + +| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal | +|---|---|---|---|---|---| +| `REV-P9-001` | Medium | 수정 완료 | blank 첫 segment가 뒤 segment로 대체됨 | `P9-R1` | 원본 첫 segment blank 거부 | +| `REV-P9-002` | Medium | 수정 완료 | 소비한 cold-start gift route가 Main 재생성에서 다시 실행될 수 있음 | `P9-R2` | 소비 data 제거와 재처리 test | + +## 5. 발견 사항 상세 + +### REV-P9-001 — blank 첫 segment 대체 + +- **관찰:** 공통 parser가 blank segment를 먼저 제거해 `gift-detail/%20/A-1002609300001`의 두 번째 segment를 신청번호로 사용한다. +- **영향:** blank 신청번호 거부 계약 위반. +- **권장 조치:** gift host에서만 필터링 전 첫 segment를 검사하고 foreground/cold-start 회귀 test를 추가한다. + +### REV-P9-002 — cold-start route 재소비 + +- **관찰:** 상세 실행 후 원래 Main 진입 Intent의 `EXTRA_DATA`가 남아 동일 Intent 재처리나 Activity 재생성 시 다시 상세를 열 수 있다. +- **영향:** cold-start 한 번만 실행 계약 위반. +- **권장 조치:** gift route 성공 시 소비된 전달 data를 최소 범위에서 제거하고 재처리 test를 추가한다. + +## 6. plan·goal 전환 + +- `plan-task.md` Phase 9에 `P9-R1`, `P9-R2`를 추가했다. +- 두 회귀 Task의 focused test와 Phase 9 Gate가 끝나기 전에는 Phase 9를 완료 처리하지 않는다. + +## 7. 리뷰 종료 판정 + +**최종 결론:** 수정 검증 완료. + +**남은 항목:** 없음. + +## 8. 수정 후 검증 기록 + +- 2026-10-08: `P9-R1`에서 foreground/cold-start blank 첫 segment 회귀 test를 RED→GREEN으로 확인했다. +- 2026-10-08: `P9-R2`에서 동일 entry Intent와 새 Main 인스턴스의 재소비 차단, 새 gift Intent 처리 유지 test를 RED→GREEN으로 확인했다. +- 2026-10-08: focused, gift package, 전체 local unit, resource merge, Kotlin compile, assemble, diff-check를 재실행했다. ktlint는 변경 외 기존 레거시 위반으로 실패했다.