docs(auth): 콘텐츠 설정 구현과 검증 결과를 기록한다

This commit is contained in:
2026-10-13 11:31:01 +09:00
parent 248cd9dcb2
commit 739f57e5df
5 changed files with 450 additions and 0 deletions
@@ -0,0 +1,225 @@
# 본인인증 후 콘텐츠 보기 설정 구현 계획
| 항목 | 내용 |
|---|---|
| 상태 / 작성일 | 디버그 시뮬레이션 포함 구현 완료; release 컴파일은 서명 설정으로 검증 차단 / 2026-10-12 |
| 요구사항 / API | [prd.md](prd.md), §8의 확인된 API 계약 |
| 현재 Phase / Goal | Phase 1~3 및 회귀 수정 완료 / 없음 |
## 목표와 현재 상태
사용자 승인에 따라 여덟 인증 진입점에서 설정을 제출하고 후처리한다. Phase 1은 2/2, Phase 2는 기존 2/2 및 회귀 수정 P2-R1 완료다. 전체 로컬 테스트 1,535개, debug 빌드, ktlint가 통과했고 최종 리뷰는 APPROVE다. 실제 서버·기기 검증은 수행하지 않았다.
## 범위와 제약
- 포함: 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 권한은 이미 허가됐다.
- 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<ApiResponse<AuthResponse>>`를 반환한다. 일반 성공은 현재 호스트에서 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<AuthResponse>`의 `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<AuthResponse>(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 실행은 서명 설정 차단으로 미검증이다.
## 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에서 작업하며 커밋하지 않는다. |
### 구현 시작 기록
- 로직 요청/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 금지.
## Verification Log
- 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·실서버·기기 검증은 재실행하지 않았으며 기존 제한 기록을 유지한다.
@@ -0,0 +1,148 @@
# 본인인증 후 콘텐츠 보기 설정 PRD
## 문서 정보
| 항목 | 내용 |
|---|---|
| 문서 상태 | 구현 완료, 로컬 테스트·debug 빌드·ktlint 통과 |
| 작성일 | 2026-10-12 |
| 최종 수정일 | 2026-10-12 |
| 대상 제품 | Android SodaLive 본인인증 및 성인 콘텐츠 보기 설정 |
| 작성자·결정권자 | 사용자 승인 필요 |
| 관련 API Contract | 별도 파일 없음, 본 문서 §8에 초안 계약 포함 |
| 관련 구현 계획 | [plan-task.md](plan-task.md) |
| 관련 review | [최종 리뷰](reviews/phase2-auth-content-preference-review.md) |
### 요구사항 상태
요구사항과 정책 인터뷰 및 두 문서의 최종 사용자 승인이 완료됐다. 현재 브랜치에서 계획에 따라 구현한다.
## 1. Overview
Bootpay 본인인증을 마친 사용자가 모든 인증 진입점에서 같은 BottomSheet로 성인 콘텐츠 표시 여부와 취향을 함께 정하고 인증을 제출한다. 서버 인증 성공 뒤 7개 일반 경로는 기존 Splash 재시작을 유지하며, 오디오 상세 경로만 회원 정보를 동기화하고 현재 상세를 다시 불러온다.
## 2. Problem Statement
- 현재 `Auth.auth` 완료 직후 인증 POST가 실행되어 사용자가 인증과 콘텐츠 보기 설정을 함께 선택할 수 없다.
- 구식 인증 요청·응답은 영수증과 성별 중심이며 설정 선호도를 제출하지 않는다.
- 성공 후 일반 화면과 오디오 상세의 후속 처리가 다르므로 동작을 명확히 분리해야 한다.
해결 기준은 8개 진입점의 공통 선택 UI, 합의한 요청 payload, 각 경로의 성공 후처리를 테스트로 확인하는 것이다.
## 3. Goals
- 인증 완료와 인증 POST 사이에 설정 선택 BottomSheet를 한 번 표시한다.
- 사용자 선택을 인증 POST에 포함하고 성공 뒤 요청 경로별 후속 동작을 보장한다.
- 기존 저장 설정을 초기값으로 사용하거나 별도 설정 PATCH를 보내지 않는다.
## 4. Non-Goals
- `Auth.kt`, 구식 DTO/API/repository, `MyPageViewModel`, `AudioContentDetailViewModel`의 기존 흐름 변경은 기본 제외한다.
- 별도 설정 PATCH, 설정 화면 전면 수정, 성별 기반 취향 추론은 제외한다.
- 문서 승인 전에는 제품 코드를 구현하지 않는다.
## 5. 사용자 및 권한
로그인 사용자가 Bootpay 인증 절차를 정상 완료한 경우에만 선택 UI와 인증 요청을 진행한다. Bootpay 취소·오류는 인증 제출을 진행하지 않는다. 토큰은 기존 사용자 API 인증 관례를 따르며 기록하거나 화면에 노출하지 않는다.
## 6. 핵심 사용자 흐름
1. 사용자가 인증을 시작하고 Bootpay를 완료한다.
2. 모든 8개 진입점에서 같은 BottomSheet를 표시한다. 초기값은 기존 로컬 상태와 무관하게 ON 및 `ALL`이다.
3. ON일 때 `ALL`, `MALE`, `FEMALE` 중 하나를 선택한다. OFF 전환은 `contentType`을 `ALL`로 초기화하고 selector를 숨겨 OFF caption을 표시한다.
4. 완료 버튼만 닫기 경로다. 배경, system back, swipe 모두 닫지 않는다. 완료 탭은 Sheet를 닫은 뒤 선택값으로 인증+설정 POST를 보낸다.
5. 일반 7개 경로는 POST 성공 후 제출 설정을 저장하고 기존 Splash를 재시작한다. 실패하면 오류 표시 후 같은 선택값의 Sheet를 다시 연다. 오디오 상세는 POST 성공 후 회원 정보 GET 성공, 설정 저장, 기존 `getAudioContentDetail` 재호출 순이며 재시작하지 않는다.
## 7. 기능 요구사항
| ID | 상태 | 요구사항 및 수용 기준 |
|---|---|---|
| AUTH-001 | 확정 | `Auth.auth` 8개 진입점 모두 Bootpay 완료 후, 인증 POST 전 동일 BottomSheet를 연다. 취소·오류에서는 POST하지 않는다. |
| PREF-001 | 확정 | 매번 초기값은 ON + `ALL`. OFF 전환 시 `contentType=ALL`, selector 숨김 및 OFF caption. |
| PREF-002 | 확정 | 완료 버튼만 닫을 수 있고 background/back/swipe는 닫지 않는다. 완료 tap은 Sheet close 후 POST. |
| API-001 | 확정 | 요청 본문은 `receipt_id`, `isAdultContentVisible: Boolean`, `contentType: ALL/MALE/FEMALE`. 기존 응답은 `Single<ApiResponse<AuthResponse>>`이며 `success/data/message/errorProperty` envelope, `AuthResponse.gender: Int`만 포함한다. |
| FLOW-001 | 확정 | 일반 7개는 성공 시 제출 설정 저장 후 기존 Splash restart. 실패는 오류 후 동일 선택 Sheet 재오픈. |
| FLOW-002 | 확정 | 오디오 상세는 POST 성공 후 `GET /member/info`, 서버 `isAuth`/선호도 저장 후 상세 재조회, Activity restart 없음. GET 실패는 POST 재전송 없이 GET만 재시도. |
| DATA-001 | 확정 | member response의 nullable 선호도 fallback은 제출 선택값(기술 선택). `isAuth` 그대로 보존, gender로 contentType 유추 금지. |
| DATA-002 | 확정 | Sheet 변경만으로 별도 PATCH하지 않는다. 선호도는 POST 성공 후 반영한다. |
| SCOPE-001 | 확정 | 사용자는 아래 7개 legacy caller의 최소 wiring을 허가했다. 공용 legacy 인증 구현 변경은 포함하지 않는다. |
## 8. API 계약 초안
| 항목 | 계약 |
|---|---|
| Endpoint | `POST /auth` |
| 인증 | 기존 `Authorization: Bearer` token header 사용; token은 문서에 기록하지 않음 |
| 요청 | `receipt_id`, `isAdultContentVisible: Boolean`, `contentType: ContentType.name`; OFF도 enum 포함 |
| 응답 | 기존 `Single<ApiResponse<AuthResponse>>`; envelope는 `success: Boolean`, `data: AuthResponse?`, `message: String?`, `errorProperty?`; `AuthResponse`는 `gender: Int`만 포함 |
| 후속 조회 | 오디오 POST 성공 후 `GET /member/info`; `isAuth`와 서버 선호도 사용. nullable 선호도는 제출값 fallback(기술 선택) |
| 별도 PATCH | Sheet 변경을 위한 PATCH 없음 |
기존 인증 응답은 성별만 포함하므로 새 v2 adapter는 응답 gender를 로컬 설정에 쓰지 않고 기존 legacy gender-overwrite 흐름도 우회한다. 완료된 POST 뒤 설정을 반영한다.
```json
{
"receipt_id": "test-receipt",
"isAdultContentVisible": true,
"contentType": "ALL"
}
```
서버 지원은 사용자 확인으로 확정됐으며 실제 서버 요청 검증은 아직 하지 않았다. 실패 응답은 기존 `message` 또는 `common_error_unknown` 안내를 사용한다. 요청 중에는 중복 제출을 막고 loading을 표시한다. 오디오 GET-only 재시도에서는 이미 서버에 제출한 설정을 유지하며 재선택·추가 POST를 허용하지 않는다.
## 9. UI/UX 기대사항
- ON 디자인: https://www.figma.com/design/HmN1yNdJ3EIpqknFL0Hkab?node-id=2489-32150
- OFF 디자인: https://www.figma.com/design/HmN1yNdJ3EIpqknFL0Hkab?node-id=2489-32163
- 공통 Android BottomSheet로 두 상태를 표현한다. 정확한 문구·수치·간격은 링크 디자인 및 승인된 리소스 기준으로 구현 시 확인한다.
- 배경, system back, swipe 닫힘을 모두 막는다. 완료 버튼만 닫을 수 있다.
## 10. 보안 및 데이터 취급
실제 영수증 ID와 인증 token을 log, Toast, 테스트 fixture에 기록하지 않는다. 테스트에는 가짜 영수증만 사용한다. 요청은 기존 인증 API의 인증 경계를 따른다. 로컬 preference는 성공 처리 시점에만 저장하며, 서버 `isAuth=false`도 그대로 저장한다.
## 11. 성공 기준
- [x] 8개 진입점 모두 같은 UI를 거쳐 요청하고, 최초값이 ON/ALL이다.
- [x] payload의 receipt id, Boolean, enum name 및 요청 순서 테스트가 통과한다.
- [x] 일반 경로 성공은 Splash를 재시작하고 오디오 상세는 member GET 후 상세를 갱신한다.
- [x] 실패 후 동일 선택 재오픈, nullable 선호도 fallback 및 `isAuth=false` 보존이 검증된다.
- [x] 오디오 GET 재시도는 POST를 재전송하지 않으며 미완료 GET 실패 상태에서 선호도를 commit하지 않는다.
완료 판단 근거는 로컬 자동 테스트와 코드 검토다. 실제 본인인증 서버·기기·시각 QA는 수행하지 않았으며, 기존 Auth launcher의 SDK payload 로그는 이번 변경 범위 밖으로 남긴다.
## 12. 승인 상태
정책 인터뷰와 최종 사용자 승인이 완료돼 구현을 진행한다. 최소 wiring 권한을 받은 legacy caller 7개는 `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이며 legacy 목록에 포함하지 않는다. 모든 Kotlin 파일 경로는 `app/src/main/java/kr/co/vividnext/sodalive/` 기준이다.
## 13. Decision Log
| 날짜 | ID | 상태 | 결정 또는 요구 | 근거 |
|---|---|---|---|---|
| 2026-10-12 | DEC-001 | 확정 | 공통 UI는 8개 `Auth.auth` 진입점에서 Bootpay 완료 후 POST 전에 노출, 기본 ON/ALL | 사용자 요구 |
| 2026-10-12 | DEC-002 | 확정 | 완료 버튼 후 Sheet를 닫고 인증+선호도 POST, 배경 탭은 닫기 불가 | 사용자 명시 요구 |
| 2026-10-12 | DEC-003 | 확정 | 일반 7개 경로는 Splash 재시작, 오디오 상세는 POST→member GET→저장→상세 reload, 재시작 없음 | 사용자 승인 처리 방식 |
| 2026-10-12 | DEC-004 | 확정 | `isAuth` 서버 값 보존, 성별 추론 및 별도 PATCH 금지 | 승인한 로컬 동기화 흐름; nullable fallback은 DEC-010 기술 선택 |
| 2026-10-12 | DEC-005 | 확정 | OFF 전환 시 `contentType=ALL` | 사용자 확인 |
| 2026-10-12 | DEC-006 | 확정 | POST 실패 시 오류 후 같은 선택값 Sheet 재오픈; 완료 시 닫은 뒤 요청 | 사용자 확인 |
| 2026-10-12 | DEC-007 | 확정 | 오디오 member GET 실패는 GET만 재시도하고 POST 재전송/미완료 상태 commit 금지 | 사용자 확인 |
| 2026-10-12 | DEC-008 | 확정 | 배경/back/swipe 닫기 차단, 완료만 닫기 | 최초 요청의 '설정 완료 터치시에만 닫힘' 기준 |
| 2026-10-12 | DEC-009 | 확정 | 7개 legacy caller 최소 wiring 허용. `V2AccessGuard`는 별도 v2 caller | 사용자 확인 |
| 2026-10-12 | DEC-010 | 기술 선택 | 오디오 GET nullable 선호도는 제출 선택값으로 fallback; 일반 경로는 POST 성공 후 제출값 저장 | 기존 `MainV2ViewModel` 저장 관례 및 사용자 요구 일관성 |
| 2026-10-12 | DEC-011 | 확정 | 이번에는 문서만 작성하고 최종 문서 승인 후 구현 시작 | 사용자 문서·승인 절차 지시 |
| 2026-10-12 | DEC-012 | 확정 | 문서대로 구현 시작, worktree 없이 현재 브랜치에서 작업 | 사용자 최종 구현 승인 |
| 2026-10-12 | DEC-013 | 확정 | 디버그는 실제 본인인증과 인증 POST를 생략하지만 설정 완료 후 기존 전송 성공 프로세스를 실행 | 사용자 후속 요청 |
## 14. 추적 및 변경 관리
`AUTH-001`, `PREF-001/002`, `API-001`, `FLOW-001/002`, `DATA-001/002`, `SCOPE-001`은 [plan-task.md](plan-task.md)의 Phase와 회귀 테스트로 추적한다. 인터뷰는 완료됐으며 최종 문서 승인 전 코드를 변경하지 않는다. 요구사항이 바뀌면 Decision Log와 계획을 먼저 갱신한다.
## 15. 디버그 인증 시뮬레이션 추가
- `DEBUG-001` 확정: `BuildConfig.DEBUG`인 빌드에서 인증 시도 시 실제 Bootpay를 호출하지 않고 짧은 로딩 후 기존 ON/ALL BottomSheet를 연다. 로딩은 테스트용 500ms로 구현한다.
- `DEBUG-002` 확정: 설정 완료는 `/auth` POST 없이 메모리 성공 응답을 기존 ViewModel에 전달한다. 단순 닫기 대신 기존 저장·완료 후처리를 실행한다.
- `DEBUG-003` 기존 후처리 유지: 일반 경로는 제출 설정을 로컬에 저장한 뒤 Splash로 재시작한다. 오디오 경로는 실제 회원 GET→서버 인증 상태·설정 저장→상세 갱신을 유지한다. 서버 인증 상태를 임의로 true로 만들지 않는다.
- `DEBUG-004` 제약: 서버에는 설정/인증 결과가 저장되지 않는다. 회원 재조회 시 서버 값이 로컬 선택을 덮어쓸 수 있고, 서버의 성인 권한이 생기지 않는다. 이 한계를 사용자에게 구현 전에 안내했다.
- `DEBUG-005` 격리: 릴리즈는 기존 실제 본인인증·POST 경로 그대로다. Intent/환경설정으로 시뮬레이션을 켜는 기능은 추가하지 않는다. 테스트는 디버그 경로와 실제 경로를 각각 검증한다.
구현 완료: 운영 변경은 `V2AuthFlow.kt`의 진입·API 선택에 한정했고 기존 성공 처리 로직을 재사용했다. 전체 debug 로컬 테스트 1,544개/빌드/ktlint 통과, [Phase3 리뷰](reviews/phase3-debug-auth-simulation-review.md) APPROVE. release Kotlin 컴파일은 기존 서명 설정 누락으로 미검증이며 실제 릴리즈 실행을 확인한 것으로 간주하지 않는다.
@@ -0,0 +1,42 @@
# 본인인증 후 콘텐츠 보기 설정 최종 리뷰
## 리뷰 정보
| 항목 | 내용 |
|---|---|
| 대상 | Phase 1~2, 현재 main working tree 및 staged 신규 파일 |
| 일자 | 2026-10-12 |
| 리뷰어 | Oracle, 부모 확인 |
| 기준 | [PRD](../prd.md), [구현 계획](../plan-task.md) |
| 상태 | 수정 검증 완료, APPROVE |
## 검토 범위와 증거
신규 v2/auth API·상태·수명주기·BottomSheet·리소스·테스트와 인증 진입점 8곳을 검토했다. 부모가 전체 로컬 테스트 1,534개/실패 0 및 debug assemble exit 0을 확인했다. 신규 코드 린트 형식 수정 후 담당이 ktlintCheck exit 0 및 집중 테스트 60개 통과를 확인했다. 실서버·기기·시각 QA는 승인 범위에서 제외하며 실행하지 않았다.
## 발견 사항
### REV-P2-001: 오디오 상세 재조회 실패 시 화면 종료 회귀
- 심각도: Medium (P2), 확정.
- 요구사항: FLOW-002, 기존 상세 갱신 동작 유지.
- 대상: `app/src/main/java/kr/co/vividnext/sodalive/audio_content/detail/AudioContentDetailActivity.kt` 인증 완료 Fragment Result listener.
- 근거: 새 listener가 `getAudioContentDetail(audioContentId) { finish() }`를 호출한다. 기존 `AudioContentDetailViewModel.authVerify`는 실패 callback 없이 같은 조회를 실행했다.
- 재현 조건: 인증 POST/회원 GET 성공 후 상세 GET이 오류 또는 success=false로 응답하면 새 listener의 실패 callback 때문에 Activity가 종료된다.
- 최소 수정: 새 listener의 `{ finish() }`만 제거한다. 최초 진입 등 기존 다른 조회나 legacy ViewModel은 바꾸지 않는다.
- 회귀 검증: 인증 완료 listener의 상세 조회 계약을 기존 소스 라우팅 테스트로 고정하고 오류 발생 시 종료 callback을 주입하지 않음을 검증한다. 기존 실제 ViewModel 오류 처리도 근거로 확인한다.
- 후속 Task: `P2-R1`.
## 기타 판정
초기 ON/ALL, OFF→ALL, 완료 전 미전송·미저장, 닫힌 뒤 POST, POST 실패 선택 복원, GET-only retry, 서버 isAuth=false 반영, RESUMED 완료 처리, 신규 transport 로그 차단에는 추가 차단 사항을 발견하지 못했다. 기존 `Auth.kt`의 SDK payload 로그/오류 Toast는 수정 이전 코드이며 이번 변경에 포함하지 않았다.
## 판정 기록
- 2026-10-12: REV-P2-001 확정, gate BLOCK. 구현 전에 계획에 회귀 수정 Task를 추가했다.
- 2026-10-12: P2-R1에서 listener 실패 종료 callback 한 줄을 제거했다. 소스 라우팅 회귀 테스트 RED 1개 후 집중 64개와 ktlintCheck GREEN. 최초 진입·기타 상세 조회와 legacy ViewModel은 변경하지 않았다.
- 2026-10-12: Oracle 수정분 재검토 결과 REV-P2-001 ADDRESSED, 최종 Gate APPROVE, 추가 필수 수정 없음. 부모가 `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug :app:ktlintCheck` exit 0과 전체 1,535개 실패/ignored 0을 확인했다.
## 최종 검증 한계
오디오 Activity 연결은 기존 소스 라우팅 테스트로 고정하고 공통 흐름은 로컬 Robolectric 호스트로 실행했다. 실제 오디오 화면 전체 및 실서버 인증을 실행한 증거는 아니다. 기기·실서버·시각 QA 미실행을 유지하며, 이번 범위 밖의 기존 SDK 로그 위험은 별도 후속 검토 대상이다.
@@ -0,0 +1,27 @@
# 디버그 인증 시뮬레이션 리뷰
## 리뷰 정보
- 범위: Phase3 `V2AuthFlow.kt`, `V2AuthFlowTest.kt`와 PRD §15.
- 일자/리뷰어: 2026-10-12, Oracle.
- 상태: 수정 검증 완료 (APPROVE), release 실행 검증은 환경 차단.
- 실행 증거: 부모의 전체 debug 로컬 테스트 1,544개 실패/ignored 0, debug assemble 및 ktlint exit 0. release 컴파일은 기존 서명 설정 누락으로 차단됐으며 우회하지 않았다.
## REV-P3-001: 공용 테스트가 DEBUG=true를 요구함
- 심각도: Medium, 확정.
- 대상: `app/src/test/java/kr/co/vividnext/sodalive/v2/auth/V2AuthFlowTest.kt`의 기본 빌드 선택 테스트.
- 근거: `assertTrue(BuildConfig.DEBUG)`와 무조건 Bootpay 미호출/지연 후 Sheet를 기대한다. 공용 src/test는 release variant에서도 실행돼 false일 때 반드시 실패한다.
- 수정 범위: 현재 빌드의 실제 기본 selector를 검증하되 debug는 지연/SDK 미호출, release는 실제 SDK 호출/완료 후 POST를 각각 검증한다. 기존 강제 simulate=true/false 시나리오는 유지한다.
- 회귀 검증: auth 집중 테스트 및 ktlint; release 실행은 서명 설정 누락으로 여전히 [blocked]이며 정적 분기와 기존 simulate=false 실제 경로 회귀로 보완한다. 이 제한을 통과로 표시하지 않는다.
- 후속 Task: 계획 문서 `P3-R1`.
## 기타 검토
운영 코드의 BuildConfig.DEBUG 단일 선택, fake API/실제 API 분리, 파괴 시 지연 취소, RESUMED UI 표시, 디버그 단일 대기, 기존 오디오 회원 GET/서버값 저장에는 추가 필수 수정이 없었다. 실기기·실서버 검증은 수행하지 않았다.
## 판정 기록
- 2026-10-12: REV-P3-001 확정, BLOCK. 운영 코드 변경 없이 테스트의 variant 전제를 수정한다.
- 2026-10-12: 기본 build test의 동작 검증을 삭제하지 않고 실제 BuildConfig에 따라 debug/실제 인증의 기대 결과를 각각 검사했다. 기존 강제 true/false 시나리오와 운영 코드는 유지했다. auth 55개 및 ktlintCheck 통과.
- 2026-10-12: Oracle 수정분 재검토 REV-P3-001 ADDRESSED, 최종 APPROVE. 부모 전체 테스트 재실행 1,544개 실패/ignored 0, debug assemble 및 ktlintCheck exit 0. release 컴파일은 기존 서명 설정 누락으로 미검증이며 우회하지 않았다.
+8
View File
@@ -155,6 +155,14 @@ Gift 개인정보·재생성 라우팅·modal 회귀 테스트 예시:
``` ```
같은 테스트 결과 XML에 동시에 쓰지 않도록 다른 Gradle 테스트 실행이 끝난 뒤 직렬 실행한다. `GiftNavigationTest`는 Robolectric local unit test이며 기기·계측 테스트가 아니다. 같은 테스트 결과 XML에 동시에 쓰지 않도록 다른 Gradle 테스트 실행이 끝난 뒤 직렬 실행한다. `GiftNavigationTest`는 Robolectric local unit test이며 기기·계측 테스트가 아니다.
본인인증 후 콘텐츠 보기 설정 테스트 예시:
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.V2AuthViewModelTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.V2AuthVerifyRequestTest"
```
인증 설정 테스트는 요청 직렬화와 상태·저장·재시도 계약을 검증한다. 실제 본인인증 서버나 기기 UI는 호출하지 않는다.
참고: 참고:
- 신규 Kotlin 테스트 메서드는 backtick 함수명을 사용하고, 테스트명은 한글 문장으로 작성한다. - 신규 Kotlin 테스트 메서드는 backtick 함수명을 사용하고, 테스트명은 한글 문장으로 작성한다.
- 기존 영어 테스트명을 수정하지 않는 최소 변경 상황을 제외하고, 새 테스트명에 영어 문장을 사용하지 않는다. - 기존 영어 테스트명을 수정하지 않는 최소 변경 상황을 제외하고, 새 테스트명에 영어 문장을 사용하지 않는다.