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
@@ -2,20 +2,23 @@
| 항목 | 내용 |
|---|---|
| 상태 / 작성일 | 디버그 시뮬레이션 포함 구현 완료; release 컴파일은 서명 설정으로 검증 차단 / 2026-10-12 |
| 상태 / 작성일 | Phase 1~4 기능 범위 완료; release 마이 탭 사용자 확인 반영, 잔여 기술 검증 별도 기록 / 2026-10-12 |
| 요구사항 / API | [prd.md](prd.md), §8의 확인된 API 계약 |
| 현재 Phase / Goal | Phase 1~3 및 회귀 수정 완료 / 없음 |
| 현재 Phase / Goal | Phase 4 기능 완료, Task 1/1 / 활성 Goal 없음 |
## 목표와 현재 상태
사용자 승인에 따라 여덟 인증 진입점에서 설정을 제출하고 후처리한다. Phase 1은 2/2, Phase 2는 기존 2/2 및 회귀 수정 P2-R1 완료다. 전체 로컬 테스트 1,535개, debug 빌드, ktlint가 통과했고 최종 리뷰는 APPROVE다. 실제 서버·기기 검증은 수행하지 않았다.
2026-10-13 후속 상태: Phase 1~3의 완료·검증 기록은 유지한다. 마이 탭 오류에 대응하는 Phase 4는 기존 인증 전환의 연속으로 문서만 추가하며, 사용자 별도 승인 전에는 테스트 작성·제품 코드 수정·파일 삭제·빌드 설정 변경을 시작하지 않는다. 이전 release 검증 차단 기록은 아래에 보존한다.
## 범위와 제약
- 포함: v2/auth 요청 adapter, 상태 및 공통 BottomSheet, 8개 caller 연결, 일반 7경로 Splash 재시작, 오디오 상세 member GET/상세 reload, local unit 및 access regression 테스트, debug assemble.
- 제외: 승인 전 코드, 설정 PATCH, 성별 유추, `AudioContentDetailViewModel` 및 legacy 공용 인증/API/DTO/repository/`MyPageViewModel` 변경, UI instrumentation/device/screenshot QA.
- 신규 UI와 연결 코드는 `kr.co.vividnext.sodalive.v2` 하위, 새 인증 구현은 `v2.auth` 하위에 둔다. 기존 Retrofit/Rx/BottomSheet 관례와 `UserRepository.getMemberInfo`, 기존 상세 reload callback을 우선 재사용한다.
- 시작 조건: 두 문서의 최종 사용자 승인. 7개 legacy caller 최소 wiring 권한은 이미 허가됐다.
- 후속 범위 예외 제안: Phase 4에 한해 두 legacy ViewModel과 `AppDI`, 미사용 인증 전용 파일의 최소 제거를 별도 승인받는다. 기존 wiring 승인으로 이 범위를 실행하지 않는다.
- worktree 없이 현재 `main` 브랜치에서 작업한다. 의존성을 추가하지 않고 커밋·푸시는 별도 요청 없이는 하지 않는다.
- `app/src/test` 로직/local unit test만 계획한다. 레이아웃 속성 테스트·`androidTest`·기기 조작·스크린샷 QA는 하지 않는다. 신규 test 추가 시 `docs/agent-guides/build-test-style.md` 단일 실행 예시를 갱신한다.
@@ -183,6 +186,64 @@ Kotlin 운영 경로는 `app/src/main/java/kr/co/vividnext/sodalive/`, 테스트
**검증 기록 (2026-10-12):** 기본 build test는 debug 시 SDK/POST 미호출과 500ms 진입, release 시 실제 SDK 완료 callback/POST 1회/Splash를 각각 검증하도록 수정했다. auth 집중 55개 및 ktlintCheck exit 0, 부모 전체 재실행 1,544개 실패/ignored 0 및 debug assemble·ktlint exit 0. Oracle 수정분 판정 ADDRESSED / APPROVE. release 실행은 서명 설정 차단으로 미검증이다.
## Phase 4: 미사용 인증 경로 제거
**승인 갱신 (2026-10-13, DEC-016):** 사용자의 명시적 승인으로 아래 최소 레거시 변경 및 회귀 테스트를 시작했다. 이전 승인 대기 기록은 보존하며, 승인 당시 활성 Goal은 `P4-T1`이었다. 현재 코드는 반영됐고 `P4-GATE`의 release 검증이 차단돼 있다. 빌드 설정은 변경하지 않는다.
**Phase 결과:** 마이 탭과 오디오 상세 ViewModel 생성에서 사용하지 않는 기존 인증 API 의존성을 없애고, 현재 V2 인증 동작은 유지한다.
**선행조건:** PRD §16 `CLEANUP-001~003` 및 아래 레거시 제거 범위에 대한 사용자 명시적 구현 승인. 현재는 문서 작성만 승인됐으며 `0/1` Task, 활성 Goal 없음이다.
위 선행조건의 문서 작성 전용 상태는 승인 전 이력이다. DEC-016으로 구현 시작 조건은 충족됐으며 완료 여부는 아래 체크리스트와 Gate 기록을 따른다.
#### Task 4.1 미사용 인증 의존성과 전용 파일 제거
**Goal `P4-T1`:** 기존 인증 메서드·생성자 의존성·Koin 등록을 함께 제거해 `AuthApi` 생성 경로를 없앤다.
- 시작 조건: 별도 구현 승인 후 전체 `app/src` 참조 재검색. 새로운 실사용 호출부가 발견되면 삭제하지 않고 범위를 다시 확인한다.
- Modify: `mypage/MyPageViewModel.kt`, `audio_content/detail/AudioContentDetailViewModel.kt`, `di/AppDI.kt`.
- Delete: `mypage/auth/AuthApi.kt`, `mypage/auth/AuthRepository.kt`, `mypage/auth/AuthVerifyRequest.kt`.
- Test: 기존 `app/src/test/java/kr/co/vividnext/sodalive/v2/main/MainV2LoginGuardSourceTest.kt`에 제거 경로 회귀 검사를 추가한다. 테스트 클래스 신설·이동은 하지 않는다.
- Interfaces: `MyPageViewModel(UserRepository, NoticeRepository)`와 `AudioContentDetailViewModel(AudioContentRepository, UserRepository, ReportRepository, AudioContentCommentRepository)`로 생성자 및 DI 호출을 맞춘다. `V2AuthApi.verify(V2AuthVerifyRequest, String): Single<ApiResponse<AuthResponse>>`는 유지한다.
- 범위 밖: `Auth.kt`, `AuthResponse.kt`, V2 운영 코드와 8개 진입점 변경, keep 규칙 추가, minify/서명 설정 변경, 관련 없는 정리·의존성 추가.
- [x] **RED:** 기존 source test에 두 ViewModel의 `authVerify`/`AuthRepository` 부재, `AppDI`의 기존 `AuthApi`/`AuthRepository` 등록 부재, 삭제 대상 3개 파일 부재를 검증하는 테스트를 추가한다. 단어 경계로 기존 타입만 검사해 `V2AuthApi` 등은 오탐하지 않는다. 기존 8개 진입점 assertion은 유지한다.
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.MainV2LoginGuardSourceTest"`에서 미사용 경로가 남아 있어 발생하는 assertion 실패를 확인한다.
- [x] **GREEN:** 두 ViewModel의 미사용 메서드와 인증 의존성, DI 생성 인자·등록을 함께 정리하고 전용 3개 파일을 삭제한다. 이 제거로만 불필요해진 import를 정리하며 공유 `AuthResponse`는 보존한다.
- [x] **GREEN 확인:** 같은 focused test를 재실행하고 운영 소스에서 기존 타입·`authVerify` 참조가 0건인지 확인한다. V2 및 DTO 테스트의 `AuthResponse` 참조는 유지한다.
- [x] **REFACTOR:** 추가 구조 변경 없이 아래 Gate를 실행하고 실제 결과를 누적한다. 실패 테스트 삭제·완화로 통과시키지 않는다.
**조사 기록 (2026-10-13, 구현 전):** 기존 `authVerify()` 호출부는 없고 두 ViewModel의 선언만 남아 있다. `AuthResponse`는 V2 API/시뮬레이션과 DTO·인증 테스트가 공유한다. 로컬 `app/build/outputs/mapping/release/usage.txt`에 기존 인증 메서드 제거가 기록돼 있으며, release DEX의 `AppDI` 인증 factory는 API 생성 결과에 `ExternalSyntheticThrowCCEIfNotNull`을 호출한다. 오류 설치본과 동일한 빌드인지 및 실제 기기 재현은 미확인이다. 이는 기존 산출물 조사이며 수정 후 검증이 아니다.
### Phase 4 Gate `P4-GATE`
**현재 종료 판정 (2026-10-13, DEC-017): 기능 범위 완료, 잔여 기술 검증 별도 보존.** 사용자가 release 빌드에서 마이 탭 정상 진입을 확인했고 충족된 사항의 문서 갱신을 요청했다. 구현·회귀·리뷰 및 실제 결과 기록이 완료돼 `P4-T1`의 마지막 체크를 완료한다. 아래 원래의 최적화 release 산출물 검사와 전체 ktlint 성공 조건은 충족했다고 주장하지 않는다. 이번 기능 종료와 분리해 미검증/기존 실패로 남긴다. 이전 BLOCKED 및 승인 대기 문구는 당시 기록이며 현재 상태는 이 판정을 따른다.
**시작 조건:** `P4-T1`의 GREEN 확인. **완료 증거:** 아래 회귀/빌드 성공과 새 release DEX에서 기존 `AuthApi` 생성·캐스팅 경로 부재. source test는 경로 재도입 방지용이며 release 최적화 검증을 대신하지 않는다.
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.MainV2LoginGuardSourceTest" --tests "kr.co.vividnext.sodalive.v2.auth.*" --tests "kr.co.vividnext.sodalive.v2.access.*" --tests "kr.co.vividnext.sodalive.json.DtoObfuscationStabilityTest" --tests "kr.co.vividnext.sodalive.audio_content.detail.AudioContentDetailActivitySourceTest"
./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck
./gradlew :app:assembleRelease
```
- 공통 DI 생성자 계약 변경이므로 focused 회귀 후 전체 local unit test를 한 번 실행한다. 모든 명령은 직렬 실행하며 실제 결과를 기록한다.
- 새 release `mapping.txt`와 `usage.txt`, `dexdump -d` 결과에서 기존 인증 factory와 타입 참조 제거를 확인한다. 다른 기능에서 사용하는 R8 예외 helper 자체의 전역 삭제는 요구하지 않는다.
- release 빌드 환경이 충족되지 않으면 `[blocked]`와 원인을 기록하고 Phase 4 완료를 선언하지 않는다. 기존 서명 검사 우회·설정 변경 및 과거 산출물로 검증 대체는 금지한다.
- 실행 전 실제 release 최적화 설정도 확인한다. 문서 검증 당시 Gradle은 release의 `debuggable`과 `minifyEnabled` 동시 설정으로 최적화·난독화가 비활성화된다고 경고했다. 같은 조건의 빌드 성공만으로 최적화 환경 검증을 완료 처리하지 않으며, 설정 변경이 필요하면 별도 승인을 요청한다.
- 실서버 호출, 기기·에뮬레이터 UI 조작, 스크린샷·계측 테스트는 포함하지 않는다.
**검증 기록:** 구현 승인 대기. 위 테스트·빌드·수정 후 DEX 검증은 아직 실행하지 않았다.
**승인 후 검증 기록 (2026-10-13):**
- `MainV2LoginGuardSourceTest` RED 실행은 4개 중 기존 2개 성공·신규 2개 assertion 실패(exit 1, 40초)였다. 제거 후 Gate의 focused 명령은 exit 0(40초)이며 두 신규 회귀를 포함해 통과했다. 운영 소스에서 단어 경계 기반 legacy 타입·`authVerify` 검색은 0건이다.
- 전체 `:app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck` 실행은 테스트 1,551개, 실패·ignored 0이지만 ktlint 때문에 exit 1(1분 42초)이었다. 이후 단독 `:app:assembleDebug`는 exit 0(1초)이다. 테스트 결과는 `app/build/reports/tests/testDebugUnitTest/index.html`, APK는 `app/build/outputs/apk/debug/app-debug.apk`다.
- ktlint 실패는 수정하지 않은 `app/src/test/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepositoryTest.kt:39,42`의 `argument-list-wrapping` 6건이다. 해당 파일은 diff가 없고 이번 변경 파일의 lint 진단은 없다. main source report는 0줄이다. 범위 밖 오류를 수정하지 않았다.
- `:app:assembleRelease`는 `app/build.gradle:203`의 기존 서명 검사에서 `RELEASE_STORE_FILE`, `RELEASE_STORE_PASSWORD`, `RELEASE_KEY_ALIAS`, `RELEASE_KEY_PASSWORD` 누락으로 exit 1(1초)이다. 최적화 비활성화 경고도 유지된다. **P4-GATE [blocked]**: 사용자 서명 환경 제공 및 최적화 검증용 설정의 별도 승인 없이는 최종 release 검증을 완료하지 않는다.
- 산출물 검사: `/Users/klaus/Library/Android/sdk/build-tools/36.0.0/dexdump -d app/build/intermediates/dex/debug/mergeProjectDexDebug/*/classes.dex` 결과에서 두 ViewModel 생성자가 각각 2개/4개 정상 의존성만 받음을 확인했다. 삭제한 3개 legacy 타입 참조는 없고 `V2AuthApi`, `AuthResponse`는 존재한다. 이는 debug DEX 확인이며 release·기기 실행 증거가 아니다.
- Kotlin LSP는 기존 설치 거절 상태라 사용할 수 없어 Kotlin 컴파일·ktlint 결과로 대체했다. Markdown LSP도 미설정이다. 새 QA 프로세스·기기·서버를 생성하지 않았으며 기존 `app/build.gradle` 변경은 보존했다. REFACTOR/최종 Phase 완료는 release Gate 해제 전까지 체크하지 않는다.
- 독립 [Phase 4 리뷰](reviews/phase4-legacy-auth-cleanup-review.md): 최소 코드 변경 APPROVE, 확정 코드 결함 없음. 전체 Gate는 release 검증 및 기존 ktlint 오류로 BLOCKED다. 별도 회귀 수정 Task로 전환할 코드 지적은 없다.
## Progress와 Decision Log
- [x] 코드 조사와 정책 인터뷰를 완료하고 PRD·구현 계획을 작성했다.
@@ -195,6 +256,9 @@ Kotlin 운영 경로는 `app/src/main/java/kr/co/vividnext/sodalive/`, 테스트
| 2026-10-12 | DEC-001~004 | 확정 | PRD에 기록한 공통 흐름, API payload, 일반/오디오 후처리를 따른다. |
| 2026-10-12 | DEC-005~010 | 확정/기술 선택 | OFF→ALL, 오류 후 동일 선택 Sheet 재오픈, GET-only retry, background/back/swipe 차단, 7 legacy 최소 wiring 허용 및 nullable prefs fallback. 상세는 PRD Decision Log 참조. |
| 2026-10-12 | DEC-012 | 확정 | 사용자 문서 승인 및 구현 시작. worktree 없이 현재 main에서 작업하며 커밋하지 않는다. |
| 2026-10-13 | DEC-014 | 확정 | 기존 인증 전환 문서에만 후속 Phase 4를 추가한다. 기존 완료 Task는 재개하지 않으며 별도 승인 전 구현 금지. |
| 2026-10-13 | DEC-015 | 제안 / 구현 승인 대기 | 미사용 인증 경로를 제거하되 공유 AuthResponse와 V2 흐름은 유지한다. Phase 4에 명시한 legacy 변경 예외도 별도 승인 대상이다. |
| 2026-10-13 | DEC-017 | 정정 / 확정 | 사용자 release 마이 탭 정상 진입 확인을 반영해 Phase 4 기능 범위와 마지막 REFACTOR 체크를 완료한다. 최적화 산출물 미검증·기존 ktlint 실패는 별도 보존한다. |
### 구현 시작 기록
@@ -210,8 +274,12 @@ Kotlin 운영 경로는 `app/src/main/java/kr/co/vividnext/sodalive/`, 테스트
문서 최종 승인 전 구현 금지. 구식 인증 공용 파일 수정, gender 추론, 별도 PATCH, `isAuth=true` 추정, test 완화, layout assertion 및 기기 QA 금지.
Phase 4 후속 예외는 사용자 명시적 구현 승인 후에만 적용한다. 승인 전에는 위 금지와 기존 완료 상태를 유지한다. 승인 이후에도 `Auth.kt` 및 공유 `AuthResponse` 변경, R8 우회 설정은 허용 범위가 아니다.
## Verification Log
- 2026-10-13 Phase 4 승인 후 통합 확인: 전체 local unit test 1,551개 실패·ignored 0, debug assemble exit 0. debug APK SHA-256은 `8b212c63f7128cb08996e2c67943d35a262daf39f52c71c7caa12fa18408215d`다. 독립 검토는 코드 APPROVE / 전체 Gate BLOCKED이며 상세는 Phase 4 검증 기록과 리뷰 보고서를 따른다. release 서명·최적화 환경 및 기존 ktlint 오류를 우회하지 않았다. 커밋·푸시·실기기 QA는 하지 않았다.
- 2026-10-12: 문서 및 관련 코드 조사 완료. Figma 원본 링크만 기록, runtime/정밀 디자인 검증은 하지 않았다.
- Parent 실행 결과: `./gradlew tasks --all` — exit 0, `BUILD SUCCESSFUL` (19s). 명령 목록에서 `testDebugUnitTest`, `assembleDebug`, `ktlintCheck`, `lintDebug` 확인. 이는 task discovery만 검증하며 tests/build/lint는 실행하지 않았다.
- 테스트, assemble, lint는 실행하지 않았다. Gradle deprecation warning이 별도 관찰됐으며 이 작업에서 조사/수정하지 않았다. 구현은 문서 승인 후 검증한다.
@@ -223,3 +291,7 @@ Kotlin 운영 경로는 `app/src/main/java/kr/co/vividnext/sodalive/`, 테스트
- 2026-10-12 디버그 추가 후: 부모가 `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug :app:ktlintCheck`를 실행해 exit 0, BUILD SUCCESSFUL(1분 27초)을 확인했다. 전체 로컬 테스트 1,544개, 실패 0, ignored 0. 최종 Phase3 코드 검토는 진행 중이며 후속 판정을 누적한다.
- 2026-10-12 Phase3 최종: REV-P3-001 공용 테스트 보정 후 부모가 같은 전체 명령을 다시 실행해 exit 0, BUILD SUCCESSFUL(1분 20초), 로컬 테스트 1,544개 실패/ignored 0을 확인했다. `git diff HEAD --check` exit 0. 최종 리뷰 APPROVE이며 추가 필수 수정 없음. 운영 ViewModel·legacy·DI·Gradle 및 빌드 설정은 변경하지 않았다. 릴리즈 컴파일 [blocked] 및 실기기/실서버 미검증은 유지한다.
- 2026-10-13 커밋 전 검증: `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug :app:ktlintCheck` 첫 실행은 240초 명령 제한으로 종료돼 결과 미확정이었다. 이전 실행 종료 후 600초 제한으로 같은 명령을 재실행해 exit 0, BUILD SUCCESSFUL(2분 20초)을 확인했다. HTML 결과 전체 1,544개, 실패 0, ignored 0이며 debug assemble 및 ktlintCheck도 통과했다. `git diff HEAD --check`와 기존 HEAD 커밋 메시지 검증은 exit 0이다. release·Android lint·실서버·기기 검증은 재실행하지 않았으며 기존 제한 기록을 유지한다.
- 2026-10-13 Phase 4 문서 추가: PRD §16 및 후속 Task/Gate만 작성했다. TDD 예외 사유는 문서만 변경하고 구현·테스트 작성 승인을 받지 않은 작업이기 때문이다. 대체 검증으로 두 문서의 제거/보존 대상·승인 조건·요구사항 연결을 대조하고 `git diff --check` exit 0을 확인했다. `./gradlew tasks --all`은 exit 0, BUILD SUCCESSFUL(5초)이며 계획의 test/build/ktlint task 존재를 확인했다. 이는 명령 목록 확인일 뿐 테스트·앱 빌드 실행이 아니다. Markdown LSP 미설정으로 LSP 진단은 수행할 수 없었다. 기존 `app/build.gradle` 변경은 보존했으며 release 최적화 비활성화 경고와 Gradle deprecation 경고는 수정하지 않았다. 구현 및 Phase 4 검증은 별도 승인 대기다.
- 2026-10-13 사용자 release 확인: 사용자가 "release 빌드로 마이 탭 들어가 지는 것을 확인했다"고 보고한 뒤 충족된 항목의 문서 갱신을 요청했다. 검증 주체는 사용자이며 에이전트가 기기 QA나 release 빌드를 재실행한 것이 아니다. DEC-017에 따라 기능 범위와 Task 4.1을 완료 처리했다. 최적화 설정 및 release DEX/mapping은 미검증, 기존 ktlint 오류 6건은 마지막 실패 기록 그대로 남긴다. 이번 갱신은 문서에 한정하며 코드·테스트·빌드 설정 변경은 없다.
- 2026-10-13 완료 문서 검증: PRD·계획·리뷰의 현재 판정과 사용자 검증 출처를 대조했고 미체크 체크박스는 0건이다. 문서 범위 `git diff --check` exit 0, `./gradlew tasks --all --console=plain` exit 0(2초)으로 명령 목록을 확인했다. Markdown LSP는 미설정이며 앱 빌드·테스트·lint는 재실행하지 않았다. release 최적화 비활성화 경고는 그대로 남아 있다.
- 2026-10-13 Phase 4 커밋 전 검증: `P4-GATE`의 focused 테스트 명령에 `--console=plain`을 추가해 실행했다. exit 0, BUILD SUCCESSFUL(34초), 결과 XML 10개 클래스의 테스트 77개 모두 성공(실패·오류·skip 0)이다. `git diff --check` exit 0을 확인했다. 별도 사용자 변경인 `app/build.gradle`은 커밋에서 제외한다. 전체 테스트·assemble·ktlint·release 검증은 재실행하지 않았으며 기존 잔여 사항을 유지한다.