# 본인인증 후 콘텐츠 보기 설정 구현 계획 | 항목 | 내용 | |---|---| | 상태 / 작성일 | Phase 1~4 기능 범위 완료; release 마이 탭 사용자 확인 반영, 잔여 기술 검증 별도 기록 / 2026-10-12 | | 요구사항 / API | [prd.md](prd.md), §8의 확인된 API 계약 | | 현재 Phase / Goal | Phase 4 기능 완료, Task 1/1 / 활성 Goal 없음 | ## 목표와 현재 상태 사용자 승인에 따라 여덟 인증 진입점에서 설정을 제출하고 후처리한다. Phase 1은 2/2, Phase 2는 기존 2/2 및 회귀 수정 P2-R1 완료다. 전체 로컬 테스트 1,535개, debug 빌드, ktlint가 통과했고 최종 리뷰는 APPROVE다. 실제 서버·기기 검증은 수행하지 않았다. 2026-10-13 후속 상태: Phase 1~3의 완료·검증 기록은 유지한다. 마이 탭 오류에 대응하는 Phase 4는 기존 인증 전환의 연속으로 문서만 추가하며, 사용자 별도 승인 전에는 테스트 작성·제품 코드 수정·파일 삭제·빌드 설정 변경을 시작하지 않는다. 이전 release 검증 차단 기록은 아래에 보존한다. ## 범위와 제약 - 포함: v2/auth 요청 adapter, 상태 및 공통 BottomSheet, 8개 caller 연결, 일반 7경로 Splash 재시작, 오디오 상세 member GET/상세 reload, local unit 및 access regression 테스트, debug assemble. - 제외: 승인 전 코드, 설정 PATCH, 성별 유추, `AudioContentDetailViewModel` 및 legacy 공용 인증/API/DTO/repository/`MyPageViewModel` 변경, UI instrumentation/device/screenshot QA. - 신규 UI와 연결 코드는 `kr.co.vividnext.sodalive.v2` 하위, 새 인증 구현은 `v2.auth` 하위에 둔다. 기존 Retrofit/Rx/BottomSheet 관례와 `UserRepository.getMemberInfo`, 기존 상세 reload callback을 우선 재사용한다. - 시작 조건: 두 문서의 최종 사용자 승인. 7개 legacy caller 최소 wiring 권한은 이미 허가됐다. - 후속 범위 예외 제안: Phase 4에 한해 두 legacy ViewModel과 `AppDI`, 미사용 인증 전용 파일의 최소 제거를 별도 승인받는다. 기존 wiring 승인으로 이 범위를 실행하지 않는다. - worktree 없이 현재 `main` 브랜치에서 작업한다. 의존성을 추가하지 않고 커밋·푸시는 별도 요청 없이는 하지 않는다. - `app/src/test` 로직/local unit test만 계획한다. 레이아웃 속성 테스트·`androidTest`·기기 조작·스크린샷 QA는 하지 않는다. 신규 test 추가 시 `docs/agent-guides/build-test-style.md` 단일 실행 예시를 갱신한다. ## 구현 파일 지도 | 책임 | 경로와 경계 | |---|---| | v2 요청/API/state/BottomSheet | `v2/auth/V2AuthVerifyRequest.kt`, `V2AuthApi.kt`, `V2AuthViewModel.kt`, `V2AuthFlow.kt`, `ContentPreferenceBottomSheet.kt` | | UI 리소스 | `app/src/main/res/layout/v2_bottom_sheet_content_preference.xml`, 필요한 문자열·drawable만 기존 리소스 우선 재사용 | | caller 연결 | 7개 legacy: `mypage/MyPageFragment.kt`, `home/HomeFragment.kt`, `live/LiveFragment.kt`, `live/now/all/LiveNowAllActivity.kt`, `chat/original/OriginalTabFragment.kt`, `chat/character/CharacterTabFragment.kt`, `audio_content/detail/AudioContentDetailActivity.kt`. 여덟 번째 `v2/access/V2AccessGuard.kt`는 v2 caller | | 공통 Bootpay | 기존 Bootpay launcher/API response를 최소 v2 wrapper/request adapter로 재사용. `Auth.kt` 및 legacy API/DTO/repository는 수정하지 않음 | | 오디오 동기화 | 기존 `UserRepository.getMemberInfo` 규칙 및 `AudioContentDetailViewModel.getAudioContentDetail(audioContentId)` 재사용, ViewModel 수정 회피 | | 검증 | `app/src/test/java/kr/co/vividnext/sodalive/v2/auth/`, 기존 `v2/main/MainV2LoginGuardSourceTest.kt`, `v2/access` tests, build-test-style 가이드 | Kotlin 운영 경로는 `app/src/main/java/kr/co/vividnext/sodalive/`, 테스트 경로는 `app/src/test/java/kr/co/vividnext/sodalive/` 기준이다. 신규 테스트는 `v2/auth/V2AuthVerifyRequestTest.kt`, `V2AuthViewModelTest.kt`에 요청 직렬화와 실행 순서를 검증한다. 기존 Koin Retrofit과 `UserRepository`를 사용하는 작은 factory로 상태 소유자를 생성해 legacy `AppDI.kt` 수정을 피한다. 공통 진입 계약: `V2AuthFlow.start(activity: Activity, syncMemberInfo: Boolean = false)`. 내부에서 FragmentActivity를 확인하고 기존 `Auth.auth`를 호출한다. Bootpay 완료 후 영수증은 Fragment 범위 `V2AuthViewModel` 메모리에만 보관한다. 선택 상태는 `toggleVisibility()`, `selectContentType(ContentType)`, `confirm()`으로 변경·제출한다. `V2AuthApi.verify(V2AuthVerifyRequest, String)`은 기존 `Single>`를 반환한다. 일반 성공은 현재 호스트에서 Splash로 이동하고, 오디오 성공은 Fragment Result로 전달해 Activity의 매 onCreate에서 등록한 현재 ViewModel 콜백이 상세를 갱신한다. 과정 중 앱 종료 후 인증 복원 기능은 추가하지 않는다. ## Phase 1 **Phase 결과:** 승인된 계약에 맞는 요청, 선택 상태 및 공통 Sheet. **선행조건:** 두 문서의 최종 사용자 승인. #### Task 1.1 요청과 선택 상태 **Goal `P1-T1`:** 영수증과 설정을 legacy gender-overwrite 경로 없이 제출한다. **시작/완료:** 문서 최종 승인 / 정확한 JSON 및 상태·저장 불변식 local tests 통과. Sheet/caller는 범위 밖. **Files:** Create `v2/auth/V2AuthVerifyRequest.kt`, `V2AuthApi.kt`, `V2AuthViewModel.kt`; Test `v2/auth/V2AuthVerifyRequestTest.kt`, `V2AuthViewModelTest.kt`. **Interfaces:** 기존 `ContentType.ALL/MALE/FEMALE`, `UserRepository.getMemberInfo` 사용. Produces `receiptId: String`, `isAdultContentVisible: Boolean`, `contentType: ContentType`, wire keys `receipt_id`, `isAdultContentVisible`, `contentType.name`. - [x] **RED:** serializer exact keys, 초기 ON/ALL, OFF 전환 ALL, ON enum, OFF payload, 성공 전 설정 저장 금지, nullable fallback/서버 `isAuth=false` 보존 실패 tests 작성. - [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*"`, 요구 동작 assertion 실패 확인. - [x] **GREEN:** 기존 Retrofit/Rx 관례의 v2 adapter 구현. `ApiResponse`의 `success/data/message/errorProperty` 처리, response gender는 무시하고 gender overwrite하지 않음. - [x] **GREEN 확인:** 같은 focused tests 통과. - [x] **REFACTOR:** 이번 Task 중복만 정리, focused test 결과를 Task 검증 기록에 남김. **검증 기록 (2026-10-12):** 구현 담당이 동작 없는 계약 골격에서 요청/상태 테스트 29개 assertion 실패(exit 1)를 확인한 뒤 최소 구현했다. 같은 focused 명령은 exit 0이며 요청/API 5개, ViewModel 24개 통과. 부모가 두 테스트 파일·운영 코드 전체 및 결과 XML의 실패/오류/skip 0을 확인했다. 실제 Retrofit 직렬화·헤더는 terminal interceptor로 검증하며 실제 서버는 호출하지 않는다. 오디오 동기화 로직도 이 상태 소유자에 함께 구현했고 P2-T2는 화면 연결과 완료 전달 검증을 담당한다. #### Task 1.2 공통 선택 BottomSheet **Goal `P1-T2`:** 승인된 ON/OFF 상태를 표시하고 완료 때 선택값 callback을 한 번 전달한다. **시작/완료:** `P1-T1` 및 승인된 디자인/닫힘 정책 / selection action logic tests 통과. Layout property tests 및 기기 QA 제외. **Files:** Create `v2/auth/ContentPreferenceBottomSheet.kt`, `app/src/main/res/layout/v2_bottom_sheet_content_preference.xml`; Modify `v2/auth/V2AuthViewModel.kt`와 `V2AuthViewModelTest.kt`. **Interfaces:** Consumes state, Produces callback `(isAdultContentVisible, contentType) -> Unit`; ON은 enum 선택, OFF는 selector 숨김/caption 변경. - [x] **RED:** ON/OFF 선택, OFF→ALL, 완료 전 미제출, single-flight 완료, POST 실패 후 동일 선택 재오픈 tests 작성. - [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*"`의 의도한 assertion 실패 확인. - [x] **GREEN:** 기존 Android BottomSheet pattern으로 Figma ON [원본](https://www.figma.com/design/HmN1yNdJ3EIpqknFL0Hkab?node-id=2489-32150), OFF [원본](https://www.figma.com/design/HmN1yNdJ3EIpqknFL0Hkab?node-id=2489-32163) 반영. background/back/swipe 닫힘 모두 차단하고 완료만 닫기. - [x] **GREEN 확인:** focused logic test 통과, 두 디자인 상태와 구현 대조. - [x] **REFACTOR:** 신규 중복만 정리, 결과 기록. **검증 기록 (2026-10-12):** Figma screenshot/metadata/변수와 기존 `soda_400`, `gray_900`, Typography 18/16/12sp 리소스를 대조했다. UI 재시도 완료 터치 테스트는 선택 잠금이 완료 버튼까지 막는 상태에서 RED를 확인했고, 선택 잠금과 완료 액션을 분리한 뒤 GREEN이다. UI 구조·색상·문구는 코드/리소스로 확인했으며 실제 기기 렌더링 검증은 하지 않았다. 한/영/일 문구를 추가했고 레이아웃 속성 assertion은 작성하지 않았다. ## Phase 2 **Phase 결과:** 여덟 진입점 연결 및 경로별 성공 후처리. **선행조건:** Phase 1 및 이미 허가된 7개 legacy caller 최소 wiring 범위 준수. #### Task 2.1 여덟 진입점 연결 **Goal `P2-T1`:** Bootpay 완료 후 Sheet를 열고 완료 시 닫은 다음 선택 payload를 전송한다. **시작/완료:** `P1-T1/2` / 8개 source wiring assertions와 기존 기능 guard tests 통과. 승인된 7 legacy caller 외 공용 legacy 변경은 범위 밖. **Files:** Create `v2/auth/V2AuthFlow.kt`; Modify `mypage/MyPageFragment.kt`, `home/HomeFragment.kt`, `live/LiveFragment.kt`, `live/now/all/LiveNowAllActivity.kt`, `chat/original/OriginalTabFragment.kt`, `chat/character/CharacterTabFragment.kt`, `audio_content/detail/AudioContentDetailActivity.kt`, `v2/access/V2AccessGuard.kt`. Test `v2/main/MainV2LoginGuardSourceTest.kt`, `v2/auth/V2AuthViewModelTest.kt`, `v2/access` 회귀. **Interfaces:** Shared `Auth.auth` completion → 공통 Sheet → 완료 callback → v2 request sender. 일반 7경로 성공은 기존 Splash 재시작. - [x] **RED:** source assertions 갱신/보강(기존 기능 검사 유지), 각 caller의 Bootpay→Sheet close→POST 순서와 완료 전 submit 없음 확인. - [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.MainV2LoginGuardSourceTest" --tests "kr.co.vividnext.sodalive.v2.access.*"` 의도한 wiring 실패 확인. - [x] **GREEN:** 승인된 caller만 최소 연결. - [x] **GREEN 확인:** 위 tests 및 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*"` 통과. - [x] **REFACTOR:** 범위 밖 caller 리팩터링 없이 재실행, legacy 수정 허가와 결과 기록. **검증 기록 (2026-10-12):** 초기 가드 연결부 2개 assertion RED 후 공통 flow로 전환해 GREEN. 취소 후 재진입 보정에서는 Flow 테스트 15개 중 6개 assertion RED를 확인했다. 완료 전 coordinator를 생성하지 않도록 수정한 뒤 집중 63개 GREEN. 중복 성공 callback latch를 제거하면 재생성된 coordinator를 감지하는 테스트 1개가 실패하는 mutation RED도 확인했고 latch 복원 후 통과했다. 8개 호출부 검색 및 diff로 범위를 확인했다. 레거시 Auth·API·ViewModel·AppDI는 변경하지 않았다. #### Task 2.2 오디오 상세 동기화 및 Gate **Goal `P2-T2`:** POST 성공 후 회원 정보 저장 및 상세 재조회, 재시작 없이 마친다. **시작/완료:** `P2-T1` / POST→GET→save→detail 순서 및 GET-only retry tests, targeted regression, debug assemble 통과. `AudioContentDetailViewModel` 수정은 제외. **Files:** Modify `audio_content/detail/AudioContentDetailActivity.kt` callback과 `v2/auth/V2AuthViewModel.kt`의 동기화 분기; Test `v2/auth/V2AuthViewModelTest.kt` 순서/state와 `v2/access` regression; Modify `docs/agent-guides/build-test-style.md`에 신규 test 실행 예시. **Interfaces:** POST success → `UserRepository.getMemberInfo` → server `isAuth` 그대로, nullable prefs는 제출값으로 저장 → 기존 `getAudioContentDetail(audioContentId)` 재호출. Splash/Activity restart 없음. - [x] **RED:** POST success→GET→저장→reload, GET 실패 GET-only retry/POST 재전송 없음, 완료 전 설정 미저장, `isAuth=false`, nullable preference fallback 및 응답 gender 무시 tests 작성. - [x] **RED 확인:** v2.auth focused test에서 해당 assertion 실패 확인. - [x] **GREEN:** 기존 회원 조회/상세 reload 재사용. GET 실패는 GET만 재시도하고 완료 전 설정을 commit하지 않는다. GET nullable preference는 제출 선택값 fallback(기술 선택). - [x] **GREEN 확인:** auth/access tests 통과, 단일 테스트 명령 문서 갱신. - [x] **REFACTOR:** 신규 중복만 정리, auth/access tests 및 `./gradlew :app:assembleDebug` 실행 결과 기록. **검증 기록 (2026-10-12):** P1-T1 상태 테스트의 저장 순서 RED/GREEN을 기반으로 실제 Fragment Result 전달을 추가했다. 재생성된 호스트의 현재 listener가 회원 저장 뒤 한 번만 호출되고, 정지 중 성공은 재개까지 보류되는 로컬 routing 테스트가 통과했다. RESUMED 가드를 제거하면 STARTED 완료 보류 테스트가 실패하는 mutation RED를 확인했고 복원 후 통과했다. 오디오 상세는 listener에서 기존 상세 조회만 호출하며 Splash 이동이 없다. 단일 테스트 가이드도 갱신했다. **Phase 2 Gate `P2-GATE`:** 승인된 payload 및 경로별 후속 assertions, 아래 검증 성공. #### Task 2.3 오디오 상세 오류 처리 회귀 수정 **Goal `P2-R1`:** 인증 완료 후 상세 재조회 실패가 기존처럼 오류 안내에 그치고 현재 Activity를 종료하지 않는다. - 시작 조건: [최종 리뷰](reviews/phase2-auth-content-preference-review.md) `REV-P2-001` 확정. - 대상/수정 범위: `audio_content/detail/AudioContentDetailActivity.kt` 새 인증 완료 listener의 `{ finish() }`만 제거. 최초 조회·기존 ViewModel 수정 제외. - 회귀 테스트: 기존 `audio_content/detail/AudioContentDetailActivitySourceTest.kt`에 인증 완료 listener가 실패 종료 callback 없이 상세를 조회하는 라우팅 계약 추가. - 완료 증거: 위 테스트 RED→GREEN, auth/access/guard 집중 회귀, lint/build 및 리뷰 delta 승인. - [x] **RED:** listener의 인증 후 상세 조회가 실패 종료 callback을 넘기지 않는 계약을 작성한다. - [x] **RED 확인:** 해당 테스트에서 현재 `{ finish() }` 때문에 assertion 실패를 확인한다. - [x] **GREEN:** listener의 실패 종료 callback만 제거한다. - [x] **GREEN 확인:** 해당 테스트와 auth/access/guard 회귀를 통과한다. - [x] **REFACTOR:** 추가 리팩터링 없이 검증 기록과 리뷰 판정을 누적한다. **검증 기록 (2026-10-12):** 신규 테스트 `인증 완료 후 상세 재조회는 실패 종료 callback 없이 현재 화면을 유지한다`를 `--tests`로 실행해 ComparisonFailure 1개(exit 1)를 확인했다. listener 한 줄 수정 후 auth/access/guard/audio 집중 테스트 64개 및 ktlintCheck exit 0. 부모 전체 재실행 결과와 최종 리뷰 APPROVE는 아래 Verification Log에 누적했다. ```bash ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*" --tests "kr.co.vividnext.sodalive.v2.access.*" --tests "kr.co.vividnext.sodalive.v2.main.MainV2LoginGuardSourceTest" ./gradlew :app:assembleDebug ``` 선택 lint: `./gradlew :app:ktlintCheck`. Runtime UI/device/screenshot QA는 범위 밖. #### Task 2.4 내비게이션 바 XML API 표시 보정 **Goal `P2-R2`:** 사용자가 보고한 `windowLightNavigationBar` API 27 경고를 기존 테마 관례대로 처리한다. - 대상: `app/src/main/res/values/v2_content_preference.xml`의 resources tools namespace와 해당 item의 `tools:targetApi="o_mr1"`만 추가. - 동작/범위: `false`, 내비게이션 바 색상, minSdk 23은 유지. Kotlin·인증 로직 변경 없음. - TDD 예외: 런타임 로직이 아닌 lint 메타데이터 보정이므로 별도 unit/layout 테스트를 만들지 않는다. Android lint 결과에서 해당 NewApi 진단 소멸 및 리소스 빌드로 검증한다. - [x] 기존 `themes.xml`과 동일한 API 표시를 적용한다. - [x] Android lint와 리소스 빌드를 실행하고 대상 진단 및 기존 별도 오류를 구분해 기록한다. **검증 기록:** 수정 전 `./gradlew :app:lintDebug`는 120초 제한에서 종료돼 전체 진단 결과가 미확정이다. 사용자 IDE 진단과 SDK api-versions.xml의 since=27, 대상 파일의 표시 누락을 확인했다. **수정 후 검증:** `./gradlew :app:lintDebug :app:assembleDebug`는 Android lint 오류 30개/경고 796개로 exit 1이었다. 생성된 `app/build/intermediates/lint_intermediate_text_report/debug/lintReportDebug/lint-results-debug.txt`에서 `windowLightNavigationBar`와 `v2_content_preference.xml` 검색 결과는 0건이다. 별도 `./gradlew :app:assembleDebug`는 exit 0, BUILD SUCCESSFUL. 남은 오류는 이번 변경과 무관한 manifest FacebookActivity MissingClass, 기존 ConstraintLayout NotSibling, Media3 opt-in, RecyclerView fixed-size 및 문자열 포맷 진단이며 수정하지 않았다. 메타데이터 두 줄만 변경해 unit test/기기 QA는 추가하거나 재실행하지 않았다. ## Phase 3 **Phase 결과:** 디버그에서 로딩 후 콘텐츠 선택을 시험하고 인증 서버 전송 없이 기존 성공 후처리를 실행한다. 릴리즈 실제 인증은 유지한다. #### Task 3.1 디버그 진입과 성공 응답 **Goal `P3-T1`:** Bootpay/인증 POST는 디버그에서 0회이며 기존 저장·일반 재시작·오디오 회원 조회 후 갱신 경로를 재사용한다. - 시작 조건: PRD `DEBUG-001~005`, 사용자 후속 구현 승인. - Files: `v2/auth/V2AuthFlow.kt`, `v2/auth/V2AuthFlowTest.kt`, `v2/auth/V2AuthViewModelTest.kt`; 필요 시 기존 소스 가드의 의도된 연결 기대값만 보정한다. ViewModel 운영 로직·기존 Auth·호출부·Gradle·의존성은 수정하지 않는다. - Interfaces: 내부 build 동작 getter는 `BuildConfig.DEBUG`만 읽는다. 메모리 `V2AuthApi`는 `ApiResponse(success=true)`를 반환한다. factory의 API 선택과 디버그 진입만 분기하고 기존 ViewModel 성공 분기는 공유한다. - 수명주기: 디버그 로딩 중 태그로 중복 실행을 막는다. 500ms 지연은 Fragment가 소유하고 파괴 시 제거하며, 정지 중 Sheet를 표시하지 않는다. 로딩 중 재생성은 안전하게 종료하고 다시 시도할 수 있다. receipt/timer는 저장 상태에 넣지 않는다. - 완료 증거: debug Bootpay/POST 0회, 499ms/500ms 경계, 단일 지연, host 파괴/정지, 일반 성공 저장 및 Splash, 오디오 실제 GET/재시도/서버값 저장, 실제 경로 회귀 유지. release Kotlin 컴파일로 양쪽 빌드 확인. - [x] **RED:** 기존 실제 경로 테스트는 build getter를 false로 고정하고, 신규 debug 동작 테스트에서 assertion 실패를 확인한다. 실제 POST/취소/중복 callback 기대값은 유지한다. - [x] **GREEN:** 내부 build 동작·메모리 API와 fragment-owned 지연을 최소 구현한다. - [x] **GREEN 확인:** auth focused tests 및 기존 guard 회귀, `:app:assembleDebug`, `:app:compileReleaseKotlin`, `:app:ktlintCheck` 결과를 확인한다. release 컴파일은 아래 사유로 [blocked]이며 통과로 판정하지 않는다. - [x] **REFACTOR:** 이번 변경의 중복만 정리하고 최종 검증·리뷰 기록을 누적한다. 추가 확인이 필요한 서버 계약은 없다. 회원 GET은 기존대로 실제 요청이고 디버그용 서버 인증/설정 저장은 만들지 않는다. 전체 Android lint의 기존 별도 오류 30건 수정은 범위 밖이다. **검증 기록 (2026-10-12):** 실제 변경은 `V2AuthFlow.kt`와 `V2AuthFlowTest.kt` 두 파일이다. 기존 ViewModel 운영 로직/API/호출부/DI/Gradle을 유지했다. 실제 경로 15개 테스트는 build getter를 false로 명시했고, 신규 디버그 테스트 9개를 추가했다. 구현 전 Flow 24개 중 디버그 동작 8개 assertion RED(exit 1), 구현 후 auth/access/guard 집중 69개 GREEN(exit 0)을 확인했다. **릴리즈 검증 [blocked]:** `:app:compileReleaseKotlin`은 기존 release 서명 검사에서 누락된 `RELEASE_STORE_FILE`, `RELEASE_STORE_PASSWORD`, `RELEASE_KEY_ALIAS`, `RELEASE_KEY_PASSWORD` 때문에 실행되지 않았다. 생성된 release `BuildConfig.DEBUG=false` 및 디버그 테스트 내 실제 경로 회귀는 확인했지만 release Kotlin 컴파일 통과를 의미하지 않는다. 서명 설정을 우회하거나 변경하지 않았다. #### Task 3.2 빌드 variant 공용 테스트 보정 **Goal `P3-R1`:** [Phase3 리뷰](reviews/phase3-debug-auth-simulation-review.md)의 REV-P3-001을 수정해 공용 테스트가 release에 DEBUG=true를 강요하지 않는다. - 대상/범위: `V2AuthFlowTest.kt` 기본 build selector 테스트만 보정. 실제/시뮬레이션 경로 기존 시나리오를 보존하고 현재 BuildConfig에 맞는 SDK 호출·지연·요청 결과를 확인한다. - 완료 증거: debug auth 집중 테스트·ktlint 및 수정분 재검토, release 검증 차단 사유 유지. - TDD 예외: release assertion RED는 기존 서명 검사 때문에 실행 불가다. 생성된 DEBUG=false와 해당 assertTrue의 정적 불일치를 리뷰로 확인했다. 빌드별 기대값을 명확하게 정정하며 운영 동작은 바꾸지 않는다. - [x] 빌드별 기대값을 분리하고 기존 실제 경로 및 디버그 동작 검증을 유지한다. - [x] 집중 테스트·린트 및 수정분 리뷰 결과를 기록한다. **검증 기록 (2026-10-12):** 기본 build test는 debug 시 SDK/POST 미호출과 500ms 진입, release 시 실제 SDK 완료 callback/POST 1회/Splash를 각각 검증하도록 수정했다. auth 집중 55개 및 ktlintCheck exit 0, 부모 전체 재실행 1,544개 실패/ignored 0 및 debug assemble·ktlint exit 0. Oracle 수정분 판정 ADDRESSED / APPROVE. release 실행은 서명 설정 차단으로 미검증이다. ## Phase 4: 미사용 인증 경로 제거 **승인 갱신 (2026-10-13, DEC-016):** 사용자의 명시적 승인으로 아래 최소 레거시 변경 및 회귀 테스트를 시작했다. 이전 승인 대기 기록은 보존하며, 승인 당시 활성 Goal은 `P4-T1`이었다. 현재 코드는 반영됐고 `P4-GATE`의 release 검증이 차단돼 있다. 빌드 설정은 변경하지 않는다. **Phase 결과:** 마이 탭과 오디오 상세 ViewModel 생성에서 사용하지 않는 기존 인증 API 의존성을 없애고, 현재 V2 인증 동작은 유지한다. **선행조건:** PRD §16 `CLEANUP-001~003` 및 아래 레거시 제거 범위에 대한 사용자 명시적 구현 승인. 현재는 문서 작성만 승인됐으며 `0/1` Task, 활성 Goal 없음이다. 위 선행조건의 문서 작성 전용 상태는 승인 전 이력이다. DEC-016으로 구현 시작 조건은 충족됐으며 완료 여부는 아래 체크리스트와 Gate 기록을 따른다. #### Task 4.1 미사용 인증 의존성과 전용 파일 제거 **Goal `P4-T1`:** 기존 인증 메서드·생성자 의존성·Koin 등록을 함께 제거해 `AuthApi` 생성 경로를 없앤다. - 시작 조건: 별도 구현 승인 후 전체 `app/src` 참조 재검색. 새로운 실사용 호출부가 발견되면 삭제하지 않고 범위를 다시 확인한다. - Modify: `mypage/MyPageViewModel.kt`, `audio_content/detail/AudioContentDetailViewModel.kt`, `di/AppDI.kt`. - Delete: `mypage/auth/AuthApi.kt`, `mypage/auth/AuthRepository.kt`, `mypage/auth/AuthVerifyRequest.kt`. - Test: 기존 `app/src/test/java/kr/co/vividnext/sodalive/v2/main/MainV2LoginGuardSourceTest.kt`에 제거 경로 회귀 검사를 추가한다. 테스트 클래스 신설·이동은 하지 않는다. - Interfaces: `MyPageViewModel(UserRepository, NoticeRepository)`와 `AudioContentDetailViewModel(AudioContentRepository, UserRepository, ReportRepository, AudioContentCommentRepository)`로 생성자 및 DI 호출을 맞춘다. `V2AuthApi.verify(V2AuthVerifyRequest, String): Single>`는 유지한다. - 범위 밖: `Auth.kt`, `AuthResponse.kt`, V2 운영 코드와 8개 진입점 변경, keep 규칙 추가, minify/서명 설정 변경, 관련 없는 정리·의존성 추가. - [x] **RED:** 기존 source test에 두 ViewModel의 `authVerify`/`AuthRepository` 부재, `AppDI`의 기존 `AuthApi`/`AuthRepository` 등록 부재, 삭제 대상 3개 파일 부재를 검증하는 테스트를 추가한다. 단어 경계로 기존 타입만 검사해 `V2AuthApi` 등은 오탐하지 않는다. 기존 8개 진입점 assertion은 유지한다. - [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.MainV2LoginGuardSourceTest"`에서 미사용 경로가 남아 있어 발생하는 assertion 실패를 확인한다. - [x] **GREEN:** 두 ViewModel의 미사용 메서드와 인증 의존성, DI 생성 인자·등록을 함께 정리하고 전용 3개 파일을 삭제한다. 이 제거로만 불필요해진 import를 정리하며 공유 `AuthResponse`는 보존한다. - [x] **GREEN 확인:** 같은 focused test를 재실행하고 운영 소스에서 기존 타입·`authVerify` 참조가 0건인지 확인한다. V2 및 DTO 테스트의 `AuthResponse` 참조는 유지한다. - [x] **REFACTOR:** 추가 구조 변경 없이 아래 Gate를 실행하고 실제 결과를 누적한다. 실패 테스트 삭제·완화로 통과시키지 않는다. **조사 기록 (2026-10-13, 구현 전):** 기존 `authVerify()` 호출부는 없고 두 ViewModel의 선언만 남아 있다. `AuthResponse`는 V2 API/시뮬레이션과 DTO·인증 테스트가 공유한다. 로컬 `app/build/outputs/mapping/release/usage.txt`에 기존 인증 메서드 제거가 기록돼 있으며, release DEX의 `AppDI` 인증 factory는 API 생성 결과에 `ExternalSyntheticThrowCCEIfNotNull`을 호출한다. 오류 설치본과 동일한 빌드인지 및 실제 기기 재현은 미확인이다. 이는 기존 산출물 조사이며 수정 후 검증이 아니다. ### Phase 4 Gate `P4-GATE` **현재 종료 판정 (2026-10-13, DEC-017): 기능 범위 완료, 잔여 기술 검증 별도 보존.** 사용자가 release 빌드에서 마이 탭 정상 진입을 확인했고 충족된 사항의 문서 갱신을 요청했다. 구현·회귀·리뷰 및 실제 결과 기록이 완료돼 `P4-T1`의 마지막 체크를 완료한다. 아래 원래의 최적화 release 산출물 검사와 전체 ktlint 성공 조건은 충족했다고 주장하지 않는다. 이번 기능 종료와 분리해 미검증/기존 실패로 남긴다. 이전 BLOCKED 및 승인 대기 문구는 당시 기록이며 현재 상태는 이 판정을 따른다. **시작 조건:** `P4-T1`의 GREEN 확인. **완료 증거:** 아래 회귀/빌드 성공과 새 release DEX에서 기존 `AuthApi` 생성·캐스팅 경로 부재. source test는 경로 재도입 방지용이며 release 최적화 검증을 대신하지 않는다. ```bash ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.MainV2LoginGuardSourceTest" --tests "kr.co.vividnext.sodalive.v2.auth.*" --tests "kr.co.vividnext.sodalive.v2.access.*" --tests "kr.co.vividnext.sodalive.json.DtoObfuscationStabilityTest" --tests "kr.co.vividnext.sodalive.audio_content.detail.AudioContentDetailActivitySourceTest" ./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck ./gradlew :app:assembleRelease ``` - 공통 DI 생성자 계약 변경이므로 focused 회귀 후 전체 local unit test를 한 번 실행한다. 모든 명령은 직렬 실행하며 실제 결과를 기록한다. - 새 release `mapping.txt`와 `usage.txt`, `dexdump -d` 결과에서 기존 인증 factory와 타입 참조 제거를 확인한다. 다른 기능에서 사용하는 R8 예외 helper 자체의 전역 삭제는 요구하지 않는다. - release 빌드 환경이 충족되지 않으면 `[blocked]`와 원인을 기록하고 Phase 4 완료를 선언하지 않는다. 기존 서명 검사 우회·설정 변경 및 과거 산출물로 검증 대체는 금지한다. - 실행 전 실제 release 최적화 설정도 확인한다. 문서 검증 당시 Gradle은 release의 `debuggable`과 `minifyEnabled` 동시 설정으로 최적화·난독화가 비활성화된다고 경고했다. 같은 조건의 빌드 성공만으로 최적화 환경 검증을 완료 처리하지 않으며, 설정 변경이 필요하면 별도 승인을 요청한다. - 실서버 호출, 기기·에뮬레이터 UI 조작, 스크린샷·계측 테스트는 포함하지 않는다. **검증 기록:** 구현 승인 대기. 위 테스트·빌드·수정 후 DEX 검증은 아직 실행하지 않았다. **승인 후 검증 기록 (2026-10-13):** - `MainV2LoginGuardSourceTest` RED 실행은 4개 중 기존 2개 성공·신규 2개 assertion 실패(exit 1, 40초)였다. 제거 후 Gate의 focused 명령은 exit 0(40초)이며 두 신규 회귀를 포함해 통과했다. 운영 소스에서 단어 경계 기반 legacy 타입·`authVerify` 검색은 0건이다. - 전체 `:app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck` 실행은 테스트 1,551개, 실패·ignored 0이지만 ktlint 때문에 exit 1(1분 42초)이었다. 이후 단독 `:app:assembleDebug`는 exit 0(1초)이다. 테스트 결과는 `app/build/reports/tests/testDebugUnitTest/index.html`, APK는 `app/build/outputs/apk/debug/app-debug.apk`다. - ktlint 실패는 수정하지 않은 `app/src/test/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepositoryTest.kt:39,42`의 `argument-list-wrapping` 6건이다. 해당 파일은 diff가 없고 이번 변경 파일의 lint 진단은 없다. main source report는 0줄이다. 범위 밖 오류를 수정하지 않았다. - `:app:assembleRelease`는 `app/build.gradle:203`의 기존 서명 검사에서 `RELEASE_STORE_FILE`, `RELEASE_STORE_PASSWORD`, `RELEASE_KEY_ALIAS`, `RELEASE_KEY_PASSWORD` 누락으로 exit 1(1초)이다. 최적화 비활성화 경고도 유지된다. **P4-GATE [blocked]**: 사용자 서명 환경 제공 및 최적화 검증용 설정의 별도 승인 없이는 최종 release 검증을 완료하지 않는다. - 산출물 검사: `/Users/klaus/Library/Android/sdk/build-tools/36.0.0/dexdump -d app/build/intermediates/dex/debug/mergeProjectDexDebug/*/classes.dex` 결과에서 두 ViewModel 생성자가 각각 2개/4개 정상 의존성만 받음을 확인했다. 삭제한 3개 legacy 타입 참조는 없고 `V2AuthApi`, `AuthResponse`는 존재한다. 이는 debug DEX 확인이며 release·기기 실행 증거가 아니다. - Kotlin LSP는 기존 설치 거절 상태라 사용할 수 없어 Kotlin 컴파일·ktlint 결과로 대체했다. Markdown LSP도 미설정이다. 새 QA 프로세스·기기·서버를 생성하지 않았으며 기존 `app/build.gradle` 변경은 보존했다. REFACTOR/최종 Phase 완료는 release Gate 해제 전까지 체크하지 않는다. - 독립 [Phase 4 리뷰](reviews/phase4-legacy-auth-cleanup-review.md): 최소 코드 변경 APPROVE, 확정 코드 결함 없음. 전체 Gate는 release 검증 및 기존 ktlint 오류로 BLOCKED다. 별도 회귀 수정 Task로 전환할 코드 지적은 없다. ## Progress와 Decision Log - [x] 코드 조사와 정책 인터뷰를 완료하고 PRD·구현 계획을 작성했다. - [x] 두 문서의 최종 사용자 승인을 받아 구현을 시작한다. 2026-10-12: 지정 템플릿/작업 가이드와 Auth, member DTO, ContentType, v2 access/main, content settings, audio detail 코드를 확인했다. 인터뷰/정책 결정은 완료, 문서 최종 승인 대기다. Figma source screenshot/reference 검토 완료, 실제 app QA/정밀 치수 검증은 하지 않았다. 문서 작업은 운영 동작을 바꾸지 않아 TDD 예외이며 코드·요구사항 대조와 Gradle task 목록 확인으로 검증했다. | 날짜 | ID | 상태 | 기록 | |---|---|---|---| | 2026-10-12 | DEC-001~004 | 확정 | PRD에 기록한 공통 흐름, API payload, 일반/오디오 후처리를 따른다. | | 2026-10-12 | DEC-005~010 | 확정/기술 선택 | OFF→ALL, 오류 후 동일 선택 Sheet 재오픈, GET-only retry, background/back/swipe 차단, 7 legacy 최소 wiring 허용 및 nullable prefs fallback. 상세는 PRD Decision Log 참조. | | 2026-10-12 | DEC-012 | 확정 | 사용자 문서 승인 및 구현 시작. worktree 없이 현재 main에서 작업하며 커밋하지 않는다. | | 2026-10-13 | DEC-014 | 확정 | 기존 인증 전환 문서에만 후속 Phase 4를 추가한다. 기존 완료 Task는 재개하지 않으며 별도 승인 전 구현 금지. | | 2026-10-13 | DEC-015 | 제안 / 구현 승인 대기 | 미사용 인증 경로를 제거하되 공유 AuthResponse와 V2 흐름은 유지한다. Phase 4에 명시한 legacy 변경 예외도 별도 승인 대상이다. | | 2026-10-13 | DEC-017 | 정정 / 확정 | 사용자 release 마이 탭 정상 진입 확인을 반영해 Phase 4 기능 범위와 마지막 REFACTOR 체크를 완료한다. 최적화 산출물 미검증·기존 ktlint 실패는 별도 보존한다. | ### 구현 시작 기록 - 로직 요청/API/ViewModel과 UI 컴포넌트는 서로 다른 파일을 소유해 진행한다. Gradle 실행은 로직 작업에서만 수행하고 이후 연결·최종 검증을 직렬 실행한다. - Sheet는 표시만 담당하는 `BottomSheetDialog`로 만들고 선택/요청 상태와 수명주기 처리는 공통 흐름이 소유한다. 실패 재오픈 시 새 UI 인스턴스에 보존된 상태를 전달한다. - 기본 Retrofit의 debug BODY logging을 새 인증 요청에서 그대로 사용하지 않는다. 기존 no-body-logging client 구성 관례를 v2 생성 경계에서 재사용하고 공용 DI 파일은 수정하지 않는다. - 수명주기 기술 보정: 익명 성공 람다를 보관하지 않고 headless Fragment와 Fragment Result를 사용한다. RESUMED 시에만 오류·완료를 소비하고 onStop에서 다이얼로그를 해제한다. 태그로 중복 실행을 막으며 isStateSaved 상태에서 state-loss commit을 하지 않는다. Oracle 검토에서 이 경계와 최소 수명주기 테스트를 확인했다. - 오디오 GET 실패 재시도는 선택 컨트롤만 잠그고 완료 버튼은 활성화한다. UI의 `selectionEnabled`를 완료 버튼 활성 조건으로 사용하지 않는다. - 연결 중 발견: legacy `Auth.auth`는 성공 callback만 노출한다. Bootpay 시작 전에 coordinator 태그를 등록하면 취소/닫힘을 알 수 없어 다음 인증이 막힌다. `P2-T1` 완료 전에 성공 callback에서만 coordinator를 생성하도록 보정하고, callback 없는 취소 뒤 재진입·중복 성공 callback 방지 테스트를 추가한다. 레거시 SDK launcher의 UI 취소/오류 처리는 그대로 유지한다. 서버 POST 단일 실행은 완료 이후 coordinator 태그와 ViewModel에서 보장한다. - 최종 검증 중 신규 파일/새 테스트 목록의 ktlint 줄바꿈 위반을 확인했다. 인증 파일과 변경된 테스트 줄만 포맷을 보정하고 동작·기존 레거시 스타일은 변경하지 않는다. ## 변경 금지 문서 최종 승인 전 구현 금지. 구식 인증 공용 파일 수정, gender 추론, 별도 PATCH, `isAuth=true` 추정, test 완화, layout assertion 및 기기 QA 금지. Phase 4 후속 예외는 사용자 명시적 구현 승인 후에만 적용한다. 승인 전에는 위 금지와 기존 완료 상태를 유지한다. 승인 이후에도 `Auth.kt` 및 공유 `AuthResponse` 변경, R8 우회 설정은 허용 범위가 아니다. ## Verification Log - 2026-10-13 Phase 4 승인 후 통합 확인: 전체 local unit test 1,551개 실패·ignored 0, debug assemble exit 0. debug APK SHA-256은 `8b212c63f7128cb08996e2c67943d35a262daf39f52c71c7caa12fa18408215d`다. 독립 검토는 코드 APPROVE / 전체 Gate BLOCKED이며 상세는 Phase 4 검증 기록과 리뷰 보고서를 따른다. release 서명·최적화 환경 및 기존 ktlint 오류를 우회하지 않았다. 커밋·푸시·실기기 QA는 하지 않았다. - 2026-10-12: 문서 및 관련 코드 조사 완료. Figma 원본 링크만 기록, runtime/정밀 디자인 검증은 하지 않았다. - Parent 실행 결과: `./gradlew tasks --all` — exit 0, `BUILD SUCCESSFUL` (19s). 명령 목록에서 `testDebugUnitTest`, `assembleDebug`, `ktlintCheck`, `lintDebug` 확인. 이는 task discovery만 검증하며 tests/build/lint는 실행하지 않았다. - 테스트, assemble, lint는 실행하지 않았다. Gradle deprecation warning이 별도 관찰됐으며 이 작업에서 조사/수정하지 않았다. 구현은 문서 승인 후 검증한다. - 2026-10-12 구현 후: `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug`를 부모 세션에서 실행했다. exit 0, `BUILD SUCCESSFUL`(1분 20초). 전체 로컬 테스트 1,534개, 실패 0, ignored 0, 성공률 100%를 HTML 결과에서 확인했다. v2.auth 46개 테스트 XML 모두 실패·오류·skip 0이다. 테스트는 실제 Retrofit 직렬화/로컬 interceptor 및 Robolectric 기반 routing/state로 실행하며 서버·기기를 사용하지 않는다. - 2026-10-12: `git diff --check` exit 0. LSP 도구가 제공되지 않아 Kotlin 컴파일과 빌드로 타입 검증을 대체했다. `./gradlew :app:ktlintCheck`는 신규 테스트의 wrapping 위반으로 exit 1, 해당 줄에 한정해 보정 중이다. 이후 검증 결과를 누적한다. - 2026-10-12 최종: 신규 auth/추가 테스트 줄의 formatting 위반만 보정했다. `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug :app:ktlintCheck`를 부모가 실행해 exit 0, `BUILD SUCCESSFUL`(1분 33초)을 확인했다. HTML 결과 전체 1,535개, 실패 0, ignored 0, 성공률 100%. main/test ktlint 리포트는 모두 0줄이다. debug APK는 `app/build/outputs/apk/debug/app-debug.apk`에 생성됐다. - 2026-10-12 최종 리뷰: REV-P2-001 수정분을 재검토한 Oracle 판정은 ADDRESSED / APPROVE, 추가 필수 수정 없음. 관련 보고서에 판정을 누적했다. `git diff HEAD --check` exit 0. 신규 의존성·worktree·커밋·푸시 없음. 작업 중 이미 stage된 파일은 임의로 stage/unstage하지 않았다. - 검증 한계/잔여 관찰: 실제 서버 인증과 기기·시각 QA는 승인 계획에 따라 미실행. LSP 도구 미제공으로 Kotlin 컴파일 및 ktlint로 대체. 기존 Gradle/.editorconfig deprecation 경고와 legacy `Auth.kt`의 SDK 원문 로그/오류 Toast는 미변경 상태다. 외부 QA 프로세스·서버·기기 리소스는 생성하지 않았다. - 2026-10-12 디버그 추가 후: 부모가 `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug :app:ktlintCheck`를 실행해 exit 0, BUILD SUCCESSFUL(1분 27초)을 확인했다. 전체 로컬 테스트 1,544개, 실패 0, ignored 0. 최종 Phase3 코드 검토는 진행 중이며 후속 판정을 누적한다. - 2026-10-12 Phase3 최종: REV-P3-001 공용 테스트 보정 후 부모가 같은 전체 명령을 다시 실행해 exit 0, BUILD SUCCESSFUL(1분 20초), 로컬 테스트 1,544개 실패/ignored 0을 확인했다. `git diff HEAD --check` exit 0. 최종 리뷰 APPROVE이며 추가 필수 수정 없음. 운영 ViewModel·legacy·DI·Gradle 및 빌드 설정은 변경하지 않았다. 릴리즈 컴파일 [blocked] 및 실기기/실서버 미검증은 유지한다. - 2026-10-13 커밋 전 검증: `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug :app:ktlintCheck` 첫 실행은 240초 명령 제한으로 종료돼 결과 미확정이었다. 이전 실행 종료 후 600초 제한으로 같은 명령을 재실행해 exit 0, BUILD SUCCESSFUL(2분 20초)을 확인했다. HTML 결과 전체 1,544개, 실패 0, ignored 0이며 debug assemble 및 ktlintCheck도 통과했다. `git diff HEAD --check`와 기존 HEAD 커밋 메시지 검증은 exit 0이다. release·Android lint·실서버·기기 검증은 재실행하지 않았으며 기존 제한 기록을 유지한다. - 2026-10-13 Phase 4 문서 추가: PRD §16 및 후속 Task/Gate만 작성했다. TDD 예외 사유는 문서만 변경하고 구현·테스트 작성 승인을 받지 않은 작업이기 때문이다. 대체 검증으로 두 문서의 제거/보존 대상·승인 조건·요구사항 연결을 대조하고 `git diff --check` exit 0을 확인했다. `./gradlew tasks --all`은 exit 0, BUILD SUCCESSFUL(5초)이며 계획의 test/build/ktlint task 존재를 확인했다. 이는 명령 목록 확인일 뿐 테스트·앱 빌드 실행이 아니다. Markdown LSP 미설정으로 LSP 진단은 수행할 수 없었다. 기존 `app/build.gradle` 변경은 보존했으며 release 최적화 비활성화 경고와 Gradle deprecation 경고는 수정하지 않았다. 구현 및 Phase 4 검증은 별도 승인 대기다. - 2026-10-13 사용자 release 확인: 사용자가 "release 빌드로 마이 탭 들어가 지는 것을 확인했다"고 보고한 뒤 충족된 항목의 문서 갱신을 요청했다. 검증 주체는 사용자이며 에이전트가 기기 QA나 release 빌드를 재실행한 것이 아니다. DEC-017에 따라 기능 범위와 Task 4.1을 완료 처리했다. 최적화 설정 및 release DEX/mapping은 미검증, 기존 ktlint 오류 6건은 마지막 실패 기록 그대로 남긴다. 이번 갱신은 문서에 한정하며 코드·테스트·빌드 설정 변경은 없다. - 2026-10-13 완료 문서 검증: PRD·계획·리뷰의 현재 판정과 사용자 검증 출처를 대조했고 미체크 체크박스는 0건이다. 문서 범위 `git diff --check` exit 0, `./gradlew tasks --all --console=plain` exit 0(2초)으로 명령 목록을 확인했다. Markdown LSP는 미설정이며 앱 빌드·테스트·lint는 재실행하지 않았다. release 최적화 비활성화 경고는 그대로 남아 있다. - 2026-10-13 Phase 4 커밋 전 검증: `P4-GATE`의 focused 테스트 명령에 `--console=plain`을 추가해 실행했다. exit 0, BUILD SUCCESSFUL(34초), 결과 XML 10개 클래스의 테스트 77개 모두 성공(실패·오류·skip 0)이다. `git diff --check` exit 0을 확인했다. 별도 사용자 변경인 `app/build.gradle`은 커밋에서 제외한다. 전체 테스트·assemble·ktlint·release 검증은 재실행하지 않았으며 기존 잔여 사항을 유지한다.