docs(auth): 인증 종료 구현과 검증 결과를 기록한다

This commit is contained in:
2026-10-14 01:39:51 +09:00
parent 0f8f474481
commit 3a5e37c58e
4 changed files with 290 additions and 3 deletions
@@ -2,9 +2,9 @@
| 항목 | 내용 |
|---|---|
| 상태 / 작성일 | Phase 1~4 기능 범위 완료; release 마이 탭 사용자 확인 반영, 잔여 기술 검증 별도 기록 / 2026-10-12 |
| 상태 / 작성일 | Phase 1~5 및 전환·스타일 후속 수정 완료, Android 9 실기기 검증 완료 / 2026-10-12 |
| 요구사항 / API | [prd.md](prd.md), §8의 확인된 API 계약 |
| 현재 Phase / Goal | Phase 4 기능 완료, Task 1/1 / 활성 Goal 없음 |
| 현재 Phase / Goal | Phase 5 구현 2/2 및 후속 수정 3/3 완료 / 활성 Goal 없음 |
## 목표와 현재 상태
@@ -244,6 +244,136 @@ Kotlin 운영 경로는 `app/src/main/java/kr/co/vividnext/sodalive/`, 테스트
- 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로 전환할 코드 지적은 없다.
## Phase 5: 본인인증 선택 화면 종료 및 표시 문구
**승인 갱신 (2026-10-13, DEC-020):** 사용자 '구현 승인'으로 아래 Task 실행을 시작한다. 이전 승인 대기·미실행 문구는 당시 이력이며 완료 증거는 Task별로 누적한다. ULW 요청에 따라 최종 전체 로컬 테스트도 실행한다. 제품 범위와 기존 사용자 변경 보존은 그대로다.
**Phase 결과:** X 확인 후 인증 선택 흐름만 종료하고, 해당 UI의 표시 용어를 맞춘다.
**선행조건:** PRD §17 `DEC-018`에 대한 **사용자의 명시적 구현 승인**. 현재 `0/2`, 활성 구현 Goal 없음이며 마지막 범위 정정은 승인이 아니다.
**이력 경계:** `PREF-002`의 완료 버튼 전용 닫기와 Phase 1~4 완료·검증은 당시 이력으로 보존한다. 승인 후 Phase 5만 X 확인 종료를 추가하며 기존 완료 Task를 다시 열지 않는다.
#### Task 5.1 X·확인 모달·Flow 종료 연결
**Goal `P5-T1`:** X는 종료 의사만 확인하고, 확인 시 호스트를 유지한 채 Sheet와 Flow를 제거한다.
- 시작 조건: 사용자 구현 승인 및 PRD §17 디자인 제안 승인. 팝업 문구는 `DEC-019`로 확정됐다.
- 완료 증거: 아래 TDD 단계, 종료/취소·재진입·수명주기 회귀와 요청/저장/완료 부작용 부재의 실제 결과.
- 수정: `app/src/main/java/kr/co/vividnext/sodalive/v2/auth/ContentPreferenceBottomSheet.kt`, `app/src/main/java/kr/co/vividnext/sodalive/v2/auth/V2AuthFlow.kt`.
- 리소스: `app/src/main/res/layout/v2_bottom_sheet_content_preference.xml`, `app/src/main/res/{values,values-en,values-ja}/v2_content_preference_strings.xml`에 X 연결과 확정 팝업 제목·본문·두 버튼 문자열을 추가한다.
- 팝업 문구: 제목 '본인인증 종료', 본문 `본인인증을 종료하시겠어요?\n종료하면 다시 본인인증을 진행해야 해요.`, confirm '종료하기', cancel '계속하기'. 본문 줄바꿈과 한국어 원문을 보존하고 영문·일문도 같은 의미로 제공한다.
- 테스트: `app/src/test/java/kr/co/vividnext/sodalive/v2/auth/ContentPreferenceBottomSheetTest.kt`.
- 테스트: `app/src/test/java/kr/co/vividnext/sodalive/v2/auth/V2AuthFlowTest.kt`.
- 회귀: `app/src/test/java/kr/co/vividnext/sodalive/v2/auth/V2AuthViewModelTest.kt`의 기존 요청·저장·GET-only 재시도 검사를 유지한다.
- 인터페이스: Sheet에 끝 인자 `onClose: () -> Unit`와 `btn_close` 액션을 추가해 기존 `onConfirm`과 분리한다. 기존 생성자 호출과 테스트에서 두 콜백을 명확히 전달한다. Flow가 nullable 종료 모달을 소유하고, X에서 기존 `V2ModalDialog`를 한 번만 표시한다.
- 종료 연결: 팝업 확인은 기존 guarded `removeFlow()`로 보낸다. 취소는 모달 참조만 해제해 Sheet·ViewModel 선택을 유지하고 재오픈을 허용한다. `dismissUi()`에 모달 dismiss·참조 해제를 포함해 `onStop/onDestroy`에서도 정리한다.
- 디자인: 중앙 제목 좌우에 `spacing_48` 대칭 공간, 오른쪽 48dp `ImageButton`과 24dp `ic_close_white`, ripple 배경·focusable·`a11y_close`를 적용한다. 기존 제목·색상·간격·drawable/style과 `activity_gift_detail.xml` 패턴을 재사용한다.
- 범위 밖: ViewModel 운영 상태·API·호출부·호스트 변경, 새 취소 phase/API/공용 추상화, 로딩 Sheet/X 추가, 배경/back/swipe 차단 해제, Compose·의존성 추가. `V2ModalDialog.kt` 자체는 수정하지 않는다.
- [x] **RED:** 기존 Sheet 테스트에 X가 `onClose`만 전달하고 제출하지 않는 액션 검사를 추가한다. Flow 테스트는 X→확정 문구의 모달, '계속하기'→동일 선택 유지→X 재오픈, '종료하기'→Flow 제거→동일 호스트 새 ON/ALL 인증을 검증한다. 필요 시 동작 없는 연결 골격만 준비해 미구현 assertion 실패와 컴파일 오류를 구분한다.
- [x] **RED:** 최초 `Choosing` 및 POST 실패 `Failed`의 종료를 일반/오디오 경로에서 검증한다. 종료 직전 대비 POST·GET 횟수 증가 0, preference 쓰기 0, 완료 결과 0, Splash 이동 0, 호스트 finish 없음과 정지·파괴·재생성 시 기존 팝업 정리를 검사한다. 기존 GET 실패 선택 잠금/GET-only 재시도 회귀도 유지하며 레이아웃 속성 assertion은 작성하지 않는다. 최초 RED는 일반 경로 2건이며 오디오·수명주기 확장은 아래 기록처럼 구현 후 보강했다.
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*"`에서 X 액션·모달·Flow 종료가 없어 발생한 의도한 assertion 실패를 기록한다. 리소스 누락·컴파일 실패만으로 RED를 인정하지 않는다.
- [x] **GREEN:** 승인된 최소 헤더와 종료 콜백·모달 소유/정리를 구현한다. 확인은 제출·완료 분기가 아닌 `removeFlow()`로만 연결하고 기존 요청/성공/재시도 분기를 유지한다.
- [x] **GREEN 확인:** 같은 auth focused 명령을 재실행해 신규 행동과 기존 요청·저장·GET-only 재시도가 함께 통과하는지 확인한다. 실패 GET Sheet 종료를 보강해도 새 요청·저장·완료 없음만 검증하고 서버 롤백은 요구하지 않는다.
- [x] **REFACTOR:** 이번 변경으로 생긴 중복만 정리하고 auth focused 및 아래 Gate를 직렬 재실행해 실제 결과를 기록한다.
**검증 기록:** 승인 대기, 테스트 작성·RED/GREEN·빌드·린트 모두 미실행.
**승인 후 1차 기록 (2026-10-13):** Sheet X 및 `onClose`, Flow의 기존 `V2ModalDialog` 소유·`removeFlow()` 연결·`dismissUi()` 정리와 확정 한/영/일 리소스를 구현했다. auth 집중 RED는 58개 중 신규 2개 실패(모달 미표시 assertion 및 없는 모달 버튼 접근), GREEN은 같은 명령 58개 실패 0이었다. 로그는 `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/sodalive-phase5-auth-red.log`, `sodalive-phase5-auth-green.log`다. 부모 검증에서 신규 테스트 190~191행의 ktlint 위반 10건을 확인해 해당 줄만 보정하며, 계획의 popup 수명주기·오디오 실패 종료·debug 재진입 회귀도 보강 중이다. 첫 두 테스트만으로 P5-T1 완료를 선언하지 않는다.
**승인 후 보강 기록 (2026-10-13):** 기존 두 테스트를 일반/오디오 경로로 확장하고 popup 정지·재생성, 잠긴 회원 GET 실패 종료, debug 종료 후 ON/ALL 재진입을 추가했다. 중복 X/확인, 늦은 SDK callback, 선택 보존, 구독 해제 및 추가 요청·로컬 저장·완료 결과·Splash·호스트 종료 부재를 검사한다. 이 추가 범위는 구현 후 회귀 보강이며 별도 RED를 수행했다고 주장하지 않는다. 보강 중 `ShadowDialog` 최신 객체를 닫힌 popup 대신 Sheet로 오인한 테스트 오류 1건은 보유 Sheet 참조로 바로잡았다. `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*" :app:ktlintTestSourceSetCheck --console=plain` 최종 exit 0, BUILD SUCCESSFUL(33초), auth61개 실패·오류 0이다. `sodalive-phase5-auth-followup.log`와 부모 최종 전체 테스트가 증거다.
#### Task 5.2 본인인증 UI의 표시 용어만 정리
**Goal `P5-T2`:** 기존 ON/OFF caption의 표시값만 본인인증·민감한 콘텐츠 표현으로 맞춘다.
- 시작 조건: 사용자 구현 승인; 실행 순서는 `P5-T1 → P5-T2 → P5-GATE`다.
- 수정: `app/src/main/res/{values,values-en,values-ja}/v2_content_preference_strings.xml`의 기존 ON/OFF 두 key 값만 변경한다. `P5-T1`의 팝업 문자열은 보존한다.
- 인터페이스: `ContentPreferenceBottomSheet.render()`의 기존 ON/OFF 리소스 선택 및 key는 그대로 유지한다.
- 한국어 ON/OFF: '본인인증 완료 후 민감한 콘텐츠를 볼 수 있어요' / '민감한 콘텐츠가 목록과 검색에 노출되지 않아요'. 영문·일문도 같은 의미로 맞춘다.
- 확인만: `app/src/main/res/values/strings.xml`의 `auth_title/auth_desc/auth_desc_live/auth_go/screen_my_identity_verification`은 이미 '본인인증'이며 토글은 '민감한 콘텐츠 보기'다. 모두 변경하지 않는다.
- 범위 밖: 앱 전체 치환, 식별자/API/enum 변경, 법적 연령 안내 수정, 기존 '설정 완료'를 '설정 저장'으로 변경하는 작업.
- TDD 예외 사유: 분기·상태·라우팅 없이 정적 문자열 값만 바꾸므로 RED/GREEN 또는 layout-property 테스트를 만들지 않는다.
- 대체 검증 방법: 한/영/일 XML의 두 caption·key 대응과 변경 범위를 원문 대조하고, Gate의 `./gradlew :app:assembleDebug`로 리소스 컴파일을 확인한다. 실제 새 표시 로직이 필요해지면 계획을 먼저 보정하고 그 로직만 기존 auth 테스트에서 TDD로 검증한다.
- [x] 지정 caption만 변경하고 세 언어 의미·XML/key 및 기존 진입 문구·버튼·법적 안내 보존을 확인한다.
- [x] 리소스 빌드와 영향 회귀 결과를 기록한다.
**완료 증거 / 검증 기록:** XML·표시 문구 대조와 리소스 빌드 성공이 필요하다. 현재 승인 대기, 변경·검증 미실행.
**승인 후 검증 기록 (2026-10-13):** 부모가 한/영/일 파일 전체와 diff를 읽고 본인인증/민감한 콘텐츠 개념, popup 사용자 원문과 줄바꿈, '종료하기'/'계속하기' 의미를 대조했다. 기존 '설정 완료', 이미 올바른 인증 진입 안내와 앱 전체 문자열은 변경하지 않았다. `xmllint --noout` 변경 XML4개 exit 0, 최종 debug 빌드 및 전체 로컬 테스트 통과. 신규 로직 없이 문자열만 수정한 TDD 예외를 유지한다.
#### Task 5.3 리뷰 후속 아이콘 표시 크기 보정
**Goal `P5-R1`:** `REV-P5-001`의 X 표시 크기를 승인된 24dp로 맞춘다.
- 시작 조건: 독립 리뷰와 부모 확인으로 60×60px xxhdpi 아이콘은 20dp이며 플랫폼 `Widget.ImageButton` 기본 `scaleType=center`임을 확인했다.
- 대상/범위: `app/src/main/res/layout/v2_bottom_sheet_content_preference.xml`의 X에 `android:scaleType="fitCenter"` 한 줄만 추가한다. 48dp 버튼·12dp padding·아이콘·콜백은 보존한다.
- 회귀 검증: 기존 auth 테스트, 전체 로컬 테스트, `:app:assembleDebug`, `:app:ktlintCheck`, XML 파싱 및 독립 delta 재검토.
- 완료 증거: 48dp - 12dp × 2 = 24dp 표시 영역에 맞추는 fitCenter 설정, 위 검증 실제 결과와 리뷰 수정 완료 판정.
- TDD 예외: XML 표시 크기 보정으로 레이아웃 속성 테스트를 만들지 않는다. SDK 기본 스타일·원본 이미지 크기·XML 대조와 리소스 빌드를 대체 검증으로 사용한다. 실제 기기 시각 QA는 미검증으로 구분한다.
- [x] X의 scaleType 한 줄을 보정한다.
- [x] 영향 회귀·빌드·lint 및 독립 재검토 결과를 기록한다.
**검증 기록 (2026-10-13):** X의 `fitCenter` 한 줄을 보정했다. 부모의 XML 대조·파싱, auth61개를 포함한 전체 로컬 테스트1,557개와 debug build/ktlint gate가 통과했다. Oracle이 수정 delta와 최종 로그·보고서를 재확인해 `REV-P5-001` 해결 및 **APPROVE**로 판정했다. 실기기 시각 검증을 수행한 것으로 간주하지 않는다.
### Phase 5 Gate `P5-GATE`
#### Task 5.4 실기기 퇴장 잔상과 X 스타일 보정
**Goal `P5-R2`:** 사용자 보고의 퇴장 중 깜빡임을 제거하고 X를 주변 시각 위계에 맞춘다.
- 시작 조건: 사용자 '다음 단계를 계속 진행한다', PRD DEC-021. 사용자 발견 `REV-P5-002`는 실기기 6초 영상244프레임에서 반복 잔상 재현으로 확정했다. 기존 Task 완료 체크는 유지한다.
- 대상/수정: `v2/auth/V2AuthFlow.kt`의 종료 확인 callback에서만 `sheet?.window?.setWindowAnimations(0)` 후 `removeFlow()`; `app/src/main/res/layout/v2_bottom_sheet_content_preference.xml` X는48dp를 유지하며 padding14dp/fitCenter/gray_400로 원본20dp 캔버스를 표시한다.
- 범위 밖: 공용 모달 구현·시트의 다른 종료/진입 애니메이션·호출부·API/ViewModel·차단 정책·테스트 삭제/완화·사용자 build.gradle 변경.
- TDD 예외 사유: window 애니메이션/아이콘 표현 속성만 바꾸므로 속성값 고정 테스트를 추가하지 않는다. 기존 auth 행동 테스트를 유지하며 실기기 전환 영상의 재현을 RED, 수정 후 동일 장면에서 반복잔상 부재를 GREEN 근거로 삼는다.
- 회귀 명령: `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug :app:ktlintCheck --console=plain`. 원래 호스트 유지·추가 요청/저장 없음·계속하기·재인증61개auth회귀와 전체로컬테스트를 확인한다.
- 실기기 시나리오: (1) X→종료하기 전후 녹화의 반복잔상 부재 및 Flow제거 (2) 계속하기에서 선택 보존 (3) 배경 터치 후 시트 유지 (4) 종료 후 debug재진입 ON/ALL. 설정 완료는 눌러 서버 요청하지 않는다.
- 기기 QA 안전: 기존 debug앱 데이터를 보존하는 업데이트만 허용하며 설치 실패 시 삭제·서명 우회·기기 초기화하지 않는다. 영상은 `adb exec-out screenrecord`로 호스트 임시 경로에만 저장한다. 시간 제한 종료 및 잔류 recording프로세스 부재를 확인한다.
- 완료 증거: 수정 전후 영상·프레임 확인, 기존 회귀/빌드/lint, 독립 수정분 검토, 검증 기록. 재현 영상은 `auth-exit-transition-before.h264`, `auth-exit-transition-contact.png`(호스트 임시 opencode경로)다.
- [x] 실기기 종료 중 반복 잔상을 녹화하고 최종 Flow제거와 구분했다.
- [x] 종료 확인 경로와 X스타일만 최소 보정한다. 애니메이션 적용 시점은 P5-R3로 보정했다.
- [x] 자동 회귀 및 같은기기 전후 녹화·계속하기/배경차단을 검증한다.
- [x] 독립검토와 실제 검증결과·QA정리를 기록한다.
**검증 기록:** 후속 구현 시작. 창 애니메이션 보정의 효과는 수정 후 영상으로 판정하며 이전 자동테스트 통과를 전환 해결 증거로 사용하지 않는다.
**P5-R2 1차 검증:** 종료 확인 callback의 windowAnimations0과 X padding14dp/gray_400만 반영한 뒤 전체로컬테스트1,557개 실패·ignored0, debug빌드/ktlint 통과(BUILD SUCCESSFUL2분52초)를 확인했다. `adb install -r`는 Success이며 debug앱 데이터를 유지했다. 같은기기에서 여성향선택→X→계속하기→배경터치 후 여성향 checked=true 및 Sheet유지, 종료 후 Flow제거, 재진입 ON/ALL을 확인했다. 수정후6초영상은20프레임, 재반복영상은18프레임으로 이전244프레임의 반복alpha잔상은 관찰되지 않았다. 다만 여전히 단방향하강/페이드가 남아 있어 callback직전의 속성변경이 실제WindowManager에 제때 전달됐는지는 미확정이다. 앱업데이트 영향과 코드수정 효과를 구분하기 위해 독립검토를 진행하며, 반복깜빡임 부재만으로 이 구현의 인과관계까지 입증했다고 하지 않는다. 영상 `auth-exit-transition-after.h264`, 전체프레임 `auth-exit-transition-after-contact.png`, 반복영상 `auth-exit-transition-after-repeat.h264` 및 `auth-exit-x-after.png`는 호스트임시opencode경로에 저장했다. 설치/테스트 외 기기설정·서버인증/설정제출은 변경하지 않았다.
#### Task 5.5 종료 애니메이션 속성 전달 시점 보정
**Goal `P5-R3`:** `REV-P5-003`의 즉시 dismiss 전 속성전달 경합을 없앤다. P5-R2의 첫 후보를 이 방식으로 대체한다.
- 시작 조건: Oracle의 Android28 source 및 후영상 대조로 확인한 `setWindowAnimations(0)` 직후 `dismiss()`의 WMS반영 누락. 앞선 녹화에서 정상slide가 남았으므로 '코드로애니메이션제거성공'으로 인정하지 않는다.
- 파일/범위: `V2AuthFlow.kt`의 `showCloseConfirmation()`만 변경. popup표시 전 현재Sheet의 Window와 원래windowAnimations를 보관하고0을적용한다. confirm은 기존removeFlow, cancel은 해당Window의원래애니메이션복원 및 popup참조해제다. 이미 열렸거나잘못된phase에서는 기존guard로return한다.
- 선택 근거: 확인후 preDraw대기/타이머/새중단상태 대신, 확인팝업이표시되는 동안 속성을 미리 전달한다. '계속하기'로 돌아온시트의진입/저장애니메이션은원복한다. popup중onStop은기존dismissUi가정리하고 재개시새시트는원래테마로생성된다.
- 회귀/완료증거: 기존61auth 행동 및전체로컬테스트/assemble/ktlint; 실기기에서 popup전후 Sheetwindow의wanim0반영, 계속하기후원래wanim복원, 종료영상에Sheet하강/반복잔상없음, Flow제거, 재진입초기값을검증한다.
- TDD예외: window스타일속성전달시점문제는Robolectric최종상태나속성고정테스트로증명하지않는다. 앞서실기기RED영상과WMSwindow속성/동일기기전환녹화를대체증거로사용한다.
- [x] popup표시전에만0설정하고취소시원복하도록최소보정한다.
- [x] 같은기기WMS속성/전환과자동회귀를검증한다.
- [x] 독립delta리뷰와검증/정리기록을누적한다.
**P5-R3 검증 기록:** `showCloseConfirmation()`에서 현재 Sheet Window의 원래 애니메이션을 보관하고 popup 표시 전에 0을 적용했다. 계속하기는 원래 값을 복원하고 종료하기는 기존 `removeFlow()`만 호출한다. 위임 실행이 중단되어 부모가 기존 파일 상태를 재확인한 뒤 해당 메서드만 직접 보정했다.
- 자동 검증: `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug :app:ktlintCheck --console=plain` exit 0, BUILD SUCCESSFUL(2분 39초), 전체 테스트 1,557개 실패·ignored 0. 로그 `sodalive-auth-exit-prearm-gate.log`. Kotlin 컴파일 및 ktlint 통과, LSP 도구는 미제공이다.
- 실기기 속성: 동일 Sheet Window `2caa498`의 `wanim`이 X 전 `0x7f14000b`, popup 표시 중 0(덤프에서 항목 생략), 계속하기 후 `0x7f14000b`로 복원됐다. 이전 콜백 직전 변경과 달리 확인 터치 전에 WMS 반영을 확인했다.
- 실기기 동작: 여성향 선택→X→계속하기→배경 터치 후 여성향 checked=true와 Sheet 유지. 다시 X→종료하기 후 Flow가 제거되고 원래 MainV2Activity는 resumed 상태로 유지됐다. 시트가 아래로 이동하거나 반복적으로 나타나는 잔상 없이 제거되고 상위 팝업만 한 번 페이드아웃했다.
- 영상: `auth-exit-transition-final.h264`(6초 녹화, 20개 인코딩 프레임), 모든 프레임을 담은 `auth-exit-transition-final-contact.png`. raw H264의 프레임 수를 재생시간이나 프레임 간격으로 환산하지 않는다. 수정 전 244프레임 반복 잔상, 1차 후보의 정상 하강 전환과 구분해 대조했다.
- 안전·정리: `adb install -r` Success, debug 앱 데이터 보존. window_animation_scale=1.0 유지, 설정 완료·실제 인증 요청·기기 초기화 없음. 영상은 호스트로 스트리밍했고 `pidof screenrecord` 결과 프로세스 없음이다. APK SHA-256 `c3b75118062b8b9a211d3ed7b26a89104a0288838ddd038ee436080b95006dd6`, 사용자 build.gradle 해시 `77b3715efb4987ef590bd2aac1ba8a1bae3550c1216dfde9e1839f2fdf9ed950` 보존.
**최종 독립 판정:** Oracle이 최종 코드와 수정 전·후 네이티브 이미지를 직접 대조해 **APPROVE**, 남은 차단 항목 없음으로 판정했다. 최종 contact sheet의 4번째 프레임부터 Sheet가 사라지고 이후 재등장·하강·반복 페이드가 없으며 상위 확인 팝업만 단방향 페이드한다. X 크기·색상과 48dp 터치 영역, 계속하기 원복·수명주기 정리도 승인했다. P5-R2/R3을 완료하며, 실제 시각 검증 범위는 해당 Samsung Android 9 debug 기기로 한정한다.
**목표:** 신규 종료와 기존 제출/성공/재시도 경계를 targeted 회귀로 판정한다.
**시작 조건:** 사용자 구현 승인 후 `P5-T1/T2` 완료. 아래는 미래 실행 명령이며 지금 실행하지 않는다.
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.MainV2LoginGuardSourceTest" --tests "kr.co.vividnext.sodalive.audio_content.detail.AudioContentDetailActivitySourceTest"
./gradlew :app:assembleDebug
./gradlew :app:ktlintCheck
```
- 완료 증거: 명령별 exit code·테스트 결과·리소스 빌드 및 lint 실제 결과를 누적한다. X/취소/확인·새 인증·수명주기와 종료 시 요청/저장/완료/호스트 종료 부재, 기존 진입점·오디오 성공 라우팅·GET-only 재시도 보존을 확인한다.
- 범위 밖: 전체 앱 테스트, 실서버, 기기·에뮬레이터·스크린샷·시각 QA, 계측/connected 테스트, 레이아웃 속성 assertion. 변경은 공통 `v2/auth` 종료 연결과 표시 리소스에 한정하므로 auth 동작 및 지정 진입점·오디오 라우팅 회귀로 검증한다.
- 기존 ktlint 오류가 남으면 별도 기존 실패로 기록하고 통과로 바꾸거나 관련 없는 파일을 수정하지 않는다. Phase 4의 release 잔여 기술 검증은 이 Gate에 합치지 않는다.
**검증 기록:** 모든 미래 명령 미실행, 통과 주장 없음. 현재 작업은 문서 계획뿐이므로 리뷰 보고서는 만들지 않는다.
**최종 판정 (2026-10-13): 구현·자동 Gate 완료.** 위 문구는 계획 당시 기록이다. P5-T1/T2 및 P5-R1이 완료됐고, auth61개·진입점4개·오디오 라우팅4개를 포함한 전체 로컬 테스트1,557개 실패·제외0, debug build 성공, ktlint gate 성공을 확인했다. 독립 [Phase 5 리뷰](reviews/phase5-auth-content-preference-exit-review.md)는 **APPROVE**, 코드·자동 검증 차단 항목 없음이다. 별도 실제 기기 시각 QA와 LSP 진단은 미수행 상태를 보존한다.
## Progress와 Decision Log
- [x] 코드 조사와 정책 인터뷰를 완료하고 PRD·구현 계획을 작성했다.
@@ -259,6 +389,9 @@ Kotlin 운영 경로는 `app/src/main/java/kr/co/vividnext/sodalive/`, 테스트
| 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 실패는 별도 보존한다. |
| 2026-10-13 | DEC-018 | 후속 계획 / 구현 승인 대기 | PRD §17과 Phase 5의 X 확인 종료·인증 UI caption만 계획한다. 기존 완료 이력은 유지하며 사용자 범위 정정으로 구현을 시작하지 않는다. |
| 2026-10-13 | DEC-019 | 팝업 문구 확정 / 구현 승인 대기 | 사용자 지정 제목·두 줄 본문·'종료하기'·'계속하기'를 PRD §17과 P5-T1에 반영한다. 문구 확정은 전체 구현 승인이 아니다. |
| 2026-10-13 | DEC-020 | 구현 승인 | 사용자 '구현 승인'으로 P5-T1부터 실행한다. ULW 최종 검증으로 전체 로컬 테스트를 추가하며 제품 범위는 확장하지 않는다. |
### 구현 시작 기록
@@ -295,3 +428,11 @@ 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 검증은 재실행하지 않았으며 기존 잔여 사항을 유지한다.
- 2026-10-13 Phase 5 계획: DEC-018에 따라 기존 두 문서만 갱신한다. 구현·테스트 작성 승인은 없으며 제품 코드·빌드 설정·기존 `app/build.gradle` 사용자 변경은 건드리지 않는다. 과거 완료·검증 기록은 그대로 보존한다.
- 2026-10-13 Phase 5 문서 전용 검증: 두 문서를 읽고 사용자 확정 문구·줄바꿈·버튼 동작, PRD §17과 P5-T1/T2의 요구사항 연결 및 승인 경계를 대조했다. DEC-019로 최종 팝업 문구를 반영했다. 문서 범위 `git diff --check` exit 0, `./gradlew tasks --all --console=plain` exit 0, BUILD SUCCESSFUL(17초)이며 계획의 `testDebugUnitTest`, `assembleDebug`, `ktlintCheck` task 존재를 확인했다. TDD 예외 사유는 제품 동작을 바꾸지 않는 문서 작업이며 대체 검증은 문서·코드 대조와 명령 목록 확인이다. LSP 진단 도구가 제공되지 않아 Markdown 진단은 수행하지 못했다. 앱 테스트·빌드·린트·기기/서버 검증은 실행하지 않았고 기존 Gradle deprecation 경고는 수정하지 않았다. 이번 수정은 기존 PRD·계획 두 파일뿐이며 기존 사용자 `app/build.gradle` 변경은 보존했다. 구현 승인 대기 상태로 문서 작성을 마친다.
- 2026-10-13 Phase 5 통합 1차: 부모가 `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug :app:ktlintCheck --console=plain`을 실행했다. 로컬 테스트 보고서는 1,554개 실패·ignored 0, 성공률 100%지만 전체 명령은 신규 `V2AuthFlowTest.kt` 190~191행의 줄 길이·줄바꿈 lint 위반 10건으로 BUILD FAILED(4분 27초)다. assemble 완료 Task가 없어 이번 실행으로 APK 빌드 성공을 주장하지 않는다. 로그는 `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/sodalive-phase5-parent-gate.log`다. 기존 사용자 `app/build.gradle` SHA-256은 작업 전후 `77b3715efb4987ef590bd2aac1ba8a1bae3550c1216dfde9e1839f2fdf9ed950`로 동일하다.
- 2026-10-13 Phase 5 검증 경계: `xmllint --noout`으로 변경 layout 및 한/영/일 문자열 XML 4개를 검사해 exit 0을 확인했다. LSP 도구 미제공으로 해당 진단은 불가하며 Kotlin 컴파일·ktlint로 대체한다. 실기기 목록과 기존 AVD 존재만 조회했고 앱 설치·실기기 UI 조작·스크린샷·서버 호출은 하지 않았다. 독립 debug 인증 화면 진입점이 없고 실제 로그인/회원 조회와 분리된 native QA 경로를 확보하지 못해 실제 렌더링·시각 QA는 [blocked]다. 로컬 Robolectric 행동 검증을 실기기 검증으로 표현하지 않으며, 새 에뮬레이터·서버·테스트 harness는 만들지 않는다.
- 2026-10-13 Phase 5 최종 자동 검증: P5-R1의 `scaleType="fitCenter"` 보정 후 부모가 `./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug :app:ktlintCheck --console=plain`을 재실행했다. exit 0, BUILD SUCCESSFUL(1분 59초), 전체 로컬 테스트 1,557개 실패·ignored 0이다. XML 보고서에서 auth61개와 MainV2LoginGuardSourceTest4개, AudioContentDetailActivitySourceTest4개 모두 실패·오류·skip0을 확인했다. APK는 `app/build/outputs/apk/debug/app-debug.apk`, SHA-256 `023d605f17384c2f065260b724e76b1a03d3e6f65b2ff7076e68d7fb7bb4649d`다. `sodalive-phase5-final-gate.log`에 전체 출력이 있으며 변경 XML4개 파싱과 `git diff --check`도 exit 0이다. 기존 사용자 build.gradle 해시는 전과 동일하다. 독립 delta 리뷰 결과는 다음 기록에 누적한다.
- 2026-10-13 Phase 5 최종 리뷰: Oracle이 fitCenter 수정과 최종 로그·HTML/XML 보고서를 직접 확인해 **APPROVE**, 남은 코드·자동 Gate 차단 항목 없음으로 판정했다. 최종 `ktlintCheck`는 앞선 실행 결과를 활용한 UP-TO-DATE 성공이며, 새로 전부 재실행했다고 해석하지 않는다. 실제 기기/서버/시각 QA 및 LSP는 미수행 상태다. QA용 앱 설치·기기 초기화·에뮬레이터·서버·별도 harness 생성이 없어 종료할 QA 프로세스는 없다. 기존 인증 테스트 실행 예시를 가이드에 추가했고 커밋·푸시는 하지 않았다.
- 2026-10-13 P5-R2/R3 후속 최종: 사용자 깜빡임 피드백을 실제 Samsung Android 9 기기에서 녹화해 재현한 후, 팝업 표시 전 애니메이션 준비·계속하기 원복 및 작은 회색 X를 적용했다. 최종 WMS 속성 `기본→0→기본`과 `auth-exit-transition-final-contact.png` 전체20프레임을 대조해 Sheet 반복 잔상·하강 제거를 확인했다. 계속하기 선택 유지·배경 차단·최종 Flow 제거·호스트 유지도 확인했다. 전체1,557개 테스트 실패·제외0, debug빌드·ktlint gate 통과(2분39초), 독립 코드·실기기 이미지 검토 **APPROVE**. 검증용 debugAPK를 데이터 보존 업데이트로 설치했으며 기기 애니메이션 설정은1.0 그대로다. 녹화 프로세스 종료를 확인했고 실제 인증/설정 제출·기기 초기화·커밋·푸시는 하지 않았다. 이전 미수행/차단 기록은 당시 이력이며 현 검증 범위는 해당기기debug에 한정한다. 다른 OS·release·실서버 및 LSP는 미검증이고 기존 사용자 build.gradle 변경은 보존했다.
- 2026-10-14 Phase 5 커밋 전 검증: `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.auth.*' :app:assembleDebug :app:ktlintCheck --console=plain` exit 0, BUILD SUCCESSFUL(1분 3초). 결과 XML 5개 클래스의 인증 테스트 61개 모두 통과(실패·오류·skip 0), debug 빌드 성공, ktlint는 UP-TO-DATE 성공이다. `git diff HEAD --check` exit 0을 확인했다. 검증은 기존 사용자 버전 변경이 있는 작업 트리에서 실행했으며 `app/build.gradle`은 커밋에서 제외한다. 전체 테스트·release·실기기 QA는 이번 커밋 절차에서 재실행하지 않았다.