# 본인인증 후 콘텐츠 보기 설정 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 컴파일은 기존 서명 설정 누락으로 미검증이며 실제 릴리즈 실행을 확인한 것으로 간주하지 않는다.