docs(deeplink): 커뮤니티 상세 이동 검증을 기록한다

2026-10-13 13:58:04 +09:00
parent 4b5fa133f5
commit c3b0d6e3f4
3 changed files with 194 additions and 0 deletions
@@ -0,0 +1,43 @@
+# 커뮤니티 상세 딥링크 리뷰
+
+## 1. 리뷰 정보
+| 항목 | 내용 |
+|---|---|
+| 대상 | Phase 1 / 현재 브랜치 working tree |
+| 일자 | 2026-10-13 |
+| 리뷰어 | 독립 읽기 전용 에이전트, Sisyphus 검증 |
+| 기준 | [PRD](../prd.md), [계획](../plan-task.md) |
+| 상태 | 코드 리뷰 승인, 실제 UI 확인 제한 기록 |
+
+## 2. 목적과 범위
+공통 `AppDeepLinkHandler.swift`와 `work/tests/AppDeepLinkGiftDetailCheck.swift`의 변경, 기존 AppDelegate/알림 목록/Splash/AppStep/ContentView/상세 조회 연결을 검토했다. UI 디자인·API 계약·인증 정책 변경은 제외한다.
+
+## 3. 판정 기준
+정상 postId는 해당 상세 route에 전달되고, 누락·무효 postId는 현재 route와 pending action을 바꾸지 않아야 한다. 사용자 ID와 진입점에 따른 오동작 또는 기존 선물/콘텐츠 회귀는 차단 결함이다.
+
+## 4. 검토 근거와 검증
+- CD-001/003: community action은 postId만 보유한다. 기존 ContentView가 이를 상세 화면에 전달하고 ViewModel은 해당 postId로 기존 API를 호출한다.
+- CD-002: 양수 Int 검증과 명시적 community 경로 fallback 차단을 확인했다. main/splash에서 현재 route와 기존 pending action 보존 검사가 통과했다.
+- CD-004: 외부 URL/푸시/알림 목록이 같은 handler를 사용하며 스플래시 재적용도 동일 action을 사용한다.
+- CD-005: 기존 선물/콘텐츠 assertion 22개를 유지했다.
+
+| 검증 | 결과 |
+|---|---|
+| 리뷰어의 딥링크 하네스 재실행 | PASS, 279 assertions |
+| 전체 `work/tests/check-*.sh` | 모두 PASS |
+| Swift 구문 검사 및 `git diff --check` | PASS |
+| SodaLive-dev Debug 시뮬레이터 빌드 | BUILD SUCCEEDED |
+| Xcode test action | 스킴에 test action이 구성되지 않아 실행 불가 |
+| 실제 앱 설치/딥링크 실행 | 시도 완료, 첫 실행 추적 허용 팝업으로 상세 표시 확인 제한 |
+
+## 5. 발견 사항 요약
+확정 발견 사항 없음. 코드 리뷰는 승인한다. 실제 API 응답·게시물 표시·푸시 탭 E2E 검증은 하네스와 별개이며 완료로 판단하지 않는다.
+
+## 6. 발견 사항 상세
+차단 결함 없음. 개발 앱 수동 QA scheme은 `voiceon-test`, 운영 앱은 `voiceon`이다. 이 차이는 계획의 QA 명령에 반영했다.
+
+## 7. plan·goal 전환
+확정 결함이 없어 전환 항목 없음.
+
+## 8. 종료 판정
+요청 범위 코드와 테스트는 승인한다. 실제 UI 확인 제한 및 실행 증거는 [계획 Progress](../plan-task.md)에 기록했다. 추가 리팩터링 없이 종료한다.