docs(gift): 수령지 구현 검증을 기록한다

2026-10-08 12:33:15 +09:00
parent fc52c5e5a5
commit a683f76e16
4 changed files with 200 additions and 0 deletions
@@ -0,0 +1,55 @@
+# Phase 7 받은 상세 기반 리뷰
+
+## 1. 리뷰 정보
+
+| 항목 | 내용 |
+|---|---|
+| 리뷰 대상 | Phase 7 / `P7-T1` |
+| 기준 commit 또는 working tree | working tree |
+| 리뷰 일자 | 2026-10-07 |
+| 리뷰어 | 개인정보·기능 Oracle, 정적 UI Oracle |
+| 기준 문서 | `prd.md`, `plan-task.md` |
+| 리뷰 상태 | 수정 검증 완료 |
+
+## 2. 리뷰 목적과 범위
+
+- 받은 상세 UI가 privacy-safe display model만 사용하고 금지 필드를 구조적으로 참조할 수 없는지 확인한다.
+- 상태명, 기존 5단계 progress, 허용된 선물 정보만 포함하는 `P7-T1` 기반을 검토한다.
+- 배송지 입력·mutation과 상태별 완료 화면은 `P7-T2~T4` 범위이므로 제외한다.
+
+## 3. 검토한 근거
+
+- production source: `GiftDisplayModels.swift`, `GiftDisplayPolicy.swift`, `GiftDetailView.swift`, `ReceivedGiftDetailContentView.swift`
+- privacy check: 16 assertions, 허용 멤버 probe, 금지 멤버 5개 compiler rejection
+- foundation check: component 부재 RED 후 component·received branch integration GREEN
+- build: `SodaLive-dev`, `SodaLive` generic iOS Debug build 성공
+- 정적 검증: Swift parse, `plutil -lint`, `git diff --check` 성공
+
+## 4. 발견 사항 요약
+
+| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
+|---|---|---|---|---|---|
+| `REV-P7-001` | Medium | 수정 완료 | privacy runner가 필수 명령 실패를 마지막 exit 0으로 가릴 수 있음 | `P7-T1` | 완료 |
+
+### REV-P7-001 — privacy runner fail-open
+
+- **관찰:** `set -u`만 사용해 production check compile·assertion·positive probe 실패가 마지막 `exit 0`에 의해 가려질 수 있었다.
+- **수정:** `set -euo pipefail`을 적용했다. 예상된 negative probe는 기존 `if swiftc` 분기를 유지했다.
+- **검증:** 수정 전 필수 `swiftc` 실패 주입은 runner exit 0, 수정 후 같은 실패는 exit 42였다. 정상 privacy·foundation 경로는 모두 성공했다.
+
+## 5. plan·goal 전환
+
+추가 전환 항목 없음. `REV-P7-001`은 `P7-T1` 안에서 수정·검증했다.
+
+## 6. 리뷰 종료 판정
+
+| 판정 항목 | 결과 | 근거 |
+|---|---|---|
+| 개인정보 경계 | 충족 | 안전 모델 allowlist와 5개 compile-fail probe |
+| 받은 상세 기반 연결 | 충족 | safe model 전용 component와 received branch |
+| 양 타깃 build | 충족 | 두 스킴 `BUILD SUCCEEDED` |
+| 기능 재리뷰 | 충족 | `APPROVE` |
+| 정적 UI 리뷰 | 충족 | `APPROVED_STATIC` |
+| runtime visual QA | 미충족 | 인증 가능한 runtime 부재 |
+
+**최종 결론:** 수정 검증 완료. P7-T1 코드·정적 범위 승인.
@@ -0,0 +1,50 @@
+# Phase 7 받은 상세 상태 UI 리뷰
+
+## 1. 리뷰 정보
+
+| 항목 | 내용 |
+|---|---|
+| 리뷰 대상 | Phase 7 / `P7-T4`, `P7-GATE` 코드 범위 |
+| 기준 commit 또는 working tree | working tree |
+| 리뷰 일자 | 2026-10-07 |
+| 리뷰어 | 기능 Oracle, 정적 UI reviewer |
+| 기준 문서 | `prd.md`, `plan-task.md` |
+| 리뷰 상태 | 판정 완료 |
+
+## 2. 리뷰 목적과 범위
+
+- null 주소와 전달 불가 상태가 개인정보 섹션을 생성하지 않는지 확인한다.
+- 배송지 입력 완료부터 전달 완료까지 받은 상세 상태와 전달 불가 action을 확인한다.
+- 인증 실서버, Figma pixel 비교, screenshot·큰 글자·VoiceOver 실행은 제외한다.
+
+## 3. 검토한 근거
+
+- 코드: `GiftDisplayModels.swift`, `GiftDisplayPolicy.swift`, `ReceivedGiftDetailContentView.swift`, `GiftDetailView.swift`
+- 테스트: `ReceivedGiftDetailCheck.swift`, `check-received-gift-detail.sh`, `GiftRecipientAddressCheck.swift`
+- focused 검사: privacy 19 assertions, 금지 필드 5개 compiler probe, foundation/recipient-form/received-states, 제출 266 assertions 성공
+- 정적 검증: Swift parse, shell parse, `git diff --check` 성공
+- build: `SodaLive`, `SodaLive-dev` generic iOS Debug build 성공
+
+## 4. 발견 사항 요약
+
+확정 제품 발견 사항 없음.
+
+기능 리뷰 `APPROVE`, 정적 UI 리뷰 `APPROVED_STATIC`이다. Figma node 접근과 인증 runtime capture가 없어 pixel fidelity, 실제 CJK 줄바꿈, 최대 Dynamic Type, VoiceOver, 하단 safe area 상호작용은 판정하지 않았다.
+
+## 5. plan·goal 전환
+
+전환 항목 없음.
+
+## 6. 리뷰 종료 판정
+
+| 판정 항목 | 결과 | 근거 |
+|---|---|---|
+| 받은 상세 개인정보 allowlist | 충족 | 금지 필드 5개 compile-fail probe |
+| null 주소 섹션 제거 | 충족 | policy assertion과 optional section 구조 검사 |
+| 전달 불가 제한 UI | 충족 | 주소·form·progress·gift 배제, 사유·폐기 안내 구조 검사 |
+| 문의·정책 action | 충족 | 기존 service center route와 `준비 중입니다.` toast 사용, URL 없음 |
+| 상태별 정상 상세 | 충족 | 5단계 progress, 안전한 선물 정보, optional 받는 주소 |
+| build·focused 검사 | 충족 | fresh Phase 7 checks와 양 스킴 build 성공 |
+| Figma·runtime visual QA | 미충족 | 활성 Figma node와 인증 실행 환경 부재 |
+
+**최종 결론:** P7-T4와 Phase 7 코드 gate 승인. 수동 runtime 항목은 최종 Gate의 증거 공백으로 유지한다.
@@ -0,0 +1,49 @@
+# Phase 7 배송지 제출 리뷰
+
+## 1. 리뷰 정보
+
+| 항목 | 내용 |
+|---|---|
+| 리뷰 대상 | Phase 7 / `P7-T3` |
+| 기준 commit 또는 working tree | working tree |
+| 리뷰 일자 | 2026-10-07 |
+| 리뷰어 | 기능 Oracle, 정적 UI reviewer |
+| 기준 문서 | `prd.md`, `plan-task.md` |
+| 리뷰 상태 | 판정 완료 |
+
+## 2. 리뷰 목적과 범위
+
+- 배송지 validation, POST 중복 차단, 실패 복구, 성공 toast와 상세 재조회 순서를 확인한다.
+- 성공 후 GET 실패가 배송지 POST를 반복하지 않고 상세 GET만 재시도하는지 확인한다.
+- `P7-T4` 상태별 받은 상세 UI와 인증 실서버 동작은 제외한다.
+
+## 3. 검토한 근거
+
+- 코드: `GiftRecipientAddressViewModel.swift`, `GiftRecipientAddressFormView.swift`, `GiftDetailView.swift`, `GiftDetailViewModel.swift`
+- 테스트: `GiftRecipientAddressCheck.swift`, `check-gift-recipient-address.sh`, `check-received-gift-detail.sh`
+- focused 검사: production-source harness 266 assertions, recipient-form 구조 검사 성공
+- 정적 검증: 수정 SwiftUI 파일 2개의 Swift parse 성공
+- build: `SodaLive`, `SodaLive-dev` generic iOS Debug build 성공
+
+## 4. 발견 사항 요약
+
+확정 제품 발견 사항 없음.
+
+기능 리뷰 `APPROVE`, 정적 UI 리뷰 `APPROVED_STATIC`이다. 구조 검사는 SwiftUI runtime 통합 검증을 대신하지 않으며, 인증 실서버 read-after-write, screenshot, keyboard, VoiceOver 증거는 확보하지 못했다.
+
+## 5. plan·goal 전환
+
+전환 항목 없음.
+
+## 6. 리뷰 종료 판정
+
+| 판정 항목 | 결과 | 근거 |
+|---|---|---|
+| validation·request mapping | 충족 | 필수 4개 입력·약관 2개, 선택 상세주소, 양끝 공백 제거를 harness로 검증 |
+| 중복 제출·실패 복구 | 충족 | POST 1회 잠금, 실패 후 입력 유지·재시도를 harness로 검증 |
+| 성공 toast·상세 재조회 | 충족 | active 화면 toast 종료 후 callback 1회, 동일 상세 ViewModel GET 연결 |
+| GET 실패 복구 | 충족 | 제출 latch를 유지하며 상세 GET-only 재시도 제공 |
+| build·정적 검사 | 충족 | focused 검사, parse, 양 스킴 build 성공 |
+| runtime visual·실서버 | 미충족 | 인증 환경과 현재 화면 캡처 부재 |
+
+**최종 결론:** P7-T3 코드·정적 범위 승인. runtime·실서버 증거 공백은 최종 Gate에 유지한다.
@@ -0,0 +1,46 @@
+# Phase 7 배송지 입력 UI 리뷰
+
+## 1. 리뷰 정보
+
+| 항목 | 내용 |
+|---|---|
+| 리뷰 대상 | Phase 7 / `P7-T2` |
+| 기준 commit 또는 working tree | working tree |
+| 리뷰 일자 | 2026-10-07 |
+| 리뷰어 | 기능 Oracle, 정적 UI Oracle |
+| 기준 문서 | `prd.md`, `plan-task.md` |
+| 리뷰 상태 | 판정 완료 |
+
+## 2. 리뷰 목적과 범위
+
+- 안전한 received display model의 `recipientAddressRequired`로만 form을 분기하는지 확인한다.
+- P7-T2의 입력 상태와 약관 링크만 검토하며 validation·API·상태별 완료 화면은 제외한다.
+
+## 3. 검토한 근거
+
+- 코드: `GiftRecipientAddressFormView.swift`, `GiftRecipientAddressViewModel.swift`, `GiftDetailView.swift`, `GiftAgreementRow.swift`
+- focused 검사: privacy, foundation, recipient-form 성공
+- 정적 검증: Swift parse, `plutil -lint`, `git diff --check` 성공
+- build: `SodaLive-dev`, `SodaLive` generic iOS Debug build 성공
+
+## 4. 발견 사항 요약
+
+확정 제품 발견 사항 없음.
+
+Figma node `2531:36290`는 활성 Figma 문서에서 찾을 수 없어 exact copy·spacing·pixel 대조를 수행하지 못했다. 문서와 기존 component 관례 기준 기능 리뷰 `APPROVE`, 정적 UI 리뷰 `APPROVED_STATIC`이며 이는 runtime visual 승인이 아니다.
+
+## 5. plan·goal 전환
+
+전환 항목 없음.
+
+## 6. 리뷰 종료 판정
+
+| 판정 항목 | 결과 | 근거 |
+|---|---|---|
+| 조건 분기·privacy | 충족 | safe model flag와 허용 정보만 사용 |
+| 수동 입력·약관 | 충족 | 5개 입력, 2개 독립 상태, 확정 Notion URL |
+| P7-T2 범위 | 충족 | CTA 비활성, API·validation 없음 |
+| build·정적 검사 | 충족 | focused 검사와 양 스킴 build 성공 |
+| fresh Figma·runtime visual QA | 미충족 | Figma 활성 문서와 인증 runtime 부재 |
+
+**최종 결론:** P7-T2 코드·정적 범위 승인. Figma·runtime 증거 공백은 유지한다.