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
@@ -4,7 +4,7 @@
| 항목 | 내용 |
|---|---|
| 문서 상태 | Phase 1~4 기능 범위 완료; release 마이 탭 사용자 확인 반영, 잔여 기술 검증 별도 기록 |
| 문서 상태 | Phase 1~5 및 종료 전환·X 스타일 후속 수정 완료; Android 9 실기기 검증 완료, 기존 잔여 기술 검증 보존 |
| 작성일 | 2026-10-12 |
| 최종 수정일 | 2026-10-13 |
| 대상 제품 | Android SodaLive 본인인증 및 성인 콘텐츠 보기 설정 |
@@ -137,6 +137,9 @@ Bootpay 본인인증을 마친 사용자가 모든 인증 진입점에서 같은
| 2026-10-13 | DEC-014 | 확정 | 기존 인증 전환 작업의 연속으로 본 문서와 계획에 후속 항목만 추가한다. 구현은 별도 승인 전 금지 | 사용자 명시 지시 |
| 2026-10-13 | DEC-015 | 제안 / 구현 승인 대기 | keep 규칙 추가 대신 미사용 인증 메서드·DI 의존성·전용 파일을 제거한다. §4의 레거시 변경 제외에 대한 예외는 §16 범위에 한해 별도 승인받는다 | 마이 탭 오류 조사 및 사용자 제거 방향 제안 |
| 2026-10-13 | DEC-017 | 정정 / 확정 | 사용자 release 마이 탭 정상 진입 확인과 문서 갱신 요청에 따라 Phase 4 기능 범위를 완료 처리한다. 최적화 산출물 미검증·기존 lint 오류는 별도 잔여 사항으로 보존하며 통과로 바꾸지 않는다 | 사용자 직접 검증 보고 및 "충족 되었으면 문서를 갱신한다" 지시 |
| 2026-10-13 | DEC-018 | 후속 계획 / 구현 승인 대기 | §17의 X 확인 종료와 본인인증 관련 표시 문구만 Phase 5로 추가한다. 기존 완료는 다시 열지 않으며 제안 디자인·팝업 문구와 구현은 별도 승인 대상이다 | 사용자 후속 요구 및 인증 UI로 한정한 범위 정정; 구현 승인이 아님 |
| 2026-10-13 | DEC-019 | 팝업 문구 확정 / 구현 승인 대기 | 사용자 지정 제목·두 줄 본문·'종료하기'·'계속하기'를 §17에 반영한다. DEC-018의 팝업 제안을 대체하며 전체 구현 승인과 구분한다 | 사용자 문구 지정 및 '확정' 답변 |
| 2026-10-13 | DEC-020 | 구현 승인 | §17 및 Phase 5의 최소 X 디자인·종료 동작·인증 UI 용어 변경을 승인받아 구현한다. 기존 코드·검증 이력과 사용자 변경은 보존한다 | 사용자 '구현 승인' 및 ULW 실행 요청 |
## 14. 추적 및 변경 관리
@@ -182,3 +185,58 @@ Bootpay 본인인증을 마친 사용자가 모든 인증 진입점에서 같은
### 사용자 확인 후 종료 상태 (2026-10-13, DEC-017)
사용자가 release 빌드에서 마이 탭 정상 진입을 직접 확인했다. 기존 코드 제거·자동 회귀·코드 리뷰 결과와 이 사용자 검증을 근거로 이번 마이 탭 오류 수정의 기능 범위를 완료 처리한다. 위 차단 기록은 당시 에이전트 실행 이력으로 보존한다. 사용자 확인 범위는 마이 탭 진입이며, 최적화 설정·release DEX/mapping 검사·오디오 상세 실기기 동작까지 확인한 것으로 확장하지 않는다. 최적화 산출물 미검증 및 기존 ktlint 오류 6건은 미해결 잔여 기술 사항이며, 기능 완료와 구분한다.
## 17. 본인인증 선택 화면 종료 및 표시 문구 후속 계획
### 승인 경계 (2026-10-13, DEC-018)
**현재 승인 상태:** DEC-020으로 Phase 5 구현이 승인됐다. 아래 승인 대기 문구는 계획 당시 이력이며, 구현·검증 완료는 새 실행 기록으로 판정한다.
현재 허용 범위는 기존 PRD·계획 갱신뿐이다. 사용자 범위 정정은 구현 승인이 아니며, Phase 5는 **사용자의 명시적 구현 승인** 후 시작한다. Phase 1~4 완료 체크·검증·잔여 기술 사항은 보존한다.
원래 `PREF-002`, §6·§9 및 `DEC-002/008`의 '완료 버튼으로만 닫기'는 당시 완료 기준으로 남긴다. 승인 후 Phase 5에 한해 아래 X 확인 종료가 그 제한을 대체한다. 기존 완료 Task를 재개하는 변경이 아니다.
### 후속 요구사항과 수용 기준
| ID | 상태 | 요구사항 및 수용 기준 | 추적 |
|---|---|---|---|
| EXIT-001 | 구현 승인 대기 | 최초 `Choosing`와 실패 후 `Failed` Sheet에 X를 제공한다. X는 제출하지 않고 기존 `V2ModalDialog` 확인 팝업만 연다. 취소는 팝업만 닫고 선택·Sheet·Flow를 유지하며 다시 X를 누를 수 있다 | `P5-T1` |
| EXIT-002 | 구현 승인 대기 | 팝업 확인은 Sheet와 `V2AuthFlow`를 종료하고 원래 호스트 Activity는 유지한다. `AUDIO_AUTH_COMPLETED`, Splash 재시작, 호스트 `finish()`, preference 쓰기, 종료로 인한 새 API 요청은 없다. 이후 같은 호스트에서 새 인증을 시작할 수 있다 | `P5-T1` |
| EXIT-003 | 구현 승인 대기 | 기존 배경/system back/swipe 차단과 요청·성공·재시도는 유지한다. 로딩에는 Sheet/X가 없고 변경하지 않는다. `removeFlow()`의 중복 제거·상태 저장 가드와 `dismissUi()`의 수명주기 정리를 재사용한다 | `P5-T1`, `P5-GATE` |
| COPY-001 | 구현 승인 대기 | 본인인증 관련 UI의 표시 용어만 '본인인증', '민감한 콘텐츠'로 맞춘다. 기존 인증 진입 문구와 '설정 완료' 버튼은 유지하고 ON/OFF 설명 두 개 및 대응 영문·일문만 수정한다 | `P5-T2` |
### 최소 디자인 제안과 확정 팝업 문구
- Android XML Views를 유지한다. 기존 제목 스타일 `V2ContentPreferenceTitle`, 색상 `white/gray_900/gray_400/soda_400`, 간격 `spacing_*`, Sheet·모달 drawable/style을 재사용하며 화면 전체를 재설계하지 않는다.
- 헤더 중앙 제목 양쪽에 대칭 공간을 확보하고 오른쪽 X는 48dp 터치 영역(`spacing_48`), 24dp 표시 아이콘(`spacing_24`)으로 제안한다. `activity_gift_detail.xml`의 `ImageButton`, `?attr/selectableItemBackgroundBorderless`, `ic_close_white`, `a11y_close` 패턴을 재사용하고 버튼을 focusable로 한다.
- `ui-ux-pro-max`의 native `pro-rules.md` 기준은 Android 최소 48dp다. 기존 `ic_close_white` 이미지와 닫기 패턴에 맞춰 적용하며 새 디자인 시스템·Compose 전환·의존성 추가는 하지 않는다.
- 팝업 문구는 사용자 확정값이다(`DEC-019`). 제목: **'본인인증 종료'**, 본문: `본인인증을 종료하시겠어요?\n종료하면 다시 본인인증을 진행해야 해요.`. `\n`은 실제 줄바꿈으로 표시한다.
- `confirm`: **'종료하기'**로 Sheet와 인증 흐름을 종료한다. `cancel`: **'계속하기'**로 팝업만 닫는다. 기존 모달 컴포넌트를 재사용하되 버튼 이름은 공용 '확인'/'취소' 대신 확정 문구를 전달한다. 제목·본문·두 버튼은 한/영/일 리소스로 제공하며 한국어는 사용자 원문 그대로 사용한다. 디자인 제안과 구현은 승인 대기다.
### 표시 문구 변경 경계
- 대상은 `app/src/main/res/{values,values-en,values-ja}/v2_content_preference_strings.xml`의 `v2_content_preference_adult_on_description`, `v2_content_preference_adult_off_description`이다.
- 한국어 ON: **'본인인증 완료 후 민감한 콘텐츠를 볼 수 있어요'**, OFF: **'민감한 콘텐츠가 목록과 검색에 노출되지 않아요'**. 영문·일문도 본인인증 및 민감한 콘텐츠 의미로 일치시킨다.
- 기존 `auth_title/auth_desc/auth_desc_live/auth_go/screen_my_identity_verification`은 이미 '본인인증'이므로 확인 후 그대로 둔다. 기존 토글 '민감한 콘텐츠 보기'도 유지한다. 버튼은 실제 '설정 완료'이며 '설정 저장'으로 바꾸지 않는다.
- 앱 전체 치환, API·enum·리소스 식별자 변경, 법적 연령 안내 수정은 제외한다. '설정 완료'는 기존 서버 제출 동작이며 종료는 제출과 분리한다. 서버 취소·롤백 API나 새 취소 상태·공용 추상화를 추가하지 않는다.
- 기존 GET 실패 후 GET-only 재시도는 유지한다. 실패 Sheet 종료의 기술 회귀 검증은 가능하지만 이미 제출된 서버 결과를 되돌리는 요구사항으로 확장하지 않는다.
**검증 상태:** 문서 계획만 작성하며 Phase 5 테스트·빌드·린트는 미실행이다. 완료 기준은 `P5-T1/T2`와 targeted `P5-GATE`의 실제 증거이며 과거 통과 기록으로 대체하지 않는다.
### 구현 및 자동 검증 완료 (2026-10-13)
DEC-020 승인 범위의 `EXIT-001~003`, `COPY-001` 구현과 자동 검증을 완료했다. X에서 기존 종료 팝업을 표시하고 '종료하기'는 설정 Sheet·인증 Flow를 종료하되 원래 화면은 유지한다. '계속하기'는 선택값을 유지하고 팝업만 닫는다. 기존 요청·성공·재시도는 보존하고 인증 UI 한정 용어 및 확정 문구를 한/영/일 리소스에 반영했다.
최종 전체 로컬 테스트 1,557개 실패·제외 0, debug 빌드와 ktlint gate가 통과했다. 독립 리뷰의 X 표시 크기 지적 `REV-P5-001`을 `fitCenter`로 보정한 후 코드·자동 검증 판정은 **APPROVE**다. 위 승인 대기·미실행 문구는 계획 당시 이력이며 현재 판정은 본 절과 계획의 최종 Verification Log를 따른다. 실제 기기 렌더링·시각 QA와 LSP 진단은 미수행이며 자동 검증과 구분한다. 상세는 [Phase 5 리뷰](reviews/phase5-auth-content-preference-exit-review.md)를 참조한다.
### 실기기 전환 후속 수정 (2026-10-13, DEC-021)
사용자가 X의 시각 불일치와 '종료하기' 후 사라지기 전 깜빡임을 보고했고 다음 단계 진행을 요청했다. 실기기 녹화에서 Flow 제거 후에도 시트 잔상이 반복적으로 밝아졌다 어두워지는 것을 확인했다. 배경 터치 차단과 명시적 `dismiss()`는 별개이며 차단 설정은 유지한다. APK의 기본 퇴장 애니메이션은 단방향 200ms여서 기기에서 반복되는 상세 원인(캐시 등)은 미확정이다.
- `EXIT-004`: 종료 팝업의 확인 경로에서만 하위 시트의 window 퇴장 애니메이션을 끄고 기존 Flow 제거를 실행한다. 진입·설정 완료·계속하기·뒤로가기/배경/드래그 정책과 서버 동작은 바꾸지 않는다.
- `STYLE-001`: X는 기존 48dp 터치 영역·ripple·접근성 이름을 유지하고 기존 자산의 원래 20dp 캔버스 크기 및 `gray_400`으로 보조 동작 위계를 맞춘다. 이전 24dp 표시 제안을 이번 사용자 시각 피드백으로 대체한다.
- 완료 판단은 최종 창이 없어지는 것만이 아니라 같은 기기·동일 애니메이션 설정의 전후 녹화에서 시트 재등장/밝기 반복이 없는지로 한다. '계속하기' 선택 유지 및 배경 터치 차단도 실기기에서 확인한다.
- 기존 완료 Task는 유지하고 계획의 `P5-R2`로 추적한다. 디버그 앱 검증은 데이터 보존 업데이트만 사용하며 앱 데이터 삭제·로그아웃·실서버 인증/설정 제출·기기 설정 변경은 하지 않는다.
**DEC-022 적용 시점 정정:** 종료 직전 속성 변경은 Android 28에서 WindowManager 반영보다 창 제거가 먼저 될 수 있어 P5-R3로 보정했다. X로 확인 팝업을 열 때 하위 시트의 원래 windowAnimations를 보관하고 0을 미리 적용한다. '종료하기'는 기존 제거를 즉시 실행하며, '계속하기'는 원래 애니메이션을 복원하고 선택을 유지한다. 타이머·공용 모달·다른 화면은 변경하지 않는다. 실기기에서 원래 값→0→원래 값의 서버 속성 전환과 최종 종료 영상의 시트 퇴장 잔상 부재를 확인했다. 최종 독립 검토 결과는 계획에 누적한다.
**후속 완료:** 전체 로컬 테스트 1,557개와 debug 빌드·ktlint gate가 통과했다. 같은 Samsung Android 9 기기의 최종 영상에서 시트 재등장·하강·반복 페이드가 사라졌고, 계속하기 선택 유지·애니메이션 원복·배경 차단·Flow 제거를 확인했다. 독립 코드·실기기 이미지 검토는 **APPROVE**다. 검증용 debug 앱은 데이터 보존 업데이트로 설치했으며, 다른 OS와 release·실서버 인증은 이번 실기기 검증 범위 밖이다. 원래 반복 애니메이션이 발생한 시스템 내부 원인을 캐시 오류로 확정하지는 않는다.