sodalive-ios/docs/20261006_선물_UI_추가/prd.md

# 선물 UI 추가 PRD

## 문서 정보

| 항목 | 내용 |
|---|---|
| 문서 상태 | 구현 완료 |
| 작성일 | `2026-10-06` |
| 최종 수정일 | `2026-10-06` |
| 대상 제품 | 크리에이터 상세 선물 버튼, 마이 탭 선물함 버튼 |
| 작성자·결정권자 | 사용자 요청 기준 |
| 관련 API Contract | 해당 없음 |
| 관련 구현 계획 | `docs/20261006_선물_UI_추가/plan-task.md` |
| 관련 review | 없음 |

## 1. Overview

한국에서 접속하고 앱 언어가 한국어인 사용자가 크리에이터 상세와 마이 탭에서 선물 관련 진입점을 볼 수 있게 한다. 이번 범위는 UI 진입점 추가까지만 포함하며 실제 선물 보내기/선물함 화면 이동은 후속 작업에서 연결한다.

## 2. Problem Statement

- 선물 기능 연결 전에도 사용자가 진입점을 인지할 수 있는 UI가 필요하다.
- 크리에이터 상세의 선물 진입점은 현재 `DM 보내기`와 같은 레벨의 액션으로 보여야 한다.
- 마이 탭의 선물함은 기존 보관함, 차단목록 등 카테고리 버튼과 같은 UI 레벨에 있어야 한다.

문제를 해결했다는 판단은 조건에 맞는 사용자에게 두 진입점이 기존 UI 규칙대로 노출되고, 탭해도 아직 별도 기능으로 이동하지 않는 것으로 한다.

## 3. Goals

### 3.1 제품 목표

- 크리에이터 상세에서 `DM 보내기` 노출 조건과 동일한 크리에이터에 대해 한국 접속, 한국어 설정, 타인 채널 조건일 때 `선물 보내기` 버튼을 표시한다.
- 마이 탭 카테고리 그리드의 첫 항목으로 `선물함` 버튼을 표시한다.
- 후속 기능 연결을 위해 탭 액션 위치만 남기고 실제 화면 이동/API 호출은 하지 않는다.

### 3.2 UX 목표

- `선물 보내기` 버튼은 `DM 보내기`와 같은 형태, 간격, 텍스트 스타일을 사용한다.
- `선물함` 버튼은 기존 카테고리 버튼과 같은 4열 그리드, 아이콘 박스, 텍스트 스타일을 사용한다.

## 4. Non-Goals

- 선물 보내기 화면, 선물함 화면, 라우팅, API, 데이터 모델 구현은 제외한다.
- 신규 디자인 시스템, 공용 컴포넌트 추출, 기존 버튼 리팩터링은 제외한다.
- 새 의존성 추가와 프로젝트 설정 변경은 제외한다.

## 5. Target Users and Permissions

| 사용자 | 목표 | 주요 작업 | 사용 환경 |
|---|---|---|---|
| 한국 접속 및 한국어 설정 사용자 | 크리에이터에게 선물하거나 선물함을 확인할 진입점을 인지 | 버튼 확인 및 탭 | iOS 앱 |

권한과 인증 흐름은 이번 범위에서 변경하지 않는다. `선물 보내기` 버튼 노출은 기존 `DM 보내기` 노출 조건인 `creator.isDmAvailable`을 재사용한다.

## 6. 핵심 사용자 흐름

1. 사용자가 크리에이터 상세에 진입한다.
2. 앱이 내 채널 여부, `creator.isDmAvailable`, 접속 국가, 앱 언어를 기준으로 `선물 보내기` 버튼 노출 여부를 결정한다.
3. 조건이 맞으면 `DM 보내기` 오른쪽에 같은 형태의 `선물 보내기` 버튼이 보인다.
4. 로그인 사용자가 마이 탭에 진입하면 카테고리 그리드 첫 항목에 `선물함` 버튼이 보인다.
5. 두 버튼의 탭 액션은 후속 구현 전까지 아무 동작도 하지 않는다.

## 7. 정보 구조와 라우팅

```text
크리에이터 상세 헤더 액션 영역
  DM 보내기
  선물 보내기

마이 탭 카테고리 그리드
  선물함
  보관함
  차단목록
  ...기존 항목
```

신규 route는 만들지 않는다.

## 8. 기능 요구사항

| ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 |
|---|---|---|---|---|
| `GIFT-001` | 확정 | 크리에이터 상세에 `선물 보내기` 버튼을 추가한다. | 내 채널이 아니고 `creator.isDmAvailable == true`, 한국 접속, `LanguageHeaderProvider.current == "ko"`일 때만 `DM 보내기` 오른쪽에 표시된다. | `P1-T2` |
| `GIFT-002` | 확정 | 한국 접속 판정은 기존 패턴을 사용한다. | `UserDefaults.countryCode`를 trim/uppercase 후 빈 값 또는 `KR`이면 한국 접속으로 본다. | `P1-T2` |
| `GIFT-003` | 확정 | 한국어 설정 판정은 기존 언어 헤더를 사용한다. | `LanguageHeaderProvider.current == "ko"`일 때 한국어 설정으로 본다. | `P1-T2` |
| `GIFT-004` | 확정 | 마이 탭 카테고리 그리드 첫 항목에 `선물함`을 추가한다. | 4열 설정은 유지되고, `ic_my_present` 아이콘과 `선물함` 텍스트가 보관함 앞에 표시된다. | `P1-T3` |
| `GIFT-005` | 확정 | 두 버튼의 탭 액션은 후속 구현 전까지 inert placeholder로 둔다. | 탭해도 화면 이동, API 호출, 상태 변경이 없다. | `P1-T2`, `P1-T3` |
| `GIFT-006` | 확정 | 크리에이터 상세의 `선물 보내기` 버튼은 아이콘 없이 텍스트만 표시한다. | 캡슐 스타일은 유지하되 `ic_my_present` 등 아이콘을 포함하지 않는다. | `P1-T2` |

## 9. 반응형 기능 범위

| 기능 | iPhone | iPad | 비고 |
|---|---:|---:|---|
| 크리에이터 상세 버튼 | 전체 | 전체 | 기존 헤더 액션 레이아웃 유지 |
| 마이 탭 선물함 | 전체 | 전체 | 기존 4열 그리드 유지 |

## 10. UI/UX Expectations

- 크리에이터 상세 버튼은 `CreatorChannelTalkActionSection`의 기존 캡슐 버튼 스타일을 그대로 따른다.
- 마이 탭 버튼은 `CategoryButtonItem`을 그대로 사용한다.
- 새 아이콘은 기존 asset `ic_my_present`를 사용한다.
- 새 텍스트는 `I18n`에 추가해 기존 다국어 선택 방식을 따른다.

## 11. API 계약

해당 없음. 신규 API 요청, 응답, 에러 계약은 이번 범위에 없다.

## 12. 보안과 데이터 취급

- 인증 토큰, 사용자 정보, 선물 데이터 저장 로직을 변경하지 않는다.
- 버튼 탭으로 네트워크 요청을 발생시키지 않는다.

## 13. 성능과 품질 요구사항

- 신규 의존성을 추가하지 않는다.
- 기존 SwiftUI view 구조에서 조건부 렌더링만 추가한다.
- `xcodebuild` Debug build를 기본 검증으로 사용한다.

## 14. 성공 기준

### 14.1 기능 수용 기준

- [ ] `DM 보내기`가 보이는 타인 크리에이터 채널에서 한국 접속 및 한국어 설정이면 `선물 보내기`도 보인다.
- [ ] 내 채널에서는 `선물 보내기`가 보이지 않는다.
- [ ] `creator.isDmAvailable == false`이면 `선물 보내기`가 보이지 않는다.
- [ ] 한국 접속이 아니거나 한국어 설정이 아니면 `선물 보내기`가 보이지 않는다.
- [ ] 마이 탭 카테고리 그리드 첫 항목에 `선물함`이 보인다.
- [ ] 두 새 버튼을 탭해도 화면 이동/API 호출이 없다.

### 14.2 UI/UX 수용 기준

- [ ] `선물 보내기`는 아이콘 없이 `DM 보내기`와 같은 캡슐 형태로 표시된다.
- [ ] `선물함`은 기존 카테고리 버튼과 같은 형태로 표시된다.
- [ ] 한 줄에 보이는 카테고리 개수는 기존 4열 설정 그대로다.

### 14.3 추적성 완료 기준

- [ ] 모든 확정 요구사항이 `plan-task.md`의 Task와 연결된다.
- [ ] 검증 결과가 `plan-task.md`에 누적된다.

## 15. Open Questions

없음.

## Decision Log

| 일시 | 결정 | 근거 |
|---|---|---|
| 2026-10-06 | `선물 보내기`는 `DM 보내기` 노출 조건인 `isDmAvailable`을 재사용한다. | 사용자 답변: “해당 조건과 동일하게 설정하면 된다.” |
| 2026-10-06 | 한국 접속은 기존 `countryCode` 판정, 한국어 설정은 `LanguageHeaderProvider.current == "ko"`를 사용한다. | 기존 코드 검색 결과 `isKoreanCountry` 패턴과 언어 헤더 구조 확인 |
| 2026-10-06 | 크리에이터 상세 `선물 보내기`는 아이콘 없이 타인 채널에서만 표시한다. | 사용자 추가 요청 |