From 40e864ae02befd7e01cce8d7b3645cc61e4e2b21 Mon Sep 17 00:00:00 2001 From: klaus Date: Thu, 8 Oct 2026 11:54:18 +0900 Subject: [PATCH] =?UTF-8?q?docs(gift):=20=EB=B0=B0=EC=86=A1=EC=A7=80=20?= =?UTF-8?q?=EC=9E=85=EB=A0=A5=20=EC=A1=B0=EA=B1=B4=20=EC=9A=94=EA=B5=AC?= =?UTF-8?q?=EC=82=AC=ED=95=AD=EC=9D=84=20=EC=A0=95=EB=A6=AC=ED=95=9C?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../plan-task.md | 202 ++++++++++++++++++ .../prd.md | 91 ++++++++ 2 files changed, 293 insertions(+) create mode 100644 docs/20261008_선물_배송지_입력_조건_수정/plan-task.md create mode 100644 docs/20261008_선물_배송지_입력_조건_수정/prd.md diff --git a/docs/20261008_선물_배송지_입력_조건_수정/plan-task.md b/docs/20261008_선물_배송지_입력_조건_수정/plan-task.md new file mode 100644 index 00000000..01b6846e --- /dev/null +++ b/docs/20261008_선물_배송지_입력_조건_수정/plan-task.md @@ -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 동작은 저장소 정책에 따라 계측하지 않은 잔여 위험으로 기록한다. diff --git a/docs/20261008_선물_배송지_입력_조건_수정/prd.md b/docs/20261008_선물_배송지_입력_조건_수정/prd.md new file mode 100644 index 00000000..fa0cb5a7 --- /dev/null +++ b/docs/20261008_선물_배송지_입력_조건_수정/prd.md @@ -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` |