docs(gift): 배송지 입력 조건 요구사항을 정리한다
This commit is contained in:
@@ -0,0 +1,202 @@
|
|||||||
|
# 선물 배송지 입력 조건 수정 구현 계획
|
||||||
|
|
||||||
|
| 문서 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 상태 | 완료 |
|
||||||
|
| 작성일 | 2026-10-08 |
|
||||||
|
| 요구사항 기준 | `docs/20261008_선물_배송지_입력_조건_수정/prd.md` |
|
||||||
|
| API 기준 | 변경 없음 |
|
||||||
|
| 현재 Phase | Phase 1 입력 조건 수정 |
|
||||||
|
| 현재 활성 Goal | 완료 |
|
||||||
|
|
||||||
|
## 목표
|
||||||
|
|
||||||
|
선물 보내기와 받은 선물 배송지 입력 폼에서 한글 조합을 보존하고 이름·휴대폰 입력 문자와 최대 길이를 동일하게 제한한다.
|
||||||
|
|
||||||
|
## 현재 상태
|
||||||
|
|
||||||
|
| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 |
|
||||||
|
|---:|---|---:|---|---|
|
||||||
|
| 1 | 완료 | `4/4` | 완료 | 없음 |
|
||||||
|
|
||||||
|
## 범위
|
||||||
|
|
||||||
|
### 포함
|
||||||
|
|
||||||
|
- 공용 이름·휴대폰 문자 필터 수정
|
||||||
|
- 두 Activity에 이름 12자·휴대폰 11자 `LengthFilter` 적용
|
||||||
|
- 보내는 사람과 수령인 이름 제출 검증을 한글·영문 1~12자로 정렬
|
||||||
|
- 공용 필터와 Presenter local unit test
|
||||||
|
|
||||||
|
### 제외
|
||||||
|
|
||||||
|
- API·DTO 제출 계약 변경
|
||||||
|
- 주소 필드, 오류 문구, 레이아웃 디자인 변경
|
||||||
|
- 신규 dependency, `androidTest`, 기기·에뮬레이터·스크린샷 검증
|
||||||
|
|
||||||
|
## 기술적 제약
|
||||||
|
|
||||||
|
- 기존 `GiftSendInputFilters`와 Android `InputFilter.LengthFilter`를 재사용한다.
|
||||||
|
- 허용 source는 `null`을 반환해 원본 text와 composing span을 보존한다.
|
||||||
|
- 금지 문자가 있을 때만 `SpannableStringBuilder`에서 해당 문자를 삭제한다.
|
||||||
|
- 이름 입력 중에는 한글 자모를 허용하되 양쪽 폼의 최종 제출은 완성형 한글·영문만 허용한다.
|
||||||
|
- 휴대폰 문자 필터는 ASCII `0-9`만 허용한다.
|
||||||
|
- 기존 `textPersonName`, `phone`, 보내는 사람 휴대폰 정확히 11자리 제출 검증을 유지한다.
|
||||||
|
|
||||||
|
## 시나리오 계약
|
||||||
|
|
||||||
|
| 구분 | 시나리오 | 통과 조건 | 검증 표면 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| Happy path | 한글·영문 이름과 11자리 휴대폰 번호 입력 | 입력값이 그대로 유지되고 최대 경계까지 허용된다. | `GiftSendInputFiltersTest` |
|
||||||
|
| Edge | 한글 자모 조합, 숫자·공백·기호 혼합, 최대 길이 초과 | 자모와 composing span은 유지되고 금지 문자와 초과 입력은 남지 않는다. | `GiftSendInputFiltersTest` |
|
||||||
|
| Regression | 양쪽 폼의 최종 이름 검증과 두 화면 공용 필터 적용 | 자모·숫자·13자 이름은 무효이고 기존 11자리 휴대폰 검증과 Activity 연결은 유지된다. | `GiftSendRequestPresenterTest`, `GiftRecipientAddressViewModelTest`, 소스 대조 |
|
||||||
|
|
||||||
|
**중단 조건:** focused RED→GREEN, Gift 패키지 회귀, Debug 빌드와 변경 파일 정적 검증이 모두 통과하고 PRD 성공 기준 및 문서 검증 기록이 갱신되면 즉시 종료한다.
|
||||||
|
|
||||||
|
## Phase 1 입력 조건 수정
|
||||||
|
|
||||||
|
**Phase 결과:** 두 선물 배송지 폼에서 한글 조합이 이어지고 이름·휴대폰 입력 제한이 동일하게 적용된다.
|
||||||
|
|
||||||
|
**선행조건:** 승인된 PRD와 구현 계획.
|
||||||
|
|
||||||
|
### 구현 항목
|
||||||
|
|
||||||
|
#### Task 1.1 요구사항과 원인 문서화
|
||||||
|
|
||||||
|
**Goal 실행 `P1-T1`:** 원인, 허용 문자, 길이 경계와 변경 범위를 구현 기준으로 확정한다.
|
||||||
|
|
||||||
|
- **시작 조건:** 사용자 권장 설계 승인.
|
||||||
|
- **완료 증거:** `prd.md`, `plan-task.md`의 요구사항·시나리오·파일 범위 일치.
|
||||||
|
- **범위 밖:** production 코드와 테스트 변경.
|
||||||
|
- **TDD 예외 사유:** production 동작을 변경하지 않는 문서 작업이다.
|
||||||
|
- **대체 검증 방법:** placeholder 부재, 문서 경로와 요구사항 ID 연결을 확인한다.
|
||||||
|
|
||||||
|
- [x] 원인을 완성형 한글 전용 필터의 조합 자모 제거로 기록한다.
|
||||||
|
- [x] 이름 한글·영문 1~12자, 휴대폰 ASCII 숫자 최대 11자를 확정한다.
|
||||||
|
- [x] 기존 입력 타입과 보내는 사람 휴대폰 제출 조건 유지 범위를 기록한다.
|
||||||
|
|
||||||
|
#### Task 1.2 공용 입력 필터와 길이 제한
|
||||||
|
|
||||||
|
**Goal 실행 `P1-T2`:** 한글 조합을 보존하는 공용 문자 필터와 최대 길이 제한을 두 입력 화면에 적용한다.
|
||||||
|
|
||||||
|
- **시작 조건:** `P1-T1` 완료.
|
||||||
|
- **완료 증거:** focused RED→GREEN과 두 Activity 연결 확인.
|
||||||
|
- **범위 밖:** Presenter 외 제출 계약, API, 레이아웃 디자인 변경.
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
|
||||||
|
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendInputUi.kt`
|
||||||
|
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestActivity.kt`
|
||||||
|
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailActivity.kt`
|
||||||
|
- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendInputFiltersTest.kt`
|
||||||
|
|
||||||
|
- [x] **RED:** 자모·composing span 보존, 금지 문자 제거, 이름 12자와 휴대폰 11자 경계 테스트를 작성한다.
|
||||||
|
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendInputFiltersTest" --rerun`에서 기존 자모 제거 또는 길이 제한 부재 assertion 실패를 확인한다.
|
||||||
|
- [x] **GREEN:** 공용 필터를 수정하고 두 Activity에 문자 필터 다음 `LengthFilter`를 적용한다.
|
||||||
|
- [x] **GREEN 확인:** 같은 focused test가 failures/errors/skipped 0으로 통과하는지 확인한다.
|
||||||
|
- [x] **REFACTOR:** 이번 변경에서 만든 중복만 정리하고 두 Activity가 동일한 필터 배열을 쓰는지 확인한다.
|
||||||
|
|
||||||
|
**검증 기록:** 최초 RED 명령은 Kotlin compile 중 120초 제한, 두 번째는 300초 제한을 초과해 assertion에 도달하지 못했다. 잔류 Kotlin compile daemon을 종료하고 `--no-daemon -Dkotlin.compiler.execution.strategy=in-process`로 재실행한 결과 7분 13초 후 의도한 RED를 확인했다. `GiftSendInputFiltersTest`의 자모·span, 이름 금지 문자, 비ASCII 휴대폰 숫자 3건과 `GiftNavigationTest`의 실제 두 폼 최대 길이 1건, 총 4개 test가 assertion 실패했다. production 수정 전 결과다.
|
||||||
|
|
||||||
|
**GREEN 검증 기록:** 같은 두 test class/method를 `--no-daemon -Dkotlin.compiler.execution.strategy=in-process`로 재실행해 6분 24초 후 `BUILD SUCCESSFUL`을 확인했다. 공용 필터 3개와 실제 두 Activity 길이 경계 1개, 총 4개 test가 failures/errors/skipped=0으로 통과했다. 두 Activity 모두 이름 필터 뒤 `LengthFilter(12)`, 휴대폰 필터 뒤 `LengthFilter(11)`을 적용한다.
|
||||||
|
|
||||||
|
#### Task 1.3 보내는 사람 이름 제출 검증
|
||||||
|
|
||||||
|
**Goal 실행 `P1-T3`:** 보내는 사람 이름의 최종 제출 검증을 한글·영문 1~12자로 맞춘다.
|
||||||
|
|
||||||
|
- **시작 조건:** `P1-T2` 완료.
|
||||||
|
- **완료 증거:** 숫자·13자 이름 RED와 정규식 최소 수정 GREEN.
|
||||||
|
- **범위 밖:** 휴대폰 제출 길이, 수령인 ViewModel 제출 조건 변경.
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
|
||||||
|
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenter.kt`
|
||||||
|
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenterTest.kt`
|
||||||
|
|
||||||
|
- [x] **RED:** 숫자 포함·13자 이름이 유효하지 않고 1자·12자 이름이 유효한 테스트를 작성한다.
|
||||||
|
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestPresenterTest" --rerun`에서 기존 숫자 또는 13자 허용 assertion 실패를 확인한다.
|
||||||
|
- [x] **GREEN:** `SENDER_NAME_REGEX`만 한글·영문 1~12자 계약으로 수정한다.
|
||||||
|
- [x] **GREEN 확인:** 같은 focused test와 기존 휴대폰 11자리 검증이 통과하는지 확인한다.
|
||||||
|
- [x] **REFACTOR:** 기존 테스트 helper를 유지하고 새 abstraction을 추가하지 않는다.
|
||||||
|
|
||||||
|
**RED 검증 기록:** `--no-daemon -Dkotlin.compiler.execution.strategy=in-process` focused 명령을 실행해 6분 19초 후 `GiftSendRequestPresenterTest` 21개 중 이름 경계 1개가 실패했다. 기존 정규식이 숫자 포함 이름을 허용한 assertion 실패이며 production Presenter 수정 전 결과다.
|
||||||
|
|
||||||
|
**GREEN 검증 기록:** 같은 focused test를 증분 실행해 1분 14초 후 `BUILD SUCCESSFUL`을 확인했다. Presenter 21개 test가 failures/errors/skipped=0으로 통과했고 이름 1자·12자 허용, 숫자·13자·자모·공백·기호 거부와 기존 휴대폰 11자리 검증을 함께 확인했다.
|
||||||
|
|
||||||
|
#### Task 1.R1 수령인 최종 이름 검증 정합성 수정
|
||||||
|
|
||||||
|
**Goal 실행 `P1-R1`:** `REV-P1-001`을 수정해 조합 중 허용한 자모가 보내는 사람과 수령인의 최종 제출 이름으로 사용되지 않게 한다.
|
||||||
|
|
||||||
|
- **시작 조건:** Oracle 리뷰에서 `REV-P1-001` 확정.
|
||||||
|
- **완료 증거:** 수령인 단독 자모 RED, 공용 최종 이름 검증 GREEN, Gift 회귀와 재리뷰.
|
||||||
|
- **범위 밖:** 휴대폰 제출 길이, API·DTO·서버 검증 변경.
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
|
||||||
|
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendInputUi.kt`
|
||||||
|
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestPresenter.kt`
|
||||||
|
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftRecipientAddressViewModel.kt`
|
||||||
|
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendInputFiltersTest.kt`
|
||||||
|
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftRecipientAddressViewModelTest.kt`
|
||||||
|
|
||||||
|
- [x] **RED:** 공용 최종 이름 검증 경계와 수령인 단독 자모 CTA 비활성 테스트를 작성한다.
|
||||||
|
- [x] **RED 확인:** focused test에서 수령인 단독 자모가 현재 제출 가능해 발생하는 assertion 실패를 확인한다.
|
||||||
|
- 검증 기록: `GiftRecipientAddressViewModelTest` 9개 중 신규 테스트가 `GiftRecipientAddressViewModelTest.kt:78` assertion에서 실패했다.
|
||||||
|
- [x] **GREEN:** 완성형 한글·ASCII 영문 1~12자 공용 검증을 두 제출 경로에서 사용한다.
|
||||||
|
- [x] **GREEN 확인:** 공용 필터와 수령인 ViewModel focused test가 통과하는지 확인한다.
|
||||||
|
- 검증 기록: `GiftRecipientAddressViewModelTest`, `GiftSendRequestPresenterTest`, `GiftSendInputFiltersTest`를 함께 실행해 `BUILD SUCCESSFUL`을 확인했다.
|
||||||
|
- [x] **REFACTOR:** 이름 정규식을 한 곳에만 유지하고 입력 중 자모 허용과 최종 값 검증을 분리한다.
|
||||||
|
|
||||||
|
### Phase 1 Gate
|
||||||
|
|
||||||
|
**Goal 실행 `P1-GATE`:** 입력 조건 수정과 Gift 영향 범위를 최종 판정한다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --rerun
|
||||||
|
./gradlew :app:assembleDebug
|
||||||
|
GIT_MASTER=1 git diff --check
|
||||||
|
```
|
||||||
|
|
||||||
|
**Expected:** 모든 명령 exit 0, 한글 조합·문자·길이·제출 경계 테스트 통과, API/DTO/XML 입력 타입 변경 없음.
|
||||||
|
|
||||||
|
## 실행 순서와 의존성
|
||||||
|
|
||||||
|
```text
|
||||||
|
P1-T1 → P1-T2 → P1-T3 → P1-R1 → P1-GATE
|
||||||
|
```
|
||||||
|
|
||||||
|
## 변경 금지 항목
|
||||||
|
|
||||||
|
- 레거시 파일, API·DTO, 주소 입력 조건과 관련 없는 Gift 코드를 수정하지 않는다.
|
||||||
|
- 테스트를 삭제·skip·완화하거나 타입 오류를 우회하지 않는다.
|
||||||
|
- 새 dependency나 범용 입력 abstraction을 추가하지 않는다.
|
||||||
|
- 사용자가 요청하지 않은 기기·에뮬레이터·시각 QA를 실행하지 않는다.
|
||||||
|
|
||||||
|
## Progress
|
||||||
|
|
||||||
|
### P1-T1 1차 실행 — 2026-10-08
|
||||||
|
|
||||||
|
- 상태: 완료
|
||||||
|
- 무엇을: 원인 조사, 사용자 설계 승인, PRD와 구현 계획 작성.
|
||||||
|
- 왜: production 수정 전에 이름 IME 조합 실패와 입력 경계를 구현 기준으로 고정하기 위해서다.
|
||||||
|
- 어떻게:
|
||||||
|
- `GiftSendInputUi.kt`와 두 Activity 호출 경로 대조 — 공용 필터 적용 확인.
|
||||||
|
- Android `InputFilter`, `InputConnection`, `LengthFilter` 공식 계약 대조 — composing source 원본 수락과 native 길이 제한 근거 확인.
|
||||||
|
- 남은 항목: 문서 검토, `P1-T2` RED부터 실행.
|
||||||
|
- 다음 행동: 문서 승인 후 `GiftSendInputFiltersTest` 작성.
|
||||||
|
|
||||||
|
## Decision Log
|
||||||
|
|
||||||
|
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 |
|
||||||
|
|---|---|---|---|---|---|
|
||||||
|
| 2026-10-08 | `PLAN-DEC-001` | 확정 | 공용 필터 최소 수정과 native `LengthFilter`를 사용한다. | 사용자 승인, Android 공식 계약, YAGNI | `P1-T2` |
|
||||||
|
| 2026-10-08 | `PLAN-DEC-002` | 정정 | 기존 휴대폰 11자리 제출 검증은 유지하되 최종 이름 검증은 양쪽 폼에 적용한다. | `REV-P1-001`에서 입력 중 자모가 수령인 최종 요청에 도달함을 확인 | `P1-R1` |
|
||||||
|
|
||||||
|
## Verification Log
|
||||||
|
|
||||||
|
- 2026-10-08: 구현 전 원인·호출 경로·공식 Android 입력 계약을 확인했다. production/test 검증은 아직 실행하지 않았다.
|
||||||
|
- 2026-10-08: `GiftRecipientAddressViewModelTest` RED에서 신규 테스트가 78행 assertion으로 실패해 단독 자모 제출 문제를 재현했다.
|
||||||
|
- 2026-10-08: `GiftRecipientAddressViewModelTest`, `GiftSendRequestPresenterTest`, `GiftSendInputFiltersTest` focused GREEN이 `BUILD SUCCESSFUL`로 통과했다.
|
||||||
|
- 2026-10-08: `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.gift.*' :app:assembleDebug :app:ktlintCheck`가 `BUILD SUCCESSFUL`로 통과했다. 기존 `.editorconfig`의 `disabled_rules` deprecation warning만 출력됐다.
|
||||||
|
- 2026-10-08: `GIT_MASTER=1 git diff --check`가 출력 없이 성공했다.
|
||||||
|
- 2026-10-08: Oracle 재리뷰에서 `REV-P1-001` 해결, 신규 발견 없음, 승인 가능 판정을 받았다. 실제 키보드별 IME 동작은 저장소 정책에 따라 계측하지 않은 잔여 위험으로 기록한다.
|
||||||
@@ -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