From 91bfea320b9d25c1ea6ad97bacc0f73e9f3e007c Mon Sep 17 00:00:00 2001 From: klaus Date: Thu, 8 Oct 2026 15:06:13 +0900 Subject: [PATCH] =?UTF-8?q?docs(gift):=20=EC=84=A0=EB=AC=BC=20=EC=8B=A0?= =?UTF-8?q?=EC=B2=AD=20=ED=9B=84=EC=86=8D=20=EC=9A=94=EA=B5=AC=EC=82=AC?= =?UTF-8?q?=ED=95=AD=EC=9D=84=20=EC=A0=95=EB=A6=AC=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/20261001_선물_보내기_신청_페이지/prd.md | 30 ++++++++++++++++---- 1 file changed, 24 insertions(+), 6 deletions(-) diff --git a/docs/20261001_선물_보내기_신청_페이지/prd.md b/docs/20261001_선물_보내기_신청_페이지/prd.md index 7f11c264..9ffe1f63 100644 --- a/docs/20261001_선물_보내기_신청_페이지/prd.md +++ b/docs/20261001_선물_보내기_신청_페이지/prd.md @@ -6,7 +6,7 @@ |---|---| | 문서 상태 | 구현 기준 확정 | | 작성일 | `2026-10-01` | -| 최종 수정일 | `2026-10-06` | +| 최종 수정일 | `2026-10-08` | | 대상 제품 | 선물 보내기 신청 페이지 UI 및 신청 API 연동 | | 작성자·결정권자 | 사용자 요청 기준 | | 관련 API Contract | `GET /api/v2/gifts/form-options`, `POST /api/v2/gifts` | @@ -23,7 +23,7 @@ ## 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 @@ -43,6 +43,8 @@ - 필수 진입 정보가 없거나 유효하지 않으면 “잘못된 접근입니다.” 메시지를 표시하고 화면을 종료한다. - 선물 사이즈, 카테고리, 보내는 사람 정보, 주소, 동의 UI를 Figma 기준으로 표시한다. - 모든 필수 UI 입력이 채워진 상태와 비어 있는 상태에 따라 CTA 활성/비활성 표시가 달라진다. +- 크리에이터 채널에서 회원번호·닉네임과 함께 프로필 이미지 URL을 전달해 받는 크리에이터 영역에 표시한다. +- 크리에이터 채널의 선물 보내기 버튼에 전용 아이콘을 표시하고 흰 배경·검은 글자 스타일을 적용한다. ### 3.2 UX 목표 @@ -80,7 +82,7 @@ ## 6. 핵심 사용자 흐름 1. DM을 보낼 수 있는 비소유자 크리에이터 채널에서 사용자가 `선물 보내기` 버튼을 터치한다. -2. 앱은 현재 크리에이터 회원번호와 닉네임을 담아 `GiftSendRequestActivity`를 실행한다. +2. 앱은 현재 크리에이터 회원번호, 닉네임, 프로필 이미지 URL을 담아 `GiftSendRequestActivity`를 실행한다. 3. 앱은 Intent extra의 크리에이터 닉네임과 회원번호를 확인한다. 4. 값이 유효하지 않으면 “잘못된 접근입니다.”를 표시하고 화면을 종료한다. 5. 값이 유효하면 신규 선물 보내기 신청 `Activity`를 표시한다. @@ -103,8 +105,8 @@ CreatorChannelActivity - 진입 extra: - `EXTRA_CREATOR_MEMBER_ID: Long` - `EXTRA_CREATOR_NICKNAME: String` -- 후속 extra 후보: - - 프로필 이미지 URL은 이번 요구에서 필수로 확정하지 않는다. Figma의 프로필 이미지는 placeholder 또는 기존 프로필 로더 정책으로 대응한다. + - `EXTRA_CREATOR_PROFILE_IMAGE_URL: String?` +- 프로필 이미지 URL이 blank이면 기존 빈 이미지 표시 정책을 유지하며 잘못된 접근으로 처리하지 않는다. ## 8. 기능 요구사항 @@ -116,6 +118,7 @@ CreatorChannelActivity | `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 @@ -130,6 +133,7 @@ CreatorChannelActivity | `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 보내는 사람과 주소 입력 @@ -155,6 +159,7 @@ CreatorChannelActivity | `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 @@ -169,7 +174,7 @@ CreatorChannelActivity - 상단 navigation: title `선물 보내기`, back button. - 안내 배너: 선물 보내기 관련 안내 문구. -- 받는 크리에이터: 전달받은 크리에이터 닉네임과 프로필 placeholder. +- 받는 크리에이터: 전달받은 크리에이터 닉네임과 원형 프로필 이미지. URL이 blank이면 기존 빈 이미지 정책을 사용한다. - 선물 사이즈: 라디오형 size card, 설명, 비용/포인트 표기 영역. - 카테고리: OS 기본 dropdown, placeholder `카테고리 선택`. - 보내는 사람: 이름, 휴대폰 번호, 우편번호, 기본 주소, 상세 주소. @@ -279,6 +284,13 @@ CreatorChannelActivity - [ ] 성공 응답 data 누락 또는 blank 신청번호에서는 상세를 열지 않는다. - [ ] 이용약관과 개인정보 `(필수)` 터치 함수가 분리되고 두 함수 모두 지정된 Notion URL을 열며 체크 상태 동작은 유지된다. +### 14.5 Phase 7 프로필 이미지·파손 정책·채널 버튼 + +- [ ] 크리에이터 채널의 프로필 이미지 URL이 선물 보내기 Intent에 보존된다. +- [ ] 선물 보내기 상단에 전달받은 프로필 이미지가 원형으로 표시되고 blank URL은 안전하게 빈 이미지로 처리된다. +- [ ] 파손 및 분실 면책 `(필수)` 터치가 전용 파손 정책 URL을 열고 체크 상태를 변경하지 않으며 `(자세히보기)`는 표시하지 않는다. +- [ ] 크리에이터 채널 선물 보내기 버튼에 `ic_send_gift`가 문구 왼쪽에 표시되며 배경은 흰색, 글자는 검은색이다. + ## 15. Open Questions | 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-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 @@ -314,6 +327,11 @@ CreatorChannelActivity | `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. 변경 관리