diff --git a/docs/20261029_이벤트_상세_딥링크/plan-task.md b/docs/20261029_이벤트_상세_딥링크/plan-task.md new file mode 100644 index 00000000..90a05743 --- /dev/null +++ b/docs/20261029_이벤트_상세_딥링크/plan-task.md @@ -0,0 +1,268 @@ +# 이벤트 상세 딥링크·AppsFlyer 구현 계획 + +> 승인된 현재 main 작업 트리에서 Task 순서대로 실행한다. worktree·브랜치·커밋·푸시는 생성하지 않는다. + +**Goal:** 직접 링크·푸시·AppsFlyer에서 로그인 여부와 관계없이 같은 이벤트 상세를 열고, 기존 도메인 이동 정책을 보존한다. +**Architecture:** v2 이벤트 입력 파서/entry 상태와 Application lifecycle 전달 helper를 둔다. 직접 URI는 Intent, OneLink는 UDL이 이동을 소유한다. 기존 DeepLinkActivity/Splash/MainV2/라이브룸 확인 경로를 재사용한다. +**Tech Stack:** Kotlin, Android Intent/Bundle/Handler/ActivityLifecycleCallbacks, AppsFlyer 6.17.4, JUnit4/Robolectric. +**Spec:** [prd.md](prd.md) + +| 항목 | 내용 | +|---|---| +| 상태 | Phase1·Phase2 구현 완료 | +| 작성일 | 2026-10-29 | +| Phase | 2 기존 Bundle 라우팅 편입 | +| 승인 | DeepLinkActivity/SodaLiveApp의 최소 이벤트 연결 및 SDK 등록 순서 보정 | + +## Global Constraints +- 신규 코드는 `app/src/main/java/kr/co/vividnext/sodalive/v2/event/`, 테스트는 대응 `app/src/test/java/.../v2/event/`에 둔다. +- 허용 레거시 수정은 `main/DeepLinkActivity.kt`, `app/SodaLiveApp.kt`의 이벤트 연결과 listener 등록 순서뿐이다. MainV2 이벤트 연결은 v2 범위다. +- 기존 이벤트 API/화면 UI, 다른 도메인 라우터·공통 인증·마케팅 저장/추적은 바꾸지 않는다. +- 실서버/실제 푸시/SDK 네트워크/기기 UI/스크린샷 검증 없음. 테스트는 SDK/API를 fake/mock 처리한다. +- SDK key, 토큰, 전체 attribution payload를 출력하거나 문서화하지 않는다. 키를 변경하지 않는다. +- 새 dependency, 전면 router 추상화, 영구 queue, eventId 전역 중복 set, 임의 TTL은 추가하지 않는다. +- 구현은 RED → RED 확인 → GREEN → GREEN 확인 → REFACTOR 순서다. 기존 완료 기록은 보존한다. + +## Review Focus +- URI/Bundle alias 및 query 충돌로 임의 host/ID가 이벤트로 승격되지 않는가. +- 실제 entry 재생성/콜드 handoff는 한 번, 새 same-ID Intent는 새 이동인가. +- URI+UDL 어느 순서에서도 OneLink의 이동 소유자가 하나인가. +- late callback, Activity pause/destroy, Main 초기 routing barrier에서 background launch/누수/유실이 없는가. +- 이벤트 guest 예외가 오디오·gift·DM·라이브룸 확인·비이벤트 로그인 가드를 훼손하지 않는가. + +## Phase 1 +**결과:** EDL-001~008을 로컬 Intent·콜백·Activity lifecycle에서 검증한다. +**시작 조건:** PRD와 사용자 레거시 승인 완료, Oracle 소유권 설계 및 Plan agent breakdown 확인. + +#### Task 1.1 이벤트 입력 계약·Intent 소유 진입 +**Files:** +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/event/EventDeepLinkContract.kt` +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/event/EventDeepLinkEntry.kt` +- 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` +- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDeepLinkContractTest.kt` +- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDeepLinkEntryTest.kt` +- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDeepLinkRoutingTest.kt` +- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDetailNavigationTest.kt`의 기존 fake API로 실제 상세 조회까지 연결하는 통합 회귀 추가 + +**Interfaces:** `EventDeepLinkContract.classify(uri, appScheme)` → Direct(eventId)/SdkOwned/InvalidEvent/Unrelated; `parseUdl(value, sub5): Long?`; `canonicalUri(eventId, appScheme): Uri`. `EventDeepLinkEntry`는 event URL 후보 정규화와 entry token/단계별 전달·소비 상태를 소유한다. 내부 메서드 형태는 가장 작은 구현으로 정하고 실제 계약을 기록한다. +**범위:** direct URI는 새 이벤트 상세로 연결, OneLink URI는 bootstrap 뒤 UDL 대기. 기존 payverse/DM/라이브룸 확인 순서 보존. Main은 기존 선행 분기 유지 후 audio → guest event → 기존 login/non-event 순서. Splash와 라이브룸에는 기존 Bundle만 전달한다. +**완료 증거:** 정확한 environment scheme/host·ID grammar, event alias/우선순위, warm/cold/guest/재생성/새 Intent 및 인접 회귀 로컬 테스트. + +- [x] **RED:** 입력 계약/소유 상태 및 실제 라우팅의 최소 실패 테스트를 작성한다. +- [x] **RED 확인:** event focused 테스트를 실행해 구현 부재 또는 동작 assertion 실패를 구분해 기록한다. +- [x] **GREEN:** helper와 두 routing 경계만 최소 연결한다. +- [x] **GREEN 확인:** 계약·라우팅 및 기존 관련 회귀 통과. +- [x] **REFACTOR:** 이번 코드 중복만 정리하고 테스트 결과 누적. + +**Task 1.1 검증 — 2026-10-29** +- `--tests '*EventDeepLinkContractTest' --tests '*EventDeepLinkRoutingTest'`: 최초 Contract 부재로 test Kotlin compilation RED. Contract 구현 후 9개 중 라우팅 assertion 4개 실패 RED(푸시 별칭/잘못된 event fallback/foreground/cold). 구현 이후 Contract 4 + Entry 3 + Routing 5 = 12개 통과, 실패/skip 없음. +- Entry의 최초 RED는 helper 부재 compilation 실패다. 실제 Robolectric Activity `recreate()`에서 원본 launch Intent와 saved state를 복원하고 새 same-ID Intent를 허용한다. +- 같은 Gradle 명령에 `--tests '*GiftNavigationTest' --tests '*DeepLinkActivitySourceTest' --tests '*MainV2*Test' --tests '*SodaFirebaseMessagingServiceSourceTest'`를 추가한 인접 검증 BUILD SUCCESSFUL(27초). 기존 assertion/fixture 변경 없음. +- Entry interface: `classify(Intent)`, `payload(Intent)`, `forward/consume(Intent): Boolean`, `save/restore(Intent, Bundle?)`. data가 있으면 authoritative, data 없는 후보 충돌은 InvalidEvent. 토큰과 독립 forwarded/consumed 상태만 내부 Bundle/saved state에 보존한다. +- 실행 방식: 승인된 main에서 순차 실행, 별도 worktree/SDD workspace/커밋 없음. 정식 계획을 ledger로 사용한다. Task1.2는 동일 Contract와 Entry canonical handoff를 소비한다. + +#### Task 1.2 AppsFlyer lifecycle 전달 +**Files:** +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/event/EventDeepLinkDelivery.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/app/SodaLiveApp.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/MainV2Activity.kt` +- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDeepLinkDeliveryTest.kt` +- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventAppsFlyerIntegrationTest.kt` + +**Interfaces:** Application install, validated ID offer, Main routing ready 통지. one process-local FIFO/weak resumed host/main-thread serialization, explicit DeepLinkActivity canonical handoff. +**범위:** listener-before-start, 기존 FOUND 저장/UTM 추적 유지 후 event payload만 전달. Splash/DeepLink/초기 routing 중 Main은 대기. resumed host가 이미 있어도 offer가 drain을 예약한다. pause/destroy 재검사, handoff 한 번, 라이브룸 취소 뒤 재등장 없음. 새 same-ID UDL은 별도 전달이다. +**완료 증거:** 선도착/후도착·background 복귀·ready barrier·FIFO·same-ID 새 delivery·취소/종료·메인 스레드·소유권 양방향 순서 테스트. + +- [x] **RED:** lifecycle와 SDK callback 전달 seam의 실패 테스트 작성. +- [x] **RED 확인:** focused 실행으로 필요한 동작 부재 확인. +- [x] **GREEN:** 새 전달 helper와 승인된 두 연결부만 구현. +- [x] **GREEN 확인:** lifecycle/UDL/URI 통합 테스트 통과. +- [x] **REFACTOR:** 불필요한 중복 제거, listener 등록 순서·기존 마케팅 저장 유지 증거 기록. + +**Task 1.2 검증 — 2026-10-29** +- 최초 `--tests '*EventDeepLinkDeliveryTest' --tests '*EventAppsFlyerIntegrationTest'`는 Delivery/helper property 부재 compilation RED. fixture의 존재하지 않는 `Robolectric.buildApplication` 호출은 `SodaLiveApp()`으로 수정했으며, 이 fixture 오류는 기능 RED로 계산하지 않는다. +- Delivery 구현 후 SDK 연결 전 동일 명령은 `start` 시 listener 미등록 assertion RED(`true` 기대/`false` 실제). 이후 `init → helper 설치 → subscribeForDeepLink → start`로 연결하고 start 내부에서 즉시 mock callback을 전달해 선도착 보관 및 추후 handoff를 입증했다. SDK `init` 호출의 기존 키·인수는 편집하지 않았다. +- 초기 Delivery fixture에서 Robolectric `nextStartedActivity`의 LIFO 관찰을 FIFO로 잘못 가정한 오류와 Splash Firebase 초기화 누락을 수정했다. FIFO는 실제 Activity의 `startActivity` 수신 목록 순서로 검증하며 기존 테스트의 assertion/fixture는 약화하지 않았다. +- lifecycle 8개: 선도착 FIFO, 이미 resumed인 호스트의 후도착/같은 ID 새 전달, pause/destroy/finishing, Splash·trampoline·Main ready barrier, 초기 Main 오디오 우선과 별도 UDL 보존, URI→UDL/UDL→URI 단일 상세, 라이브 확인 취소 뒤 재전달 없음, background thread offer를 검증했다. +- 실제 `SodaLiveApp.setupAppsFlyer`를 fake SDK로 실행한 callback 테스트 1개: start 이전 등록, PID/UTM/마케팅 ID 저장, Firebase 호출, 유효 이벤트만 offer를 검증했다. 새 callback seam/의존성/SDK 네트워크는 추가하지 않았다. +- helper interface는 `EventDeepLinkDelivery(Application)`, `offer(validatedEventId: Long)`, `onMainRoutingReady()`다. lifecycle callback은 Application에 등록하며 `MainV2Activity.isEventDeepLinkRoutingReady`를 barrier로 읽는다. 대기는 process-local FIFO, resumed Activity는 WeakReference만 사용한다. + +#### Task 1.3 통합 검증·문서 +**Files:** 새 테스트 및 직접 영향받는 기존 source test, `docs/agent-guides/build-test-style.md`의 focused 명령. 기존 source-shape assertion을 바꾸면 동일 의미를 실제 동작 테스트로 유지하고 이유를 기록한다. +**TDD 예외 사유:** 구현 이후 검증·문서 Task다. 일반 검증 결과는 이 계획에 기록하고 리뷰 결과만 별도 보고서로 쓴다. +- [x] event focused + 기존 gift/DeepLink/MainV2/FCM/login/audio 회귀 실행. +- [x] 전체 unit suite, main/test ktlint, debug 빌드 실행. +- [x] `./gradlew tasks --all --console=plain`로 문서 명령 확인. +- [x] LSP 도구 미제공 시 Kotlin compilation/ktlint 대체 사실 명시. +- [x] `reviews/phase1-event-deeplink-appsflyer-review.md`에 단일 최종 리뷰 기록; 확정 수정은 신규 회귀 Task로 추가. +- [x] PRD/계획 완료 기록과 소유 임시 자원 정리. + +#### Task 1.4 전체 실행의 AppsFlyer 테스트 저장소 경계 격리 +**시작 조건:** parent 전체 unit 실행 1722개 중 EventAppsFlyerIntegrationTest 한 건 실패(expected ID7, actual0). +**Files:** `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventAppsFlyerIntegrationTest.kt`만 변경. +**근거:** SharedPreferenceManager는 setPreference의 즉시 메모리 갱신 후 IO edit를 수행하고, 별도 observer가 전체 snapshot을 덮어쓴다(:71~82,:143~168). 테스트가 여러 마케팅 setter 직후 동기적인 전체 snapshot을 가정한 경계 경쟁이다. 기존 EventDetailViewModelTest도 저장소 getter를 MockK로 격리한다. +**범위:** SDK 실제 연결 callback 테스트는 유지하고, 마케팅 property setter의 정확한 값·호출과 Firebase tracking을 MockK로 검증한다. SDK listener/start 순서, ID handoff, invalid/non-event 거부 assertion은 유지한다. 운영 저장소나 callback/라우팅 코드는 수정하지 않는다. +- [x] failing 전체 결과 XML과 공통 저장소의 비동기 갱신 경계를 대조한다. +- [x] callback 테스트의 저장소 경계만 fake/mock 처리하고 기대하는 값·호출 검증을 유지한다. +- [x] focused 테스트 및 main/test ktlint로 확인한다. +- [x] parent 전체 unit/build 재실행으로 확인한다. + +**Task 1.4 검증 — 2026-10-29** +- 수정 전 XML의 assertion RED는 `EventAppsFlyerIntegrationTest:68` expected7/actual0이다. `setPreference`의 메모리 갱신·비동기 IO edit와 observer의 전체 snapshot 교체를 직접 읽어 대조했다. flaky 재현을 위한 반복 실행이나 sleep/retry는 추가하지 않았다. +- 테스트의 실제 `SharedPreferenceManager.init/resetForTest` 호출을 제거하고 7개 property setter만 MockK로 격리했다. getter를 기대값으로 고정하지 않고 `verify(exactly = 1)`로 최초 callback의 정확한 값·횟수, 이후 invalid/non-event callback까지 포함한 정확한 값·총 횟수를 검증한다. `confirmVerified`로 예상 밖 추가 호출도 거부한다. 실제 DataStore observer/write는 시작하지 않는다. +- 실제 `setupAppsFlyer` 실행, start 이전 listener 등록 assertion, mock SDK callback, Firebase 호출, 유효 ID handoff, invalid/non-event 이동 거부는 유지했다. 운영 코드·공통 저장소·다른 테스트는 수정하지 않았다. +- 순차 실행 1: `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.EventAppsFlyerIntegrationTest' --console=plain` → BUILD SUCCESSFUL(13초), **1 test / 0 failures / 0 errors / 0 skipped**. +- 순차 실행 2: `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --console=plain` → BUILD SUCCESSFUL(19초), **80 tests / 0 failures / 0 errors / 0 skipped**. +- 순차 실행 3: `./gradlew :app:ktlintMainSourceSetCheck :app:ktlintTestSourceSetCheck --console=plain` → BUILD SUCCESSFUL(3초). 전체 unit/build 재실행은 parent 담당으로 남긴다. +- 로그는 기존 소유 임시 디렉터리의 `task14-appsflyer-focused.log`, `task14-event-focused.log`, `task14-lint.log`에 보존한다. 이번 변경 파일은 해당 테스트와 이 계획 문서뿐이다. +- parent 최종 전체 검증: 아래 통합 Gate 3차에서 1722개 통과와 debug APK 빌드 성공을 확인했다. + +### 검증 명령 +```bash +./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --console=plain +./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --tests '*GiftNavigationTest' --tests '*DeepLinkActivitySourceTest' --tests '*MainV2*Test' --tests '*SodaFirebaseMessagingServiceSourceTest' --console=plain +./gradlew :app:ktlintMainSourceSetCheck :app:ktlintTestSourceSetCheck :app:testDebugUnitTest :app:assembleDebug --console=plain +./gradlew tasks --all --console=plain +``` +**Expected:** 실패/오류/새 skip 없음, Kotlin compilation/ktlint/build exit0. 실서비스 적합성을 주장하지 않는다. + +## Phase 2 기존 공통 라우팅 편입 +**목표:** 이벤트 전용 실행 경로를 기존 Bundle dispatcher의 이벤트 분기로 대체하고, 입력 수신 방식과 목적지 실행 책임을 분리한다. +**시작 조건:** 사용자 "추천 방안대로 수정한다" 승인. Phase1의 완료 항목/리뷰/검증은 그대로 보존한다. +**범위 밖:** 전체 앱 새 라우터 도입, SDK 초기화/대기 계약 변경, OneLink native fallback 추가, 다른 도메인의 정책 변경. + +### 코드·영향 지도 +- DeepLinkActivity: buildDeepLinkExtras → 기존 foreground/cold/live orchestration → routeForegroundDeepLink. +- MainV2: resolveDeepLinkBundle → 접근 정책/기존 audio 우선 → executeBundleRoute/routeByDeepLinkValue. +- EventDeepLinkContract: 기존 엄격한 URI/UDL 검증 유지. +- EventDeepLinkEntry: 입력 후보를 검증된 Bundle로 정규화하고 단계별 상태를 보존. 실행 책임 없음. +- EventDeepLinkDelivery: 기존 canonical URI 전달·FIFO/weak host/Main 준비 대기 유지. 상세 목적지 판단/실행 없음. + +#### Task 2.1 정규화와 공통 dispatcher 편입 +**Files:** +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/event/EventDeepLinkEntry.kt` +- 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` +- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDeepLinkEntryTest.kt` +- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDeepLinkRoutingTest.kt` +- Verify unchanged: Contract/Delivery/AppsFlyerIntegration/EventDetailNavigation 및 기존 gift/Main/FCM 회귀. +- 필요 시 Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/MainV2AudioNotificationRouteSourceTest.kt`의 로그인 가드 source-shape만 공통 접근 정책 호출로 교체한다. 오디오 → 접근 정책 → 실행 순서 assertion과 실제 guest/비이벤트/오디오 우선 동작 테스트는 유지한다. + +**Interfaces:** `normalize(intent): Bundle?`(Unrelated만 null), `route(bundle): EventDeepLinkContract`를 Entry의 입력 변환 역할에 둔다. Direct는 canonical deep_link·deep_link_value=event-detail·typed event_id·기존 state로 표현한다. raw ID만으로 실행하지 않고 URL 검증·ID 일치를 다시 확인한다. 정확한 최소 메서드 형태는 실제 구현으로 기록한다. +**정규화 정책:** SdkOwned는 검증된 URL/state만, InvalidEvent는 목적지 ID 없는 terminal event 입력으로 보존한다. 관련 없는 입력의 기존 Bundle 작성은 유지한다. normalize 이후 forward/consume 상태가 원본 및 handoff에 반영되게 한다. +**실행 정책:** handleEventEntry와 handleEventDeepLink를 삭제한다. 별도 새 이벤트 실행 helper로 이름만 바꾸지 않는다. 이벤트 startActivity는 기존 routeForegroundDeepLink/executeBundleRoute 안에서 수행한다. guest 예외는 검증된 목적지의 접근 정책이며 소스별 별도 실행이 아니다. 기존 payverse/DM/audio/live 확인/콜드 Splash/gift 소비 정책을 유지한다. + +**Task 2.1 실행 중 — 2026-10-29** +- 순서: Entry 정규화·Bundle 검증 실패 테스트 → Entry 구현 → 기존 두 dispatcher 실패 assertion → Activity 연결 → targeted/lint 검증. Task2.2의 전체 suite/build/리뷰는 parent가 수행한다. +- 정규화 Bundle의 state는 원본 entry state를 공유해 dispatcher 소비가 원본 saved state에 남도록 한다. handoff/복원에서는 기존 token 및 forward/consume 두 단계를 유지한다. dispatcher는 Activity.intent가 아닌 전달받은 Bundle을 소비한다. +- 공통 접근 정책은 정규화된 event route만 guest 예외로 처리한다. InvalidEvent/SdkOwned도 terminal로 처리하되 목적지 실행은 하지 않는다. 기존 비이벤트 Bundle 작성 경로는 유지한다. + +- [x] **RED:** 정규화 Bundle 내용·forged ID·잘못된 URL·SdkOwned·상태 전달 및 두 기존 dispatcher의 이벤트 실행 테스트를 작성한다. +- [x] **RED 확인:** focused 명령으로 신규 정규화/공통 dispatcher 동작 부재를 확인한다. +- [x] **GREEN:** Entry 정규화와 두 기존 dispatcher 연결을 최소 변경하고 이벤트 우회 실행 함수를 제거한다. +- [x] **GREEN 확인:** 기존 156개 targeted baseline과 신규 테스트 통과. +- [x] **REFACTOR:** 새 중복만 정리한다. 기존 source-shape 테스트를 변경해야 하면 동일 의미의 동작 검증을 유지하고 이유를 기록한다. + +**Task 2.1 검증 — 2026-10-29** +- 최초 `:app:testDebugUnitTest --tests '*EventDeepLinkEntryTest' --tests '*EventDeepLinkRoutingTest' --console=plain`은 `normalize/route` 부재로 test Kotlin compilation RED(7초)다. assertion 실패와 구분한다. Entry 구현 후 동일 명령은 **28개 중 3개 assertion RED**(dispatcher의 이벤트 미처리, terminal 입력의 gift fallback, 기존 Bundle seam의 typed ID 부재, 55초)였다. +- DeepLinkActivity 연결 후 재실행은 **29개 중 4개 assertion RED**(앞선 세 검증이 MainV2에서 실패하고, 추가 SDK URL 별칭 충돌에서 InvalidEvent 기대/SdkOwned 실제, 30초)다. MainV2 연결·SDK 별칭 충돌 검증 후 **29/29 GREEN**(34초). 신규 테스트는 Entry 9개 + Routing 5개로 총 14개이며 기존 테스트 삭제·기대값 완화는 없다. +- 확정 interface: `normalize(Intent): Bundle?`는 Unrelated만 null이다. Direct는 canonical `deep_link`, `deep_link_value=event-detail`, Long `event_id`, `v2.event.entry`만 보유한다. SdkOwned는 검증된 `deep_link`와 state만, InvalidEvent는 terminal marker와 state만 보유하며 실행 URL/ID는 없다. data 없는 SDK 별칭은 분류가 같아도 서로 다른 URL이면 거부한다. +- `route(Bundle): EventDeepLinkContract`는 URI 계약을 재검증하고 Direct의 marker·Long ID 일치를 요구한다. `consume(Bundle): Boolean`은 이 검증을 통과한 Bundle state만 소비한다. `consume(Intent)`와 기존 Delivery가 쓰는 `payload(Intent)`는 정규화를 재사용한다. `forward(Intent)`, `save/restore` 계약은 유지한다. 원본·정규화·handoff·복원 및 새 same-ID 입력을 테스트했다. +- 구조: `handleEventEntry`/`handleEventDeepLink` 정의·호출을 삭제했다(`rg` 두 운영 파일 검색 결과 없음). 이벤트 `EventDetailActivity.newIntent` 실행은 `DeepLinkActivity.routeForegroundDeepLink`와 `MainV2Activity.executeBundleRoute` 내부 각 한 곳뿐이다. 전자는 `buildDeepLinkExtras`, 후자는 `resolveDeepLinkBundle`에서 정규화한다. SdkOwned foreground 대기/콜드 bootstrap과 InvalidEvent 종료는 입력 정책으로 남기고 기존 payverse/DM/live/Splash orchestration을 재사용한다. +- MainV2의 deferred/onNewIntent는 오디오 우선 후 동일 `isDeepLinkAccessAllowed(Intent)` 정책을 거친다. 이는 정규화 event route의 guest 접근·terminal 처리를 판단할 뿐 실행하지 않는다. chat filter·live 지연·readiness·gift 소비는 기존 경로 그대로다. 이벤트가 기존 마케팅 저장값을 clear하지 않던 동작도 유지하며 비이벤트 성공의 기존 clear 동작만 실행한다. +- 추가 source-shape 변경은 사전 기록한 `MainV2AudioNotificationRouteSourceTest`의 직접 로그인 검사 문자열 두 곳을 공통 접근 정책 호출로 교체한 것뿐이다. 오디오 → 정책 → 실행 순서 assertion을 유지하며 Routing의 실제 guest/비이벤트 로그인 거부·오디오 승리 뒤 이벤트 소비, Delivery의 초기 오디오·late UDL 대기 회귀도 통과했다. +- 최종 명령: `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --tests '*GiftNavigationTest' --tests '*DeepLinkActivitySourceTest' --tests '*MainV2*Test' --tests '*SodaFirebaseMessagingServiceSourceTest' :app:ktlintMainSourceSetCheck :app:ktlintTestSourceSetCheck --console=plain` → **BUILD SUCCESSFUL(1분38초)**. 최신 XML/HTML은 **170 tests / 0 failures / 0 errors / 0 skipped**(기존156 + 신규14), 이벤트 패키지94개다. main/test Kotlin compilation과 main/test ktlint 통과. LSP 도구는 미제공이므로 이를 대체 검증으로 사용했다. +- 표면 검증은 Robolectric 실제 DeepLinkActivity cold→Splash→Main handoff, trampoline/Entry 재생성, 라이브 확인 broadcast→Main, Main 새 Intent/초기 runnable, 두 dispatcher 직접 호출 및 fake SDK callback으로 수행했다. 두 dispatcher는 별도 원본 Bundle만 소비하고 무관한 Activity.intent는 소비하지 않음을 확인했다. SDK 저장소 setter mock 및 Contract/Delivery/AppsFlyerIntegration/EventDetailNavigation 테스트는 수정하지 않았다. +- 중간 targeted 실행은 assertion 실패 없이 `Gradle Test Executor 42` exit1로 중단(25초)했다. 지시대로 소스/설정 변경 없이 `--info` 진단을 한 번 실행해 **170/170 통과(1분39초)**했다. 이후 최종 실행도 통과했다. 초기 RED 실행의 Robolectric 임시 디렉터리 종료 경고 및 lint 줄바꿈/중괄호/들여쓰기 실패는 로그에 남겼으며, 해당 신규 코드의 포맷만 수정했다. shared cache 정리나 Gradle 설정 변경은 없다. +- 이번 변경은 운영3개(Entry/DeepLinkActivity/MainV2Activity), 테스트3개(Entry/Routing/Audio source-shape), PRD/계획2개다. Contract/Delivery/SodaLiveApp 및 금지된 Manifest/Splash/FCM/LiveRoom/공통 저장소/Utils/상세 API·UI는 편집하지 않았다. SodaLiveApp 원문이나 SDK key는 읽거나 표시하지 않았다. +- 로그는 `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/event-route-refactor.6pApSj/implementation.7Rgui0/`에만 기록했다: `phase2-normalize-red.log`, `phase2-dispatch-red.log`, `phase2-main-sdk-red.log`, `phase2-normalize-dispatch-green.log`, `phase2-targeted-green.log`, `phase2-targeted-diagnostic.log`, `phase2-lint.log`, `phase2-lint-green.log`, `phase2-lint-final.log`, `phase2-targeted-lint-final.log`. 이름의 green/final 표기는 성공 판정이 아니며 위 실패·최종 결과를 기준으로 한다. parent Gate 확인을 위해 보존하며 공유 캐시는 건드리지 않았다. + +#### Task 2.2 회귀·최종 검증 및 문서 +**TDD 예외 사유:** 동작 구현 이후의 검증·문서 Task다. 실제 테스트·컴파일·lint 실행 결과를 기록한다. +- [x] event focused 및 gift/DeepLink/MainV2/FCM/login/audio 회귀 실행. Task2.1 최종170개·main/test ktlint 결과 참조. +- [x] 전체 unit suite + main/test ktlint + debug build 통과. +- [x] 신규 단일 read-only gate 리뷰를 `reviews/phase2-common-event-routing-review.md`에 기록한다. +- [x] 변경된 PRD/계획과 실제 구조를 대조하고 임시 자원을 정리한다. + +**검증 명령:** 기존 Phase1 검증 명령을 재사용한다. LSP 도구는 미제공이므로 Kotlin compilation/ktlint로 대체하며 실서버·기기 UI는 실행하지 않는다. +**순서:** 정규화 RED/GREEN → dispatcher RED/GREEN → 인접 회귀 → parent 전체 Gate·리뷰. 공유 Gradle 산출물은 순차 실행한다. + +## Progress (누적) +### 설계·기준 검증 — 2026-10-29 +- 사용자가 승인한 별도 이벤트 딥링크 작업이며 AppsFlyer도 포함한다. 승인된 설계·실행 방식을 재질문하지 않는다. +- Oracle: custom URI Intent 소유/OneLink UDL 소유를 분리하여 동일 OneLink의 양쪽 전달 순서 문제를 제거한다. 식별 불가능한 SDK 중복보다 새 클릭 보존을 우선한다. +- Plan agent: 입력/entry → UDL lifecycle → 통합 Gate 순차 실행. shared routing/Gradle 산출물 동시 수정·실행하지 않음. +- baseline: `./gradlew :app:testDebugUnitTest --tests '*GiftNavigationTest' --tests '*DeepLinkActivitySourceTest' --tests '*MainV2ActivitySourceTest' --tests '*MainV2LoginGuardSourceTest' --tests '*SodaFirebaseMessagingServiceSourceTest' --tests 'kr.co.vividnext.sodalive.v2.event.*' --console=plain` → BUILD SUCCESSFUL (2분12초), 122 tests/0 failures/0 ignored. + +## Decision Log +| 날짜 | ID | 결정 | +|---|---|---| +| 2026-10-29 | EP-001 | main 직접 작업, 기존 작업 문서/공유 SDK 설정/상세 API 변경 없음 | +| 2026-10-29 | EP-002 | OneLink URI native fallback 없음. 유효한 UDL 전달을 단일 이동 소유자로 사용 | +| 2026-10-29 | EP-003 | 영구 queue/TTL/전역 eventId set 없음. entry token은 앱 내부 handoff/재생성 보장 범위에만 사용 | +| 2026-10-29 | EP-004 | Phase2는 사용자 승인된 구조 리팩터링이다. 기존 두 dispatcher를 확장하고 이벤트 전용 선처리 실행을 제거한다. 비동기 전달과 입력 소유권은 유지한다. | + +## Verification Log +최종 통합 결과는 Task 검증 뒤 누적한다. 실서버·실제 푸시·AppsFlyer 대시보드·기기 UI는 검증 대상에서 제외한다. + +### Tasks 1.1/1.2 구현 인계 — 2026-10-29 +- 추가 경계 RED/GREEN: malformed/빈 port와 비이벤트 Intent 소비 부작용은 이벤트 focused 77개 중 assertion 2개 RED를 확인한 뒤 authority 일치 검증 및 event-only 소비로 수정했다. URL 없이 event routing 필드만 주는 입력은 26개 중 assertion 1개 RED 뒤 InvalidEvent로 차단했다. 테스트 fixture의 LoginActivity 패키지 오타 compilation 실패는 별도로 수정했으며 동작 RED로 계산하지 않았다. +- payverse 충돌 query 우선순위는 Routing 10개 중 assertion 1개 RED를 확인한 뒤 기존 결제 분기를 이벤트 경계보다 먼저 유지해 GREEN으로 만들었다. 기존 DM 우선순위/비이벤트 분기는 유지했다. +- 최종 명령: `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --tests '*GiftNavigationTest' --tests '*DeepLinkActivitySourceTest' --tests '*MainV2*Test' --tests '*SodaFirebaseMessagingServiceSourceTest' --console=plain --info` → BUILD SUCCESSFUL(52초). XML 합계 **156 tests / 0 failures / 0 errors / 0 skipped**, 이벤트 패키지 **80개** 포함. 기존 source-shape assertion은 수정하지 않았다. +- `./gradlew :app:ktlintMainSourceSetCheck :app:ktlintTestSourceSetCheck --console=plain` → BUILD SUCCESSFUL(1초, 최종 재확인 UP-TO-DATE). 신규 코드 줄바꿈만 수정했다. 저장소의 기존 `disabled_rules`/Gradle deprecation 경고는 범위 밖으로 유지한다. +- 사용 표면 검증은 Robolectric 실제 DeepLinkActivity cold Splash handoff/foreground/재생성, Main 새 Intent·초기 runnable, LocalBroadcast 라이브 확인 handoff, fake SDK callback, 기존 fake API의 Long.MAX_VALUE 실제 상세 조회로 수행했다. Main 전체 UI를 생성하는 계측 테스트나 기기 조작은 하지 않았다. +- 검증 중 한 번 TempDirectory/NoSuchFileException과 한 번 테스트 worker exit 1이 발생했다. 소스 변경 없는 재실행 및 `--info` 진단 실행은 통과했다. 최종 XML에 failure/skip은 없다. 재현되는 코드 결함으로 판단하지 않았으며 실행 실패 기록을 보존한다. +- LSP 도구는 제공되지 않아 Gradle의 main/test Kotlin compilation과 main/test ktlint로 대체했다. 전체 unit suite·assembleDebug·tasks 목록 확인·최종 리뷰·PRD 최종 체크·임시 자원 정리는 상위 실행자가 담당하므로 해당 Task1.3 체크박스는 남겨 둔다. +- 변경 파일: EventDeepLinkContract/Entry/Delivery 신규 3개, DeepLinkActivity/MainV2Activity/SodaLiveApp 연결 3개, EventDeepLinkContract/Entry/Routing/Delivery/EventAppsFlyerIntegration 테스트 신규 5개, EventDetailNavigationTest fake API 통합 1개, 이 계획 및 build-test-style 문서 2개. Manifest/Splash/FCM/LiveRoom/공통 preference/상세 API·UI는 수정하지 않았다. +- 임시 로그는 `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/event-deeplink.B7Qa1i/implementation.5aULlv/`의 `*.log`만 사용했다. 핵심 증거: `task11-compile-red.log`, `task11-assertion-red.log`, `task11-entry-red.log`, `task12-compile-red.log`, `task12-assertion-red.log`, `event-integration-red.log`, `event-boundary-assertion-red.log`, `payment-priority-red.log`, `final-worker-diagnostic.log`, `final-lint-green.log`. 실패/중간 실행 로그도 같은 디렉터리에 보존한다. 공유 캐시는 정리하지 않았다. +- 남은 계약 한계는 PRD §8 그대로다. OneLink URI 단독의 native fallback은 없고, provider identity가 없는 동일 ID 새 UDL callback은 새 전달로 보존하며 프로세스 종료 후 별도 queue를 복구하지 않는다. + +### Parent 통합 Gate 1차 — 2026-10-29 +- `./gradlew :app:ktlintMainSourceSetCheck :app:ktlintTestSourceSetCheck :app:testDebugUnitTest :app:assembleDebug --console=plain` → BUILD FAILED(2분2초), 1722 tests 중 1개 실패. +- 실패: EventAppsFlyerIntegrationTest:68 `marketingLinkValueId` expected7/actual0. XML에서 확인했다. main/test ktlint는 통과했으나 unit 실패로 assembleDebug 완료 판정은 하지 않는다. +- 공통 저장소의 비동기 snapshot 반영을 즉시 동기 값으로 읽는 신규 fixture 경계를 Task1.4로 격리한다. 테스트 삭제/기대값 완화/운영 저장소 변경은 하지 않는다. + +### Parent 통합 Gate 2~3차 — 2026-10-29 +- Task1.4 이후 동일 통합 명령은 main/test ktlint 통과 후 `Gradle Test Executor 36` exit1로 중단(55초). assertion 실패 출력이 아닌 worker 종료이며 원인은 이 출력만으로 확정하지 않았다. +- 진단 명령 `./gradlew :app:testDebugUnitTest :app:assembleDebug --console=plain --info` → BUILD SUCCESSFUL(2분33초). 이 재실행 동안 소스 변경은 없었다. +- 최신 HTML `app/build/reports/tests/testDebugUnitTest/index.html`: **1722 tests / 0 failures / 0 ignored / 100% successful**. `app/build/outputs/apk/debug/app-debug.apk` 생성 확인. +- main/test ktlint report txt 두 개는 내용 없음(위반0). `git diff HEAD --check` 출력 없음(exit0). +- `./gradlew tasks --all --console=plain` → BUILD SUCCESSFUL(1초), 정식 검증 task 확인. +- worker 중단이 진단 실행에서 재현되지 않아 원인을 단정하거나 코드/Gradle 설정을 변경하지 않았다. 이전 실패 기록은 유지한다. +- 최종 read-only 리뷰 진행 중. 실서버·SDK 네트워크·푸시 발송·대시보드·기기 UI는 실행하지 않았다. + +### 최종 리뷰 — 2026-10-29 +- Oracle read-only 판정 APPROVE. 차단 결함·추가 코드 수정 없음. [리뷰 보고서](reviews/phase1-event-deeplink-appsflyer-review.md)에 근거와 한계를 기록했다. +- Main readiness/초기 runnable은 reflection 경계를, entry 재생성은 테스트 Activity를 사용한다. Main 전체 lifecycle/기기 UI까지 검증한 것으로 확대하지 않는다. +- 라이브 취소는 실제 dialog 버튼이 아니라 broadcast 이후 승인하지 않는 상황의 재전달 부재를 검증했다. SDK 마케팅 검증은 정확한 setter 요청과 Firebase 호출이며 저장소 영속성 검증이 아니다. +- 최종 테스트1722·lint0·debug APK 성공은 parent의 실제 실행 증거이며 reviewer의 읽기 전용 승인과 구분한다. + +### 자원 정리 — 2026-10-29 +- 전원 완료 후 작업 소유 로그22개와 notepad를 삭제하고, 확인된 빈 child 디렉터리4개 및 `event-deeplink.B7Qa1i` run root를 `rmdir`로 정리했다. `test ! -e` exit0으로 부재 확인했다. +- 위 임시 로그 경로는 실행 당시 위치로 현재 정리되었다. 관찰된 RED/GREEN/실패·진단 결과는 이 문서에 보존하며 최신 test XML/HTML·ktlint report·APK는 프로젝트 build 산출물에 남는다. +- 별도 QA 서버/기기/브라우저/컨테이너는 시작하지 않았다. shared Gradle 캐시·다른 작업 자원은 삭제하지 않았다. +- 현재 main 직접 변경만 수행했으며 커밋·푸시·새 브랜치/worktree 생성은 하지 않았다. + +### Phase2 baseline — 2026-10-29 +- 변경 전 기존 event+gift/DeepLink/MainV2/FCM targeted 명령 → BUILD SUCCESSFUL(3분24초). 이전 기능의 코드/테스트를 유지한 상태에서 통과했다. +- 현재 dirty tree는 이전 단계의 미커밋 작업이며 이를 되돌리거나 stage 상태를 변경하지 않는다. Phase1 완료 기록은 재개방하지 않는다. + +### Phase2 parent Gate 1~3차 — 2026-10-29 +- 첫 전체 통합 명령은 `Gradle Test Executor 50` exit1로 중단(2분40초). assertion 실패 출력은 없었다. +- 소스 변경 없는 `./gradlew :app:testDebugUnitTest :app:assembleDebug --console=plain --info` 진단은 debug APK 생성 후 전체 **1736 tests 중1실패**(5분33초)로 종료했다. 실패는 기존 `V2AuthFlowTest.디버그 오디오는 POST 없이 실제 회원 조회를 재시도하고 서버 false와 설정 저장 뒤 한 번 완료한다`의 :844 `isAdultContentVisible=false` assertion이다. +- 해당 인증 운영 코드/테스트와 SharedPreferenceManager는 `git diff HEAD --stat -- ...` 결과 변경 없음이다. 실패 지점과 callback 직후 snapshot 검사를 확인했으며, 변경 영향을 확정하지 않고 분리 실행으로 조사했다. +- 동일 실패 메서드만 `--tests 'kr.co.vividnext.sodalive.v2.auth.V2AuthFlowTest.디버그 오디오는 POST 없이 실제 회원 조회를 재시도하고 서버 false와 설정 저장 뒤 한 번 완료한다'`로 실행 → BUILD SUCCESSFUL(59초). 코드·기대값 변경 없음. 단독 통과를 전체 성공으로 간주하지 않는다. +- 최종 gate를 작업자 하나로 제한한 전체 실행으로 확인한다. 반복 실패 시 scope 밖 인증 코드를 임의 수정하지 않고 결과를 명시한다. + +### Phase2 최종 Gate·리뷰 — 2026-10-29 +- `./gradlew :app:ktlintMainSourceSetCheck :app:ktlintTestSourceSetCheck :app:testDebugUnitTest :app:assembleDebug --console=plain --max-workers=1` → BUILD SUCCESSFUL(4분36초). +- 최신 report1736 tests/0 failures/0 ignored, main/testktlint 위반0, debug APK build 성공. 이 실행 전후 인증 코드/기대값·Gradle 설정은 변경하지 않았다. +- 실패한 기존 인증 메서드가 직렬 실행에서는 재현되지 않았다는 관찰만 기록한다. 이전 worker 종료와 인증 snapshot 실패의 근본 원인을 해결했다고 주장하지 않는다. +- `git diff HEAD --check` exit0, `./gradlew tasks --all --console=plain` 성공(7초). +- Oracle 코드 리뷰 APPROVE, 차단 결함 없음. [Phase2 리뷰](reviews/phase2-common-event-routing-review.md)에 구조·동작 근거와 실제 Main/lifecycle/provider 검증 한계를 기록했다. + +### Phase2 자원 정리 — 2026-10-29 +- 모든 agent 종료 후 이번 단계 소유 로그10개와 notepad를 삭제했다. 확인한 빈 child 디렉터리4개와 `event-route-refactor.6pApSj` root를 rmdir로 제거하고 `test ! -e` exit0으로 부재 확인했다. +- 위 임시 로그 경로는 실행 당시 위치이며 현재는 정리됐다. 실제 RED/GREEN/실패·재검증 기록은 본 문서에, 최신 결과 XML/HTML·ktlint·APK는 프로젝트 build 산출물에 보존한다. +- 공유 캐시·기존 작업 자원·stage 상태는 변경하지 않았다. 커밋/푸시/새 worktree·브랜치/실서버·기기 UI 실행 없음. diff --git a/docs/20261029_이벤트_상세_딥링크/prd.md b/docs/20261029_이벤트_상세_딥링크/prd.md new file mode 100644 index 00000000..311e378e --- /dev/null +++ b/docs/20261029_이벤트_상세_딥링크/prd.md @@ -0,0 +1,102 @@ +# 이벤트 상세 딥링크·AppsFlyer 연동 PRD + +## 문서 정보 +- 상태: Phase1·Phase2 구현·로컬 검증 완료 (실서버 검증 제외) +- 작성일: 2026-10-29 +- 대상: 이벤트 상세 직접 URI·푸시·AppsFlyer UDL 진입 +- 결정권자: 사용자 +- 관련 계획: [plan-task.md](plan-task.md) +- 이번 작업은 이벤트 상세 API 연동과 별도 작업이다. 기존 API/화면은 재사용하며 이전 작업 문서는 수정하지 않는다. + +## 1. 목표 +직접 URI, 기존 FCM/알림함/Notifly의 클릭 URL 및 AppsFlyer direct/deferred 콜백에서 양수 Long 이벤트 ID로 동일한 `v2.event.EventDetailActivity`를 연다. 비로그인도 이벤트 상세에 진입하고, 늦은 콜백·앱 준비 전 전달·동일 진입 중복·Activity 재생성에 대응한다. + +## 2. 현재 문제 +- `DeepLinkActivity`와 `MainV2Activity`의 라우터에 event-detail 분기가 없다. +- FCM notification+data의 런처 진입은 raw extras를 MainV2에 전달하지만 MainV2는 `deep_link`만 URL로 읽고 `deepLink`를 정규화하지 않는다. +- MainV2의 공통 라우팅 앞 로그인 검사로 공개 이벤트도 차단된다. +- AppsFlyer 콜백은 마케팅 값을 저장하지만 MainV2에 저장 목적지를 소비하는 연결이 없다. +- SDK는 `init → start → subscribeForDeepLink` 순서이며 공식 UDL 지침은 listener를 start 전에 등록하도록 한다. + +## 3. 확정 입력 계약 +| 입력 | 계약 | +|---|---| +| release 직접 URI | `voiceon://event-detail/{eventId}` | +| debug 직접 URI | `voiceon-test://event-detail/{eventId}` | +| FCM data | `deep_link`에 전체 URI; 기존 `deepLink` 별칭도 수용 | +| 알림함 | 기존 `deepLink` 필드에 같은 URI | +| Notifly | 캠페인 클릭 URL에 같은 URI; SDK 1.12.0은 ACTION_VIEW로 전달 | +| OneLink URL | 현재 빌드의 APPLINK_HOST에 대한 HTTPS URL, `deep_link_value=event-detail`, `deep_link_sub5={eventId}` | +| AppsFlyer UDL | 콜백의 `deep_link_value=event-detail`, `deep_link_sub5={eventId}` | + +ID는 하나의 ASCII 십진수 문자열을 양수 Long으로 파싱한다. `1..9223372036854775807`을 보존하며 0/음수/비숫자/공백/overflow/추가 경로를 거부한다. direct path ID는 query의 다른 ID로 대체하지 않는다. 잘못된 이벤트 입력을 다른 도메인 라우팅으로 바꾸지 않는다. 서로 다른 환경 스킴이나 임의 외부 HTTPS host를 이벤트 링크로 수용하지 않는다. + +`EventDetailActivity.newIntent(context, eventId: Long)`만 호출하고 Parcelable 데이터나 새 상세 API는 만들지 않는다. 상세 조회의 loading/성공/조회 불가/오류는 기존 화면 책임이다. + +## 4. 기능 요구사항 +| ID | 상태 | 요구사항·수용 기준 | +|---|---|---| +| EDL-001 | 확정 | 허용 URI/OneLink/UDL의 양수 Long을 동일한 상세 진입점에 연결한다. 누락·무효 입력은 상세를 열지 않는다. | +| EDL-002 | 확정 | foreground와 Splash를 거치는 cold/background, MainV2 새 Intent에서 동일 이벤트를 처리한다. FCM 두 URL key를 이벤트 경계에서 정규화한다. | +| EDL-003 | 확정 | 이벤트만 비로그인 진입 가능하다. 기존 다른 도메인 로그인/성인 가드, 자체 FCM 수신의 토큰 조건은 변경하지 않는다. | +| EDL-004 | 확정 | AppsFlyer listener를 start 전에 등록하고 기존 마케팅 PID/UTM 저장·Firebase 추적을 유지한다. | +| EDL-005 | 확정 | Activity 준비 전 또는 준비 후 늦게 도착한 UDL을 처리한다. 백그라운드에서 강제로 Activity를 띄우거나 종료된 Activity 참조를 유지하지 않는다. | +| EDL-006 | 확정 | 같은 이벤트 OneLink의 URI+UDL은 UDL만 이동을 소유하여 이중 실행하지 않는다. Intent 재생성·handoff는 단회 처리한다. 새로운 명시적 동일 이벤트 진입과 새 UDL 전달은 허용하며 영구 eventId 차단/임의 TTL은 사용하지 않는다. | +| EDL-007 | 확정 | 라이브룸의 기존 이동 확인을 거친다. 오디오 알림·gift·DM·콘텐츠·채널 등의 기존 라우팅 우선순위와 정책은 유지한다. | +| EDL-008 | 확정 | 기존 Manifest 공개 라우터를 사용하고 상세 Activity의 exported=false를 유지한다. 필요한 최소 경계만 변경한다. | +| EDL-009 | 확정 | 이벤트도 기존 Bundle 정규화·목적지 dispatcher에서 실행한다. handleEventEntry/handleEventDeepLink의 별도 선행 실행은 제거하고, AppsFlyer helper는 입력 대기·전달만 담당한다. | + +## 5. 포함·제외 및 승인 +- 신규 helper·상태·테스트는 `kr.co.vividnext.sodalive.v2.event` 하위에 작성한다. +- 사용자 승인: `main/DeepLinkActivity.kt`, `app/SodaLiveApp.kt`를 이벤트 연결 및 AppsFlyer 초기화 순서 보정에 한해 최소 수정한다. +- MainV2의 이벤트 연결, 필요하면 v2 이벤트 상세의 lifecycle 연결은 이번 범위다. 이벤트 API·표시 UI는 바꾸지 않는다. +- Manifest/FCM 서비스/Splash/알림함/LiveRoomActivity/공통 인증 저장소/기존 OneLink 공유 함수의 전면 수정은 하지 않는다. +- AppsFlyer SDK 업그레이드·대시보드 변경·신규 SDK/의존성·다른 도메인의 UDL 복구·기기 UI/계측 테스트는 제외한다. +- 사용자 지시대로 현재 main 브랜치에 직접 작업한다. worktree/새 브랜치/커밋/푸시는 만들지 않는다. +- 사용자 지시대로 실서버 연결 테스트와 실제 푸시 발송은 하지 않는다. 로컬 fake/fixture 및 Robolectric 라우팅 테스트만 사용한다. + +## 6. 검증 시나리오 +1. 정상: 직접 URI, 두 FCM URL key, OneLink query, UDL direct/deferred의 유효 ID가 기존 상세를 연다. release/debug 설정을 각각 지킨다. +2. 경계: 잘못된 ID·외부 scheme/host·경로/query 충돌·중복 alias를 거부하고 Int 범위 초과/Long.MAX_VALUE를 보존한다. +3. 비동기: 콜백 선도착·후도착, 준비 전 여러 입력, background→foreground, Activity 재생성/종료, URI/UDL 양쪽 순서, 사용자의 같은 ID 재클릭을 검증한다. +4. 인접 회귀: 비로그인 이벤트와 비이벤트 가드, 라이브룸 확인·취소, 오디오 알림·gift 단회 소비·기존 푸시 extras 및 마케팅 저장을 확인한다. + +## 7. 외부 의존과 검증 한계 +- AppsFlyer 대시보드의 OneLink template, SHA-256, fallback, 실제 캠페인 설정은 로컬 코드로 입증하지 않는다. +- SDK가 두 콜백에 동일한 클릭 식별자를 보장하지 않는 경우 중복 방지의 정확한 소유 범위와 한계를 구현 계획에 명시한다. 추측한 provider field를 도입하지 않는다. +- 키·토큰·서명 정보·SDK payload 전체를 로그나 문서에 기록하지 않는다. + +## 8. 전달 소유권과 생명주기 +- 커스텀 이벤트 URI는 Intent가 소유한다. 이벤트 OneLink URI는 앱 bootstrap만 수행하고 상세 이동은 유효한 UDL 콜백이 소유한다. SDK 실패 시 URL만으로 상세 이동하는 자동 fallback은 추가하지 않는다. +- Application 소유 event helper는 main thread에서 process-local FIFO를 관리하고 resumed Activity를 weak reference로만 참조한다. Splash·DeepLink trampoline 및 초기 라우팅이 완료되지 않은 Main에서는 대기한다. +- 콜백 도착과 Activity resume 모두 대기 전달을 확인한다. 현재 Activity가 종료/일시정지됐으면 실행하지 않는다. background에서 강제 startActivity하지 않는다. +- UDL은 현재 resumed Activity를 통해 명시적 DeepLinkActivity Intent로 넘겨 기존 라이브룸 확인을 재사용한다. 전달 후 큐에서 제거하며 사용자가 확인을 취소해도 재전달하지 않는다. +- 각 Intent 진입의 로컬 token과 전달/소비 상태를 handoff Bundle 및 savedInstanceState에 보존한다. 이는 동일 entry 재생성 방지용이지 provider 클릭 identity가 아니다. +- 새로운 SDK 콜백은 새로운 전달로 취급한다. provider가 같은 클릭을 중복 callback으로 전달한 경우와 실제 동일 ID 재클릭을 입력 필드만으로 구분할 수 없으며, 이 경우 새 클릭 보존을 우선한다. 커스텀 URI가 별도 event UDL echo까지 일으키는 비표준 발송 조합의 완전 중복 제거는 보장하지 않는다. +- 프로세스 종료 후 별도 영구 navigation queue는 복구하지 않는다. 복원된 launch Intent/saved state 또는 새 SDK callback을 사용한다. 마케팅 preference를 navigation queue로 읽지 않는다. + +## Decision Log +| 날짜 | ID | 결정·근거 | +|---|---|---| +| 2026-10-29 | EDEC-001 | 별도 작업으로 PRD/계획 생성. 기존 이벤트 API 작업과 구분한다. | +| 2026-10-29 | EDEC-002 | 사용자 요청으로 AppsFlyer도 동일 이벤트 상세에 연결한다. | +| 2026-10-29 | EDEC-003 | 사용자 승인으로 DeepLinkActivity/SodaLiveApp의 최소 연결·등록 순서 변경 허용. | +| 2026-10-29 | EDEC-004 | 단일 event-detail 계약, guest 이벤트만 허용, 공통 다른 라우팅·추적은 보존한다. | +| 2026-10-29 | EDEC-005 | Oracle 설계 검토에 따라 custom URI/OneLink UDL 소유권 분리. 제공되지 않은 click ID나 시간 기반 중복 차단을 만들지 않는다. OneLink는 SDK 전달 성공에 의존한다. | +| 2026-10-29 | EDEC-006 | 사용자 요청으로 기존 공통 라우팅 확장 + AppsFlyer 입력 어댑터 방향으로 후속 리팩터링한다. Phase1의 별도 이벤트 실행 분기는 공통 dispatcher 내부 이벤트 목적지로 대체한다. EDEC-005 소유권·비동기 전달·외부 입력 계약은 유지한다. | + +## 완료 기준 +- [x] EDL-001~008의 로컬 테스트 및 회귀 통과 +- [x] 전체 unit suite·main/test ktlint·debug 빌드 검증 및 한계 기록 +- [x] 최종 리뷰 승인: [phase1-event-deeplink-appsflyer-review.md](reviews/phase1-event-deeplink-appsflyer-review.md) +- [x] 소유 임시 자원 정리 + +## Phase2 추가 완료 기준 +- [x] DeepLinkActivity.routeForegroundDeepLink와 MainV2Activity.executeBundleRoute에서 이벤트 목적지를 처리하고, 별도 이벤트 실행 우회 함수가 없다. +- [x] 이벤트 ID/URL은 입력 정규화에서 검증하며 raw event_id·외부 URL·SDK 소유 입력이 실행 가능한 이벤트로 승격되지 않는다. +- [x] 비로그인 정책·단회 소비·새 same-ID 클릭·late UDL·기존 도메인 회귀를 보존한다. +- [x] 전체 로컬 검증·Phase2 리뷰·이번 단계 임시 자원 정리 완료. + +Task2.1 로컬 증거: 기존156개 + 정규화/공통 dispatcher 신규14개 = **170개 통과**, main/test ktlint 통과. 정확한 interface·RED/GREEN·실행 명령·임시 로그 위치는 [계획 Task2.1 검증](plan-task.md)에 기록했다. 전체 suite/build/Phase2 리뷰와 최종 자원 정리는 parent Task2.2에서 수행한다. + +Task2.2 최종 증거: 전체1736개 통과·lint 위반0·debug 빌드 성공. [Phase2 코드 리뷰](reviews/phase2-common-event-routing-review.md) APPROVE. 실서버와 기기 UI는 제외했으며 중간 인증 테스트 실패/worker 중단 기록과 검증 한계는 계획·리뷰에 보존한다.