docs(gift): 크리에이터 채널 선물 자격 조건을 정리한다

This commit is contained in:
2026-10-08 22:03:57 +09:00
parent f768fbdad6
commit 9e2619efd3
@@ -11,7 +11,7 @@
| 작성자·결정권자 | 사용자 요청 기준 | | 작성자·결정권자 | 사용자 요청 기준 |
| 관련 API Contract | `GET /api/v2/gifts/form-options`, `POST /api/v2/gifts` | | 관련 API Contract | `GET /api/v2/gifts/form-options`, `POST /api/v2/gifts` |
| 관련 구현 계획 | `docs/20261001_선물_보내기_신청_페이지/plan-task.md` | | 관련 구현 계획 | `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` | | 관련 review | `docs/20261001_선물_보내기_신청_페이지/reviews/phase3-gift-send-request-review.md`, `docs/20261001_선물_보내기_신청_페이지/reviews/phase4-creator-channel-gift-entry-review.md`, `docs/20261001_선물_보내기_신청_페이지/reviews/phase8-creator-channel-gift-eligibility-review.md` |
### 요구사항 상태 ### 요구사항 상태
@@ -39,7 +39,7 @@
### 3.1 제품 목표 ### 3.1 제품 목표
- 크리에이터 채널에서 전달받은 수령 크리에이터 닉네임과 회원번호로 선물 보내기 신청 화면에 진입한다. - 크리에이터 채널에서 전달받은 수령 크리에이터 닉네임과 회원번호로 선물 보내기 신청 화면에 진입한다.
- DM을 보낼 수 있는 비소유자 크리에이터 채널에서는 DM 버튼 우측에 동일 패턴의 선물 보내기 버튼을 표시한다. - DM을 보낼 수 있는 비소유자이면서 한국 접속·유효 언어가 한국어인 크리에이터 채널에서는 DM 버튼 우측에 동일 패턴의 선물 보내기 버튼을 표시한다.
- 필수 진입 정보가 없거나 유효하지 않으면 “잘못된 접근입니다.” 메시지를 표시하고 화면을 종료한다. - 필수 진입 정보가 없거나 유효하지 않으면 “잘못된 접근입니다.” 메시지를 표시하고 화면을 종료한다.
- 선물 사이즈, 카테고리, 보내는 사람 정보, 주소, 동의 UI를 Figma 기준으로 표시한다. - 선물 사이즈, 카테고리, 보내는 사람 정보, 주소, 동의 UI를 Figma 기준으로 표시한다.
- 모든 필수 UI 입력이 채워진 상태와 비어 있는 상태에 따라 CTA 활성/비활성 표시가 달라진다. - 모든 필수 UI 입력이 채워진 상태와 비어 있는 상태에 따라 CTA 활성/비활성 표시가 달라진다.
@@ -74,8 +74,8 @@
- 인증 주체: 기존 앱 로그인 사용자. 이번 UI 범위에서는 로그인 가드 신규 구현 없음. - 인증 주체: 기존 앱 로그인 사용자. 이번 UI 범위에서는 로그인 가드 신규 구현 없음.
- 허용 진입점: 크리에이터 채널에서 수령 크리에이터 닉네임과 회원번호를 전달하는 경로. - 허용 진입점: 크리에이터 채널에서 수령 크리에이터 닉네임과 회원번호를 전달하는 경로.
- 채널 버튼 노출 조건: 채널 소유자가 아니고 `isDmAvailable == true`인 크리에이터만 선물 보내기 버튼을 표시한다. 소유자의 DM 목록 버튼은 선물 보내기 조건에 포함하지 않는다. - 채널 버튼 노출 조건: 채널 소유자가 아니고 `isDmAvailable == true`이며 `GiftInboxEntryPolicy`의 한국 접속·유효 언어 한국어 조건을 만족할 때만 선물 보내기 버튼을 표시한다. 소유자의 DM 목록 버튼은 선물 보내기 조건에 포함하지 않는다.
- 지역/언어 운영 의도: 한국 접속·한국어 설정 사용자에게만 입장시킬 예정이나, 이번 구현은 런타임 지역/언어 gate를 추가하지 않고 string resource 누락 방지를 위해 `ko`, `en`, `ja` 문자열을 모두 제공한다. - 지역/언어 운영 정책: `SharedPreferenceManager.countryCode`가 `KR`이고 `LanguageManager.getEffectiveLanguage(context)`가 `ko`일 때만 선물 보내기 버튼을 표시하고 진입을 허용한다. 빈 국가 코드는 기존 선물함 정책과 동일하게 `KR`로 처리한다.
- 거부 조건: 닉네임이 blank이거나 회원번호가 0 이하이면 잘못된 접근으로 처리한다. - 거부 조건: 닉네임이 blank이거나 회원번호가 0 이하이면 잘못된 접근으로 처리한다.
- 잘못된 접근 처리: `Toast` 또는 기존 화면 메시지 패턴으로 “잘못된 접근입니다.”를 표시한 뒤 `finish()`한다. - 잘못된 접근 처리: `Toast` 또는 기존 화면 메시지 패턴으로 “잘못된 접근입니다.”를 표시한 뒤 `finish()`한다.
@@ -117,7 +117,7 @@ CreatorChannelActivity
| `GIFT-ENTRY-001` | 확정 | 크리에이터 채널에서 신규 `GiftSendRequestActivity`로 진입할 수 있게 계획한다. | `newIntent(context, creatorMemberId, creatorNickname)`가 계획에 포함된다. | `P1-T1` | | `GIFT-ENTRY-001` | 확정 | 크리에이터 채널에서 신규 `GiftSendRequestActivity`로 진입할 수 있게 계획한다. | `newIntent(context, creatorMemberId, creatorNickname)`가 계획에 포함된다. | `P1-T1` |
| `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 && GiftInboxEntryPolicy.shouldShow(countryCode, languageCode)` 정책이 local unit test로 검증된다. | `P4-T1`, `P8-T1` |
| `GIFT-ENTRY-005` | 확정 | 크리에이터 채널에서 프로필 이미지 URL을 선물 보내기 화면으로 전달한다. | `GiftSendRequestActivity` Intent가 `header.profileImageUrl`을 보존하고 받는 크리에이터 이미지에 원형으로 표시한다. blank URL과 기존 placeholder/error 정책은 유지한다. | `P7-T1`, `P7-T5` | | `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` |
@@ -258,7 +258,7 @@ CreatorChannelActivity
### 14.1 기능 수용 기준 ### 14.1 기능 수용 기준
- [ ] 유효한 extra로 신규 `GiftSendRequestActivity` UI shell이 표시된다. - [ ] 유효한 extra로 신규 `GiftSendRequestActivity` UI shell이 표시된다.
- [ ] DM 가능 비소유자 크리에이터 채널에서 선물 보내기 버튼이 표시되고 신규 `Activity`로 이동한다. - [x] DM 가능 비소유자이며 한국 접속·유효 언어가 한국어인 크리에이터 채널에서만 선물 보내기 버튼이 표시되고 신규 `Activity`로 이동한다.
- [ ] 유효하지 않은 extra는 “잘못된 접근입니다.” 표시 후 종료된다. - [ ] 유효하지 않은 extra는 “잘못된 접근입니다.” 표시 후 종료된다.
- [ ] 선물 사이즈 첫 항목 기본 선택과 미선택 스타일 정책이 presentation model에 반영된다. - [ ] 선물 사이즈 첫 항목 기본 선택과 미선택 스타일 정책이 presentation model에 반영된다.
- [ ] 카테고리 미선택 placeholder와 OS 기본 dropdown 계획이 반영된다. - [ ] 카테고리 미선택 placeholder와 OS 기본 dropdown 계획이 반영된다.
@@ -312,6 +312,7 @@ CreatorChannelActivity
| `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 대조 | | `GIFT-ENTRY-005`, `GIFT-UI-009`, `GIFT-AGREE-005` | 없음 | 7 | `P7-T1`, `P7-T2`, `P7-T3`, `P7-T5`, `P7-GATE` | `GiftSendEntryPolicyTest`, `GiftNavigationTest` | source/resource 대조 |
| `GIFT-ENTRY-004` 지역·언어 gate | 없음 | 8 | `P8-T1`, `P8-GATE` | `CreatorChannelGiftEligibilityTest`, `GiftInboxEntryPolicyTest` | source 대조 |
## 17. Decision Log ## 17. Decision Log
@@ -332,6 +333,7 @@ CreatorChannelActivity
| `2026-10-08` | `DEC-014` | 확정 | 사용자가 추가한 `ic_send_gift`, `ic_gift_info`와 수정한 선물 레이아웃 2개를 최신 기준으로 보존한다. | 사용자 명시 요청 | `GIFT-UI-009`, Phase 7 전체 | | `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-015` | 정정 | `DEC-013`의 `(자세히보기)` 링크를 제거하고 파손 및 분실 면책의 기존 `(필수)`를 같은 파손 정책 URL 링크로 사용한다. | 사용자 후속 요청과 권장안 승인 | `GIFT-AGREE-005`, `P7-T5` |
| `2026-10-08` | `DEC-016` | 확정 | 선물 보내기 화면의 받는 크리에이터 프로필 이미지에 기존 Coil 원형 crop 패턴을 적용한다. | 사용자 후속 요청 | `GIFT-ENTRY-005`, `P7-T5` | | `2026-10-08` | `DEC-016` | 확정 | 선물 보내기 화면의 받는 크리에이터 프로필 이미지에 기존 Coil 원형 crop 패턴을 적용한다. | 사용자 후속 요청 | `GIFT-ENTRY-005`, `P7-T5` |
| `2026-10-08` | `DEC-017` | 정정 | `DEC-005`의 버튼 노출 조건에 기존 `GiftInboxEntryPolicy`를 재사용해 한국 접속·유효 언어 한국어 조건을 추가하고, 표시와 클릭 진입에 동일하게 적용한다. | 사용자 후속 요청 | `GIFT-ENTRY-004`, `P8-T1`, `P8-GATE` |
## 18. 변경 관리 ## 18. 변경 관리