From 739f57e5df52d5fb1464d3166c3b11bfa69b16fe Mon Sep 17 00:00:00 2001 From: klaus Date: Tue, 13 Oct 2026 11:31:01 +0900 Subject: [PATCH] =?UTF-8?q?docs(auth):=20=EC=BD=98=ED=85=90=EC=B8=A0=20?= =?UTF-8?q?=EC=84=A4=EC=A0=95=20=EA=B5=AC=ED=98=84=EA=B3=BC=20=EA=B2=80?= =?UTF-8?q?=EC=A6=9D=20=EA=B2=B0=EA=B3=BC=EB=A5=BC=20=EA=B8=B0=EB=A1=9D?= =?UTF-8?q?=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../plan-task.md | 225 ++++++++++++++++++ .../prd.md | 148 ++++++++++++ .../phase2-auth-content-preference-review.md | 42 ++++ .../phase3-debug-auth-simulation-review.md | 27 +++ docs/agent-guides/build-test-style.md | 8 + 5 files changed, 450 insertions(+) create mode 100644 docs/20261012_본인인증_후_콘텐츠_보기_설정/plan-task.md create mode 100644 docs/20261012_본인인증_후_콘텐츠_보기_설정/prd.md create mode 100644 docs/20261012_본인인증_후_콘텐츠_보기_설정/reviews/phase2-auth-content-preference-review.md create mode 100644 docs/20261012_본인인증_후_콘텐츠_보기_설정/reviews/phase3-debug-auth-simulation-review.md diff --git a/docs/20261012_본인인증_후_콘텐츠_보기_설정/plan-task.md b/docs/20261012_본인인증_후_콘텐츠_보기_설정/plan-task.md new file mode 100644 index 00000000..870cc2d8 --- /dev/null +++ b/docs/20261012_본인인증_후_콘텐츠_보기_설정/plan-task.md @@ -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>`를 반환한다. 일반 성공은 현재 호스트에서 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 실행은 서명 설정 차단으로 미검증이다. + +## 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·실서버·기기 검증은 재실행하지 않았으며 기존 제한 기록을 유지한다. diff --git a/docs/20261012_본인인증_후_콘텐츠_보기_설정/prd.md b/docs/20261012_본인인증_후_콘텐츠_보기_설정/prd.md new file mode 100644 index 00000000..cb929e70 --- /dev/null +++ b/docs/20261012_본인인증_후_콘텐츠_보기_설정/prd.md @@ -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>`이며 `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>`; 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 컴파일은 기존 서명 설정 누락으로 미검증이며 실제 릴리즈 실행을 확인한 것으로 간주하지 않는다. diff --git a/docs/20261012_본인인증_후_콘텐츠_보기_설정/reviews/phase2-auth-content-preference-review.md b/docs/20261012_본인인증_후_콘텐츠_보기_설정/reviews/phase2-auth-content-preference-review.md new file mode 100644 index 00000000..ee964ba7 --- /dev/null +++ b/docs/20261012_본인인증_후_콘텐츠_보기_설정/reviews/phase2-auth-content-preference-review.md @@ -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 로그 위험은 별도 후속 검토 대상이다. diff --git a/docs/20261012_본인인증_후_콘텐츠_보기_설정/reviews/phase3-debug-auth-simulation-review.md b/docs/20261012_본인인증_후_콘텐츠_보기_설정/reviews/phase3-debug-auth-simulation-review.md new file mode 100644 index 00000000..95d957b4 --- /dev/null +++ b/docs/20261012_본인인증_후_콘텐츠_보기_설정/reviews/phase3-debug-auth-simulation-review.md @@ -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 컴파일은 기존 서명 설정 누락으로 미검증이며 우회하지 않았다. diff --git a/docs/agent-guides/build-test-style.md b/docs/agent-guides/build-test-style.md index 207d63c8..778f4589 100644 --- a/docs/agent-guides/build-test-style.md +++ b/docs/agent-guides/build-test-style.md @@ -155,6 +155,14 @@ Gift 개인정보·재생성 라우팅·modal 회귀 테스트 예시: ``` 같은 테스트 결과 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 함수명을 사용하고, 테스트명은 한글 문장으로 작성한다. - 기존 영어 테스트명을 수정하지 않는 최소 변경 상황을 제외하고, 새 테스트명에 영어 문장을 사용하지 않는다.