docs(event): 딥링크와 공통 라우팅 리뷰를 기록한다

This commit is contained in:
2026-10-29 15:29:21 +09:00
parent 3a66488f1e
commit c61a6f8a9e
2 changed files with 101 additions and 0 deletions
@@ -0,0 +1,49 @@
# Phase2 이벤트 공통 라우팅 편입 리뷰
## 1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 대상 | Phase2 / Task2.1~2.2 |
| 기준 | 기존 Phase1 미커밋 변경을 보존한 현재 main 작업 트리 |
| 일자 | 2026-10-29 |
| 리뷰어 | Oracle / ses_e79de1d11ffeuZp1o9lxwKuIq1 |
| 기준 문서 | [PRD](../prd.md) EDL-009, [계획](../plan-task.md) Phase2 |
| 코드 판정 | APPROVE |
## 2. 목적과 범위
- 이벤트 전용 실행 우회를 기존 Bundle 정규화·접근 정책·dispatcher 흐름에 편입했는지 확인했다.
- Phase2 운영 변경은 EventDeepLinkEntry, DeepLinkActivity, MainV2Activity 3개이며 Contract/Delivery/SDK 초기화는 보존했다.
- Entry/Routing 신규 회귀와 기존 audio source-shape 변경을 검토했다. Phase1 완료·리뷰 기록은 유지했다.
## 3. 판정 근거
| 기준 | 확인 근거 | 판정 |
|---|---|---|
| 공통 실행 | handleEventEntry/handleEventDeepLink 정의·호출 없음. 이벤트 startActivity는 기존 routeForegroundDeepLink/executeBundleRoute 내부 각1곳 | 충족 |
| 입력 변환 | buildDeepLinkExtras/resolveDeepLinkBundle에서 normalize. canonical URL·marker·typed Long ID/state 생성, route에서 URL/ID 재검증 | 충족 |
| 위조·충돌 차단 | raw event_id/외부 URL/SDK 별칭 충돌/ID 변조 거부. Invalid/SdkOwned는 gift/live보다 먼저 무이동 종료 | 충족 |
| 소비 상태 | 전달받은 Bundle만 소비하며 원본 state/handoff/saved state에 반영. 무관한 Activity.intent는 보존 | 충족 |
| 기존 동작 | chat/audio 우선, 검증된 이벤트 guest 정책, 라이브 확인·지연, gift 소비·마케팅 clear, UDL handoff 유지 | 충족 |
## 4. 발견 사항
**EDL-009와 Phase2 기준을 위반하는 차단 결함 없음.** 추가 코드 수정·회귀 수정 Task 전환 항목 없음.
MainV2AudioNotificationRouteSourceTest의 로그인 검사 문자열2곳을 공통 접근 정책 호출로 바꾼 것은 구조 변경에 따른 조정이다. 오디오 → 접근 정책 → 실행 순서 assertion과 guest/비이벤트/오디오 승리 동작 테스트를 유지했다.
## 5. 실제 검증 결과
리뷰어는 재실행하지 않았다. 아래는 상위 실행자와 구현자의 실제 명령·산출물 확인 결과다.
- baseline targeted156개 통과. 구현 후 기존156+신규14 = targeted170개 통과, event94개 포함.
- 최초 parent 전체 실행은 worker exit1. `--info` 진단에서는1736개 중 기존 V2AuthFlowTest:844 한 건 실패, APK는 생성됐다.
- 해당 인증 코드/테스트 및 공통 저장소는 변경하지 않았다. 실패 메서드 분리 실행은 통과했다(59초). 원인을 확정하거나 기대값을 완화하지 않았다.
- 최종 `./gradlew :app:ktlintMainSourceSetCheck :app:ktlintTestSourceSetCheck :app:testDebugUnitTest :app:assembleDebug --console=plain --max-workers=1` → BUILD SUCCESSFUL(4분36초).
- 최신 HTML: **1736 tests / 0 failures / 0 ignored / 100% successful**. main/test ktlint report 내용 없음(위반0).
- `git diff HEAD --check`: exit0. `./gradlew tasks --all --console=plain`: 성공(7초).
- 테스트 report: `app/build/reports/tests/testDebugUnitTest/index.html`; APK: `app/build/outputs/apk/debug/app-debug.apk`.
## 6. 검증 한계
- Main 일부 검증은 private method/field/runnable 경계를 사용한다. 실제 Main 전체 lifecycle·라이브 dialog 버튼·기기 UI 검증으로 확대하지 않는다.
- OneLink native fallback 부재와 provider click identity 없는 중복 구분 한계는 Phase1 계약을 유지한다.
- 실제 서버·SDK 네트워크·푸시 발송·대시보드 검증은 사용자 지시로 수행하지 않았다. LSP 미제공으로 Kotlin compilation/ktlint를 사용했다.
- 이전 worker 종료와 인증 테스트 간헐 실패는 최종 직렬 실행에서 재현되지 않았지만, 이 리팩터링으로 테스트 환경 불안정성을 수정한 것은 아니다.
## 7. 종료 판정
**APPROVE.** 코드 구조·기능 기준에 차단 결함 없음. 읽기 전용 리뷰 승인과 parent의 최종1736개·lint·build 통과를 각각 확인했다. 남은 코드 수정 없음.