Files
sodalive-android/docs/20261008_선물_배송지_입력_조건_수정/prd.md
T

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. 핵심 사용자 흐름

  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