From b5c49c22c5c8d87e652a5c6850047eb953966444 Mon Sep 17 00:00:00 2001 From: klaus Date: Thu, 29 Oct 2026 11:47:20 +0900 Subject: [PATCH] =?UTF-8?q?feat(event):=20=EC=B0=B8=EC=97=AC=20=EB=A7=81?= =?UTF-8?q?=ED=81=AC=20=EA=B2=80=EC=A6=9D=EA=B3=BC=20=EC=95=88=EC=A0=84?= =?UTF-8?q?=ED=95=9C=20=EC=8B=A4=ED=96=89=EC=9D=84=20=EC=B6=94=EA=B0=80?= =?UTF-8?q?=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../v2/event/EventDetailLinkPolicy.kt | 40 ++++++++ .../v2/event/EventDetailLinkPolicyTest.kt | 97 +++++++++++++++++++ .../reviews/phase1-event-detail-api-review.md | 53 ++++++++++ 3 files changed, 190 insertions(+) create mode 100644 app/src/main/java/kr/co/vividnext/sodalive/v2/event/EventDetailLinkPolicy.kt create mode 100644 app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDetailLinkPolicyTest.kt create mode 100644 docs/20261029_이벤트_상세_API_연동/reviews/phase1-event-detail-api-review.md diff --git a/app/src/main/java/kr/co/vividnext/sodalive/v2/event/EventDetailLinkPolicy.kt b/app/src/main/java/kr/co/vividnext/sodalive/v2/event/EventDetailLinkPolicy.kt new file mode 100644 index 00000000..84a3152d --- /dev/null +++ b/app/src/main/java/kr/co/vividnext/sodalive/v2/event/EventDetailLinkPolicy.kt @@ -0,0 +1,40 @@ +package kr.co.vividnext.sodalive.v2.event + +import android.content.ActivityNotFoundException +import android.content.Context +import android.content.Intent +import android.net.Uri +import kr.co.vividnext.sodalive.BuildConfig +import java.net.URI +import java.net.URISyntaxException +import java.util.Locale + +object EventDetailLinkPolicy { + fun toIntent(link: String?): Intent? { + val value = link?.trim()?.takeIf { it.isNotBlank() } ?: return null + val uri = try { + URI(value) + } catch (_: URISyntaxException) { + return null + } + val scheme = uri.scheme?.lowercase(Locale.ROOT) ?: return null + when (scheme) { + "http", "https" -> if (uri.host.isNullOrBlank()) return null + BuildConfig.APPSCHEME -> Unit + else -> return null + } + return Intent(Intent.ACTION_VIEW, Uri.parse(value).normalizeScheme()) + } + + fun launch(context: Context, link: String?): Boolean { + val intent = toIntent(link) ?: return false + return try { + context.startActivity(intent) + true + } catch (_: ActivityNotFoundException) { + false + } catch (_: SecurityException) { + false + } + } +} diff --git a/app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDetailLinkPolicyTest.kt b/app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDetailLinkPolicyTest.kt new file mode 100644 index 00000000..938b860f --- /dev/null +++ b/app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDetailLinkPolicyTest.kt @@ -0,0 +1,97 @@ +package kr.co.vividnext.sodalive.v2.event + +import android.app.Application +import android.content.ActivityNotFoundException +import android.content.Context +import android.content.ContextWrapper +import android.content.Intent +import androidx.test.core.app.ApplicationProvider +import kr.co.vividnext.sodalive.BuildConfig +import org.junit.Assert.assertEquals +import org.junit.Assert.assertFalse +import org.junit.Assert.assertNull +import org.junit.Assert.assertTrue +import org.junit.Test +import org.junit.runner.RunWith +import org.robolectric.RobolectricTestRunner +import org.robolectric.annotation.Config + +@RunWith(RobolectricTestRunner::class) +@Config(sdk = [28], application = Application::class) +class EventDetailLinkPolicyTest { + @Test + fun `웹과 앱 scheme만 정규화한 ACTION_VIEW Intent로 변환한다`() { + listOf( + " https://example.com/events/7?q=a%20b#join " to "https://example.com/events/7?q=a%20b#join", + "HTTP://example.com/path" to "http://example.com/path", + "${BuildConfig.APPSCHEME}://creator/7" to "${BuildConfig.APPSCHEME}://creator/7" + ).forEach { (link, expected) -> + val intent = EventDetailLinkPolicy.toIntent(link) + assertEquals(Intent.ACTION_VIEW, intent?.action) + assertEquals(expected, intent?.dataString) + assertNull(intent?.extras) + } + } + + @Test + fun `누락과 빈 링크 및 임의 scheme은 거부한다`() { + listOf( + null, + "", + " ", + "example.com", + "//example.com", + "javascript:alert(1)", + "intent://event#Intent;end", + "file:///tmp/event", + "content://event/1", + "tel:123", + "ftp://example.com" + ) + .forEach { assertNull(it, EventDetailLinkPolicy.toIntent(it)) } + } + + @Test + fun `host 없는 웹과 잘못된 URI는 거부한다`() { + listOf( + "https:", + "http:/path", + "https:///path", + "https://", + "https://?q=1", + "https://exa mple.com", + "https://example.com/%zz", + "https://[bad", + "https://example.com:bad", + "https://example.com/\npath" + ) + .forEach { assertNull(it, EventDetailLinkPolicy.toIntent(it)) } + } + + @Test + fun `허용 링크는 한 번 실행하고 차단 링크는 실행하지 않는다`() { + val context = LaunchContext(ApplicationProvider.getApplicationContext()) + assertTrue(EventDetailLinkPolicy.launch(context, "https://example.com/join")) + assertEquals(listOf("https://example.com/join"), context.started.map { it.dataString }) + assertFalse(EventDetailLinkPolicy.launch(context, "javascript:alert(1)")) + assertEquals(1, context.started.size) + } + + @Test + fun `처리 앱이 없거나 실행 권한이 없으면 예외 대신 실패를 반환한다`() { + listOf(ActivityNotFoundException("내부 정보"), SecurityException("내부 정보")).forEach { failure -> + val context = LaunchContext(ApplicationProvider.getApplicationContext(), failure) + assertFalse(EventDetailLinkPolicy.launch(context, "https://example.com/join")) + assertEquals(1, context.started.size) + } + } + + private class LaunchContext(base: Context, private val failure: RuntimeException? = null) : ContextWrapper(base) { + val started = mutableListOf() + + override fun startActivity(intent: Intent) { + started += intent + failure?.let { throw it } + } + } +} diff --git a/docs/20261029_이벤트_상세_API_연동/reviews/phase1-event-detail-api-review.md b/docs/20261029_이벤트_상세_API_연동/reviews/phase1-event-detail-api-review.md new file mode 100644 index 00000000..1dd2197b --- /dev/null +++ b/docs/20261029_이벤트_상세_API_연동/reviews/phase1-event-detail-api-review.md @@ -0,0 +1,53 @@ +# 이벤트 상세 API 연동 리뷰 + +## 1. 리뷰 정보 +| 항목 | 내용 | +|---|---| +| 리뷰 대상 | Phase 1 / Task 1.1~1.3 | +| 기준 | 현재 main 작업 트리의 HEAD 대비 staged + unstaged 변경 | +| 리뷰 일자 | 2026-10-29 | +| 리뷰어 | Oracle, 세션 ses_e7a87efd4ffefVOISxOmSYNlKu | +| 기준 문서 | [prd.md](../prd.md), [plan-task.md](../plan-task.md) | +| 상태 | 판정 완료 | + +## 2. 목적과 범위 +- 신규 `v2/event` 데이터·상태·화면·링크 정책과 로컬 테스트를 EVT-001~008에 대조했다. +- 기존 상세 Activity의 ID bridge, AppDI 등록, 비공개 manifest 등록을 검토했다. +- 기존 6개 호출부와 공통 BaseActivity/BaseViewModel, Retrofit/인증자 연결을 읽기 전용으로 추적했다. +- 실서버 연결은 사용자 지시로 제외했다. 기기 UI·스크린샷·LSP 실행 및 공통 저장소 리팩터링도 검토 실행 범위 밖이다. + +## 3. 판정 기준 +요구사항 위반, 핵심 흐름 불능, 기존 호출 계약 회귀, 임의 URL scheme 실행, 잘못된 응답의 성공 처리, lifecycle 누수 및 검증되지 않은 완료 주장을 차단 기준으로 삼았다. + +## 4. 검토 근거 +| 요구사항 | 코드·테스트 근거 | 판정 | +|---|---|---| +| EVT-001 | legacy `EventDetailActivity` ID 전달·종료, 신규 `newIntent`, NavigationTest Long/잘못된 extra/bridge | 충족 | +| EVT-002~005 | EventDetailApi/Repository/ViewModel, ApiTest와 ViewModelTest의 GET·헤더·단일 객체·success/data·HTTP 오류 | 충족 | +| EVT-006~007 | 서버 URL 직접 이미지 요청, 참여 클릭, LinkPolicy scheme/URI 검증과 launch failure, NavigationTest | 충족 | +| EVT-008 | Koin Activity ViewModel, 초기 중복 가드, BaseViewModel dispose, dialog onDestroy 정리 및 재생성 테스트 | 충족 | + +### 실행 환경과 증거 +- macOS, OpenJDK 17.0.15, Gradle 8.14.3. +- 리뷰어는 테스트를 재실행하지 않고 코드와 기존 test XML/HTML 증거를 확인했다. +- 상위 작업자가 포맷 보정 후 `./gradlew :app:ktlintMainSourceSetCheck :app:ktlintTestSourceSetCheck :app:testDebugUnitTest :app:assembleDebug --console=plain`을 실제 실행했다: BUILD SUCCESSFUL (3분 18초). +- 전체 unit suite: 1693개, 실패 0, ignored 0. 신규 이벤트 51개 및 기존 배너 회귀 100개 포함. +- main/test ktlint report: 위반 0. `git diff HEAD --check`: exit 0. +- APK: `app/build/outputs/apk/debug/app-debug.apk`. +- 결과: `app/build/reports/tests/testDebugUnitTest/index.html`, `app/build/test-results/testDebugUnitTest/TEST-kr.co.vividnext.sodalive.v2.event.*.xml`. + +## 5. 발견 사항 +**확정 발견 사항 없음.** 추가 기능 수정이나 회귀 수정 Task로 전환할 항목이 없다. + +API 테스트는 실제 Retrofit/Gson 요청 생성·역직렬화를 사용하고, 화면 로직 테스트는 API와 이미지 전송을 대체한다. 토큰 재시도 테스트는 공통 비동기 저장소가 아닌 token getter 입력을 MockK로 격리하고 기존 기대값을 유지했다. 운영 토큰 저장소의 동작을 수정하거나 검증 완료로 주장하지 않는다. + +## 6. 검증 한계 +- 운영 DI 전체와 실제 401 인증 전환은 종단 실행하지 않았다. 기존 공통 클라이언트와 TokenAuthenticator 연결을 코드로 확인했다. +- 실서버 적합성·실제 기기 화면·LSP 진단 완료를 주장하지 않는다. 실서버 테스트는 서버 동시 개발 때문에 사용자 지시로 의도적으로 제외했다. +- 후속 이벤트 상세 딥링크 파서/등록은 이번 범위가 아니며 ID-only 진입점만 준비했다. + +## 7. plan·goal 전환 +회귀 수정 Task 전환 항목 없음. Task1.3은 리뷰 전 일반 lint 검증에서 발견한 포맷 보정이며 이미 완료했다. + +## 8. 종료 판정 +**APPROVE: 허용된 로컬 계약·코드 검토 범위에서 승인.** 검토 범위와 수용 기준을 확인했고, 차단 결함이 없다. 남은 필수 코드 수정 없음.