# 선물 보내기 신청 페이지 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`로 통과했다. ## Phase 6: 신청 성공 상세 이동과 약관 외부 링크 **Phase 결과:** 신청 성공 응답을 typed DTO로 파싱해 유효한 신청번호의 상세 화면을 열고, 보내는 사람 이용약관·개인정보 문구에서 지정된 Notion 페이지를 외부 브라우저로 연다. **선행조건:** PRD `GIFT-CTA-005`, `GIFT-AGREE-004`, `DEC-009`, `DEC-011` 확정. **Phase 완료 조건:** `P6-T1`, `P6-T2`, `P6-GATE` 완료, PRD 14.4와 Verification Log 갱신. ### Task 6.1 typed 신청 응답과 상세 이동 **Goal 실행 `P6-T1`:** `POST /api/v2/gifts` 성공 payload의 신청번호를 보존하고 같은 번호의 `GiftDetailActivity`를 연다. **Files:** - Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftModels.kt` - Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftApi.kt` - Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestViewModel.kt` - Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestActivity.kt` - Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestViewModelTest.kt` - Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` - [ ] **RED:** 유효한 `GiftCreateResponse.applicationNo`가 성공 event에 포함되는 ViewModel test를 작성한다. - [ ] **RED:** `data=null` 또는 blank `applicationNo`에서 성공 event를 내보내지 않고 기존 오류 feedback을 유지하는 test를 작성한다. - [ ] **RED:** 성공 event 소비 시 같은 신청번호만 담은 `GiftDetailActivity` Intent를 만들고 신청 화면을 종료하는 navigation test를 작성한다. - [ ] **RED 확인:** focused test에서 typed 응답 또는 navigation event 부재 실패를 기록한다. - [ ] **GREEN:** `GiftCreateResponse`를 추가하고 `GiftApi.createGift()`를 `ApiResponse`로 변경한다. - [ ] **GREEN:** ViewModel 성공 event와 Activity navigation을 기존 소비형 event·`GiftDetailActivity.newIntent` 패턴으로 최소 연결한다. - [ ] **GREEN 확인:** focused test PASS를 기록한다. - [ ] **REFACTOR:** DTO 전체를 Intent에 넣지 않고 `applicationNo`만 전달하며 기존 request body·loading·실패 시 form 유지 동작을 보존한다. ```bash ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun ``` ### Task 6.2 보내는 사람 약관 외부 링크 **Goal 실행 `P6-T2`:** 이용약관과 개인정보 `(필수)` 터치를 분리하고 두 경로 모두 지정된 Notion URL을 외부 브라우저로 연다. **Files:** - Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestActivity.kt` - Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` - [ ] **RED:** 이용약관과 개인정보 handler가 각각 `ACTION_VIEW`와 정확한 Notion URL을 갖는 Intent를 만드는 navigation test를 작성한다. - [ ] **RED:** 링크 handler 실행 전후 form 동의 상태와 CTA 계산이 바뀌지 않는 test를 작성한다. - [ ] **RED 확인:** 전용 handler 또는 외부 Intent 부재 실패를 기록한다. - [ ] **GREEN:** 두 문구의 클릭 listener를 전용 함수로 분리하고 기존 `Intent(Intent.ACTION_VIEW, Uri.parse(URL))` 패턴을 재사용한다. - [ ] **GREEN 확인:** navigation focused test PASS를 기록한다. - [ ] **REFACTOR:** 신규 Activity, WebView, dependency, manifest 항목 또는 중복 URL 상수를 추가하지 않는다. ```bash ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun ``` ### Task 6.3 통합 Gate **Goal 실행 `P6-GATE`:** 신청 성공 이동·약관 링크와 기존 gift 기능을 직렬 검증한다. - [ ] gift package local unit test를 실행한다. - [ ] resource merge, Kotlin compile, ktlint, debug assemble을 실행한다. - [ ] `GIT_MASTER=1 git diff --check HEAD`를 실행한다. - [ ] PRD 14.4와 이 문서의 체크박스·Verification Log를 실제 증거로 갱신한다. - [ ] 코드 리뷰에서 확정 finding이 나오면 기존 완료 Task를 다시 열지 않고 `P6-R*` 회귀 수정 Task를 먼저 추가한다. ```bash ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --rerun ./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck ./gradlew :app:assembleDebug GIT_MASTER=1 git diff --check HEAD ``` ## 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` | | `2026-10-06` | `DEC-008` | 정정 | `DEC-007`을 대체하고 typed 성공 응답의 유효한 `applicationNo`로 상세를 연 뒤 신청 화면을 종료한다. | 승인된 PRD `DEC-009` | `P6-T1` | | `2026-10-06` | `DEC-009` | 확정 | 보내는 사람 이용약관·개인정보 터치는 모두 지정된 Notion URL을 외부 브라우저로 연다. | 승인된 PRD `DEC-011` | `P6-T2` | ## 발견된 문제 | 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은 이번 변경과 무관하게 유지됐다. - 2026-10-06: 승인된 PRD 후속 범위를 기준으로 `P6-T1` typed 신청 응답·상세 이동, `P6-T2` 약관 외부 링크, `P6-GATE` 계획을 추가했다. production/test/resource 코드는 아직 변경하지 않았고 RED/GREEN과 Gate는 미실행이다.