docs(event): 상세 API 요구사항과 검증 결과를 기록한다
This commit is contained in:
@@ -0,0 +1,166 @@
|
||||
# 이벤트 상세 API 연동 구현 계획
|
||||
|
||||
> 실행: 승인된 최소 범위에서 Task 순서대로 TDD 구현한다. 현재 작업 트리를 유지하고 자동 커밋·푸시는 하지 않는다.
|
||||
|
||||
**Goal:** 기존 목록·배너·팝업에서 이벤트 ID로 최신 상세를 조회하고 조회 불가 시 이전 화면으로 돌아간다.
|
||||
**Architecture:** 기존 상세 Activity는 ID 전달 연결부로 남기고 `v2.event`의 ID-only 상세가 API → Repository → ViewModel → Activity 흐름으로 처리한다. 기존 Retrofit, ApiResponse, Koin, 화면 리소스를 재사용한다.
|
||||
**Tech Stack:** Kotlin, Android XML/ViewBinding, RxJava3, Retrofit/Gson, Koin, JUnit4/Robolectric.
|
||||
**Spec:** [prd.md](prd.md)
|
||||
|
||||
| 항목 | 내용 |
|
||||
|---|---|
|
||||
| 상태 | 구현 완료 |
|
||||
| 작성일 | 2026-10-29 |
|
||||
| 현재 Phase | 1 상세 조회 연결 |
|
||||
| 승인 | 레거시 EventDetailActivity 최소 연결 수정 |
|
||||
|
||||
## Global Constraints
|
||||
- 신규 코드는 `kr.co.vividnext.sodalive.v2.event`; 기존 호출부/목록 모델/공통 인증 동작은 유지한다.
|
||||
- 신규 의존성·딥링크 등록·화면 재디자인·기기 UI 조작 없음.
|
||||
- `success=false`는 종료, transport/HTTP error는 별도 오류 상태. 원문 예외/토큰 로그 없음.
|
||||
- 테스트는 `app/src/test`의 한글 backtick 메서드; 레이아웃 속성 검증 없음.
|
||||
- 구현 전에 실패 테스트를 실행하고 실제 결과를 아래 누적 기록한다.
|
||||
|
||||
## Review Focus
|
||||
- ID가 Long.MAX_VALUE일 때 손실 없음; 필수 필드 누락/다른 ID를 Content로 처리하지 않음.
|
||||
- 서버가 link만 반환하거나 잘못된 scheme을 반환해도 정상 조회 판정과 안전한 이동을 분리함.
|
||||
- 기존 연결 Activity가 back stack에 남아 조회 불가 복귀 시 재조회 루프를 만들지 않음.
|
||||
- 화면 재생성/종료 시 중복 요청·dialog 누수·늦은 응답 실행 없음.
|
||||
- 401/404/500의 본문이 JSON이 아니어도 공통 오류 경로 유지.
|
||||
|
||||
## Phase 1
|
||||
**결과:** 기존 진입 및 ID-only 진입에서 상세 API가 연결된다.
|
||||
**시작 조건:** 사용자 API 계약과 DEC-001~003, 레거시 최소 수정 승인 완료.
|
||||
|
||||
#### Task 1.1 API·상태 로직
|
||||
**Files:**
|
||||
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/event/data/EventDetailApi.kt`
|
||||
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/event/data/EventDetailResponse.kt`
|
||||
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/event/data/EventDetailRepository.kt`
|
||||
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/event/EventDetailViewModel.kt`
|
||||
- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDetailApiTest.kt`
|
||||
- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDetailViewModelTest.kt`
|
||||
|
||||
**Interfaces:** `getEventDetail(id: Long, authHeader: String?): Single<ApiResponse<EventDetailResponse>>`; `loadInitial(eventId: Long)`, `retry()`, `state: LiveData<EventDetailUiState>`.
|
||||
**완료 증거:** EVT-002~005,008의 요청·역직렬화·상태·구독 해제 테스트.
|
||||
**범위 밖:** Activity 렌더링/라우팅.
|
||||
|
||||
- [x] **RED:** 정확한 GET/헤더/객체 DTO, Loading→Content, Unavailable, null/무효 data, HTTP/IO 오류, 재시도/구독 해제 실패 테스트 작성.
|
||||
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --console=plain` 실행 후 구현 부재 실패 확인.
|
||||
- [x] **GREEN:** 공통 클라이언트를 소비하는 최소 API/repository/ViewModel 구현.
|
||||
- [x] **GREEN 확인:** 동일 focused test 통과.
|
||||
- [x] **REFACTOR:** 이번 코드 중복만 정리하고 회귀 결과 기록.
|
||||
|
||||
**Task 1.1 검증 기록 — 2026-10-29:**
|
||||
- 실행 전 `./gradlew --status --console=plain`: Gradle 8.14.3 daemon 82224가 IDLE임을 확인했다. 다른 테스트와 병렬 실행하지 않았다.
|
||||
- RED: `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --console=plain` → `:app:compileDebugUnitTestKotlin FAILED`, `BUILD FAILED in 47s`. `EventDetailApi`, `EventDetailRepository`, `EventDetailResponse`, `EventDetailViewModel`, `EventDetailUiState` 구현 부재에 따른 unresolved reference다. 테스트 실행/assertion 실패와 구분하며, 이 실행에서 테스트 본문은 실행되지 않았다.
|
||||
- RED 로그: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/event-detail.JUOfAB/data.TcunSn/task1.1-red.log`.
|
||||
- GREEN: 같은 `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --console=plain` → `BUILD SUCCESSFUL in 1m 41s`. 결과 XML 기준 `EventDetailApiTest` 12개 + `EventDetailViewModelTest` 17개 = 29개 통과, 실패·오류·건너뜀 각각 0개. production/test Kotlin compilation도 통과했다.
|
||||
- 로컬 요청 surface: 실제 Retrofit/Gson/OkHttp interceptor로 GET 경로, query/body 없음, nullable Authorization, Int 초과 및 Long.MAX_VALUE, 단일 data/배열 거부, 필수 필드 누락·null, 문자열 원문, 선택 필드 null, 비JSON 200 및 401/404/500 오류 전달을 실행 검증했다. 운영 API는 호출하지 않았다.
|
||||
- 상태 surface: fake API/Robolectric으로 Loading→Content, 명시적 실패→Unavailable(서버 메시지 원문), null/다른 ID/필수 썸네일 null→Error, IO/HTTP/역직렬화 오류→Error, 잘못된 진입 ID의 무요청, 최초 중복/로딩 중 retry 차단, 최신 토큰으로 같은 ID 재시도, ViewModelStore 종료→BaseViewModel dispose 및 늦은 응답 무시를 검증했다. 빈 필수 문자열과 nullable 선택 필드는 정상 Content다.
|
||||
- 구현 결정/인계: 필수 wire 필드 `id: Long?`, `thumbnailImageUrl: String?`는 누락을 감지하도록 nullable로 받고 ViewModel이 Content 이전에 요청 ID 일치 및 썸네일 nonnull을 확인한다. 개별 JSON adapter는 추가하지 않았다. 상태는 `Loading`, `Content(detail)`, `Unavailable(message: String?)`, 메시지 없는 단일 `Error`다. 화면은 Unavailable에서 복귀하고 Error에서 공통 안내/재시도를 연결한다.
|
||||
- REFACTOR: 요청/상태 분기가 한 곳에 모인 최소 구현으로 유지했다. 추가 추상화나 다른 파일 정리는 하지 않았으며 focused 회귀 29개 통과 결과를 유지했다.
|
||||
- 실행 환경: 모든 셸 명령에서 `TMPDIR=/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/event-detail.JUOfAB/data.TcunSn`, `NODE_COMPILE_CACHE=$TMPDIR/node-compile-cache`, `BUN_RUNTIME_TRANSPILER_CACHE_PATH=$TMPDIR/bun-transpiler`를 export했다. GREEN 로그는 같은 임시 루트의 `task1.1-green.log`, 결과 XML은 `app/build/test-results/testDebugUnitTest/TEST-kr.co.vividnext.sodalive.v2.event.EventDetailApiTest.xml` 및 `TEST-kr.co.vividnext.sodalive.v2.event.EventDetailViewModelTest.xml`이다. 임시 루트에는 RED/GREEN 로그 2개만 있으며 상위 작업자의 증거 확인 후 정리 대상으로 남겼다. 공유 캐시는 삭제하지 않았다.
|
||||
- 경고/한계: Gradle 9.0 호환성 deprecation 안내가 있었다. 일반 JVM API 테스트 XML stderr에는 OkHttp Android platform 탐지 중 `android.util.Log.isLoggable not mocked` 안내가 있으나 테스트 실패/오류는 0개다. ViewModel 테스트 stderr는 비어 있다. LSP 도구는 제공되지 않아 실행하지 못했으며 Kotlin compilation 결과로 한정한다. 요청 범위에 따라 전체 suite/assemble/lint/기기 UI는 실행하지 않았다. Activity·레이아웃·DI·manifest·레거시는 수정하지 않았고 Task 1.2 및 Phase Gate는 미완료로 유지한다.
|
||||
|
||||
#### Task 1.2 화면·호환 진입 연결
|
||||
**Files:**
|
||||
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/event/EventDetailActivity.kt`
|
||||
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/event/EventDetailLinkPolicy.kt` (서버 링크의 허용 여부·Intent 변환 로직)
|
||||
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/settings/event/EventDetailActivity.kt` (ID 추출·전달·종료만)
|
||||
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt` (API/repository/ViewModel 등록만)
|
||||
- Modify: `app/src/main/AndroidManifest.xml` (신규 비공개 Activity 등록만)
|
||||
- Reuse unchanged: `app/src/main/res/layout/activity_event_detail.xml`, 기존 loading/modal/문구
|
||||
- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDetailNavigationTest.kt`
|
||||
- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/event/EventDetailLinkPolicyTest.kt`
|
||||
- Modify: `docs/agent-guides/build-test-style.md` (focused 명령 예시)
|
||||
|
||||
**Interfaces:** `EventDetailActivity.newIntent(context: Context, eventId: Long): Intent`; Parcelable은 legacy bridge에서만 읽는다. 링크 정책은 기존 배너의 scheme 정책을 따르되 이벤트 자체의 성공 여부와 분리한다.
|
||||
`EventDetailLinkPolicy.toIntent(link: String?): Intent?`, `launch(context: Context, link: String?): Boolean`으로 허용 여부와 실행 실패를 검증한다. Context는 저장하지 않으며 실행 실패는 Activity의 공통 오류 토스트로 안내한다. 별도 presenter/helper는 추가하지 않는다.
|
||||
**완료 증거:** EVT-001,006~008의 ID-only/호환 진입/종료 및 링크 정책 로컬 검증; 빌드 성공.
|
||||
**범위 밖:** 기존 목록의 링크 직접 열기 분기, 딥링크 파서/등록.
|
||||
|
||||
- [x] **RED:** ID-only Intent, 기존 Parcelable의 ID 전달/종료, 안전/거부 URL, launch failure의 로직 테스트 작성.
|
||||
- [x] **RED 확인:** focused test로 요구 동작 부재 확인.
|
||||
- [x] **GREEN:** 기존 화면 리소스를 재사용해 Loading/Content/Unavailable/Error 렌더링; error 재시도와 lifecycle 정리; bridge와 DI/manifest 연결.
|
||||
- [x] **GREEN 확인:** focused 및 기존 홈/콘텐츠 배너 라우팅 회귀 통과.
|
||||
- [x] **통합 테스트 격리:** `EventDetailViewModelTest`의 토큰 getter만 기존 MockK로 제어해 비동기 DataStore observer 경쟁을 제거한다. Task 1.1 운영 코드는 변경하지 않으며 최초/비로그인/최신 토큰 재시도 기대값은 유지한다.
|
||||
- [x] **REFACTOR:** 범위 내 중복만 정리하고 문서 갱신.
|
||||
|
||||
**Task 1.2 검증 기록 — 2026-10-29:**
|
||||
- 승인된 Task 1.2만 실행한다. Task 1.1의 상태 계약을 그대로 소비하고 전체 suite/assemble/최종 리뷰는 상위 작업자가 수행한다. 기존 XML·toolbar·LoadingDialog·V2ModalDialog·테마·색상·간격 리소스를 확인했으며 신규 시각 토큰/레이아웃/컴포넌트를 만들지 않는다.
|
||||
- RED: `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --tests '*HomeMainFragmentLayoutTest' --tests '*ContentMainFragmentSourceTest' --console=plain` → `:app:compileDebugUnitTestKotlin FAILED`, `BUILD FAILED in 17s`. 신규 Activity/LinkPolicy 구현 부재에 따른 unresolved reference이며 assertion 실패가 아니다. 테스트 본문 실행 0개. 로그: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/event-detail.JUOfAB/ui.54zHYx/task1.2-red.log`.
|
||||
- 통합 RED: Activity/LinkPolicy 추가 후 bridge·manifest 연결 전 같은 명령 → 150개 실행, 146개 통과, 4개 실패(`task1.2-integration-red.log`, 39초). 레거시 extra 누락 NPE, bridge의 미종료 assertion, manifest 미등록 예외로 실제 통합 부재를 확인했다. 나머지 1개는 Task 1.1 최신 토큰 재시도에서 이전 토큰이 관측된 실패다.
|
||||
- 첫 통합 확인: bridge·DI·manifest 연결 후 같은 명령 → 150개 중 149개 통과, 기존 `EventDetailViewModelTest.오류 후 재시도는 같은 ID와 최신 토큰으로 로딩을 거쳐 새 콘텐츠를 표시한다`만 실패(`task1.2-green.log`, 1분 20초). `SharedPreferenceManager.setPreference`의 즉시 메모리 갱신과 비동기 DataStore 전체 상태 observer가 경쟁할 수 있음을 코드에서 확인했다. 단독 `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.EventDetailViewModelTest' --console=plain`은 17개 통과(`task1.2-vm-isolation.log`, 11초). 통합 검증을 위해 Task 1.1 테스트의 입력 fixture만 MockK getter로 격리한다. 운영 인증·저장소·ViewModel은 범위 밖이므로 수정하지 않는다.
|
||||
- 최종 GREEN: 지정된 focused+배너 회귀 명령 → `BUILD SUCCESSFUL in 38s`, XML 기준 총 151개 통과, 실패·오류·건너뜀 각각 0개. `EventDetailApiTest` 12개, `EventDetailViewModelTest` 17개, `EventDetailLinkPolicyTest` 5개, `EventDetailNavigationTest` 17개, 기존 `HomeMainFragmentLayoutTest` 74개, `ContentMainFragmentSourceTest` 26개다. 로그: `ui.54zHYx/task1.2-green-isolated.log`.
|
||||
- 진입 surface: Robolectric에서 실제 Activity를 생성하고 Koin fake API로 Int 초과/Long.MAX_VALUE 보존, ID-only extras, 누락/0/음수/잘못된 타입의 무요청 종료, 기존 Parcelable의 ID만 전달하는 bridge와 즉시 종료, 서버 `success=false`에 따른 신규 Activity의 실제 종료를 확인했다. stale Parcelable 필드는 v2에서 무시하며 서버 이미지 request source와 클릭 링크만 사용한다.
|
||||
- 참여·오류 surface: nullable 이미지/링크·blank 링크는 정상 Content로 유지한다. link-only도 자동 이동 없이 참여 클릭으로만 ACTION_VIEW를 실행한다. URI 형식과 web host를 검사하고 http/https/앱 scheme만 허용한다. 처리 앱 없음/권한 예외는 정책의 실패 반환으로 검증했고 실제 Activity의 처리 앱 없음과 차단 scheme 클릭은 공통 오류 토스트를 확인했다. 일반 오류 modal의 공통 문구·같은 ID 재시도·닫기 종료를 클릭으로 실행했다. 원문 예외/BuildConfig 값/링크 로그는 추가하지 않았다.
|
||||
- lifecycle surface: 로딩/성공/오류에서 재생성해 같은 Koin ViewModel 유지와 최초 조회 중복 방지, 이전 로딩·오류 dialog 해제, 새 dialog 재시도, 종료 시 dialog dismiss와 구독 해제 및 늦은 응답 무실행을 확인했다. manifest의 신규 Activity 비공개 등록도 PackageManager로 검증했다.
|
||||
- 구현 결정: 정확한 신규 진입은 `fun newIntent(context: Context, eventId: Long): Intent`, 전용 `EXTRA_EVENT_ID`만 전달한다. 기존 XML은 수정하지 않았다. 참여 버튼이 있을 때 ScrollView에 기존 버튼 위 `RelativeLayout.ABOVE` 관계를 적용해 전체 이미지 접근을 보존하며 WRAP_CONTENT(-2)를 margin으로 사용하지 않는다. 기존 toolbar·폰트·색상·간격·문구·LoadingDialog·V2ModalDialog를 재사용하고 별도 presenter/레이아웃/로그인 guard/딥링크는 추가하지 않았다. AppDI는 import 3개와 공통 Retrofit 기반 API/repository/ViewModel 등록 3개만 추가했다.
|
||||
- 검증 범위·artifact: production/test Kotlin compilation이 통과했다. LSP 도구는 제공되지 않아 실행하지 못했다. 결과 XML은 `app/build/test-results/testDebugUnitTest/TEST-kr.co.vividnext.sodalive.v2.event.*.xml` 및 두 배너 회귀 클래스 XML이다. 테스트의 API는 fake이며 Coil은 메모리 interceptor로 차단했으므로 운영 API/이미지 서버 호출을 하지 않았다. 요청대로 전체 suite/assemble/lint/tasks 전체 목록/최종 리뷰/기기 UI/스크린샷은 실행하지 않았고 상위 작업자가 후속 gate를 담당한다.
|
||||
- 임시 자원: 모든 셸 명령은 `TMPDIR=/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/event-detail.JUOfAB/ui.54zHYx`, `NODE_COMPILE_CACHE=$TMPDIR/node-compile-cache`, `BUN_RUNTIME_TRANSPILER_CACHE_PATH=$TMPDIR/bun-transpiler`를 export했다. 이 임시 루트에 본 Task 로그 5개(`task1.2-red.log`, `task1.2-integration-red.log`, `task1.2-green.log`, `task1.2-vm-isolation.log`, `task1.2-green-isolated.log`)를 증거 확인 후 정리 대상으로 남겼다. 공유 캐시는 변경·삭제하지 않았다.
|
||||
- REFACTOR/범위 확인: 추가 추상화 없이 Activity와 링크 정책의 최소 구현을 유지했다. `git diff --check`는 출력 없이 통과했고 기존 `activity_event_detail.xml`, `EventItem`, 홈 배너 라우팅 소스는 diff가 없다. 기존 컴파일의 HomeFragment unchecked cast·배너 테스트 deprecated API 및 Gradle deprecation 안내는 수정하지 않았다. Task 1.1 운영 파일·기존 호출부·기존 홈/콘텐츠 테스트는 변경하지 않았다.
|
||||
- stderr 확인: 최종 `EventDetailNavigationTest` XML에 Robolectric 실행 중 `Invalid ID 0x00000000.` 안내 20줄이 있으며 실패·오류는 0개다. LinkPolicy/ViewModel XML stderr는 비어 있다. 이 리소스 안내를 없애기 위한 기존 공통 테마/레이아웃 변경은 하지 않았다. 비동기 토큰 저장소의 운영 경쟁 가능성 자체는 본 Task에서 수정한 것이 아니며 테스트 경계만 격리했다.
|
||||
|
||||
#### Task 1.3 통합 lint 포맷 보정
|
||||
**시작 조건:** 전체 unit suite 1693개 및 debug 빌드 통과 후 main/test ktlint에서 이번 변경의 포맷 위반 13건 확인.
|
||||
**Files:** `v2/event/EventDetailActivity.kt`, 테스트 `EventDetailApiTest.kt`, `EventDetailLinkPolicyTest.kt`, `EventDetailNavigationTest.kt`.
|
||||
**범위:** 줄바꿈·중괄호·테스트 JSON fixture의 표현만 보정하고 assertion/동작/기존 코드 스타일 설정은 유지한다.
|
||||
**TDD 예외 사유:** 동작 변경 없는 포맷 수정이다. 이미 실행한 ktlint 실패가 재현 증거다.
|
||||
- [x] 지적된 4개 파일만 apply_patch로 보정한다.
|
||||
- [x] main/test ktlint 재실행 성공, 전체 unit suite 및 debug 빌드 재확인.
|
||||
|
||||
**Task 1.3 검증 기록 — 2026-10-29:**
|
||||
- 네 파일의 중괄호/줄바꿈과 JSON fixture의 공백 표현만 보정했다. assertion·JSON 문자열 값·운영 동작은 변경하지 않았다.
|
||||
- `./gradlew :app:ktlintMainSourceSetCheck :app:ktlintTestSourceSetCheck :app:testDebugUnitTest :app:assembleDebug --console=plain` → BUILD SUCCESSFUL (3분 18초), 전체 1693개 통과·실패 0·ignored 0. 두 ktlint report는 빈 파일로 위반 0건이다.
|
||||
|
||||
### Phase Gate
|
||||
- [x] `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --tests '*HomeMainFragmentLayoutTest' --tests '*ContentMainFragmentSourceTest' --console=plain`
|
||||
- [x] `./gradlew :app:testDebugUnitTest --console=plain`
|
||||
- [x] `./gradlew :app:assembleDebug --console=plain`
|
||||
- [x] `./gradlew tasks --all --console=plain` (문서 명령 검증)
|
||||
- [x] 사용 가능 시 LSP 진단, 불가 시 Kotlin compilation 및 범위 lint로 대체하고 한계 명시.
|
||||
- [x] 실제 Retrofit 요청/JSON을 사용하는 로컬 surface 검증과 결과 artifact 기록. 운영 API/기기 UI는 실행하지 않는다.
|
||||
- [x] 리뷰 결과는 `reviews/phase1-event-detail-api-review.md`에 기록하고 확정 수정은 신규 회귀 Task로 추가.
|
||||
|
||||
## Progress
|
||||
### 계획 확정 — 2026-10-29
|
||||
- 기존 EventItem.id는 Long이며 상세 진입은 6곳에서 Parcelable로 연결된다.
|
||||
- 사용자 API 계약이 DTO 기준이다. 추가 서버 명세 요청은 불필요하다.
|
||||
- 최소 bridge를 승인받았으며 후속 딥링크는 ID-only 신규 Activity를 재사용한다.
|
||||
- 일반 기기 UI/스크린샷 검증은 저장소 범위상 제외. LSP 도구가 노출되어 있지 않으므로 실행 가능성을 따로 확인한다.
|
||||
|
||||
## Decision Log
|
||||
| 날짜 | ID | 결정 |
|
||||
|---|---|---|
|
||||
| 2026-10-29 | PLAN-001 | API·상태 → 화면·bridge → 회귀·빌드·리뷰 순차 실행; 공유 Gradle 산출물은 병렬 실행하지 않음 |
|
||||
| 2026-10-29 | PLAN-002 | 사용자가 승인한 최소 레거시 bridge 외 동작 변경 없음; DI/manifest는 신규 기능 등록만 |
|
||||
| 2026-10-29 | PLAN-003 | 사용자 추가 지시대로 worktree 없이 현재 main 브랜치 직접 작업, 실서버 호출은 완료 뒤에도 제외 |
|
||||
|
||||
## Verification Log
|
||||
아직 구현 검증 전이다. 실제 실행 결과를 삭제 없이 누적한다.
|
||||
|
||||
### 통합 검증 1차 — 2026-10-29
|
||||
- `./gradlew :app:testDebugUnitTest --console=plain`: BUILD SUCCESSFUL (1분 38초). HTML report 기준 1693개, 실패 0, ignored 0.
|
||||
- `./gradlew :app:assembleDebug --console=plain`: BUILD SUCCESSFUL (16초). `app/build/outputs/apk/debug/app-debug.apk` 생성 확인.
|
||||
- `./gradlew tasks --all --console=plain`: BUILD SUCCESSFUL (2초), 계획의 task 존재 확인.
|
||||
- `./gradlew :app:ktlintMainSourceSetCheck :app:ktlintTestSourceSetCheck --continue --console=plain`: 실패 (4초). 신규 Activity 2건, 신규 테스트 11건의 줄 길이/줄바꿈/중괄호 위반. Task1.3에서 보정한다. 기존 `.editorconfig` disabled_rules deprecation 경고는 범위 밖이다.
|
||||
- 실서버·기기 UI 호출 없음. LSP 도구 미제공으로 Kotlin compilation/ktlint 결과를 사용한다.
|
||||
|
||||
### 통합 검증 2차 — 2026-10-29
|
||||
- 포맷 보정 후 main/test ktlint + 전체 unit suite + debug 빌드 통합 실행 성공(3분 18초).
|
||||
- `app/build/reports/tests/testDebugUnitTest/index.html`: 1693 tests, 0 failures, 0 ignored, 100% successful.
|
||||
- `app/build/reports/ktlint/ktlintMainSourceSetCheck/ktlintMainSourceSetCheck.txt`, `ktlintTestSourceSetCheck/ktlintTestSourceSetCheck.txt`: 내용 없음(위반 0).
|
||||
- `git diff HEAD --check`: 출력 없음, exit 0. 신규 파일의 staged/unstaged 상태는 변경하지 않았다.
|
||||
- read-only 최종 리뷰 진행 중. 기존 `.editorconfig`/Gradle deprecation 경고는 변경 범위 밖이며 성공을 막지 않는다.
|
||||
|
||||
### 최종 리뷰 — 2026-10-29
|
||||
- Oracle read-only gate: APPROVE. EVT-001~008을 차단할 확정 결함 없음. 회귀 수정 Task 전환 항목 없음.
|
||||
- 보고서: [reviews/phase1-event-detail-api-review.md](reviews/phase1-event-detail-api-review.md).
|
||||
- 승인 범위는 로컬 계약·로직과 코드 통합이다. 실서버·기기 UI·운영 DI 전체의 실제 401 전환 검증은 포함하지 않는다.
|
||||
- 현재 main 브랜치에서 작업했으며 branch/worktree/commit/push는 생성·실행하지 않았다. 기존 다른 작업의 worktree 등록도 변경하지 않았다.
|
||||
|
||||
### 임시 자원 정리 — 2026-10-29
|
||||
- 작업 소유 `event-detail.JUOfAB` 아래 data/UI 로그 7개와 notepad를 삭제했다. 빈 하위 디렉터리 3개 및 run root를 `rmdir`로 제거한 뒤 `test ! -e` exit 0으로 부재 확인했다.
|
||||
- 본문에 남은 임시 로그 경로는 실행 당시 증거 위치이며 현재는 정리되었다. RED/GREEN 관찰 결과는 해당 Task 기록에 보존했고, 최신 테스트 XML/HTML·ktlint report·APK는 프로젝트 build 산출물에 남아 있다.
|
||||
- 작업이 시작한 별도 서버/기기/브라우저/컨테이너 없음. 기존 Gradle/shared 캐시와 다른 작업 자원은 삭제하지 않았다.
|
||||
@@ -0,0 +1,80 @@
|
||||
# 이벤트 상세 API 연동 PRD
|
||||
|
||||
## 문서 정보
|
||||
- 상태: 구현 완료 (로컬 계약 검증 완료, 실서버 검증 제외)
|
||||
- 작성일: 2026-10-29
|
||||
- 대상: Android 이벤트 상세 조회
|
||||
- 요구사항·승인: 사용자 제공 API 계약, 후속 상세 딥링크 고려 요청, 레거시 최소 수정 승인
|
||||
- 구현 계획: [plan-task.md](plan-task.md)
|
||||
- API 계약: 이 문서의 API 계약 절을 기준으로 한다.
|
||||
|
||||
## 목표와 범위
|
||||
이벤트 상세는 목록/배너의 오래된 Parcelable 내용을 표시하지 않고, 양수 Long 이벤트 ID로 서버의 최신 상세와 조회 가능 여부를 확인한다. 후속 딥링크도 같은 ID 전용 상세 진입점을 사용할 수 있어야 한다.
|
||||
|
||||
- 신규 상세 Activity, ViewModel, API, Repository 및 연결 코드는 `kr.co.vividnext.sodalive.v2.event`에 둔다.
|
||||
- 기존 `settings.event.EventDetailActivity`는 Parcelable에서 ID를 추출해 신규 상세로 전달하고 종료하는 연결부로만 변경한다.
|
||||
- 기존 목록·배너·팝업 호출부와 `EventItem`은 유지한다. Parcelable과 별도 ID를 중복 전달하지 않는다.
|
||||
- 공통 DI 등록과 신규 Activity manifest 등록만 추가하며 공통 네트워크/인증 동작은 변경하지 않는다.
|
||||
- 상세 화면의 기존 레이아웃과 이미지+참여 버튼 정책을 재사용한다. 상세 이미지가 null인 정상 응답도 처리한다.
|
||||
|
||||
## 제외
|
||||
- 딥링크 URL 형식·파서·intent-filter 등록은 후속 작업이다.
|
||||
- 목록 API 전환, 목록의 링크 직접 이동 정책 변경, 배너/팝업 라우팅 일괄 전환, 레거시 공통 계층 리팩터링은 하지 않는다.
|
||||
- 신규 의존성, 화면 재디자인, 실제 운영 데이터 변경, 기기·에뮬레이터 UI/계측 테스트는 포함하지 않는다.
|
||||
- 서버 동시 개발 중이므로 구현 완료 후에도 실서버 연결 테스트를 수행하지 않는다. 제공 계약 기반 로컬 fake/fixture와 Retrofit 요청·역직렬화 검증으로 한정한다(사용자 명시 지시).
|
||||
|
||||
## API 계약
|
||||
`GET {API_BASE_URL}/api/v2/events/{id}`. `id`는 필수 양수 64비트 정수. body와 query 없음. 비로그인 시 Authorization 없음, 로그인 시 `Bearer {accessToken}`. 공통 Retrofit/OkHttp/언어 헤더/TokenAuthenticator를 유지한다.
|
||||
|
||||
성공: HTTP 200, `ApiResponse` envelope의 `success=true`와 유효한 단일 `data` 객체를 함께 확인한다.
|
||||
|
||||
| 필드 | 계약 |
|
||||
|---|---|
|
||||
| id | 정수 Long; 요청 ID와 일치 |
|
||||
| thumbnailImageUrl | 문자열 필수 |
|
||||
| detailImageUrl | 문자열 또는 null |
|
||||
| popupImageUrl | 문자열 또는 null |
|
||||
| link | 문자열 또는 null |
|
||||
|
||||
제목·본문·기간·언어·성인/팝업 여부를 추정하거나 추가하지 않는다. 이미지 URL은 원문 그대로 사용한다.
|
||||
|
||||
조회 불가: HTTP 200, `success=false`, `data=null`, `message="잘못된 요청입니다."`, `errorProperty=null`. 미존재/비활성/기간/조건 불일치, 잘못된 ID는 동일 계약이다. 문자열 메시지나 404로 오류 종류를 분기하지 않는다. 클라이언트 ID 진입은 Long으로 한정하고 누락/0/음수는 요청 없이 종료한다. 비숫자·범위 초과 문자열 ID 파싱은 후속 딥링크의 경계 책임이다.
|
||||
|
||||
네트워크·인증·비정상 HTTP 오류는 공통 클라이언트 처리를 유지하고 Rx error 경로로 처리한다. 임의의 오류 JSON envelope를 파싱하지 않는다.
|
||||
|
||||
## 기능 요구사항과 수용 기준
|
||||
| ID | 요구사항 | 수용 기준 |
|
||||
|---|---|---|
|
||||
| EVT-001 | ID 전용 상세 진입과 기존 Parcelable 호환 | `newIntent(context, eventId: Long)`로 단독 진입; 레거시 연결부는 ID만 전달하고 종료 |
|
||||
| EVT-002 | 정확한 GET 및 선택적 인증 | Long.MAX_VALUE 및 Int 범위 초과 ID 보존; body/query 없음; 비로그인 헤더 생략 |
|
||||
| EVT-003 | 서버 응답만 표시 | stale Parcelable 이미지는 표시하지 않음; 유효한 success/data만 Content |
|
||||
| EVT-004 | 상태 분리 | Loading, Content, Unavailable, Error 구분; success=false/잘못된 ID는 이전 화면 복귀 |
|
||||
| EVT-005 | 비정상 데이터·전송 오류 | null data/누락 필수 데이터/요청과 다른 ID는 성공 아님; 네트워크/HTTP 오류는 조회 불가와 구분하고 공통 오류 안내·재시도 |
|
||||
| EVT-006 | 이미지·링크 정책 | 이미지와 링크가 함께 있으면 이미지+참여 버튼; 링크만 있어도 정상 화면의 참여 동작 제공; 자동 외부 이동하지 않음 |
|
||||
| EVT-007 | 안전한 링크 | 기존 배너의 http/https 및 앱 내부 scheme 정책 적용; 잘못된 URL·미지원 scheme·실행할 앱 없음은 충돌 없이 공통 오류 안내 |
|
||||
| EVT-008 | lifecycle | 화면 재생성 시 중복 최초 요청 방지; 종료 시 구독·로딩/오류 표시 정리 |
|
||||
|
||||
## 보안
|
||||
API 응답, Intent ID, 서버 제공 링크를 입력 경계로 본다. 임의 scheme 실행, 토큰/BuildConfig/내부 예외의 UI·로그 노출을 추가하지 않는다. 기존 인증자와 오류 흐름을 우회하는 별도 HTTP 클라이언트를 만들지 않는다.
|
||||
|
||||
## 검증 시나리오
|
||||
1. 정상: 실제 Retrofit 직렬화/요청 경계와 ViewModel을 통해 정확한 ID·선택적 헤더·단일 객체를 검증하고 URL 원문 및 이미지+링크 표시 결정을 확인한다.
|
||||
2. 경계: success=false, null/무효 data, 잘못된 진입 ID, nullable 이미지, 링크만/미지원 링크 응답, 요청 중 재시도/재생성을 검증한다.
|
||||
3. 회귀: 기존 홈·콘텐츠 배너의 Parcelable Intent 계약 및 레거시 연결부의 ID 추출/종료, 공통 HTTP 오류 전달을 확인한다.
|
||||
|
||||
자동 검증은 `app/src/test`의 로직/local unit test로 수행한다. 레이아웃 크기·간격·visibility 속성 자체를 테스트하지 않는다. 실서비스 조회와 실제 기기 UI 확인을 수행하지 못한 경우 검증 한계를 명시한다.
|
||||
|
||||
## Decision Log
|
||||
| 날짜 | ID | 결정 | 근거 |
|
||||
|---|---|---|---|
|
||||
| 2026-10-29 | DEC-001 | ID-only v2 상세 + 기존 Parcelable의 ID 추출 연결부 | 후속 딥링크는 목록 데이터 없이 진입; 기존 6개 호출 경로 일괄 수정 방지 |
|
||||
| 2026-10-29 | DEC-002 | 레거시 상세 최소 연결 수정 허용 | 사용자 명시 승인: 레거시 최소 수정 승인 |
|
||||
| 2026-10-29 | DEC-003 | 상세에서는 link-only도 참여 버튼, 자동 외부 이동 없음 | 기존 상세 화면 정책 보존; 목록의 직접 외부 이동은 별도 기존 동작 |
|
||||
| 2026-10-29 | DEC-004 | 현재 main 브랜치에서 직접 작업, worktree 생성 없음 | 사용자 명시 지시 |
|
||||
| 2026-10-29 | DEC-005 | 실서버 연결 테스트 제외 | 서버 동시 개발 중이라는 사용자 명시 지시; 로컬 계약 테스트로 검증 |
|
||||
|
||||
## 완료 기준
|
||||
- [x] EVT-001~008 구현 및 관련 로컬 테스트 통과
|
||||
- [x] 관련 회귀·전체 unit suite·debug 빌드 결과와 제약 기록
|
||||
- [x] 변경 범위 리뷰 승인: [phase1-event-detail-api-review.md](reviews/phase1-event-detail-api-review.md)
|
||||
- [x] 임시 자원 정리
|
||||
Reference in New Issue
Block a user