docs(gift): 받은 선물 구현 기록을 정리한다

This commit is contained in:
2026-10-02 23:55:27 +09:00
parent 5f2965b915
commit 68867cf8c8
5 changed files with 597 additions and 1 deletions
@@ -0,0 +1,85 @@
# Phase 7 최종 코드 리뷰
## 1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 리뷰 대상 | Phase 7 전체 |
| 기준 commit 또는 working tree | 미커밋 working tree |
| 리뷰 일자 | 2026-10-02 |
| 리뷰어 | Sisyphus, Oracle |
| 기준 문서 | `prd.md`, `plan-task.md`, 기존 Phase 7 리뷰 3개 |
| 리뷰 상태 | 완료 |
## 2. 리뷰 목적과 범위
- 받은 선물 상태·개인정보·배송지 입력·POST·재조회·목록 갱신의 최종 정합성을 검토한다.
- Phase 7 production, local unit test, resource, 문서를 포함한다.
- 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 저장소 규칙에 따라 제외한다.
## 3. 판정 기준
- 심각도와 상태는 `docs/sample/sample-review.md`를 따른다.
- PRD 위반, 개인정보 노출, 기존 Gift 회귀, 저장소 테스트 정책 위반을 확정 finding으로 전환한다.
## 4. 검토한 근거
- PRD: `GIFT-RECEIVED-*`, `GIFT-ADDRESS-FORM-*`, `GIFT-POSTCODE-*`, `DEC-017`~`020`.
- 계획: `P7-T1`~`P7-T5`, `P7-R1`~`R3`, `P7-GATE`.
- 사전 Gate: gift/modal 180개, 전체 unit 1,447개, resource/compile/ktlint, assembleDebug, diff check 모두 성공.
- 코드·테스트: Phase 7 변경 파일과 기존 SENT/tracking/cancel 영향 범위.
## 5. 발견 사항 요약
| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
|---|---|---|---|---|---|
| `REV-P7-GATE-001` | Medium | 수정 완료 | Navigation test가 visibility와 View 자식 순서를 직접 검증함 | `P7-R4` | 금지 assertion 제거와 동작 검증 유지 |
| `REV-P7-GATE-002` | Low | 수정 완료 | 배송지 입력 전 헤더가 `선물 받기` 대신 `선물 상세`를 사용함 | `P7-R4` | AddressForm 전용 헤더 분기와 회귀 test |
## 6. 발견 사항 상세
### REV-P7-GATE-001 — 레이아웃 속성 직접 검증
- **심각도:** Medium
- **상태:** 확정
- **관련 요구사항:** AGENTS.md UI 테스트 정책, PRD 14.4
- **소유 Task:** `P7-R4`
- **근거:** `GiftNavigationTest`가 `isVisible`과 `indexOfChild(sectionSeparator)`를 직접 assertion한다.
- **권장 조치:** 해당 assertion만 제거하고 상태 전환 후 추가 POST 0회, 정보 행과 제목 같은 허용된 동작 검증을 유지한다.
### REV-P7-GATE-002 — 배송지 입력 헤더 분기 누락
- **심각도:** Low
- **상태:** 확정
- **관련 요구사항:** PRD 9.2 받은 선물 배송지 입력 전 고정 `선물 받기` header
- **소유 Task:** `P7-R4`
- **근거:** `GiftDetailActivity.bindReceived()`가 모든 received mode에 `gift_recipient_detail_title`을 적용한다.
- **권장 조치:** AddressForm이면 기존 `gift_recipient_receive`, 나머지 received mode이면 `gift_recipient_detail_title`을 사용한다.
## 7. 확정 항목의 plan·goal 전환
두 finding을 `plan-task.md`의 `P7-R4`로 전환했다.
## 8. 리뷰 종료 판정
| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 리뷰 범위 전체 확인 | 충족 | Phase 7 코드·테스트·문서 대조 |
| 후보 항목 판정 완료 | 충족 | 2건 확정 |
| 확정 항목 plan 반영 | 충족 | `P7-R4` 등록 |
| 보류 항목의 담당·재개 조건 기록 | 해당 없음 | 외부 차단 없음 |
| 검증 명령과 결과 기록 | 충족 | 수정 후 focused·전체 Gate 통과 |
**최종 결론:** APPROVED
**남은 항목:** 없음
## 9. 수정 후 검증 기록
- AddressForm 헤더 test는 production 수정 전 `expected:<선물 [받기]> but was:<선물 [상세]>`로 RED를 확인했다.
- `GiftDetailActivity.bindReceived()`는 AddressForm에 기존 `gift_recipient_receive`, 그 외 RECEIVED mode에 기존 `gift_recipient_detail_title`을 사용하도록 최소 수정했다.
- `GiftNavigationTest`에서 금지된 visibility·View 자식 순서 assertion을 제거하고 추가 POST 방지·정보 행·상태별 제목 검증을 유지했다.
- parent fresh `GiftNavigationTest` 21개는 `BUILD SUCCESSFUL in 18s`, resource/compile/ktlint는 `BUILD SUCCESSFUL in 1s`였다.
- Oracle 재검토는 `REV-P7-GATE-001`, `REV-P7-GATE-002` 모두 RESOLVED, P7-R4 APPROVED, 신규 finding 없음으로 판정했다.
- 수정 후 P7-GATE를 직렬 재실행했다. gift/modal 180개와 전체 local unit 1,447개는 failures/errors/skipped=0이며 resource/compile/ktlint와 assembleDebug가 성공했다.
- 전체 `git diff --check HEAD`와 staging 확인은 무출력이었다. 저장소 정책에 따라 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 실행하지 않았다.
@@ -0,0 +1,91 @@
# Phase 7 배송지 성공 재조회·목록 갱신 코드 리뷰
## 1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 리뷰 대상 | Phase 7 / P7-T5 |
| 기준 commit 또는 working tree | 미커밋 working tree |
| 리뷰 일자 | 2026-10-02 |
| 리뷰어 | Sisyphus, Oracle |
| 기준 문서 | `prd.md`, `plan-task.md` P7-T5 |
| 리뷰 상태 | 판정 완료 |
## 2. 리뷰 목적과 범위
### 목적
- 배송지 POST 성공이 같은 신청번호의 상세 GET 재조회와 목록 갱신 결과로 연결되는지 확인한다.
- POST 응답 합성이나 개인정보 Intent·result·saved state 저장 없이 기존 Boolean 변경 marker를 재사용하는지 확인한다.
### 포함 범위
- 코드: `GiftDetailActivity.kt`, 기존 recipient/detail/inbox ViewModel과 Activity result 연결.
- 테스트: `GiftNavigationTest`, `GiftDetailViewModelTest`, `GiftRecipientAddressViewModelTest`, `GiftInboxViewModelTest`.
- 문서: PRD 받은 선물 요구사항과 `P7-T5`.
### 제외 범위
- P7-R3 이전 상태 전환·지역화 finding, 신규 UI 설계, P7-GATE 전체 회귀.
- 기기·에뮬레이터·androidTest·스크린샷·시각 QA.
## 3. 판정 기준
- Blocker/High/Medium/Low 심각도와 후보/확정/오탐/보류/수정 완료 상태는 `docs/sample/sample-review.md`를 따른다.
- 확정 요구사항 위반, 중복 요청, PII 저장, POST 응답 기반 상세 합성, 기존 목록 갱신 회귀를 차단 finding으로 본다.
## 4. 검토한 근거
### 문서와 코드
- 요구사항: `GIFT-RECEIVED-001`, `GIFT-ADDRESS-FORM-005`, `DEC-019`.
- 계획: `P7-T5`.
- 코드: `GiftDetailActivity.observe`, `GiftRecipientAddressViewModel.consumeRecipientAddressSuccessEvent`, `GiftDetailViewModel.reloadAfterRecipientAddressSuccess`, `GiftInboxActivity` result launcher.
- 테스트: `받은 선물 진입 후 주소 성공은 같은 상세를 한 번 재조회하고 완료 결과로 목록을 갱신한다`와 관련 focused suite.
### 실행 환경
```text
OS: macOS
검증: Android local unit test, resource merge, Kotlin compile, ktlint
제외: 기기·에뮬레이터·androidTest·스크린샷
```
### 실행한 검증
| 명령 또는 수동 검증 | 결과 | 핵심 증거 |
|---|---|---|
| 4개 focused test class `--rerun` | 성공 | `BUILD SUCCESSFUL in 19s`, 57 tests, failures/errors/skipped=0 |
| `:app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck` | 성공 | `BUILD SUCCESSFUL in 1s` |
| 명세 리뷰 | 승인 | 모든 P7-T5 코드 요구사항 MET, 문서 반영만 후속 처리 |
| 코드 품질 리뷰 | 승인 | Critical/Important/Minor finding 없음 |
## 5. 발견 사항 요약
확정 발견 사항 없음.
## 6. 발견 사항 상세
없음.
## 7. 확정 항목의 plan·goal 전환
전환 항목 없음.
## 8. 리뷰 종료 판정
| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 리뷰 범위 전체 확인 | 충족 | 성공 event부터 상세 GET·RESULT_OK·목록 refresh까지 대조 |
| 후보 항목 판정 완료 | 충족 | 확정 finding 없음 |
| 확정 항목 plan 반영 | 해당 없음 | 신규 회귀 Task 불필요 |
| 보류 항목의 담당·재개 조건 기록 | 해당 없음 | 외부 차단 없음 |
| 검증 명령과 결과 기록 | 충족 | focused 57개와 resource/compile/ktlint 기록 |
**최종 결론:** 확정 발견 사항 없음, APPROVED
**남은 항목:** `P7-GATE` 전체 회귀 검증
## 9. 수정 후 검증 기록
수정 finding이 없어 해당 없음.
@@ -0,0 +1,79 @@
# Phase 7 받은 선물 배송지 UI 코드 리뷰
## 1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 리뷰 대상 | Phase 7 / P7-T4 |
| 기준 commit 또는 working tree | 미커밋 working tree |
| 리뷰 일자 | 2026-10-02 |
| 리뷰어 | Sisyphus, Oracle |
| 기준 문서 | `prd.md`, `plan-task.md`, Figma `2531:36290`, `2531:36399`, `2531:36330`, `2531:36422` |
| 리뷰 상태 | 수정 후 승인 |
## 2. 리뷰 목적과 범위
- 배송지 form, Kakao 결과 연결, 받은 선물 4개 상태와 action이 PRD 및 Figma 구조를 충족하는지 확인했다.
- `GiftDetailActivity`, `activity_gift_detail.xml`, 한/영/일 문자열과 `GiftNavigationTest`를 검토했다.
- P7-T5의 성공 후 상세 재조회와 목록 변경 marker는 제외했다.
## 3. 검토한 근거
- 우편번호 성공은 현재 form의 우편번호·주소만 변경하고 상세 주소에 focus를 요청한다.
- 비정상 결과는 form을 갱신하지 않으며 테스트가 객체 동일성을 검증한다.
- 입력 View에는 `saveEnabled=false`가 적용되고 PII를 Intent·Bundle·로그에 저장하지 않는다.
- Figma parent design context는 timeout됐고 metadata와 하위 노드 `2531:36321`, `2531:36431`, `2531:36401`, `2531:36335`를 대조했다.
## 4. 발견 사항 요약
| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
|---|---|---|---|---|---|
| `REV-P7-T4-001` | High | 확정 | 받은 선물 header가 `선물 상세` 대신 SENT용 `신청 상세`를 사용함 | `P7-R2` | 전용 title과 회귀 test |
| `REV-P7-T4-002` | Low | 확정 | 전달 완료 action과 선물 정보 사이 divider 누락 | `P7-R2` | 기존 divider 조건 보완 |
| `REV-P7-T4-003` | Low | 확정 | 이용 약관 동의와 사유 섹션 header 누락 | `P7-R2` | Figma 문구 header 추가 |
| `REV-P7-T4-004` | High | 수정·검증 완료 | Loading/Error에서도 이전 배송지 CTA가 남아 제출 가능 | `P7-R3` | 현재 AddressForm mode로 CTA·progress 제한 |
| `REV-P7-T4-005` | High | 수정·검증 완료 | 수신 상태가 바꾼 정보 visibility와 divider 순서를 다음 bind에서 복원하지 않음 | `P7-R3` | 공통 기본 상태·순서 복원 |
| `REV-P7-T4-006` | Low | 수정·검증 완료 | 완료 hero와 주소 삭제 안내가 한국어 Raw 값으로 고정됨 | `P7-R3` | `GiftDetailText.Key` 지역화 |
## 5. plan·goal 전환
`REV-P7-T4-001`~`003`은 `P7-R2`, 코드 품질 검토에서 확정된 `REV-P7-T4-004`~`006`은 `P7-R3`로 전환했다. 기존 완료 Task 기록은 다시 열거나 삭제하지 않는다.
## 6. 리뷰 종료 판정
| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 리뷰 범위 전체 확인 | 충족 | 코드·테스트·PRD·Figma metadata/context 대조 |
| 후보 항목 판정 완료 | 충족 | 6건 확정 |
| 확정 항목 plan 반영 | 충족 | `P7-R2`, `P7-R3` 등록 |
| 검증 명령과 결과 기록 | 충족 | P7-R2·P7-R3 focused 검증과 재검토 누적 |
**최종 결론:** APPROVED
**남은 항목:** 없음. P7-T5 성공 재조회·목록 marker는 기존 리뷰 범위 밖으로 유지한다.
## 7. 수정 후 검증 기록
### 1차 수정 검증 — 2026-10-02
- 무엇을: `REV-P7-T4-001`~`003`을 해결했다.
- 왜: 받은 선물 고정 title과 Figma divider·섹션 계층 누락을 해소하기 위해서다.
- 어떻게:
- 제목 test RED에서 `신청 상세` 오출력을 확인하고 RECEIVED 전용 title로 수정했다.
- Figma 하위 context와 XML을 대조해 Delivered divider, `이용 약관 동의`, `사유`를 추가했다.
- focused 43개, resource/compile/ktlint, diff check를 통과했다.
- 명세 재검토에서 세 항목 모두 RESOLVED/APPROVED 판정을 받았다.
- 남은 항목: 코드 품질 검토의 `REV-P7-T4-004`~`006`.
### 2차 수정 검증 — 2026-10-02
- 무엇을: `REV-P7-T4-004`~`006`을 해결했다.
- 왜: 동일 Activity에서 이전 배송지 form 상태가 Loading/Error·다른 상세에 남는 문제와 완료 문구의 한국어 고정을 해소하기 위해서다.
- 어떻게:
- 현재 `AddressForm` 렌더 여부로 CTA·progress 표시와 submit을 함께 제한했다.
- 공통 bind가 선물 정보 visibility와 divider 기본 위치를 먼저 복원하도록 했다.
- 완료 hero·주소 삭제 안내 3개를 `GiftDetailText.Key`와 한/영/일 resource로 연결했다.
- fresh focused 실행은 `BUILD SUCCESSFUL in 20s`, navigation 20개, presenter 24개, recipient ViewModel 8개, detail ViewModel 17개로 총 69개가 failures/errors/skipped=0이다.
- resource merge·Kotlin compile·ktlint는 `BUILD SUCCESSFUL in 1s`였다.
- 품질 재검토에서 세 finding 모두 RESOLVED, 최종 APPROVED 판정을 받았다.
- 남은 항목: 없음. P7-T5는 별도 Task에서 검증한다.
@@ -0,0 +1,55 @@
# Phase 7 배송지 ViewModel 코드 리뷰
## 1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 리뷰 대상 | Phase 7 / P7-T3 |
| 기준 commit 또는 working tree | 미커밋 working tree |
| 리뷰 일자 | 2026-10-02 |
| 리뷰어 | Sisyphus, Oracle |
| 기준 문서 | `prd.md`, `plan-task.md` |
| 리뷰 상태 | 판정 완료 |
## 2. 리뷰 목적과 범위
- 배송지 form validation, POST 요청 매핑, 중복 제출 차단, 실패 복구, 성공 후 상세 재조회 이벤트가 확정 계약과 일치하는지 확인했다.
- `GiftRecipientAddressViewModel`, 관련 `GiftDetailViewModel`, Koin 등록, 한/영/일 문자열과 focused local unit test를 검토했다.
- Activity UI, Kakao 주소 검색 연결, 받은 선물 라우팅은 P7-T4와 P7-T5 범위이므로 제외했다.
## 3. 검토한 근거
- 코드: `GiftRecipientAddressViewModel.kt`, `GiftDetailViewModel.kt`, `AppDI.kt`, `values*/strings.xml`
- 테스트: `GiftRecipientAddressViewModelTest.kt`, `GiftDetailViewModelTest.kt`
- 문서: `P7-T3`, `S7-01`, `S7-02`, `S7-07`
| 명령 또는 검토 | 결과 | 핵심 증거 |
|---|---|---|
| focused local unit test `--rerun` | 성공 | JUnit XML 기준 8개 + 17개 = 25개 |
| `:app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck` | 성공 | lint 서식 수정 후 `BUILD SUCCESSFUL` |
| `GIT_MASTER=1 git diff --check HEAD` | 성공 | 출력 없음 |
| 명세 검토 | APPROVED | 계약 누락·범위 초과 없음 |
| 코드 품질·보안 검토 | APPROVED | 차단 결함 및 PII 노출 없음 |
## 4. 발견 사항 요약
확정 발견 사항 없음.
비차단 잔여 위험은 Activity lifecycle에서의 이벤트 소비와 실제 scheduler 전환이며, 각각 P7-T4 연결 테스트와 Phase Gate에서 확인한다.
## 5. plan·goal 전환
전환 항목 없음.
## 6. 리뷰 종료 판정
| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 리뷰 범위 전체 확인 | 충족 | 코드·테스트·DI·리소스 검토 완료 |
| 후보 항목 판정 완료 | 충족 | 차단 finding 없음 |
| 확정 항목 plan 반영 | 해당 없음 | 확정 발견 사항 없음 |
| 검증 명령과 결과 기록 | 충족 | focused 25개, compile/resource/ktlint, diff check 성공 |
**최종 결론:** 확정 발견 사항 없음
**남은 항목:** P7-T4 Activity/UI 연결과 P7-T5 라우팅 검증