6.0 KiB
6.0 KiB
선물 배송지 입력 조건 수정 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. 핵심 사용자 흐름
- 사용자가 보내는 사람 또는 수령인 이름 필드를 선택한다.
- 한글 조합 또는 영문 입력은 유지되고 숫자·공백·기호는 제거된다.
- 이름 12자 이후 입력은 반영되지 않는다.
- 휴대폰 번호 필드에는 숫자 키패드가 유지되고 숫자만 입력된다.
- 휴대폰 번호 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 |