|
|
|
@@ -0,0 +1,225 @@
|
|
|
|
|
# 본인인증 후 콘텐츠 보기 설정 구현 계획
|
|
|
|
|
|
|
|
|
|
| 항목 | 내용 |
|
|
|
|
|
|---|---|
|
|
|
|
|
| 상태 / 작성일 | 디버그 시뮬레이션 포함 구현 완료; release 컴파일은 서명 설정으로 검증 차단 / 2026-10-12 |
|
|
|
|
|
| 요구사항 / API | [prd.md](prd.md), §8의 확인된 API 계약 |
|
|
|
|
|
| 현재 Phase / Goal | Phase 1~3 및 회귀 수정 완료 / 없음 |
|
|
|
|
|
|
|
|
|
|
## 목표와 현재 상태
|
|
|
|
|
|
|
|
|
|
사용자 승인에 따라 여덟 인증 진입점에서 설정을 제출하고 후처리한다. Phase 1은 2/2, Phase 2는 기존 2/2 및 회귀 수정 P2-R1 완료다. 전체 로컬 테스트 1,535개, debug 빌드, ktlint가 통과했고 최종 리뷰는 APPROVE다. 실제 서버·기기 검증은 수행하지 않았다.
|
|
|
|
|
|
|
|
|
|
## 범위와 제약
|
|
|
|
|
|
|
|
|
|
- 포함: 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 권한은 이미 허가됐다.
|
|
|
|
|
- worktree 없이 현재 `main` 브랜치에서 작업한다. 의존성을 추가하지 않고 커밋·푸시는 별도 요청 없이는 하지 않는다.
|
|
|
|
|
- `app/src/test` 로직/local unit test만 계획한다. 레이아웃 속성 테스트·`androidTest`·기기 조작·스크린샷 QA는 하지 않는다. 신규 test 추가 시 `docs/agent-guides/build-test-style.md` 단일 실행 예시를 갱신한다.
|
|
|
|
|
|
|
|
|
|
## 구현 파일 지도
|
|
|
|
|
|
|
|
|
|
| 책임 | 경로와 경계 |
|
|
|
|
|
|---|---|
|
|
|
|
|
| v2 요청/API/state/BottomSheet | `v2/auth/V2AuthVerifyRequest.kt`, `V2AuthApi.kt`, `V2AuthViewModel.kt`, `V2AuthFlow.kt`, `ContentPreferenceBottomSheet.kt` |
|
|
|
|
|
| UI 리소스 | `app/src/main/res/layout/v2_bottom_sheet_content_preference.xml`, 필요한 문자열·drawable만 기존 리소스 우선 재사용 |
|
|
|
|
|
| caller 연결 | 7개 legacy: `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 |
|
|
|
|
|
| 공통 Bootpay | 기존 Bootpay launcher/API response를 최소 v2 wrapper/request adapter로 재사용. `Auth.kt` 및 legacy API/DTO/repository는 수정하지 않음 |
|
|
|
|
|
| 오디오 동기화 | 기존 `UserRepository.getMemberInfo` 규칙 및 `AudioContentDetailViewModel.getAudioContentDetail(audioContentId)` 재사용, ViewModel 수정 회피 |
|
|
|
|
|
| 검증 | `app/src/test/java/kr/co/vividnext/sodalive/v2/auth/`, 기존 `v2/main/MainV2LoginGuardSourceTest.kt`, `v2/access` tests, build-test-style 가이드 |
|
|
|
|
|
|
|
|
|
|
Kotlin 운영 경로는 `app/src/main/java/kr/co/vividnext/sodalive/`, 테스트 경로는 `app/src/test/java/kr/co/vividnext/sodalive/` 기준이다. 신규 테스트는 `v2/auth/V2AuthVerifyRequestTest.kt`, `V2AuthViewModelTest.kt`에 요청 직렬화와 실행 순서를 검증한다. 기존 Koin Retrofit과 `UserRepository`를 사용하는 작은 factory로 상태 소유자를 생성해 legacy `AppDI.kt` 수정을 피한다.
|
|
|
|
|
|
|
|
|
|
공통 진입 계약: `V2AuthFlow.start(activity: Activity, syncMemberInfo: Boolean = false)`. 내부에서 FragmentActivity를 확인하고 기존 `Auth.auth`를 호출한다. Bootpay 완료 후 영수증은 Fragment 범위 `V2AuthViewModel` 메모리에만 보관한다. 선택 상태는 `toggleVisibility()`, `selectContentType(ContentType)`, `confirm()`으로 변경·제출한다. `V2AuthApi.verify(V2AuthVerifyRequest, String)`은 기존 `Single<ApiResponse<AuthResponse>>`를 반환한다. 일반 성공은 현재 호스트에서 Splash로 이동하고, 오디오 성공은 Fragment Result로 전달해 Activity의 매 onCreate에서 등록한 현재 ViewModel 콜백이 상세를 갱신한다. 과정 중 앱 종료 후 인증 복원 기능은 추가하지 않는다.
|
|
|
|
|
|
|
|
|
|
## Phase 1
|
|
|
|
|
|
|
|
|
|
**Phase 결과:** 승인된 계약에 맞는 요청, 선택 상태 및 공통 Sheet.
|
|
|
|
|
**선행조건:** 두 문서의 최종 사용자 승인.
|
|
|
|
|
|
|
|
|
|
#### Task 1.1 요청과 선택 상태
|
|
|
|
|
|
|
|
|
|
**Goal `P1-T1`:** 영수증과 설정을 legacy gender-overwrite 경로 없이 제출한다.
|
|
|
|
|
**시작/완료:** 문서 최종 승인 / 정확한 JSON 및 상태·저장 불변식 local tests 통과. Sheet/caller는 범위 밖.
|
|
|
|
|
|
|
|
|
|
**Files:** Create `v2/auth/V2AuthVerifyRequest.kt`, `V2AuthApi.kt`, `V2AuthViewModel.kt`; Test `v2/auth/V2AuthVerifyRequestTest.kt`, `V2AuthViewModelTest.kt`.
|
|
|
|
|
**Interfaces:** 기존 `ContentType.ALL/MALE/FEMALE`, `UserRepository.getMemberInfo` 사용. Produces `receiptId: String`, `isAdultContentVisible: Boolean`, `contentType: ContentType`, wire keys `receipt_id`, `isAdultContentVisible`, `contentType.name`.
|
|
|
|
|
|
|
|
|
|
- [x] **RED:** serializer exact keys, 초기 ON/ALL, OFF 전환 ALL, ON enum, OFF payload, 성공 전 설정 저장 금지, nullable fallback/서버 `isAuth=false` 보존 실패 tests 작성.
|
|
|
|
|
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*"`, 요구 동작 assertion 실패 확인.
|
|
|
|
|
- [x] **GREEN:** 기존 Retrofit/Rx 관례의 v2 adapter 구현. `ApiResponse<AuthResponse>`의 `success/data/message/errorProperty` 처리, response gender는 무시하고 gender overwrite하지 않음.
|
|
|
|
|
- [x] **GREEN 확인:** 같은 focused tests 통과.
|
|
|
|
|
- [x] **REFACTOR:** 이번 Task 중복만 정리, focused test 결과를 Task 검증 기록에 남김.
|
|
|
|
|
|
|
|
|
|
**검증 기록 (2026-10-12):** 구현 담당이 동작 없는 계약 골격에서 요청/상태 테스트 29개 assertion 실패(exit 1)를 확인한 뒤 최소 구현했다. 같은 focused 명령은 exit 0이며 요청/API 5개, ViewModel 24개 통과. 부모가 두 테스트 파일·운영 코드 전체 및 결과 XML의 실패/오류/skip 0을 확인했다. 실제 Retrofit 직렬화·헤더는 terminal interceptor로 검증하며 실제 서버는 호출하지 않는다. 오디오 동기화 로직도 이 상태 소유자에 함께 구현했고 P2-T2는 화면 연결과 완료 전달 검증을 담당한다.
|
|
|
|
|
|
|
|
|
|
#### Task 1.2 공통 선택 BottomSheet
|
|
|
|
|
|
|
|
|
|
**Goal `P1-T2`:** 승인된 ON/OFF 상태를 표시하고 완료 때 선택값 callback을 한 번 전달한다.
|
|
|
|
|
**시작/완료:** `P1-T1` 및 승인된 디자인/닫힘 정책 / selection action logic tests 통과. Layout property tests 및 기기 QA 제외.
|
|
|
|
|
|
|
|
|
|
**Files:** Create `v2/auth/ContentPreferenceBottomSheet.kt`, `app/src/main/res/layout/v2_bottom_sheet_content_preference.xml`; Modify `v2/auth/V2AuthViewModel.kt`와 `V2AuthViewModelTest.kt`.
|
|
|
|
|
**Interfaces:** Consumes state, Produces callback `(isAdultContentVisible, contentType) -> Unit`; ON은 enum 선택, OFF는 selector 숨김/caption 변경.
|
|
|
|
|
|
|
|
|
|
- [x] **RED:** ON/OFF 선택, OFF→ALL, 완료 전 미제출, single-flight 완료, POST 실패 후 동일 선택 재오픈 tests 작성.
|
|
|
|
|
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*"`의 의도한 assertion 실패 확인.
|
|
|
|
|
- [x] **GREEN:** 기존 Android BottomSheet pattern으로 Figma ON [원본](https://www.figma.com/design/HmN1yNdJ3EIpqknFL0Hkab?node-id=2489-32150), OFF [원본](https://www.figma.com/design/HmN1yNdJ3EIpqknFL0Hkab?node-id=2489-32163) 반영. background/back/swipe 닫힘 모두 차단하고 완료만 닫기.
|
|
|
|
|
- [x] **GREEN 확인:** focused logic test 통과, 두 디자인 상태와 구현 대조.
|
|
|
|
|
- [x] **REFACTOR:** 신규 중복만 정리, 결과 기록.
|
|
|
|
|
|
|
|
|
|
**검증 기록 (2026-10-12):** Figma screenshot/metadata/변수와 기존 `soda_400`, `gray_900`, Typography 18/16/12sp 리소스를 대조했다. UI 재시도 완료 터치 테스트는 선택 잠금이 완료 버튼까지 막는 상태에서 RED를 확인했고, 선택 잠금과 완료 액션을 분리한 뒤 GREEN이다. UI 구조·색상·문구는 코드/리소스로 확인했으며 실제 기기 렌더링 검증은 하지 않았다. 한/영/일 문구를 추가했고 레이아웃 속성 assertion은 작성하지 않았다.
|
|
|
|
|
|
|
|
|
|
## Phase 2
|
|
|
|
|
|
|
|
|
|
**Phase 결과:** 여덟 진입점 연결 및 경로별 성공 후처리.
|
|
|
|
|
**선행조건:** Phase 1 및 이미 허가된 7개 legacy caller 최소 wiring 범위 준수.
|
|
|
|
|
|
|
|
|
|
#### Task 2.1 여덟 진입점 연결
|
|
|
|
|
|
|
|
|
|
**Goal `P2-T1`:** Bootpay 완료 후 Sheet를 열고 완료 시 닫은 다음 선택 payload를 전송한다.
|
|
|
|
|
**시작/완료:** `P1-T1/2` / 8개 source wiring assertions와 기존 기능 guard tests 통과. 승인된 7 legacy caller 외 공용 legacy 변경은 범위 밖.
|
|
|
|
|
|
|
|
|
|
**Files:** Create `v2/auth/V2AuthFlow.kt`; Modify `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`. Test `v2/main/MainV2LoginGuardSourceTest.kt`, `v2/auth/V2AuthViewModelTest.kt`, `v2/access` 회귀.
|
|
|
|
|
**Interfaces:** Shared `Auth.auth` completion → 공통 Sheet → 완료 callback → v2 request sender. 일반 7경로 성공은 기존 Splash 재시작.
|
|
|
|
|
|
|
|
|
|
- [x] **RED:** source assertions 갱신/보강(기존 기능 검사 유지), 각 caller의 Bootpay→Sheet close→POST 순서와 완료 전 submit 없음 확인.
|
|
|
|
|
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.MainV2LoginGuardSourceTest" --tests "kr.co.vividnext.sodalive.v2.access.*"` 의도한 wiring 실패 확인.
|
|
|
|
|
- [x] **GREEN:** 승인된 caller만 최소 연결.
|
|
|
|
|
- [x] **GREEN 확인:** 위 tests 및 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*"` 통과.
|
|
|
|
|
- [x] **REFACTOR:** 범위 밖 caller 리팩터링 없이 재실행, legacy 수정 허가와 결과 기록.
|
|
|
|
|
|
|
|
|
|
**검증 기록 (2026-10-12):** 초기 가드 연결부 2개 assertion RED 후 공통 flow로 전환해 GREEN. 취소 후 재진입 보정에서는 Flow 테스트 15개 중 6개 assertion RED를 확인했다. 완료 전 coordinator를 생성하지 않도록 수정한 뒤 집중 63개 GREEN. 중복 성공 callback latch를 제거하면 재생성된 coordinator를 감지하는 테스트 1개가 실패하는 mutation RED도 확인했고 latch 복원 후 통과했다. 8개 호출부 검색 및 diff로 범위를 확인했다. 레거시 Auth·API·ViewModel·AppDI는 변경하지 않았다.
|
|
|
|
|
|
|
|
|
|
#### Task 2.2 오디오 상세 동기화 및 Gate
|
|
|
|
|
|
|
|
|
|
**Goal `P2-T2`:** POST 성공 후 회원 정보 저장 및 상세 재조회, 재시작 없이 마친다.
|
|
|
|
|
**시작/완료:** `P2-T1` / POST→GET→save→detail 순서 및 GET-only retry tests, targeted regression, debug assemble 통과. `AudioContentDetailViewModel` 수정은 제외.
|
|
|
|
|
|
|
|
|
|
**Files:** Modify `audio_content/detail/AudioContentDetailActivity.kt` callback과 `v2/auth/V2AuthViewModel.kt`의 동기화 분기; Test `v2/auth/V2AuthViewModelTest.kt` 순서/state와 `v2/access` regression; Modify `docs/agent-guides/build-test-style.md`에 신규 test 실행 예시.
|
|
|
|
|
**Interfaces:** POST success → `UserRepository.getMemberInfo` → server `isAuth` 그대로, nullable prefs는 제출값으로 저장 → 기존 `getAudioContentDetail(audioContentId)` 재호출. Splash/Activity restart 없음.
|
|
|
|
|
|
|
|
|
|
- [x] **RED:** POST success→GET→저장→reload, GET 실패 GET-only retry/POST 재전송 없음, 완료 전 설정 미저장, `isAuth=false`, nullable preference fallback 및 응답 gender 무시 tests 작성.
|
|
|
|
|
- [x] **RED 확인:** v2.auth focused test에서 해당 assertion 실패 확인.
|
|
|
|
|
- [x] **GREEN:** 기존 회원 조회/상세 reload 재사용. GET 실패는 GET만 재시도하고 완료 전 설정을 commit하지 않는다. GET nullable preference는 제출 선택값 fallback(기술 선택).
|
|
|
|
|
- [x] **GREEN 확인:** auth/access tests 통과, 단일 테스트 명령 문서 갱신.
|
|
|
|
|
- [x] **REFACTOR:** 신규 중복만 정리, auth/access tests 및 `./gradlew :app:assembleDebug` 실행 결과 기록.
|
|
|
|
|
|
|
|
|
|
**검증 기록 (2026-10-12):** P1-T1 상태 테스트의 저장 순서 RED/GREEN을 기반으로 실제 Fragment Result 전달을 추가했다. 재생성된 호스트의 현재 listener가 회원 저장 뒤 한 번만 호출되고, 정지 중 성공은 재개까지 보류되는 로컬 routing 테스트가 통과했다. RESUMED 가드를 제거하면 STARTED 완료 보류 테스트가 실패하는 mutation RED를 확인했고 복원 후 통과했다. 오디오 상세는 listener에서 기존 상세 조회만 호출하며 Splash 이동이 없다. 단일 테스트 가이드도 갱신했다.
|
|
|
|
|
|
|
|
|
|
**Phase 2 Gate `P2-GATE`:** 승인된 payload 및 경로별 후속 assertions, 아래 검증 성공.
|
|
|
|
|
|
|
|
|
|
#### Task 2.3 오디오 상세 오류 처리 회귀 수정
|
|
|
|
|
|
|
|
|
|
**Goal `P2-R1`:** 인증 완료 후 상세 재조회 실패가 기존처럼 오류 안내에 그치고 현재 Activity를 종료하지 않는다.
|
|
|
|
|
|
|
|
|
|
- 시작 조건: [최종 리뷰](reviews/phase2-auth-content-preference-review.md) `REV-P2-001` 확정.
|
|
|
|
|
- 대상/수정 범위: `audio_content/detail/AudioContentDetailActivity.kt` 새 인증 완료 listener의 `{ finish() }`만 제거. 최초 조회·기존 ViewModel 수정 제외.
|
|
|
|
|
- 회귀 테스트: 기존 `audio_content/detail/AudioContentDetailActivitySourceTest.kt`에 인증 완료 listener가 실패 종료 callback 없이 상세를 조회하는 라우팅 계약 추가.
|
|
|
|
|
- 완료 증거: 위 테스트 RED→GREEN, auth/access/guard 집중 회귀, lint/build 및 리뷰 delta 승인.
|
|
|
|
|
- [x] **RED:** listener의 인증 후 상세 조회가 실패 종료 callback을 넘기지 않는 계약을 작성한다.
|
|
|
|
|
- [x] **RED 확인:** 해당 테스트에서 현재 `{ finish() }` 때문에 assertion 실패를 확인한다.
|
|
|
|
|
- [x] **GREEN:** listener의 실패 종료 callback만 제거한다.
|
|
|
|
|
- [x] **GREEN 확인:** 해당 테스트와 auth/access/guard 회귀를 통과한다.
|
|
|
|
|
- [x] **REFACTOR:** 추가 리팩터링 없이 검증 기록과 리뷰 판정을 누적한다.
|
|
|
|
|
|
|
|
|
|
**검증 기록 (2026-10-12):** 신규 테스트 `인증 완료 후 상세 재조회는 실패 종료 callback 없이 현재 화면을 유지한다`를 `--tests`로 실행해 ComparisonFailure 1개(exit 1)를 확인했다. listener 한 줄 수정 후 auth/access/guard/audio 집중 테스트 64개 및 ktlintCheck exit 0. 부모 전체 재실행 결과와 최종 리뷰 APPROVE는 아래 Verification Log에 누적했다.
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*" --tests "kr.co.vividnext.sodalive.v2.access.*" --tests "kr.co.vividnext.sodalive.v2.main.MainV2LoginGuardSourceTest"
|
|
|
|
|
./gradlew :app:assembleDebug
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
선택 lint: `./gradlew :app:ktlintCheck`. Runtime UI/device/screenshot QA는 범위 밖.
|
|
|
|
|
|
|
|
|
|
#### Task 2.4 내비게이션 바 XML API 표시 보정
|
|
|
|
|
|
|
|
|
|
**Goal `P2-R2`:** 사용자가 보고한 `windowLightNavigationBar` API 27 경고를 기존 테마 관례대로 처리한다.
|
|
|
|
|
|
|
|
|
|
- 대상: `app/src/main/res/values/v2_content_preference.xml`의 resources tools namespace와 해당 item의 `tools:targetApi="o_mr1"`만 추가.
|
|
|
|
|
- 동작/범위: `false`, 내비게이션 바 색상, minSdk 23은 유지. Kotlin·인증 로직 변경 없음.
|
|
|
|
|
- TDD 예외: 런타임 로직이 아닌 lint 메타데이터 보정이므로 별도 unit/layout 테스트를 만들지 않는다. Android lint 결과에서 해당 NewApi 진단 소멸 및 리소스 빌드로 검증한다.
|
|
|
|
|
- [x] 기존 `themes.xml`과 동일한 API 표시를 적용한다.
|
|
|
|
|
- [x] Android lint와 리소스 빌드를 실행하고 대상 진단 및 기존 별도 오류를 구분해 기록한다.
|
|
|
|
|
|
|
|
|
|
**검증 기록:** 수정 전 `./gradlew :app:lintDebug`는 120초 제한에서 종료돼 전체 진단 결과가 미확정이다. 사용자 IDE 진단과 SDK api-versions.xml의 since=27, 대상 파일의 표시 누락을 확인했다.
|
|
|
|
|
|
|
|
|
|
**수정 후 검증:** `./gradlew :app:lintDebug :app:assembleDebug`는 Android lint 오류 30개/경고 796개로 exit 1이었다. 생성된 `app/build/intermediates/lint_intermediate_text_report/debug/lintReportDebug/lint-results-debug.txt`에서 `windowLightNavigationBar`와 `v2_content_preference.xml` 검색 결과는 0건이다. 별도 `./gradlew :app:assembleDebug`는 exit 0, BUILD SUCCESSFUL. 남은 오류는 이번 변경과 무관한 manifest FacebookActivity MissingClass, 기존 ConstraintLayout NotSibling, Media3 opt-in, RecyclerView fixed-size 및 문자열 포맷 진단이며 수정하지 않았다. 메타데이터 두 줄만 변경해 unit test/기기 QA는 추가하거나 재실행하지 않았다.
|
|
|
|
|
|
|
|
|
|
## Phase 3
|
|
|
|
|
|
|
|
|
|
**Phase 결과:** 디버그에서 로딩 후 콘텐츠 선택을 시험하고 인증 서버 전송 없이 기존 성공 후처리를 실행한다. 릴리즈 실제 인증은 유지한다.
|
|
|
|
|
|
|
|
|
|
#### Task 3.1 디버그 진입과 성공 응답
|
|
|
|
|
|
|
|
|
|
**Goal `P3-T1`:** Bootpay/인증 POST는 디버그에서 0회이며 기존 저장·일반 재시작·오디오 회원 조회 후 갱신 경로를 재사용한다.
|
|
|
|
|
|
|
|
|
|
- 시작 조건: PRD `DEBUG-001~005`, 사용자 후속 구현 승인.
|
|
|
|
|
- Files: `v2/auth/V2AuthFlow.kt`, `v2/auth/V2AuthFlowTest.kt`, `v2/auth/V2AuthViewModelTest.kt`; 필요 시 기존 소스 가드의 의도된 연결 기대값만 보정한다. ViewModel 운영 로직·기존 Auth·호출부·Gradle·의존성은 수정하지 않는다.
|
|
|
|
|
- Interfaces: 내부 build 동작 getter는 `BuildConfig.DEBUG`만 읽는다. 메모리 `V2AuthApi`는 `ApiResponse<AuthResponse>(success=true)`를 반환한다. factory의 API 선택과 디버그 진입만 분기하고 기존 ViewModel 성공 분기는 공유한다.
|
|
|
|
|
- 수명주기: 디버그 로딩 중 태그로 중복 실행을 막는다. 500ms 지연은 Fragment가 소유하고 파괴 시 제거하며, 정지 중 Sheet를 표시하지 않는다. 로딩 중 재생성은 안전하게 종료하고 다시 시도할 수 있다. receipt/timer는 저장 상태에 넣지 않는다.
|
|
|
|
|
- 완료 증거: debug Bootpay/POST 0회, 499ms/500ms 경계, 단일 지연, host 파괴/정지, 일반 성공 저장 및 Splash, 오디오 실제 GET/재시도/서버값 저장, 실제 경로 회귀 유지. release Kotlin 컴파일로 양쪽 빌드 확인.
|
|
|
|
|
- [x] **RED:** 기존 실제 경로 테스트는 build getter를 false로 고정하고, 신규 debug 동작 테스트에서 assertion 실패를 확인한다. 실제 POST/취소/중복 callback 기대값은 유지한다.
|
|
|
|
|
- [x] **GREEN:** 내부 build 동작·메모리 API와 fragment-owned 지연을 최소 구현한다.
|
|
|
|
|
- [x] **GREEN 확인:** auth focused tests 및 기존 guard 회귀, `:app:assembleDebug`, `:app:compileReleaseKotlin`, `:app:ktlintCheck` 결과를 확인한다. release 컴파일은 아래 사유로 [blocked]이며 통과로 판정하지 않는다.
|
|
|
|
|
- [x] **REFACTOR:** 이번 변경의 중복만 정리하고 최종 검증·리뷰 기록을 누적한다.
|
|
|
|
|
|
|
|
|
|
추가 확인이 필요한 서버 계약은 없다. 회원 GET은 기존대로 실제 요청이고 디버그용 서버 인증/설정 저장은 만들지 않는다. 전체 Android lint의 기존 별도 오류 30건 수정은 범위 밖이다.
|
|
|
|
|
|
|
|
|
|
**검증 기록 (2026-10-12):** 실제 변경은 `V2AuthFlow.kt`와 `V2AuthFlowTest.kt` 두 파일이다. 기존 ViewModel 운영 로직/API/호출부/DI/Gradle을 유지했다. 실제 경로 15개 테스트는 build getter를 false로 명시했고, 신규 디버그 테스트 9개를 추가했다. 구현 전 Flow 24개 중 디버그 동작 8개 assertion RED(exit 1), 구현 후 auth/access/guard 집중 69개 GREEN(exit 0)을 확인했다.
|
|
|
|
|
|
|
|
|
|
**릴리즈 검증 [blocked]:** `:app:compileReleaseKotlin`은 기존 release 서명 검사에서 누락된 `RELEASE_STORE_FILE`, `RELEASE_STORE_PASSWORD`, `RELEASE_KEY_ALIAS`, `RELEASE_KEY_PASSWORD` 때문에 실행되지 않았다. 생성된 release `BuildConfig.DEBUG=false` 및 디버그 테스트 내 실제 경로 회귀는 확인했지만 release Kotlin 컴파일 통과를 의미하지 않는다. 서명 설정을 우회하거나 변경하지 않았다.
|
|
|
|
|
|
|
|
|
|
#### Task 3.2 빌드 variant 공용 테스트 보정
|
|
|
|
|
|
|
|
|
|
**Goal `P3-R1`:** [Phase3 리뷰](reviews/phase3-debug-auth-simulation-review.md)의 REV-P3-001을 수정해 공용 테스트가 release에 DEBUG=true를 강요하지 않는다.
|
|
|
|
|
|
|
|
|
|
- 대상/범위: `V2AuthFlowTest.kt` 기본 build selector 테스트만 보정. 실제/시뮬레이션 경로 기존 시나리오를 보존하고 현재 BuildConfig에 맞는 SDK 호출·지연·요청 결과를 확인한다.
|
|
|
|
|
- 완료 증거: debug auth 집중 테스트·ktlint 및 수정분 재검토, release 검증 차단 사유 유지.
|
|
|
|
|
- TDD 예외: release assertion RED는 기존 서명 검사 때문에 실행 불가다. 생성된 DEBUG=false와 해당 assertTrue의 정적 불일치를 리뷰로 확인했다. 빌드별 기대값을 명확하게 정정하며 운영 동작은 바꾸지 않는다.
|
|
|
|
|
- [x] 빌드별 기대값을 분리하고 기존 실제 경로 및 디버그 동작 검증을 유지한다.
|
|
|
|
|
- [x] 집중 테스트·린트 및 수정분 리뷰 결과를 기록한다.
|
|
|
|
|
|
|
|
|
|
**검증 기록 (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 실행은 서명 설정 차단으로 미검증이다.
|
|
|
|
|
|
|
|
|
|
## Progress와 Decision Log
|
|
|
|
|
|
|
|
|
|
- [x] 코드 조사와 정책 인터뷰를 완료하고 PRD·구현 계획을 작성했다.
|
|
|
|
|
- [x] 두 문서의 최종 사용자 승인을 받아 구현을 시작한다.
|
|
|
|
|
|
|
|
|
|
2026-10-12: 지정 템플릿/작업 가이드와 Auth, member DTO, ContentType, v2 access/main, content settings, audio detail 코드를 확인했다. 인터뷰/정책 결정은 완료, 문서 최종 승인 대기다. Figma source screenshot/reference 검토 완료, 실제 app QA/정밀 치수 검증은 하지 않았다. 문서 작업은 운영 동작을 바꾸지 않아 TDD 예외이며 코드·요구사항 대조와 Gradle task 목록 확인으로 검증했다.
|
|
|
|
|
|
|
|
|
|
| 날짜 | ID | 상태 | 기록 |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| 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에서 작업하며 커밋하지 않는다. |
|
|
|
|
|
|
|
|
|
|
### 구현 시작 기록
|
|
|
|
|
|
|
|
|
|
- 로직 요청/API/ViewModel과 UI 컴포넌트는 서로 다른 파일을 소유해 진행한다. Gradle 실행은 로직 작업에서만 수행하고 이후 연결·최종 검증을 직렬 실행한다.
|
|
|
|
|
- Sheet는 표시만 담당하는 `BottomSheetDialog`로 만들고 선택/요청 상태와 수명주기 처리는 공통 흐름이 소유한다. 실패 재오픈 시 새 UI 인스턴스에 보존된 상태를 전달한다.
|
|
|
|
|
- 기본 Retrofit의 debug BODY logging을 새 인증 요청에서 그대로 사용하지 않는다. 기존 no-body-logging client 구성 관례를 v2 생성 경계에서 재사용하고 공용 DI 파일은 수정하지 않는다.
|
|
|
|
|
- 수명주기 기술 보정: 익명 성공 람다를 보관하지 않고 headless Fragment와 Fragment Result를 사용한다. RESUMED 시에만 오류·완료를 소비하고 onStop에서 다이얼로그를 해제한다. 태그로 중복 실행을 막으며 isStateSaved 상태에서 state-loss commit을 하지 않는다. Oracle 검토에서 이 경계와 최소 수명주기 테스트를 확인했다.
|
|
|
|
|
- 오디오 GET 실패 재시도는 선택 컨트롤만 잠그고 완료 버튼은 활성화한다. UI의 `selectionEnabled`를 완료 버튼 활성 조건으로 사용하지 않는다.
|
|
|
|
|
- 연결 중 발견: legacy `Auth.auth`는 성공 callback만 노출한다. Bootpay 시작 전에 coordinator 태그를 등록하면 취소/닫힘을 알 수 없어 다음 인증이 막힌다. `P2-T1` 완료 전에 성공 callback에서만 coordinator를 생성하도록 보정하고, callback 없는 취소 뒤 재진입·중복 성공 callback 방지 테스트를 추가한다. 레거시 SDK launcher의 UI 취소/오류 처리는 그대로 유지한다. 서버 POST 단일 실행은 완료 이후 coordinator 태그와 ViewModel에서 보장한다.
|
|
|
|
|
- 최종 검증 중 신규 파일/새 테스트 목록의 ktlint 줄바꿈 위반을 확인했다. 인증 파일과 변경된 테스트 줄만 포맷을 보정하고 동작·기존 레거시 스타일은 변경하지 않는다.
|
|
|
|
|
|
|
|
|
|
## 변경 금지
|
|
|
|
|
|
|
|
|
|
문서 최종 승인 전 구현 금지. 구식 인증 공용 파일 수정, gender 추론, 별도 PATCH, `isAuth=true` 추정, test 완화, layout assertion 및 기기 QA 금지.
|
|
|
|
|
|
|
|
|
|
## Verification Log
|
|
|
|
|
|
|
|
|
|
- 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이 별도 관찰됐으며 이 작업에서 조사/수정하지 않았다. 구현은 문서 승인 후 검증한다.
|
|
|
|
|
- 2026-10-12 구현 후: `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug`를 부모 세션에서 실행했다. exit 0, `BUILD SUCCESSFUL`(1분 20초). 전체 로컬 테스트 1,534개, 실패 0, ignored 0, 성공률 100%를 HTML 결과에서 확인했다. v2.auth 46개 테스트 XML 모두 실패·오류·skip 0이다. 테스트는 실제 Retrofit 직렬화/로컬 interceptor 및 Robolectric 기반 routing/state로 실행하며 서버·기기를 사용하지 않는다.
|
|
|
|
|
- 2026-10-12: `git diff --check` exit 0. LSP 도구가 제공되지 않아 Kotlin 컴파일과 빌드로 타입 검증을 대체했다. `./gradlew :app:ktlintCheck`는 신규 테스트의 wrapping 위반으로 exit 1, 해당 줄에 한정해 보정 중이다. 이후 검증 결과를 누적한다.
|
|
|
|
|
- 2026-10-12 최종: 신규 auth/추가 테스트 줄의 formatting 위반만 보정했다. `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug :app:ktlintCheck`를 부모가 실행해 exit 0, `BUILD SUCCESSFUL`(1분 33초)을 확인했다. HTML 결과 전체 1,535개, 실패 0, ignored 0, 성공률 100%. main/test ktlint 리포트는 모두 0줄이다. debug APK는 `app/build/outputs/apk/debug/app-debug.apk`에 생성됐다.
|
|
|
|
|
- 2026-10-12 최종 리뷰: REV-P2-001 수정분을 재검토한 Oracle 판정은 ADDRESSED / APPROVE, 추가 필수 수정 없음. 관련 보고서에 판정을 누적했다. `git diff HEAD --check` exit 0. 신규 의존성·worktree·커밋·푸시 없음. 작업 중 이미 stage된 파일은 임의로 stage/unstage하지 않았다.
|
|
|
|
|
- 검증 한계/잔여 관찰: 실제 서버 인증과 기기·시각 QA는 승인 계획에 따라 미실행. LSP 도구 미제공으로 Kotlin 컴파일 및 ktlint로 대체. 기존 Gradle/.editorconfig deprecation 경고와 legacy `Auth.kt`의 SDK 원문 로그/오류 Toast는 미변경 상태다. 외부 QA 프로세스·서버·기기 리소스는 생성하지 않았다.
|
|
|
|
|
- 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·실서버·기기 검증은 재실행하지 않았으며 기존 제한 기록을 유지한다.
|