Files

8.2 KiB

Phase 6 Gift UI 계약 코드 리뷰

1. 리뷰 정보

항목 내용
리뷰 대상 Phase 6 / P6-T1, P6-T2, P6-R1~P6-R3, P6-GATE
기준 commit 또는 working tree 현재 미커밋 working tree
리뷰 일자 2026-10-02
리뷰어 Sisyphus, goal Oracle, QA executor, quality Oracle, security Oracle, context reviewer
기준 문서 prd.md, plan-task.md의 Phase 6 전체
리뷰 상태 수정 검증 완료

2. 리뷰 목적과 범위

목적

  • P6-T1 구현이 승인된 상태·progress·행 카드 계약을 충족하는지 확인한다.
  • P6-T2 운송장 입력·오류·제출 계약과 P6-GATE 완료 증거를 확인한다.
  • 실제 Activity 상태 전이에서 Phase 1~5 동작을 회귀시키지 않는지 확인한다.

포함 범위

  • GiftDetailModels, GiftDetailPresenter, GiftDetailActivity, 상세 행·progress adapter와 layout/resource.
  • GiftTrackingPresenter, GiftTrackingViewModel, GiftTrackingActivity, 운송장 layout/resource.
  • GiftDetailPresenterTest, GiftTrackingPresenterTest, GiftTrackingViewModelTest, GiftNavigationTest의 관련 local test.
  • PRD DEC-013DEC-016, 910장과 Phase 6 Task 전체.

제외 범위

  • 기기·에뮬레이터·androidTest·스크린샷·픽셀 QA.

3. 판정 기준

  • Blocker: 보안·데이터 손실 또는 핵심 흐름 불능.
  • High: 확정 요구사항 위반 또는 주요 회귀.
  • Medium: 제한된 상태에서 발생하는 기능·복구 문제.
  • Low: 비핵심 유지보수성 또는 문서 정합성 문제.

4. 검토한 근거

  • 명세 review: APPROVED. 5개 API 이력, 4구간 projection, 종료 상태 progress 비노출, 동적 취소 본문·7행, 84dp/72dp/12dp 행 계약을 코드와 resource에서 확인했다.
  • quality review: CHANGES REQUESTED. 하단 tracking CTA의 비-content 상태 초기화 누락 1건을 확정했다.
  • 두 review 모두 read-only 소스 검토이며 테스트 실행 결과를 새로 주장하지 않는다.
  • 최종 5-lane review: goal PASS, QA PASS, quality PASS, security 최초 INCONCLUSIVE 후 직접 소스 감사 PASS, context는 REV-P6-REVIEW-001 수정 전 FAIL에서 P6-R3 재검토 PASS로 전환했다.
  • 수정 후 직렬 Gate: gift/modal 149개와 전체 1,416개 failures/errors/skipped=0, resource merge·Kotlin compile·ktlint·assembleDebug 성공, diff check exit 0.

5. 발견 사항 요약

ID 심각도 상태 제목 소유 Task 후속 goal
REV-P6-T1-001 Medium 수정 완료 상세 재조회 Loading/Error에서 이전 운송장 CTA가 남는다 P6-R1 완료
REV-P6-REVIEW-001 Low 수정 완료 stale tracking CTA 회귀 test가 View visibility를 직접 assertion한다 P6-R3 완료

6. 발견 사항 상세

REV-P6-T1-001 - 상세 재조회 중 이전 운송장 CTA 노출

  • 심각도: Medium
  • 상태: 수정 완료
  • 관련 요구사항: GIFT-ACTION-001, UI/UX 9.2
  • 소유 Task: P6-R1

관찰 내용

P6-T1에서 tracking 버튼이 content 밖의 하단 action bar로 이동했지만 GiftDetailActivity.render()는 Loading/Error에서 content만 숨긴다. 직전 content에서 표시된 tracking 버튼은 bind()가 다시 호출되기 전까지 남는다.

근거

  • activity_gift_detail.xml: tracking은 FrameLayout 밖 최상위 자식이다.
  • GiftDetailActivity.kt: render()는 Loading/Error에서 tracking visibility를 초기화하지 않고, bind()에서만 표시 여부를 갱신한다.

재현 또는 검증 절차

  1. trackingRequired=true content를 표시한다.
  2. tracking 성공 후 상세 재조회를 지연하거나 오류로 종료한다.
  3. Loading/Error에서도 이전 tracking CTA가 visible 상태로 남는지 확인한다.
  4. 요구 결과는 비-content 상태에서 CTA가 숨겨지는 것이다.

영향

최신 상세를 확인하지 못한 동안 사용자가 이미 처리된 운송장 화면으로 다시 진입할 수 있다.

권장 조치

render()의 비-content 상태에서 tracking CTA를 숨기고, 지연 가능한 상세 응답을 사용하는 local Robolectric 회귀 test를 추가한다.

판정 기록

  • 2026-10-02 - P6-T1 quality review에서 P6-T1의 layout 부모 변경으로 생긴 회귀로 확정했다.
  • 2026-10-02 - RED 재현, 최소 수정, focused 회귀·compile, 원 reviewer PASS로 수정 완료 판정했다.

REV-P6-REVIEW-001 - stale tracking CTA 회귀 test의 View 속성 직접 검증

  • 심각도: Low
  • 상태: 수정 완료
  • 관련 요구사항: PRD 14.4, 저장소 UI test 정책
  • 소유 Task: P6-R3

관찰 내용

GiftNavigationTest가 tracking.visibility를 View.VISIBLE/GONE과 직접 비교해 화면 결정 로직만 local unit test로 검증한다는 정책을 위반했다.

조치와 근거

  • 기존 stale CTA production 수정은 유지했다.
  • GiftDetailPresenter.showsTrackingAction()으로 상태별 표시 결정을 추출하고 Activity가 매 render에서 사용하게 했다.
  • presenter test가 eligible Content=true, Loading/Error/Canceled/direct CANCELED Content=false를 검증한다.
  • gift test 범위의 visibility 관련 금지 패턴 검색은 0건이며 context·quality 재검토가 PASS했다.

판정 기록

  • 2026-10-02 - 최종 context review에서 정책 위반으로 확정했다.
  • 2026-10-02 - P6-R3 RED/GREEN, 전체 Gate, context·quality 재검토 PASS로 수정 완료 판정했다.

7. 확정 항목의 plan·goal 전환

  • plan-task.md에 P6-R1을 추가했다. 실패 재현 test, 최소 수정, focused 회귀, resource/Kotlin compile, reviewer 재검토를 완료 조건으로 한다.
  • 최종 context review에서 REV-P6-REVIEW-001을 확정하고 plan-task.md에 P6-R3을 추가했다. 기존 production 수정은 보존하면서 View 속성 assertion을 순수 presentation 결정 test로 전환한다.

8. 리뷰 종료 판정

판정 항목 결과 근거
리뷰 범위 전체 확인 충족 Phase 6 Kotlin/XML/resource/test와 5개 review lane 대조
후보 항목 판정 완료 충족 두 review finding 모두 수정 완료
확정 항목 plan 반영 충족 P6-R1, P6-R3 등록·완료
보류 항목의 담당·재개 조건 기록 해당 없음 보류 없음
검증 명령과 결과 기록 충족 P6-R1·P6-R3 RED→GREEN과 수정 후 전체 Gate 기록

최종 결론: Phase 6 수정 검증 완료

남은 항목: 없음

9. 수정 후 검증 기록

1차 수정 검증 - 2026-10-02

  • 무엇을: REV-P6-T1-001의 stale tracking CTA를 비-content 상태에서 숨겼다.
  • 왜: tracking 버튼이 content 밖으로 이동한 뒤 Loading/Error가 이전 visibility를 유지했기 때문이다.
  • 어떻게:
    • 신규 단일 test production 수정 전 실행 - GiftNavigationTest.kt:219에서 1건 실패, BUILD FAILED in 15s.
    • 동일 단일 test 수정 후 실행 - BUILD SUCCESSFUL in 22s.
    • navigation 13개·detail 15개·cancel 12개 - 총 40개, failures/errors/skipped=0, BUILD SUCCESSFUL in 15s.
    • ./gradlew :app:mergeDebugResources :app:compileDebugKotlin - BUILD SUCCESSFUL in 1s.
    • 대상 파일 scoped GIT_MASTER=1 git diff --check - exit 0.
    • 원 quality reviewer 재검토 - PASS, 필수 추가 수정 없음.
  • 남은 항목: P6-T2, Phase 6 통합 Gate와 최종 review.

2차 수정 검증 - 2026-10-02

  • 무엇을: REV-P6-REVIEW-001의 View visibility assertion을 순수 presentation 결정 test로 전환했다.
  • 왜: 저장소 규칙은 UI의 크기·간격·constraint·visibility 직접 assertion을 금지하고 화면 표현 결정 로직 검증만 허용하기 때문이다.
  • 어떻게:
    • production 함수 부재 RED - showsTrackingAction unresolved reference, BUILD FAILED in 5s.
    • presenter 16개 GREEN - BUILD SUCCESSFUL in 16s.
    • navigation/detail/cancel 39개 GREEN - BUILD SUCCESSFUL in 14s.
    • 수정 후 전체 Gate - focused 149개, 전체 1,416개, failures/errors/skipped=0; resource/compile/ktlint·assembleDebug 성공; diff check exit 0.
    • 재검토 - context PASS, quality PASS, 직접 security PASS. 기존 goal·QA PASS와 합쳐 5개 영역 모두 PASS.
  • 남은 항목: 없음.