docs(gift): 선물 신청 구현과 리뷰를 기록한다

This commit is contained in:
2026-10-08 15:06:50 +09:00
parent 91bfea320b
commit eb1653710b
2 changed files with 150 additions and 0 deletions
@@ -826,6 +826,100 @@ P1-T1 -> P1-T2 -> P1-GATE -> P2-T1 -> P2-T2 -> P2-GATE -> P3-T1 -> P3-T2 -> P3-T
GIT_MASTER=1 git diff --check HEAD GIT_MASTER=1 git diff --check HEAD
``` ```
## Phase 7: 크리에이터 프로필·파손 정책·채널 선물 버튼
**Phase 결과:** 크리에이터 채널에서 전달한 프로필 이미지를 선물 신청 화면에 표시하고, 파손 정책 링크를 외부 브라우저로 열며, 채널 선물 버튼에 승인된 아이콘·색상을 적용한다.
**선행조건:** 승인된 PRD `DEC-024`~`DEC-026`.
**Phase 완료 조건:** `P7-T1`~`P7-T3`, `P7-GATE` 완료, PRD와 Verification Log 갱신.
### Task 7.1 프로필 URL 전달과 표시
**Goal 실행 `P7-T1`:** 크리에이터 채널의 `header.profileImageUrl`을 선물 신청 Intent에 전달하고 기존 Glide 패턴으로 표시한다.
**Files:**
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/creator/channel/CreatorChannelActivity.kt`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestActivity.kt`
- Modify: `app/src/main/res/layout/activity_gift_send_request.xml`
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt`
- [x] **RED:** `GiftSendRequestActivity.newIntent`가 creator id, nickname, profile URL을 원본 그대로 전달하는 test를 추가한다.
- [x] **RED:** 신청 화면이 profile URL을 ImageView에 요청하고 URL이 없을 때 기존 placeholder를 유지하는 test를 추가한다.
- [x] **RED 확인:** profile extra와 image binding 부재로 실패함을 기록한다.
- [x] **GREEN:** 기존 Intent factory에 profile URL을 추가하고 채널 클릭에서 `header.profileImageUrl`을 넘긴다.
- [x] **GREEN:** 기존 이미지 로더를 재사용해 `iv_creator_profile`에 표시한다.
- [x] **REFACTOR:** 신규 image loader·wrapper·dependency를 만들지 않는다.
### Task 7.2 파손 정책 외부 링크
**Goal 실행 `P7-T2`:** `gift_send_damage_policy`의 `(자세히보기)` 터치만 지정된 파손 정책 URL을 외부 브라우저로 연다.
**Files:**
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftAgreementLink.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/GiftNavigationTest.kt`
- [x] **RED:** `ACTION_VIEW`와 `https://app.notion.com/p/3f227b3596738018ba5dea2e5205293b`를 검증하는 navigation test를 추가한다.
- [x] **RED:** 링크 터치 전후 form·약관·CTA 상태가 유지되는 test를 추가한다.
- [x] **RED 확인:** 전용 span/handler 부재로 실패함을 기록한다.
- [x] **GREEN:** 기존 `GiftAgreementLink`의 span·hit 영역 처리와 외부 Intent 패턴을 재사용한다.
- [x] **REFACTOR:** 전체 문구 클릭, WebView, 신규 화면을 추가하지 않는다.
### Task 7.3 크리에이터 채널 선물 버튼 UI
**Goal 실행 `P7-T3`:** 선물 버튼에 `ic_send_gift`, 흰 배경, 검은 글자를 적용한다.
**Files:**
- Modify: `app/src/main/res/layout/activity_creator_channel.xml`
- Modify/Create only if needed: `app/src/main/res/drawable/bg_creator_channel_gift_button.xml`
- [x] `tv_gift_send_button`에 `app:drawableStartCompat="@drawable/ic_send_gift"`와 기존 버튼의 drawable padding을 적용한다.
- [x] 기존 `bg_round_corner_999_white`를 재사용하고 신규 drawable은 추가하지 않는다.
- [x] 사용자 추가 asset `ic_send_gift.png`를 수정하지 않는다.
- [x] 레이아웃 속성 직접 unit test는 작성하지 않고 resource merge로 검증한다.
### Task 7.4 통합 Gate
**Goal 실행 `P7-GATE`:** Phase 7과 기존 선물 신청 흐름을 직렬 검증한다.
- [x] `GiftNavigationTest` focused test를 실행한다.
- [x] 전체 gift local unit test와 전체 local unit test를 실행한다.
- [x] resource merge, Kotlin compile, ktlint, debug assemble을 실행한다.
- [x] `GIT_MASTER=1 git diff --check HEAD`를 실행한다.
- [x] 실제 결과를 각 Task와 문서 하단 Verification Log에 기록한다.
- [x] 코드 리뷰 finding을 `phase7-profile-damage-button-review.md`에 기록하고 문서 정합성을 수정한다.
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --rerun
./gradlew :app:testDebugUnitTest --rerun
./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck
./gradlew :app:assembleDebug
GIT_MASTER=1 git diff --check HEAD
```
### Task 7.5 파손 정책 `(필수)` 링크와 원형 프로필 후속 수정
**Goal 실행 `P7-T5`:** 파손 면책의 `(자세히보기)`를 제거하고 기존 `(필수)`로 정책 URL을 열며, 받는 크리에이터 프로필 이미지를 원형으로 표시한다.
**Files:**
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftAgreementLink.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/GiftNavigationTest.kt`
- [x] **RED:** 파손 면책의 클릭 span이 `(필수)`이고 `(자세히보기)`가 없으며 기존 URL·폼·동의·CTA가 유지되는 test로 변경한다.
- [x] **RED:** 유효한 프로필 이미지 요청에 `CircleCropTransformation`이 적용되는 test를 추가한다.
- [x] **RED 확인:** 기존 `(자세히보기)` span과 원형 transformation 부재로 focused test가 실패함을 기록한다.
- [x] **GREEN:** `setRequiredLink()`를 파손 면책에도 재사용하고 사용처가 사라진 전용 링크 상수·함수를 제거한다.
- [x] **GREEN:** 기존 `loadUrl` 요청에 `CircleCropTransformation`만 추가해 URL·blank·placeholder/error 동작을 보존한다.
- [x] **GREEN 확인:** focused test와 gift package test를 실행해 PASS를 기록한다.
- [x] **회귀 검증:** resource merge, Kotlin compile, ktlint, diff check 결과를 Verification Log에 누적한다.
## Decision Log ## Decision Log
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 | | 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 |
@@ -839,6 +933,10 @@ GIT_MASTER=1 git diff --check HEAD
| `2026-10-01` | `DEC-007` | 확정 | 성공 화면은 만들지 않고 신청 성공 토스트 후 현재 화면을 종료한다. | 사용자 명시 요청 | `P5-T3` | | `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-008` | 정정 | `DEC-007`을 대체하고 typed 성공 응답의 유효한 `applicationNo`로 상세를 연 뒤 신청 화면을 종료한다. | 승인된 PRD `DEC-009` | `P6-T1` |
| `2026-10-06` | `DEC-009` | 확정 | 보내는 사람 이용약관·개인정보 터치는 모두 지정된 Notion URL을 외부 브라우저로 연다. | 승인된 PRD `DEC-011` | `P6-T2` | | `2026-10-06` | `DEC-009` | 확정 | 보내는 사람 이용약관·개인정보 터치는 모두 지정된 Notion URL을 외부 브라우저로 연다. | 승인된 PRD `DEC-011` | `P6-T2` |
| `2026-10-08` | `DEC-010` | 확정 | 크리에이터 채널의 `header.profileImageUrl`을 선물 신청 Intent로 전달해 기존 Glide 패턴으로 표시한다. | 승인된 PRD `DEC-024` | `P7-T1` |
| `2026-10-08` | `DEC-011` | 확정 | 파손 정책 `(자세히보기)`는 지정된 Notion URL을 외부 브라우저로 연다. | 승인된 PRD `DEC-025` | `P7-T2` |
| `2026-10-08` | `DEC-012` | 확정 | 크리에이터 채널 선물 버튼은 `ic_send_gift`, 흰 배경, 검은 글자를 사용한다. | 승인된 PRD `DEC-026` | `P7-T3` |
| `2026-10-08` | `DEC-013` | 정정 | 파손 정책 링크는 `(자세히보기)` 대신 기존 `(필수)`에 연결하고, 받는 크리에이터 프로필은 기존 Coil 요청에 원형 crop을 적용한다. | 사용자 후속 요청과 권장안 승인 | `P7-T5` |
## 발견된 문제 ## 발견된 문제
@@ -848,6 +946,10 @@ GIT_MASTER=1 git diff --check HEAD
## Verification Log ## Verification Log
- 2026-10-08: `P7-T5` RED에서 `GiftNavigationTest` 44개 중 파손 span과 프로필 transformation 관련 2개 실패를 확인했다. `setRequiredLink()` 재사용과 `CircleCropTransformation` 적용 후 같은 focused test가 `BUILD SUCCESSFUL in 51s`로 통과했다. 이어 gift package local unit test, resource merge, Kotlin compile, ktlint가 `BUILD SUCCESSFUL in 43s`로 통과했고 `git diff --check HEAD`도 무출력 통과했다. 기기·에뮬레이터·androidTest·시각 QA는 저장소 규칙에 따라 실행하지 않았다.
- 2026-10-08: Phase 7 RED에서 profile extra/image binding 및 파손 정책 handler 부재 실패를 확인한 뒤 기존 Coil `loadUrl`과 `GiftAgreementLink`를 재사용해 GREEN을 확인했다. 최종 `GiftNavigationTest`는 `BUILD SUCCESSFUL in 1m 25s`, gift package는 `BUILD SUCCESSFUL in 1m 34s`, 전체 local unit suite는 `BUILD SUCCESSFUL in 2m 23s`였다. `mergeDebugResources`·`compileDebugKotlin`은 `BUILD SUCCESSFUL in 3s`, `assembleDebug`는 `BUILD SUCCESSFUL in 8s`, `GIT_MASTER=1 git diff --check HEAD`는 무출력 통과했다. `ktlintCheck`는 이번 변경 외 기존 `audio_content` 등 레거시 위반으로 실패했으며 변경 파일 위반은 보고되지 않았다. 기기·에뮬레이터·androidTest·시각 QA는 저장소 규칙에 따라 실행하지 않았다.
- 2026-10-01: 문서 생성 작업이므로 Gradle 빌드/테스트는 실행하지 않았다. 실제 구현 시 Phase Gate 명령을 실행한다. - 2026-10-01: 문서 생성 작업이므로 Gradle 빌드/테스트는 실행하지 않았다. 실제 구현 시 Phase Gate 명령을 실행한다.
- 2026-10-01: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck`를 fresh 실행해 `BUILD SUCCESSFUL`을 확인했다. 기존 namespace 중복, deprecated API, `.editorconfig`의 `disabled_rules` deprecation 경고는 이번 변경과 무관한 경고로 유지했다. - 2026-10-01: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck`를 fresh 실행해 `BUILD SUCCESSFUL`을 확인했다. 기존 namespace 중복, deprecated API, `.editorconfig`의 `disabled_rules` deprecation 경고는 이번 변경과 무관한 경고로 유지했다.
- 2026-10-01: `P3-R1` 문서 수정 후 PRD에서 잘못된 테스트명 검색 결과 없음, plan-task 미완료 체크박스 검색 결과 없음, `git diff --check` 출력 없음을 확인했다. - 2026-10-01: `P3-R1` 문서 수정 후 PRD에서 잘못된 테스트명 검색 결과 없음, plan-task 미완료 체크박스 검색 결과 없음, `git diff --check` 출력 없음을 확인했다.
@@ -0,0 +1,48 @@
# Phase 7 프로필·파손 정책·채널 버튼 리뷰
## 1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 리뷰 대상 | Phase 7 / `P7-T1`~`P7-GATE` |
| 기준 commit 또는 working tree | `1b3206fe` 이후 working tree |
| 리뷰 일자 | `2026-10-08` |
| 리뷰어 | Oracle, Sisyphus |
| 기준 문서 | `prd.md`, `plan-task.md` Phase 7 |
| 리뷰 상태 | 수정 검증 완료 |
## 2. 리뷰 목적과 범위
- 프로필 URL 전달·표시, 파손 정책 링크, 채널 버튼 스타일의 요구사항·코드·test 정합성을 확인한다.
- 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 저장소 규칙에 따라 제외한다.
## 3. 검토한 근거
- 코드: `CreatorChannelActivity.kt`, `GiftSendRequestActivity.kt`, `GiftAgreementLink.kt`, 관련 XML/resource.
- 테스트: `GiftNavigationTest`의 profile URL 요청과 파손 정책 hit-area/state 보존 test.
- 검증: focused test, gift package test, 전체 local unit test, resource merge, compile, assemble, diff-check.
## 4. 발견 사항
| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
|---|---|---|---|---|---|
| `REV-P7-001` | Low | 수정 완료 | PRD의 파손 정책 클릭 대상이 계획·구현과 달리 `(필수)`로 기록됨 | 문서 정합성 | PRD를 승인된 `(자세히보기)`로 정정 |
### REV-P7-001 — 파손 정책 클릭 대상 문서 불일치
- **관찰:** 계획과 구현·test는 `(자세히보기)`만 정책 URL을 열지만 PRD 세 위치는 `(필수)`로 기록돼 있었다.
- **조치:** `GIFT-AGREE-005`, 성공 기준 14.5, `DEC-013`을 `(자세히보기)`로 정정했다. 링크 hit 범위는 넓히지 않았다.
- **영향:** production 동작 변경 없음. 승인된 계획과 PRD의 추적성만 복구한다.
## 5. 리뷰 종료 판정
**최종 결론:** 문서 정합성 수정 완료. 코드 회귀 finding 없음.
**남은 항목:** 없음.
## 6. 후속 요구사항 반영 — 2026-10-08
- 사용자의 후속 요청으로 `REV-P7-001` 당시 기준이었던 `(자세히보기)` 링크는 supersede됐다.
- 파손 정책은 기존 `(필수)` span으로 열고 `(자세히보기)`는 제거했다. URL·체크 상태·CTA 계산은 유지했다.
- 받는 크리에이터 프로필 이미지 요청에 기존 Coil `CircleCropTransformation`을 적용했다. URL·blank·placeholder/error 동작은 유지했다.
- `GiftNavigationTest` RED 2건을 확인한 뒤 focused test와 gift package test, resource merge, Kotlin compile, ktlint, diff check를 통과했다.