# 본인인증 후 콘텐츠 보기 설정 PRD ## 문서 정보 | 항목 | 내용 | |---|---| | 문서 상태 | Phase 1~4 기능 범위 완료; release 마이 탭 사용자 확인 반영, 잔여 기술 검증 별도 기록 | | 작성일 | 2026-10-12 | | 최종 수정일 | 2026-10-13 | | 대상 제품 | Android SodaLive 본인인증 및 성인 콘텐츠 보기 설정 | | 작성자·결정권자 | 사용자 승인 필요 | | 관련 API Contract | 별도 파일 없음, 본 문서 §8에 초안 계약 포함 | | 관련 구현 계획 | [plan-task.md](plan-task.md) | | 관련 review | [최종 리뷰](reviews/phase2-auth-content-preference-review.md) | ### 요구사항 상태 요구사항과 정책 인터뷰 및 두 문서의 최종 사용자 승인이 완료됐다. 현재 브랜치에서 계획에 따라 구현한다. 2026-10-13 추가: 위 승인은 기존 구현에 대한 기록이다. §16의 미사용 인증 경로 제거는 문서 작성만 승인됐으며, 별도 사용자 승인 전에는 코드·테스트·빌드 설정을 변경하지 않는다. ## 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를 생략하지만 설정 완료 후 기존 전송 성공 프로세스를 실행 | 사용자 후속 요청 | | 2026-10-13 | DEC-014 | 확정 | 기존 인증 전환 작업의 연속으로 본 문서와 계획에 후속 항목만 추가한다. 구현은 별도 승인 전 금지 | 사용자 명시 지시 | | 2026-10-13 | DEC-015 | 제안 / 구현 승인 대기 | keep 규칙 추가 대신 미사용 인증 메서드·DI 의존성·전용 파일을 제거한다. §4의 레거시 변경 제외에 대한 예외는 §16 범위에 한해 별도 승인받는다 | 마이 탭 오류 조사 및 사용자 제거 방향 제안 | | 2026-10-13 | DEC-017 | 정정 / 확정 | 사용자 release 마이 탭 정상 진입 확인과 문서 갱신 요청에 따라 Phase 4 기능 범위를 완료 처리한다. 최적화 산출물 미검증·기존 lint 오류는 별도 잔여 사항으로 보존하며 통과로 바꾸지 않는다 | 사용자 직접 검증 보고 및 "충족 되었으면 문서를 갱신한다" 지시 | ## 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 컴파일은 기존 서명 설정 누락으로 미검증이며 실제 릴리즈 실행을 확인한 것으로 간주하지 않는다. ## 16. 인증 전환 후 미사용 경로 제거 (구현 승인됨) 2026-10-13 승인 갱신 `DEC-016`: 사용자의 "승인"으로 `CLEANUP-001~003` 및 최소 레거시 제거 예외가 확정됐다. 앞선 문서 작성 전용 기록은 당시 이력이며, 현재는 승인된 Phase 4를 실행한다. 빌드 설정 변경은 별도 승인 대상이다. ### 배경과 확인 범위 마이 탭 진입 시 `MyPageViewModel → AuthRepository → AuthApi` 생성 과정에서 `ClassCastException`이 보고됐다. 실제 인증 진입점은 `V2AuthFlow`로 전환됐지만 두 기존 ViewModel의 미사용 `authVerify()`와 생성자 의존성, Koin 등록이 남아 있다. 로컬 release `usage.txt`에서 기존 인증 메서드 제거를 확인했고, DEX에서 `AuthApi` 생성 결과가 null이 아니면 `ClassCastException`을 던지는 R8 생성 코드를 확인했다. 해당 산출물과 오류가 발생한 설치본의 동일성 및 기기 재현은 미확인이다. ### 후속 요구사항 | ID | 상태 | 요구사항 및 수용 기준 | 추적 | |---|---|---|---| | CLEANUP-001 | 확정 | `MyPageViewModel`, `AudioContentDetailViewModel`의 미사용 `authVerify()`와 `AuthRepository` 생성자 의존성을 제거하고 `AppDI`의 두 ViewModel 생성 인자 및 기존 인증 API/repository 등록을 함께 정리한다 | `P4-T1` | | CLEANUP-002 | 확정 | 참조 재확인 후 전용 `AuthApi.kt`, `AuthRepository.kt`, `AuthVerifyRequest.kt`를 삭제한다. V2 및 기존 테스트가 사용하는 `AuthResponse.kt`는 위치·계약 그대로 유지한다 | `P4-T1` | | CLEANUP-003 | 확정 | 기존 8개 인증 진입점, V2 요청/응답, 일반·오디오 후처리 및 디버그 시뮬레이션은 변경하지 않는다. keep 규칙 추가나 R8 비활성화로 우회하지 않는다 | `P4-GATE` | ### 승인 및 완료 기준 - 최초 허용 범위는 두 문서 갱신뿐이었다. Phase 1~3의 기존 승인·완료 상태와 별개로 DEC-016에서 후속 레거시 제거 승인을 받았다. - 사용자가 이 후속 범위의 구현을 승인한 뒤에만 §4의 레거시 변경 제외에 대한 최소 예외로 적용한다. `Auth.kt`, 공유 `AuthResponse`, 화면·인증 정책 변경과 무관한 정리는 제외한다. - 완료 증거는 미사용 경로 제거 회귀 테스트, 기존 V2 인증·DTO·오디오 라우팅 테스트, debug 빌드 및 최적화된 release 재빌드 산출물 확인이다. debug 테스트만으로 release 오류 해결을 확정하지 않는다. - release 빌드가 서명 등 환경 문제로 차단되면 해당 검증을 `[blocked]`로 남기고 설정을 임의로 우회하지 않는다. 기존 산출물 확인을 수정 후 재빌드 성공으로 대체하지 않는다. ### 승인 후 실행 상태 (2026-10-13) `CLEANUP-001/002`의 코드 제거와 공유 응답 보존을 반영했다. `CLEANUP-003`의 기존 동작 회귀를 포함한 전체 로컬 테스트 1,551개 및 debug 빌드가 통과했고 debug DEX에서 기존 인증 타입 참조 부재를 확인했다. release 빌드는 서명 설정 누락으로 차단됐으며 최적화 비활성화 경고도 있어 Phase 4 전체 완료를 선언하지 않는다. ktlint는 이번 변경과 무관한 기존 `ChatRepositoryTest.kt` 줄바꿈 오류 6건으로 실패했다. 세부 증거와 재개 조건은 계획의 `P4-GATE` 기록을 따른다. ### 사용자 확인 후 종료 상태 (2026-10-13, DEC-017) 사용자가 release 빌드에서 마이 탭 정상 진입을 직접 확인했다. 기존 코드 제거·자동 회귀·코드 리뷰 결과와 이 사용자 검증을 근거로 이번 마이 탭 오류 수정의 기능 범위를 완료 처리한다. 위 차단 기록은 당시 에이전트 실행 이력으로 보존한다. 사용자 확인 범위는 마이 탭 진입이며, 최적화 설정·release DEX/mapping 검사·오디오 상세 실기기 동작까지 확인한 것으로 확장하지 않는다. 최적화 산출물 미검증 및 기존 ktlint 오류 6건은 미해결 잔여 기술 사항이며, 기능 완료와 구분한다.