docs(gift): 배송지 입력 조건 요구사항을 정리한다

This commit is contained in:
2026-10-08 11:54:18 +09:00
parent c37b424929
commit 40e864ae02
2 changed files with 293 additions and 0 deletions
@@ -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` |