sodalive-ios/docs/20260914_크리에이터_DM_리스너_선택/plan-task.md

# 크리에이터 DM 리스너 선택 Goal 실행형 구현 계획

| 문서 항목 | 내용 |
|---|---|
| 상태 | 구현 검증 중 |
| 작성일 | `2026-09-14` |
| 요구사항 기준 | `docs/20260914_크리에이터_DM_리스너_선택/prd.md` |
| API 기준 | `docs/20260914_크리에이터_DM_리스너_선택/prd.md` §11 |
| 현재 Phase | Phase 3 검증 |
| 현재 활성 Goal | `P3-GATE` |

## 목표

크리에이터가 메인 대화 탭에서 팔로우 리스트 또는 닉네임 검색으로 리스너를 선택하고 기존 유저-크리에이터 DM 방 생성 API로 DM 방을 시작한다.

## 현재 상태

| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 |
|---:|---|---:|---|---|
| 1 | 완료 | `2/2` | 없음 | 없음 |
| 2 | 완료 | `5/5` | 없음 | 수동 네트워크 QA 필요 |
| 3 | 진행 중 | `0/1` | `P3-GATE` | 수동 QA 미수행 |

## 범위

### 포함

- 메인 대화 탭 우측 하단 크리에이터 전용 `+` 플로팅 버튼.
- 신규 리스너 선택 화면과 라우팅.
- 기존 팔로우 전체 리스트 API 재사용.
- `GET /member/search?nickname=` 2글자 이상, 500ms debounce 검색.
- 검색 empty 문구 다국어 처리.
- `SodaV2ActionModal` 기반 확인 팝업.
- 기존 DM 방 생성 API의 request model 확장과 `recipientId` 기반 호출.
- 성공 시 `AppStep.userCreatorChatRoom(roomId:)` 진입.

### 제외

- 채팅방 메시지 UI와 WebSocket 전송 로직 변경.
- 새 공통 모달 컴포넌트 작성.
- 신규 dependency 추가.
- 팔로우 전체 리스트 API 서버 계약 변경.

## 기술적 제약

- 기술 스택: SwiftUI, Combine, Moya, 기존 `AppState`/`AppStep` 라우팅.
- UI 배치: Figma `2372:23496`, 팝업 `2372:23521` 기준.
- 공통 컴포넌트: `SodaV2ActionModal`, 기존 색상·폰트·spacing token 재사용.
- API 재사용: `FollowCreatorRepository`, `UserRepository.searchUser`, `UserCreatorChatRepository` 기준.
- request model: `UserCreatorCreateRoomRequest`는 `recipientId`와 `creatorId`를 optional로 표현할 수 있어야 한다.
- 검증: 테스트 번들 타깃이 확인되지 않으므로 focused 자동 테스트 대신 빌드와 수동 QA 기준을 명시한다.

## Task TDD 작성 규칙

현재 저장소는 `docs/agent-guides/build-test-verification.md` 기준 테스트 번들 타깃이 확인되지 않는다. 구현 Task는 가능한 경우 작은 ViewModel 단위 테스트를 우선 검토하되, 테스트 타깃이 없으면 `TDD 예외 사유`와 `대체 검증 방법`을 Task에 기록한다.

## Phase 1 — 라우팅과 진입점

**Phase 결과:** 크리에이터가 메인 대화 탭에서 신규 리스너 선택 화면에 진입할 수 있다.

**선행조건:** PRD 확정.

**Phase 완료 조건:** `P1-T1`, `P1-T2` 완료와 빌드 통과.

### 구현 항목

#### Task 1.1 메인 대화 탭 플로팅 버튼

**Goal 실행 `P1-T1`:** 크리에이터 계정의 메인 대화 탭 우측 하단에 신규 DM 시작 `+` 버튼을 표시한다.

- **시작 조건:** `CDM-ENTRY-001`, `CDM-ENTRY-002` 확정.
- **완료 증거:** 크리에이터 role에서만 버튼 표시, 비크리에이터에서는 미표시.
- **범위 밖:** 새 화면 내부 리스트와 API 호출.
- **TDD 예외 사유:** UI 조건 렌더링 작업이며 현재 테스트 타깃이 확인되지 않는다.
- **대체 검증 방법:** `UserDefaults.role`이 `MemberRole.CREATOR.rawValue`일 때와 아닐 때의 수동 QA, Debug 빌드.

**Files:**

- Modify: `SodaLive/Sources/V2/Main/MainView.swift`
- Reuse: `SodaLive/Sources/V2/CreatorChannel/Components/CreatorChannelFloatingIconButton.swift` 또는 기존 홈 플로팅 버튼 컴포넌트

**Interfaces:**

- Consumes: `MemberRole.CREATOR.rawValue`, `MainTab.chat`
- Produces: `MainView` 채팅 탭 overlay에서 신규 DM 시작 액션

- [x] 버튼 재사용 후보를 확인하고 새 공통 abstraction 없이 가장 가까운 기존 플로팅 버튼을 사용한다.
- [x] 기존 `MainChatView` 수정 없이 `MainView` overlay에서 버튼을 표시한다.
- [x] `MainView`에서 현재 탭이 `.chat`이고 role이 creator일 때만 버튼을 표시한다.
- [x] 버튼 bottom padding은 main tab bar와 mini player가 가리지 않도록 기존 `creatorActionMenuBottomPadding` 계산 방식을 따른다.
- [x] `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`를 실행해 성공을 확인한다.

#### Task 1.2 AppStep 라우팅 추가

**Goal 실행 `P1-T2`:** 신규 리스너 선택 화면으로 이동할 수 있는 AppStep 라우팅을 추가한다.

- **시작 조건:** `P1-T1` 완료.
- **완료 증거:** `+` 버튼 탭 시 신규 화면이 push되고 뒤로가기로 복귀 가능.
- **범위 밖:** 화면 내부 API 연동.
- **TDD 예외 사유:** 라우팅 연결 작업이며 현재 테스트 타깃이 확인되지 않는다.
- **대체 검증 방법:** 수동 내비게이션 QA와 Debug 빌드.

**Files:**

- Modify: `SodaLive/Sources/App/AppStep.swift`
- Modify: `SodaLive/Sources/ContentView.swift`
- Modify: `SodaLive/Sources/V2/Main/Chat/UserCreatorChat/UserCreatorChatRoomView.swift`

**Interfaces:**

- Produces: `AppStep.userCreatorChatRecipientSearch`
- Consumes: `AppState.shared.setAppStep(step:)`

- [x] `AppStep`에 신규 case를 추가한다.
- [x] `AppStepLayerView`에서 신규 case를 새 화면으로 매핑한다.
- [x] `MainView`의 채팅 탭 `+` 버튼 액션에서 신규 AppStep을 호출한다.
- [x] 새 화면은 최소 shell만 만들고 내부 API는 Phase 2에서 연결한다.
- [x] `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`를 실행해 성공을 확인한다.

## Phase 2 — 리스트, 검색, 확인, 방 생성

**Phase 결과:** 크리에이터가 리스너를 선택하고 DM 방 생성 후 채팅방에 진입한다.

**선행조건:** Phase 1 완료.

**Phase 완료 조건:** `P2-T1`~`P2-T5` 완료와 Phase 2 Gate 통과.

### 구현 항목

#### Task 2.1 화면 UI shell과 다국어 키

**Goal 실행 `P2-T1`:** Figma 기준 신규 화면 shell과 필요한 다국어 키를 추가한다.

- **시작 조건:** `P1-T2` 완료, Figma `2372:23496`, `2372:23521` 확인.
- **완료 증거:** 검색 바, 섹션 타이틀, 리스트 검색 안내 문구, empty 영역, 팝업 문구 키가 존재한다.
- **범위 밖:** 실제 API 호출과 방 생성.
- **TDD 예외 사유:** UI shell과 resource 추가 작업이며 현재 테스트 타깃이 확인되지 않는다.
- **대체 검증 방법:** SwiftGen 또는 프로젝트 string 생성 절차가 있으면 실행, 없으면 빌드로 `I18n` 참조 성공 확인.

**Files:**

- Modify: `SodaLive/Sources/V2/Main/Chat/UserCreatorChat/UserCreatorChatRoomView.swift`
- Modify: localization resource files used by `I18n`

**Interfaces:**

- Produces: `I18n.UserCreatorChatRecipientSearch.searchPlaceholder`
- Produces: `I18n.UserCreatorChatRecipientSearch.sectionTitle`
- Produces: `I18n.UserCreatorChatRecipientSearch.emptyMessage`
- Produces: `I18n.UserCreatorChatRecipientSearch.dialogTitle`
- Produces: `I18n.UserCreatorChatRecipientSearch.dialogMessage(_ nickname: String)`
- Produces: `I18n.UserCreatorChatRecipientSearch.sendButton`

- [x] 검색 안내 문구 `팬 이름을 입력하세요`를 다국어 키로 추가한다.
- [x] 섹션 타이틀 `팔로워`를 다국어 키로 추가한다.
- [x] empty 문구 `사용자가 없어요.\n다른 이름으로 다시 검색해 주세요.`를 다국어 키로 추가한다.
- [x] 팝업 제목과 본문, 보내기 문구를 다국어 키로 추가한다.
- [x] 화면 shell이 Figma 기준 검은 배경, 뒤로가기, 검색 바, 리스트 영역을 표시하도록 작성한다.
- [x] `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`를 실행해 성공을 확인한다.

#### Task 2.2 초기 팔로우 전체 리스트 연동

**Goal 실행 `P2-T2`:** 화면 진입 시 기존 팔로우 전체 리스트 API로 초기 목록을 표시한다.

- **시작 조건:** `P2-T1` 완료.
- **완료 증거:** 화면 최초 진입 시 `/live/recommend/following/channel/all/list`가 기존 pagination 정책으로 호출된다.
- **범위 밖:** 검색 API와 방 생성 API.
- **TDD 예외 사유:** network ViewModel 작업이나 현재 테스트 타깃이 확인되지 않는다.
- **대체 검증 방법:** Charles/Xcode network log 또는 Moya stub 가능 시 요청 path·query 확인, Debug 빌드.

**Files:**

- Modify: `SodaLive/Sources/V2/Main/Chat/UserCreatorChat/UserCreatorChatRoomView.swift`
- Reuse: `SodaLive/Sources/Follow/FollowCreatorRepository.swift`
- Reuse: `SodaLive/Sources/Follow/GetCreatorFollowingAllListResponse.swift`

**Interfaces:**

- Consumes: `FollowCreatorRepository.getFollowedCreatorAllList(page:size:)`
- Produces: `UserCreatorChatRecipientItem(id:nickname:profileImageUrl:)`

- [x] ViewModel에 `isLoading`, `errorMessage`, `isShowPopup`, `items`, `page`, `isLast` 상태를 추가한다.
- [x] 최초 진입 시 `getFollowedCreatorAllList(page: 1, size: 10)`을 호출한다.
- [x] API response의 `creatorId`, `nickname`, `profileImageUrl`을 화면 공통 item으로 매핑한다.
- [x] 리스트 마지막 아이템 노출 시 다음 page를 호출한다.
- [x] 오류는 기존 toast 방식으로 표시한다.
- [x] `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`를 실행해 성공을 확인한다.

#### Task 2.3 유저 검색과 debounce

**Goal 실행 `P2-T3`:** 2글자 이상 검색어에 대해 500ms debounce 후 유저 검색 API를 호출하고 empty 상태를 표시한다.

- **시작 조건:** `P2-T2` 완료.
- **완료 증거:** 0~1글자는 검색 요청 0회, 2글자 이상은 마지막 입력 500ms 후 요청 1회.
- **범위 밖:** 유저 선택 후 방 생성.
- **TDD 예외 사유:** 현재 테스트 타깃이 확인되지 않는다.
- **대체 검증 방법:** 수동 입력 QA와 network 요청 횟수 확인.

**Files:**

- Modify: `SodaLive/Sources/V2/Main/Chat/UserCreatorChat/UserCreatorChatRoomView.swift`
- Reuse: `SodaLive/Sources/User/UserRepository.swift`
- Reuse: `SodaLive/Sources/User/UserApi.swift`

**Interfaces:**

- Consumes: `UserRepository.searchUser(nickname:)`
- Produces: search mode item list and empty state flag

- [x] 검색어 상태를 ViewModel로 전달한다.
- [x] trim 결과가 2글자 미만이면 pending debounce를 취소하고 초기 팔로우 리스트 모드로 돌아간다.
- [x] trim 결과가 2글자 이상이면 500ms debounce 후 `UserRepository.searchUser(nickname:)`를 호출한다.
- [x] 검색어가 바뀌면 이전 debounce 작업과 이전 검색 결과 적용을 취소하거나 무시한다.
- [x] 검색 결과 0건이면 중앙 empty 문구를 표시한다.
- [x] `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`를 실행해 성공을 확인한다.

#### Task 2.4 유저 선택 확인 팝업

**Goal 실행 `P2-T4`:** 리스트 유저 터치 시 V2 공통 팝업으로 DM 보내기 확인을 받는다.

- **시작 조건:** `P2-T2` 또는 `P2-T3` 완료.
- **완료 증거:** 유저 터치 시 API 호출 없이 팝업이 뜨고, 취소 또는 dimmed tap으로 닫힌다.
- **범위 밖:** 보내기 이후 방 생성 API 구현.
- **TDD 예외 사유:** UI interaction 작업이며 현재 테스트 타깃이 확인되지 않는다.
- **대체 검증 방법:** 수동 QA와 Debug 빌드.

**Files:**

- Modify: `SodaLive/Sources/V2/Main/Chat/UserCreatorChat/UserCreatorChatRoomView.swift`
- Reuse: `SodaLive/Sources/V2/Component/Modal/SodaV2ActionModal.swift`

**Interfaces:**

- Consumes: `UserCreatorChatRecipientItem`
- Produces: selected recipient state

- [x] 리스트 아이템 tap handler에서 selected recipient를 저장한다.
- [x] `SodaV2ActionModal` title은 `메시지 보내기` 키를 사용한다.
- [x] message는 선택 유저 닉네임을 넣어 `{{사용자이름}}에게 메시지를 보낼까요?` 형식으로 표시한다.
- [x] 취소와 dimmed tap은 selected recipient를 초기화한다.
- [x] 보내기 버튼은 `P2-T5`의 방 생성 액션을 호출할 수 있도록 연결 지점만 만든다.
- [x] `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`를 실행해 성공을 확인한다.

#### Task 2.5 recipientId 기반 DM 방 생성

**Goal 실행 `P2-T5`:** 확인 팝업의 보내기에서 선택한 리스너 ID로 기존 DM 방 생성 API를 호출하고 채팅방에 진입한다.

- **시작 조건:** `P2-T4` 완료.
- **완료 증거:** request body가 `recipientId`를 포함하고, 성공 response의 `roomId`로 `userCreatorChatRoom`에 진입한다.
- **범위 밖:** 채팅방 내부 메시지 전송 UI 변경.
- **TDD 예외 사유:** API integration 작업이나 현재 테스트 타깃이 확인되지 않는다.
- **대체 검증 방법:** network request body 확인, 성공 시 화면 이동 수동 QA, 기존 크리에이터 채널 DM 시작 회귀 확인.

**Files:**

- Modify: `SodaLive/Sources/V2/Main/Chat/UserCreatorChat/Models/UserCreatorChatModels.swift`
- Modify: `SodaLive/Sources/V2/Main/Chat/UserCreatorChat/Repository/UserCreatorChatRepository.swift`
- Modify: `SodaLive/Sources/V2/Main/Chat/UserCreatorChat/UserCreatorChatRoomView.swift`
- Verify: `SodaLive/Sources/V2/CreatorChannel/CreatorChannelView.swift`

**Interfaces:**

- Produces: `UserCreatorCreateRoomRequest(recipientId: Int? = nil, creatorId: Int? = nil)`
- Produces: `UserCreatorChatRepository.createRoom(recipientId: Int)`
- Preserves: `UserCreatorChatRepository.createRoom(creatorId: Int)` existing caller behavior

- [x] `UserCreatorCreateRoomRequest`를 `recipientId`와 `creatorId` optional request로 변경한다.
- [x] 기존 `createRoom(creatorId:)`는 `creatorId`만 보내도록 유지한다.
- [x] 신규 `createRoom(recipientId:)`를 추가하고 `recipientId`만 보낸다.
- [x] 보내기 탭 중 중복 제출을 막기 위해 loading 상태 동안 버튼 액션을 무시한다.
- [x] 성공 response의 `roomId`로 `AppState.shared.setAppStep(step: .userCreatorChatRoom(roomId: roomId))`를 호출한다.
- [x] 실패 시 서버 message 또는 `I18n.Common.commonError`를 toast로 표시한다.
- [x] 기존 크리에이터 채널의 `AppStep.userCreatorChatCreator(creatorId:)` 흐름이 `creatorId` request를 유지하는지 확인한다.
- [x] `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`를 실행해 성공을 확인한다.

## Phase 3 — 검증 Gate

**Phase 결과:** 신규 DM 시작 흐름과 기존 DM 시작 흐름이 모두 동작한다.

**선행조건:** Phase 2 전체 완료.

### 검증 방법

#### Phase 3 Gate

**Goal 실행 `P3-GATE`:** 요구사항 전체와 회귀 위험을 최종 판정한다.

- **시작 조건:** `P2-T1`~`P2-T5` 완료.
- **완료 증거:** 아래 명령과 수동 QA 결과를 Progress에 기록.
- **범위 밖:** 실패와 무관한 UI 리팩터링.

```bash
xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build
```

**Expected:** exit code 0.

수동 검증:

- [ ] 크리에이터 계정: 메인 대화 탭 우측 하단 `+` 버튼 표시.
- [ ] 비크리에이터 계정: 메인 대화 탭 우측 하단 `+` 버튼 미표시.
- [ ] 신규 화면 최초 진입: `/live/recommend/following/channel/all/list?page=0&size=10&timezone=...` 호출.
- [ ] 검색 1글자: `/member/search` 요청 0회.
- [ ] 검색 2글자 이상 연속 입력: 마지막 입력 500ms 후 `/member/search?nickname=` 요청 1회.
- [ ] 검색 결과 없음: 중앙 empty 문구 표시.
- [ ] 유저 선택: `SodaV2ActionModal` 표시, 취소와 dimmed tap 닫힘.
- [ ] 보내기: `/api/v2/user-creator-chat/rooms/create` request body에 `recipientId`만 포함.
- [ ] 방 생성 성공: `UserCreatorChatRoomView`로 이동.
- [ ] 기존 크리에이터 채널 DM 시작: request body에 `creatorId`만 포함하고 기존처럼 동작.

## 실행 순서와 의존성

| 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 |
|---:|---|---|---|---|
| 1 | `P1-T1` | PRD 확정 | 아니요 | role/진입 정책 재확인 |
| 2 | `P1-T2` | `P1-T1` | 아니요 | AppStep 라우팅 방식 확인 |
| 3 | `P2-T1` | `P1-T2` | 아니요 | 다국어 생성 절차 확인 |
| 4 | `P2-T2` | `P2-T1` | 아니요 | 기존 팔로우 API 계약 확인 |
| 5 | `P2-T3` | `P2-T2` | 아니요 | 검색 response model 확인 |
| 6 | `P2-T4` | `P2-T2` 또는 `P2-T3` | 아니요 | 팝업 문구 재확인 |
| 7 | `P2-T5` | `P2-T4` | 아니요 | 서버 request contract 확인 |
| 8 | `P3-GATE` | Phase 2 전체 | 아니요 | 실패 소유 Task에 회귀 수정 Task 추가 |

```text
P1-T1 → P1-T2 → P2-T1 → P2-T2 → P2-T3 → P2-T4 → P2-T5 → P3-GATE
```

## 변경 금지 항목

- `Pods/**`, `generated/**`, `build/**`를 직접 수정하지 않는다.
- 새 dependency를 추가하지 않는다.
- 기존 DM 방 UI와 WebSocket 전송 로직을 변경하지 않는다.
- `recipientId`와 `creatorId`를 서로 다른 값으로 동시에 보내는 request를 만들지 않는다.
- 실패하는 검증을 통과시키기 위해 테스트를 삭제·완화하거나 타입 오류를 우회하지 않는다.

## 의사결정 및 중단 규칙

- PRD와 구현 계획이 충돌하면 PRD Decision Log를 먼저 갱신한다.
- 검색 API response model이 기존 `SearchResponseItem`으로 충분하지 않으면 코드 변경 전에 이 문서에 Task를 추가한다.
- 서버가 `recipientId` request를 거부하면 `P2-T5`를 중단하고 request contract 확인 Task를 추가한다.
- UI가 Figma와 충돌하면 Figma 구조를 우선하되 기존 V2 component token을 벗어나지 않는다.

## Progress

기존 기록을 삭제하거나 덮어쓰지 않고 실제 실행 결과를 차수별로 누적한다.

### 문서 작성 — 2026-09-14

- 상태: 완료
- 무엇을: PRD와 Goal 실행형 구현 계획 초안 작성.
- 왜: 사용자 요청이 “모호한 것은 인터뷰하고 문서만 생성, 코드 구현 금지”였기 때문.
- 어떻게:
  - `docs/sample/sample-prd.md` 확인 — 샘플 구조 반영.
  - `docs/sample/sample-plan-task.md` 확인 — Phase/Task/Goal 구조 반영.
  - Figma `2372:23496`, `2372:23521` 확인 — 화면과 팝업 기준 반영.
  - 기존 코드 조사 — `MainChatView`, `FollowCreatorViewModel`, `UserApi.searchUser`, `UserCreatorChatRepository`, `SodaV2ActionModal` 기준 반영.
- 남은 항목: 사용자 문서 검토.
- 다음 행동: PRD와 plan-task 승인 또는 수정 요청.

### Phase 1~2 구현 — 2026-09-14

- 상태: 빌드 검증 완료, 수동 QA 필요
- 무엇을:
  - 메인 대화 탭에 크리에이터 전용 신규 DM 시작 `+` 버튼을 추가했다.
  - `AppStep.userCreatorChatRecipientSearch` 라우팅과 리스너 선택 화면을 추가했다.
  - 팔로우 전체 리스트, 2글자 이상 500ms debounce 검색, empty 상태, 확인 팝업, `recipientId` 기반 방 생성을 연결했다.
  - 기존 `creatorId` 기반 `createRoom(creatorId:)` 흐름은 유지했다.
- 왜: PRD의 크리에이터 선제 DM 시작 요구사항을 기존 API와 V2 컴포넌트 재사용으로 구현하기 위해서다.
- 어떻게:
  - 신규 Swift 파일은 프로젝트 수동 등록 위험이 있어 만들지 않고, 기존 컴파일 대상인 `UserCreatorChatRoomView.swift`에 선택 화면 타입을 추가했다.
  - `UserCreatorCreateRoomRequest`는 `encodeIfPresent`로 `recipientId`와 `creatorId` 중 nil 필드를 request body에서 제외하도록 했다.
  - 검색 응답은 기존 `UserRepository.searchUser` 사용처와 동일하게 `ApiResponse<[GetRoomDetailUser]>`로 디코딩했다.
  - 검색어를 2글자 미만으로 지울 때 진행 중인 검색 요청을 취소하고 초기 팔로우 리스트로 복귀하도록 했다.
  - 검색/팔로우 목록/방 생성 로딩 상태를 분리해 지연된 검색 실패가 방 생성 중복 방지 상태를 해제하지 않도록 했다.
  - 최신 검색 요청만 성공·실패 상태를 반영하고, 새 검색 시작 시 이전 검색 결과를 비워 현재 검색어와 목록이 어긋나지 않도록 했다.
- 검증:
  - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build` — 성공.
  - 첫 빌드는 Swift 접근제어 오류를 발견했고 `UserCreatorChatRecipientItem` 접근 수준을 보정했다.
  - 두 번째 빌드는 코드사인/리소스 복사 단계에서 120초 제한으로 중단됐다.
  - 세 번째 빌드는 600초 제한으로 재실행해 `** BUILD SUCCEEDED **` 확인.
  - 검색 취소 로직 보정 후 `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`를 재실행해 `** BUILD SUCCEEDED **` 확인.
  - Oracle 코드 리뷰에서 검색 취소·지연 실패·이전 결과 잔존 이슈를 지적받았고, 상태 처리 보정 후 동일 빌드를 재실행해 `** BUILD SUCCEEDED **` 확인.
- 수동 QA 미수행:
  - 이 환경에서 로그인된 크리에이터/비크리에이터 계정과 실기기 또는 시뮬레이터 네트워크 관찰을 아직 실행하지 못했다.
  - 아래 Phase 3 Gate의 수동 검증 항목은 앱 실행 환경에서 별도 확인해야 한다.

## Decision Log

| 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 |
|---|---|---|---|---|---|
| 2026-09-14 | `DEC-001` | 확정 | 코드 구현 없이 문서만 작성한다. | 사용자 직접 지시 | 전체 |
| 2026-09-14 | `DEC-002` | 확정 | 초기 목록은 기존 팔로우 전체 리스트 API를 사용한다. | 사용자 답변 `B` | `P2-T2` |
| 2026-09-14 | `DEC-003` | 확정 | 새 크리에이터→리스너 DM 시작 request는 `recipientId`를 사용한다. | 서버 request contract | `P2-T5` |

## 발견된 문제

| ID | 심각도 | 상태 | 발견 내용 | 영향 Goal | 처리 계획 |
|---|---|---|---|---|---|
| `ISSUE-001` | Medium | 처리 완료 | 현재 iOS `UserCreatorCreateRoomRequest`는 `creatorId` 단일 필드만 가진다. | `P2-T5` | request model을 optional `recipientId`/`creatorId` 구조로 확장했다. |
| `ISSUE-002` | Low | 처리 완료 | 신규 Swift 파일은 `project.pbxproj` 수동 등록이 필요해 누락 시 빌드 실패 위험이 있다. | `P1-T2`, `P2-T1`~`P2-T5` | 기존 컴파일 대상인 `UserCreatorChatRoomView.swift`에 선택 화면 타입을 추가했다. |

## 최종 보고 형식

구현 완료 보고에는 아래 항목을 기록한다.

- 구현 결과: 완료한 Phase와 사용자가 수행할 수 있게 된 DM 시작 흐름.
- 변경: 주요 파일과 사용자에게 보이는 동작.
- 결정: 적용된 Decision Log ID와 결정 내용.
- 검증: 실행한 명령, exit code, 수동 QA 성공·실패 결과.
- 남은 항목: 외부 의존, 후속 범위, 또는 없음.
- 문서: 갱신한 PRD, plan-task, review 문서 경로.