Files
sodalive-android/docs/20261012_본인인증_후_콘텐츠_보기_설정/reviews/phase5-auth-content-preference-exit-review.md
T

8.5 KiB
Raw Blame History

Phase 5 본인인증 콘텐츠 보기 설정 종료 리뷰

1. 리뷰 정보

항목 내용
대상 Phase 5 / P5-T1, P5-T2 및 후속 P5-R1
기준 현재 working tree의 인증 Sheet·Flow·전용 리소스·인증 테스트 변경
일자 2026-10-13
리뷰어 Oracle 독립 읽기 전용 검토, 부모 근거 재확인
기준 문서 ../prd.md §17, ../plan-task.md Phase 5
상태 실기기 전환 후속 수정 검증 완료 / 최종 APPROVE

2. 목적과 범위

  • X 확인은 설정 창·Flow만 닫고 호스트는 유지하며, 계속하기는 팝업만 닫는지 검토한다.
  • 최초·저장 실패·회원 GET 실패·중복 액션·재인증·정지/재생성에서 부작용 없이 기존 요청·성공·재시도를 보존하는지 확인한다.
  • 확정 문구, 인증 UI 한정 용어, 중앙 제목, 48dp 터치 영역과 24dp 표시 아이콘, 기존 모달·접근성 리소스를 대조한다.
  • 기존 사용자 app/build.gradle, 레거시·API 변경, 실기기 시각 QA는 제외한다.

3. 검토 근거

  • 코드: v2/auth/ContentPreferenceBottomSheet.kt, V2AuthFlow.kt, 기존 V2AuthViewModel.kt, base/BaseViewModel.kt, v2/components/modal/V2ModalDialog.kt와 8개 Flow 호출부.
  • 리소스: v2_bottom_sheet_content_preference.xml, 한/영/일 v2_content_preference_strings.xml, drawable-xxhdpi/ic_close_white.png, Android SDK Widget.ImageButton 스타일.
  • 테스트: 기존 Sheet/Flow 테스트 및 신규 종료·계속하기·중복·수명주기·오디오·debug 재진입 회귀.
  • 실행 증거: 최초 auth RED 58개 중 2개 실패, GREEN 58개 통과. 부모 통합 1차는 전체 테스트 1,554개 실패 0이나 신규 테스트 lint10건으로 중단. 보강 후 auth61개 및 test-source ktlint 통과 로그를 부모가 추가 확인했다.
  • 실제 기기 렌더링은 확인하지 않았다. Robolectric은 실행된 로컬 동작 검증이며 실기기 UI 증거가 아니다.

4. 발견 사항

ID 심각도 상태 발견 후속 Task
REV-P5-001 Low 수정 완료 ImageButton 기본 center로 X가 승인된 24dp가 아닌 20dp로 표시됨 P5-R1

REV-P5-001

  • 관련 요구: PRD §17의 24dp 표시 아이콘, 계획 P5-T1.
  • 근거: sips -g pixelWidth -g pixelHeight app/src/main/res/drawable-xxhdpi/ic_close_white.png 결과 60×60px이다. xxhdpi 기준 20dp이며 SDK platforms/android-35/data/res/values/styles.xml:592의 Widget.ImageButton은 scaleType=center다.
  • 현재 48dp 버튼과 12dp padding은 터치 영역은 충족하지만 원본 아이콘을 24dp로 확대하지 않는다.
  • 최소 조치: X에 android:scaleType="fitCenter"만 명시한다. 공용 아이콘·다른 소비처는 수정하지 않는다.
  • 부모가 근거를 직접 재확인한 뒤 코드 수정 전에 P5-R1을 계획에 추가했다.

5. 그 외 판정

종료·취소·수명주기·기존 제출 경로에서 입증된 추가 차단 결함은 없다. 모달 중복 방지와 dismiss-before-callback, Flow 제거 시 구독 정리, 원래 화면 유지, 종료 시 요청·저장·완료 부작용 부재, GET-only 재시도와 기존 back/outside/swipe 정책 보존을 확인했다. 앱 전체 문자열 치환이나 레거시·API·ViewModel 운영 코드 변경은 없다.

6. 리뷰 종료 판정

최초 판정은 REQUEST_CHANGES이며 P5-R1 수정 및 최종 테스트·빌드·lint 증거와 delta 재검토를 기다린다. 실제 렌더링 QA는 별도 미검증 항목이다.

7. 수정 후 검증 기록

1차 수정 검증 - 2026-10-13

  • 무엇을: btn_close에 android:scaleType="fitCenter" 한 줄을 추가했다. 48dp 터치 영역·12dp padding과 기존 자산·콜백은 유지했다.
  • 왜: 승인된 24dp 표시 영역에 아이콘을 맞추기 위한 REV-P5-001 최소 수정이다.
  • 검증: 부모가 ./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug :app:ktlintCheck --console=plain을 실행해 exit0, BUILD SUCCESSFUL(1분59초)을 확인했다. 전체1,557개 실패·ignored0, auth61개 및 진입점4개·오디오 라우팅4개 모두 실패·오류0이다. 최종 ktlintCheck는 UP-TO-DATE 성공이며 앞선 test-source lint 실행도 통과했다.
  • 증거: /var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/sodalive-phase5-final-gate.log, app/build/reports/tests/testDebugUnitTest/index.html, app/build/test-results/testDebugUnitTest/.
  • 독립 재검토: Oracle이 XML delta와 위 로그·HTML/XML 결과를 직접 확인해 APPROVE, 추가 코드 수정 불필요 및 남은 차단 항목 없음으로 판정했다.
  • 최종 결론: REV-P5-001 수정 완료, 코드·자동 Gate 승인. 최초 REQUEST_CHANGES는 이전 이력이다. 실제 기기 시각 QA 및 LSP 진단은 미수행으로 남긴다.

REV-P5-002 - 종료 후 창 잔상 반복과 X 시각 불일치

  • 상태/심각도: 사용자 보고 및 실기기 녹화로 확정 / Medium. 기존 리뷰가 수행하지 못한 실제 window 퇴장 전환 문제다.
  • 관찰: X→종료하기 후 인증 Fragment는 제거됐지만, BottomSheet surface가 몇 초 동안 alpha를 반복하며 남았다. 배경 터치 차단과 명시적 dismiss는 충돌하지 않았다.
  • 근거: 같은 SM_G960N의 auth-exit-transition-before.h264 6초/244프레임과 auth-exit-transition-contact.png. APK의 기본 mtrl_bottom_sheet_slide_out는 200ms 단방향 fade/translate이며 상세한 반복 원인은 미확정이다.
  • 처리: 코드 수정 전에 PRD DEC-021과 plan-task.md P5-R2를 추가했다. 종료 확인 시에만 시트 windowAnimation을 제거하는 좁은 보정을 전후 영상으로 검증한다. 공용 모달/서버/차단 정책은 유지한다.
  • X는 사용자 피드백에 따라 원본20dp 캔버스와 gray_400로 조정하되48dp터치영역을 보존한다. 이전24dp제안은 이 후속 요구로 대체한다.
  • 이전 자동검증/APPROVE 기록은 삭제하지 않으며, 해당 기록만으로 전환 깜빡임까지 해결됐다고 주장하지 않는다.

REV-P5-003 - 확인 직전 windowAnimations 변경이 WMS에 전달되기 전 제거됨

  • 상태/심각도: Oracle 소스추적 및 부모 녹화로 확정 / Medium, 첫 후보 승인 차단.
  • 근거: Android28 Dialog.onWindowAttributesChanged→ViewRootImpl.setLayoutParams는 다음traversal을예약한다. 같은콜백의즉시dismiss는 dispatchDetachedFromWindow에서mView=null/WindowSession.remove/unscheduleTraversals를실행하므로 서버가 이전애니메이션속성을사용할수있다.
  • 수정후 첫영상에서 반복은없지만 Sheet하강/fade가남아있어 코드효과와재설치효과가분리되지않았다. 따라서 첫후보를완료처리하지않는다.
  • 후속: 코드수정전P5-R3를계획에추가했다. popup표시전에애니메이션을0으로미리설정하고계속하기에서원복하는작은보정으로검증한다. 타이머/새상태/공용모달수정없이 WMS속성실제반영과동작을대조한다.

2차 수정 검증 - REV-P5-002/003 완료

  • 최종 구현은 popup 표시 전에 Sheet Window의 원래 애니메이션을 보관해 0으로 설정하고, 계속하기에서 원래 값을 복원한다. 종료하기의 Flow 제거와 기존 공용 모달은 유지한다.
  • 부모 자동 검증: 전체 1,557개 실패·ignored 0, debug 빌드·ktlint 성공(2분 39초). sodalive-auth-exit-prearm-gate.log 및 테스트 HTML/XML을 확인했다.
  • 부모 실기기 검증: 동일 Sheet Window의 WMS 값이 0x7f14000b → 0 → 0x7f14000b로 전환됐다. 여성향 선택이 계속하기·배경 터치 후 보존됐다. 최종 종료 후 인증 Flow는 없고 호스트는 resumed 상태다.
  • 시각 증거: auth-exit-transition-final-contact.png는 최종 6초 녹화의 모든 20프레임이다. 원래 반복 alpha 영상, 첫 후보의 하강 영상과 달리 Sheet가 바로 사라지고 확인 팝업만 한 번 페이드한다. X는20dp/gray_400으로 조정됐고48dp터치영역은 보존됐다.
  • 독립 최종 리뷰: Oracle이 코드와 세 단계 영상을 직접 대조해 APPROVE했다. REV-P5-002/003 수정 완료이며 남은 차단 항목은 없다.
  • 한계: Android 9 Samsung debug 기기에서 확인한 결과다. 다른 OS·release·실서버 인증은 미검증이고 LSP 도구 미제공은 Kotlin 컴파일·ktlint로 대체했다. 원래 반복의 시스템 내부 원인을 캐시 오류로 확정하지 않는다. 앱 데이터 삭제·설정 제출·기기 애니메이션 설정 변경은 하지 않았다.