docs(gift): 선물함 통합 리뷰를 기록한다

This commit is contained in:
2026-10-01 21:20:40 +09:00
parent 73b332467f
commit 84aff9f6ec
@@ -0,0 +1,107 @@
# Phase 4 선물함 통합 리뷰
## 1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 리뷰 대상 | Phase 1~4 / 선물함 목록 API·상태·UI·통합 검증 |
| 기준 commit 또는 working tree | 현재 브랜치의 `HEAD` 대비 미커밋 변경 |
| 리뷰 일자 | 2026-10-01 |
| 리뷰어 | Sisyphus 및 독립 reviewer 5개 lane |
| 기준 문서 | `prd.md`, `plan-task.md`, `AGENTS.md` |
| 리뷰 상태 | 판정 완료 |
## 2. 리뷰 목적과 범위
### 목적
- 확정 요구사항과 API 계약이 production 코드·테스트·리소스에 일치하는지 확인한다.
- 완료 기록과 실제 테스트·빌드 결과가 일치하는지 확인한다.
### 포함 범위
- 코드: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/` 및 연결된 DI·manifest
- 테스트: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/`
- 리소스: 신규 선물함 layout·drawable·한/영/일 문자열
- 문서: 현재 작업 디렉터리의 PRD와 구현 계획
### 제외 범위
- 사용자 요청이 없었던 기기·에뮬레이터·UI 계측·시각 QA
- API가 제공하지 않는 상대 닉네임, 취소일, 배송지 마감일의 정확 표시
- 특정 기존 메뉴에서 선물함으로 진입하는 신규 연결
## 3. 판정 기준
- Blocker/High: 보안·핵심 흐름 실패 또는 확정 요구사항 위반
- Medium: 제한된 조건의 기능·복구 문제
- Low: 비차단 테스트 공백·유지보수·보안 강화 권고
## 4. 검토한 근거
### 문서와 코드
- 요구사항: API-001~004, UI-001~005, STATUS-001~003, EMPTY-001~003, BANNER-001~003, INQUIRY-001
- 코드: 변경된 Kotlin/XML/resource/manifest 26개 파일
- 테스트: `GiftInboxPresenterTest`, `GiftInboxViewModelTest` 및 기존 gift 회귀 테스트
### 실행한 검증
| 명령 또는 수동 검증 | 결과 | 핵심 증거 |
|---|---|---|
| `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --rerun :app:mergeDebugResources :app:compileDebugKotlin :app:assembleDebug --console=plain` | 성공 | 50개 테스트, failures/errors/skipped=0, `BUILD SUCCESSFUL in 11s` |
| `./gradlew :app:mergeDebugResources --rerun :app:compileDebugKotlin --rerun :app:packageDebug --rerun :app:assembleDebug --console=plain` | 성공 | resource·compile·APK package 강제 재실행, `BUILD SUCCESSFUL in 1m 34s` |
| `unzip -tq app/build/outputs/apk/debug/app-debug.apk` | 성공 | APK 압축 데이터 오류 없음 |
| `./gradlew :app:ktlintCheck` | 성공 | ktlint error 없음, 기존 `.editorconfig` deprecation 경고만 관찰 |
| `git diff --check HEAD` | 성공 | 출력 없음 |
| 독립 요구사항·품질·보안·문맥 검토 | 성공 | 5개 lane 모두 PASS, 차단 이슈 없음 |
## 5. 발견 사항 요약
| ID | 심각도 | 상태 | 제목 | 후속 처리 |
|---|---|---|---|---|
| `REV-P4-001` | Low | 보류 | 비어 있지 않은 혼합 목록의 관점 필터 테스트 공백 | 구현 결함이 발견되거나 관점 진입점이 추가될 때 보강 |
| `REV-P4-002` | Low | 보류 | 서버·예외 원문을 오류 UI와 toast에 표시 | 사용자 오류 문구 계약이 정해질 때 별도 보안 강화 |
| `REV-P4-003` | Medium | 오탐 | 카카오 문의 HTTP URL 재사용 | 기존 화면과 같은 URL을 쓰라는 확정 요구사항이므로 이번 범위에서 변경하지 않음 |
확정된 Blocker/High/Medium 기능 결함은 없다.
## 6. 발견 사항 상세
### REV-P4-001 — 관점 필터 테스트 공백
- **상태:** 보류
- **관찰:** `GiftInboxPresenter`의 `SENT`/`RECEIVED` 필터 구현은 정상이나, 기존 테스트는 혼합 목록을 `ALL`에서만 검증한다.
- **영향:** 현재 동작 오류는 없고 회귀 검출 범위만 제한된다.
- **재개 조건:** 특정 관점 진입점이 제품 범위에 추가되거나 필터 구현 결함이 재현될 때 기존 presenter 테스트에 혼합 목록 사례를 추가한다.
### REV-P4-002 — 오류 원문 표시
- **상태:** 보류
- **관찰:** `GiftInboxViewModel`은 서버 메시지와 `Throwable.message`를 오류 상태·toast로 전달한다.
- **영향:** 일부 네트워크 기술 정보가 사용자에게 보일 수 있으나 비밀값·개인정보 노출 경로는 확인되지 않았다.
- **재개 조건:** 사용자용 공통 오류 문구 계약이 정해지면 원문 비노출 회귀 테스트와 함께 최소 수정한다.
### REV-P4-003 — 기존 HTTP 문의 URL
- **상태:** 오탐
- **관찰:** 신규 화면은 기존 고객센터와 동일한 `http://pf.kakao.com/_lkxgxhG/chat`을 사용한다.
- **판정:** HTTPS 전환은 보안상 권고할 수 있으나, 기존 문의 페이지와 같은 URL을 사용하라는 확정 요구사항을 정확히 이행한 결과다. 전역 문의 URL 정책 변경 없이 신규 화면만 다르게 만들지 않는다.
## 7. 확정 항목의 plan·goal 전환
전환 항목 없음. 이번 리뷰에서 즉시 수정할 확정 항목이 없다.
## 8. 리뷰 종료 판정
| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 리뷰 범위 전체 확인 | 충족 | 요구사항·QA·품질·보안·문맥 5개 lane 완료 |
| 후보 항목 판정 완료 | 충족 | 2건 보류, 1건 오탐으로 판정 |
| 확정 항목 plan 반영 | 해당 없음 | 차단 또는 즉시 수정 항목 없음 |
| 보류 항목의 재개 조건 기록 | 충족 | 각 상세 항목에 기록 |
| 검증 명령과 결과 기록 | 충족 | local test·resource·compile·APK·lint·diff 검증 기록 |
**최종 결론:** 확정 수정 항목 없음. 리뷰 통과.
**남은 항목:** 기기·에뮬레이터 수동 UI 검증은 사용자 요청이 없어 수행하지 않았다.