docs(gift): 선물 신청 후속 요구사항을 정리한다
This commit is contained in:
@@ -6,7 +6,7 @@
|
||||
|---|---|
|
||||
| 문서 상태 | 구현 기준 확정 |
|
||||
| 작성일 | `2026-10-01` |
|
||||
| 최종 수정일 | `2026-10-01` |
|
||||
| 최종 수정일 | `2026-10-06` |
|
||||
| 대상 제품 | 선물 보내기 신청 페이지 UI 및 신청 API 연동 |
|
||||
| 작성자·결정권자 | 사용자 요청 기준 |
|
||||
| 관련 API Contract | `GET /api/v2/gifts/form-options`, `POST /api/v2/gifts` |
|
||||
@@ -23,7 +23,7 @@
|
||||
|
||||
## 1. Overview
|
||||
|
||||
크리에이터 채널에서 특정 크리에이터에게 선물을 보내기 위한 신청 화면을 만든다. 기존 UI shell과 크리에이터 채널 진입 연결에 이어, 이번 후속 범위에서는 선물 폼 옵션 조회, Kakao 우편번호 검색 결과 반영, 신청 제출 API, 성공 토스트 후 뒤로가기를 연결한다.
|
||||
크리에이터 채널에서 특정 크리에이터에게 선물을 보내기 위한 신청 화면을 만든다. 기존 UI shell과 크리에이터 채널 진입 연결에 이어, 선물 폼 옵션 조회, Kakao 우편번호 검색 결과 반영, 신청 제출 API를 연결한다. 2026-10-06 후속 범위에서는 신청 성공 응답의 `applicationNo`로 신청 상세를 바로 열고, 이용약관·개인정보 터치 시 지정된 Notion 약관 페이지를 외부 브라우저로 연다.
|
||||
|
||||
## 2. Problem Statement
|
||||
|
||||
@@ -87,13 +87,15 @@
|
||||
6. 화면은 안내 배너, 받는 크리에이터, 선물 사이즈, 카테고리, 보내는 사람, 이용 약관 동의, 하단 CTA를 표시한다.
|
||||
7. 입력 전에는 CTA가 비활성이다.
|
||||
8. 필수 입력과 필수 동의가 채워진 상태에서는 CTA가 활성 스타일로 표시된다.
|
||||
9. CTA 클릭 동작과 API 제출은 후속 요청에서 연결한다.
|
||||
9. CTA를 누르면 신청 API를 호출한다.
|
||||
10. 성공 응답의 `applicationNo`가 유효하면 성공 toast를 표시하고 같은 번호의 `GiftDetailActivity`를 연 뒤 신청 화면을 종료한다.
|
||||
|
||||
## 7. 정보 구조와 라우팅
|
||||
|
||||
```text
|
||||
CreatorChannelActivity
|
||||
-> GiftSendRequestActivity
|
||||
-> GiftDetailActivity(applicationNo)
|
||||
```
|
||||
|
||||
- 신규 화면 단위: `GiftSendRequestActivity`.
|
||||
@@ -146,11 +148,13 @@ CreatorChannelActivity
|
||||
|---|---|---|---|---|
|
||||
| `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-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
|
||||
|
||||
@@ -212,7 +216,8 @@ CreatorChannelActivity
|
||||
- Method: `POST`
|
||||
- Path: `/api/v2/gifts`
|
||||
- 인증: 기존 v2 API와 동일한 `Authorization: Bearer <token>` header.
|
||||
- 성공 envelope: 기존 `ApiResponse<Any>` 패턴. 성공 판정은 `success == true` 기준이다.
|
||||
- 성공 envelope: `ApiResponse<GiftCreateResponse>`.
|
||||
- `data`: `applicationNo: String`, `status: String`, `statusName: String`, `priceCan: Int`, `trackingDeadlineAt: String`.
|
||||
- Request body:
|
||||
- `recipientMemberId`: `GiftSendRequestActivity` 진입 시 받은 `memberId`.
|
||||
- `senderName`
|
||||
@@ -225,7 +230,8 @@ CreatorChannelActivity
|
||||
- `senderTermsAgreed`
|
||||
- `senderPrivacyAgreed`
|
||||
- `damageWaiverAgreed`
|
||||
- 성공 UX: 성공 토스트를 표시한 뒤 현재 화면을 종료한다.
|
||||
- 성공 UX: `success == true`, `data != null`, `applicationNo`가 blank가 아닐 때 성공 토스트를 표시하고 같은 신청번호의 상세를 연 뒤 현재 화면을 종료한다.
|
||||
- 성공 envelope가 유효하지 않으면 상세를 열거나 화면을 종료하지 않고 기존 오류 feedback을 표시한다.
|
||||
- 실패 UX: 화면에 남아 기존 공통 오류 토스트 또는 서버 메시지를 표시한다.
|
||||
- 진행 UX: form-options 조회와 신청 제출 중에는 기존 `LoadingDialog`를 표시한다.
|
||||
|
||||
@@ -266,13 +272,20 @@ CreatorChannelActivity
|
||||
- [ ] 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-01 | `P5-T3` |
|
||||
| `OQ-003` | 정정 | 제출 API와 완료/실패 UX | `POST /api/v2/gifts` 성공 시 응답 신청번호로 상세 이동, 실패 시 입력 화면 유지 | 사용자/API 담당 | 2026-10-06 | `P5-T3`, `P6-T1` |
|
||||
|
||||
## 16. 요구사항 추적표
|
||||
|
||||
@@ -285,6 +298,7 @@ CreatorChannelActivity
|
||||
| `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
|
||||
|
||||
@@ -297,6 +311,9 @@ CreatorChannelActivity
|
||||
| `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. 변경 관리
|
||||
|
||||
|
||||
Reference in New Issue
Block a user