Files
sodalive-android/docs/20261008_선물_배송지_입력_조건_수정/plan-task.md
T

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와 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 연결을 확인한다.

  • 원인을 완성형 한글 전용 필터의 조합 자모 제거로 기록한다.

  • 이름 한글·영문 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 실패를 확인한다.

    • 검증 기록: GiftRecipientAddressViewModelTest 9개 중 신규 테스트가 GiftRecipientAddressViewModelTest.kt:78 assertion에서 실패했다.
  • 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-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 동작은 저장소 정책에 따라 계측하지 않은 잔여 위험으로 기록한다.