diff --git a/docs/20261008_선물_배송지_입력_조건_수정/reviews/phase1-gift-input-constraints-review.md b/docs/20261008_선물_배송지_입력_조건_수정/reviews/phase1-gift-input-constraints-review.md new file mode 100644 index 00000000..7ea82134 --- /dev/null +++ b/docs/20261008_선물_배송지_입력_조건_수정/reviews/phase1-gift-input-constraints-review.md @@ -0,0 +1,81 @@ +# 선물 입력 조건 Phase 1 코드 리뷰 보고서 + +## 1. 리뷰 정보 + +| 항목 | 내용 | +|---|---| +| 리뷰 대상 | Phase 1 / `P1-T2`, `P1-T3`, `P1-R1` | +| 기준 commit 또는 working tree | `main` working tree 미커밋 변경 | +| 리뷰 일자 | 2026-10-08 | +| 리뷰어 | Oracle | +| 기준 문서 | `docs/20261008_선물_배송지_입력_조건_수정/prd.md`, `plan-task.md` | +| 리뷰 상태 | 승인 | + +## 2. 리뷰 목적과 범위 + +- 한글 IME composing 보존, 이름·휴대폰 문자와 길이 경계가 양쪽 폼에 일치하는지 확인한다. +- 공용 필터, 두 Activity, 최종 제출 검증과 회귀 테스트를 검토한다. +- API·DTO, 레이아웃 디자인, 기기·계측 테스트는 제외한다. + +## 3. 검토한 근거 + +- 요구사항: `GIFT-INPUT-001~005` +- 계획: `P1-T2`, `P1-T3`, `P1-GATE` +- 코드: `GiftSendInputUi.kt`, `GiftSendRequestActivity.kt`, `GiftDetailActivity.kt`, `GiftSendRequestPresenter.kt`, `GiftRecipientAddressViewModel.kt` +- 테스트: `GiftSendInputFiltersTest`, `GiftNavigationTest`, `GiftSendRequestPresenterTest` + +| 명령 | 결과 | 핵심 증거 | +|---|---|---| +| Gift 패키지 local unit test | 성공 | 194개, failures/errors/skipped=0 | +| `./gradlew :app:assembleDebug` | 성공 | exit 0 | +| `./gradlew :app:ktlintCheck` | 성공 | exit 0 | +| `GIT_MASTER=1 git diff --check` | 성공 | 출력 없음 | + +## 4. 발견 사항 요약 + +| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal | +|---|---|---|---|---|---| +| `REV-P1-001` | High | 해결 | 수령인 단독 자모 이름이 최종 요청에 전달될 수 있음 | `P1-R1` | 완료 | + +## 5. 발견 사항 상세 + +### REV-P1-001 — 수령인 단독 자모 이름이 최종 요청에 전달될 수 있음 + +- **심각도:** High +- **상태:** 해결 +- **관련 요구사항:** `GIFT-INPUT-001`, `GIFT-INPUT-002` +- **관련 계약:** API 변경 없음 +- **소유 Task:** `P1-R1` + +**관찰 내용:** 공용 필터는 IME 조합을 위해 자모를 허용하지만 수령인 폼은 이름을 `isNotBlank()`로만 검사한다. 사용자가 단독 자모를 남기면 수령인 요청에 최종 이름으로 전달될 수 있다. + +**근거:** `GiftSendInputUi.kt`의 자모 허용, `GiftRecipientAddressViewModel.kt`의 `isNotBlank()` 제출 조건, 보내는 사람에만 적용된 `GiftSendRequestPresenter` 최종 이름 정규식. + +**재현 절차:** 수령인 이름을 `ㄱ`으로 두고 나머지 필수값과 동의를 완료하면 현재 `isSubmitEnabled`가 true가 된다. 요구 결과는 조합 중 자모는 허용하되 최종 제출은 비활성인 상태다. + +**영향:** 두 이름 필드가 같은 최종 규칙을 사용한다는 요구사항을 충족하지 못하고 유효하지 않은 수령인 이름이 서버 요청에 포함될 수 있다. + +**권장 조치:** 완성형 한글·ASCII 영문 1~12자 검증을 공용 입력 규칙에 두고 보내는 사람과 수령인 제출 경로가 함께 사용하도록 최소 수정한다. + +**판정 기록:** + +- 2026-10-08 — Oracle 리뷰에서 코드 경로와 요구사항 대조로 확정했다. +- 2026-10-08 — `GiftSendInputFilters.isValidName()`을 두 제출 경로에서 사용하고 수령인 단독 자모·숫자·13자 이름 테스트를 추가했다. +- 2026-10-08 — Oracle 재리뷰에서 `REV-P1-001` 해결, 신규 발견 없음, 승인 가능으로 판정했다. + +## 6. plan·goal 전환 + +`plan-task.md`에 `Task 1.R1`과 `P1-R1`을 추가했다. 수령인 단독 자모 RED, 공용 최종 이름 검증 GREEN, Gift 회귀와 재리뷰를 완료 증거로 사용한다. + +## 7. 리뷰 종료 판정 + +| 판정 항목 | 결과 | 근거 | +|---|---|---| +| 리뷰 범위 전체 확인 | 충족 | 요구사항·코드·테스트 대조 완료 | +| 후보 항목 판정 완료 | 충족 | `REV-P1-001` 해결 | +| 확정 항목 plan 반영 | 충족 | `P1-R1` 완료 | +| 검증 명령과 결과 기록 | 충족 | Gift 전체 test, build, ktlint, diff 기록 | + +**최종 결론:** 승인 + +**남은 항목:** 없음. 실제 키보드별 IME 조합 동작은 저장소 정책상 계측하지 않은 잔여 위험이다.