# PRD: 선물 보내기 신청 페이지 ## 문서 정보 | 항목 | 내용 | |---|---| | 문서 상태 | 구현 기준 확정 | | 작성일 | `2026-10-01` | | 최종 수정일 | `2026-10-06` | | 대상 제품 | 선물 보내기 신청 페이지 UI 및 신청 API 연동 | | 작성자·결정권자 | 사용자 요청 기준 | | 관련 API Contract | `GET /api/v2/gifts/form-options`, `POST /api/v2/gifts` | | 관련 구현 계획 | `docs/20261001_선물_보내기_신청_페이지/plan-task.md` | | 관련 review | `docs/20261001_선물_보내기_신청_페이지/reviews/phase3-gift-send-request-review.md`, `docs/20261001_선물_보내기_신청_페이지/reviews/phase4-creator-channel-gift-entry-review.md` | ### 요구사항 상태 | 상태 | 의미 | 구현 처리 | |---|---|---| | 확정 | 이번 UI 구현 기준으로 사용 | `plan-task.md`의 Task와 완료 증거로 추적 | | 후속 | 다음 요청에서 API·액션 연결 시 확정 | UI shell에는 명시적 placeholder/disabled 상태만 반영 | | 제외 | 이번 범위에서 구현하지 않음 | Decision Log에 제외 이유 기록 | ## 1. Overview 크리에이터 채널에서 특정 크리에이터에게 선물을 보내기 위한 신청 화면을 만든다. 기존 UI shell과 크리에이터 채널 진입 연결에 이어, 선물 폼 옵션 조회, Kakao 우편번호 검색 결과 반영, 신청 제출 API를 연결한다. 2026-10-06 후속 범위에서는 신청 성공 응답의 `applicationNo`로 신청 상세를 바로 열고, 이용약관·개인정보 터치 시 지정된 Notion 약관 페이지를 외부 브라우저로 연다. ## 2. Problem Statement - 선물 보내기 신청 화면이 없어 크리에이터 채널에서 선물 전달 신청 흐름을 시작할 수 없다. - 수령 크리에이터, 선물 사이즈, 카테고리, 보내는 사람 정보, 주소, 발송 규정 동의가 한 화면에서 입력되어야 한다. - 주소는 자유 입력이 아니라 우편번호 검색을 통해서만 기본 주소와 우편번호를 등록해야 한다. - 현재 Figma는 선택된 선물 사이즈 UI만 표현되어 있어, 미선택 상태의 라디오와 border 정책을 별도 요구사항으로 고정해야 한다. 문제를 해결했다는 판단은 Figma `2481:18904`, `2481:18957`의 비활성/활성 CTA 상태와 사용자 요구의 진입 조건·UI 상태가 구현 계획에 추적되는 것으로 한다. ## 3. Goals ### 3.1 제품 목표 - 크리에이터 채널에서 전달받은 수령 크리에이터 닉네임과 회원번호로 선물 보내기 신청 화면에 진입한다. - DM을 보낼 수 있는 비소유자 크리에이터 채널에서는 DM 버튼 우측에 동일 패턴의 선물 보내기 버튼을 표시한다. - 필수 진입 정보가 없거나 유효하지 않으면 “잘못된 접근입니다.” 메시지를 표시하고 화면을 종료한다. - 선물 사이즈, 카테고리, 보내는 사람 정보, 주소, 동의 UI를 Figma 기준으로 표시한다. - 모든 필수 UI 입력이 채워진 상태와 비어 있는 상태에 따라 CTA 활성/비활성 표시가 달라진다. ### 3.2 UX 목표 - 카테고리는 OS 기본 dropdown UI로 표시하고 미선택 시 `카테고리 선택` placeholder를 표시한다. - 선물 사이즈는 접근 시 받아올 API 목록 중 첫 번째 항목이 기본 선택되는 정책을 UI 상태 모델에 반영한다. - 선물 사이즈 미선택 상태는 라디오가 선택되지 않고 카드 border가 없는 상태로 표현할 수 있어야 한다. - 파손 및 분실 면책 동의 UI는 이번 UI 구현에서 미리 노출한다. - 주소 기본값과 우편번호는 우편번호 검색 결과로만 채워지고 사용자가 직접 수정할 수 없도록 계획한다. ## 4. Non-Goals - 선물 신청 완료 전용 화면. - 주소 직접 입력. 우편번호와 기본 주소는 Kakao 우편번호 검색 결과로만 등록한다. - 레거시 코드 직접 수정. - `app/src/androidTest` UI/계측 테스트, 기기·에뮬레이터 조작, 스크린샷 기반 시각 QA. ## 5. Target Users and Permissions ### 5.1 사용자 | 사용자 | 목표 | 주요 작업 | 사용 환경 | |---|---|---|---| | 크리에이터 채널 방문 사용자 | 특정 크리에이터에게 선물 신청 | 신청 정보 입력, 주소 검색, 약관 동의 | Android 앱 | | Android 개발자 | 후속 API·액션 연결 전 UI shell 구현 | 신규 Activity와 presentation model 구현 | 로컬 개발 환경 | ### 5.2 권한 - 인증 주체: 기존 앱 로그인 사용자. 이번 UI 범위에서는 로그인 가드 신규 구현 없음. - 허용 진입점: 크리에이터 채널에서 수령 크리에이터 닉네임과 회원번호를 전달하는 경로. - 채널 버튼 노출 조건: 채널 소유자가 아니고 `isDmAvailable == true`인 크리에이터만 선물 보내기 버튼을 표시한다. 소유자의 DM 목록 버튼은 선물 보내기 조건에 포함하지 않는다. - 지역/언어 운영 의도: 한국 접속·한국어 설정 사용자에게만 입장시킬 예정이나, 이번 구현은 런타임 지역/언어 gate를 추가하지 않고 string resource 누락 방지를 위해 `ko`, `en`, `ja` 문자열을 모두 제공한다. - 거부 조건: 닉네임이 blank이거나 회원번호가 0 이하이면 잘못된 접근으로 처리한다. - 잘못된 접근 처리: `Toast` 또는 기존 화면 메시지 패턴으로 “잘못된 접근입니다.”를 표시한 뒤 `finish()`한다. ## 6. 핵심 사용자 흐름 1. DM을 보낼 수 있는 비소유자 크리에이터 채널에서 사용자가 `선물 보내기` 버튼을 터치한다. 2. 앱은 현재 크리에이터 회원번호와 닉네임을 담아 `GiftSendRequestActivity`를 실행한다. 3. 앱은 Intent extra의 크리에이터 닉네임과 회원번호를 확인한다. 4. 값이 유효하지 않으면 “잘못된 접근입니다.”를 표시하고 화면을 종료한다. 5. 값이 유효하면 신규 선물 보내기 신청 `Activity`를 표시한다. 6. 화면은 안내 배너, 받는 크리에이터, 선물 사이즈, 카테고리, 보내는 사람, 이용 약관 동의, 하단 CTA를 표시한다. 7. 입력 전에는 CTA가 비활성이다. 8. 필수 입력과 필수 동의가 채워진 상태에서는 CTA가 활성 스타일로 표시된다. 9. CTA를 누르면 신청 API를 호출한다. 10. 성공 응답의 `applicationNo`가 유효하면 성공 toast를 표시하고 같은 번호의 `GiftDetailActivity`를 연 뒤 신청 화면을 종료한다. ## 7. 정보 구조와 라우팅 ```text CreatorChannelActivity -> GiftSendRequestActivity -> GiftDetailActivity(applicationNo) ``` - 신규 화면 단위: `GiftSendRequestActivity`. - Activity 위치: `kr.co.vividnext.sodalive.v2.gift` 하위. - 진입 extra: - `EXTRA_CREATOR_MEMBER_ID: Long` - `EXTRA_CREATOR_NICKNAME: String` - 후속 extra 후보: - 프로필 이미지 URL은 이번 요구에서 필수로 확정하지 않는다. Figma의 프로필 이미지는 placeholder 또는 기존 프로필 로더 정책으로 대응한다. ## 8. 기능 요구사항 ### 8.1 진입과 접근 가드 | ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 | |---|---|---|---|---| | `GIFT-ENTRY-001` | 확정 | 크리에이터 채널에서 신규 `GiftSendRequestActivity`로 진입할 수 있게 계획한다. | `newIntent(context, creatorMemberId, creatorNickname)`가 계획에 포함된다. | `P1-T1` | | `GIFT-ENTRY-002` | 확정 | 닉네임 blank 또는 회원번호 0 이하이면 잘못된 접근으로 종료한다. | “잘못된 접근입니다.” 표시 후 `finish()`하는 테스트 계획이 있다. | `P1-T1` | | `GIFT-ENTRY-003` | 확정 | DM을 보낼 수 있는 비소유자 크리에이터 채널에서 선물 보내기 버튼으로 실제 진입 액션을 연결한다. | DM 버튼 우측에 동일 패턴 버튼이 표시되고 `GiftSendRequestActivity.newIntent()`로 이동한다. | `P4-T2`, `DEC-005` | | `GIFT-ENTRY-004` | 확정 | 선물 보내기 버튼 노출 조건은 소유자가 아니고 DM 가능 상태인 크리에이터로 제한한다. | `!isOwner && isDmAvailable` 정책이 local unit test로 검증된다. | `P4-T1` | | `GIFT-I18N-001` | 확정 | 선물 보내기 화면 문자열은 기본 한국어 외 영어·일본어 resource에도 추가한다. | `values-en`, `values-ja`에 `gift_send_*` 키가 있어 resource merge 오류가 없다. | `P4-T2` | ### 8.2 화면 UI shell | ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 | |---|---|---|---|---| | `GIFT-UI-001` | 확정 | Figma `gift_002` 비활성 CTA 화면을 기준으로 초기 상태 UI를 만든다. | 안내 배너, 수령 크리에이터, 사이즈, 카테고리, 보내는 사람, 이용 약관, 비활성 CTA가 표시된다. | `P2-T1`, `P3-GATE` | | `GIFT-UI-002` | 확정 | Figma `gift_003` 활성 CTA 화면을 기준으로 입력 완료 상태 UI를 표현한다. | presentation model 테스트에서 모든 필수값 입력 시 CTA enabled가 true다. | `P2-T2` | | `GIFT-UI-003` | 확정 | 선물 사이즈는 후속 API 목록의 첫 번째 항목이 기본 선택되는 정책으로 모델링한다. | local unit test의 입력 목록 첫 항목이 selected가 되고, production UI는 API 연결 전 빈 목록으로 시작한다. | `P2-T1` | | `GIFT-UI-004` | 확정 | 선물 사이즈 미선택 상태는 라디오 미선택, border 없음으로 표현 가능해야 한다. | selected id가 없을 때 border 없는 style을 선택하는 mapper 테스트가 있다. | `P2-T1` | | `GIFT-UI-005` | 확정 | 카테고리 미선택 시 `카테고리 선택` placeholder를 표시한다. | Spinner의 첫 sentinel 항목은 category id로 변환되지 않고 placeholder text로 표시된다. | `P2-T1` | | `GIFT-UI-006` | 확정 | 카테고리는 OS 기본 dropdown UI로 계획한다. | Android `Spinner` 또는 기존 OS 기본 dropdown 패턴을 사용한다. | `P3-T1` | | `GIFT-UI-007` | 확정 | 파손 및 분실 면책 동의 UI는 이번 UI 구현에서 항상 표시한다. | 카테고리와 무관하게 면책 동의 row가 렌더 대상이다. | `P2-T2` | | `GIFT-UI-008` | 확정 | form-options 조회 또는 신청 제출 중 진행 상태를 알 수 있도록 `LoadingDialog`를 표시한다. | 조회 `Loading` 또는 제출 loading이 true이면 dialog를 표시하고 둘 다 종료되면 해제한다. | `P5-FOLLOWUP` | ### 8.3 보내는 사람과 주소 입력 | ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 | |---|---|---|---|---| | `GIFT-FORM-001` | 확정 | 보내는 사람 이름과 휴대폰 번호 입력 필드를 표시한다. | 비어 있으면 CTA disabled다. | `P2-T2` | | `GIFT-FORM-002` | 확정 | 우편번호와 기본 주소는 우편번호 검색을 통해서만 등록 가능하도록 계획한다. | 우편번호/기본 주소 필드는 직접 편집 불가로 계획된다. | `P3-T2` | | `GIFT-FORM-003` | 확정 | 상세 주소는 사용자가 직접 입력한다. | 상세 주소가 비어 있으면 CTA disabled다. | `P2-T2` | | `GIFT-FORM-004` | 확정 | Kakao 우편번호 WebView 결과를 실제 필드에 반영한다. | Kakao 가이드의 `embed()` 방식으로 검색하고 `zonecode`, 사용자 선택 주소를 read-only 필드에 채운다. | `P5-T4`, `DEC-006` | | `GIFT-FORM-005` | 확정 | 보내는 사람 이름은 한글·영문·숫자만 입력 가능하다. | 다른 문자가 있으면 `한글, 영문, 숫자로만 작성해 주세요` error state가 표시되고 CTA가 비활성이다. | `P5-FOLLOWUP` | | `GIFT-FORM-006` | 확정 | 휴대폰 번호는 숫자만 입력 가능하며 11자리여야 한다. | 11자리가 아니면 `올바른 휴대폰 번호를 입력해 주세요` error state가 표시되고 CTA가 비활성이다. | `P5-FOLLOWUP` | ### 8.4 CTA와 동의 | ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 | |---|---|---|---|---| | `GIFT-CTA-001` | 확정 | 필수 입력이 비어 있으면 CTA는 비활성 스타일이다. | Figma `2481:18904` 상태와 대응된다. | `P2-T2`, `P3-GATE` | | `GIFT-CTA-002` | 확정 | 필수 입력과 필수 동의가 충족되면 CTA는 활성 스타일이다. | Figma `2481:18957` 상태와 대응된다. | `P2-T2`, `P3-GATE` | | `GIFT-CTA-003` | 정정 | CTA 클릭 시 신청 API를 호출한다. | 필수 입력·동의가 충족된 경우 `POST /api/v2/gifts`를 호출한다. 성공 후 이동은 `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` | ## 9. UI/UX Expectations ### 9.1 Figma 기준 - 비활성 CTA: Figma `2481:18904`, `gift_002`. - 활성 CTA: Figma `2481:18957`, `gift_003`. - 화면 폭 기준: 402px iPhone frame을 Android XML에서 기존 dp/token으로 대응한다. - 하단 CTA는 기존 bottom action bar 또는 신규 layout으로 구현하되 Figma처럼 화면 하단에 고정한다. ### 9.2 표시 섹션 - 상단 navigation: title `선물 보내기`, back button. - 안내 배너: 선물 보내기 관련 안내 문구. - 받는 크리에이터: 전달받은 크리에이터 닉네임과 프로필 placeholder. - 선물 사이즈: 라디오형 size card, 설명, 비용/포인트 표기 영역. - 카테고리: OS 기본 dropdown, placeholder `카테고리 선택`. - 보내는 사람: 이름, 휴대폰 번호, 우편번호, 기본 주소, 상세 주소. - 이용 약관 동의: 발송 규정 요약 box와 3개 동의 row. ### 9.3 접근성 - 모든 입력 필드는 visible label 또는 hint를 가져야 한다. - 체크 row는 텍스트 터치로도 체크 상태가 바뀌도록 계획한다. - CTA enabled/disabled는 색상뿐 아니라 `isEnabled` 상태로도 표현한다. - 우편번호/기본 주소 직접 편집 불가 필드는 focus 정책을 명확히 한다. ## 10. Kakao 우편번호 요구사항 - 공식 가이드: `https://postcode.map.kakao.com/guide`. - Kakao 우편번호 서비스는 별도 key 없이 사용할 수 있다. - WebView 기반 서비스는 `window.open()` 팝업보다 `embed()` 방식이 권장된다. - 후속 구현에서 `kakao.Postcode({ oncomplete })` 결과 중 최소 `zonecode`, 사용자 선택 주소를 사용한다. - 이번 UI 범위에서는 WebView 화면 실행과 결과 반영을 구현하지 않고, 우편번호 검색 버튼과 직접 편집 불가 필드 상태만 만든다. ## 11. API 계약 ### 11.1 폼 옵션 조회 - Method: `GET` - Path: `/api/v2/gifts/form-options` - 인증: 기존 v2 API와 동일한 `Authorization: Bearer ` header. - 성공 envelope: 기존 `ApiResponse`. - `data.sizes`: 선물 사이즈 목록. 첫 번째 항목을 기본 선택한다. - `data.categories`: 카테고리 목록. Spinner 0번은 기존 placeholder sentinel로 유지한다. - size UI 매핑: - `code` 또는 식별값은 제출 시 `sizeCode`로 사용한다. - `name`은 카드 title로 표시한다. - `salePriceCan`은 카드 가격과 CTA 금액에 사용한다. - `SMALL` 설명은 `세 변의 합 100cm 이하 · 5kg 이하`로 표시한다. - `MEDIUM`, `LARGE`는 서버 설명값이 없으면 설명을 비워 둔다. - category UI 매핑: - `id`는 제출 시 `categoryId`로 사용한다. - `name`은 dropdown label로 표시한다. - `requiresDamageWaiver == true`인 카테고리에서만 파손 및 분실 면책 동의 row를 표시한다. ### 11.2 선물 신청 제출 - Method: `POST` - Path: `/api/v2/gifts` - 인증: 기존 v2 API와 동일한 `Authorization: Bearer ` header. - 성공 envelope: `ApiResponse`. - `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을 열며 체크 상태 동작은 유지된다. ## 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 대조 | ## 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` | ## 18. 변경 관리 - API·액션 연결 범위가 추가되면 이 PRD의 `Open Questions`, `API 계약`, `Decision Log`를 먼저 갱신한다. - 기존 완료 Task와 검증 기록은 삭제하지 않고 후속 Task를 추가한다. - 레거시 코드 변경이 필요해 보이면 구현 전에 사용자 확인을 받는다.