Files

4.3 KiB

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.
  • 남은 항목: 없음