docs(gift): 선물 상세 딥링크 구현과 리뷰를 기록한다

This commit is contained in:
2026-10-08 15:07:42 +09:00
parent 56583af7ea
commit daab03788a
2 changed files with 178 additions and 0 deletions
@@ -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`에 등록했다.
@@ -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는 변경 외 기존 레거시 위반으로 실패했다.