docs(gift): 선물 자격 조건 구현과 리뷰를 기록한다
This commit is contained in:
@@ -920,6 +920,50 @@ GIT_MASTER=1 git diff --check HEAD
|
||||
- [x] **GREEN 확인:** focused test와 gift package test를 실행해 PASS를 기록한다.
|
||||
- [x] **회귀 검증:** resource merge, Kotlin compile, ktlint, diff check 결과를 Verification Log에 누적한다.
|
||||
|
||||
## Phase 8: 크리에이터 채널 선물 버튼 지역·언어 gate
|
||||
|
||||
**Phase 결과:** 크리에이터 채널의 선물 보내기 버튼이 기존 자격 조건과 한국 접속·유효 언어 한국어 조건을 모두 만족할 때만 표시되고 진입한다.
|
||||
|
||||
**선행조건:** PRD `GIFT-ENTRY-004`, `DEC-017` 확정.
|
||||
|
||||
**Phase 완료 조건:** `P8-T1`, `P8-GATE` 완료, PRD와 Verification Log 갱신.
|
||||
|
||||
### Task 8.1 선물 버튼 지역·언어 자격 조건
|
||||
|
||||
**Goal 실행 `P8-T1`:** 기존 `GiftInboxEntryPolicy`를 재사용해 크리에이터 채널 선물 버튼의 표시·클릭 조건을 동일하게 제한한다.
|
||||
|
||||
**Files:**
|
||||
|
||||
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/creator/channel/CreatorChannelActivity.kt`
|
||||
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/creator/channel/CreatorChannelGiftEligibilityTest.kt`
|
||||
|
||||
- [x] **RED:** 비소유자·DM 가능·`KR`·`ko`이면 true이고, 언어가 `en`이거나 국가가 `JP`이면 false인 테스트를 작성한다.
|
||||
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.creator.channel.CreatorChannelGiftEligibilityTest" --rerun`을 실행해 새 함수 계약 부재로 실패함을 기록한다.
|
||||
- [x] **GREEN:** `canSendCreatorGift`가 기존 소유자·DM 조건과 `GiftInboxEntryPolicy.shouldShow(countryCode, languageCode)`를 함께 검사하도록 최소 수정한다.
|
||||
- [x] **GREEN:** `bindHeader()`와 클릭 listener에서 `SharedPreferenceManager.countryCode`, `LanguageManager.getEffectiveLanguage(this)`를 같은 함수에 전달한다.
|
||||
- [x] **GREEN 확인:** 같은 focused test와 `GiftInboxEntryPolicyTest`가 통과함을 기록한다.
|
||||
- [x] **REFACTOR:** 별도 정책·wrapper·dependency를 추가하지 않고 기존 두 정책 재사용만 유지한다.
|
||||
|
||||
검증 기록:
|
||||
|
||||
- 2026-10-08: 신규 국가·언어 인자를 요구하는 테스트를 먼저 작성했고 기존 2개 인자 함수에서 `No parameter with name 'countryCode'`, `No parameter with name 'languageCode'` 컴파일 실패로 RED를 확인했다. 기존 `GiftInboxEntryPolicy`를 조합한 뒤 `CreatorChannelGiftEligibilityTest`와 `GiftInboxEntryPolicyTest`가 `BUILD SUCCESSFUL in 13s`로 통과했다.
|
||||
|
||||
### Task 8.2 통합 Gate
|
||||
|
||||
**Goal 실행 `P8-GATE`:** 지역·언어 gate와 기존 크리에이터 채널·선물함 자격 조건의 회귀 여부를 판정한다.
|
||||
|
||||
- [x] 관련 focused local unit test를 실행한다.
|
||||
- [x] 전체 local unit test, Kotlin compile, ktlint, debug assemble을 실행한다.
|
||||
- [x] `GIT_MASTER=1 git diff --check HEAD`를 실행한다.
|
||||
- [x] 실제 결과를 Task와 Verification Log에 기록한다.
|
||||
|
||||
```bash
|
||||
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.creator.channel.CreatorChannelGiftEligibilityTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxEntryPolicyTest" --rerun
|
||||
./gradlew :app:testDebugUnitTest --rerun
|
||||
./gradlew :app:compileDebugKotlin :app:ktlintCheck :app:assembleDebug
|
||||
GIT_MASTER=1 git diff --check HEAD
|
||||
```
|
||||
|
||||
## Decision Log
|
||||
|
||||
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 |
|
||||
@@ -937,6 +981,7 @@ GIT_MASTER=1 git diff --check HEAD
|
||||
| `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` |
|
||||
| `2026-10-08` | `DEC-014` | 정정 | 크리에이터 채널 선물 버튼은 기존 소유자·DM 조건과 `GiftInboxEntryPolicy`의 한국 접속·유효 언어 한국어 조건을 모두 만족할 때만 표시·진입한다. | 사용자 후속 요청과 승인된 최소 설계 | `P8-T1`, `P8-GATE` |
|
||||
|
||||
## 발견된 문제
|
||||
|
||||
@@ -946,6 +991,8 @@ GIT_MASTER=1 git diff --check HEAD
|
||||
|
||||
## Verification Log
|
||||
|
||||
- 2026-10-08: Phase 8 RED에서 `countryCode`, `languageCode` 인자 부재로 `compileDebugUnitTestKotlin FAILED`를 확인했다. 최소 구현 후 `CreatorChannelGiftEligibilityTest`와 `GiftInboxEntryPolicyTest`가 `BUILD SUCCESSFUL in 13s`로 통과했다. 이어 `./gradlew :app:testDebugUnitTest --rerun :app:compileDebugKotlin :app:ktlintCheck :app:assembleDebug`가 `BUILD SUCCESSFUL in 1m 21s`, `GIT_MASTER=1 git diff --check HEAD`가 무출력으로 통과했다. 읽기 전용 코드 리뷰는 차단 이슈 없이 승인됐고 문서 검증 기록 누락만 완료 전에 보정했다. 기기·에뮬레이터·androidTest·시각 QA는 저장소 규칙에 따라 실행하지 않았다.
|
||||
|
||||
- 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는 저장소 규칙에 따라 실행하지 않았다.
|
||||
|
||||
@@ -0,0 +1,44 @@
|
||||
# Phase 8 크리에이터 채널 선물 자격 조건 리뷰
|
||||
|
||||
## 1. 리뷰 정보
|
||||
|
||||
| 항목 | 내용 |
|
||||
|---|---|
|
||||
| 리뷰 대상 | Phase 8 / `P8-T1`, `P8-GATE` |
|
||||
| 기준 commit 또는 working tree | 미커밋 working tree |
|
||||
| 리뷰 일자 | `2026-10-08` |
|
||||
| 리뷰어 | Oracle read-only reviewer |
|
||||
| 기준 문서 | `docs/20261001_선물_보내기_신청_페이지/prd.md`, `docs/20261001_선물_보내기_신청_페이지/plan-task.md` |
|
||||
| 리뷰 상태 | 판정 완료 |
|
||||
|
||||
## 2. 리뷰 목적과 범위
|
||||
|
||||
- `GIFT-ENTRY-004`, `DEC-017`의 한국 접속·유효 언어 한국어 조건이 버튼 표시와 클릭 진입에 동일하게 적용되는지 확인한다.
|
||||
- 기존 소유자·DM 가능 조건과 선물함의 빈 국가 코드 정책이 보존되는지 확인한다.
|
||||
- 대상은 `CreatorChannelActivity.kt`, `CreatorChannelGiftEligibilityTest.kt`, Phase 8 문서 변경이다.
|
||||
- 기기·에뮬레이터 UI 검증은 저장소 규칙에 따라 제외한다.
|
||||
|
||||
## 3. 검토한 근거
|
||||
|
||||
- 코드: `CreatorChannelActivity.kt`의 버튼 클릭, `bindHeader()`, `canSendCreatorGift()`.
|
||||
- 정책: `GiftInboxEntryPolicy.shouldShow(countryCode, languageCode)`.
|
||||
- 테스트: `CreatorChannelGiftEligibilityTest`, `GiftInboxEntryPolicyTest`.
|
||||
- 자동 검증: focused test, 전체 local unit test, Kotlin compile, ktlint, debug assemble, diff check.
|
||||
|
||||
## 4. 발견 사항
|
||||
|
||||
확정된 코드·테스트 발견 사항은 없다. 리뷰 시점에 Phase 8 체크박스와 Verification Log가 미갱신 상태였으며, 완료 보고 전에 실제 실행 결과로 보정했다.
|
||||
|
||||
## 5. 리뷰 종료 판정
|
||||
|
||||
| 판정 항목 | 결과 | 근거 |
|
||||
|---|---|---|
|
||||
| 표시·클릭 조건 일치 | 충족 | 두 경로가 동일한 네 인자를 `canSendCreatorGift()`에 전달한다. |
|
||||
| 기존 소유자·DM 조건 보존 | 충족 | 기존 조건에 `GiftInboxEntryPolicy` 결과만 AND로 추가했다. |
|
||||
| 지역·언어 정책 재사용 | 충족 | 별도 정책 없이 `GiftInboxEntryPolicy`를 호출한다. |
|
||||
| 회귀 테스트 | 충족 | `KR/ko`, `KR/en`, `JP/ko`, 소유자·DM 조합을 검증한다. |
|
||||
| 확정 항목 plan 반영 | 해당 없음 | 코드 수정이 필요한 finding이 없다. |
|
||||
|
||||
**최종 결론:** 차단 이슈 없이 승인.
|
||||
|
||||
**남은 항목:** 없음.
|
||||
Reference in New Issue
Block a user