diff --git a/app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendInputUi.kt b/app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendInputUi.kt new file mode 100644 index 00000000..782a1882 --- /dev/null +++ b/app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendInputUi.kt @@ -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 +) : ArrayAdapter(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)) + } +} diff --git a/app/src/main/res/drawable/bg_gift_send_input_error.xml b/app/src/main/res/drawable/bg_gift_send_input_error.xml new file mode 100644 index 00000000..ba7ab97c --- /dev/null +++ b/app/src/main/res/drawable/bg_gift_send_input_error.xml @@ -0,0 +1,8 @@ + + + + + + diff --git a/docs/20261001_선물_보내기_신청_페이지/plan-task.md b/docs/20261001_선물_보내기_신청_페이지/plan-task.md new file mode 100644 index 00000000..21d035e5 --- /dev/null +++ b/docs/20261001_선물_보내기_신청_페이지/plan-task.md @@ -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` 기반 Activity, `newIntent()`, invalid entry message/`finish()` 조기 반환을 구현한 뒤 Kotlin compile과 read-only 대조로 wiring을 확인한다. +- [x] **GREEN:** `BaseActivity` 기반 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): List` +- Produces: `GiftSendRequestPresenter.categoryIdAt(position: Int, categories: List): 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은 이번 변경과 무관하게 유지됐다. diff --git a/docs/20261001_선물_보내기_신청_페이지/prd.md b/docs/20261001_선물_보내기_신청_페이지/prd.md new file mode 100644 index 00000000..a233d618 --- /dev/null +++ b/docs/20261001_선물_보내기_신청_페이지/prd.md @@ -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 ` header. +- 성공 envelope: 기존 `ApiResponse`. +- `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 ` header. +- 성공 envelope: 기존 `ApiResponse` 패턴. 성공 판정은 `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를 추가한다. +- 레거시 코드 변경이 필요해 보이면 구현 전에 사용자 확인을 받는다.