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

29 KiB

PRD: 선물 보내기 신청 페이지

문서 정보

항목 내용
문서 상태 구현 기준 확정
작성일 2026-10-01
최종 수정일 2026-10-08
대상 제품 선물 보내기 신청 페이지 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, docs/20261001_선물_보내기_신청_페이지/reviews/phase8-creator-channel-gift-eligibility-review.md

요구사항 상태

상태 의미 구현 처리
확정 이번 UI 구현 기준으로 사용 plan-task.md의 Task와 완료 증거로 추적
후속 다음 요청에서 API·액션 연결 시 확정 UI shell에는 명시적 placeholder/disabled 상태만 반영
제외 이번 범위에서 구현하지 않음 Decision Log에 제외 이유 기록

1. Overview

크리에이터 채널에서 특정 크리에이터에게 선물을 보내기 위한 신청 화면을 만든다. 기존 UI shell과 크리에이터 채널 진입 연결에 이어, 선물 폼 옵션 조회, Kakao 우편번호 검색 결과 반영, 신청 제출 API를 연결한다. 2026-10-06 후속 범위에서는 신청 성공 응답의 applicationNo로 신청 상세를 바로 열고, 이용약관·개인정보 터치 시 지정된 Notion 약관 페이지를 외부 브라우저로 연다. 2026-10-08 후속 범위에서는 크리에이터 프로필 이미지 URL을 신청 화면까지 전달해 표시하고, 파손 정책 링크와 크리에이터 채널의 선물 보내기 버튼 스타일을 보정한다.

2. Problem Statement

  • 선물 보내기 신청 화면이 없어 크리에이터 채널에서 선물 전달 신청 흐름을 시작할 수 없다.
  • 수령 크리에이터, 선물 사이즈, 카테고리, 보내는 사람 정보, 주소, 발송 규정 동의가 한 화면에서 입력되어야 한다.
  • 주소는 자유 입력이 아니라 우편번호 검색을 통해서만 기본 주소와 우편번호를 등록해야 한다.
  • 현재 Figma는 선택된 선물 사이즈 UI만 표현되어 있어, 미선택 상태의 라디오와 border 정책을 별도 요구사항으로 고정해야 한다.

문제를 해결했다는 판단은 Figma 2481:18904, 2481:18957의 비활성/활성 CTA 상태와 사용자 요구의 진입 조건·UI 상태가 구현 계획에 추적되는 것으로 한다.

3. Goals

3.1 제품 목표

  • 크리에이터 채널에서 전달받은 수령 크리에이터 닉네임과 회원번호로 선물 보내기 신청 화면에 진입한다.
  • DM을 보낼 수 있는 비소유자이면서 한국 접속·유효 언어가 한국어인 크리에이터 채널에서는 DM 버튼 우측에 동일 패턴의 선물 보내기 버튼을 표시한다.
  • 필수 진입 정보가 없거나 유효하지 않으면 “잘못된 접근입니다.” 메시지를 표시하고 화면을 종료한다.
  • 선물 사이즈, 카테고리, 보내는 사람 정보, 주소, 동의 UI를 Figma 기준으로 표시한다.
  • 모든 필수 UI 입력이 채워진 상태와 비어 있는 상태에 따라 CTA 활성/비활성 표시가 달라진다.
  • 크리에이터 채널에서 회원번호·닉네임과 함께 프로필 이미지 URL을 전달해 받는 크리에이터 영역에 표시한다.
  • 크리에이터 채널의 선물 보내기 버튼에 전용 아이콘을 표시하고 흰 배경·검은 글자 스타일을 적용한다.

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이며 GiftInboxEntryPolicy의 한국 접속·유효 언어 한국어 조건을 만족할 때만 선물 보내기 버튼을 표시한다. 소유자의 DM 목록 버튼은 선물 보내기 조건에 포함하지 않는다.
  • 지역/언어 운영 정책: SharedPreferenceManager.countryCode가 KR이고 LanguageManager.getEffectiveLanguage(context)가 ko일 때만 선물 보내기 버튼을 표시하고 진입을 허용한다. 빈 국가 코드는 기존 선물함 정책과 동일하게 KR로 처리한다.
  • 거부 조건: 닉네임이 blank이거나 회원번호가 0 이하이면 잘못된 접근으로 처리한다.
  • 잘못된 접근 처리: Toast 또는 기존 화면 메시지 패턴으로 “잘못된 접근입니다.”를 표시한 뒤 finish()한다.

6. 핵심 사용자 흐름

  1. DM을 보낼 수 있는 비소유자 크리에이터 채널에서 사용자가 선물 보내기 버튼을 터치한다.
  2. 앱은 현재 크리에이터 회원번호, 닉네임, 프로필 이미지 URL을 담아 GiftSendRequestActivity를 실행한다.
  3. 앱은 Intent extra의 크리에이터 닉네임과 회원번호를 확인한다.
  4. 값이 유효하지 않으면 “잘못된 접근입니다.”를 표시하고 화면을 종료한다.
  5. 값이 유효하면 신규 선물 보내기 신청 Activity를 표시한다.
  6. 화면은 안내 배너, 받는 크리에이터, 선물 사이즈, 카테고리, 보내는 사람, 이용 약관 동의, 하단 CTA를 표시한다.
  7. 입력 전에는 CTA가 비활성이다.
  8. 필수 입력과 필수 동의가 채워진 상태에서는 CTA가 활성 스타일로 표시된다.
  9. CTA를 누르면 신청 API를 호출한다.
  10. 성공 응답의 applicationNo가 유효하면 성공 toast를 표시하고 같은 번호의 GiftDetailActivity를 연 뒤 신청 화면을 종료한다.

7. 정보 구조와 라우팅

CreatorChannelActivity
  -> GiftSendRequestActivity
       -> GiftDetailActivity(applicationNo)
  • 신규 화면 단위: GiftSendRequestActivity.
  • Activity 위치: kr.co.vividnext.sodalive.v2.gift 하위.
  • 진입 extra:
    • EXTRA_CREATOR_MEMBER_ID: Long
    • EXTRA_CREATOR_NICKNAME: String
    • EXTRA_CREATOR_PROFILE_IMAGE_URL: String?
  • 프로필 이미지 URL이 blank이면 기존 빈 이미지 표시 정책을 유지하며 잘못된 접근으로 처리하지 않는다.

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 && GiftInboxEntryPolicy.shouldShow(countryCode, languageCode) 정책이 local unit test로 검증된다. P4-T1, P8-T1
GIFT-ENTRY-005 확정 크리에이터 채널에서 프로필 이미지 URL을 선물 보내기 화면으로 전달한다. GiftSendRequestActivity Intent가 header.profileImageUrl을 보존하고 받는 크리에이터 이미지에 원형으로 표시한다. blank URL과 기존 placeholder/error 정책은 유지한다. P7-T1, P7-T5
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
GIFT-UI-009 확정 크리에이터 채널의 선물 보내기 버튼은 ic_send_gift를 문구 왼쪽에 표시하고 흰 배경·검은 글자를 사용한다. 기존 버튼의 노출·클릭 정책은 유지하고 지정된 아이콘·배경·글자색만 적용된다. P7-T2

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를 호출한다. 성공 후 이동은 GIFT-CTA-005가 대체한다. P5-T3, P6-T1
GIFT-CTA-004 확정 CTA 활성 시 선택된 선물 사이즈의 가격으로 {salePriceCan}캔으로 선물 보내기를 표시한다. 선택 사이즈 가격이 80이면 CTA text는 80캔으로 선물 보내기다. P5-FOLLOWUP
GIFT-CTA-005 확정 신청 성공 시 응답의 applicationNo로 신청 상세를 바로 연다. 유효한 신청번호에서 GiftDetailActivity가 같은 번호로 실행되고 신청 화면은 종료된다. 데이터가 없거나 신청번호가 blank이면 상세를 열지 않고 오류 feedback을 표시한다. P6-T1
GIFT-AGREE-001 확정 “소다라이브 크리에이터 상품 전달 이용약관에 동의합니다.” 동의 row를 표시한다. 체크 여부가 CTA enabled 계산에 포함된다. P2-T2
GIFT-AGREE-002 확정 “상품 전달을 위한 개인정보 수집·이용에 동의합니다.” 동의 row를 표시한다. 체크 여부가 CTA enabled 계산에 포함된다. P2-T2
GIFT-AGREE-003 확정 “파손 및 분실 면책 사항에 동의합니다.” 동의 row를 미리 표시한다. 카테고리와 무관하게 화면에 표시된다. P2-T2
GIFT-AGREE-004 정정 이용약관과 개인정보 (필수) 터치 처리를 각각 전용 함수로 분리한다. 두 함수 모두 ACTION_VIEW로 https://app.notion.com/p/3eb27b359673802b937ae741ab7b4ad3을 열고 기존 체크 상태 계산을 유지한다. P6-T2
GIFT-AGREE-005 정정 파손 및 분실 면책 동의의 (필수) 터치 시 파손 정책 동의서를 연다. (자세히보기)는 표시하지 않고 ACTION_VIEW로 https://app.notion.com/p/3f227b3596738018ba5dea2e5205293b을 열며 체크 상태와 CTA 계산은 바뀌지 않는다. P7-T2, P7-T5

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.
  • 안내 배너: 선물 보내기 관련 안내 문구.
  • 받는 크리에이터: 전달받은 크리에이터 닉네임과 원형 프로필 이미지. URL이 blank이면 기존 빈 이미지 정책을 사용한다.
  • 선물 사이즈: 라디오형 size card, 설명, 비용/포인트 표기 영역.
  • 카테고리: OS 기본 dropdown, placeholder 카테고리 선택.
  • 보내는 사람: 이름, 휴대폰 번호, 우편번호, 기본 주소, 상세 주소.
  • 이용 약관 동의: 발송 규정 요약 box와 3개 동의 row.

9.3 접근성

  • 모든 입력 필드는 visible label 또는 hint를 가져야 한다.
  • 체크 row는 텍스트 터치로도 체크 상태가 바뀌도록 계획한다.
  • CTA enabled/disabled는 색상뿐 아니라 isEnabled 상태로도 표현한다.
  • 우편번호/기본 주소 직접 편집 불가 필드는 focus 정책을 명확히 한다.

10. Kakao 우편번호 요구사항

  • 공식 가이드: https://postcode.map.kakao.com/guide.
  • Kakao 우편번호 서비스는 별도 key 없이 사용할 수 있다.
  • WebView 기반 서비스는 window.open() 팝업보다 embed() 방식이 권장된다.
  • 후속 구현에서 kakao.Postcode({ oncomplete }) 결과 중 최소 zonecode, 사용자 선택 주소를 사용한다.
  • 이번 UI 범위에서는 WebView 화면 실행과 결과 반영을 구현하지 않고, 우편번호 검색 버튼과 직접 편집 불가 필드 상태만 만든다.

11. API 계약

11.1 폼 옵션 조회

  • Method: GET
  • Path: /api/v2/gifts/form-options
  • 인증: 기존 v2 API와 동일한 Authorization: Bearer <token> header.
  • 성공 envelope: 기존 ApiResponse<T>.
  • data.sizes: 선물 사이즈 목록. 첫 번째 항목을 기본 선택한다.
  • data.categories: 카테고리 목록. Spinner 0번은 기존 placeholder sentinel로 유지한다.
  • size UI 매핑:
    • code 또는 식별값은 제출 시 sizeCode로 사용한다.
    • name은 카드 title로 표시한다.
    • salePriceCan은 카드 가격과 CTA 금액에 사용한다.
    • SMALL 설명은 세 변의 합 100cm 이하 · 5kg 이하로 표시한다.
    • MEDIUM, LARGE는 서버 설명값이 없으면 설명을 비워 둔다.
  • category UI 매핑:
    • id는 제출 시 categoryId로 사용한다.
    • name은 dropdown label로 표시한다.
    • requiresDamageWaiver == true인 카테고리에서만 파손 및 분실 면책 동의 row를 표시한다.

11.2 선물 신청 제출

  • Method: POST
  • Path: /api/v2/gifts
  • 인증: 기존 v2 API와 동일한 Authorization: Bearer <token> header.
  • 성공 envelope: ApiResponse<GiftCreateResponse>.
  • data: applicationNo: String, status: String, statusName: String, priceCan: Int, trackingDeadlineAt: String.
  • Request body:
    • recipientMemberId: GiftSendRequestActivity 진입 시 받은 memberId.
    • senderName
    • senderPhoneNumber
    • senderZipCode
    • senderAddress
    • senderAddressDetail
    • sizeCode
    • categoryId
    • senderTermsAgreed
    • senderPrivacyAgreed
    • damageWaiverAgreed
  • 성공 UX: success == true, data != null, applicationNo가 blank가 아닐 때 성공 토스트를 표시하고 같은 신청번호의 상세를 연 뒤 현재 화면을 종료한다.
  • 성공 envelope가 유효하지 않으면 상세를 열거나 화면을 종료하지 않고 기존 오류 feedback을 표시한다.
  • 실패 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에 남아 있다.
  • 제외 범위가 구현 계획에 포함되지 않는다.

14.4 신청 성공 상세 이동과 약관 함수

  • 신청 성공 응답을 typed DTO로 파싱한다.
  • 유효한 applicationNo로 GiftDetailActivity를 열고 신청 화면을 종료한다.
  • 성공 응답 data 누락 또는 blank 신청번호에서는 상세를 열지 않는다.
  • 이용약관과 개인정보 (필수) 터치 함수가 분리되고 두 함수 모두 지정된 Notion URL을 열며 체크 상태 동작은 유지된다.

14.5 Phase 7 프로필 이미지·파손 정책·채널 버튼

  • 크리에이터 채널의 프로필 이미지 URL이 선물 보내기 Intent에 보존된다.
  • 선물 보내기 상단에 전달받은 프로필 이미지가 원형으로 표시되고 blank URL은 안전하게 빈 이미지로 처리된다.
  • 파손 및 분실 면책 (필수) 터치가 전용 파손 정책 URL을 열고 체크 상태를 변경하지 않으며 (자세히보기)는 표시하지 않는다.
  • 크리에이터 채널 선물 보내기 버튼에 ic_send_gift가 문구 왼쪽에 표시되며 배경은 흰색, 글자는 검은색이다.

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-06 P5-T3, P6-T1

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 기기·에뮬레이터 실행 제외
GIFT-CTA-005, GIFT-AGREE-004 POST /api/v2/gifts typed response 6 P6-T1, P6-T2, P6-GATE GiftSendRequestViewModelTest, GiftNavigationTest Figma·source 대조
GIFT-ENTRY-005, GIFT-UI-009, GIFT-AGREE-005 없음 7 P7-T1, P7-T2, P7-T3, P7-T5, P7-GATE GiftSendEntryPolicyTest, GiftNavigationTest source/resource 대조
GIFT-ENTRY-004 지역·언어 gate 없음 8 P8-T1, P8-GATE CreatorChannelGiftEligibilityTest, GiftInboxEntryPolicyTest source 대조

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
2026-10-06 DEC-009 정정 DEC-007의 성공 후 단순 종료를 대체하고, 성공 응답의 applicationNo로 신청 상세를 연 뒤 신청 화면을 종료한다. 사용자 제공 성공 응답 계약과 승인된 접근안 A GIFT-CTA-005, P6-T1
2026-10-06 DEC-010 확정 선물 전용 약관 route가 제공되기 전에는 이용약관·개인정보 터치 함수만 분리하고 실제 이동은 구현하지 않는다. 사용자 선택 “함수만 분리” GIFT-AGREE-004, P6-T2
2026-10-06 DEC-011 정정 DEC-010을 대체하고 이용약관·개인정보 터치 시 모두 지정된 Notion URL을 외부 브라우저로 연다. 사용자 제공 URL과 후속 명시 요청 GIFT-AGREE-004, P6-T2
2026-10-08 DEC-012 확정 크리에이터 프로필 이미지 URL은 선택 extra로 전달하고 blank URL은 진입 거부 조건에 포함하지 않는다. 사용자 후속 요청과 기존 이미지 로더의 blank 처리 정책 GIFT-ENTRY-005, P7-T1
2026-10-08 DEC-013 확정 파손 및 분실 면책 (자세히보기)는 기존 공통 약관 URL이 아니라 별도 파손 정책 Notion URL을 연다. 사용자 제공 URL과 승인된 Phase 7 계획 GIFT-AGREE-005, P7-T3
2026-10-08 DEC-014 확정 사용자가 추가한 ic_send_gift, ic_gift_info와 수정한 선물 레이아웃 2개를 최신 기준으로 보존한다. 사용자 명시 요청 GIFT-UI-009, Phase 7 전체
2026-10-08 DEC-015 정정 DEC-013의 (자세히보기) 링크를 제거하고 파손 및 분실 면책의 기존 (필수)를 같은 파손 정책 URL 링크로 사용한다. 사용자 후속 요청과 권장안 승인 GIFT-AGREE-005, P7-T5
2026-10-08 DEC-016 확정 선물 보내기 화면의 받는 크리에이터 프로필 이미지에 기존 Coil 원형 crop 패턴을 적용한다. 사용자 후속 요청 GIFT-ENTRY-005, P7-T5
2026-10-08 DEC-017 정정 DEC-005의 버튼 노출 조건에 기존 GiftInboxEntryPolicy를 재사용해 한국 접속·유효 언어 한국어 조건을 추가하고, 표시와 클릭 진입에 동일하게 적용한다. 사용자 후속 요청 GIFT-ENTRY-004, P8-T1, P8-GATE

18. 변경 관리

  • API·액션 연결 범위가 추가되면 이 PRD의 Open Questions, API 계약, Decision Log를 먼저 갱신한다.
  • 기존 완료 Task와 검증 기록은 삭제하지 않고 후속 Task를 추가한다.
  • 레거시 코드 변경이 필요해 보이면 구현 전에 사용자 확인을 받는다.