# 라이브룸 전역 표시와 키보드 레이아웃 수정 계획

## 기준 문서

- PRD: `docs/20260714_라이브룸_전역_표시와_키보드_레이아웃_수정/prd.md`
- 코드 스타일: `docs/agent-guides/code-style.md`
- 빌드/검증: `docs/agent-guides/build-test-verification.md`
- 기존 외부 이동 확인 기록: `docs/plan-task/20260306_라이브룸외부이동확인다이얼로그.md`

## 구현 원칙

- `enterRoom`의 API 요청·응답 처리는 유지하고, 전역 overlay와 충돌하는 navigation side effect만 분리한다.
- 전역 라이브룸은 한 곳에서만 생성한다.
- 표시 계층 이동으로 가려질 수 있는 기존 외부 이동 확인 다이얼로그도 같은 최상위 계층으로 옮긴다.
- 키보드 처리 방식은 새로 만들지 않고, 현재 수동 offset과 충돌하는 safe area 적용 위치만 바로잡는다.

### Phase 1: 라이브룸 전역 표시

- [x] **Task 1.1: 라이브룸 표시 지점을 앱 최상위로 이동**
  - 대상 파일:
    - 수정: `SodaLive/Sources/ContentView.swift`
    - 수정: `SodaLive/Sources/V2/Main/MainView.swift`
  - 작업 내용:
    - `ContentView`의 `NavigationStack` 최상위에 전역 `ZStack` overlay를 구성한다.
    - `AppState.shared.isShowPlayer`가 `true`이면 `NavigationStack` 위에 `LiveRoomViewV2`를 표시한다.
    - `MainView` 내부의 기존 `LiveRoomViewV2` 표시 분기를 제거해 중복 생성을 방지한다.
  - 검증 기준:
    - 실행 명령: `rg -n "LiveRoomViewV2\\(" SodaLive/Sources/ContentView.swift SodaLive/Sources/V2/Main/MainView.swift`
    - 기대 결과: 실제 표시 지점은 `ContentView` 한 곳에서만 확인된다.

- [x] **Task 1.2: 외부 이동 확인 상태와 다이얼로그를 전역 계층으로 이동**
  - 대상 파일:
    - 수정: `SodaLive/Sources/App/AppState.swift`
    - 수정: `SodaLive/Sources/ContentView.swift`
    - 수정: `SodaLive/Sources/V2/Main/MainView.swift`
  - 작업 내용:
    - pending navigation action과 cancel action, 다이얼로그 표시 상태를 `AppState`에서 관리한다.
    - `MainView`의 외부 이동 요청은 `AppState`에 위임한다.
    - `ContentView`에서 기존 문구와 `SodaV2ActionModal`을 사용해 라이브룸 위에 확인 다이얼로그를 표시한다.
    - 라이브 종료 후 pending action 실행 및 취소 시 상태 정리 의미를 유지한다.
  - 검증 기준:
    - 실행 명령: `rg -n "isShowLeaveLiveNavigationDialog|requestExternalNavigation|confirmExternalNavigation|cancelExternalNavigation|requestLiveRoomQuitForExternalNavigation" SodaLive/Sources/App/AppState.swift SodaLive/Sources/ContentView.swift SodaLive/Sources/V2/Main/MainView.swift`
    - 기대 결과: 상태/처리는 `AppState`, 표시는 `ContentView`, 요청 위임은 `MainView`에서 확인된다.

### Phase 2: 라이브 채팅 키보드 레이아웃 수정

- [x] **Task 2.1: 키보드 safe area 무시 위치 보정 (초기 보정, Phase 4에서 대체)**
  - 대상 파일:
    - 수정: `SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`
  - 작업 내용:
    - 내부 hosted content에 적용된 `.ignoresSafeArea(.keyboard)`를 제거한다.
    - `ScreenCaptureSecureContainer` 바깥에 `.ignoresSafeArea(.keyboard)`를 적용한다.
    - 기존 `appliedKeyboardHeight`와 채팅 입력 offset은 유지한다.
  - 검증 기준:
    - 실행 명령: `rg -n "ScreenCaptureSecureContainer|ignoresSafeArea\\(\\.keyboard\\)|offset\\(y: -appliedKeyboardHeight\\)" SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`
    - 기대 결과: outer container가 키보드 safe area를 무시하고 수동 offset은 한 번만 적용된다.

### Phase 3: 검증

- [x] **Task 3.1: 변경 범위 및 정적 검증**
  - 대상 파일:
    - 확인: `SodaLive/Sources/ContentView.swift`
    - 확인: `SodaLive/Sources/V2/Main/MainView.swift`
    - 확인: `SodaLive/Sources/App/AppState.swift`
    - 확인: `SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`
  - 작업 내용:
    - 라이브룸 단일 표시, 외부 이동 확인 흐름, 키보드 modifier 위치를 검색한다.
    - `git diff --check`로 whitespace 오류를 확인한다.
  - 검증 기준:
    - 기대 결과: PRD 범위를 벗어난 소스 변경이 없고 정적 검사 오류가 없다.

- [x] **Task 3.2: Debug 빌드 검증**
  - 대상 파일:
    - 확인: `SodaLive.xcworkspace`
  - 작업 내용:
    - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`를 실행한다.
  - 검증 기준:
    - 기대 결과: `** BUILD SUCCEEDED **`.

- [ ] **Task 3.3: 수동 동작 검증**
  - 대상 화면:
    - 크리에이터 채널의 즉시 라이브 생성 화면
    - 라이브룸 채팅 화면
    - 라이브 중 푸시/딥링크 외부 이동 확인 화면
  - 작업 내용:
    - 즉시 라이브 생성 후 현재 화면 위에 라이브룸이 보이는지 확인한다.
    - 키보드 표시 시 입력창이 키보드 바로 위에 있고 큰 빈 공간이 없는지 확인한다.
    - 외부 이동 확인/취소 흐름을 확인한다.
  - 검증 기준:
    - 기대 결과: PRD Success Criteria를 충족한다.

### Phase 4: 사용자 재검증 후 보정

- [x] **Task 4.1: 보안 컨테이너를 화면 전체로 확장**
  - 대상 파일:
    - 수정: `SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`
  - 작업 내용:
    - `ScreenCaptureSecureContainer`에 무한 최대 frame을 부여한다.
    - 컨테이너 바깥에서 모든 safe area를 무시해 UIKit 컨테이너 경계가 전체 화면을 차지하도록 한다.
  - 검증 기준:
    - 라이브룸 배경이 상태 표시줄과 홈 인디케이터 영역까지 덮는다.

- [x] **Task 4.2: 내부 UIHostingController의 키보드 자동 회피 제거**
  - 대상 파일:
    - 수정: `SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`
  - 작업 내용:
    - `UIHostingController.safeAreaRegions`를 `.container`로 제한한다.
    - 일반 container safe area는 내부 UI에 유지하고 keyboard safe area만 제외한다.
    - 기존 `appliedKeyboardHeight` offset은 유지한다.
  - 검증 기준:
    - 키보드 표시 시 내부 호스팅 크기 축소와 수동 offset이 중복되지 않는다.

### Phase 5: 재검증

- [x] **Task 5.1: 정적 검사 및 Debug 빌드**
  - 대상 파일:
    - 확인: `SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`
  - 검증 기준:
    - `git diff --check`가 성공한다.
    - `SodaLive-dev` Debug 빌드가 `** BUILD SUCCEEDED **`로 완료된다.

- [ ] **Task 5.2: 수정본 수동 동작 검증**
  - 대상 화면:
    - 전역 라이브룸 화면
    - 라이브룸 채팅 입력 화면
  - 검증 기준:
    - 라이브룸이 화면 전체를 덮는다.
    - 키보드 표시 시 입력창이 키보드 바로 위에 위치하고 큰 빈 공간이 없다.

### Phase 6: 라이브 종료 후 입장 전 화면 복원

- [x] **Task 6.1: 공용 입장 성공 처리에서 navigation 초기화 제거**
  - 대상 파일:
    - 수정: `SodaLive/Sources/Live/LiveViewModel.swift`
    - 수정: `SodaLive/Sources/Explorer/Profile/UserProfileViewModel.swift`
  - 작업 내용:
    - 입장 성공 시 `roomId`와 `isShowPlayer`만 갱신한다.
    - 공용 `enterRoom` 내부의 `setAppStep(.main)` 호출을 제거한다.
  - 검증 기준:
    - 앱 내부 진입점이 현재 navigation path를 유지한 채 전역 라이브룸을 표시한다.

- [x] **Task 6.2: 콜드 스타트 라이브 푸시의 메인 전환 명시**
  - 대상 파일:
    - 수정: `SodaLive/Sources/Splash/SplashView.swift`
  - 작업 내용:
    - 스플래시에서 `pushRoomId`를 로컬 값으로 소비한다.
    - `.main`을 설정한 뒤 소비한 room ID로 입장을 진행한다.
  - 검증 기준:
    - 기존 콜드 스타트 푸시가 스플래시에 머물지 않고 메인 위 라이브룸으로 진입한다.

- [x] **Task 6.3: 정적 검사 및 Debug 빌드**
  - 대상 파일:
    - 확인: `SodaLive/Sources/Live/LiveViewModel.swift`
    - 확인: `SodaLive/Sources/Explorer/Profile/UserProfileViewModel.swift`
    - 확인: `SodaLive/Sources/Splash/SplashView.swift`
  - 검증 기준:
    - `git diff --check`가 성공한다.
    - `SodaLive-dev` Debug 빌드가 `** BUILD SUCCEEDED **`로 완료된다.

- [ ] **Task 6.4: 진입점별 수동 복귀 검증**
  - 대상 화면:
    - 홈/라이브 탭, 라이브 상세, 크리에이터 채널, 프로필
    - 콜드 스타트 및 포그라운드 라이브 푸시
  - 검증 기준:
    - 일반 입장은 종료 후 입장 직전 화면을 표시한다.
    - 푸시 입장은 호출부에 정의된 navigation 정책을 유지한다.

## 검증 기록

- 2026-07-14: 코드 조사 결과 `LiveRoomViewV2`가 `MainView` 내부에 있어 navigation destination보다 아래에 놓이는 표시 계층 문제와, `ScreenCaptureSecureContainer` 바깥의 시스템 키보드 회피 및 내부 수동 offset이 중복될 수 있는 구조를 확인했다. 구현 및 빌드 검증은 아직 수행하지 않았다.
- 2026-07-14: `LiveRoomViewV2` 표시를 `ContentView`의 `NavigationStack` overlay로 옮기고, 외부 이동 확인 상태와 다이얼로그도 같은 전역 계층으로 이동했다. `MainView`에서는 전역 상태에 요청만 위임하도록 정리했다.
- 2026-07-14: `.ignoresSafeArea(.keyboard)`를 내부 hosted content에서 `ScreenCaptureSecureContainer` 바깥으로 이동해 시스템 키보드 회피와 기존 수동 offset이 중복되지 않도록 했다.
- 2026-07-14: `rg`로 라이브룸 단일 표시 지점, 외부 이동 확인 흐름, 키보드 modifier 위치를 확인했고 `git diff --check`가 오류 없이 완료됐다.
- 2026-07-14: sandbox 환경의 CoreSimulator/XPC 접근 제한으로 최초 빌드가 소스 컴파일 전에 중단됐다. 동일 명령을 허용된 환경에서 `-derivedDataPath /tmp/SodaLiveDerivedData`와 함께 다시 실행했으며, 전체 빌드와 최종 변경 후 증분 빌드 모두 `** BUILD SUCCEEDED **`를 확인했다.
- 2026-07-14: Task 3.3의 실제 즉시 라이브 생성, 채팅 키보드, 라이브 중 외부 이동 확인/취소는 기기 또는 시뮬레이터 수동 QA가 필요해 미실행 상태로 남겼다.
- 2026-07-14: 사용자 재검증에서 라이브룸이 화면 전체를 덮지 않고 키보드 위 빈 공간도 남는 것을 확인했다. 바깥 `ScreenCaptureSecureContainer`와 내부 `UIHostingController`가 별도의 safe area 경계를 가지므로 바깥 modifier 이동만으로는 부족했다.
- 2026-07-14: `ScreenCaptureSecureContainer`를 전체 화면 frame으로 확장하고 모든 바깥 safe area를 무시하도록 보정했다. 내부 `UIHostingController.safeAreaRegions`는 `.container`로 제한해 상태 표시줄/홈 인디케이터 safe area는 유지하면서 키보드 자동 회피만 제외했다.
- 2026-07-14: 보정 후 `git diff --check`가 성공했고, `xcodebuild -workspace SodaLive.xcworkspace -scheme SodaLive-dev -configuration Debug -derivedDataPath /tmp/SodaLiveDerivedData build`에서 `** BUILD SUCCEEDED **`를 확인했다. Task 5.2의 실제 화면 확인은 사용자 수동 재검증이 필요하다.
- 2026-07-14: 사용자 재검증에서 크리에이터 채널로 입장한 라이브 종료 후 메인이 표시되는 문제를 확인했다. 종료 처리가 이동한 것이 아니라 공용 `enterRoom`의 `setAppStep(.main)`이 입장 시 navigation path를 미리 삭제한 것이 원인이었다.
- 2026-07-14: 일반 입장은 현재 화면을 보존하도록 공용 입장 구현 두 곳에서 navigation 초기화를 제거했다. 2025년 콜드 스타트 라이브 푸시 보정의 의도는 `SplashView`에서 `pushRoomId` 소비와 `.main` 전환을 명시하는 방식으로 유지했다.
- 2026-07-14: 변경 후 `git diff --check`가 성공했고, `xcodebuild -workspace SodaLive.xcworkspace -scheme SodaLive-dev -configuration Debug -derivedDataPath /tmp/SodaLiveDerivedData build`에서 `** BUILD SUCCEEDED **`를 확인했다. Task 6.4의 진입점별 종료 복귀와 푸시 진입은 실제 앱 수동 검증이 필요하다.