docs(gift): 선물 신청 후속 요구사항을 정리한다
This commit is contained in:
@@ -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. 변경 관리
|
||||
|
||||
|
||||
Reference in New Issue
Block a user