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,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 컴파일은 기존 서명 설정 누락으로 미검증이며 우회하지 않았다.