docs(auth): 미사용 인증 경로 정리와 검증을 기록한다

This commit is contained in:
2026-10-13 18:35:34 +09:00
parent 8830f364f5
commit 5daf1ef310
3 changed files with 158 additions and 4 deletions
@@ -4,9 +4,9 @@
| 항목 | 내용 |
|---|---|
| 문서 상태 | 구현 완료, 로컬 테스트·debug 빌드·ktlint 통과 |
| 문서 상태 | Phase 1~4 기능 범위 완료; release 마이 탭 사용자 확인 반영, 잔여 기술 검증 별도 기록 |
| 작성일 | 2026-10-12 |
| 최종 수정일 | 2026-10-12 |
| 최종 수정일 | 2026-10-13 |
| 대상 제품 | Android SodaLive 본인인증 및 성인 콘텐츠 보기 설정 |
| 작성자·결정권자 | 사용자 승인 필요 |
| 관련 API Contract | 별도 파일 없음, 본 문서 §8에 초안 계약 포함 |
@@ -17,6 +17,8 @@
요구사항과 정책 인터뷰 및 두 문서의 최종 사용자 승인이 완료됐다. 현재 브랜치에서 계획에 따라 구현한다.
2026-10-13 추가: 위 승인은 기존 구현에 대한 기록이다. §16의 미사용 인증 경로 제거는 문서 작성만 승인됐으며, 별도 사용자 승인 전에는 코드·테스트·빌드 설정을 변경하지 않는다.
## 1. Overview
Bootpay 본인인증을 마친 사용자가 모든 인증 진입점에서 같은 BottomSheet로 성인 콘텐츠 표시 여부와 취향을 함께 정하고 인증을 제출한다. 서버 인증 성공 뒤 7개 일반 경로는 기존 Splash 재시작을 유지하며, 오디오 상세 경로만 회원 정보를 동기화하고 현재 상세를 다시 불러온다.
@@ -132,6 +134,9 @@ Bootpay 본인인증을 마친 사용자가 모든 인증 진입점에서 같은
| 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. 추적 및 변경 관리
@@ -146,3 +151,34 @@ Bootpay 본인인증을 마친 사용자가 모든 인증 진입점에서 같은
- `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건은 미해결 잔여 기술 사항이며, 기능 완료와 구분한다.