docs(gift): 선물 신청 요구사항을 정리한다

This commit is contained in:
2026-10-01 15:51:51 +09:00
parent 0fb727d0ee
commit 79f47c25ab
4 changed files with 1166 additions and 0 deletions
@@ -0,0 +1,65 @@
package kr.co.vividnext.sodalive.v2.gift
import android.content.Context
import android.text.InputFilter
import android.view.View
import android.view.ViewGroup
import android.widget.ArrayAdapter
import android.widget.TextView
import androidx.core.content.ContextCompat
import kr.co.vividnext.sodalive.R
class GiftCategoryAdapter(
context: Context,
items: List<String>
) : ArrayAdapter<String>(context, R.layout.item_gift_send_category, items) {
override fun getView(position: Int, convertView: View?, parent: ViewGroup): View =
super.getView(position, convertView, parent).also { tintItem(it, position) }
override fun getDropDownView(position: Int, convertView: View?, parent: ViewGroup): View =
super.getDropDownView(position, convertView, parent).also { tintItem(it, position) }
private fun tintItem(view: View, position: Int) {
(view as? TextView)?.setTextColor(
ContextCompat.getColor(context, if (position == 0) R.color.gray_500 else R.color.white)
)
}
}
object GiftSendInputFilters {
fun senderName() = InputFilter { source, start, end, _, _, _ ->
filterChars(source, start, end) { it.isLetterOrDigit() && (it.code < 128 || it in '가'..'힣') }
}
fun phoneNumber() = InputFilter { source, start, end, _, _, _ ->
filterChars(source, start, end) { it.isDigit() }
}
private fun filterChars(
source: CharSequence,
start: Int,
end: Int,
accepts: (Char) -> Boolean
): CharSequence? {
val filtered = source.subSequence(start, end).filter(accepts)
return if (filtered.length == end - start) null else filtered
}
}
object GiftSendInputErrorBinder {
fun bind(
context: Context,
input: TextView,
helper: TextView,
hasError: Boolean,
errorText: String,
normalText: String
) {
input.setBackgroundResource(
if (hasError) R.drawable.bg_gift_send_input_error else R.drawable.bg_creator_channel_fantalk_reply
)
helper.text = if (hasError) errorText else normalText
helper.setTextColor(ContextCompat.getColor(context, if (hasError) R.color.red_400 else R.color.gray_400))
}
}
@@ -0,0 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android">
<solid android:color="@color/gray_900" />
<stroke
android:width="1dp"
android:color="@color/red_400" />
<corners android:radius="@dimen/radius_14" />
</shape>
@@ -0,0 +1,788 @@
# 선물 보내기 신청 페이지 UI 구현 계획/TASK
> **For agentic workers:** REQUIRED SUB-SKILL: Use `superpowers:subagent-driven-development` 또는 `superpowers:executing-plans` to implement this plan task-by-task. 각 단계는 체크박스(`- [ ]`)로 추적하고, 완료 즉시 `- [x]`로 갱신한다. 구현 범위 변경이 생기면 이 문서를 먼저 수정한 뒤 코드에 반영한다.
**Goal:** 크리에이터 채널에서 전달받은 크리에이터 정보로 선물 보내기 신청 UI shell을 표시하고, 입력/동의 상태에 따른 CTA 활성 정책을 구현한다.
**Architecture:** 신규 `GiftSendRequestActivity`를 `kr.co.vividnext.sodalive.v2.gift` 하위에 만들고, 화면 상태 계산은 순수 Kotlin presentation model로 분리한다. API 호출, 제출 action, Kakao 우편번호 WebView 결과 반영은 후속 요청 범위로 남기며, 이번 구현은 Figma 기준 UI와 no-op 상태만 만든다.
**Tech Stack:** Kotlin, Android XML Views, ViewBinding, BaseActivity, Spinner, RecyclerView 또는 정적 LinearLayout, JUnit4 local unit test.
---
## 전제와 성공 기준
- PRD: `docs/20261001_선물_보내기_신청_페이지/prd.md`
- Figma:
- 비활성 CTA: `2481:18904` (`gift_002`)
- 활성 CTA: `2481:18957` (`gift_003`)
- Kakao 우편번호 가이드: `https://postcode.map.kakao.com/guide`
- 이번 범위:
- 신규 `Activity` UI shell.
- 크리에이터 채널 DM 가능 비소유자에서 선물 보내기 진입 연결.
- 진입 extra 검증.
- 선물 사이즈/카테고리/CTA/동의 presentation model.
- XML layout과 string/drawable resource.
- 제외 범위:
- 선물 사이즈·카테고리 API 호출.
- CTA 제출 API와 성공/실패 처리.
- Kakao 우편번호 WebView 실행과 JavaScript bridge 결과 반영.
- `app/src/androidTest`, `connectedDebugAndroidTest`, 기기·에뮬레이터 UI 조작, 스크린샷·시각 QA.
- 구현 실행 보정:
- production UI는 API 연결 전 선물 사이즈 빈 목록, 카테고리 sentinel placeholder, CTA disabled 상태로 시작한다.
- CTA enabled 상태는 production fixture 없이 `GiftSendRequestPresenterTest`의 완성된 synthetic form state로 검증한다.
- 우편번호와 기본 주소는 `EditText`가 아닌 field style의 read-only `TextView`로 구현한다.
- Activity/Manifest/layout의 메서드명·속성을 문자열로 검사하는 source test는 작성하지 않는다. wiring은 compile/resource merge와 read-only 대조로 검증한다.
- 크리에이터 채널 선물 버튼 노출 조건은 `!isOwner && isDmAvailable`로 한정하고, 지역/언어 runtime gate는 후속 범위로 남긴다.
- 구현 완료 후 최소 다음 명령을 실행한다.
- `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*"`
- `./gradlew :app:mergeDebugResources`
- `./gradlew :app:compileDebugKotlin`
- `./gradlew :app:ktlintCheck`
- `git diff --check`
---
## 파일 구조
- 생성: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestActivity.kt`
- Intent extra 검증, ViewBinding, 입력 watcher, dropdown, checkbox, CTA enabled binding을 담당한다.
- 생성: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestModels.kt`
- `GiftSendEntry`, `GiftSizeUiModel`, `GiftCategoryUiModel`, `GiftSendFormState`, `GiftSendCtaState`를 정의한다.
- 생성: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenter.kt`
- entry validation, 기본 선물 사이즈 선택, 미선택 스타일, category placeholder, CTA enabled 계산을 담당한다.
- 생성: `app/src/main/res/layout/activity_gift_send_request.xml`
- Figma 기준 전체 화면 layout을 구성한다.
- 생성 가능: `app/src/main/res/drawable/bg_gift_send_*.xml`
- 기존 drawable/token으로 대응되지 않는 카드, border, CTA 배경만 최소 추가한다.
- 수정: `app/src/main/res/values/strings.xml`
- 화면 title, 안내, label, placeholder, 동의 문구, 잘못된 접근 메시지를 추가한다.
- 수정: `app/src/main/res/values-en/strings.xml`, `app/src/main/res/values-ja/strings.xml`
- 선물 화면 string key 누락으로 인한 resource 오류를 막기 위해 영어·일본어 번역을 추가한다.
- 수정: `app/src/main/AndroidManifest.xml`
- 신규 `GiftSendRequestActivity`를 등록한다.
- 수정: `app/src/main/java/kr/co/vividnext/sodalive/v2/creator/channel/CreatorChannelActivity.kt`, `app/src/main/res/layout/activity_creator_channel.xml`
- DM 버튼 우측에 선물 보내기 버튼을 추가하고 신규 Activity로 이동한다.
- 테스트 생성: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendEntryPolicyTest.kt`
- Intent entry validation 정책을 검증한다.
- 테스트 생성: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenterTest.kt`
- 선물 사이즈 기본 선택, 미선택 스타일, category placeholder, CTA enabled 계산을 검증한다.
---
## Phase 1: 진입 정책과 Activity shell
**Phase 결과:** 유효한 크리에이터 정보로 신규 Activity가 표시되고, 잘못된 접근은 메시지 후 종료된다.
**선행조건:** PRD `GIFT-ENTRY-*` 확정.
**Phase 완료 조건:** `P1-T1`, `P1-T2`, `P1-GATE` 완료, 검증 기록 누적.
### 구현 항목
#### Task 1.1 진입 extra 정책 구현
**Goal 실행 `P1-T1`:** `GiftSendRequestActivity` 진입에 필요한 크리에이터 회원번호와 닉네임 검증 정책을 만든다.
- **시작 조건:** PRD `GIFT-ENTRY-001`, `GIFT-ENTRY-002`.
- **완료 증거:** entry policy 테스트 PASS, invalid access message string 추가.
- **범위 밖:** 크리에이터 채널에서 실제 startActivity 연결.
**Files:**
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestModels.kt`
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenter.kt`
- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendEntryPolicyTest.kt`
- Modify: `app/src/main/res/values/strings.xml`
**Interfaces:**
- Produces: `GiftSendEntry(creatorMemberId: Long, creatorNickname: String)`
- Produces: `GiftSendRequestPresenter.toValidEntry(creatorMemberId: Long, creatorNickname: String): GiftSendEntry?`
- [x] **RED:** `creatorMemberId <= 0`이면 `toValidEntry()`가 null을 반환하는 테스트를 작성한다.
- [x] **RED:** blank nickname이면 `toValidEntry()`가 null을 반환하는 테스트를 작성한다.
- [x] **RED:** 유효한 값이면 `GiftSendEntry`를 반환하는 테스트를 작성한다.
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendEntryPolicyTest"`를 실행해 신규 타입 부재 또는 assertion 실패를 확인한다.
- [x] **GREEN:** `GiftSendEntry`, `GiftSendRequestPresenter.toValidEntry()`를 최소 구현한다. `gift_send_invalid_access` 문자열은 Activity resource Task에서 추가한다.
- [x] **GREEN 확인:** 같은 focused test를 다시 실행해 PASS를 확인한다.
- [x] **REFACTOR:** 이번 Task에서 만든 중복만 정리하고 focused test 결과를 Progress에 기록한다.
검증 기록:
- 2026-10-01: production 구현 전 gift package test를 실행해 신규 모델·presenter 부재로 `compileDebugUnitTestKotlin FAILED`를 확인했다. 최소 구현 후 동일 package test가 `BUILD SUCCESSFUL`로 통과했고, 진입 정책의 spec/quality review가 승인됐다.
#### Task 1.2 신규 Activity shell과 Manifest 등록
**Goal 실행 `P1-T2`:** 신규 `GiftSendRequestActivity`를 만들고 invalid entry 시 메시지 후 종료하도록 연결한다.
- **시작 조건:** `P1-T1` 완료.
- **완료 증거:** Activity compile PASS, Manifest 등록, `newIntent()` 제공.
- **범위 밖:** 실제 크리에이터 채널 진입 액션 연결.
**Files:**
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestActivity.kt`
- Create: `app/src/main/res/layout/activity_gift_send_request.xml`
- Modify: `app/src/main/AndroidManifest.xml`
**Interfaces:**
- Produces: `GiftSendRequestActivity.newIntent(context, creatorMemberId, creatorNickname)`
- Consumes: `GiftSendRequestPresenter.toValidEntry()`
- [x] **TDD 예외 사유:** Activity/Manifest wiring은 순수 입력/출력 로직이 아니며 source 문자열 테스트는 동작을 검증하지 않는다. 진입 판정은 `P1-T1` local unit test로 검증한다.
- [x] **대체 검증 방법:** `BaseActivity<ActivityGiftSendRequestBinding>` 기반 Activity, `newIntent()`, invalid entry message/`finish()` 조기 반환을 구현한 뒤 Kotlin compile과 read-only 대조로 wiring을 확인한다.
- [x] **GREEN:** `BaseActivity<ActivityGiftSendRequestBinding>` 기반 Activity, layout, `newIntent()`, invalid entry `Toast.makeText(...).show(); finish()`를 구현한다.
- [x] **GREEN:** Manifest에 `GiftSendRequestActivity`를 등록한다.
- [x] **GREEN 확인:** focused test와 `./gradlew :app:compileDebugKotlin`을 실행해 PASS를 확인한다.
- [x] **REFACTOR:** Activity의 setup method를 `bindEntry()`, `setupView()` 수준으로만 정리하고 결과를 Progress에 기록한다.
### 완료 조건
- [x] `P1-T1`, `P1-T2`의 체크박스와 완료 증거가 모두 충족됐다.
- [x] invalid entry 정책이 PRD와 일치한다.
### 검증 방법
#### Phase 1 Gate
**Goal 실행 `P1-GATE`:** 신규 Activity 진입 정책과 shell 컴파일을 판정한다.
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*"
./gradlew :app:compileDebugKotlin
```
**Expected:** 테스트와 Kotlin 컴파일이 exit 0으로 종료된다.
---
## Phase 2: UI 상태 모델과 CTA 정책
**Phase 결과:** 선물 사이즈, 카테고리, 입력값, 동의값으로 CTA 활성 상태를 계산한다.
**선행조건:** `P1-GATE` 완료.
**Phase 완료 조건:** `P2-T1`, `P2-T2`, `P2-GATE` 완료.
### 구현 항목
#### Task 2.1 선물 사이즈와 카테고리 presentation model
**Goal 실행 `P2-T1`:** API 없이도 Figma UI를 그릴 수 있는 선물 사이즈와 카테고리 상태 모델을 만든다.
- **시작 조건:** PRD `GIFT-UI-003`, `GIFT-UI-004`, `GIFT-UI-005`.
- **완료 증거:** 기본 선택, 미선택 style, placeholder 테스트 PASS.
- **범위 밖:** 실제 API DTO, endpoint, repository.
**Files:**
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestModels.kt`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenter.kt`
- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenterTest.kt`
**Interfaces:**
- Produces: `GiftSizeUiModel(id: String, title: String, description: String, pointText: String, selected: Boolean)`
- Produces: `GiftCategoryUiModel(id: String, name: String)`
- Produces: `GiftSendRequestPresenter.selectDefaultSize(sizes: List<GiftSizeUiModel>): List<GiftSizeUiModel>`
- Produces: `GiftSendRequestPresenter.categoryIdAt(position: Int, categories: List<GiftCategoryUiModel>): String?`
- [x] **RED:** size 목록 첫 번째 item이 selected 되는 테스트를 작성한다.
- [x] **RED:** selected size가 없으면 `hasBorder == false`에 해당하는 정책이 반환되는 테스트를 작성한다.
- [x] **RED:** Spinner position 0 sentinel은 null, 실제 category position은 해당 id를 반환하는 테스트를 작성한다.
- [x] **RED 확인:** focused test 실행으로 실패를 확인한다.
- [x] **GREEN:** 모델과 presenter 함수를 최소 구현한다.
- [x] **GREEN 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestPresenterTest"`를 실행해 PASS를 확인한다.
- [x] **REFACTOR:** 후속 API 연결을 위한 불필요한 abstraction을 만들지 않고 테스트 결과를 Progress에 기록한다.
#### Task 2.2 Form과 CTA enabled 정책
**Goal 실행 `P2-T2`:** 필수 입력과 동의 상태를 기준으로 CTA 활성/비활성을 계산한다.
- **시작 조건:** `P2-T1` 완료.
- **완료 증거:** 빈 상태 disabled, 입력 완료 상태 enabled 테스트 PASS.
- **범위 밖:** CTA 클릭 시 제출 API 호출.
**Files:**
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestModels.kt`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenter.kt`
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenterTest.kt`
**Interfaces:**
- Produces: `GiftSendFormState(senderName, phoneNumber, zoneCode, address, detailAddress, selectedSizeId, selectedCategoryId, termsAgreed, privacyAgreed, damageLossAgreed)`
- Produces: `GiftSendRequestPresenter.ctaState(formState): GiftSendCtaState`
- [x] **RED:** 모든 입력이 비어 있으면 CTA disabled인 테스트를 작성한다.
- [x] **RED:** 이름, 휴대폰 번호, 우편번호, 기본 주소, 상세 주소, size, category, 3개 동의가 모두 있으면 CTA enabled인 테스트를 작성한다.
- [x] **RED:** 파손 및 분실 면책 동의만 false이면 CTA disabled인 테스트를 작성한다.
- [x] **RED 확인:** focused test 실행으로 실패를 확인한다.
- [x] **GREEN:** `GiftSendFormState`, `GiftSendCtaState`, `ctaState()`를 최소 구현한다.
- [x] **GREEN 확인:** focused test를 다시 실행해 PASS를 확인한다.
- [x] **REFACTOR:** trim 처리 외 추가 validation을 넣지 않고 결과를 Progress에 기록한다.
검증 기록:
- 2026-10-01: size 기본 선택·border 정책·Spinner sentinel·필수 입력과 세 동의의 CTA 정책을 local unit test로 검증했다. `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*"`가 `BUILD SUCCESSFUL`로 통과했고, spec/quality review에서 차단 항목이 없었다.
### 완료 조건
- [x] `P2-T1`, `P2-T2`의 체크박스와 완료 증거가 모두 충족됐다.
- [x] 후속 API 없이도 UI shell이 사용할 상태 모델이 존재한다.
### 검증 방법
#### Phase 2 Gate
**Goal 실행 `P2-GATE`:** UI 상태 모델과 CTA 계산을 판정한다.
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestPresenterTest"
```
**Expected:** entry, size/category, CTA enabled 정책 테스트가 모두 PASS한다.
---
## Phase 3: XML UI와 Activity binding
**Phase 결과:** Figma 기준 선물 보내기 신청 화면 UI shell이 Android XML과 Activity에 표시된다.
**선행조건:** `P2-GATE` 완료.
**Phase 완료 조건:** `P3-T1`, `P3-T2`, `P3-T3`, `P3-GATE` 완료.
### 구현 항목
#### Task 3.1 정적 화면 레이아웃 작성
**Goal 실행 `P3-T1`:** Figma `gift_002` 구조에 맞춰 화면 섹션을 XML로 만든다.
- **시작 조건:** `P2-GATE` 완료.
- **완료 증거:** resource merge PASS.
- **범위 밖:** pixel-perfect 시각 QA, 동적 API 데이터.
**Files:**
- Modify: `app/src/main/res/layout/activity_gift_send_request.xml`
- Create possible: `app/src/main/res/drawable/bg_gift_send_*.xml`
- Modify: `app/src/main/res/values/strings.xml`
**Interfaces:**
- Consumes: Figma section inventory from PRD.
- Produces: ViewBinding ids for Activity binding.
- [x] **TDD 예외 사유:** XML 정적 layout은 로직 local unit test 대상이 아니며 layout 속성 직접 검증 테스트는 금지되어 있다.
- [x] **대체 검증 방법:** Figma section inventory와 XML을 read-only로 대조하고 `./gradlew :app:mergeDebugResources` 성공을 확인한다.
- [x] **GREEN:** top nav, 안내 배너, 받는 크리에이터, 선물 사이즈, 카테고리 Spinner, 보내는 사람 입력, 우편번호 검색 button, 이용 약관 동의, 하단 CTA를 XML에 작성한다.
- [x] **GREEN:** 기존 color/dimen/drawable을 우선 재사용하고, 대응되지 않는 배경만 `bg_gift_send_*`로 최소 생성한다.
- [x] **GREEN 확인:** `./gradlew :app:mergeDebugResources`를 실행해 PASS를 확인한다.
- [x] **REFACTOR:** unused resource와 중복 drawable을 제거하고 결과를 Progress에 기록한다.
#### Task 3.2 입력 watcher와 CTA binding 연결
**Goal 실행 `P3-T2`:** Activity에서 입력/선택/동의 변경 시 CTA enabled 스타일을 갱신한다.
- **시작 조건:** `P3-T1` 완료.
- **완료 증거:** compile PASS, presenter test 유지 PASS.
- **범위 밖:** CTA submit action, WebView 결과 반영.
**Files:**
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestActivity.kt`
**Interfaces:**
- Consumes: `GiftSendRequestPresenter.ctaState()`
- Produces: `bindCtaState(state: GiftSendCtaState)`
- [x] **TDD 예외 사유:** Activity binding 메서드 이름을 검사하는 source test는 동작 계약을 검증하지 않는다. CTA 정책은 `P2-T2` local unit test로 검증한다.
- [x] **대체 검증 방법:** Activity가 tested presenter를 호출하는지 read-only로 대조하고 Kotlin compile 성공을 확인한다.
- [x] **GREEN:** `addTextChangedListener`, checkbox click listener, Spinner selection listener로 `GiftSendFormState`를 갱신한다.
- [x] **GREEN:** CTA는 enabled 시 Figma 활성 색상, disabled 시 비활성 색상을 적용하고, 클릭 action은 이번 범위에서 no-op로 둔다.
- [x] **GREEN 확인:** focused test와 `./gradlew :app:compileDebugKotlin`을 실행해 PASS를 확인한다.
- [x] **REFACTOR:** Activity가 커지지 않도록 상태 계산은 presenter에만 유지하고 결과를 Progress에 기록한다.
#### Task 3.3 우편번호 검색 UI placeholder 연결
**Goal 실행 `P3-T3`:** 우편번호 검색 버튼과 직접 편집 불가 주소 필드 정책을 UI에 반영한다.
- **시작 조건:** `P3-T2` 완료.
- **완료 증거:** compile PASS, address field 직접 편집 불가 source 확인.
- **범위 밖:** Kakao WebView 실행, JavaScript bridge, 결과 반영.
**Files:**
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestActivity.kt`
- Modify: `app/src/main/res/layout/activity_gift_send_request.xml`
**Interfaces:**
- Produces: `setupPostcodeSearchPlaceholder()`
- [x] **TDD 예외 사유:** View 종류와 편집 가능 속성은 layout 속성 직접 검증 금지 범위다.
- [x] **대체 검증 방법:** 우편번호와 기본 주소가 field style의 `TextView`인지 read-only로 대조하고 resource merge 성공을 확인한다.
- [x] **GREEN:** 우편번호와 기본 주소 field는 직접 입력할 수 없게 하고, 우편번호 검색 버튼 click은 후속 구현 범위임을 코드 주석 한 문장으로 남기거나 no-op로 둔다.
- [x] **GREEN 확인:** focused test와 `./gradlew :app:compileDebugKotlin`을 실행해 PASS를 확인한다.
- [x] **REFACTOR:** 후속 WebView용 가짜 데이터나 mock fallback을 추가하지 않고 결과를 Progress에 기록한다.
#### Task 3.4 리뷰 문서 정합성 회귀 수정
**Goal 실행 `P3-R1`:** 최종 리뷰의 확정 Low 항목 `REV-P3-001`, `REV-P3-002`를 수정하고 구현·검증 기록의 추적성을 맞춘다.
- **시작 조건:** 최종 리뷰 승인과 문서 정합성 Low 항목 2건 확정.
- **대상 파일:** `prd.md`, `plan-task.md`, `reviews/phase3-gift-send-request-review.md`.
- **수정 범위:** 실제 테스트명과 제외된 수동 검증 표기 정정, 리뷰 보고서 생성과 PRD 링크 연결.
- **회귀 테스트:** 문서 내 잘못된 테스트명과 미완료 체크박스가 없는지 검색하고 `git diff --check`를 실행한다.
- **완료 증거:** 리뷰 보고서의 두 항목이 수정 완료이고 검색 및 diff check가 통과한다.
- **범위 밖:** production 코드, 테스트 로직, API·액션 범위 변경.
- [x] 잘못된 테스트명 참조를 실제 `GiftSendRequestPresenterTest`로 정정하고 수동 화면 확인을 제외 범위와 맞춘다.
- [x] Phase 3 리뷰 보고서를 생성하고 PRD의 관련 review에 연결한다.
- [x] 잘못된 테스트명·미완료 체크박스 검색과 `git diff --check`를 실행한다.
- [x] 수정 결과와 검증 증거를 기존 기록을 덮어쓰지 않고 누적한다.
### 완료 조건
- [x] `P3-T1`, `P3-T2`, `P3-T3`의 체크박스와 완료 증거가 모두 충족됐다.
- [x] UI shell은 API 없이 동작하고, 후속 action은 연결되지 않았다.
### 검증 방법
#### Phase 3 Gate
**Goal 실행 `P3-GATE`:** UI resource, Kotlin compile, local unit test를 판정한다.
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*"
./gradlew :app:mergeDebugResources
./gradlew :app:compileDebugKotlin
./gradlew :app:ktlintCheck
git diff --check
```
**Expected:** 모든 명령이 exit 0으로 종료된다. UI/계측 테스트와 스크린샷 검증은 실행하지 않는다.
---
## Phase 4: 크리에이터 채널 선물 보내기 진입 연결
**Phase 결과:** DM을 보낼 수 있는 비소유자 크리에이터 채널에서 선물 보내기 버튼이 표시되고, 터치 시 신규 `GiftSendRequestActivity`로 이동한다.
**선행조건:** `P3-GATE` 완료, 사용자 후속 요청으로 `GIFT-ENTRY-003` 제외 범위 supersede.
**Phase 완료 조건:** `P4-T1`, `P4-T2`, `P4-GATE` 완료.
### 구현 항목
#### Task 4.1 선물 보내기 버튼 노출 정책 구현
**Goal 실행 `P4-T1`:** 크리에이터 채널 선물 보내기 버튼 노출 조건을 순수 함수로 고정한다.
- **시작 조건:** PRD `GIFT-ENTRY-004`.
- **완료 증거:** 소유자/DM 가능 조합 local unit test PASS.
- **범위 밖:** 지역·언어 runtime gate, View visibility source test.
**Files:**
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/creator/channel/CreatorChannelActivity.kt`
- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/creator/channel/CreatorChannelGiftEligibilityTest.kt`
- [x] **RED:** 비소유자이면서 DM 가능이면 선물 보내기 가능인 테스트를 작성한다.
- [x] **RED:** DM 불가 또는 소유자이면 선물 보내기 불가인 테스트를 작성한다.
- [x] **RED 확인:** 신규 테스트가 helper 부재로 실패하는 것을 확인한다.
- [x] **GREEN:** `canSendCreatorGift(isOwner, isDmAvailable)`를 최소 구현한다.
- [x] **GREEN 확인:** focused test PASS를 확인한다.
#### Task 4.2 버튼 UI, 다국어 string, Activity 이동 연결
**Goal 실행 `P4-T2`:** DM 버튼 우측에 선물 보내기 버튼을 추가하고 `GiftSendRequestActivity`로 이동한다.
- **시작 조건:** `P4-T1` 완료.
- **완료 증거:** resource merge, Kotlin compile, 관련 local unit test PASS.
- **범위 밖:** API, 제출 action, Kakao WebView, 지역·언어 runtime gate.
**Files:**
- Modify: `app/src/main/res/layout/activity_creator_channel.xml`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/creator/channel/CreatorChannelActivity.kt`
- Modify: `app/src/main/res/values/strings.xml`
- Modify: `app/src/main/res/values-en/strings.xml`
- Modify: `app/src/main/res/values-ja/strings.xml`
- [x] **GREEN:** `tv_gift_send_button`을 `tv_dm_button` 우측에 동일 outline button 패턴으로 추가한다.
- [x] **GREEN:** `bindHeader()`에서 `canSendCreatorGift()` 결과로 버튼 표시를 갱신한다.
- [x] **GREEN:** 버튼 클릭 시 현재 header와 eligibility를 확인한 뒤 `GiftSendRequestActivity.newIntent()`로 이동한다.
- [x] **GREEN:** `gift_send_*` 문자열을 `values-en`, `values-ja`에도 추가한다.
- [x] **GREEN 확인:** focused test, resource merge, Kotlin compile을 실행해 PASS를 확인한다.
### 완료 조건
- [x] `P4-T1`, `P4-T2`의 체크박스와 완료 증거가 모두 충족됐다.
- [x] 소유자 DM 목록 버튼은 선물 보내기 버튼 노출 조건에 포함되지 않는다.
- [x] 지역·언어 gate는 추가하지 않았고 문자열 누락만 방지했다.
### 검증 방법
#### Phase 4 Gate
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.creator.channel.CreatorChannelGiftEligibilityTest" --tests "kr.co.vividnext.sodalive.v2.creator.channel.CreatorChannelActivitySourceTest" --tests "kr.co.vividnext.sodalive.v2.gift.*"
./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck
git diff --check
```
**Expected:** 모든 명령이 exit 0으로 종료된다. UI/계측 테스트와 스크린샷 검증은 실행하지 않는다.
---
## Phase 5: 선물 옵션 API, Kakao 우편번호, 제출 연결
**Phase 결과:** 화면 진입 시 선물 사이즈·카테고리를 API에서 불러오고, Kakao 우편번호 검색 결과로 주소를 등록한 뒤, 신청 성공 시 토스트 후 이전 화면으로 돌아간다.
**선행조건:** `P4-GATE` 완료, 사용자 후속 요청으로 API·주소검색·제출 범위 확정.
**Phase 완료 조건:** `P5-T1`, `P5-T2`, `P5-T3`, `P5-T4`, `P5-GATE` 완료.
### 구현 항목
#### Task 5.1 API DTO와 presentation mapper TDD
**Goal 실행 `P5-T1`:** form-options 응답을 기존 size/category UI 모델과 제출 request로 변환하는 순수 로직을 고정한다.
- **시작 조건:** PRD `11.1`, `11.2`, `DEC-006`, `DEC-007`.
- **완료 증거:** size 첫 항목 기본 선택, `SMALL` 설명, `salePriceCan` 표시, `requiresDamageWaiver` 조건, request body 매핑 local unit test PASS.
- **범위 밖:** Retrofit 호출, WebView 실행.
**Files:**
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftApi.kt`
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftModels.kt`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestModels.kt`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenter.kt`
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenterTest.kt`
- [x] **RED:** form-options size 첫 항목이 기본 선택되고 `SMALL` 설명과 `salePriceCan` 금액 문구가 만들어지는 실패 test를 작성한다.
- [x] **RED:** 카테고리의 `requiresDamageWaiver`가 UI 모델에 보존되고 false 선택 시 면책 동의가 제출 필수값에서 제외되는 실패 test를 작성한다.
- [x] **RED:** `GiftSendFormState`와 entry 정보가 `GiftCreateRequest` 필드로 정확히 매핑되는 실패 test를 작성한다.
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestPresenterTest"`를 실행해 신규 타입/동작 부재 실패를 확인한다.
- [x] **GREEN:** DTO, UI 모델 확장, mapper, request builder를 최소 구현한다.
- [x] **GREEN 확인:** 같은 focused test PASS를 확인한다.
- [x] **REFACTOR:** 이번 Task에서 만든 중복만 정리하고 결과를 Progress에 기록한다.
검증 기록:
- 2026-10-01: `GiftSendRequestPresenterTest`에 form-options mapper, 면책 조건 CTA, submit request 매핑 RED test를 추가했고, 신규 DTO/mapper 부재로 `compileDebugUnitTestKotlin FAILED`를 확인했다. 최소 구현 후 같은 focused test가 `BUILD SUCCESSFUL`로 통과했다.
#### Task 5.2 Gift API, Repository, ViewModel, DI 연결
**Goal 실행 `P5-T2`:** 기존 v2 Retrofit/RxJava/Koin 패턴으로 form-options 조회와 submit 호출 상태를 만든다.
- **시작 조건:** `P5-T1` 완료.
- **완료 증거:** fake API 기반 ViewModel local unit test PASS, DI compile PASS.
- **범위 밖:** Activity layout 재구성, WebView Activity.
**Files:**
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftRepository.kt`
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestViewModel.kt`
- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestViewModelTest.kt`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt`
- [x] **RED:** form-options 성공 시 UI options 상태가 채워지는 ViewModel 실패 test를 작성한다.
- [x] **RED:** form-options 실패 시 오류 toast 상태가 만들어지는 실패 test를 작성한다.
- [x] **RED:** submit 성공 시 성공 이벤트가 한 번만 소비되는 실패 test를 작성한다.
- [x] **RED:** submit 실패 시 화면 종료 이벤트 없이 오류 toast가 만들어지는 실패 test를 작성한다.
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestViewModelTest"`를 실행해 실패를 확인한다.
- [x] **GREEN:** `GiftApi`, `GiftRepository`, `GiftSendRequestViewModel`, DI 등록을 최소 구현한다.
- [x] **GREEN 확인:** 같은 focused test PASS를 확인한다.
- [x] **REFACTOR:** GET loading과 POST loading을 분리하고, 개인정보·토큰을 log로 남기지 않는지 대조한다.
검증 기록:
- 2026-10-01: `GiftSendRequestViewModelTest`를 추가하고 신규 API/Repository/ViewModel 부재로 `compileDebugUnitTestKotlin FAILED`를 확인했다. 최소 구현 후 같은 focused test가 `BUILD SUCCESSFUL`로 통과했다.
#### Task 5.3 Activity API 상태와 제출 액션 연결
**Goal 실행 `P5-T3`:** `GiftSendRequestActivity`가 options 상태를 렌더링하고 CTA 클릭 시 `POST /api/v2/gifts`를 호출한다.
- **시작 조건:** `P5-T2` 완료.
- **완료 증거:** Kotlin compile, presenter/viewModel test 유지 PASS.
- **범위 밖:** 새 성공 화면, 계측 UI 테스트.
**Files:**
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestActivity.kt`
- Modify: `app/src/main/res/layout/activity_gift_send_request.xml`
- Modify: `app/src/main/res/values/strings.xml`, `values-en/strings.xml`, `values-ja/strings.xml`
- [x] **TDD 예외 사유:** Activity observer wiring과 Toast/finish 자체는 local unit test에서 검증하지 않는다. 상태 계산과 submit 결과는 `P5-T1`, `P5-T2` local unit test로 검증한다.
- [x] **대체 검증 방법:** Activity가 tested ViewModel contract를 호출하는지 read-only 대조하고 compile/resource merge 성공을 확인한다.
- [x] **GREEN:** Activity에 Koin ViewModel을 주입하고 options loading/error/content 상태를 기존 UI에 바인딩한다.
- [x] **GREEN:** CTA click에서 현재 form state를 request로 만들고 ViewModel submit을 호출한다.
- [x] **GREEN:** submit 성공 이벤트 수신 시 성공 toast 후 `finish()`한다.
- [x] **GREEN 확인:** focused tests와 `./gradlew :app:mergeDebugResources :app:compileDebugKotlin` PASS를 확인한다.
검증 기록:
- 2026-10-01: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다. 기존 deprecation warning은 이번 변경과 무관하게 유지됐다.
#### Task 5.4 Kakao 우편번호 검색 Activity 연결
**Goal 실행 `P5-T4`:** Kakao 우편번호 가이드의 `embed()` 방식으로 주소 검색을 실행하고 결과를 선물 폼에 반환한다.
- **시작 조건:** `P5-T1` 완료.
- **완료 증거:** Kakao 결과 매핑 local unit test PASS, Manifest/resource compile PASS.
- **범위 밖:** 외부 지도 API, 주소 직접 입력, 계측 WebView 조작.
**Files:**
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/KakaoPostcodeSearchActivity.kt`
- Create: `app/src/main/res/layout/activity_kakao_postcode_search.xml`
- Modify: `app/src/main/AndroidManifest.xml`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestActivity.kt`
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenterTest.kt`
- [x] **RED:** Kakao `zonecode`, `userSelectedType`, `roadAddress`, `jibunAddress`, `address` 입력에서 제출용 우편번호·주소가 선택되는 실패 test를 작성한다.
- [x] **RED 확인:** focused presenter test 실패를 확인한다.
- [x] **GREEN:** `GiftSendRequestPresenter.toPostcodeResult()` 또는 동등 순수 mapper를 최소 구현한다.
- [x] **GREEN:** `KakaoPostcodeSearchActivity`는 WebView에 Kakao postcode script와 `new kakao.Postcode({ oncomplete }).embed(...)` HTML을 로드하고 Android bridge로 결과를 받는다.
- [x] **GREEN:** `GiftSendRequestActivity`는 `ActivityResultContracts.StartActivityForResult`로 검색 Activity를 열고 결과의 우편번호·주소를 read-only 필드에 채운 뒤 CTA 상태를 갱신한다.
- [x] **GREEN 확인:** focused test, resource merge, Kotlin compile PASS를 확인한다.
검증 기록:
- 2026-10-01: Kakao 우편번호 결과 mapper RED test를 추가하고 신규 타입/mapper 부재로 `compileDebugUnitTestKotlin FAILED`를 확인했다. 최소 구현 후 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다.
### 완료 조건
- [x] `P5-T1`~`P5-T4`의 체크박스와 완료 증거가 모두 충족됐다.
- [x] 주소는 Kakao 우편번호 검색 결과로만 등록되고 직접 입력 경로가 없다.
- [x] 성공 화면 없이 성공 토스트 후 화면이 종료된다.
### 검증 방법
#### Phase 5 Gate
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*"
./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck
git diff --check
```
**Expected:** 모든 명령이 exit 0으로 종료된다. UI/계측 테스트, 기기·에뮬레이터 WebView 조작, 스크린샷 검증은 실행하지 않는다.
---
## 실행 순서와 의존성
| 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 |
|---:|---|---|---|---|
| 1 | `P1-T1` | 없음 | 아니요 | PRD 진입 정책 보정 |
| 2 | `P1-T2` | `P1-T1` | 아니요 | Manifest/Activity 경계 재확인 |
| 3 | `P1-GATE` | Phase 1 Task 전체 | 아니요 | 실패 Task 회귀 수정 goal 생성 |
| 4 | `P2-T1` | `P1-GATE` | 아니요 | 모델 범위 보정 |
| 5 | `P2-T2` | `P2-T1` | 아니요 | CTA 필수값 정책 PRD 확인 |
| 6 | `P2-GATE` | Phase 2 Task 전체 | 아니요 | 실패 Task 회귀 수정 goal 생성 |
| 7 | `P3-T1` | `P2-GATE` | 아니요 | resource 누락 수정 |
| 8 | `P3-T2` | `P3-T1` | 아니요 | Activity 상태 binding 수정 |
| 9 | `P3-T3` | `P3-T2` | 아니요 | 후속 WebView 범위와 UI 범위 분리 |
| 10 | `P3-GATE` | Phase 3 Task 전체 | 아니요 | 실패 소유 Task 회귀 수정 goal 생성 |
| 11 | `P4-T1` | `P3-GATE` | 아니요 | 노출 정책 보정 |
| 12 | `P4-T2` | `P4-T1` | 아니요 | Activity 이동 연결 보정 |
| 13 | `P4-GATE` | Phase 4 Task 전체 | 아니요 | 실패 소유 Task 회귀 수정 goal 생성 |
| 14 | `P5-T1` | `P4-GATE` | 아니요 | API 계약과 mapper 보정 |
| 15 | `P5-T2` | `P5-T1` | 아니요 | ViewModel 상태 계약 보정 |
| 16 | `P5-T3` | `P5-T2` | 아니요 | Activity observer/action wiring 보정 |
| 17 | `P5-T4` | `P5-T1` | 일부 가능 | Kakao result 계약 보정 |
| 18 | `P5-GATE` | Phase 5 Task 전체 | 아니요 | 실패 소유 Task 회귀 수정 goal 생성 |
```text
P1-T1 -> P1-T2 -> P1-GATE -> P2-T1 -> P2-T2 -> P2-GATE -> P3-T1 -> P3-T2 -> P3-T3 -> P3-GATE -> P4-T1 -> P4-T2 -> P4-GATE -> P5-T1 -> P5-T2 -> P5-T3 -> P5-GATE
└-> P5-T4 -----------┘
```
## 변경 금지 항목
- 제공되지 않은 API endpoint, DTO, 제출 payload를 추정해 만들지 않는다. Phase 5에서 확정된 `/api/v2/gifts/*` 계약은 구현한다.
- 크리에이터 채널 실제 진입 버튼은 `P4`에서 확정한 DM 가능 비소유자 조건 외에는 연결하지 않는다.
- Kakao 우편번호 WebView 결과를 가짜 fixture로 production UI에 자동 반영하지 않는다.
- 레거시 파일을 직접 수정하지 않는다.
- 요청 범위 밖 리팩터링, dependency 추가, 공통 abstraction 확장을 하지 않는다.
- test를 삭제·skip·완화하거나 타입 오류를 우회하지 않는다.
- 크리에이터 회원번호, 이름, 휴대폰 번호, 주소를 log·fixture·문서에 실제 개인정보로 기록하지 않는다.
## 의사결정 및 중단 규칙
- PRD와 계획이 충돌하면 PRD Decision Log를 먼저 갱신한다.
- API·액션 연결 요구가 추가되면 `plan-task.md`에 후속 Phase를 추가한 뒤 구현한다.
- 레거시 코드 수정이 필요해 보이면 사용자 확인 전에는 중단한다.
- 구현 중 Figma와 기존 디자인 token이 충돌하면 기존 앱 token을 우선하고, 차이를 Progress에 기록한다.
## Progress
기존 기록을 삭제하거나 덮어쓰지 않고 실제 실행 결과를 차수별로 누적한다.
### 문서 작성 — 2026-10-01
- 상태: 완료
- 무엇을: PRD와 UI-only 구현 계획 초안을 생성했다.
- 왜: 사용자 요청이 구현 전 문서 생성과 모호한 부분 인터뷰였기 때문이다.
- 어떻게:
- Figma `2481:18904`, `2481:18957` metadata와 screenshot을 확인했다.
- Kakao 우편번호 가이드에서 WebView 기반 서비스는 팝업보다 `embed()` 방식이 권장됨을 확인했다.
- 신규 화면 단위는 사용자 답변에 따라 `Activity`로 결정했다.
- 남은 항목: 실제 구현 시 각 Task 체크박스 실행.
- 다음 행동: 사용자가 구현을 요청하면 `P1-T1`부터 시작한다.
### UI shell 구현 — 2026-10-01
- 상태: 완료
- 무엇을: 신규 `GiftSendRequestActivity`, Manifest 등록, Figma 섹션 기반 XML, size/category item, 입력·동의 watcher와 CTA binding을 구현했다.
- 어떻게:
- 잘못된 extra는 안내 메시지 후 종료하고, 유효한 닉네임은 수령 크리에이터 영역에 표시한다.
- production fixture 없이 size 빈 목록, category sentinel, CTA disabled 상태로 시작한다.
- 우편번호와 기본 주소는 read-only `TextView`, 상세 주소는 `EditText`로 구성했다.
- 기존 color/dimen/drawable을 우선 재사용하고 선택 border drawable 하나만 추가했다.
- 검증: gift package local unit test, resource merge, Kotlin compile, ktlint가 한 번의 fresh Gradle 실행에서 `BUILD SUCCESSFUL`로 통과했다. UI spec review와 code quality review도 차단 항목 없이 승인됐다.
- 남은 항목: API, 제출 action, Kakao 우편번호 WebView, 크리에이터 채널 진입 연결은 후속 범위다.
### 최종 리뷰 문서 정합성 수정 — 2026-10-01
- 상태: 완료
- 무엇을: `REV-P3-001`, `REV-P3-002`에 따라 PRD 추적표의 테스트명·수동 검증 표기를 정정하고 Phase 3 리뷰 보고서를 연결했다.
- 왜: 실제 구현·테스트·리뷰 증거와 문서 추적 정보를 일치시키기 위해서다.
- 어떻게: PRD 대상 잘못된 테스트명 검색, 미완료 체크박스 검색, `git diff --check`를 실행했다.
- 남은 항목: 없음.
### 크리에이터 채널 선물 보내기 진입 연결 — 2026-10-01
- 상태: 완료
- 무엇을: DM 가능 비소유자 크리에이터 채널의 DM 버튼 우측에 선물 보내기 버튼을 추가하고 `GiftSendRequestActivity`로 이동하도록 연결했다.
- 왜: 사용자가 크리에이터 채널에서 선물 보내기 신청 화면으로 실제 진입할 수 있어야 하기 때문이다.
- 어떻게:
- `canSendCreatorGift(isOwner, isDmAvailable)` 정책을 RED/GREEN local unit test로 고정했다.
- 기존 outline button 패턴을 재사용해 `tv_gift_send_button`을 추가했다.
- 버튼 클릭 시 현재 header와 eligibility를 재확인하고 `GiftSendRequestActivity.newIntent()`를 호출한다.
- 한국어 기본 문자열 외 `values-en`, `values-ja`에도 `gift_send_*` 번역을 추가했다.
- 검증: 신규 eligibility test는 helper 부재로 RED 실패 후 GREEN 통과했다. Phase 4 Gate Gradle 명령이 `BUILD SUCCESSFUL`로 통과했다.
- 리뷰: `reviews/phase4-creator-channel-gift-entry-review.md`에서 차단 항목 없이 승인됐다.
- 남은 항목: 지역·언어 runtime gate, API, 제출 action, Kakao WebView는 후속 범위다.
### API·Kakao 우편번호 연동 계획 추가 — 2026-10-01
- 상태: 진행 중
- 무엇을: 사용자 후속 요청에 따라 form-options 조회, submit, Kakao 우편번호 `embed()` 검색, 성공 토스트 후 종료를 Phase 5로 추가했다.
- 왜: 기존 UI-only 결정 중 API·액션·주소검색 제외 범위가 후속 요청으로 supersede됐기 때문이다.
- 어떻게:
- 기존 저장소에는 재사용 가능한 Daum/Kakao Postcode Activity 또는 WebView bridge가 없음을 확인했다.
- API 계층은 `HomeRecommendation`의 v2 Retrofit/RxJava/Koin 패턴을 재사용하기로 했다.
- 주소는 직접 입력 없이 Kakao 우편번호 검색 결과의 `zonecode`와 사용자 선택 주소만 read-only 필드에 반영하기로 했다.
- 남은 항목: `P5-T1` RED test부터 구현한다.
### Phase 5 Task 5.1 폼 도메인 TDD — 2026-10-01
- 상태: 완료
- 무엇을: form-options 응답을 size/category UI 모델로 변환하고, 카테고리 면책 조건과 submit request body 매핑을 구현했다.
- 검증: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestPresenterTest"`가 `BUILD SUCCESSFUL`로 통과했다.
- 남은 항목: API/Repository/ViewModel 연결은 `P5-T2`에서 진행한다.
### Phase 5 Task 5.2 API 계층 구현 — 2026-10-01
- 상태: 완료
- 무엇을: `GiftApi`, `GiftRepository`, `GiftSendRequestViewModel`, Koin DI 등록을 추가했다.
- 검증: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestViewModelTest"`가 `BUILD SUCCESSFUL`로 통과했다.
- 남은 항목: Activity options rendering, submit click, 성공 toast/finish 연결은 `P5-T3`에서 진행한다.
### Phase 5 Task 5.3 Activity 상태 연결 — 2026-10-01
- 상태: 완료
- 무엇을: `GiftSendRequestActivity`에 Koin ViewModel, form-options 렌더링, 카테고리별 면책 동의 표시, submit click, 성공 토스트 후 종료를 연결했다.
- 검증: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다.
- 남은 항목: Kakao 우편번호 검색 Activity와 결과 반환은 `P5-T4`에서 진행한다.
### Phase 5 Task 5.4 Kakao 우편번호 검색 연결 — 2026-10-01
- 상태: 완료
- 무엇을: Kakao 우편번호 `embed()` WebView Activity, JavaScript bridge, ActivityResult 결과 반영, 주소 결과 mapper를 추가했다.
- 검증: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다.
- 남은 항목: 없음.
### Phase 5 회귀 수정: form-options 응답 필드명 보정 — 2026-10-01
- 상태: 완료
- 원인: 실제 form-options 응답은 size 식별자를 `sizeCode`, category 식별자를 `categoryId`로 내려주는데, 기존 DTO는 `code`, `id`만 받아 `GiftSizeUiModel.id`에 null이 전달될 수 있었다.
- 수정: `GiftSizeResponse.code`에 `sizeCode` alias를, `GiftCategoryResponse.id`에 `categoryId` alias를 추가했다. code/id가 없는 항목은 제출 payload를 만들 수 없으므로 UI 옵션에서 제외한다. 응답에 포함된 `basePriceCan`도 DTO에 추가했다.
- 검증: 제공 JSON을 그대로 파싱하는 회귀 테스트를 추가했고 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다. `git diff --check`는 출력 없이 통과했다.
### Phase 5 회귀 수정: 입력 검증 UI와 로딩·CTA 보정 — 2026-10-01
- 상태: 완료
- 원인: Figma error state 기준으로 이름/휴대폰 입력 제한과 에러 UI가 추가로 확정됐다.
- 수정 범위: category dropdown placeholder와 실제 item 색상 분리, 이름 한글·영문·숫자 제한, 휴대폰 숫자 제한, 이름/휴대폰 error border와 안내 문구 표시 및 정상 입력 시 복구.
- 추가 수정 범위: form-options 조회와 신청 제출 중 `LoadingDialog` 표시, 활성 CTA 문구를 `{salePriceCan}캔으로 선물 보내기`로 보정.
- 검증: `GiftSendRequestPresenterTest`는 신규 validation API/state 부재로 RED compile 실패를 확인한 뒤 GREEN 통과했다. `GiftSendRequestViewModelTest`와 gift package 전체 테스트, resource merge, Kotlin compile, ktlint가 `BUILD SUCCESSFUL`로 통과했다.
### Phase 5 회귀 수정: 휴대폰 에러 문구 위치 보정 — 2026-10-01
- 상태: 완료
- 원인: `activity_gift_send_request.xml`에서 이름 label에 `tv_sender_name_support` ID가 붙고, 이름 input 아래 support TextView에 `tv_phone_number_support` ID가 붙어 휴대폰 에러 문구가 이름 input 아래에 표시됐다.
- 수정 범위: 이름/휴대폰 support TextView ID를 각 inputfield 바로 아래 TextView로 재배치한다.
- 검증: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다.
### Phase 5 회귀 수정: 입력 안내 문구 에러 상태 보정 — 2026-10-01
- 상태: 완료
- 원인: 에러 상태에서 Figma support 영역은 input 아래에 표시되어야 하며, 별도 에러 문구가 아니라 기존 안내 문구를 error color로 표시하는 정책으로 확정됐다.
- 수정 범위: 이름 error 시 `gift_send_name_description`, 휴대폰 error 시 `gift_send_phone_description`을 그대로 표시하고 error 색상/테두리만 적용한다. 미사용 error 전용 string은 제거한다.
- 검증: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다.
### Phase 5 회귀 수정: 입력 에러 전용 문구 복구 — 2026-10-01
- 상태: 완료
- 원인: 이전 요청의 기본 안내 문구는 support 위치를 특정하기 위한 설명이었고, 에러 상태 문구 자체는 기존 전용 문구가 맞았다.
- 수정 범위: support 위치는 input 아래로 유지하고, 이름 error 문구는 `한글, 영문, 숫자로만 작성해 주세요`, 휴대폰 error 문구는 `올바른 휴대폰 번호를 입력해 주세요`로 복구한다.
- 검증: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다.
### Phase 5 회귀 수정: 휴대폰 support ID 재배치 — 2026-10-01
- 상태: 완료
- 원인: 휴대폰 label TextView에 `tv_phone_number_support` ID가 붙어 Activity가 휴대폰 에러/안내 문구를 input 위 label 영역에 바인딩했다.
- 수정 범위: `tv_phone_number_support` ID를 휴대폰 inputfield 아래 support TextView로 이동한다.
- 검증: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다.
## Decision Log
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 |
|---|---|---|---|---|---|
| `2026-10-01` | `DEC-001` | 확정 | 이번 계획은 UI shell만 구현하고 API와 action 연결은 제외한다. | 사용자 명시 요청 | 전체 Phase |
| `2026-10-01` | `DEC-002` | 확정 | 화면 단위는 신규 `Activity`로 한다. | 사용자 인터뷰 답변 A | `P1-T2` |
| `2026-10-01` | `DEC-003` | 확정 | 우편번호 검색은 WebView 기반 후속 구현으로 남기고 이번에는 UI placeholder만 만든다. | UI-only 범위 | `P3-T3` |
| `2026-10-01` | `DEC-004` | 확정 | production UI에는 임의 size/category fixture를 넣지 않고 초기 disabled 상태를 유지하며, 활성 CTA는 순수 상태 테스트로 검증한다. | API·action 제외 범위와 TDD 검토 | `P2-T1`, `P2-T2`, `P3-T2` |
| `2026-10-01` | `DEC-005` | 확정 | 크리에이터 채널 진입 연결 제외는 후속 요청으로 supersede하고, DM 가능 비소유자 크리에이터에만 선물 보내기 버튼을 추가한다. | 사용자 후속 요청 | `P4-T1`, `P4-T2` |
| `2026-10-01` | `DEC-006` | 확정 | 주소는 직접 입력 없이 Kakao 우편번호 검색 `embed()` 결과로만 우편번호와 기본 주소를 등록한다. | 사용자 명시 요청과 Kakao 가이드 | `P5-T4` |
| `2026-10-01` | `DEC-007` | 확정 | 성공 화면은 만들지 않고 신청 성공 토스트 후 현재 화면을 종료한다. | 사용자 명시 요청 | `P5-T3` |
## 발견된 문제
| ID | 심각도 | 상태 | 발견 내용 | 영향 Goal | 처리 계획 |
|---|---|---|---|---|---|
| `ISSUE-001` | Low | 처리 | Figma는 iPhone 402px 기준이므로 Android 기기별 세부 spacing은 구현 시 기존 앱 token과 조정이 필요하다. | `P3-T1` | 기존 앱 color/dimen/drawable token을 우선 적용했다. 기기별 시각 QA는 요청 범위에서 제외했다. |
## Verification Log
- 2026-10-01: 문서 생성 작업이므로 Gradle 빌드/테스트는 실행하지 않았다. 실제 구현 시 Phase Gate 명령을 실행한다.
- 2026-10-01: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck`를 fresh 실행해 `BUILD SUCCESSFUL`을 확인했다. 기존 namespace 중복, deprecated API, `.editorconfig`의 `disabled_rules` deprecation 경고는 이번 변경과 무관한 경고로 유지했다.
- 2026-10-01: `P3-R1` 문서 수정 후 PRD에서 잘못된 테스트명 검색 결과 없음, plan-task 미완료 체크박스 검색 결과 없음, `git diff --check` 출력 없음을 확인했다.
- 2026-10-01: `CreatorChannelGiftEligibilityTest`를 먼저 실행해 `canSendCreatorGift` 미구현 compile 실패로 RED를 확인했다. 이후 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.creator.channel.CreatorChannelGiftEligibilityTest" --tests "kr.co.vividnext.sodalive.v2.creator.channel.CreatorChannelActivitySourceTest" --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck`가 `BUILD SUCCESSFUL`로 통과했다. 기존 `.editorconfig`의 `disabled_rules` deprecation 경고는 이번 변경과 무관한 경고로 유지했다.
- 2026-10-01: Phase 4 최종 read-only review에서 노출 조건, 기존 DM 동작 보존, 버튼 배치·스타일, Activity 이동, 다국어 string, 문서 정합성이 차단 항목 없이 승인됐다.
- 2026-10-01: Phase 5 Gate로 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck`를 fresh 실행해 `BUILD SUCCESSFUL`을 확인했다. `git diff --check`는 출력 없이 통과했다. 기존 `.editorconfig`의 `disabled_rules` deprecation 경고와 Android/Agora namespace warning은 이번 변경과 무관한 경고로 유지했다.
- 2026-10-01: 입력 검증 UI와 로딩·CTA 보정 후 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestPresenterTest"`, `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestViewModelTest"`, `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*"`, `./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck`가 모두 `BUILD SUCCESSFUL`로 통과했다. 기존 `.editorconfig`의 `disabled_rules` deprecation 경고는 이번 변경과 무관하게 유지됐다.
- 2026-10-01: 휴대폰 에러 문구 위치 보정 후 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다. 기존 Android/Agora namespace warning과 Gradle deprecation warning은 이번 변경과 무관하게 유지됐다.
- 2026-10-01: 입력 안내 문구 에러 상태 보정 후 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다. 기존 Android/Agora namespace warning과 Gradle/Kotlin deprecation warning은 이번 변경과 무관하게 유지됐다.
- 2026-10-01: 입력 에러 전용 문구 복구 후 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다. 기존 Gradle/Kotlin deprecation warning은 이번 변경과 무관하게 유지됐다.
- 2026-10-01: 휴대폰 support ID 재배치 후 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다. 기존 Android/Agora namespace warning과 Gradle deprecation warning은 이번 변경과 무관하게 유지됐다.
@@ -0,0 +1,305 @@
# PRD: 선물 보내기 신청 페이지
## 문서 정보
| 항목 | 내용 |
|---|---|
| 문서 상태 | 구현 기준 확정 |
| 작성일 | `2026-10-01` |
| 최종 수정일 | `2026-10-01` |
| 대상 제품 | 선물 보내기 신청 페이지 UI 및 신청 API 연동 |
| 작성자·결정권자 | 사용자 요청 기준 |
| 관련 API Contract | `GET /api/v2/gifts/form-options`, `POST /api/v2/gifts` |
| 관련 구현 계획 | `docs/20261001_선물_보내기_신청_페이지/plan-task.md` |
| 관련 review | `docs/20261001_선물_보내기_신청_페이지/reviews/phase3-gift-send-request-review.md`, `docs/20261001_선물_보내기_신청_페이지/reviews/phase4-creator-channel-gift-entry-review.md` |
### 요구사항 상태
| 상태 | 의미 | 구현 처리 |
|---|---|---|
| 확정 | 이번 UI 구현 기준으로 사용 | `plan-task.md`의 Task와 완료 증거로 추적 |
| 후속 | 다음 요청에서 API·액션 연결 시 확정 | UI shell에는 명시적 placeholder/disabled 상태만 반영 |
| 제외 | 이번 범위에서 구현하지 않음 | Decision Log에 제외 이유 기록 |
## 1. Overview
크리에이터 채널에서 특정 크리에이터에게 선물을 보내기 위한 신청 화면을 만든다. 기존 UI shell과 크리에이터 채널 진입 연결에 이어, 이번 후속 범위에서는 선물 폼 옵션 조회, Kakao 우편번호 검색 결과 반영, 신청 제출 API, 성공 토스트 후 뒤로가기를 연결한다.
## 2. Problem Statement
- 선물 보내기 신청 화면이 없어 크리에이터 채널에서 선물 전달 신청 흐름을 시작할 수 없다.
- 수령 크리에이터, 선물 사이즈, 카테고리, 보내는 사람 정보, 주소, 발송 규정 동의가 한 화면에서 입력되어야 한다.
- 주소는 자유 입력이 아니라 우편번호 검색을 통해서만 기본 주소와 우편번호를 등록해야 한다.
- 현재 Figma는 선택된 선물 사이즈 UI만 표현되어 있어, 미선택 상태의 라디오와 border 정책을 별도 요구사항으로 고정해야 한다.
문제를 해결했다는 판단은 Figma `2481:18904`, `2481:18957`의 비활성/활성 CTA 상태와 사용자 요구의 진입 조건·UI 상태가 구현 계획에 추적되는 것으로 한다.
## 3. Goals
### 3.1 제품 목표
- 크리에이터 채널에서 전달받은 수령 크리에이터 닉네임과 회원번호로 선물 보내기 신청 화면에 진입한다.
- DM을 보낼 수 있는 비소유자 크리에이터 채널에서는 DM 버튼 우측에 동일 패턴의 선물 보내기 버튼을 표시한다.
- 필수 진입 정보가 없거나 유효하지 않으면 “잘못된 접근입니다.” 메시지를 표시하고 화면을 종료한다.
- 선물 사이즈, 카테고리, 보내는 사람 정보, 주소, 동의 UI를 Figma 기준으로 표시한다.
- 모든 필수 UI 입력이 채워진 상태와 비어 있는 상태에 따라 CTA 활성/비활성 표시가 달라진다.
### 3.2 UX 목표
- 카테고리는 OS 기본 dropdown UI로 표시하고 미선택 시 `카테고리 선택` placeholder를 표시한다.
- 선물 사이즈는 접근 시 받아올 API 목록 중 첫 번째 항목이 기본 선택되는 정책을 UI 상태 모델에 반영한다.
- 선물 사이즈 미선택 상태는 라디오가 선택되지 않고 카드 border가 없는 상태로 표현할 수 있어야 한다.
- 파손 및 분실 면책 동의 UI는 이번 UI 구현에서 미리 노출한다.
- 주소 기본값과 우편번호는 우편번호 검색 결과로만 채워지고 사용자가 직접 수정할 수 없도록 계획한다.
## 4. Non-Goals
- 선물 신청 완료 전용 화면.
- 주소 직접 입력. 우편번호와 기본 주소는 Kakao 우편번호 검색 결과로만 등록한다.
- 레거시 코드 직접 수정.
- `app/src/androidTest` UI/계측 테스트, 기기·에뮬레이터 조작, 스크린샷 기반 시각 QA.
## 5. Target Users and Permissions
### 5.1 사용자
| 사용자 | 목표 | 주요 작업 | 사용 환경 |
|---|---|---|---|
| 크리에이터 채널 방문 사용자 | 특정 크리에이터에게 선물 신청 | 신청 정보 입력, 주소 검색, 약관 동의 | Android 앱 |
| Android 개발자 | 후속 API·액션 연결 전 UI shell 구현 | 신규 Activity와 presentation model 구현 | 로컬 개발 환경 |
### 5.2 권한
- 인증 주체: 기존 앱 로그인 사용자. 이번 UI 범위에서는 로그인 가드 신규 구현 없음.
- 허용 진입점: 크리에이터 채널에서 수령 크리에이터 닉네임과 회원번호를 전달하는 경로.
- 채널 버튼 노출 조건: 채널 소유자가 아니고 `isDmAvailable == true`인 크리에이터만 선물 보내기 버튼을 표시한다. 소유자의 DM 목록 버튼은 선물 보내기 조건에 포함하지 않는다.
- 지역/언어 운영 의도: 한국 접속·한국어 설정 사용자에게만 입장시킬 예정이나, 이번 구현은 런타임 지역/언어 gate를 추가하지 않고 string resource 누락 방지를 위해 `ko`, `en`, `ja` 문자열을 모두 제공한다.
- 거부 조건: 닉네임이 blank이거나 회원번호가 0 이하이면 잘못된 접근으로 처리한다.
- 잘못된 접근 처리: `Toast` 또는 기존 화면 메시지 패턴으로 “잘못된 접근입니다.”를 표시한 뒤 `finish()`한다.
## 6. 핵심 사용자 흐름
1. DM을 보낼 수 있는 비소유자 크리에이터 채널에서 사용자가 `선물 보내기` 버튼을 터치한다.
2. 앱은 현재 크리에이터 회원번호와 닉네임을 담아 `GiftSendRequestActivity`를 실행한다.
3. 앱은 Intent extra의 크리에이터 닉네임과 회원번호를 확인한다.
4. 값이 유효하지 않으면 “잘못된 접근입니다.”를 표시하고 화면을 종료한다.
5. 값이 유효하면 신규 선물 보내기 신청 `Activity`를 표시한다.
6. 화면은 안내 배너, 받는 크리에이터, 선물 사이즈, 카테고리, 보내는 사람, 이용 약관 동의, 하단 CTA를 표시한다.
7. 입력 전에는 CTA가 비활성이다.
8. 필수 입력과 필수 동의가 채워진 상태에서는 CTA가 활성 스타일로 표시된다.
9. CTA 클릭 동작과 API 제출은 후속 요청에서 연결한다.
## 7. 정보 구조와 라우팅
```text
CreatorChannelActivity
-> GiftSendRequestActivity
```
- 신규 화면 단위: `GiftSendRequestActivity`.
- Activity 위치: `kr.co.vividnext.sodalive.v2.gift` 하위.
- 진입 extra:
- `EXTRA_CREATOR_MEMBER_ID: Long`
- `EXTRA_CREATOR_NICKNAME: String`
- 후속 extra 후보:
- 프로필 이미지 URL은 이번 요구에서 필수로 확정하지 않는다. Figma의 프로필 이미지는 placeholder 또는 기존 프로필 로더 정책으로 대응한다.
## 8. 기능 요구사항
### 8.1 진입과 접근 가드
| ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 |
|---|---|---|---|---|
| `GIFT-ENTRY-001` | 확정 | 크리에이터 채널에서 신규 `GiftSendRequestActivity`로 진입할 수 있게 계획한다. | `newIntent(context, creatorMemberId, creatorNickname)`가 계획에 포함된다. | `P1-T1` |
| `GIFT-ENTRY-002` | 확정 | 닉네임 blank 또는 회원번호 0 이하이면 잘못된 접근으로 종료한다. | “잘못된 접근입니다.” 표시 후 `finish()`하는 테스트 계획이 있다. | `P1-T1` |
| `GIFT-ENTRY-003` | 확정 | DM을 보낼 수 있는 비소유자 크리에이터 채널에서 선물 보내기 버튼으로 실제 진입 액션을 연결한다. | DM 버튼 우측에 동일 패턴 버튼이 표시되고 `GiftSendRequestActivity.newIntent()`로 이동한다. | `P4-T2`, `DEC-005` |
| `GIFT-ENTRY-004` | 확정 | 선물 보내기 버튼 노출 조건은 소유자가 아니고 DM 가능 상태인 크리에이터로 제한한다. | `!isOwner && isDmAvailable` 정책이 local unit test로 검증된다. | `P4-T1` |
| `GIFT-I18N-001` | 확정 | 선물 보내기 화면 문자열은 기본 한국어 외 영어·일본어 resource에도 추가한다. | `values-en`, `values-ja`에 `gift_send_*` 키가 있어 resource merge 오류가 없다. | `P4-T2` |
### 8.2 화면 UI shell
| ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 |
|---|---|---|---|---|
| `GIFT-UI-001` | 확정 | Figma `gift_002` 비활성 CTA 화면을 기준으로 초기 상태 UI를 만든다. | 안내 배너, 수령 크리에이터, 사이즈, 카테고리, 보내는 사람, 이용 약관, 비활성 CTA가 표시된다. | `P2-T1`, `P3-GATE` |
| `GIFT-UI-002` | 확정 | Figma `gift_003` 활성 CTA 화면을 기준으로 입력 완료 상태 UI를 표현한다. | presentation model 테스트에서 모든 필수값 입력 시 CTA enabled가 true다. | `P2-T2` |
| `GIFT-UI-003` | 확정 | 선물 사이즈는 후속 API 목록의 첫 번째 항목이 기본 선택되는 정책으로 모델링한다. | local unit test의 입력 목록 첫 항목이 selected가 되고, production UI는 API 연결 전 빈 목록으로 시작한다. | `P2-T1` |
| `GIFT-UI-004` | 확정 | 선물 사이즈 미선택 상태는 라디오 미선택, border 없음으로 표현 가능해야 한다. | selected id가 없을 때 border 없는 style을 선택하는 mapper 테스트가 있다. | `P2-T1` |
| `GIFT-UI-005` | 확정 | 카테고리 미선택 시 `카테고리 선택` placeholder를 표시한다. | Spinner의 첫 sentinel 항목은 category id로 변환되지 않고 placeholder text로 표시된다. | `P2-T1` |
| `GIFT-UI-006` | 확정 | 카테고리는 OS 기본 dropdown UI로 계획한다. | Android `Spinner` 또는 기존 OS 기본 dropdown 패턴을 사용한다. | `P3-T1` |
| `GIFT-UI-007` | 확정 | 파손 및 분실 면책 동의 UI는 이번 UI 구현에서 항상 표시한다. | 카테고리와 무관하게 면책 동의 row가 렌더 대상이다. | `P2-T2` |
| `GIFT-UI-008` | 확정 | form-options 조회 또는 신청 제출 중 진행 상태를 알 수 있도록 `LoadingDialog`를 표시한다. | 조회 `Loading` 또는 제출 loading이 true이면 dialog를 표시하고 둘 다 종료되면 해제한다. | `P5-FOLLOWUP` |
### 8.3 보내는 사람과 주소 입력
| ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 |
|---|---|---|---|---|
| `GIFT-FORM-001` | 확정 | 보내는 사람 이름과 휴대폰 번호 입력 필드를 표시한다. | 비어 있으면 CTA disabled다. | `P2-T2` |
| `GIFT-FORM-002` | 확정 | 우편번호와 기본 주소는 우편번호 검색을 통해서만 등록 가능하도록 계획한다. | 우편번호/기본 주소 필드는 직접 편집 불가로 계획된다. | `P3-T2` |
| `GIFT-FORM-003` | 확정 | 상세 주소는 사용자가 직접 입력한다. | 상세 주소가 비어 있으면 CTA disabled다. | `P2-T2` |
| `GIFT-FORM-004` | 확정 | Kakao 우편번호 WebView 결과를 실제 필드에 반영한다. | Kakao 가이드의 `embed()` 방식으로 검색하고 `zonecode`, 사용자 선택 주소를 read-only 필드에 채운다. | `P5-T4`, `DEC-006` |
| `GIFT-FORM-005` | 확정 | 보내는 사람 이름은 한글·영문·숫자만 입력 가능하다. | 다른 문자가 있으면 `한글, 영문, 숫자로만 작성해 주세요` error state가 표시되고 CTA가 비활성이다. | `P5-FOLLOWUP` |
| `GIFT-FORM-006` | 확정 | 휴대폰 번호는 숫자만 입력 가능하며 11자리여야 한다. | 11자리가 아니면 `올바른 휴대폰 번호를 입력해 주세요` error state가 표시되고 CTA가 비활성이다. | `P5-FOLLOWUP` |
### 8.4 CTA와 동의
| ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 |
|---|---|---|---|---|
| `GIFT-CTA-001` | 확정 | 필수 입력이 비어 있으면 CTA는 비활성 스타일이다. | Figma `2481:18904` 상태와 대응된다. | `P2-T2`, `P3-GATE` |
| `GIFT-CTA-002` | 확정 | 필수 입력과 필수 동의가 충족되면 CTA는 활성 스타일이다. | Figma `2481:18957` 상태와 대응된다. | `P2-T2`, `P3-GATE` |
| `GIFT-CTA-003` | 확정 | CTA 클릭 시 신청 API를 호출한다. | 필수 입력·동의가 충족된 경우 `POST /api/v2/gifts`를 호출하고 성공 시 토스트 후 뒤로간다. | `P5-T3` |
| `GIFT-CTA-004` | 확정 | CTA 활성 시 선택된 선물 사이즈의 가격으로 `{salePriceCan}캔으로 선물 보내기`를 표시한다. | 선택 사이즈 가격이 80이면 CTA text는 `80캔으로 선물 보내기`다. | `P5-FOLLOWUP` |
| `GIFT-AGREE-001` | 확정 | “소다라이브 크리에이터 상품 전달 이용약관에 동의합니다.” 동의 row를 표시한다. | 체크 여부가 CTA enabled 계산에 포함된다. | `P2-T2` |
| `GIFT-AGREE-002` | 확정 | “상품 전달을 위한 개인정보 수집·이용에 동의합니다.” 동의 row를 표시한다. | 체크 여부가 CTA enabled 계산에 포함된다. | `P2-T2` |
| `GIFT-AGREE-003` | 확정 | “파손 및 분실 면책 사항에 동의합니다.” 동의 row를 미리 표시한다. | 카테고리와 무관하게 화면에 표시된다. | `P2-T2` |
## 9. UI/UX Expectations
### 9.1 Figma 기준
- 비활성 CTA: Figma `2481:18904`, `gift_002`.
- 활성 CTA: Figma `2481:18957`, `gift_003`.
- 화면 폭 기준: 402px iPhone frame을 Android XML에서 기존 dp/token으로 대응한다.
- 하단 CTA는 기존 bottom action bar 또는 신규 layout으로 구현하되 Figma처럼 화면 하단에 고정한다.
### 9.2 표시 섹션
- 상단 navigation: title `선물 보내기`, back button.
- 안내 배너: 선물 보내기 관련 안내 문구.
- 받는 크리에이터: 전달받은 크리에이터 닉네임과 프로필 placeholder.
- 선물 사이즈: 라디오형 size card, 설명, 비용/포인트 표기 영역.
- 카테고리: OS 기본 dropdown, placeholder `카테고리 선택`.
- 보내는 사람: 이름, 휴대폰 번호, 우편번호, 기본 주소, 상세 주소.
- 이용 약관 동의: 발송 규정 요약 box와 3개 동의 row.
### 9.3 접근성
- 모든 입력 필드는 visible label 또는 hint를 가져야 한다.
- 체크 row는 텍스트 터치로도 체크 상태가 바뀌도록 계획한다.
- CTA enabled/disabled는 색상뿐 아니라 `isEnabled` 상태로도 표현한다.
- 우편번호/기본 주소 직접 편집 불가 필드는 focus 정책을 명확히 한다.
## 10. Kakao 우편번호 요구사항
- 공식 가이드: `https://postcode.map.kakao.com/guide`.
- Kakao 우편번호 서비스는 별도 key 없이 사용할 수 있다.
- WebView 기반 서비스는 `window.open()` 팝업보다 `embed()` 방식이 권장된다.
- 후속 구현에서 `kakao.Postcode({ oncomplete })` 결과 중 최소 `zonecode`, 사용자 선택 주소를 사용한다.
- 이번 UI 범위에서는 WebView 화면 실행과 결과 반영을 구현하지 않고, 우편번호 검색 버튼과 직접 편집 불가 필드 상태만 만든다.
## 11. API 계약
### 11.1 폼 옵션 조회
- Method: `GET`
- Path: `/api/v2/gifts/form-options`
- 인증: 기존 v2 API와 동일한 `Authorization: Bearer <token>` header.
- 성공 envelope: 기존 `ApiResponse<T>`.
- `data.sizes`: 선물 사이즈 목록. 첫 번째 항목을 기본 선택한다.
- `data.categories`: 카테고리 목록. Spinner 0번은 기존 placeholder sentinel로 유지한다.
- size UI 매핑:
- `code` 또는 식별값은 제출 시 `sizeCode`로 사용한다.
- `name`은 카드 title로 표시한다.
- `salePriceCan`은 카드 가격과 CTA 금액에 사용한다.
- `SMALL` 설명은 `세 변의 합 100cm 이하 · 5kg 이하`로 표시한다.
- `MEDIUM`, `LARGE`는 서버 설명값이 없으면 설명을 비워 둔다.
- category UI 매핑:
- `id`는 제출 시 `categoryId`로 사용한다.
- `name`은 dropdown label로 표시한다.
- `requiresDamageWaiver == true`인 카테고리에서만 파손 및 분실 면책 동의 row를 표시한다.
### 11.2 선물 신청 제출
- Method: `POST`
- Path: `/api/v2/gifts`
- 인증: 기존 v2 API와 동일한 `Authorization: Bearer <token>` header.
- 성공 envelope: 기존 `ApiResponse<Any>` 패턴. 성공 판정은 `success == true` 기준이다.
- Request body:
- `recipientMemberId`: `GiftSendRequestActivity` 진입 시 받은 `memberId`.
- `senderName`
- `senderPhoneNumber`
- `senderZipCode`
- `senderAddress`
- `senderAddressDetail`
- `sizeCode`
- `categoryId`
- `senderTermsAgreed`
- `senderPrivacyAgreed`
- `damageWaiverAgreed`
- 성공 UX: 성공 토스트를 표시한 뒤 현재 화면을 종료한다.
- 실패 UX: 화면에 남아 기존 공통 오류 토스트 또는 서버 메시지를 표시한다.
- 진행 UX: form-options 조회와 신청 제출 중에는 기존 `LoadingDialog`를 표시한다.
## 12. 보안과 데이터 취급
- 크리에이터 회원번호, 보내는 사람 이름, 휴대폰 번호, 주소는 로그에 남기지 않는다.
- WebView에서 받은 주소 데이터는 후속 제출 전 화면 상태로만 보관한다.
- API endpoint, token, 개인정보를 Toast나 crash message에 직접 노출하지 않는다.
## 13. 성능과 품질 요구사항
- 신규 UI 구현은 `kr.co.vividnext.sodalive.v2.gift` 하위에 둔다.
- 신규 로직 테스트는 `app/src/test` local unit test로 한정한다.
- 레이아웃 속성 자체를 단위 테스트로 검증하지 않고, CTA 활성 정책·접근 가드·선택 상태 mapper 같은 순수 로직만 검증한다.
- 후속 API·WebView 구현 전에는 production fixture나 fallback mock을 두지 않는다.
## 14. 성공 기준
### 14.1 기능 수용 기준
- [ ] 유효한 extra로 신규 `GiftSendRequestActivity` UI shell이 표시된다.
- [ ] DM 가능 비소유자 크리에이터 채널에서 선물 보내기 버튼이 표시되고 신규 `Activity`로 이동한다.
- [ ] 유효하지 않은 extra는 “잘못된 접근입니다.” 표시 후 종료된다.
- [ ] 선물 사이즈 첫 항목 기본 선택과 미선택 스타일 정책이 presentation model에 반영된다.
- [ ] 카테고리 미선택 placeholder와 OS 기본 dropdown 계획이 반영된다.
- [ ] 필수 입력/동의 상태에 따라 CTA enabled가 계산된다.
### 14.2 UI/UX 수용 기준
- [ ] Figma 비활성 CTA 화면의 섹션 구조가 구현 계획과 일치한다.
- [ ] Figma 활성 CTA 화면의 입력 완료 상태가 presentation model로 재현된다.
- [ ] 파손 및 분실 면책 동의 row가 항상 표시된다.
- [ ] 우편번호/기본 주소 직접 편집 불가 정책이 반영된다.
### 14.3 추적성 완료 기준
- [ ] 모든 확정 요구사항이 `plan-task.md`의 Task에 연결된다.
- [ ] API·액션 후속 범위가 `EXT-*` 또는 Decision Log에 남아 있다.
- [ ] 제외 범위가 구현 계획에 포함되지 않는다.
## 15. Open Questions
| ID | 상태 | 결정 필요 사항 | 현재 권고 | 결정 주체 | 결정 기한/시점 | 영향 Goal |
|---|---|---|---|---|---|---|
| `OQ-001` | 확정 | 선물 사이즈·카테고리 API endpoint와 DTO | `GET /api/v2/gifts/form-options` 계약으로 연결 | 사용자/API 담당 | 2026-10-01 | `P5-T2` |
| `OQ-002` | 확정 | 카테고리별 면책 동의 UI 노출 조건 | `requiresDamageWaiver`가 true인 카테고리에서만 표시 | 사용자/API 담당 | 2026-10-01 | `P5-T2` |
| `OQ-003` | 확정 | 제출 API와 완료/실패 UX | `POST /api/v2/gifts` 성공 시 토스트 후 뒤로가기 | 사용자/API 담당 | 2026-10-01 | `P5-T3` |
## 16. 요구사항 추적표
| 요구사항 범위 | API Contract | 계획 Phase | Goal | 자동 검증 | 수동 검증 |
|---|---|---:|---|---|---|
| `GIFT-ENTRY-*` | 없음 | 1 | `P1-T1` | `GiftSendEntryPolicyTest` | 없음 |
| `GIFT-ENTRY-003`, `GIFT-ENTRY-004` | 없음 | 4 | `P4-T1`, `P4-T2` | `CreatorChannelGiftEligibilityTest` | 이번 범위에서 제외 |
| `GIFT-UI-*` | `EXT-001`, `EXT-002` 후속 | 2, 3 | `P2-T1`, `P2-T2`, `P3-T1`, `P3-GATE` | `GiftSendRequestPresenterTest` | 이번 범위에서 제외 |
| `GIFT-FORM-*` | `EXT-003` 후속 | 2, 3 | `P2-T2`, `P3-T2` | `GiftSendRequestPresenterTest` | 이번 범위에서 제외 |
| `GIFT-CTA-*`, `GIFT-AGREE-*` | `EXT-003` 후속 | 2, 3 | `P2-T2`, `P3-GATE` | `GiftSendRequestPresenterTest` | 이번 범위에서 제외 |
| `GIFT-API-*`, `GIFT-FORM-004`, `GIFT-CTA-003` | `/api/v2/gifts/*` | 5 | `P5-T1`~`P5-GATE` | `GiftSendRequestPresenterTest`, `GiftSendRequestViewModelTest` | 기기·에뮬레이터 실행 제외 |
| `GIFT-UI-008`, `GIFT-FORM-005`, `GIFT-FORM-006`, `GIFT-CTA-004` | `/api/v2/gifts/*` | 5 follow-up | `P5-FOLLOWUP` | `GiftSendRequestPresenterTest`, `GiftSendRequestViewModelTest` | 기기·에뮬레이터 실행 제외 |
## 17. Decision Log
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 요구사항·계약·Goal |
|---|---|---|---|---|---|
| `2026-10-01` | `DEC-001` | 확정 | 이번 작업은 UI만 만들고 API와 액션은 다음 요청에서 처리한다. | 사용자 명시 요청 | `GIFT-CTA-003`, `EXT-003` |
| `2026-10-01` | `DEC-002` | 확정 | 선물 보내기 신청 페이지는 신규 `Activity`로 계획한다. | 사용자 인터뷰 답변 A | `GIFT-ENTRY-001`, `P1-T1` |
| `2026-10-01` | `DEC-003` | 확정 | Kakao 우편번호 검색은 WebView 기반으로 계획하되 이번 범위에서는 버튼과 직접 편집 불가 필드 UI만 만든다. | 사용자 명시 요청과 UI-only 범위 | `GIFT-FORM-002`, `GIFT-FORM-004`, `P3-T2` |
| `2026-10-01` | `DEC-005` | 확정 | 이전의 크리에이터 채널 진입 연결 제외는 이번 후속 요청으로 supersede하고, DM 가능 비소유자 크리에이터에서만 선물 보내기 버튼을 노출한다. | 사용자 후속 요청 | `GIFT-ENTRY-003`, `GIFT-ENTRY-004`, `P4-T1`, `P4-T2` |
| `2026-10-01` | `DEC-006` | 확정 | 주소는 직접 입력 없이 Kakao 우편번호 검색 `embed()` 결과로만 우편번호와 기본 주소를 등록한다. | 사용자 명시 요청과 Kakao 가이드의 WebView 기반 서비스 권장 | `GIFT-FORM-002`, `GIFT-FORM-004`, `P5-T4` |
| `2026-10-01` | `DEC-007` | 확정 | 성공 화면은 만들지 않고 신청 성공 토스트 후 현재 화면을 종료한다. | 사용자 명시 요청 | `GIFT-CTA-003`, `P5-T3` |
| `2026-10-01` | `DEC-008` | 확정 | form-options 조회와 신청 제출 중 모두 `LoadingDialog`를 표시한다. | 사용자 후속 요청 | `GIFT-UI-008`, `P5-FOLLOWUP` |
## 18. 변경 관리
- API·액션 연결 범위가 추가되면 이 PRD의 `Open Questions`, `API 계약`, `Decision Log`를 먼저 갱신한다.
- 기존 완료 Task와 검증 기록은 삭제하지 않고 후속 Task를 추가한다.
- 레거시 코드 변경이 필요해 보이면 구현 전에 사용자 확인을 받는다.