docs(gift): 운송장 화면 리뷰를 기록한다
This commit is contained in:
@@ -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.
|
||||||
|
- 남은 항목: 없음
|
||||||
Reference in New Issue
Block a user