docs(gift): 선물 신청 후속 요구사항을 정리한다

This commit is contained in:
2026-10-08 15:06:13 +09:00
parent b8cf3b52f9
commit 91bfea320b
@@ -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. 변경 관리