fix(live): 라이브룸 전역 표시를 보정한다

docs/20260714_라이브룸_전역_표시와_키보드_레이아웃_수정/prd.md

@@ -0,0 +1,74 @@
+# PRD: 라이브룸 전역 표시와 키보드 레이아웃 수정
+
+## 1. Overview
+
+라이브룸 표시 계층을 메인 페이지 내부에서 앱 최상위 계층으로 옮겨 현재 화면과 무관하게 입장 결과가 보이도록 하고, 라이브 채팅 키보드 표시 시 중복 레이아웃 이동을 제거한다.
+
+## 2. Problem
+
+- `LiveViewModel.enterRoom(roomId:)` 성공 후 `AppState.shared.isShowPlayer`가 `true`가 되어도 `LiveRoomViewV2`는 `MainView` 내부에만 배치되어 있다.
+- 크리에이터 채널과 라이브 생성 화면은 `ContentView`의 `NavigationStack` destination으로 메인 페이지 위에 표시되므로, 라이브룸 상태가 활성화되어도 현재 destination보다 아래에서 렌더링될 수 있다.
+- `LiveRoomViewV2`는 채팅 키보드 높이만큼 콘텐츠를 수동으로 올리지만, 화면 캡처 보호용 `ScreenCaptureSecureContainer`가 SwiftUI와 내부 `UIHostingController` 사이에 경계를 만든다.
+- 바깥 SwiftUI 계층의 키보드 safe area만 무시해도 내부 `UIHostingController`의 기본 `safeAreaRegions == .all`에 키보드 영역이 남는다. 내부 콘텐츠가 자동으로 줄어든 뒤 수동 offset까지 적용되어 키보드 위에 불필요한 빈 공간이 생긴다.
+- `ScreenCaptureSecureContainer` 자체가 일반 container safe area 안에 배치되면 내부 배경의 `edgesIgnoringSafeArea`가 UIKit 컨테이너 경계를 넘어갈 수 없어 라이브룸이 화면 전체를 덮지 못한다.
+
+## 3. Goals
+
+- 어떤 `NavigationStack` destination이 표시 중이어도 라이브룸 입장 성공 시 `LiveRoomViewV2`가 앱 화면 최상위에 표시된다.
+- 라이브룸의 보안 컨테이너와 배경이 상단 및 하단 safe area를 포함한 화면 전체를 덮는다.
+- 크리에이터 채널에서 즉시 시작 라이브를 생성하면 `enterRoom` 성공 직후 라이브룸이 보인다.
+- 라이브룸 표시 계층 변경 후에도 라이브 중 푸시/딥링크 외부 이동 확인 다이얼로그가 라이브룸 위에 표시된다.
+- 채팅 키보드가 표시될 때 입력창은 키보드 바로 위에 위치하고, 키보드 높이만큼의 중복 빈 공간이 생기지 않는다.
+- 기존 입장 API, Agora 초기화/종료, 채팅 전송, 캡처 보호 동작을 유지한다.
+
+## 4. Non-Goals
+
+- `enterRoom`, `getRoomDetail`, 결제 또는 비밀번호 확인 API 흐름을 변경하지 않는다.
+- 라이브 생성 후 메인/홈/라이브 데이터 갱신 정책을 변경하지 않는다.
+- 라이브룸 UI 디자인이나 채팅 컴포넌트 모양을 변경하지 않는다.
+- 키보드 처리 공통 모듈 전체를 리팩터링하지 않는다.
+- `Pods/**`, `generated/**`, `build/**`를 수정하지 않는다.
+
+## 5. Core Requirements
+
+### 5.1 라이브룸 전역 표시
+
+- `LiveRoomViewV2`의 단일 표시 지점을 `MainView` 내부가 아닌 `ContentView`의 `NavigationStack` 최상위 overlay로 이동한다.
+- 표시 조건은 기존과 동일하게 `AppState.shared.isShowPlayer`를 사용한다.
+- `LiveRoomViewV2`를 중복 생성하지 않는다.
+- `LiveViewModel.enterRoom(roomId:)`의 성공 처리와 `AppState.shared.roomId` 설정은 변경하지 않는다.
+
+### 5.2 외부 이동 확인 보존
+
+- 라이브 중 푸시/딥링크 이동 요청의 pending action을 앱 최상위 계층에서 접근 가능한 상태로 관리한다.
+- 확인 다이얼로그는 전역 라이브룸보다 위에 표시한다.
+- 확인 시 기존과 같이 `.requestLiveRoomQuitForExternalNavigation` 알림으로 라이브 종료를 요청하고, `isShowPlayer == false`가 된 뒤 pending action을 실행한다.
+- 취소 시 pending action과 cancel action을 정리하고 라이브룸을 유지한다.
+
+### 5.3 키보드 레이아웃
+
+- 기존 수동 `appliedKeyboardHeight` offset 동작은 유지한다.
+- `ScreenCaptureSecureContainer`는 화면 전체 크기로 확장하고 바깥 SwiftUI 계층의 safe area를 무시한다.
+- 내부 `UIHostingController.safeAreaRegions`는 `.container`로 제한해 일반 화면 safe area는 전달하되 키보드 safe area는 전달하지 않는다.
+- 시스템 키보드 회피와 수동 offset이 동시에 적용되지 않도록 한다.
+- 캡처 보호 활성/비활성 상태 모두 같은 키보드 레이아웃 규칙을 사용한다.
+
+## 6. Technical Constraints
+
+- 변경은 기존 파일인 `SodaLive/Sources/ContentView.swift`, `SodaLive/Sources/V2/Main/MainView.swift`, `SodaLive/Sources/App/AppState.swift`, `SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`에 한정한다.
+- 기존 `SodaV2ActionModal`과 외부 이동 확인 문구를 재사용한다.
+- 신규 사용자 노출 문자열이나 신규 API를 추가하지 않는다.
+- 자동화 테스트 번들 타깃이 없는 현재 프로젝트 구성에서는 정적 검색과 `SodaLive-dev` Debug 빌드로 자동 검증하고, 실제 키보드 높이는 수동 QA 항목으로 남긴다.
+
+## 7. Success Criteria
+
+- 크리에이터 채널에서 즉시 라이브 생성 후 라이브룸이 현재 destination 위에 표시된다.
+- 홈, 라이브, 크리에이터 채널 등 진입 화면과 무관하게 `isShowPlayer == true`이면 전역 라이브룸이 한 번만 표시된다.
+- 라이브룸 배경이 상태 표시줄과 홈 인디케이터 영역을 포함한 화면 전체를 덮는다.
+- 라이브 중 외부 이동 요청 시 확인 다이얼로그가 라이브룸 위에 표시되고 확인/취소가 기존 의미대로 동작한다.
+- 채팅 입력 포커스 시 화면 이동량이 키보드 회피와 중복되지 않으며 입력창 아래에 큰 빈 공간이 생기지 않는다.
+- `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`가 성공한다.
+
+## 8. Open Questions
+
+- 해당 없음.