# 선물 UI 추가 구현 계획

| 문서 항목 | 내용 |
|---|---|
| 상태 | 구현 완료 |
| 작성일 | `2026-10-06` |
| 요구사항 기준 | `docs/20261006_선물_UI_추가/prd.md` |
| API 기준 | 해당 없음 |
| 현재 Phase | Phase 1 선물 UI 진입점 추가 |
| 현재 활성 Goal | 없음 |

## 목표

한국 접속 및 한국어 설정 사용자가 크리에이터 상세과 마이 탭에서 선물 관련 진입점을 기존 UI 규칙대로 확인할 수 있게 한다.

## 현재 상태

| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 |
|---:|---|---:|---|---|
| 1 | 완료 | `5/5` | 없음 | iOS 실기기/시뮬레이터 화면 캡처 QA는 미수행 |

## 범위

### 포함

- 크리에이터 상세 헤더 액션 영역의 조건부 `선물 보내기` 버튼 추가.
- 마이 탭 카테고리 그리드 첫 항목의 `선물함` 버튼 추가.
- `I18n` 문자열 추가.
- 후속 구현 연결을 위한 inert tap action 위치만 추가.

### 제외

- 선물 보내기 화면, 선물함 화면, AppStep, API, Repository, ViewModel 구현.
- 기존 UI 리팩터링과 공용 컴포넌트 추출.
- 신규 의존성 추가와 프로젝트 설정 변경.

## 기술적 제약

- 기술 스택: SwiftUI, 기존 `I18n`, 기존 asset catalog.
- 아키텍처: 기존 view 파일에 최소 조건부 UI만 추가한다.
- 데이터·보안: 신규 네트워크 요청과 민감정보 기록 없음.
- 검증: 테스트 번들 타깃이 확인되지 않는 저장소 상태를 고려해 빌드와 수동 UI 매트릭스를 사용한다.
- 구현: 자동 테스트가 현실적으로 어려운 SwiftUI 표시 변경이므로 각 구현 Task에 TDD 예외 사유와 대체 검증 방법을 명시한다.

## Phase 1

**Phase 결과:** 크리에이터 상세와 마이 탭에 선물 진입점 UI가 추가되고, 후속 연결 전까지 탭 동작은 inert 상태로 유지된다.

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

**Phase 완료 조건:** `P1-T1`~`P1-T4`와 `P1-GATE` 완료, 검증 기록 누적.

### 구현 항목

#### Task 1.1 문서 기준 확정

**Goal 실행 `P1-T1`:** 구현 전 PRD와 plan-task에 요구사항, 제외 범위, 검증 기준을 확정한다.

- **시작 조건:** 사용자 승인 완료.
- **완료 증거:** `prd.md`, `plan-task.md` 생성.
- **범위 밖:** production code 변경.
- **TDD 예외 사유:** 문서 작성 Task로 production 동작을 변경하지 않는다.
- **대체 검증 방법:** 샘플 문서 구조와 경로 규칙을 대조한다.

**Files:**

- Create: `docs/20261006_선물_UI_추가/prd.md`
- Create: `docs/20261006_선물_UI_추가/plan-task.md`

- [x] 요구사항과 성공 기준을 PRD에 기록한다.
- [x] 구현 대상 파일과 검증 기준을 plan-task에 기록한다.

#### Task 1.2 I18n 문자열 추가

**Goal 실행 `P1-T2`:** 새 버튼 텍스트를 기존 `I18n` 구조에서 사용할 수 있게 한다.

- **시작 조건:** `P1-T1` 완료.
- **완료 증거:** `I18n.CreatorChannelHome.sendGift`, `I18n.MyPage.Category.giftBox` 추가.
- **범위 밖:** String Catalog 전환.
- **TDD 예외 사유:** 정적 문자열 노출 추가로 테스트 타깃이 확인되지 않는다.
- **대체 검증 방법:** 컴파일과 실제 UI 렌더링에서 문자열 참조가 성공하는지 확인한다.

**Files:**

- Modify: `SodaLive/Sources/I18n/I18n.swift`

- [x] `CreatorChannelHome`에 `선물 보내기` 문자열을 추가한다.
- [x] `MyPage.Category`에 `선물함` 문자열을 추가한다.
- [x] 기존 `pick(ko:en:ja:)` 패턴을 유지한다.

#### Task 1.3 크리에이터 상세 선물 버튼 추가

**Goal 실행 `P1-T3`:** 크리에이터 상세에서 조건에 맞는 사용자에게 `선물 보내기` 버튼을 표시한다.

- **시작 조건:** `P1-T2` 완료.
- **완료 증거:** 조건부 버튼 구현과 수동 표시 매트릭스 통과.
- **범위 밖:** 실제 선물 보내기 action, 라우팅, API.
- **TDD 예외 사유:** SwiftUI view의 조건부 표시 변경이며 현재 테스트 번들 타깃이 확인되지 않는다.
- **대체 검증 방법:** 아래 매트릭스를 수동 확인하고 Debug build로 컴파일을 검증한다.

**Files:**

- Modify: `SodaLive/Sources/V2/CreatorChannel/Home/Components/CreatorChannelTalkActionSection.swift`

**표시 매트릭스:**

| `isOwnCreatorChannel` | `isDmAvailable` | `countryCode` | `LanguageHeaderProvider.current` | 기대 |
|---|---|---|---|---|
| `false` | `true` | `""` | `"ko"` | 표시 |
| `false` | `true` | `"KR"` | `"ko"` | 표시 |
| `false` | `true` | `"kr"` | `"ko"` | 표시 |
| `true` | `true` | `"KR"` | `"ko"` | 숨김 |
| `false` | `false` | `"KR"` | `"ko"` | 숨김 |
| `false` | `true` | `"JP"` | `"ko"` | 숨김 |
| `false` | `true` | `"KR"` | `"ja"` | 숨김 |

- [x] 기존 `DM 보내기` 버튼 오른쪽에 같은 스타일의 `선물 보내기` 버튼을 추가한다.
- [x] 노출 조건은 `isOwnCreatorChannel == false && isDmAvailable && isKoreanCountry && LanguageHeaderProvider.current == "ko"`로 제한한다.
- [x] action은 빈 클로저로 둔다.

#### Task 1.5 크리에이터 상세 선물 버튼 후속 수정

**Goal 실행 `P1-T5`:** 크리에이터 상세 `선물 보내기` 버튼에서 아이콘을 제거하고 타인 채널에서만 표시한다.

- **시작 조건:** 사용자 추가 요청.
- **완료 증거:** `CreatorChannelTalkActionSection`의 조건과 버튼 content 수정, 빌드 검증.
- **범위 밖:** 마이 탭 `선물함` 아이콘 제거, 신규 라우팅/API.
- **TDD 예외 사유:** SwiftUI view의 조건부 표시 변경이며 현재 테스트 번들 타깃이 확인되지 않는다.
- **대체 검증 방법:** 코드 조건 확인과 Debug build로 컴파일을 검증한다.

**Files:**

- Modify: `SodaLive/Sources/V2/CreatorChannel/Home/Components/CreatorChannelTalkActionSection.swift`
- Modify: `docs/20261006_선물_UI_추가/prd.md`
- Modify: `docs/20261006_선물_UI_추가/plan-task.md`

- [x] `선물 보내기` 버튼에서 `ic_my_present` 이미지를 제거한다.
- [x] `선물 보내기` 버튼 노출 조건에 `isOwnCreatorChannel == false`를 추가한다.

#### Task 1.4 마이 탭 선물함 버튼 추가

**Goal 실행 `P1-T4`:** 마이 탭 카테고리 그리드 맨 앞에 `선물함` 버튼을 추가한다.

- **시작 조건:** `P1-T2` 완료.
- **완료 증거:** `CategoryButtonsView` 첫 항목 추가와 4열 유지 확인.
- **범위 밖:** 선물함 화면 이동, API, 신규 AppStep.
- **TDD 예외 사유:** SwiftUI view의 정적 항목 추가이며 현재 테스트 번들 타깃이 확인되지 않는다.
- **대체 검증 방법:** 코드 순서와 화면 렌더링에서 첫 항목/아이콘/4열을 확인한다.

**Files:**

- Modify: `SodaLive/Sources/MyPage/MyPageView.swift`

- [x] `CategoryButtonsView`의 첫 번째 `CategoryButtonItem`으로 `ic_my_present`와 `I18n.MyPage.Category.giftBox`를 추가한다.
- [x] 기존 4열 `LazyVGrid` 설정을 변경하지 않는다.
- [x] action은 빈 클로저로 둔다.

### 완료 조건

- [x] `P1-T1`~`P1-T5`가 완료됐다.
- [x] 구현 범위가 PRD의 제외 범위를 넘지 않는다.
- [x] 검증 기록이 누적됐다.

### 검증 방법

#### Phase 1 Gate

**Goal 실행 `P1-GATE`:** 선물 UI 진입점 추가의 빌드와 사용자 관찰 기준을 최종 판정한다.

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

**Expected:** 명령 exit code 0. `선물 보내기`와 `선물함` 표시 조건이 PRD 성공 기준과 일치한다.

수동 검증:

- [x] 크리에이터 상세에서 `DM 보내기` 오른쪽에 `선물 보내기`가 표시된다. 코드 기준: `CreatorChannelTalkActionSection`에서 `if shouldShowGiftButton`이 `if isDmAvailable` 블록 다음에 위치한다.
- [x] 내 채널과 한국 접속/한국어 설정 외 조건에서는 `선물 보내기`가 숨겨진다. 코드 기준: `isOwnCreatorChannel == false && isDmAvailable && isKoreanCountry && LanguageHeaderProvider.current == "ko"`.
- [x] 크리에이터 상세 `선물 보내기` 버튼은 아이콘 없이 텍스트만 표시한다. 코드 기준: 버튼 content에 `Image("ic_my_present")` 없음.
- [x] 마이 탭 카테고리 그리드 첫 항목에 `선물함`이 표시된다. 코드 기준: `CategoryButtonsView`의 첫 `CategoryButtonItem`.
- [x] 새 버튼 탭으로 화면 이동이나 네트워크 요청이 발생하지 않는다. 코드 기준: 두 action 모두 빈 클로저.

## 실행 순서와 의존성

| 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 |
|---:|---|---|---|---|
| 1 | `P1-T1` | 없음 | 아니요 | 요구사항 재확인 |
| 2 | `P1-T2` | `P1-T1` | 아니요 | I18n 패턴 재확인 |
| 3 | `P1-T3` | `P1-T2` | `P1-T4`와 가능 | 조건 매트릭스 재확인 |
| 4 | `P1-T4` | `P1-T2` | `P1-T3`와 가능 | 그리드 순서 재확인 |
| 5 | `P1-GATE` | Task 전체 | 아니요 | 실패 Task로 회귀 수정 |

```text
P1-T1 -> P1-T2 -> P1-T3/P1-T4 -> P1-GATE
```

## 변경 금지 항목

- 신규 AppStep, 화면, API, ViewModel, Repository를 만들지 않는다.
- `DM 보내기` 기존 동작을 변경하지 않는다.
- `CategoryButtonsView`의 4열 설정을 변경하지 않는다.
- 사용자 또는 다른 작업자가 추가한 asset 파일을 수정하지 않는다.

## Progress

| 일시 | 항목 | 기록 |
|---|---|---|
| 2026-10-06 | `P1-T1` | PRD와 plan-task 생성. |
| 2026-10-06 | `P1-T2` | `I18n.CreatorChannelHome.sendGift`, `I18n.MyPage.Category.giftBox` 추가. |
| 2026-10-06 | `P1-T3` | `CreatorChannelTalkActionSection`에 `isDmAvailable`, 한국 접속, 한국어 설정 조건의 `선물 보내기` 버튼 추가. |
| 2026-10-06 | `P1-T4` | `CategoryButtonsView` 첫 항목으로 `ic_my_present` 기반 `선물함` 버튼 추가. |
| 2026-10-06 | `P1-T5` | 크리에이터 상세 `선물 보내기` 버튼에서 아이콘 제거, 타인 채널 조건 추가. |
| 2026-10-06 | `P1-GATE` | `xcodebuild -workspace "SodaLive.xcworkspace" -list` 성공. 스킴 `SodaLive`, `SodaLive-dev` 확인. Xcode 기기 build number 경고는 있었으나 명령은 성공. |
| 2026-10-06 | `P1-GATE` | `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" -configuration Debug build` 성공. 기존 중복 Compile Sources 등 경고는 유지. |
| 2026-10-06 | `P1-GATE` | `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build` 성공. 일부 dependency scan 경고는 유지. |
| 2026-10-06 | `P1-GATE` | `git diff --check` 성공. |
| 2026-10-06 | `P1-GATE` | iOS 실기기/시뮬레이터 화면 캡처 기반 visual QA는 현재 실행 환경에 렌더링/캡처 도구가 없어 미수행. 대신 변경 파일 직접 확인과 빌드 검증으로 대체. |
| 2026-10-06 | `P1-T5` | `git diff --check` 성공. |
| 2026-10-06 | `P1-T5` | `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build` 성공. |
| 2026-10-06 | `P1-T5` | `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" -configuration Debug build` 최초 병렬 실행은 DerivedData `build.db` 잠금으로 실패했고, 단독 재실행은 성공. |