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 동작은 저장소 정책에 따라 계측하지 않은 잔여 위험으로 기록한다.