docs(gift): 배송지 입력 조건 요구사항을 정리한다
This commit is contained in:
@@ -0,0 +1,91 @@
|
||||
# 선물 배송지 입력 조건 수정 PRD
|
||||
|
||||
## 문서 정보
|
||||
|
||||
| 항목 | 내용 |
|
||||
|---|---|
|
||||
| 문서 상태 | 구현 기준 확정 |
|
||||
| 작성일 | 2026-10-08 |
|
||||
| 최종 수정일 | 2026-10-08 |
|
||||
| 대상 제품 | 선물 보내기 및 받은 선물 배송지 입력 폼 |
|
||||
| 작성자·결정권자 | 사용자, Sisyphus |
|
||||
| 관련 API Contract | 변경 없음 |
|
||||
| 관련 구현 계획 | `docs/20261008_선물_배송지_입력_조건_수정/plan-task.md` |
|
||||
| 관련 review | 없음 |
|
||||
|
||||
## 1. Overview
|
||||
|
||||
선물 보내기 폼의 보내는 사람과 받은 선물 상세의 수령인 배송지 폼에 동일한 이름·휴대폰 입력 조건을 적용한다. 한글 IME 조합을 방해하지 않으면서 이름은 한글·영문 1~12자, 휴대폰 번호는 숫자만 최대 11자까지 입력할 수 있게 한다.
|
||||
|
||||
## 2. Problem Statement
|
||||
|
||||
- 현재 이름 필터는 ASCII 또는 완성형 한글 `가-힣`만 허용한다.
|
||||
- 한글 IME가 다음 글자를 조합하며 전달하는 자모가 필터에서 제거되어 한 글자 입력 후 후속 입력이 막힐 수 있다.
|
||||
- 현재 이름에는 숫자가 허용되고 이름·휴대폰 번호의 최대 입력 길이 제한이 없다.
|
||||
|
||||
문제 해결 여부는 공용 입력 필터 테스트에서 한글 조합 문자 보존, 허용 문자 제한, 이름 12자 및 휴대폰 11자 경계가 통과하는지로 판단한다.
|
||||
|
||||
## 3. Goals
|
||||
|
||||
- 보내는 사람과 수령인 이름에 한글·영문만 입력되게 한다.
|
||||
- 한글 IME 조합 중 자모를 허용해 연속 입력을 보존한다.
|
||||
- 이름은 최소 1자, 최대 12자로 제한하고 13번째 문자는 입력되지 않게 한다.
|
||||
- 휴대폰 번호는 ASCII 숫자만 입력되며 최대 11자로 제한한다.
|
||||
- 두 화면이 동일한 공용 입력 규칙을 사용하게 한다.
|
||||
|
||||
## 4. Non-Goals
|
||||
|
||||
- API, DTO, 서버 검증 조건을 변경하지 않는다.
|
||||
- 보내는 사람 휴대폰 번호의 기존 11자리 제출 검증을 변경하지 않는다.
|
||||
- 레이아웃 디자인, 오류 문구, 주소 입력 조건은 변경하지 않는다.
|
||||
- 기기·에뮬레이터 UI 테스트와 스크린샷 검증은 수행하지 않는다.
|
||||
|
||||
## 5. 핵심 사용자 흐름
|
||||
|
||||
1. 사용자가 보내는 사람 또는 수령인 이름 필드를 선택한다.
|
||||
2. 한글 조합 또는 영문 입력은 유지되고 숫자·공백·기호는 제거된다.
|
||||
3. 이름 12자 이후 입력은 반영되지 않는다.
|
||||
4. 휴대폰 번호 필드에는 숫자 키패드가 유지되고 숫자만 입력된다.
|
||||
5. 휴대폰 번호 11자 이후 입력은 반영되지 않는다.
|
||||
|
||||
## 6. 기능 요구사항
|
||||
|
||||
| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 |
|
||||
|---|---|---|---|---|
|
||||
| `GIFT-INPUT-001` | 확정 | 이름은 완성형 한글과 ASCII 영문만 최종 값으로 허용한다. | 숫자·공백·기호가 제거되고 보내는 사람 제출 검증에서도 거부된다. | `P1-T2`, `P1-T3` |
|
||||
| `GIFT-INPUT-002` | 확정 | 한글 IME 조합 중 자모를 보존한다. | 허용 source에는 `null`을 반환해 원본 composing span을 유지한다. | `P1-T2` |
|
||||
| `GIFT-INPUT-003` | 확정 | 이름은 1~12자만 입력할 수 있다. | 빈 이름은 기존 필수값 검증으로 제출되지 않고 13번째 입력은 차단된다. | `P1-T2`, `P1-T3` |
|
||||
| `GIFT-INPUT-004` | 확정 | 휴대폰 번호는 ASCII 숫자만 최대 11자로 입력할 수 있다. | 기호·문자·비ASCII 숫자가 제거되고 12번째 입력은 차단된다. | `P1-T2` |
|
||||
| `GIFT-INPUT-005` | 확정 | 보내는 사람과 수령인 폼은 같은 공용 필터를 사용한다. | 두 Activity가 동일한 필터와 길이 제한을 적용한다. | `P1-T2`, `P1-GATE` |
|
||||
|
||||
## 7. UI/UX Expectations
|
||||
|
||||
- 이름 필드의 `textPersonName`과 휴대폰 필드의 `phone` 입력 타입을 유지한다.
|
||||
- 허용 문자는 입력 즉시 표시되고 금지 문자는 입력값에 남지 않는다.
|
||||
- 한글 조합 중간값은 최종 이름 제출 규칙과 구분해 입력 단계에서 허용한다.
|
||||
- 최대 길이를 초과하는 입력은 Android 기본 `InputFilter.LengthFilter` 동작으로 차단한다.
|
||||
|
||||
## 8. 품질 요구사항
|
||||
|
||||
- 신규 dependency를 추가하지 않는다.
|
||||
- `app/src/test`의 local unit/Robolectric 테스트로 공용 필터와 제출 검증을 확인한다.
|
||||
- 필터가 `Spanned` 입력을 변경할 때 허용 문자의 span을 보존한다.
|
||||
- Gift 패키지 회귀 테스트와 Debug 빌드를 통과한다.
|
||||
|
||||
## 9. 성공 기준
|
||||
|
||||
- [ ] 한글 조합 자모가 공용 이름 필터에서 제거되지 않는다.
|
||||
- [ ] 이름의 한글·영문 허용, 금지 문자 제거, 12자 경계 테스트가 통과한다.
|
||||
- [ ] 휴대폰 번호의 ASCII 숫자 허용, 금지 문자 제거, 11자 경계 테스트가 통과한다.
|
||||
- [ ] 보내는 사람 이름 제출 검증이 숫자와 13자 이름을 거부한다.
|
||||
- [ ] 두 입력 화면의 공용 필터 연결과 기존 입력 타입이 유지된다.
|
||||
- [ ] Gift 패키지 local unit test와 Debug 빌드가 통과한다.
|
||||
|
||||
## 10. Decision Log
|
||||
|
||||
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 요구사항·계획 |
|
||||
|---|---|---|---|---|---|
|
||||
| 2026-10-08 | `DEC-001` | 확정 | 공용 필터가 한글 자모를 허용하고 원본 source를 수락해 composing span을 보존한다. | 기존 완성형 범위 필터가 IME 조합 문자를 제거하는 원인 분석 | `GIFT-INPUT-002`, `P1-T2` |
|
||||
| 2026-10-08 | `DEC-002` | 확정 | 최대 길이는 Android `InputFilter.LengthFilter`를 사용한다. | 교체 범위와 surrogate 경계를 처리하는 native API 재사용 | `GIFT-INPUT-003~004`, `P1-T2` |
|
||||
| 2026-10-08 | `DEC-003` | 확정 | 이름의 공백·숫자를 허용하지 않고 기존 휴대폰 제출 11자리 검증은 유지한다. | 사용자 승인 설계와 최소 변경 원칙 | `GIFT-INPUT-001`, `P1-T3` |
|
||||
| 2026-10-08 | `DEC-004` | 정정 | 입력 중 허용한 자모가 최종 수령인 이름으로 제출되지 않도록 양쪽 이름의 최종 검증을 공용 규칙으로 적용한다. | `REV-P1-001`에서 수령인 폼이 단독 자모를 `isNotBlank()`로 제출할 수 있음을 확인 | `GIFT-INPUT-001`, `P1-R1` |
|
||||
Reference in New Issue
Block a user