Files
sodalive-android/docs/20261012_본인인증_후_콘텐츠_보기_설정/plan-task.md
T

29 KiB

본인인증 후 콘텐츠 보기 설정 구현 계획

항목 내용
상태 / 작성일 디버그 시뮬레이션 포함 구현 완료; release 컴파일은 서명 설정으로 검증 차단 / 2026-10-12
요구사항 / API 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.

  • RED: serializer exact keys, 초기 ON/ALL, OFF 전환 ALL, ON enum, OFF payload, 성공 전 설정 저장 금지, nullable fallback/서버 isAuth=false 보존 실패 tests 작성.
  • RED 확인: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*", 요구 동작 assertion 실패 확인.
  • GREEN: 기존 Retrofit/Rx 관례의 v2 adapter 구현. ApiResponse<AuthResponse>의 success/data/message/errorProperty 처리, response gender는 무시하고 gender overwrite하지 않음.
  • GREEN 확인: 같은 focused tests 통과.
  • 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 변경.

  • RED: ON/OFF 선택, OFF→ALL, 완료 전 미제출, single-flight 완료, POST 실패 후 동일 선택 재오픈 tests 작성.
  • RED 확인: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*"의 의도한 assertion 실패 확인.
  • GREEN: 기존 Android BottomSheet pattern으로 Figma ON 원본, OFF 원본 반영. background/back/swipe 닫힘 모두 차단하고 완료만 닫기.
  • GREEN 확인: focused logic test 통과, 두 디자인 상태와 구현 대조.
  • 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 재시작.

  • RED: source assertions 갱신/보강(기존 기능 검사 유지), 각 caller의 Bootpay→Sheet close→POST 순서와 완료 전 submit 없음 확인.
  • RED 확인: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.MainV2LoginGuardSourceTest" --tests "kr.co.vividnext.sodalive.v2.access.*" 의도한 wiring 실패 확인.
  • GREEN: 승인된 caller만 최소 연결.
  • GREEN 확인: 위 tests 및 ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*" 통과.
  • 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 없음.

  • RED: POST success→GET→저장→reload, GET 실패 GET-only retry/POST 재전송 없음, 완료 전 설정 미저장, isAuth=false, nullable preference fallback 및 응답 gender 무시 tests 작성.
  • RED 확인: v2.auth focused test에서 해당 assertion 실패 확인.
  • GREEN: 기존 회원 조회/상세 reload 재사용. GET 실패는 GET만 재시도하고 완료 전 설정을 commit하지 않는다. GET nullable preference는 제출 선택값 fallback(기술 선택).
  • GREEN 확인: auth/access tests 통과, 단일 테스트 명령 문서 갱신.
  • 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를 종료하지 않는다.

  • 시작 조건: 최종 리뷰 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 승인.
  • RED: listener의 인증 후 상세 조회가 실패 종료 callback을 넘기지 않는 계약을 작성한다.
  • RED 확인: 해당 테스트에서 현재 { finish() } 때문에 assertion 실패를 확인한다.
  • GREEN: listener의 실패 종료 callback만 제거한다.
  • GREEN 확인: 해당 테스트와 auth/access/guard 회귀를 통과한다.
  • REFACTOR: 추가 리팩터링 없이 검증 기록과 리뷰 판정을 누적한다.

검증 기록 (2026-10-12): 신규 테스트 인증 완료 후 상세 재조회는 실패 종료 callback 없이 현재 화면을 유지한다를 --tests로 실행해 ComparisonFailure 1개(exit 1)를 확인했다. listener 한 줄 수정 후 auth/access/guard/audio 집중 테스트 64개 및 ktlintCheck exit 0. 부모 전체 재실행 결과와 최종 리뷰 APPROVE는 아래 Verification Log에 누적했다.

./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 진단 소멸 및 리소스 빌드로 검증한다.
  • 기존 themes.xml과 동일한 API 표시를 적용한다.
  • 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 컴파일로 양쪽 빌드 확인.
  • RED: 기존 실제 경로 테스트는 build getter를 false로 고정하고, 신규 debug 동작 테스트에서 assertion 실패를 확인한다. 실제 POST/취소/중복 callback 기대값은 유지한다.
  • GREEN: 내부 build 동작·메모리 API와 fragment-owned 지연을 최소 구현한다.
  • GREEN 확인: auth focused tests 및 기존 guard 회귀, :app:assembleDebug, :app:compileReleaseKotlin, :app:ktlintCheck 결과를 확인한다. release 컴파일은 아래 사유로 [blocked]이며 통과로 판정하지 않는다.
  • 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 리뷰의 REV-P3-001을 수정해 공용 테스트가 release에 DEBUG=true를 강요하지 않는다.

  • 대상/범위: V2AuthFlowTest.kt 기본 build selector 테스트만 보정. 실제/시뮬레이션 경로 기존 시나리오를 보존하고 현재 BuildConfig에 맞는 SDK 호출·지연·요청 결과를 확인한다.
  • 완료 증거: debug auth 집중 테스트·ktlint 및 수정분 재검토, release 검증 차단 사유 유지.
  • TDD 예외: release assertion RED는 기존 서명 검사 때문에 실행 불가다. 생성된 DEBUG=false와 해당 assertTrue의 정적 불일치를 리뷰로 확인했다. 빌드별 기대값을 명확하게 정정하며 운영 동작은 바꾸지 않는다.
  • 빌드별 기대값을 분리하고 기존 실제 경로 및 디버그 동작 검증을 유지한다.
  • 집중 테스트·린트 및 수정분 리뷰 결과를 기록한다.

검증 기록 (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

  • 코드 조사와 정책 인터뷰를 완료하고 PRD·구현 계획을 작성했다.
  • 두 문서의 최종 사용자 승인을 받아 구현을 시작한다.

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·실서버·기기 검증은 재실행하지 않았으며 기존 제한 기록을 유지한다.