diff --git a/docs/20261002_선물_상세와_운송장_등록/reviews/phase3-tracking-screen-review.md b/docs/20261002_선물_상세와_운송장_등록/reviews/phase3-tracking-screen-review.md new file mode 100644 index 00000000..31ad1690 --- /dev/null +++ b/docs/20261002_선물_상세와_운송장_등록/reviews/phase3-tracking-screen-review.md @@ -0,0 +1,104 @@ +# Phase 3 운송장 화면 코드 리뷰 + +## 1. 리뷰 정보 + +| 항목 | 내용 | +|---|---| +| 리뷰 대상 | Phase 3 / P3-T3 | +| 기준 commit 또는 working tree | 현재 미커밋 working tree | +| 리뷰 일자 | 2026-10-02 | +| 리뷰어 | Sisyphus / Oracle | +| 기준 문서 | `prd.md`, `plan-task.md` | +| 리뷰 상태 | 수정 검증 완료 | + +## 2. 리뷰 목적과 범위 + +- 운송장 화면의 Intent/result, 상세 재조회, 입력과 상태 관찰이 요구사항을 충족하는지 확인한다. +- `GiftTrackingActivity`, `GiftTrackingViewModel`, 관련 local unit test와 Android 리소스를 검토한다. +- 기기·에뮬레이터·스크린샷·시각 QA는 저장소 규칙에 따라 제외한다. + +## 3. 판정 기준 + +- Blocker/High/Medium/Low 심각도와 후보/확정/오탐/수정 완료 상태를 사용한다. +- 확정 항목은 수정 전 `plan-task.md`의 신규 회귀 Task로 전환한다. + +## 4. 검토한 근거 + +- 요구사항: `GIFT-TRACKING-001~003`, `GIFT-MAILBOX-001` +- 계획: `P3-T2`, `P3-T3`, `P3-GATE` +- 코드: `GiftTrackingViewModel.kt`, `GiftTrackingActivity.kt`, `GiftDetailActivity.kt` +- 테스트: `GiftTrackingViewModelTest.kt`, `GiftNavigationTest.kt` + +| 명령 또는 검증 | 결과 | 핵심 증거 | +|---|---|---| +| P3-T3 focused 39 tests `--rerun` | 성공 | 39 tests, failures/errors/skipped 0, `BUILD SUCCESSFUL in 1m 27s` | +| `:app:mergeDebugResources :app:compileDebugKotlin --rerun` | 성공 | `BUILD SUCCESSFUL in 1m 4s` | +| 정적 코드·리소스 검토 | 수정 필요 | Toast LiveData가 소비 후 제거되지 않음 | + +## 5. 발견 사항 요약 + +| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal | +|---|---|---|---|---|---| +| `REV-P3-T3-001` | Medium | 수정 완료 | 등록 실패 Toast가 Activity 재생성 시 다시 표시된다 | `P3-R1` | 소비형 Toast와 회귀 test | + +## 6. 발견 사항 상세 + +### REV-P3-T3-001 — 등록 실패 Toast 재표시 + +- **심각도:** Medium +- **상태:** 수정 완료 +- **관련 요구사항:** 운송장 등록 실패 후 입력 유지·재시도 +- **소유 Task:** `P3-R1` + +**관찰 내용** + +`GiftTrackingViewModel`은 실패 Toast를 일반 `MutableLiveData`에 보관하고 제거하지 않는다. Activity가 재생성되어 observer가 다시 연결되면 이전 실패 메시지가 다시 표시된다. + +**근거** + +- 코드: `GiftTrackingViewModel.kt:24-25,103-108` +- 소비 경로: `GiftTrackingActivity.kt:64-66` +- 테스트 공백: `GiftTrackingViewModelTest.kt`는 실패와 재시도는 검증하지만 Toast 소비 후 재관찰 상태는 검증하지 않는다. + +**영향** + +사용자가 실패 후 입력을 수정하거나 재시도하는 동안 오래된 오류 메시지가 화면 재생성 시 중복 노출될 수 있다. + +**권장 조치** + +Toast를 반환하면서 값을 null로 지우는 소비 함수를 추가하고 Activity는 소비된 값만 표시한다. 이전 Toast는 두 번 소비되지 않고 새로운 실패는 다시 소비되는 local unit test를 추가한다. + +**판정 기록** + +- 2026-10-02 — 코드와 observer replay 동작으로 Medium 회귀를 확정하고 `P3-R1`로 전환했다. +- 2026-10-02 — 소비 함수와 회귀 test를 추가하고 원 reviewer 재검토에서 CONFIRMED 판정을 받았다. + +## 7. 확정 항목의 plan·goal 전환 + +- `P3-R1`: `REV-P3-T3-001` Toast 소비 회귀 수정. + +## 8. 리뷰 종료 판정 + +| 판정 항목 | 결과 | 근거 | +|---|---|---| +| 리뷰 범위 전체 확인 | 충족 | P3-T3 코드·리소스·테스트 검토 | +| 후보 항목 판정 완료 | 충족 | 1건 확정 | +| 확정 항목 plan 반영 | 충족 | `P3-R1` | +| 검증 명령과 결과 기록 | 충족 | 39 tests와 resource/Kotlin compile | + +**최종 결론:** 수정 검증 완료 + +**남은 항목:** 없음 + +## 9. 수정 후 검증 기록 + +### 1차 수정 검증 — 2026-10-02 + +- 무엇을: `REV-P3-T3-001`의 실패 Toast를 one-shot으로 소비하도록 수정했다. +- 왜: Activity 재생성 시 오래된 실패 메시지가 재표시되는 회귀를 방지하기 위해서다. +- 어떻게: + - 회귀 test RED — `consumeToast` unresolved reference, `BUILD FAILED in 11s`. + - Phase 3 focused suite — 40 tests, failures/errors/skipped 0, `BUILD SUCCESSFUL in 1m 21s`. + - resource merge와 Kotlin compile — `BUILD SUCCESSFUL in 52s`. + - 원 quality reviewer 재검토 — CONFIRMED. +- 남은 항목: 없음