13 KiB
선물 배송지 입력 조건 수정 구현 계획
| 문서 항목 | 내용 |
|---|---|
| 상태 | 완료 |
| 작성일 | 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와 AndroidInputFilter.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 연결을 확인한다.
-
원인을 완성형 한글 전용 필터의 조합 자모 제거로 기록한다.
-
이름 한글·영문 1~12자, 휴대폰 ASCII 숫자 최대 11자를 확정한다.
-
기존 입력 타입과 보내는 사람 휴대폰 제출 조건 유지 범위를 기록한다.
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 -
RED: 자모·composing span 보존, 금지 문자 제거, 이름 12자와 휴대폰 11자 경계 테스트를 작성한다.
-
RED 확인:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendInputFiltersTest" --rerun에서 기존 자모 제거 또는 길이 제한 부재 assertion 실패를 확인한다. -
GREEN: 공용 필터를 수정하고 두 Activity에 문자 필터 다음
LengthFilter를 적용한다. -
GREEN 확인: 같은 focused test가 failures/errors/skipped 0으로 통과하는지 확인한다.
-
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 -
RED: 숫자 포함·13자 이름이 유효하지 않고 1자·12자 이름이 유효한 테스트를 작성한다.
-
RED 확인:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestPresenterTest" --rerun에서 기존 숫자 또는 13자 허용 assertion 실패를 확인한다. -
GREEN:
SENDER_NAME_REGEX만 한글·영문 1~12자 계약으로 수정한다. -
GREEN 확인: 같은 focused test와 기존 휴대폰 11자리 검증이 통과하는지 확인한다.
-
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 -
RED: 공용 최종 이름 검증 경계와 수령인 단독 자모 CTA 비활성 테스트를 작성한다.
-
RED 확인: focused test에서 수령인 단독 자모가 현재 제출 가능해 발생하는 assertion 실패를 확인한다.
- 검증 기록:
GiftRecipientAddressViewModelTest9개 중 신규 테스트가GiftRecipientAddressViewModelTest.kt:78assertion에서 실패했다.
- 검증 기록:
-
GREEN: 완성형 한글·ASCII 영문 1~12자 공용 검증을 두 제출 경로에서 사용한다.
-
GREEN 확인: 공용 필터와 수령인 ViewModel focused test가 통과하는지 확인한다.
- 검증 기록:
GiftRecipientAddressViewModelTest,GiftSendRequestPresenterTest,GiftSendInputFiltersTest를 함께 실행해BUILD SUCCESSFUL을 확인했다.
- 검증 기록:
-
REFACTOR: 이름 정규식을 한 곳에만 유지하고 입력 중 자모 허용과 최종 값 검증을 분리한다.
Phase 1 Gate
Goal 실행 P1-GATE: 입력 조건 수정과 Gift 영향 범위를 최종 판정한다.
./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 입력 타입 변경 없음.
실행 순서와 의존성
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-T2RED부터 실행. - 다음 행동: 문서 승인 후
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:
GiftRecipientAddressViewModelTestRED에서 신규 테스트가 78행 assertion으로 실패해 단독 자모 제출 문제를 재현했다. - 2026-10-08:
GiftRecipientAddressViewModelTest,GiftSendRequestPresenterTest,GiftSendInputFiltersTestfocused GREEN이BUILD SUCCESSFUL로 통과했다. - 2026-10-08:
./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.gift.*' :app:assembleDebug :app:ktlintCheck가BUILD SUCCESSFUL로 통과했다. 기존.editorconfig의disabled_rulesdeprecation warning만 출력됐다. - 2026-10-08:
GIT_MASTER=1 git diff --check가 출력 없이 성공했다. - 2026-10-08: Oracle 재리뷰에서
REV-P1-001해결, 신규 발견 없음, 승인 가능 판정을 받았다. 실제 키보드별 IME 동작은 저장소 정책에 따라 계측하지 않은 잔여 위험으로 기록한다.