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

This commit is contained in:
2026-10-06 15:29:48 +09:00
parent 3ab69a50c8
commit 5609b77eba
2 changed files with 98 additions and 7 deletions
@@ -755,6 +755,77 @@ P1-T1 -> P1-T2 -> P1-GATE -> P2-T1 -> P2-T2 -> P2-GATE -> P3-T1 -> P3-T2 -> P3-T
- 수정 범위: `tv_phone_number_support` ID를 휴대폰 inputfield 아래 support TextView로 이동한다.
- 검증: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다.
## Phase 6: 신청 성공 상세 이동과 약관 외부 링크
**Phase 결과:** 신청 성공 응답을 typed DTO로 파싱해 유효한 신청번호의 상세 화면을 열고, 보내는 사람 이용약관·개인정보 문구에서 지정된 Notion 페이지를 외부 브라우저로 연다.
**선행조건:** PRD `GIFT-CTA-005`, `GIFT-AGREE-004`, `DEC-009`, `DEC-011` 확정.
**Phase 완료 조건:** `P6-T1`, `P6-T2`, `P6-GATE` 완료, PRD 14.4와 Verification Log 갱신.
### Task 6.1 typed 신청 응답과 상세 이동
**Goal 실행 `P6-T1`:** `POST /api/v2/gifts` 성공 payload의 신청번호를 보존하고 같은 번호의 `GiftDetailActivity`를 연다.
**Files:**
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftModels.kt`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftApi.kt`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestViewModel.kt`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestActivity.kt`
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestViewModelTest.kt`
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt`
- [ ] **RED:** 유효한 `GiftCreateResponse.applicationNo`가 성공 event에 포함되는 ViewModel test를 작성한다.
- [ ] **RED:** `data=null` 또는 blank `applicationNo`에서 성공 event를 내보내지 않고 기존 오류 feedback을 유지하는 test를 작성한다.
- [ ] **RED:** 성공 event 소비 시 같은 신청번호만 담은 `GiftDetailActivity` Intent를 만들고 신청 화면을 종료하는 navigation test를 작성한다.
- [ ] **RED 확인:** focused test에서 typed 응답 또는 navigation event 부재 실패를 기록한다.
- [ ] **GREEN:** `GiftCreateResponse`를 추가하고 `GiftApi.createGift()`를 `ApiResponse<GiftCreateResponse>`로 변경한다.
- [ ] **GREEN:** ViewModel 성공 event와 Activity navigation을 기존 소비형 event·`GiftDetailActivity.newIntent` 패턴으로 최소 연결한다.
- [ ] **GREEN 확인:** focused test PASS를 기록한다.
- [ ] **REFACTOR:** DTO 전체를 Intent에 넣지 않고 `applicationNo`만 전달하며 기존 request body·loading·실패 시 form 유지 동작을 보존한다.
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun
```
### Task 6.2 보내는 사람 약관 외부 링크
**Goal 실행 `P6-T2`:** 이용약관과 개인정보 `(필수)` 터치를 분리하고 두 경로 모두 지정된 Notion URL을 외부 브라우저로 연다.
**Files:**
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestActivity.kt`
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt`
- [ ] **RED:** 이용약관과 개인정보 handler가 각각 `ACTION_VIEW`와 정확한 Notion URL을 갖는 Intent를 만드는 navigation test를 작성한다.
- [ ] **RED:** 링크 handler 실행 전후 form 동의 상태와 CTA 계산이 바뀌지 않는 test를 작성한다.
- [ ] **RED 확인:** 전용 handler 또는 외부 Intent 부재 실패를 기록한다.
- [ ] **GREEN:** 두 문구의 클릭 listener를 전용 함수로 분리하고 기존 `Intent(Intent.ACTION_VIEW, Uri.parse(URL))` 패턴을 재사용한다.
- [ ] **GREEN 확인:** navigation focused test PASS를 기록한다.
- [ ] **REFACTOR:** 신규 Activity, WebView, dependency, manifest 항목 또는 중복 URL 상수를 추가하지 않는다.
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun
```
### Task 6.3 통합 Gate
**Goal 실행 `P6-GATE`:** 신청 성공 이동·약관 링크와 기존 gift 기능을 직렬 검증한다.
- [ ] gift package local unit test를 실행한다.
- [ ] resource merge, Kotlin compile, ktlint, debug assemble을 실행한다.
- [ ] `GIT_MASTER=1 git diff --check HEAD`를 실행한다.
- [ ] PRD 14.4와 이 문서의 체크박스·Verification Log를 실제 증거로 갱신한다.
- [ ] 코드 리뷰에서 확정 finding이 나오면 기존 완료 Task를 다시 열지 않고 `P6-R*` 회귀 수정 Task를 먼저 추가한다.
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --rerun
./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck
./gradlew :app:assembleDebug
GIT_MASTER=1 git diff --check HEAD
```
## Decision Log
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 |
@@ -766,6 +837,8 @@ P1-T1 -> P1-T2 -> P1-GATE -> P2-T1 -> P2-T2 -> P2-GATE -> P3-T1 -> P3-T2 -> P3-T
| `2026-10-01` | `DEC-005` | 확정 | 크리에이터 채널 진입 연결 제외는 후속 요청으로 supersede하고, DM 가능 비소유자 크리에이터에만 선물 보내기 버튼을 추가한다. | 사용자 후속 요청 | `P4-T1`, `P4-T2` |
| `2026-10-01` | `DEC-006` | 확정 | 주소는 직접 입력 없이 Kakao 우편번호 검색 `embed()` 결과로만 우편번호와 기본 주소를 등록한다. | 사용자 명시 요청과 Kakao 가이드 | `P5-T4` |
| `2026-10-01` | `DEC-007` | 확정 | 성공 화면은 만들지 않고 신청 성공 토스트 후 현재 화면을 종료한다. | 사용자 명시 요청 | `P5-T3` |
| `2026-10-06` | `DEC-008` | 정정 | `DEC-007`을 대체하고 typed 성공 응답의 유효한 `applicationNo`로 상세를 연 뒤 신청 화면을 종료한다. | 승인된 PRD `DEC-009` | `P6-T1` |
| `2026-10-06` | `DEC-009` | 확정 | 보내는 사람 이용약관·개인정보 터치는 모두 지정된 Notion URL을 외부 브라우저로 연다. | 승인된 PRD `DEC-011` | `P6-T2` |
## 발견된 문제
@@ -786,3 +859,4 @@ P1-T1 -> P1-T2 -> P1-GATE -> P2-T1 -> P2-T2 -> P2-GATE -> P3-T1 -> P3-T2 -> P3-T
- 2026-10-01: 입력 안내 문구 에러 상태 보정 후 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다. 기존 Android/Agora namespace warning과 Gradle/Kotlin deprecation warning은 이번 변경과 무관하게 유지됐다.
- 2026-10-01: 입력 에러 전용 문구 복구 후 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다. 기존 Gradle/Kotlin deprecation warning은 이번 변경과 무관하게 유지됐다.
- 2026-10-01: 휴대폰 support ID 재배치 후 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin`가 `BUILD SUCCESSFUL`로 통과했다. 기존 Android/Agora namespace warning과 Gradle deprecation warning은 이번 변경과 무관하게 유지됐다.
- 2026-10-06: 승인된 PRD 후속 범위를 기준으로 `P6-T1` typed 신청 응답·상세 이동, `P6-T2` 약관 외부 링크, `P6-GATE` 계획을 추가했다. production/test/resource 코드는 아직 변경하지 않았고 RED/GREEN과 Gate는 미실행이다.
@@ -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. 변경 관리