341 lines
28 KiB
Markdown
341 lines
28 KiB
Markdown
# 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` |
|
|
|
|
### 요구사항 상태
|
|
|
|
| 상태 | 의미 | 구현 처리 |
|
|
|---|---|---|
|
|
| 확정 | 이번 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`인 크리에이터만 선물 보내기 버튼을 표시한다. 소유자의 DM 목록 버튼은 선물 보내기 조건에 포함하지 않는다.
|
|
- 지역/언어 운영 의도: 한국 접속·한국어 설정 사용자에게만 입장시킬 예정이나, 이번 구현은 런타임 지역/언어 gate를 추가하지 않고 string resource 누락 방지를 위해 `ko`, `en`, `ja` 문자열을 모두 제공한다.
|
|
- 거부 조건: 닉네임이 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. 정보 구조와 라우팅
|
|
|
|
```text
|
|
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` 정책이 local unit test로 검증된다. | `P4-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 대조 |
|
|
|
|
## 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` |
|
|
|
|
## 18. 변경 관리
|
|
|
|
- API·액션 연결 범위가 추가되면 이 PRD의 `Open Questions`, `API 계약`, `Decision Log`를 먼저 갱신한다.
|
|
- 기존 완료 Task와 검증 기록은 삭제하지 않고 후속 Task를 추가한다.
|
|
- 레거시 코드 변경이 필요해 보이면 구현 전에 사용자 확인을 받는다.
|