docs(gift): 운송장 구현 검증을 기록한다

docs/20261006_선물_UI_추가/reviews/phase6-tracking-mutations.md

@@ -0,0 +1,49 @@
+# Phase 6 운송장 mutation 리뷰
+
+## 1. 리뷰 정보
+
+| 항목 | 내용 |
+|---|---|
+| 리뷰 대상 | Phase 6 / `P6-T3` |
+| 기준 commit 또는 working tree | working tree |
+| 리뷰 일자 | 2026-10-07 |
+| 리뷰어 | 기능 Oracle |
+| 기준 문서 | `prd.md`, `plan-task.md` |
+| 리뷰 상태 | 판정 완료 |
+
+## 2. 리뷰 목적과 범위
+
+- 운송장 validation·등록과 확인된 신청 취소가 기존 API 계약을 사용하고 상호 중복되지 않는지 확인한다.
+- 성공 후 로컬 상태를 만들지 않고 동일 신청번호 상세 route로 guarded replace한 뒤 서버 상세를 재조회하는지 확인한다.
+- 인증 실서버와 실제 기기의 toast·alert·navigation 조작은 현재 실행 환경에서 제외한다.
+
+## 3. 검토한 근거
+
+- 코드: `GiftTrackingRegistrationViewModel.swift`, `GiftTrackingRegistrationView.swift`, `GiftRepository.swift`, `GiftApi.swift`, `AppState.swift`
+- RED: P6-T3 API 부재 compile 실패와 `.trackingRegistered` 취소 허용 assertion 실패를 확인
+- GREEN: `GiftTrackingRegistrationCheck` 62개 assertion 성공
+- build: `SodaLive-dev`, `SodaLive` generic iOS Debug build 성공
+- 정적 검증: Swift parse, `plutil -lint`, `git diff --check` 성공
+
+## 4. 발견 사항 요약
+
+확정 발견 사항 없음.
+
+초기 구현 검토 중 `.received`가 아닌 상태에서도 `canCancel`이 참이 될 수 있는 누락을 확인했으며, production 수정 전에 focused RED를 추가한 뒤 `summary.status == .received` 조건으로 수정하고 62개 전체 assertion을 재실행했다.
+
+## 5. plan·goal 전환
+
+전환 항목 없음.
+
+## 6. 리뷰 종료 판정
+
+| 판정 항목 | 결과 | 근거 |
+|---|---|---|
+| validation·request mapping | 충족 | 택배사 표시명 보존, 운송장 양끝 공백 제거 |
+| 등록·취소 중복 차단 | 충족 | 단일 `isSubmitting` lock과 완료 latch |
+| 확인 이후 취소 | 충족 | destructive alert action만 `confirmCancel()` 호출 |
+| 성공 후 최신 상세 | 충족 | guarded replace, 거부 시 GET 복구, 로컬 status 미생성 |
+| focused test·build | 충족 | 62 assertions, 양 스킴 `BUILD SUCCEEDED` |
+| 인증 runtime 검증 | 미충족 | 로그인·실서버 환경 부재 |
+
+**최종 결론:** 코드와 compile/build 범위에서 승인. 인증 runtime 검증은 Phase 6 Gate의 잔여 항목으로 유지한다.