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