docs(gift): 배송지 입력 조건 리뷰를 기록한다
This commit is contained in:
@@ -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 조합 동작은 저장소 정책상 계측하지 않은 잔여 위험이다.
|
||||||
Reference in New Issue
Block a user