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,52 @@
# 이벤트 딥링크·AppsFlyer 최종 리뷰
## 1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 대상 | Phase1 / Tasks1.1~1.4 |
| 기준 | main 작업 트리, HEAD a4c69bfb 대비 변경 및 신규 untracked 파일 |
| 일자 | 2026-10-29 |
| 리뷰어 | Oracle / ses_e7a2303a7ffexT7xBJlfEx0OQW |
| 문서 | [PRD](../prd.md), [구현 계획](../plan-task.md) |
| 판정 | APPROVE, 읽기 전용 코드 리뷰 완료 |
## 2. 목적과 범위
- EDL-001~008 및 PRD §8의 입력 계약·소유권·생명주기·기존 정책 보존을 검토했다.
- 새 EventDeepLinkContract/Entry/Delivery, DeepLinkActivity/MainV2Activity/SodaLiveApp 연결, 신규 테스트와 상세 조회 통합 회귀를 확인했다.
- SDK key 원문은 리뷰하지 않았고 SodaLiveApp diff는 context 없는 형태로 확인했다. init의 기존 인수는 변경되지 않았다.
- 실서버/실제 푸시/AppsFlyer 대시보드/SDK 네트워크/기기 UI는 사용자·저장소 정책에 따라 제외했다.
## 3. 검토한 근거
| 기준 | 근거 | 판정 |
|---|---|---|
| 입력 경계 | Contract의 환경별 scheme/host, ASCII 양수 Long, authority/경로/query 검증, Entry alias 정규화 | 충족 |
| 진입 보존 | DeepLinkActivity의 결제 우선·event handoff, Main의 audio→event→login 순서, saved state/단계별 소비 | 충족 |
| UDL 전달 | FIFO, weak resumed host, main thread 직렬화, Main readiness, explicit trampoline 전달 | 충족 |
| SDK 연결 | listener-before-start, 기존 마케팅 setter/Firebase 호출 보존, 유효 event만 offer | 충족 |
| 소유권 | OneLink URI는 SdkOwned, 실제 상세 이동은 UDL만 소유 | 승인된 계약과 일치 |
## 4. 검증 결과
- 리뷰어는 코드와 테스트를 읽었으며 Gradle을 재실행하지 않았다. 아래 결과는 상위 실행자가 실제 실행·산출물 확인한 결과다.
- baseline 관련 회귀: 122개 통과.
- 구현 후 focused+인접 회귀: 156개 통과, 이벤트 패키지80개 포함.
- 최종 `./gradlew :app:testDebugUnitTest :app:assembleDebug --console=plain --info`: BUILD SUCCESSFUL(2분33초), **1722 tests / 0 failures / 0 ignored**.
- main/test ktlint: 위반0, 두 txt report 내용 없음. Kotlin compilation 통과.
- `./gradlew tasks --all --console=plain`: 성공. `git diff HEAD --check`: exit0.
- 결과 HTML: `app/build/reports/tests/testDebugUnitTest/index.html`.
- APK: `app/build/outputs/apk/debug/app-debug.apk`.
- 이전 전체 실행은 신규 fixture의 즉시 DataStore snapshot assertion으로 실패했고 Task1.4로 테스트 경계를 격리했다. 이후 worker exit1도 있었으나 소스 변경 없는 `--info` 실행에서 재현되지 않았다. 실패 기록과 불확실성은 계획 Verification Log에 보존했다.
## 5. 발견 사항
**차단할 확정 코드 결함 없음. 추가 코드 수정 없음.** 회귀 수정 Task 전환 항목 없음.
### 검증 범위 주의사항
- Main readiness는 미생성 Main 인스턴스의 필드/실제 runnable을 사용한다. Main 전체 UI/lifecycle를 실제 기기에서 검증한 증거는 아니다.
- Entry 소비의 재생성은 테스트 Activity를, trampoline 재생성은 실제 DeepLinkActivity를 사용한다. 두 범위를 구분한다.
- 라이브 취소 시나리오는 실제 취소 버튼 조작이 아니라 확인 broadcast 뒤 승인 handoff를 하지 않았을 때 재전달이 없는지 검사한다.
- SDK 테스트는 마케팅 property setter7개의 값·횟수 및 후속 callback 누적 호출을 `verify`/`confirmVerified`로 검사한다. 저장소 자체의 영속성 검증이 아니다. listener/start 순서·Firebase 호출·유효 ID 전달·무효/비이벤트 거부는 유지되어 assertion 약화로 보지 않는다.
- OneLink native fallback 부재, provider click identity 없는 동일 ID 새 callback 처리, 프로세스 종료 시 queue 미복구는 PRD §8의 명시된 계약이다.
## 6. 종료 판정
**APPROVE.** 로컬 코드·테스트 계약 범위에서 EDL-001~008 차단 결함 없음. 상위 실행자의 전체 테스트·빌드 결과는 별도로 확인했으며 리뷰 승인으로 실행 검증을 대체하지 않았다.
실서비스 AppsFlyer callback 수신·대시보드 설정·실제 발송 적합성과 전체 Main/라이브 dialog 기기 동작은 검증 완료로 주장하지 않는다.
@@ -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 통과를 각각 확인했다. 남은 코드 수정 없음.