docs(gift): 선물 신청 후속 요구사항을 정리한다
This commit is contained in:
@@ -6,7 +6,7 @@
|
|||||||
|---|---|
|
|---|---|
|
||||||
| 문서 상태 | 구현 기준 확정 |
|
| 문서 상태 | 구현 기준 확정 |
|
||||||
| 작성일 | `2026-10-01` |
|
| 작성일 | `2026-10-01` |
|
||||||
| 최종 수정일 | `2026-10-06` |
|
| 최종 수정일 | `2026-10-08` |
|
||||||
| 대상 제품 | 선물 보내기 신청 페이지 UI 및 신청 API 연동 |
|
| 대상 제품 | 선물 보내기 신청 페이지 UI 및 신청 API 연동 |
|
||||||
| 작성자·결정권자 | 사용자 요청 기준 |
|
| 작성자·결정권자 | 사용자 요청 기준 |
|
||||||
| 관련 API Contract | `GET /api/v2/gifts/form-options`, `POST /api/v2/gifts` |
|
| 관련 API Contract | `GET /api/v2/gifts/form-options`, `POST /api/v2/gifts` |
|
||||||
@@ -23,7 +23,7 @@
|
|||||||
|
|
||||||
## 1. Overview
|
## 1. Overview
|
||||||
|
|
||||||
크리에이터 채널에서 특정 크리에이터에게 선물을 보내기 위한 신청 화면을 만든다. 기존 UI shell과 크리에이터 채널 진입 연결에 이어, 선물 폼 옵션 조회, Kakao 우편번호 검색 결과 반영, 신청 제출 API를 연결한다. 2026-10-06 후속 범위에서는 신청 성공 응답의 `applicationNo`로 신청 상세를 바로 열고, 이용약관·개인정보 터치 시 지정된 Notion 약관 페이지를 외부 브라우저로 연다.
|
크리에이터 채널에서 특정 크리에이터에게 선물을 보내기 위한 신청 화면을 만든다. 기존 UI shell과 크리에이터 채널 진입 연결에 이어, 선물 폼 옵션 조회, Kakao 우편번호 검색 결과 반영, 신청 제출 API를 연결한다. 2026-10-06 후속 범위에서는 신청 성공 응답의 `applicationNo`로 신청 상세를 바로 열고, 이용약관·개인정보 터치 시 지정된 Notion 약관 페이지를 외부 브라우저로 연다. 2026-10-08 후속 범위에서는 크리에이터 프로필 이미지 URL을 신청 화면까지 전달해 표시하고, 파손 정책 링크와 크리에이터 채널의 선물 보내기 버튼 스타일을 보정한다.
|
||||||
|
|
||||||
## 2. Problem Statement
|
## 2. Problem Statement
|
||||||
|
|
||||||
@@ -43,6 +43,8 @@
|
|||||||
- 필수 진입 정보가 없거나 유효하지 않으면 “잘못된 접근입니다.” 메시지를 표시하고 화면을 종료한다.
|
- 필수 진입 정보가 없거나 유효하지 않으면 “잘못된 접근입니다.” 메시지를 표시하고 화면을 종료한다.
|
||||||
- 선물 사이즈, 카테고리, 보내는 사람 정보, 주소, 동의 UI를 Figma 기준으로 표시한다.
|
- 선물 사이즈, 카테고리, 보내는 사람 정보, 주소, 동의 UI를 Figma 기준으로 표시한다.
|
||||||
- 모든 필수 UI 입력이 채워진 상태와 비어 있는 상태에 따라 CTA 활성/비활성 표시가 달라진다.
|
- 모든 필수 UI 입력이 채워진 상태와 비어 있는 상태에 따라 CTA 활성/비활성 표시가 달라진다.
|
||||||
|
- 크리에이터 채널에서 회원번호·닉네임과 함께 프로필 이미지 URL을 전달해 받는 크리에이터 영역에 표시한다.
|
||||||
|
- 크리에이터 채널의 선물 보내기 버튼에 전용 아이콘을 표시하고 흰 배경·검은 글자 스타일을 적용한다.
|
||||||
|
|
||||||
### 3.2 UX 목표
|
### 3.2 UX 목표
|
||||||
|
|
||||||
@@ -80,7 +82,7 @@
|
|||||||
## 6. 핵심 사용자 흐름
|
## 6. 핵심 사용자 흐름
|
||||||
|
|
||||||
1. DM을 보낼 수 있는 비소유자 크리에이터 채널에서 사용자가 `선물 보내기` 버튼을 터치한다.
|
1. DM을 보낼 수 있는 비소유자 크리에이터 채널에서 사용자가 `선물 보내기` 버튼을 터치한다.
|
||||||
2. 앱은 현재 크리에이터 회원번호와 닉네임을 담아 `GiftSendRequestActivity`를 실행한다.
|
2. 앱은 현재 크리에이터 회원번호, 닉네임, 프로필 이미지 URL을 담아 `GiftSendRequestActivity`를 실행한다.
|
||||||
3. 앱은 Intent extra의 크리에이터 닉네임과 회원번호를 확인한다.
|
3. 앱은 Intent extra의 크리에이터 닉네임과 회원번호를 확인한다.
|
||||||
4. 값이 유효하지 않으면 “잘못된 접근입니다.”를 표시하고 화면을 종료한다.
|
4. 값이 유효하지 않으면 “잘못된 접근입니다.”를 표시하고 화면을 종료한다.
|
||||||
5. 값이 유효하면 신규 선물 보내기 신청 `Activity`를 표시한다.
|
5. 값이 유효하면 신규 선물 보내기 신청 `Activity`를 표시한다.
|
||||||
@@ -103,8 +105,8 @@ CreatorChannelActivity
|
|||||||
- 진입 extra:
|
- 진입 extra:
|
||||||
- `EXTRA_CREATOR_MEMBER_ID: Long`
|
- `EXTRA_CREATOR_MEMBER_ID: Long`
|
||||||
- `EXTRA_CREATOR_NICKNAME: String`
|
- `EXTRA_CREATOR_NICKNAME: String`
|
||||||
- 후속 extra 후보:
|
- `EXTRA_CREATOR_PROFILE_IMAGE_URL: String?`
|
||||||
- 프로필 이미지 URL은 이번 요구에서 필수로 확정하지 않는다. Figma의 프로필 이미지는 placeholder 또는 기존 프로필 로더 정책으로 대응한다.
|
- 프로필 이미지 URL이 blank이면 기존 빈 이미지 표시 정책을 유지하며 잘못된 접근으로 처리하지 않는다.
|
||||||
|
|
||||||
## 8. 기능 요구사항
|
## 8. 기능 요구사항
|
||||||
|
|
||||||
@@ -116,6 +118,7 @@ CreatorChannelActivity
|
|||||||
| `GIFT-ENTRY-002` | 확정 | 닉네임 blank 또는 회원번호 0 이하이면 잘못된 접근으로 종료한다. | “잘못된 접근입니다.” 표시 후 `finish()`하는 테스트 계획이 있다. | `P1-T1` |
|
| `GIFT-ENTRY-002` | 확정 | 닉네임 blank 또는 회원번호 0 이하이면 잘못된 접근으로 종료한다. | “잘못된 접근입니다.” 표시 후 `finish()`하는 테스트 계획이 있다. | `P1-T1` |
|
||||||
| `GIFT-ENTRY-003` | 확정 | DM을 보낼 수 있는 비소유자 크리에이터 채널에서 선물 보내기 버튼으로 실제 진입 액션을 연결한다. | DM 버튼 우측에 동일 패턴 버튼이 표시되고 `GiftSendRequestActivity.newIntent()`로 이동한다. | `P4-T2`, `DEC-005` |
|
| `GIFT-ENTRY-003` | 확정 | DM을 보낼 수 있는 비소유자 크리에이터 채널에서 선물 보내기 버튼으로 실제 진입 액션을 연결한다. | DM 버튼 우측에 동일 패턴 버튼이 표시되고 `GiftSendRequestActivity.newIntent()`로 이동한다. | `P4-T2`, `DEC-005` |
|
||||||
| `GIFT-ENTRY-004` | 확정 | 선물 보내기 버튼 노출 조건은 소유자가 아니고 DM 가능 상태인 크리에이터로 제한한다. | `!isOwner && isDmAvailable` 정책이 local unit test로 검증된다. | `P4-T1` |
|
| `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` |
|
| `GIFT-I18N-001` | 확정 | 선물 보내기 화면 문자열은 기본 한국어 외 영어·일본어 resource에도 추가한다. | `values-en`, `values-ja`에 `gift_send_*` 키가 있어 resource merge 오류가 없다. | `P4-T2` |
|
||||||
|
|
||||||
### 8.2 화면 UI shell
|
### 8.2 화면 UI shell
|
||||||
@@ -130,6 +133,7 @@ CreatorChannelActivity
|
|||||||
| `GIFT-UI-006` | 확정 | 카테고리는 OS 기본 dropdown UI로 계획한다. | Android `Spinner` 또는 기존 OS 기본 dropdown 패턴을 사용한다. | `P3-T1` |
|
| `GIFT-UI-006` | 확정 | 카테고리는 OS 기본 dropdown UI로 계획한다. | Android `Spinner` 또는 기존 OS 기본 dropdown 패턴을 사용한다. | `P3-T1` |
|
||||||
| `GIFT-UI-007` | 확정 | 파손 및 분실 면책 동의 UI는 이번 UI 구현에서 항상 표시한다. | 카테고리와 무관하게 면책 동의 row가 렌더 대상이다. | `P2-T2` |
|
| `GIFT-UI-007` | 확정 | 파손 및 분실 면책 동의 UI는 이번 UI 구현에서 항상 표시한다. | 카테고리와 무관하게 면책 동의 row가 렌더 대상이다. | `P2-T2` |
|
||||||
| `GIFT-UI-008` | 확정 | form-options 조회 또는 신청 제출 중 진행 상태를 알 수 있도록 `LoadingDialog`를 표시한다. | 조회 `Loading` 또는 제출 loading이 true이면 dialog를 표시하고 둘 다 종료되면 해제한다. | `P5-FOLLOWUP` |
|
| `GIFT-UI-008` | 확정 | form-options 조회 또는 신청 제출 중 진행 상태를 알 수 있도록 `LoadingDialog`를 표시한다. | 조회 `Loading` 또는 제출 loading이 true이면 dialog를 표시하고 둘 다 종료되면 해제한다. | `P5-FOLLOWUP` |
|
||||||
|
| `GIFT-UI-009` | 확정 | 크리에이터 채널의 선물 보내기 버튼은 `ic_send_gift`를 문구 왼쪽에 표시하고 흰 배경·검은 글자를 사용한다. | 기존 버튼의 노출·클릭 정책은 유지하고 지정된 아이콘·배경·글자색만 적용된다. | `P7-T2` |
|
||||||
|
|
||||||
### 8.3 보내는 사람과 주소 입력
|
### 8.3 보내는 사람과 주소 입력
|
||||||
|
|
||||||
@@ -155,6 +159,7 @@ CreatorChannelActivity
|
|||||||
| `GIFT-AGREE-002` | 확정 | “상품 전달을 위한 개인정보 수집·이용에 동의합니다.” 동의 row를 표시한다. | 체크 여부가 CTA enabled 계산에 포함된다. | `P2-T2` |
|
| `GIFT-AGREE-002` | 확정 | “상품 전달을 위한 개인정보 수집·이용에 동의합니다.” 동의 row를 표시한다. | 체크 여부가 CTA enabled 계산에 포함된다. | `P2-T2` |
|
||||||
| `GIFT-AGREE-003` | 확정 | “파손 및 분실 면책 사항에 동의합니다.” 동의 row를 미리 표시한다. | 카테고리와 무관하게 화면에 표시된다. | `P2-T2` |
|
| `GIFT-AGREE-003` | 확정 | “파손 및 분실 면책 사항에 동의합니다.” 동의 row를 미리 표시한다. | 카테고리와 무관하게 화면에 표시된다. | `P2-T2` |
|
||||||
| `GIFT-AGREE-004` | 정정 | 이용약관과 개인정보 `(필수)` 터치 처리를 각각 전용 함수로 분리한다. | 두 함수 모두 `ACTION_VIEW`로 `https://app.notion.com/p/3eb27b359673802b937ae741ab7b4ad3`을 열고 기존 체크 상태 계산을 유지한다. | `P6-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. UI/UX Expectations
|
||||||
|
|
||||||
@@ -169,7 +174,7 @@ CreatorChannelActivity
|
|||||||
|
|
||||||
- 상단 navigation: title `선물 보내기`, back button.
|
- 상단 navigation: title `선물 보내기`, back button.
|
||||||
- 안내 배너: 선물 보내기 관련 안내 문구.
|
- 안내 배너: 선물 보내기 관련 안내 문구.
|
||||||
- 받는 크리에이터: 전달받은 크리에이터 닉네임과 프로필 placeholder.
|
- 받는 크리에이터: 전달받은 크리에이터 닉네임과 원형 프로필 이미지. URL이 blank이면 기존 빈 이미지 정책을 사용한다.
|
||||||
- 선물 사이즈: 라디오형 size card, 설명, 비용/포인트 표기 영역.
|
- 선물 사이즈: 라디오형 size card, 설명, 비용/포인트 표기 영역.
|
||||||
- 카테고리: OS 기본 dropdown, placeholder `카테고리 선택`.
|
- 카테고리: OS 기본 dropdown, placeholder `카테고리 선택`.
|
||||||
- 보내는 사람: 이름, 휴대폰 번호, 우편번호, 기본 주소, 상세 주소.
|
- 보내는 사람: 이름, 휴대폰 번호, 우편번호, 기본 주소, 상세 주소.
|
||||||
@@ -279,6 +284,13 @@ CreatorChannelActivity
|
|||||||
- [ ] 성공 응답 data 누락 또는 blank 신청번호에서는 상세를 열지 않는다.
|
- [ ] 성공 응답 data 누락 또는 blank 신청번호에서는 상세를 열지 않는다.
|
||||||
- [ ] 이용약관과 개인정보 `(필수)` 터치 함수가 분리되고 두 함수 모두 지정된 Notion URL을 열며 체크 상태 동작은 유지된다.
|
- [ ] 이용약관과 개인정보 `(필수)` 터치 함수가 분리되고 두 함수 모두 지정된 Notion URL을 열며 체크 상태 동작은 유지된다.
|
||||||
|
|
||||||
|
### 14.5 Phase 7 프로필 이미지·파손 정책·채널 버튼
|
||||||
|
|
||||||
|
- [ ] 크리에이터 채널의 프로필 이미지 URL이 선물 보내기 Intent에 보존된다.
|
||||||
|
- [ ] 선물 보내기 상단에 전달받은 프로필 이미지가 원형으로 표시되고 blank URL은 안전하게 빈 이미지로 처리된다.
|
||||||
|
- [ ] 파손 및 분실 면책 `(필수)` 터치가 전용 파손 정책 URL을 열고 체크 상태를 변경하지 않으며 `(자세히보기)`는 표시하지 않는다.
|
||||||
|
- [ ] 크리에이터 채널 선물 보내기 버튼에 `ic_send_gift`가 문구 왼쪽에 표시되며 배경은 흰색, 글자는 검은색이다.
|
||||||
|
|
||||||
## 15. Open Questions
|
## 15. Open Questions
|
||||||
|
|
||||||
| ID | 상태 | 결정 필요 사항 | 현재 권고 | 결정 주체 | 결정 기한/시점 | 영향 Goal |
|
| ID | 상태 | 결정 필요 사항 | 현재 권고 | 결정 주체 | 결정 기한/시점 | 영향 Goal |
|
||||||
@@ -299,6 +311,7 @@ CreatorChannelActivity
|
|||||||
| `GIFT-API-*`, `GIFT-FORM-004`, `GIFT-CTA-003` | `/api/v2/gifts/*` | 5 | `P5-T1`~`P5-GATE` | `GiftSendRequestPresenterTest`, `GiftSendRequestViewModelTest` | 기기·에뮬레이터 실행 제외 |
|
| `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-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-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
|
## 17. Decision Log
|
||||||
|
|
||||||
@@ -314,6 +327,11 @@ CreatorChannelActivity
|
|||||||
| `2026-10-06` | `DEC-009` | 정정 | `DEC-007`의 성공 후 단순 종료를 대체하고, 성공 응답의 `applicationNo`로 신청 상세를 연 뒤 신청 화면을 종료한다. | 사용자 제공 성공 응답 계약과 승인된 접근안 A | `GIFT-CTA-005`, `P6-T1` |
|
| `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-010` | 확정 | 선물 전용 약관 route가 제공되기 전에는 이용약관·개인정보 터치 함수만 분리하고 실제 이동은 구현하지 않는다. | 사용자 선택 “함수만 분리” | `GIFT-AGREE-004`, `P6-T2` |
|
||||||
| `2026-10-06` | `DEC-011` | 정정 | `DEC-010`을 대체하고 이용약관·개인정보 터치 시 모두 지정된 Notion URL을 외부 브라우저로 연다. | 사용자 제공 URL과 후속 명시 요청 | `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. 변경 관리
|
## 18. 변경 관리
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user