docs(auth): 콘텐츠 설정 구현과 검증 결과를 기록한다
This commit is contained in:
@@ -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 컴파일은 기존 서명 설정 누락으로 미검증이며 실제 릴리즈 실행을 확인한 것으로 간주하지 않는다.
|
||||
Reference in New Issue
Block a user