# 선물 배송지 입력 조건 수정 구현 계획 | 문서 항목 | 내용 | |---|---| | 상태 | 완료 | | 작성일 | 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 동작은 저장소 정책에 따라 계측하지 않은 잔여 위험으로 기록한다.