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

28 KiB

본인인증 후 콘텐츠 보기 설정 PRD

문서 정보

항목 내용
문서 상태 Phase 1~5 및 종료 전환·X 스타일 후속 수정 완료; Android 9 실기기 검증 완료, 기존 잔여 기술 검증 보존
작성일 2026-10-12
최종 수정일 2026-10-13
대상 제품 Android SodaLive 본인인증 및 성인 콘텐츠 보기 설정
작성자·결정권자 사용자 승인 필요
관련 API Contract 별도 파일 없음, 본 문서 §8에 초안 계약 포함
관련 구현 계획 plan-task.md
관련 review 최종 리뷰

요구사항 상태

요구사항과 정책 인터뷰 및 두 문서의 최종 사용자 승인이 완료됐다. 현재 브랜치에서 계획에 따라 구현한다.

2026-10-13 추가: 위 승인은 기존 구현에 대한 기록이다. §16의 미사용 인증 경로 제거는 문서 작성만 승인됐으며, 별도 사용자 승인 전에는 코드·테스트·빌드 설정을 변경하지 않는다.

1. Overview

Bootpay 본인인증을 마친 사용자가 모든 인증 진입점에서 같은 BottomSheet로 성인 콘텐츠 표시 여부와 취향을 함께 정하고 인증을 제출한다. 서버 인증 성공 뒤 7개 일반 경로는 기존 Splash 재시작을 유지하며, 오디오 상세 경로만 회원 정보를 동기화하고 현재 상세를 다시 불러온다.

2. Problem Statement

  • 현재 Auth.auth 완료 직후 인증 POST가 실행되어 사용자가 인증과 콘텐츠 보기 설정을 함께 선택할 수 없다.
  • 구식 인증 요청·응답은 영수증과 성별 중심이며 설정 선호도를 제출하지 않는다.
  • 성공 후 일반 화면과 오디오 상세의 후속 처리가 다르므로 동작을 명확히 분리해야 한다.

해결 기준은 8개 진입점의 공통 선택 UI, 합의한 요청 payload, 각 경로의 성공 후처리를 테스트로 확인하는 것이다.

3. Goals

  • 인증 완료와 인증 POST 사이에 설정 선택 BottomSheet를 한 번 표시한다.
  • 사용자 선택을 인증 POST에 포함하고 성공 뒤 요청 경로별 후속 동작을 보장한다.
  • 기존 저장 설정을 초기값으로 사용하거나 별도 설정 PATCH를 보내지 않는다.

4. Non-Goals

  • Auth.kt, 구식 DTO/API/repository, MyPageViewModel, AudioContentDetailViewModel의 기존 흐름 변경은 기본 제외한다.
  • 별도 설정 PATCH, 설정 화면 전면 수정, 성별 기반 취향 추론은 제외한다.
  • 문서 승인 전에는 제품 코드를 구현하지 않는다.

5. 사용자 및 권한

로그인 사용자가 Bootpay 인증 절차를 정상 완료한 경우에만 선택 UI와 인증 요청을 진행한다. Bootpay 취소·오류는 인증 제출을 진행하지 않는다. 토큰은 기존 사용자 API 인증 관례를 따르며 기록하거나 화면에 노출하지 않는다.

6. 핵심 사용자 흐름

  1. 사용자가 인증을 시작하고 Bootpay를 완료한다.
  2. 모든 8개 진입점에서 같은 BottomSheet를 표시한다. 초기값은 기존 로컬 상태와 무관하게 ON 및 ALL이다.
  3. ON일 때 ALL, MALE, FEMALE 중 하나를 선택한다. OFF 전환은 contentType을 ALL로 초기화하고 selector를 숨겨 OFF caption을 표시한다.
  4. 완료 버튼만 닫기 경로다. 배경, system back, swipe 모두 닫지 않는다. 완료 탭은 Sheet를 닫은 뒤 선택값으로 인증+설정 POST를 보낸다.
  5. 일반 7개 경로는 POST 성공 후 제출 설정을 저장하고 기존 Splash를 재시작한다. 실패하면 오류 표시 후 같은 선택값의 Sheet를 다시 연다. 오디오 상세는 POST 성공 후 회원 정보 GET 성공, 설정 저장, 기존 getAudioContentDetail 재호출 순이며 재시작하지 않는다.

7. 기능 요구사항

ID 상태 요구사항 및 수용 기준
AUTH-001 확정 Auth.auth 8개 진입점 모두 Bootpay 완료 후, 인증 POST 전 동일 BottomSheet를 연다. 취소·오류에서는 POST하지 않는다.
PREF-001 확정 매번 초기값은 ON + ALL. OFF 전환 시 contentType=ALL, selector 숨김 및 OFF caption.
PREF-002 확정 완료 버튼만 닫을 수 있고 background/back/swipe는 닫지 않는다. 완료 tap은 Sheet close 후 POST.
API-001 확정 요청 본문은 receipt_id, isAdultContentVisible: Boolean, contentType: ALL/MALE/FEMALE. 기존 응답은 Single<ApiResponse<AuthResponse>>이며 success/data/message/errorProperty envelope, AuthResponse.gender: Int만 포함한다.
FLOW-001 확정 일반 7개는 성공 시 제출 설정 저장 후 기존 Splash restart. 실패는 오류 후 동일 선택 Sheet 재오픈.
FLOW-002 확정 오디오 상세는 POST 성공 후 GET /member/info, 서버 isAuth/선호도 저장 후 상세 재조회, Activity restart 없음. GET 실패는 POST 재전송 없이 GET만 재시도.
DATA-001 확정 member response의 nullable 선호도 fallback은 제출 선택값(기술 선택). isAuth 그대로 보존, gender로 contentType 유추 금지.
DATA-002 확정 Sheet 변경만으로 별도 PATCH하지 않는다. 선호도는 POST 성공 후 반영한다.
SCOPE-001 확정 사용자는 아래 7개 legacy caller의 최소 wiring을 허가했다. 공용 legacy 인증 구현 변경은 포함하지 않는다.

8. API 계약 초안

항목 계약
Endpoint POST /auth
인증 기존 Authorization: Bearer token header 사용; token은 문서에 기록하지 않음
요청 receipt_id, isAdultContentVisible: Boolean, contentType: ContentType.name; OFF도 enum 포함
응답 기존 Single<ApiResponse<AuthResponse>>; envelope는 success: Boolean, data: AuthResponse?, message: String?, errorProperty?; AuthResponse는 gender: Int만 포함
후속 조회 오디오 POST 성공 후 GET /member/info; isAuth와 서버 선호도 사용. nullable 선호도는 제출값 fallback(기술 선택)
별도 PATCH Sheet 변경을 위한 PATCH 없음

기존 인증 응답은 성별만 포함하므로 새 v2 adapter는 응답 gender를 로컬 설정에 쓰지 않고 기존 legacy gender-overwrite 흐름도 우회한다. 완료된 POST 뒤 설정을 반영한다.

{
  "receipt_id": "test-receipt",
  "isAdultContentVisible": true,
  "contentType": "ALL"
}

서버 지원은 사용자 확인으로 확정됐으며 실제 서버 요청 검증은 아직 하지 않았다. 실패 응답은 기존 message 또는 common_error_unknown 안내를 사용한다. 요청 중에는 중복 제출을 막고 loading을 표시한다. 오디오 GET-only 재시도에서는 이미 서버에 제출한 설정을 유지하며 재선택·추가 POST를 허용하지 않는다.

9. UI/UX 기대사항

10. 보안 및 데이터 취급

실제 영수증 ID와 인증 token을 log, Toast, 테스트 fixture에 기록하지 않는다. 테스트에는 가짜 영수증만 사용한다. 요청은 기존 인증 API의 인증 경계를 따른다. 로컬 preference는 성공 처리 시점에만 저장하며, 서버 isAuth=false도 그대로 저장한다.

11. 성공 기준

  • 8개 진입점 모두 같은 UI를 거쳐 요청하고, 최초값이 ON/ALL이다.
  • payload의 receipt id, Boolean, enum name 및 요청 순서 테스트가 통과한다.
  • 일반 경로 성공은 Splash를 재시작하고 오디오 상세는 member GET 후 상세를 갱신한다.
  • 실패 후 동일 선택 재오픈, nullable 선호도 fallback 및 isAuth=false 보존이 검증된다.
  • 오디오 GET 재시도는 POST를 재전송하지 않으며 미완료 GET 실패 상태에서 선호도를 commit하지 않는다.

완료 판단 근거는 로컬 자동 테스트와 코드 검토다. 실제 본인인증 서버·기기·시각 QA는 수행하지 않았으며, 기존 Auth launcher의 SDK payload 로그는 이번 변경 범위 밖으로 남긴다.

12. 승인 상태

정책 인터뷰와 최종 사용자 승인이 완료돼 구현을 진행한다. 최소 wiring 권한을 받은 legacy caller 7개는 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이며 legacy 목록에 포함하지 않는다. 모든 Kotlin 파일 경로는 app/src/main/java/kr/co/vividnext/sodalive/ 기준이다.

13. Decision Log

날짜 ID 상태 결정 또는 요구 근거
2026-10-12 DEC-001 확정 공통 UI는 8개 Auth.auth 진입점에서 Bootpay 완료 후 POST 전에 노출, 기본 ON/ALL 사용자 요구
2026-10-12 DEC-002 확정 완료 버튼 후 Sheet를 닫고 인증+선호도 POST, 배경 탭은 닫기 불가 사용자 명시 요구
2026-10-12 DEC-003 확정 일반 7개 경로는 Splash 재시작, 오디오 상세는 POST→member GET→저장→상세 reload, 재시작 없음 사용자 승인 처리 방식
2026-10-12 DEC-004 확정 isAuth 서버 값 보존, 성별 추론 및 별도 PATCH 금지 승인한 로컬 동기화 흐름; nullable fallback은 DEC-010 기술 선택
2026-10-12 DEC-005 확정 OFF 전환 시 contentType=ALL 사용자 확인
2026-10-12 DEC-006 확정 POST 실패 시 오류 후 같은 선택값 Sheet 재오픈; 완료 시 닫은 뒤 요청 사용자 확인
2026-10-12 DEC-007 확정 오디오 member GET 실패는 GET만 재시도하고 POST 재전송/미완료 상태 commit 금지 사용자 확인
2026-10-12 DEC-008 확정 배경/back/swipe 닫기 차단, 완료만 닫기 최초 요청의 '설정 완료 터치시에만 닫힘' 기준
2026-10-12 DEC-009 확정 7개 legacy caller 최소 wiring 허용. V2AccessGuard는 별도 v2 caller 사용자 확인
2026-10-12 DEC-010 기술 선택 오디오 GET nullable 선호도는 제출 선택값으로 fallback; 일반 경로는 POST 성공 후 제출값 저장 기존 MainV2ViewModel 저장 관례 및 사용자 요구 일관성
2026-10-12 DEC-011 확정 이번에는 문서만 작성하고 최종 문서 승인 후 구현 시작 사용자 문서·승인 절차 지시
2026-10-12 DEC-012 확정 문서대로 구현 시작, worktree 없이 현재 브랜치에서 작업 사용자 최종 구현 승인
2026-10-12 DEC-013 확정 디버그는 실제 본인인증과 인증 POST를 생략하지만 설정 완료 후 기존 전송 성공 프로세스를 실행 사용자 후속 요청
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. 추적 및 변경 관리

AUTH-001, PREF-001/002, API-001, FLOW-001/002, DATA-001/002, SCOPE-001은 plan-task.md의 Phase와 회귀 테스트로 추적한다. 인터뷰는 완료됐으며 최종 문서 승인 전 코드를 변경하지 않는다. 요구사항이 바뀌면 Decision Log와 계획을 먼저 갱신한다.

15. 디버그 인증 시뮬레이션 추가

  • DEBUG-001 확정: BuildConfig.DEBUG인 빌드에서 인증 시도 시 실제 Bootpay를 호출하지 않고 짧은 로딩 후 기존 ON/ALL BottomSheet를 연다. 로딩은 테스트용 500ms로 구현한다.
  • DEBUG-002 확정: 설정 완료는 /auth POST 없이 메모리 성공 응답을 기존 ViewModel에 전달한다. 단순 닫기 대신 기존 저장·완료 후처리를 실행한다.
  • DEBUG-003 기존 후처리 유지: 일반 경로는 제출 설정을 로컬에 저장한 뒤 Splash로 재시작한다. 오디오 경로는 실제 회원 GET→서버 인증 상태·설정 저장→상세 갱신을 유지한다. 서버 인증 상태를 임의로 true로 만들지 않는다.
  • DEBUG-004 제약: 서버에는 설정/인증 결과가 저장되지 않는다. 회원 재조회 시 서버 값이 로컬 선택을 덮어쓸 수 있고, 서버의 성인 권한이 생기지 않는다. 이 한계를 사용자에게 구현 전에 안내했다.
  • DEBUG-005 격리: 릴리즈는 기존 실제 본인인증·POST 경로 그대로다. Intent/환경설정으로 시뮬레이션을 켜는 기능은 추가하지 않는다. 테스트는 디버그 경로와 실제 경로를 각각 검증한다.

구현 완료: 운영 변경은 V2AuthFlow.kt의 진입·API 선택에 한정했고 기존 성공 처리 로직을 재사용했다. 전체 debug 로컬 테스트 1,544개/빌드/ktlint 통과, Phase3 리뷰 APPROVE. release Kotlin 컴파일은 기존 서명 설정 누락으로 미검증이며 실제 릴리즈 실행을 확인한 것으로 간주하지 않는다.

16. 인증 전환 후 미사용 경로 제거 (구현 승인됨)

2026-10-13 승인 갱신 DEC-016: 사용자의 "승인"으로 CLEANUP-001~003 및 최소 레거시 제거 예외가 확정됐다. 앞선 문서 작성 전용 기록은 당시 이력이며, 현재는 승인된 Phase 4를 실행한다. 빌드 설정 변경은 별도 승인 대상이다.

배경과 확인 범위

마이 탭 진입 시 MyPageViewModel → AuthRepository → AuthApi 생성 과정에서 ClassCastException이 보고됐다. 실제 인증 진입점은 V2AuthFlow로 전환됐지만 두 기존 ViewModel의 미사용 authVerify()와 생성자 의존성, Koin 등록이 남아 있다. 로컬 release usage.txt에서 기존 인증 메서드 제거를 확인했고, DEX에서 AuthApi 생성 결과가 null이 아니면 ClassCastException을 던지는 R8 생성 코드를 확인했다. 해당 산출물과 오류가 발생한 설치본의 동일성 및 기기 재현은 미확인이다.

후속 요구사항

ID 상태 요구사항 및 수용 기준 추적
CLEANUP-001 확정 MyPageViewModel, AudioContentDetailViewModel의 미사용 authVerify()와 AuthRepository 생성자 의존성을 제거하고 AppDI의 두 ViewModel 생성 인자 및 기존 인증 API/repository 등록을 함께 정리한다 P4-T1
CLEANUP-002 확정 참조 재확인 후 전용 AuthApi.kt, AuthRepository.kt, AuthVerifyRequest.kt를 삭제한다. V2 및 기존 테스트가 사용하는 AuthResponse.kt는 위치·계약 그대로 유지한다 P4-T1
CLEANUP-003 확정 기존 8개 인증 진입점, V2 요청/응답, 일반·오디오 후처리 및 디버그 시뮬레이션은 변경하지 않는다. keep 규칙 추가나 R8 비활성화로 우회하지 않는다 P4-GATE

승인 및 완료 기준

  • 최초 허용 범위는 두 문서 갱신뿐이었다. Phase 1~3의 기존 승인·완료 상태와 별개로 DEC-016에서 후속 레거시 제거 승인을 받았다.
  • 사용자가 이 후속 범위의 구현을 승인한 뒤에만 §4의 레거시 변경 제외에 대한 최소 예외로 적용한다. Auth.kt, 공유 AuthResponse, 화면·인증 정책 변경과 무관한 정리는 제외한다.
  • 완료 증거는 미사용 경로 제거 회귀 테스트, 기존 V2 인증·DTO·오디오 라우팅 테스트, debug 빌드 및 최적화된 release 재빌드 산출물 확인이다. debug 테스트만으로 release 오류 해결을 확정하지 않는다.
  • release 빌드가 서명 등 환경 문제로 차단되면 해당 검증을 [blocked]로 남기고 설정을 임의로 우회하지 않는다. 기존 산출물 확인을 수정 후 재빌드 성공으로 대체하지 않는다.

승인 후 실행 상태 (2026-10-13)

CLEANUP-001/002의 코드 제거와 공유 응답 보존을 반영했다. CLEANUP-003의 기존 동작 회귀를 포함한 전체 로컬 테스트 1,551개 및 debug 빌드가 통과했고 debug DEX에서 기존 인증 타입 참조 부재를 확인했다. release 빌드는 서명 설정 누락으로 차단됐으며 최적화 비활성화 경고도 있어 Phase 4 전체 완료를 선언하지 않는다. ktlint는 이번 변경과 무관한 기존 ChatRepositoryTest.kt 줄바꿈 오류 6건으로 실패했다. 세부 증거와 재개 조건은 계획의 P4-GATE 기록을 따른다.

사용자 확인 후 종료 상태 (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 리뷰를 참조한다.

실기기 전환 후속 수정 (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·실서버 인증은 이번 실기기 검증 범위 밖이다. 원래 반복 애니메이션이 발생한 시스템 내부 원인을 캐시 오류로 확정하지는 않는다.