Files
sodalive-android/docs/20261001_선물_보내기_신청_페이지/plan-task.md
T

65 KiB

선물 보내기 신청 페이지 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?

  • RED: creatorMemberId <= 0이면 toValidEntry()가 null을 반환하는 테스트를 작성한다.

  • RED: blank nickname이면 toValidEntry()가 null을 반환하는 테스트를 작성한다.

  • RED: 유효한 값이면 GiftSendEntry를 반환하는 테스트를 작성한다.

  • RED 확인: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendEntryPolicyTest"를 실행해 신규 타입 부재 또는 assertion 실패를 확인한다.

  • GREEN: GiftSendEntry, GiftSendRequestPresenter.toValidEntry()를 최소 구현한다. gift_send_invalid_access 문자열은 Activity resource Task에서 추가한다.

  • GREEN 확인: 같은 focused test를 다시 실행해 PASS를 확인한다.

  • 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()

  • TDD 예외 사유: Activity/Manifest wiring은 순수 입력/출력 로직이 아니며 source 문자열 테스트는 동작을 검증하지 않는다. 진입 판정은 P1-T1 local unit test로 검증한다.

  • 대체 검증 방법: BaseActivity<ActivityGiftSendRequestBinding> 기반 Activity, newIntent(), invalid entry message/finish() 조기 반환을 구현한 뒤 Kotlin compile과 read-only 대조로 wiring을 확인한다.

  • GREEN: BaseActivity<ActivityGiftSendRequestBinding> 기반 Activity, layout, newIntent(), invalid entry Toast.makeText(...).show(); finish()를 구현한다.

  • GREEN: Manifest에 GiftSendRequestActivity를 등록한다.

  • GREEN 확인: focused test와 ./gradlew :app:compileDebugKotlin을 실행해 PASS를 확인한다.

  • REFACTOR: Activity의 setup method를 bindEntry(), setupView() 수준으로만 정리하고 결과를 Progress에 기록한다.

완료 조건

  • P1-T1, P1-T2의 체크박스와 완료 증거가 모두 충족됐다.
  • invalid entry 정책이 PRD와 일치한다.

검증 방법

Phase 1 Gate

Goal 실행 P1-GATE: 신규 Activity 진입 정책과 shell 컴파일을 판정한다.

./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*"
./gradlew :app:compileDebugKotlin

Expected: 테스트와 Kotlin 컴파일이 exit 0으로 종료된다.


Phase 2: UI 상태 모델과 CTA 정책

Phase 결과: 선물 사이즈, 카테고리, 입력값, 동의값으로 CTA 활성 상태를 계산한다.

선행조건: P1-GATE 완료.

Phase 완료 조건: P2-T1, P2-T2, P2-GATE 완료.

구현 항목

Task 2.1 선물 사이즈와 카테고리 presentation model

Goal 실행 P2-T1: API 없이도 Figma UI를 그릴 수 있는 선물 사이즈와 카테고리 상태 모델을 만든다.

  • 시작 조건: PRD GIFT-UI-003, GIFT-UI-004, GIFT-UI-005.
  • 완료 증거: 기본 선택, 미선택 style, placeholder 테스트 PASS.
  • 범위 밖: 실제 API DTO, endpoint, repository.

Files:

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestModels.kt
  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenter.kt
  • Create: app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenterTest.kt

Interfaces:

  • Produces: GiftSizeUiModel(id: String, title: String, description: String, pointText: String, selected: Boolean)

  • Produces: GiftCategoryUiModel(id: String, name: String)

  • Produces: GiftSendRequestPresenter.selectDefaultSize(sizes: List<GiftSizeUiModel>): List<GiftSizeUiModel>

  • Produces: GiftSendRequestPresenter.categoryIdAt(position: Int, categories: List<GiftCategoryUiModel>): String?

  • RED: size 목록 첫 번째 item이 selected 되는 테스트를 작성한다.

  • RED: selected size가 없으면 hasBorder == false에 해당하는 정책이 반환되는 테스트를 작성한다.

  • RED: Spinner position 0 sentinel은 null, 실제 category position은 해당 id를 반환하는 테스트를 작성한다.

  • RED 확인: focused test 실행으로 실패를 확인한다.

  • GREEN: 모델과 presenter 함수를 최소 구현한다.

  • GREEN 확인: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestPresenterTest"를 실행해 PASS를 확인한다.

  • 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

  • RED: 모든 입력이 비어 있으면 CTA disabled인 테스트를 작성한다.

  • RED: 이름, 휴대폰 번호, 우편번호, 기본 주소, 상세 주소, size, category, 3개 동의가 모두 있으면 CTA enabled인 테스트를 작성한다.

  • RED: 파손 및 분실 면책 동의만 false이면 CTA disabled인 테스트를 작성한다.

  • RED 확인: focused test 실행으로 실패를 확인한다.

  • GREEN: GiftSendFormState, GiftSendCtaState, ctaState()를 최소 구현한다.

  • GREEN 확인: focused test를 다시 실행해 PASS를 확인한다.

  • 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에서 차단 항목이 없었다.

완료 조건

  • P2-T1, P2-T2의 체크박스와 완료 증거가 모두 충족됐다.
  • 후속 API 없이도 UI shell이 사용할 상태 모델이 존재한다.

검증 방법

Phase 2 Gate

Goal 실행 P2-GATE: UI 상태 모델과 CTA 계산을 판정한다.

./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.

  • TDD 예외 사유: XML 정적 layout은 로직 local unit test 대상이 아니며 layout 속성 직접 검증 테스트는 금지되어 있다.

  • 대체 검증 방법: Figma section inventory와 XML을 read-only로 대조하고 ./gradlew :app:mergeDebugResources 성공을 확인한다.

  • GREEN: top nav, 안내 배너, 받는 크리에이터, 선물 사이즈, 카테고리 Spinner, 보내는 사람 입력, 우편번호 검색 button, 이용 약관 동의, 하단 CTA를 XML에 작성한다.

  • GREEN: 기존 color/dimen/drawable을 우선 재사용하고, 대응되지 않는 배경만 bg_gift_send_*로 최소 생성한다.

  • GREEN 확인: ./gradlew :app:mergeDebugResources를 실행해 PASS를 확인한다.

  • 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)

  • TDD 예외 사유: Activity binding 메서드 이름을 검사하는 source test는 동작 계약을 검증하지 않는다. CTA 정책은 P2-T2 local unit test로 검증한다.

  • 대체 검증 방법: Activity가 tested presenter를 호출하는지 read-only로 대조하고 Kotlin compile 성공을 확인한다.

  • GREEN: addTextChangedListener, checkbox click listener, Spinner selection listener로 GiftSendFormState를 갱신한다.

  • GREEN: CTA는 enabled 시 Figma 활성 색상, disabled 시 비활성 색상을 적용하고, 클릭 action은 이번 범위에서 no-op로 둔다.

  • GREEN 확인: focused test와 ./gradlew :app:compileDebugKotlin을 실행해 PASS를 확인한다.

  • 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()

  • TDD 예외 사유: View 종류와 편집 가능 속성은 layout 속성 직접 검증 금지 범위다.

  • 대체 검증 방법: 우편번호와 기본 주소가 field style의 TextView인지 read-only로 대조하고 resource merge 성공을 확인한다.

  • GREEN: 우편번호와 기본 주소 field는 직접 입력할 수 없게 하고, 우편번호 검색 버튼 click은 후속 구현 범위임을 코드 주석 한 문장으로 남기거나 no-op로 둔다.

  • GREEN 확인: focused test와 ./gradlew :app:compileDebugKotlin을 실행해 PASS를 확인한다.

  • 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·액션 범위 변경.

  • 잘못된 테스트명 참조를 실제 GiftSendRequestPresenterTest로 정정하고 수동 화면 확인을 제외 범위와 맞춘다.

  • Phase 3 리뷰 보고서를 생성하고 PRD의 관련 review에 연결한다.

  • 잘못된 테스트명·미완료 체크박스 검색과 git diff --check를 실행한다.

  • 수정 결과와 검증 증거를 기존 기록을 덮어쓰지 않고 누적한다.

완료 조건

  • P3-T1, P3-T2, P3-T3의 체크박스와 완료 증거가 모두 충족됐다.
  • UI shell은 API 없이 동작하고, 후속 action은 연결되지 않았다.

검증 방법

Phase 3 Gate

Goal 실행 P3-GATE: UI resource, Kotlin compile, local unit test를 판정한다.

./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

  • RED: 비소유자이면서 DM 가능이면 선물 보내기 가능인 테스트를 작성한다.

  • RED: DM 불가 또는 소유자이면 선물 보내기 불가인 테스트를 작성한다.

  • RED 확인: 신규 테스트가 helper 부재로 실패하는 것을 확인한다.

  • GREEN: canSendCreatorGift(isOwner, isDmAvailable)를 최소 구현한다.

  • 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

  • GREEN: tv_gift_send_button을 tv_dm_button 우측에 동일 outline button 패턴으로 추가한다.

  • GREEN: bindHeader()에서 canSendCreatorGift() 결과로 버튼 표시를 갱신한다.

  • GREEN: 버튼 클릭 시 현재 header와 eligibility를 확인한 뒤 GiftSendRequestActivity.newIntent()로 이동한다.

  • GREEN: gift_send_* 문자열을 values-en, values-ja에도 추가한다.

  • GREEN 확인: focused test, resource merge, Kotlin compile을 실행해 PASS를 확인한다.

완료 조건

  • P4-T1, P4-T2의 체크박스와 완료 증거가 모두 충족됐다.
  • 소유자 DM 목록 버튼은 선물 보내기 버튼 노출 조건에 포함되지 않는다.
  • 지역·언어 gate는 추가하지 않았고 문자열 누락만 방지했다.

검증 방법

Phase 4 Gate

./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

  • RED: form-options size 첫 항목이 기본 선택되고 SMALL 설명과 salePriceCan 금액 문구가 만들어지는 실패 test를 작성한다.

  • RED: 카테고리의 requiresDamageWaiver가 UI 모델에 보존되고 false 선택 시 면책 동의가 제출 필수값에서 제외되는 실패 test를 작성한다.

  • RED: GiftSendFormState와 entry 정보가 GiftCreateRequest 필드로 정확히 매핑되는 실패 test를 작성한다.

  • RED 확인: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestPresenterTest"를 실행해 신규 타입/동작 부재 실패를 확인한다.

  • GREEN: DTO, UI 모델 확장, mapper, request builder를 최소 구현한다.

  • GREEN 확인: 같은 focused test PASS를 확인한다.

  • 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

  • RED: form-options 성공 시 UI options 상태가 채워지는 ViewModel 실패 test를 작성한다.

  • RED: form-options 실패 시 오류 toast 상태가 만들어지는 실패 test를 작성한다.

  • RED: submit 성공 시 성공 이벤트가 한 번만 소비되는 실패 test를 작성한다.

  • RED: submit 실패 시 화면 종료 이벤트 없이 오류 toast가 만들어지는 실패 test를 작성한다.

  • RED 확인: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestViewModelTest"를 실행해 실패를 확인한다.

  • GREEN: GiftApi, GiftRepository, GiftSendRequestViewModel, DI 등록을 최소 구현한다.

  • GREEN 확인: 같은 focused test PASS를 확인한다.

  • 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

  • TDD 예외 사유: Activity observer wiring과 Toast/finish 자체는 local unit test에서 검증하지 않는다. 상태 계산과 submit 결과는 P5-T1, P5-T2 local unit test로 검증한다.

  • 대체 검증 방법: Activity가 tested ViewModel contract를 호출하는지 read-only 대조하고 compile/resource merge 성공을 확인한다.

  • GREEN: Activity에 Koin ViewModel을 주입하고 options loading/error/content 상태를 기존 UI에 바인딩한다.

  • GREEN: CTA click에서 현재 form state를 request로 만들고 ViewModel submit을 호출한다.

  • GREEN: submit 성공 이벤트 수신 시 성공 toast 후 finish()한다.

  • 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

  • RED: Kakao zonecode, userSelectedType, roadAddress, jibunAddress, address 입력에서 제출용 우편번호·주소가 선택되는 실패 test를 작성한다.

  • RED 확인: focused presenter test 실패를 확인한다.

  • GREEN: GiftSendRequestPresenter.toPostcodeResult() 또는 동등 순수 mapper를 최소 구현한다.

  • GREEN: KakaoPostcodeSearchActivity는 WebView에 Kakao postcode script와 new kakao.Postcode({ oncomplete }).embed(...) HTML을 로드하고 Android bridge로 결과를 받는다.

  • GREEN: GiftSendRequestActivity는 ActivityResultContracts.StartActivityForResult로 검색 Activity를 열고 결과의 우편번호·주소를 read-only 필드에 채운 뒤 CTA 상태를 갱신한다.

  • 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로 통과했다.

완료 조건

  • P5-T1~P5-T4의 체크박스와 완료 증거가 모두 충족됐다.
  • 주소는 Kakao 우편번호 검색 결과로만 등록되고 직접 입력 경로가 없다.
  • 성공 화면 없이 성공 토스트 후 화면이 종료된다.

검증 방법

Phase 5 Gate

./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 생성
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<GiftCreateResponse>로 변경한다.

  • GREEN: ViewModel 성공 event와 Activity navigation을 기존 소비형 event·GiftDetailActivity.newIntent 패턴으로 최소 연결한다.

  • GREEN 확인: focused test PASS를 기록한다.

  • REFACTOR: DTO 전체를 Intent에 넣지 않고 applicationNo만 전달하며 기존 request body·loading·실패 시 form 유지 동작을 보존한다.

./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 상수를 추가하지 않는다.

./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를 먼저 추가한다.
./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

Phase 7: 크리에이터 프로필·파손 정책·채널 선물 버튼

Phase 결과: 크리에이터 채널에서 전달한 프로필 이미지를 선물 신청 화면에 표시하고, 파손 정책 링크를 외부 브라우저로 열며, 채널 선물 버튼에 승인된 아이콘·색상을 적용한다.

선행조건: 승인된 PRD DEC-024~DEC-026.

Phase 완료 조건: P7-T1~P7-T3, P7-GATE 완료, PRD와 Verification Log 갱신.

Task 7.1 프로필 URL 전달과 표시

Goal 실행 P7-T1: 크리에이터 채널의 header.profileImageUrl을 선물 신청 Intent에 전달하고 기존 Glide 패턴으로 표시한다.

Files:

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/creator/channel/CreatorChannelActivity.kt

  • 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/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt

  • RED: GiftSendRequestActivity.newIntent가 creator id, nickname, profile URL을 원본 그대로 전달하는 test를 추가한다.

  • RED: 신청 화면이 profile URL을 ImageView에 요청하고 URL이 없을 때 기존 placeholder를 유지하는 test를 추가한다.

  • RED 확인: profile extra와 image binding 부재로 실패함을 기록한다.

  • GREEN: 기존 Intent factory에 profile URL을 추가하고 채널 클릭에서 header.profileImageUrl을 넘긴다.

  • GREEN: 기존 이미지 로더를 재사용해 iv_creator_profile에 표시한다.

  • REFACTOR: 신규 image loader·wrapper·dependency를 만들지 않는다.

Task 7.2 파손 정책 외부 링크

Goal 실행 P7-T2: gift_send_damage_policy의 (자세히보기) 터치만 지정된 파손 정책 URL을 외부 브라우저로 연다.

Files:

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftAgreementLink.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/GiftNavigationTest.kt

  • RED: ACTION_VIEW와 https://app.notion.com/p/3f227b3596738018ba5dea2e5205293b를 검증하는 navigation test를 추가한다.

  • RED: 링크 터치 전후 form·약관·CTA 상태가 유지되는 test를 추가한다.

  • RED 확인: 전용 span/handler 부재로 실패함을 기록한다.

  • GREEN: 기존 GiftAgreementLink의 span·hit 영역 처리와 외부 Intent 패턴을 재사용한다.

  • REFACTOR: 전체 문구 클릭, WebView, 신규 화면을 추가하지 않는다.

Task 7.3 크리에이터 채널 선물 버튼 UI

Goal 실행 P7-T3: 선물 버튼에 ic_send_gift, 흰 배경, 검은 글자를 적용한다.

Files:

  • Modify: app/src/main/res/layout/activity_creator_channel.xml

  • Modify/Create only if needed: app/src/main/res/drawable/bg_creator_channel_gift_button.xml

  • tv_gift_send_button에 app:drawableStartCompat="@drawable/ic_send_gift"와 기존 버튼의 drawable padding을 적용한다.

  • 기존 bg_round_corner_999_white를 재사용하고 신규 drawable은 추가하지 않는다.

  • 사용자 추가 asset ic_send_gift.png를 수정하지 않는다.

  • 레이아웃 속성 직접 unit test는 작성하지 않고 resource merge로 검증한다.

Task 7.4 통합 Gate

Goal 실행 P7-GATE: Phase 7과 기존 선물 신청 흐름을 직렬 검증한다.

  • GiftNavigationTest focused test를 실행한다.
  • 전체 gift local unit test와 전체 local unit test를 실행한다.
  • resource merge, Kotlin compile, ktlint, debug assemble을 실행한다.
  • GIT_MASTER=1 git diff --check HEAD를 실행한다.
  • 실제 결과를 각 Task와 문서 하단 Verification Log에 기록한다.
  • 코드 리뷰 finding을 phase7-profile-damage-button-review.md에 기록하고 문서 정합성을 수정한다.
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --rerun
./gradlew :app:testDebugUnitTest --rerun
./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck
./gradlew :app:assembleDebug
GIT_MASTER=1 git diff --check HEAD

Task 7.5 파손 정책 (필수) 링크와 원형 프로필 후속 수정

Goal 실행 P7-T5: 파손 면책의 (자세히보기)를 제거하고 기존 (필수)로 정책 URL을 열며, 받는 크리에이터 프로필 이미지를 원형으로 표시한다.

Files:

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftAgreementLink.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/GiftNavigationTest.kt

  • RED: 파손 면책의 클릭 span이 (필수)이고 (자세히보기)가 없으며 기존 URL·폼·동의·CTA가 유지되는 test로 변경한다.

  • RED: 유효한 프로필 이미지 요청에 CircleCropTransformation이 적용되는 test를 추가한다.

  • RED 확인: 기존 (자세히보기) span과 원형 transformation 부재로 focused test가 실패함을 기록한다.

  • GREEN: setRequiredLink()를 파손 면책에도 재사용하고 사용처가 사라진 전용 링크 상수·함수를 제거한다.

  • GREEN: 기존 loadUrl 요청에 CircleCropTransformation만 추가해 URL·blank·placeholder/error 동작을 보존한다.

  • GREEN 확인: focused test와 gift package test를 실행해 PASS를 기록한다.

  • 회귀 검증: resource merge, Kotlin compile, ktlint, diff check 결과를 Verification Log에 누적한다.

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
2026-10-08 DEC-010 확정 크리에이터 채널의 header.profileImageUrl을 선물 신청 Intent로 전달해 기존 Glide 패턴으로 표시한다. 승인된 PRD DEC-024 P7-T1
2026-10-08 DEC-011 확정 파손 정책 (자세히보기)는 지정된 Notion URL을 외부 브라우저로 연다. 승인된 PRD DEC-025 P7-T2
2026-10-08 DEC-012 확정 크리에이터 채널 선물 버튼은 ic_send_gift, 흰 배경, 검은 글자를 사용한다. 승인된 PRD DEC-026 P7-T3
2026-10-08 DEC-013 정정 파손 정책 링크는 (자세히보기) 대신 기존 (필수)에 연결하고, 받는 크리에이터 프로필은 기존 Coil 요청에 원형 crop을 적용한다. 사용자 후속 요청과 권장안 승인 P7-T5

발견된 문제

ID 심각도 상태 발견 내용 영향 Goal 처리 계획
ISSUE-001 Low 처리 Figma는 iPhone 402px 기준이므로 Android 기기별 세부 spacing은 구현 시 기존 앱 token과 조정이 필요하다. P3-T1 기존 앱 color/dimen/drawable token을 우선 적용했다. 기기별 시각 QA는 요청 범위에서 제외했다.

Verification Log

  • 2026-10-08: P7-T5 RED에서 GiftNavigationTest 44개 중 파손 span과 프로필 transformation 관련 2개 실패를 확인했다. setRequiredLink() 재사용과 CircleCropTransformation 적용 후 같은 focused test가 BUILD SUCCESSFUL in 51s로 통과했다. 이어 gift package local unit test, resource merge, Kotlin compile, ktlint가 BUILD SUCCESSFUL in 43s로 통과했고 git diff --check HEAD도 무출력 통과했다. 기기·에뮬레이터·androidTest·시각 QA는 저장소 규칙에 따라 실행하지 않았다.

  • 2026-10-08: Phase 7 RED에서 profile extra/image binding 및 파손 정책 handler 부재 실패를 확인한 뒤 기존 Coil loadUrl과 GiftAgreementLink를 재사용해 GREEN을 확인했다. 최종 GiftNavigationTest는 BUILD SUCCESSFUL in 1m 25s, gift package는 BUILD SUCCESSFUL in 1m 34s, 전체 local unit suite는 BUILD SUCCESSFUL in 2m 23s였다. mergeDebugResources·compileDebugKotlin은 BUILD SUCCESSFUL in 3s, assembleDebug는 BUILD SUCCESSFUL in 8s, GIT_MASTER=1 git diff --check HEAD는 무출력 통과했다. ktlintCheck는 이번 변경 외 기존 audio_content 등 레거시 위반으로 실패했으며 변경 파일 위반은 보고되지 않았다. 기기·에뮬레이터·androidTest·시각 QA는 저장소 규칙에 따라 실행하지 않았다.

  • 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는 미실행이다.