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는 미실행이다.