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
@@ -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는 변경 외 기존 레거시 위반으로 실패했다.