# 20260327 캐릭터 리스트 콘텐츠 설정 이동 안내 표시 개선

## 개요
- 채팅 캐릭터 리스트에서 `isAdultContentVisible == false`로 인해 콘텐츠 보기 설정으로 이동할 때 안내 토스트/팝업이 사용자에게 보이지 않는 문제를 수정한다.
- 이동 시점과 안내 표시 시점을 조정해 사용자가 안내 문구를 실제로 확인할 수 있도록 한다.

## 요구사항 요약
- 대상 흐름: 캐릭터 리스트 상세 진입 가드에서 non-KR + 민감 콘텐츠 OFF 분기
- 문제: 현재는 현재 화면에 토스트를 띄우고 곧바로 화면 전환되어 안내가 체감되지 않음
- 목표: 콘텐츠 보기 설정 화면 전환 후에도 안내 메시지가 사용자에게 명확히 보이도록 처리

## 완료 기준 (Acceptance Criteria)
- [x] AC1: non-KR + 민감 콘텐츠 OFF 분기에서 콘텐츠 설정으로 이동 동작은 유지된다.
- [x] AC2: 안내 메시지가 실제로 보이는 시점으로 표시 로직이 조정된다.
- [x] AC3: KR 인증 분기/기존 인증 플로우에는 영향이 없다.
- [x] AC4: 관련 화면에서 빌드/진단 결과가 문서에 기록된다.

## 구현 체크리스트
- [x] 팝업 렌더링 위치/생명주기 확인
- [x] 기존 이동 + 메시지 설정 순서의 문제 원인 확정
- [x] 최소 수정으로 안내 메시지 표시 시점 조정
- [x] 수정 파일 진단 및 워크스페이스 빌드/테스트 실행
- [x] 검증 결과 문서화

## 검증 계획
- [x] 정적 진단: 수정 파일 `lsp_diagnostics`
- [x] 빌드:
  - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" -configuration Debug build`
  - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`
- [x] 테스트 시도:
  - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" test`
  - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" test`

## 검증 기록
- 일시: 2026-03-27
  - 무엇: 캐릭터 리스트 콘텐츠 설정 이동 시 안내 표시 개선 작업 계획 문서 작성
  - 왜: 구현 전 변경 범위/완료 기준/검증 절차를 고정해 요청사항을 정확히 반영하기 위함
  - 어떻게: docs 규칙에 맞춰 요구사항/체크리스트/검증계획을 정리
  - 실행 명령/도구: `apply_patch(문서 생성)`
  - 결과: 구현 계획 문서 생성 완료

- 일시: 2026-03-27
  - 무엇: 채팅 캐릭터 리스트의 non-KR + 민감 콘텐츠 OFF 분기에서 콘텐츠 설정 이동 안내 표시 시점 조정
  - 왜: 토스트를 먼저 띄우고 즉시 화면 전환하면 사용자가 안내 메시지를 보기 어려워 UX가 손실되기 때문
  - 어떻게:
    - analyze-mode 요구에 맞춰 병렬 탐색 수행
      - explore: `Trace error popup lifecycle`, `Find message-after-navigation patterns`
      - direct: `grep/ast-grep/lsp_symbols`로 `AppState.errorMessage`, `isShowErrorPopup`, `.contentViewSettings`, `sodaToast` 렌더링 위치 확인
    - `ChatTabView`에서 non-KR 분기를 `if !isKoreanCountry && !UserDefaults.isAdultContentVisible()`로 유지
    - 기존의 “토스트 세팅 후 즉시 이동” 대신 `moveToContentSettingsWithGuideToast()`로
      - 먼저 `.contentViewSettings`로 이동
      - `DispatchQueue.main.asyncAfter(0.2)` 후 안내 토스트 표시
    - scope 최소화를 위해 요청 대상인 채팅 캐릭터 리스트 경로(`ChatTabView`)만 수정
  - 실행 명령/도구:
    - `lsp_diagnostics("SodaLive/Sources/Chat/ChatTabView.swift")`
    - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" -configuration Debug build`
    - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`
    - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" test`
    - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" test`
  - 결과:
    - 두 스킴 Debug 빌드 모두 `BUILD SUCCEEDED`
    - 테스트는 두 스킴 모두 `Scheme ... is not currently configured for the test action`으로 실행 불가(테스트 액션 미구성)
    - `lsp_diagnostics`는 SourceKit 환경에서 `No such module 'Bootpay'`를 보고했으나, 실제 빌드 통과로 컴파일 정상 확인
    - 수동 QA는 CLI 환경 제약으로 미실행(실기기/시뮬레이터에서 non-KR + 민감 콘텐츠 OFF 시 콘텐츠 설정 화면에서 안내 토스트 노출 확인 필요)

- 일시: 2026-03-27
  - 무엇: 재현 보고(토스트 미노출) 기반 2차 수정 — 콘텐츠 설정 화면에서 안내 토스트를 직접 소비하도록 변경
  - 왜: 기존 방식은 전환 타이밍/전역 토스트 상태 의존으로 인해 사용자 환경에서 안내가 보이지 않는 케이스가 재현되었기 때문
  - 어떻게:
    - 원인 확인: `ContentSettingsView`는 로컬 토스트(`viewModel.isShowPopup`)만 표시하고, 캐릭터 리스트 경로는 `AppState` 전역 토스트 상태 타이밍에 의존
    - `AppState`에 일회성 전달 상태 추가
      - `pendingContentSettingsGuideMessage`
      - `setPendingContentSettingsGuideMessage(_:)`
      - `consumePendingContentSettingsGuideMessage()`
    - `ChatTabView.moveToContentSettingsWithGuideToast()`에서 전역 토스트 토글 대신
      - 안내 문구를 pending 상태로 저장
      - `.contentViewSettings` 이동만 수행
    - `ContentSettingsView.onAppear`에서 pending 문구를 consume하여
      - `viewModel.errorMessage` 설정
      - `viewModel.isShowPopup = true`로 로컬 토스트 즉시 노출
    - analyze-mode 병렬 탐색 결과(`Trace content settings toast suppression`, `Find reliable post-redirect notice patterns`)를 반영해 최소 변경으로 해결
  - 실행 명령/도구:
    - `lsp_diagnostics("SodaLive/Sources/App/AppState.swift")`
    - `lsp_diagnostics("SodaLive/Sources/Chat/ChatTabView.swift")`
    - `lsp_diagnostics("SodaLive/Sources/Settings/Content/ContentSettingsView.swift")`
    - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" -configuration Debug build`
    - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`
    - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" test`
    - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" test`
  - 결과:
    - 두 스킴 Debug 빌드 모두 `BUILD SUCCEEDED`
    - 테스트는 두 스킴 모두 `Scheme ... is not currently configured for the test action`으로 실행 불가(테스트 액션 미구성)
    - `lsp_diagnostics`는 SourceKit 환경 한계로 모듈/스코프 미해결 오류를 보고했으나 실제 빌드는 통과
    - 수동 QA는 CLI 환경 제약으로 미실행(실기기/시뮬레이터에서 non-KR + 민감 콘텐츠 OFF → 캐릭터 탭 → 콘텐츠 설정 진입 직후 안내 토스트 노출 확인 필요)