docs(gift): Phase 12 문구 리뷰를 기록한다

This commit is contained in:
2026-10-08 20:22:50 +09:00
parent 87c788c5dd
commit 1e45f6b89d
@@ -0,0 +1,151 @@
# Phase 12 선물 상세 문구 리뷰 보고서
## 1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 리뷰 대상 | Phase 12 / `P12-T1` 상태별 hero key와 공통 안내 지역화 |
| 기준 commit 또는 working tree | Phase 12 production·resource·test·문서 변경이 반영된 working tree 기준. 특정 commit 기준 리뷰가 아니다. |
| 리뷰 일자 | `2026-10-08` |
| 리뷰어 | 명세 리뷰 에이전트 및 별도 Oracle 코드 품질 리뷰어. 이 보고서는 전달받은 판정과 실행 증거를 기록한다. |
| 기준 문서 | `docs/20261002_선물_상세와_운송장_등록/prd.md` §8.16, 같은 폴더의 `plan-task.md` `P12-T1` |
| 리뷰 상태 | 명세 재검토 PASS, 코드 품질 APPROVED. `P12-GATE` 미실행·대기 |
## 2. 리뷰 목적과 범위
### 목적
- RECEIVED의 세 진행 상태 hero와 SENT/RECEIVED 공통 전달 불가 안내가 승인된 KO/EN/JA 문구에 대응하는지 검토한다.
- 서버 사유 Raw 보존과 기존 상태·주소·action 계약 유지, 계획과 구현의 정합성 및 TDD 증거를 확인한다.
### 포함 범위
- Production: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailModels.kt`, `GiftDetailPresenter.kt`, `GiftDetailActivity.kt`의 key·상태별 매핑·문자열 resolver 변경.
- Resource: `app/src/main/res/values/strings.xml`, `app/src/main/res/values-en/strings.xml`, `app/src/main/res/values-ja/strings.xml`의 해당 문구.
- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenterTest.kt`, `GiftDetailViewModelTest.kt`의 상태·locale·Raw 보존 검증.
- 문서: PRD §8.16, 계획 `P12-T1` 및 해당 실행 증거. PRD §14.10과 `P12-GATE`는 완료 여부 경계만 확인한다.
- 수동 확인: 문서 정합성 대조만 포함한다. 이 보고서 작성에서 코드 재리뷰나 테스트 재실행을 수행한 것으로 간주하지 않는다.
### 제외 범위
- API, 상태 진입 조건, 레이아웃, 색상, action, 주소 노출 정책 변경 및 다른 Phase 재판정.
- 기기·에뮬레이터 조작, `app/src/androidTest`, 스크린샷·시각 QA, View 크기·간격·constraint·visibility 직접 테스트.
- `P12-GATE` 실행과 Phase 12 전체 완료 판정.
## 3. 판정 기준
| 심각도 | 기준 |
|---|---|
| Blocker | 보안·데이터 손실 또는 핵심 흐름 불능 |
| High | 확정 요구사항 위반 또는 주요 회귀 |
| Medium | 제한된 조건의 기능·복구 문제 |
| Low | 문서 정합성, 검증 증거 또는 유지보수성 문제 |
상태는 후보, 확정, 오탐, 보류, 수정 완료로 구분한다. 품질 리뷰의 원래 등급인 Critical/Important/Minor는 그대로 기록한다. 아래 문서·검증 보완 항목은 Low로 분류하며, 품질 리뷰의 Minor 의견은 비차단 수용으로 별도 표시한다.
## 4. 검토한 근거
### 문서와 코드
- PRD §8.16의 `GIFT-RECEIVED-COPY-001`, `GIFT-UNDELIVERABLE-COPY-001`, `GIFT-UNDELIVERABLE-COPY-002`와 승인된 전체 문자열.
- `P12-T1`의 기존 `RECIPIENT_ADDRESS_COMPLETED_TITLE` 재사용, 신규 key 5개, `DISPOSAL_NON_RETURN_GUIDANCE` 공유 및 서버 `GiftDetailText.Raw` 보존 계약.
- `P12-T1`의 resource 이름 정정과 RED/GREEN/REFACTOR 검증 기록.
- 전달받은 1차 명세 `CHANGES_REQUESTED`, 보완 후 2차 명세 `PASS`, 별도 Oracle 코드 품질 `APPROVED` 판정.
- API 계약은 변경하지 않는다. 기존 PRD 11장 계약을 새로 확장하거나 재판정하지 않았다.
### 실행 환경과 증거 출처
- 대상은 Android 프로젝트의 Gradle local unit test다. 작업 환경은 macOS이며 기기·브라우저 실행 환경은 사용하지 않았다.
- 아래 결과는 `2026-10-08`의 전달받은 focused 실행 증거와 `P12-T1` 기록이다. 보고서 작성자는 Read와 apply_patch만 사용하며 Gradle·git 명령을 실행하지 않는다.
### 실행한 검증
기존 실행에 사용된 focused 명령:
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailPresenterTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailViewModelTest" --rerun
```
| 단계 | 결과 | 핵심 증거 |
|---|---|---|
| 최초 focused RED | 예상한 실패 | 43개 테스트 중 2개 의도한 assertion 실패. 기존 공통 hero body의 null 값과 이전 한국어 전달 불가 안내가 원인이다. |
| 최소 구현 후 같은 명령 GREEN | 성공 | `BUILD SUCCESSFUL` |
| multiline Raw 보강 후 같은 명령 재실행 | 성공 | `BUILD SUCCESSFUL in 18s`. 기존 원문 보존 검증이므로 즉시 PASS가 예상되며 production-code RED가 아니다. |
| `P12-GATE` | 미실행·대기 | focused 성공을 Gate 성공으로 대체하지 않는다. |
GREEN과 multiline Raw 재실행의 테스트 수는 별도로 확정해 기록하지 않는다.
## 5. 발견 사항 요약
| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
|---|---|---|---|---|---|
| `REV-P12-001` | Low | 문서 수정 완료, production 결함 판정은 오탐 | 기존 색상과 문구 전용 범위의 문서 충돌 | `P12-T1` | 불필요 |
| `REV-P12-002` | Low | 수정 완료 | 계획 resource 이름과 실제 이름 불일치 | `P12-T1` | 불필요 |
| `REV-P12-003` | Low | 수정 완료 | multiline Raw 보존 테스트 누락 | `P12-T1` | 불필요 |
| `REV-P12-004` | Low | 수정 완료 | TDD 실행 증거 누락 | `P12-T1` | 불필요 |
| `REV-P12-005` | Minor | 비차단 수용 | enum 문자열 이름 기반 테스트의 단순화 의견 | `P12-T1` | 불필요 |
최종적으로 남은 확정 production 결함은 없다. 최초 `CHANGES_REQUESTED`는 아래 보완 후 2차 명세 리뷰에서 PASS로 전환됐다.
## 6. 발견 사항 상세
### REV-P12-001: 색상 요구와 문구 전용 범위 충돌
- 관찰: 1차 명세 리뷰는 기존 색상과 특정 빨간 글자색을 요구하는 문서 표현의 충돌을 지적했다.
- 근거: PRD §8.16과 `P12-T1`은 문구만 변경하며 레이아웃·색상은 제외한다.
- 영향과 조치: production 결함이 아니라 범위 문서의 정합성 문제다. 특정 색상을 요구·검증하는 표현을 공유 안내 문구 요구로 정정하고 기존 레이아웃 색상은 변경하지 않았다.
- 검증·판정 (`2026-10-08`): 1차 `CHANGES_REQUESTED` 후 문서 정정, 2차 명세 PASS. 색상을 production 수정 대상으로 전환하지 않는다.
### REV-P12-002: 계획 resource 이름 불일치
- 관찰: 1차 명세 리뷰에서 계획의 resource 이름과 실제 구현 이름이 일치하지 않았다.
- 근거: `P12-T1`의 신규 resource 5개는 실제 `gift_recipient_*` 명명 관례를 사용한다.
- 영향과 조치: 구현 추적의 문서 오류다. 계획을 `gift_recipient_address_completed_body`, `gift_recipient_inspection_in_progress_title`, `gift_recipient_inspection_in_progress_body`, `gift_recipient_inspection_completed_title`, `gift_recipient_inspection_completed_body`로 정정했다. production resource rename은 하지 않았다.
- 검증·판정 (`2026-10-08`): 이름 정정 후 2차 명세 PASS, 수정 완료.
### REV-P12-003: multiline Raw 보존 검증 누락
- 관찰: 1차 명세 리뷰는 서버 사유의 여러 줄 원문 보존을 직접 검증하는 coverage 부족을 지적했다.
- 근거: `GIFT-UNDELIVERABLE-COPY-002`는 사유를 번역·가공하지 않는 `GiftDetailText.Raw` 계약이다. 관련 테스트는 `GiftDetailPresenterTest.kt`, `GiftDetailViewModelTest.kt`다.
- 영향과 조치: 기존 동작의 검증 공백이며 확정 production 결함은 아니다. 당시 아직 진행 중인 `P12-T1` 안에서 Gate 전에 multiline Raw 회귀 테스트를 추가했다. 완료된 Task를 다시 열거나 production 코드를 수정한 조치가 아니다.
- 검증·판정 (`2026-10-08`): 같은 focused 명령 재실행이 `BUILD SUCCESSFUL in 18s`, 2차 명세 PASS. 기존 동작을 보존하는 테스트이므로 추가 직후 PASS를 production-code RED로 기록하지 않는다.
### REV-P12-004: TDD 증거 누락
- 관찰: 1차 명세 리뷰 시 RED/GREEN 실행 증거가 문서에 충분히 연결되지 않았다.
- 근거: `P12-T1`은 실행 계획과 실제 실행 결과를 구분해야 한다.
- 영향과 조치: 감사 가능한 근거의 누락이다. 최초 43개 테스트 중 예상한 실패 2건, 최소 구현 후 GREEN 성공, multiline Raw 보강 후 18초 성공을 Task 검증 기록에 추가했다.
- 검증·판정 (`2026-10-08`): 문서와 전달받은 증거 대조 후 2차 명세 PASS. 증거 정리를 새 테스트 실행이나 Gate 완료로 취급하지 않는다.
### REV-P12-005: enum 문자열 이름 기반 테스트
- 관찰: 별도 Oracle 코드 품질 리뷰에서 enum을 문자열 이름으로 다루는 테스트의 단순화 의견이 Minor로 제시됐다.
- 근거와 판단: 해당 방식은 신규 enum key가 없는 RED 단계에서도 테스트를 컴파일할 수 있게 했으며, 필요한 매핑이 없으면 여전히 실패한다. 누락된 매핑을 허용하도록 assertion을 완화한 것은 아니다.
- 조치·판정 (`2026-10-08`): 현재 방식을 비차단 Minor로 수용했다. 별도 변경을 요구하지 않으며 코드 품질은 APPROVED다. Critical/Important 발견 사항은 없다.
## 7. 확정 항목의 plan·goal 전환
전환 항목 없음. 문서·resource 이름·실행 증거는 정정됐고 multiline Raw 보강은 아직 활성 상태였던 `P12-T1` 안에서 Gate 전에 수행됐다. 확정 production 결함이 남지 않아 신규 회귀 수정 Task 또는 회귀 수정 goal은 필요하지 않다. 기존 완료 Task와 검증 이력은 유지한다.
## 8. 리뷰 종료 판정
| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 리뷰 범위 전체 확인 | 충족 | 명세 재검토 PASS, 별도 Oracle 품질 APPROVED |
| 후보 항목 판정 완료 | 충족 | 최초 네 항목 해결, Minor 의견 비차단 수용 |
| 확정 항목 plan 반영 | 해당 없음 | 신규 회귀 수정 goal 대상인 확정 production 결함 없음 |
| 보류 항목의 담당·재개 조건 기록 | 해당 없음 | 리뷰 finding 보류 없음. 별도 `P12-GATE`는 대기 상태 유지 |
| 검증 명령과 결과 기록 | 충족 | 최초 RED, GREEN, multiline Raw 재실행 증거를 §4와 `P12-T1`에 연결 |
**최종 결론:** 명세 PASS, 코드 품질 APPROVED. 남은 확정 production 결함 및 신규 회귀 수정 goal 없음.
**남은 항목:** `P12-GATE` 미실행·대기. PRD §14.10은 미완료로 유지한다. 리뷰 승인과 focused 성공만으로 Phase 12 전체 완료를 선언하지 않는다.
## 9. 수정 후 검증 기록
### 1차 명세 보완 및 재검토: 2026-10-08
1. 최초 명세 리뷰는 색상 범위 충돌, 계획 resource 이름 불일치, multiline Raw coverage 누락, TDD 증거 누락으로 `CHANGES_REQUESTED`였다.
2. 문구 전용 범위에 맞게 문서를 정정하고 resource 이름과 실행 증거를 맞췄다. 아직 진행 중인 `P12-T1`에서 multiline Raw 테스트를 보강하고 focused 명령의 `BUILD SUCCESSFUL in 18s`를 확인했다.
3. 보완 후 2차 명세 리뷰는 PASS였다. 별도 Oracle 코드 품질 리뷰는 Critical/Important 없이 APPROVED였고 enum 문자열 이름 기반 테스트 의견은 비차단 Minor로 수용했다.
4. 보고서 등록에서는 문서만 작성·연결한다. 테스트·Gradle·git·기기·androidTest·시각 QA를 실행하지 않으며 `P12-T1` 완료와 `P12-GATE` 대기 상태, PRD §14.10 미완료 및 기존 이력을 보존한다.