From 68867cf8c82053beca49a66b178cb48a7419864b Mon Sep 17 00:00:00 2001 From: klaus Date: Fri, 2 Oct 2026 23:55:27 +0900 Subject: [PATCH] =?UTF-8?q?docs(gift):=20=EB=B0=9B=EC=9D=80=20=EC=84=A0?= =?UTF-8?q?=EB=AC=BC=20=EA=B5=AC=ED=98=84=20=EA=B8=B0=EB=A1=9D=EC=9D=84=20?= =?UTF-8?q?=EC=A0=95=EB=A6=AC=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../plan-task.md | 288 +++++++++++++++++- .../reviews/phase7-final-review.md | 85 ++++++ ...phase7-recipient-address-routing-review.md | 91 ++++++ .../phase7-recipient-address-ui-review.md | 79 +++++ ...ase7-recipient-address-viewmodel-review.md | 55 ++++ 5 files changed, 597 insertions(+), 1 deletion(-) create mode 100644 docs/20261002_선물_상세와_운송장_등록/reviews/phase7-final-review.md create mode 100644 docs/20261002_선물_상세와_운송장_등록/reviews/phase7-recipient-address-routing-review.md create mode 100644 docs/20261002_선물_상세와_운송장_등록/reviews/phase7-recipient-address-ui-review.md create mode 100644 docs/20261002_선물_상세와_운송장_등록/reviews/phase7-recipient-address-viewmodel-review.md diff --git a/docs/20261002_선물_상세와_운송장_등록/plan-task.md b/docs/20261002_선물_상세와_운송장_등록/plan-task.md index 7838b4ac..c0c15aac 100644 --- a/docs/20261002_선물_상세와_운송장_등록/plan-task.md +++ b/docs/20261002_선물_상세와_운송장_등록/plan-task.md @@ -28,6 +28,7 @@ | 4 | 완료 | `5/5` (`P4-R1`, `P4-R2` 포함) | 완료 | 없음 | | 5 | 완료 | `6/6` (`P5-GATE`, `P5-R1`, `P5-R2`, `P5-R3`, `P5-R4`, `P5-D2`) | 완료 | 없음 | | 6 | 완료 | `7/7` | 완료 | 없음 | +| 7 | 완료 | `10/10` | 완료 | 없음 | `P5-D2`에서 최종 직렬 Gate와 재검토 증거에 따라 상태를 정리했다. 아래의 진행 중·대기·실패 기록은 각 실행 당시의 이력이며, 최신 판정은 현재 상태 표와 마지막 Verification Log를 기준으로 한다. 기존 완료 Task와 당시 검증 기록은 보존한다. @@ -42,15 +43,18 @@ - 카카오 문의 route 재사용. - local unit test, resource merge, Kotlin compile, ktlint, debug build. - Figma 7개 상태의 상세·운송장·취소 완료 UI 재구현과 운송장 ASCII 숫자 10~14자리 검증. +- 받은 선물 상세 상태 4개, 배송지 입력 form, 배송지 POST, Kakao 우편번호 재사용, 성공 후 상세 재조회. ### 제외 - iOS. -- 운송장 수정, 받는 사람 배송지 입력·수정. +- 운송장 수정, 받은 선물 배송지 수정. 배송지 최초 입력은 Phase 7 범위다. +- 운송장 수정, 받은 선물 배송지 수정. - 택배사 API. - 신규 디자인 시스템·dialog·전역 event bus. - 상대방 `recipientAddress` 노출. - gift 리뷰/정책 route 신규 구현. +- 받은 선물 `선물 정책 확인` 외부 URL 연결. - `app/src/androidTest`, 기기·에뮬레이터 조작, 스크린샷·시각 QA. ## 기술적 제약 @@ -67,6 +71,8 @@ - 구현 Task는 `RED → RED 확인 → GREEN → GREEN 확인 → REFACTOR` 순서를 지킨다. - 정보 카드 label 폭은 Figma 기준으로 일반 정보 84dp, 주소 72dp이며 value와의 간격은 12dp다. - `RECEIVED`, `CANCELED`, `UNDELIVERABLE`에는 공통 hero illustration과 progress를 표시하지 않는다. +- Phase 7의 RECEIVED 상태 화면은 기존 resource/component를 재사용하고 신규 디자인 시스템을 만들지 않는다. +- 배송지 입력 성공 후에는 POST 응답만으로 화면을 완성하지 않고 상세 GET을 다시 조회한다. ## 파일 구조 @@ -135,6 +141,8 @@ - `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingPresenterTest.kt` - `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingViewModelTest.kt` - `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` +- Phase 7 추가: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftRecipientAddressViewModelTest.kt` +- Phase 7 수정: `GiftRepositoryTest.kt`, `GiftDetailPresenterTest.kt`, `GiftDetailViewModelTest.kt`, `GiftNavigationTest.kt` --- @@ -903,6 +911,268 @@ GIT_MASTER=1 git diff --check HEAD **수동 검증 제한:** 저장소 규칙과 승인된 Non-Goal에 따라 기기·에뮬레이터·`androidTest`·스크린샷·시각 QA는 실행하지 않는다. 완료 증거는 Figma design context/XML source 대조와 local unit/resource/compile/lint/build다. +--- + +## Phase 7: 받은 선물 상세와 배송지 입력 + +**Phase 결과:** 받은 크리에이터는 선물함에서 받은 선물 상세를 열고, 배송지 입력이 필요한 선물의 주소를 제출한 뒤 재조회된 배송지 입력 완료·전달 완료·전달 불가 상태를 확인할 수 있다. + +**선행조건:** Phase 6 완료, PRD `DEC-017`~`DEC-020` 및 `GIFT-RECEIVED-*`, `GIFT-ADDRESS-FORM-*`, `GIFT-POSTCODE-*`, `GIFT-DATE-*` 확정. + +**Phase 완료 조건:** `P7-T1`~`P7-T5`, `P7-R1`~`P7-R4`, `P7-GATE` 완료, 검증 기록 누적. 구현 전에는 이 Phase의 체크박스를 완료로 바꾸지 않는다. + +### Task 7.1 API 계약과 날짜 timezone 회귀 테스트 + +**Goal 실행 `P7-T1`:** 배송지 입력 POST 계약과 상세 날짜의 기기 timezone 표시 정책을 local unit test로 고정한다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftApi.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftRepository.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftModels.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenter.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/data/GiftRepositoryTest.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenterTest.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModelTest.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestViewModelTest.kt` + +**Interfaces:** + +```kotlin +data class GiftRecipientAddressRequest( + val recipientName: String, + val recipientPhoneNumber: String, + val recipientZipCode: String, + val recipientAddress: String, + val recipientAddressDetail: String, + val recipientTermsAgreed: Boolean, + val recipientPrivacyAgreed: Boolean +) + +data class GiftRecipientAddressResponse( + val applicationNo: String, + val status: String, + val statusName: String, + val recipientAddressRegisteredAt: String +) +``` + +- [x] **RED:** repository fake가 `POST /api/v2/gifts/{applicationNo}/recipient-address`의 applicationNo, request body, Bearer header를 기록하고 현재 method 부재로 실패하는 test를 작성한다. +- [x] **RED:** `TimeZone.setDefault(TimeZone.getTimeZone("Asia/Seoul"))`에서 `2026-10-11T23:30:00Z`가 `2026.10.12`로 표시되는 상세 날짜 test를 작성한다. 같은 test에서 `UTC` 기본 timezone이면 `2026.10.11`이 되는지 확인한다. +- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftRepositoryTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailPresenterTest" --rerun`으로 method 또는 timezone 정책 부재 실패를 확인한다. +- [x] **GREEN:** Retrofit method, repository 전달 method, DTO를 추가한다. 날짜 formatter가 이미 기기 timezone이면 test만 통과시키고, 아니면 `SimpleDateFormat(pattern, Locale.US)` 출력 formatter의 timezone을 `TimeZone.getDefault()`로 명시한다. +- [x] **GREEN 확인:** 같은 focused 명령을 다시 실행해 repository 계약과 timezone 경계가 통과함을 기록한다. +- [x] **REFACTOR:** 배송지 request field 이름과 날짜 formatter 외 영역을 변경하지 않는다. `GiftApi`를 직접 구현하는 기존 test fake에는 미사용 method만 명시적으로 추가하고 기존 test 동작은 바꾸지 않는다. + +**Task 검증 기록:** RED에서 신규 request/response와 `registerRecipientAddress`가 없어 `:app:compileDebugUnitTestKotlin`이 unresolved reference와 `overrides nothing`으로 실패함을 확인했다. 최소 DTO·Retrofit·repository와 직접 `GiftApi` test fake 두 곳만 추가한 뒤 focused 명령은 `BUILD SUCCESSFUL in 21s`였다. JUnit XML 기준 repository 10개와 presenter 16개, 총 26개가 failures/errors/skipped=0이다. 기존 날짜 formatter가 이미 기기 timezone을 사용해 production presenter는 변경하지 않았다. `./gradlew :app:compileDebugKotlin :app:ktlintCheck`는 `BUILD SUCCESSFUL in 5s`, `GIT_MASTER=1 git diff --check HEAD`는 무출력(exit 0)이었다. 명세 검토와 코드 품질 검토는 모두 APPROVED이며 차단 finding은 없다. + +### Task 7.2 받은 선물 상세 presentation 모델 + +**Goal 실행 `P7-T2`:** `direction=RECEIVED` 상세 응답을 배송지 입력 전, 입력 완료, 전달 완료, 전달 불가 UI model로 변환한다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailModels.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenter.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenterTest.kt` + +**Produces:** + +- `ReceivedAddressForm` mode: 개인정보 안내, 전달 예정 선물, 배송지 form descriptor, 약관 2개, CTA label `선물 받기`. +- `ReceivedAddressCompleted` mode: hero `배송지 입력 완료!`, 문의하기, 선물 정보, nullable 받는 주소. +- `ReceivedDelivered` mode: hero `선물 전달 완료!`, 배송 완료일, nullable 받는 주소와 3일 후 삭제 안내. +- `ReceivedUndeliverable` mode: `전달 불가` chip, 문의하기, 선물 정책 확인 action, 사유 카드. + +- [x] **RED:** `direction=RECEIVED && recipientAddressRequired=true` fixture가 배송지 입력 mode를 만들고 `senderInfo`, `mailbox`, `giftInfo.applicationNo`, `paidCan`, `tracking`을 포함하지 않는 test를 작성한다. +- [x] **RED:** `recipientAddressRequired=false`와 진행 status 3개, `recipientAddress` 있음 fixture가 `배송지 입력 완료!` mode와 선물 정보 4행을 만드는 test를 작성한다. +- [x] **RED:** `recipientAddress=null` fixture에서 받는 주소 section model이 null인지 검증한다. +- [x] **RED:** `status=DELIVERED` fixture가 배송 완료일을 `statusTimeline[DELIVERED].occurredAt`에서 찾고, 주소가 있을 때만 삭제 안내와 받는 주소를 표시하는 test를 작성한다. +- [x] **RED:** `status=UNDELIVERABLE` fixture가 배송지 입력을 숨기고 reason fallback, 폐기·미반송 안내, 정책 action을 만들며 주소 응답이 있어도 주소 section을 만들지 않는 test를 작성한다. +- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailPresenterTest" --rerun`으로 신규 mode 부재 실패를 확인한다. +- [x] **GREEN:** 기존 `GiftDetailPresenter.present` 안에서 `direction=RECEIVED`와 status/recipientAddressRequired 조건을 먼저 분기한다. SENT 기존 flow는 유지한다. +- [x] **GREEN 확인:** 같은 focused test PASS를 기록한다. +- [x] **REFACTOR:** 보낸 선물 상세의 기존 `GiftDetailInfo`/action 정책을 바꾸지 않고 받은 선물 전용 helper만 분리한다. + +**Task 검증 기록:** 신규 received mode와 form descriptor 부재로 focused test의 compile RED를 확인했다. 4개 received mode, 입력 전 3행·입력 완료 4행·전달 완료 5행, nullable 주소, 전달 불가 사유·정책 action을 최소 presentation model로 추가했다. 최초 명세 검토에서 `REV-P7-T2-001`~`003`이 확정돼 아래 `P7-R1`로 전환했다. + +### Task 7.R1 받은 선물 presentation 명세 회귀 수정 + +**Goal 실행 `P7-R1`:** `P7-T2` 명세 검토의 `REV-P7-T2-001`~`003`을 해소해 모든 RECEIVED 개인정보 차단, 완료 상태 제한, 정적 form descriptor를 고정한다. + +- **시작 조건:** `P7-T2` 구현 후 명세 검토 CHANGES_REQUESTED. +- **대상 파일:** `GiftDetailModels.kt`, `GiftDetailPresenter.kt`, `GiftDetailPresenterTest.kt`. +- **수정 범위:** RECEIVED+CANCELED를 포함한 금지 필드 제거, `AddressCompleted`를 `TRACKING_REGISTERED`·`ARRIVED_AT_MAILBOX`·`INSPECTION_COMPLETED`로 제한, 개인정보 안내·입력 필드·약관 2개·`선물 받기` CTA의 정적 descriptor 추가. +- **회귀 테스트:** RECEIVED+CANCELED 민감 값 미보존, RECEIVED+주소 불필요의 완료 mode 오인 방지, form descriptor 구성, 기존 SENT 취소/상세 회귀. +- **완료 증거:** 기존 구현 실패 재현 → 최소 수정 GREEN → presenter focused test → 명세 재검토 → 코드 품질 검토. +- **범위 밖:** 입력 상태·validation·POST·reload, Activity/XML/resource, 신규 dependency 또는 공통 form abstraction. + +- [x] `REV-P7-T2-001` RECEIVED+CANCELED 개인정보 우회 회귀 test와 최소 수정. +- [x] `REV-P7-T2-002` 허용되지 않은 상태의 완료 mode 오인 회귀 test와 최소 수정. +- [x] `REV-P7-T2-003` 정적 form descriptor 계약 test와 최소 수정. +- [x] presenter focused test와 명세·품질 재검토를 통과한다. + +**Task 검증 기록:** 세 finding의 기존 실패를 각각 민감 정보 잔존, 완료 mode 오인, descriptor symbol 부재로 확인한 뒤 모든 RECEIVED sanitizer, 완료 상태 3개 제한, 고정 form descriptor만 추가했다. 명세 재검토는 세 finding 모두 RESOLVED/APPROVED, 코드 품질 검토는 차단 finding 없이 APPROVED다. fresh focused 실행은 `BUILD SUCCESSFUL in 39s`, JUnit XML 기준 24 tests, failures/errors/skipped=0이다. 첫 ktlint 실행은 신규 테스트 괄호 개행 2건으로 실패했고 해당 서식만 수정했다. 재실행한 `./gradlew :app:compileDebugKotlin :app:ktlintCheck`는 `BUILD SUCCESSFUL in 2s`, `GIT_MASTER=1 git diff --check HEAD`는 무출력(exit 0)이었다. + +### Task 7.3 배송지 입력 ViewModel과 action event + +**Goal 실행 `P7-T3`:** 배송지 form validation, POST 제출, 성공 후 상세 재조회 event, 실패 시 입력 유지와 policy/inquiry action을 관리한다. + +**Files:** + +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftRecipientAddressViewModel.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailViewModel.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt` +- Modify: `app/src/main/res/values/strings.xml` +- Modify: `app/src/main/res/values-en/strings.xml` +- Modify: `app/src/main/res/values-ja/strings.xml` +- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftRecipientAddressViewModelTest.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailViewModelTest.kt` + +**Validation:** 이름, 휴대폰 번호, 우편번호, 주소는 `isNotBlank()` 기준이다. 상세 주소는 optional이며 공백이면 빈 문자열 그대로 보낸다. 약관 2개는 모두 true여야 한다. + +- [x] **RED:** 필수 입력 또는 약관 누락 조합에서 CTA disabled이고 POST 0회인 test를 작성한다. +- [x] **RED:** 유효 form submit의 request body가 화면 입력값과 약관 boolean을 그대로 담는 test를 작성한다. +- [x] **RED:** submit pending 중 재탭은 POST 1회만 발생하는 test를 작성한다. +- [x] **RED:** POST 성공은 성공 toast와 상세 reload event를 한 번 내보내고, POST 응답만으로 content를 바꾸지 않는 test를 작성한다. +- [x] **RED:** POST 실패는 기존 form state를 유지하고 toast/dialog event만 발생시키는 test를 작성한다. +- [x] **RED:** 문의하기는 기존 카카오 ACTION_VIEW intent를 한 번 반환하고, 선물 정책 확인은 외부 URL 없이 `준비 중입니다.` toast 또는 no-op 허용 정책 중 하나로 고정되는 test를 작성한다. +- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftRecipientAddressViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailViewModelTest" --rerun`으로 신규 ViewModel 부재 실패를 확인한다. +- [x] **GREEN:** 기존 Rx/token/ToastMessage 패턴으로 최소 ViewModel을 구현하고 상세 ViewModel에는 reload trigger만 연결한다. +- [x] **GREEN 확인:** 같은 focused test PASS를 기록한다. +- [x] **REFACTOR:** form 상태와 상세 조회 상태를 섞지 않는다. DTO, 주소, 전화번호를 saved state나 Intent extra에 저장하지 않는다. + +**Task 검증 기록:** `GiftRecipientAddressViewModelTest` 8개와 `GiftDetailViewModelTest` 17개, 총 25개 focused local unit test를 `--rerun`으로 실행해 통과했다. 최초 `:app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck` 실행은 신규 테스트의 미사용 import 1건과 생성자 인자 줄바꿈 위반으로 실패했고, 동작 변경 없이 해당 서식만 수정했다. 재실행은 `BUILD SUCCESSFUL in 24s`, `GIT_MASTER=1 git diff --check HEAD`는 무출력(exit 0), staging은 비어 있었다. 명세와 코드 품질 검토는 모두 차단 finding 없이 APPROVED이며 상세 결과는 `reviews/phase7-recipient-address-viewmodel-review.md`에 기록했다. + +### Task 7.4 Activity·resource·Kakao 우편번호 연결 + +**Goal 실행 `P7-T4`:** 기존 `GiftDetailActivity`에 받은 선물 form과 완료 상태 UI를 resource/source 기준으로 연결한다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailActivity.kt` +- Modify: `app/src/main/res/layout/activity_gift_detail.xml` +- Reuse: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/KakaoPostcodeSearchActivity.kt` +- Modify: `app/src/main/res/values/strings.xml` +- Modify: `app/src/main/res/values-en/strings.xml` +- Modify: `app/src/main/res/values-ja/strings.xml` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` + +- [x] **RED:** `GiftNavigationTest`에 주소 검색 결과 `EXTRA_ZONE_CODE`, `EXTRA_ADDRESS`가 form의 우편번호·주소를 채우고 상세 주소 입력으로 focus 요청 event를 만드는 test를 작성한다. +- [x] **RED:** 주소 검색 취소/실패 결과에서 기존 form 입력과 약관 체크가 유지되는 test를 작성한다. +- [x] **RED 확인:** focused navigation test에서 form/result 연결 부재 실패를 확인한다. +- [x] **GREEN:** 기존 `KakaoPostcodeSearchActivity.newIntent`와 Activity Result launcher를 재사용한다. `data.zonecode`와 `GiftSendRequestPresenter.toPostcodeResult`의 도로명/지번 선택 정책을 그대로 사용한다. +- [x] **GREEN:** 배송지 입력 전, 입력 완료, 전달 완료, 전달 불가 상태의 section binding과 버튼 binding을 추가한다. 약관 상세 링크는 기존 약관/webview 경로가 확인될 때만 연결하고, 없으면 새 화면을 만들지 않는다. +- [x] **GREEN 확인:** navigation focused test, `./gradlew :app:mergeDebugResources :app:compileDebugKotlin` PASS를 기록한다. +- [x] **REFACTOR:** 보낸 선물 상세 layout binding과 tracking/cancel binding을 변경하지 않는다. layout 크기·간격·visibility 직접 unit test는 만들지 않는다. +- [x] **TDD 예외 및 대체 검증:** Figma 노드 `2531:36290`, `2531:36399`, `2531:36330`, `2531:36422`와 XML/source를 읽어 section 순서·문구·action을 대조하고 검증 기록에 남긴다. 기기·에뮬레이터·스크린샷 QA는 실행하지 않는다. + +**P7-T4 실행 검증 기록 (2026-10-02):** + +- RED: `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest'`에서 기존 12개 통과, 신규 우편번호 결과 2개는 `받은 선물 주소 검색 연결이 필요하다` AssertionError로 실패했다. 최초 실행의 미생성 ViewModel 조회 오류는 검색 연결 assertion을 먼저 확인하도록 테스트 순서를 고친 뒤 기대한 실패로 재확인했다. +- GREEN: 동일 navigation test와 `GiftRecipientAddressViewModelTest`, `GiftDetailViewModelTest`를 실행하여 각각 17/8/17개, 총 42개가 실패 없이 통과했다. 같은 명령에 `:app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck`를 포함한 최종 결과는 `BUILD SUCCESSFUL in 23s`였다. 중간 ktlint 줄바꿈 위반은 이번 추가 코드만 수정했고, 120초 실행 제한 이후 재실행으로 완료했다. +- Robolectric에서 우편번호 성공 시 주소 두 필드 변경·상세 주소 focus, 비정상 결과 시 원본 form 객체 유지, 폼 입력·동의 제출·실패 후 재시도·토스트 소비·성공 event, 완료/전달 상태 정보 4/5행·선택 주소·안내, 정책 toast와 기존 문의 이동을 검증했다. 기존 SENT 취소·운송장 회귀도 통과했다. +- Figma 제공 metadata `2531:36290`, `2531:36399`, `2531:36330`, `2531:36422`와 XML/source의 안내/선물 정보/배송지 입력/동의/CTA, 완료 hero/action/정보/선택 주소, 전달 안내, 전달 불가 이중 action/사유/폐기 안내 순서를 대조했다. 기존 Typography·색상·spacing·배경·입력 필터를 재사용했고 90/44/111/7 값은 제공된 metadata 기준이다. 디자인 컨텍스트 timeout으로 픽셀 일치 검증은 하지 않았다. +- `GIT_MASTER=1 git diff --check HEAD` 무출력(exit 0). 기기·에뮬레이터·브라우저·스크린샷·계측 테스트와 layout 크기/visibility assertion은 실행하거나 추가하지 않았다. Kotlin LSP 도구가 제공되지 않아 컴파일과 ktlint로 검증했다. +- 성공 toast만 소비하고 기존 recipient success event는 P7-T5 연결을 위해 유지한다. 상세 재조회·목록 변경 marker·P7-GATE·문서 완료 처리는 이번 범위에서 수행하지 않았다. + +### Task 7.R2 받은 선물 상세 UI 명세 회귀 수정 + +**Goal 실행 `P7-R2`:** P7-T4 명세 검토의 `REV-P7-T4-001`~`003`을 해소해 받은 선물 제목과 Figma 섹션 계층을 맞춘다. + +- **시작 조건:** `P7-T4` 구현 후 명세 검토 CHANGES_REQUESTED. +- **대상 파일:** `GiftDetailActivity.kt`, `activity_gift_detail.xml`, `values*/strings.xml`, `GiftNavigationTest.kt`. +- **수정 범위:** RECEIVED 전용 `선물 상세` title, 전달 완료 action 아래 divider, 배송지 form의 `이용 약관 동의`와 전달 불가의 `사유` 헤더. +- **회귀 테스트:** RECEIVED 완료 화면 title, 기존 SENT title·tracking/cancel 회귀, navigation focused test. +- **완료 증거:** title test RED → 최소 수정 GREEN → Figma 하위 노드/XML 대조 → focused test → resource/compile/ktlint → 명세 재검토. +- **범위 밖:** P7-T5 재조회·목록 marker, layout 수치/visibility unit assertion, 새 화면·dependency·정책 URL. + +- [x] `REV-P7-T4-001` 받은 선물 완료 화면 title 회귀 test와 전용 지역화 문자열을 추가한다. +- [x] `REV-P7-T4-002` 전달 완료 action 아래 기존 divider를 표시한다. +- [x] `REV-P7-T4-003` 기존 `gift_send_agreements`와 신규 사유 문자열로 섹션 헤더를 추가한다. +- [x] navigation focused test와 resource/compile/ktlint를 통과하고 명세 재검토 승인을 받는다. + +**Task 검증 기록:** 제목 회귀 test RED에서 `expected:<[선물] 상세> but was:<[신청] 상세>`를 확인했다. RECEIVED 전용 한/영/일 title, Delivered divider, 기존 약관 제목 재사용과 한/영/일 사유 제목을 최소 추가했다. 명세 재검토는 `REV-P7-T4-001`~`003` 모두 RESOLVED/APPROVED다. fresh focused 실행은 JUnit XML 기준 `GiftNavigationTest` 18개, `GiftRecipientAddressViewModelTest` 8개, `GiftDetailViewModelTest` 17개로 총 43개이며 failures/errors/skipped=0이다. `:app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck`는 `BUILD SUCCESSFUL in 1s`, diff check는 무출력, staging은 비어 있었다. + +### Task 7.R3 받은 선물 상태 전환·지역화 회귀 수정 + +**Goal 실행 `P7-R3`:** P7-T4 코드 품질 검토의 `REV-P7-T4-004`~`006`을 해소해 동일 Activity 인스턴스의 상태 전환과 다국어 완료 문구를 안전하게 만든다. + +- **시작 조건:** `P7-R2` 명세 재검토 APPROVED 후 코드 품질 검토 CHANGES_REQUESTED. +- **대상 파일:** `GiftDetailActivity.kt`, `GiftDetailModels.kt`, `GiftDetailPresenter.kt`, `values*/strings.xml`, `GiftNavigationTest.kt`, `GiftDetailPresenterTest.kt`. +- **수정 범위:** AddressForm 화면에서만 제출 CTA·progress 허용, 공통 bind 진입 시 visibility·divider 기본 위치 복원, 완료 hero·주소 삭제 안내 3개 문구 지역화. +- **회귀 테스트:** form→Loading/Error CTA 차단, 동일 Activity에서 Undeliverable→SENT/다른 received 상태 전환 복원, 한/영/일 GiftDetailText key 해석. +- **완료 증거:** 각 결함 RED → 최소 수정 GREEN → navigation/presenter focused test → resource/compile/ktlint → 품질 재검토. +- **범위 밖:** P7-T5 성공 재조회·목록 marker, 새 event wrapper·화면·dependency, validation 변경. + +- [x] `REV-P7-T4-004` Loading/Error와 비-form 상태에서 CTA·progress를 숨기고 제출을 차단한다. +- [x] `REV-P7-T4-005` 공통 bind가 gift info visibility와 divider 기본 위치를 복원한 뒤 received override를 적용한다. +- [x] `REV-P7-T4-006` 받은 선물 완료 hero·안내 3개 문구를 `GiftDetailText.Key`와 한/영/일 resource로 연결한다. +- [x] navigation/presenter focused test와 resource/compile/ktlint를 통과하고 품질 재검토 승인을 받는다. + +**Task 검증 기록:** `REV-P7-T4-004`는 현재 `AddressForm`이 렌더된 경우에만 CTA·progress와 submit을 허용하도록 수정했고, form→Loading/Error 및 비-form 상태의 추가 POST 0회를 검증했다. `REV-P7-T4-005`는 공통 bind 진입 시 선물 정보 visibility와 divider 기본 위치를 복원한 뒤 상태별 override를 적용하도록 수정했고, 동일 Activity의 Undeliverable→SENT/AddressCompleted/Delivered 전환을 검증했다. `REV-P7-T4-006`은 완료 hero·주소 삭제 안내 3개를 `GiftDetailText.Key`와 한/영/일 resource로 연결했다. fresh focused 실행은 `BUILD SUCCESSFUL in 20s`, JUnit XML 기준 navigation 20개, presenter 24개, recipient ViewModel 8개, detail ViewModel 17개로 총 69개이며 failures/errors/skipped=0이다. `./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck`는 `BUILD SUCCESSFUL in 1s`였다. 품질 재검토는 세 finding 모두 RESOLVED, 최종 APPROVED이며 추가 코드 수정 권고는 없다. + +### Task 7.5 목록 진입·재조회·문서 정합성 + +**Goal 실행 `P7-T5`:** 선물함 리스트에서 받은 선물 상세 진입, 배송지 성공 후 상세 재조회, 목록 복귀 갱신 범위를 검증한다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailActivity.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModelTest.kt` +- Modify: `docs/20261002_선물_상세와_운송장_등록/prd.md` +- Modify: `docs/20261002_선물_상세와_운송장_등록/plan-task.md` + +- [x] **RED:** 선물함 item 탭이 `applicationNo`만 상세 Intent에 담고, 받은 선물 배송지 성공 후 상세 reload가 발생하는 navigation test를 작성한다. +- [x] **RED:** 상세 reload 후 완료 UI fixture가 presenter/ViewModel 상태로 반영되는 test를 작성한다. +- [x] **RED 확인:** 기존 구현에서 recipient address success event의 Activity 연결 부재 실패를 확인한다. +- [x] **GREEN:** 성공 event를 상세 reload와 목록 갱신용 변경 marker에 연결한다. 주소·전화번호·DTO는 Intent/result/saved state에 넣지 않는다. +- [x] **GREEN 확인:** navigation/inbox/detail focused test PASS를 기록한다. +- [x] **REFACTOR:** 기존 tracking/cancel 성공 결과와 같은 Boolean 변경 marker만 재사용한다. +- [x] **문서 갱신:** Phase 7 구현 후 PRD 14.5 체크박스와 이 계획의 Progress/Verification Log를 실제 증거로만 갱신한다. + +**Task 검증 기록:** 신규 Activity 통합 테스트의 RED에서 배송지 POST 성공 후 같은 신청번호의 두 번째 GET을 기대했지만 최초 GET 1회만 관찰되어 `expected:<[test-gift, test-gift]> but was:<[test-gift]>`로 실패했다. `GiftDetailActivity`가 기존 성공 event를 한 번 소비해 `markChanged()` 후 `reloadAfterRecipientAddressSuccess()`를 호출하도록 최소 연결했다. parent fresh focused 실행은 `BUILD SUCCESSFUL in 19s`, JUnit XML 기준 navigation 21개, detail ViewModel 17개, recipient ViewModel 8개, inbox ViewModel 11개로 총 57개이며 failures/errors/skipped=0이다. 재조회 응답의 서버 주소로 `AddressCompleted` UI가 갱신되고, result payload 없이 기존 Boolean `STATE_CHANGED`만 저장·복원하며 재생성 시 GET/POST가 반복되지 않음을 검증했다. `./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck`는 `BUILD SUCCESSFUL in 1s`였다. 명세·품질 재검토는 모두 APPROVED이며 확정 finding은 없다. + +### Task 7.R4 최종 리뷰 테스트 정책·배송지 입력 헤더 회귀 수정 + +**Goal 실행 `P7-R4`:** 최종 Phase 7 리뷰의 `REV-P7-GATE-001`~`002`를 해소해 테스트 정책을 지키고 배송지 입력 화면의 고정 헤더를 PRD와 일치시킨다. + +- **시작 조건:** P7-GATE 명령 성공 후 최종 코드 리뷰 CHANGES_REQUESTED. +- **대상 파일:** `GiftDetailActivity.kt`, `GiftNavigationTest.kt`, `plan-task.md`, `reviews/phase7-final-review.md`. +- **수정 범위:** View visibility·자식 순서 직접 assertion 제거, 상태 전환의 POST 0회·정보 행·제목 검증 유지, AddressForm 헤더를 기존 `gift_recipient_receive`로 분기. +- **회귀 테스트:** 배송지 입력 전 헤더 `선물 받기` RED/GREEN, 완료·전달 불가 RECEIVED 헤더 `선물 상세`와 SENT `신청 상세` 유지, 비-form 상태 추가 POST 0회. +- **완료 증거:** 헤더 RED → 최소 분기 GREEN → navigation focused test → resource/compile/ktlint → 원 reviewer 재검토 → P7-GATE 전체 직렬 재실행. +- **범위 밖:** layout 수치·visibility·constraint 테스트, 신규 문자열·추상화·화면·dependency, P7-T5 reload/result 계약 변경. + +- [x] `REV-P7-GATE-001` 금지된 View visibility·자식 순서 assertion을 제거하고 허용된 동작 검증을 유지한다. +- [x] `REV-P7-GATE-002` AddressForm 헤더 회귀 test RED 후 기존 문자열을 사용하는 최소 분기로 GREEN을 만든다. +- [x] navigation focused test와 resource/compile/ktlint를 통과한다. +- [x] 원 reviewer 재검토와 P7-GATE 전체 직렬 재실행을 완료한다. + +**Task 검증 기록:** AddressForm 헤더 회귀 test는 production 수정 전 `expected:<선물 [받기]> but was:<선물 [상세]>`로 RED를 확인했다. `bindReceived()`의 기존 `form` Boolean과 기존 문자열만 사용해 헤더를 분기했고, 금지된 `isVisible`·View 자식 순서 assertion을 제거하면서 로딩·오류·비-form 상태의 추가 POST 0회, 정보 행 값, SENT/RECEIVED 헤더 검증은 유지했다. parent fresh `GiftNavigationTest`는 21개 모두 통과해 `BUILD SUCCESSFUL in 18s`, `mergeDebugResources`, `compileDebugKotlin`, `ktlintCheck`는 `BUILD SUCCESSFUL in 1s`였다. 대상 금지 패턴 검색 결과는 0건이다. Oracle 재검토는 `REV-P7-GATE-001`과 `REV-P7-GATE-002`를 모두 RESOLVED, P7-R4를 APPROVED로 판정했으며 신규 finding은 없다. 전체 P7-GATE 직렬 재실행 결과는 Task 7.6에 누적한다. + +### Task 7.6 통합 Gate + +**Goal 실행 `P7-GATE`:** 받은 선물 상세·배송지 입력과 기존 Gift/modal 영향 범위를 직렬 검증한다. + +- [x] gift/modal focused test를 실행하고 XML에서 실제 test 수와 failures/errors/skipped=0을 기록한다. +- [x] 전체 local unit test를 실행하고 실제 결과를 기록한다. +- [x] resource merge, Kotlin compile, ktlint, debug assemble을 실행한다. +- [x] `GIT_MASTER=1 git diff --check HEAD`를 실행한다. +- [x] 필요하면 `docs/sample/sample-review.md` 형식으로 Phase 7 리뷰를 작성하고 확정 finding은 `P7-R*` 회귀 수정 Task로 전환한다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --tests "kr.co.vividnext.sodalive.v2.components.modal.*" --rerun +./gradlew :app:testDebugUnitTest --rerun +./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck +./gradlew :app:assembleDebug +GIT_MASTER=1 git diff --check HEAD +``` + +**Expected:** 배송지 입력 CTA 조건, POST body, 성공 후 상세 재조회, 주소 섹션 null 숨김, 전달 완료/전달 불가 UI, 문의/정책 action, 기기 timezone 날짜 test가 통과한다. 기존 보낸 선물 상세, 운송장 등록, 취소, Gift NONE 로깅, V2ModalDialog 기본 동작은 회귀하지 않는다. + +**Gate 검증 기록:** P7-R4와 Oracle 재검토 후 위 명령을 병렬 실행하지 않고 순서대로 새로 실행했다. gift/modal focused suite는 `BUILD SUCCESSFUL in 21s`, JUnit XML 16개에서 180 tests, failures/errors/skipped=0이었다. 전체 local unit suite는 `BUILD SUCCESSFUL in 1m 1s`, JUnit XML 189개에서 1,447 tests, failures/errors/skipped=0이었다. resource merge·Kotlin compile·ktlint는 `BUILD SUCCESSFUL in 1s`, `assembleDebug`는 `BUILD SUCCESSFUL in 4s`였다. `GIT_MASTER=1 git diff --check HEAD`와 `GIT_MASTER=1 git diff --cached --name-only`는 모두 무출력이다. 기존 Gradle deprecated 경고는 실패가 아니며 범위 밖이라 수정하지 않았다. 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 저장소 규칙에 따라 실행하지 않았다. `REV-P7-GATE-001`~`002`는 수정·검증 완료, Oracle P7-R4 재검토 APPROVED, 신규 차단 finding 없음으로 Phase 7을 완료한다. + ## 실행 순서와 의존성 | 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 | @@ -935,6 +1205,13 @@ GIT_MASTER=1 git diff --check HEAD | 26 | `P6-GATE` | `P6-T1`, `P6-T2` | 아니요 | 실패 소유 Task에 회귀 수정 등록 | | 27 | `P6-R3` | `P6-REVIEW`의 `REV-P6-REVIEW-001` | 아니요 | presentation 결정 test로 전환 후 전체 Gate 재실행 | | 28 | `P6-REVIEW` | 최신 Gate와 `P6-R3` 재검토 증거 | 아니요 | finding별 `P6-R*` 등록 후 재검증 | +| 29 | `P7-T1` | PRD `DEC-017`~`DEC-020` | 아니요 | 배송지 POST 계약과 날짜 timezone test 재대조 | +| 30 | `P7-T2` | `P7-T1` | 아니요 | 받은 선물 상태 분기와 개인정보 노출 금지 재대조 | +| 31 | `P7-R1` | `P7-T2`, `REV-P7-T2-001`~`003` | 아니요 | RECEIVED privacy·상태 제한·form descriptor 재대조 | +| 32 | `P7-T3` | `P7-R1` | 아니요 | form validation·submit·action event 재대조 | +| 33 | `P7-T4` | `P7-T2`, `P7-T3` | 아니요 | Kakao 주소 검색·resource binding 재대조 | +| 34 | `P7-T5` | `P7-T3`, `P7-T4` | 아니요 | 상세 reload·목록 갱신 결과 재대조 | +| 35 | `P7-GATE` | Phase 7 Task 전체 | 아니요 | 실패 소유 Task에 `P7-R*` 등록 | ```text P1-T1 → P1-T2 → P1-GATE @@ -942,6 +1219,7 @@ P1-T1 → P1-T2 → P1-GATE → P3-T1 → P3-T2 → P3-T3 → P3-GATE → P4-T1 → P4-T2 → P4-T3 → P4-R2 → P4-GATE → P5-GATE → P6-T1 → P6-T2 → P6-GATE → P6-REVIEW → P6-R3 → P6-REVIEW + → P7-T1 → P7-T2 → P7-R1 → P7-T3 → P7-T4 → P7-T5 → P7-GATE ``` ## 변경 금지 항목 @@ -950,6 +1228,8 @@ P1-T1 → P1-T2 → P1-GATE - `mailbox`를 상대방 주소로 표현하지 않는다. - API 정상 상태 5개를 삭제·축약하지 않는다. 화면 projection만 승인된 4구간으로 표시한다. - tracking 수정 endpoint·화면, 택배사 API, 리뷰/정책 route를 만들지 않는다. +- 받은 선물 정책 확인에 임의 외부 URL을 연결하지 않는다. +- 배송지 입력 실패·주소 검색 취소 시 form 입력값과 약관 체크를 초기화하지 않는다. - 기존 `V2ModalDialog` 호출의 기본 자동 닫힘을 변경하지 않는다. - 레거시 파일을 직접 수정하지 않는다. - **승인된 예외 `PLAN-DEC-005`:** `P5-R2`에서만 레거시 `AppDI.kt`의 named Gift client/Retrofit 추가와 `GiftApi` 연결 변경을 허용한다. 공유 debug BODY/release NONE과 다른 API 설정은 유지한다. @@ -1246,6 +1526,9 @@ P1-T1 → P1-T2 → P1-GATE | `2026-10-02` | `PLAN-DEC-007` | 사용자 확인 | `RECEIVED`, `CANCELED`, `UNDELIVERABLE`은 공통 hero illustration과 progress를 표시하지 않는다. | PRD `DEC-016` | `P6-T1` | | `2026-10-02` | `PLAN-DEC-008` | 확정 | 행 label 폭은 Figma design context의 일반 84dp, 주소 72dp를 사용한다. | 노드 `2481:19011`, `2481:19152`, `2481:19521` 직접 추출 | `P6-T1`, `P6-T2` | | `2026-10-02` | `PLAN-DEC-009` | 확정 | 운송장 입력은 native 숫자/ASCII/14자 제한과 순수 10~14자리 validator를 함께 사용한다. | PRD `DEC-015`, Android 공식 계약 | `P6-T2` | +| `2026-10-02` | `PLAN-DEC-010` | 확정 | Phase 7은 기존 상세 Activity와 gift 계층을 확장해 받은 선물 상세·배송지 입력을 구현한다. 새 Activity·디자인 시스템·dependency는 만들지 않는다. | PRD `DEC-017`, `DEC-018` | `P7-T1`~`P7-GATE` | +| `2026-10-02` | `PLAN-DEC-011` | 확정 | 배송지 입력 성공 후 상세 GET을 다시 조회하고 POST 응답만으로 완료 UI를 만들지 않는다. | PRD `DEC-019` | `P7-T3`, `P7-T5` | +| `2026-10-02` | `PLAN-DEC-012` | 확정 | `선물 정책 확인`은 임의 URL 없이 handler만 둔다. 무동작 금지 정책이 확인되면 `준비 중입니다.` toast를 사용한다. | PRD `DEC-020` | `P7-T3`, `P7-T4` | ## 발견된 문제 @@ -1267,6 +1550,7 @@ P1-T1 → P1-T2 → P1-GATE - `2026-10-02` context 재검토 등록: 아래 과거 이력은 보존한다. 최신 전달 결과는 goal PASS, QA PASS(privacy/repository 7개, lifecycle 38개, gift/modal 141개, 각 XML failures/errors/skipped=0), quality PASS다. quality의 `callFactory` assertion 보강은 선택적 비차단 의견이다. security lane은 team-mode 규칙을 이유로 검토를 거절해 INCONCLUSIVE이며 새 취약점 판정이 아니다. context는 일반 상세 무변경 recreate 음성 테스트와 build guide 실행 예시 누락 두 건으로 FAIL이다. 전자는 `REV-P5-004`/`P5-R4`, 후자는 `REV-P5-003`/`P5-D2`에 등록했다. - `2026-10-02` 전체 Gate 상태 보강: parent가 앞서 전체 1408 tests와 build/lint 성공을 보고했으나 이후 parent 테스트와 QA가 동시에 XML을 써 충돌했다. 이는 코드 실패로 기록하지 않으며 최종 성공 근거로도 삼지 않는다. `P5-R4` 이후 전체 Gate를 직렬 재실행해야 한다. 이번 등록은 Read/apply_patch로 계획과 리뷰만 수정했으며 PRD·build guide·production/test는 변경하지 않았다. `P5-R4`, `P5-D2`와 최종 리뷰는 미완료다. +- `2026-10-02`: Phase 7 받은 선물 상세·배송지 입력은 사용자 확인에 따라 Android 앱만 대상으로 문서화했다. 기존 완료 Phase 1~6 기록은 유지하고 PRD 요구사항, API 계약, 성공 기준, 계획 Phase 7 Task를 추가했다. production/test/resource 구현은 실행하지 않았다. - `2026-10-02`: 계획 작성 단계이며 production/test/resource 구현은 실행하지 않았다. 문서 placeholder·금지 표현 검색은 결과 0건, 두 문서 대상 `git diff --check`는 exit 0이었다. 문서에 기록한 Gradle 명령의 유효성을 확인하기 위해 `./gradlew tasks --all`을 실행했고 `BUILD SUCCESSFUL in 16s`로 종료됐다. - `2026-10-02`: Phase 1 gate를 `--rerun`으로 독립 실행했다. `GiftRepositoryTest` 6개와 기존 `GiftInboxViewModelTest`/`GiftSendRequestViewModelTest` 17개가 모두 통과했고 failures, errors, skipped는 각각 0이었다. @@ -1301,3 +1585,5 @@ P1-T1 → P1-T2 → P1-GATE - `2026-10-02` P6-R2·P6-GATE 완료: production/test Kotlin 8개 파일의 ktlint 서식만 수정한 뒤 전체 Gate를 처음부터 직렬 재실행했다. gift/modal focused 149개와 전체 local unit 1,416개는 failures/errors/skipped=0, resource merge·Kotlin compile·ktlint·assembleDebug는 모두 `BUILD SUCCESSFUL`, 전체 `GIT_MASTER=1 git diff --check HEAD`는 무출력(exit 0)이었다. Phase 6은 `5/6`, 다음 Goal은 `P6-REVIEW`다. - `2026-10-02` P6-R3·P6-REVIEW 완료: 최종 context review에서 `REV-P6-REVIEW-001`을 확정하고 View visibility assertion을 상태 기반 `showsTrackingAction` presentation test로 전환했다. 함수 부재 RED 후 presenter 16개와 navigation/detail/cancel 39개 GREEN, `tracking.visibility` 검색 0건을 확인했다. 수정 후 직렬 Gate는 gift/modal 149개와 전체 1,416개 failures/errors/skipped=0, resource/compile/ktlint·assembleDebug 성공, 전체 diff check exit 0이다. 재검토는 goal·QA·quality·security·context 모두 PASS이며 High/Critical 또는 기타 차단 finding은 없다. Phase 6은 `7/7`, 남은 Goal과 blocker는 없다. - `2026-10-02` 종료 문서 후 fresh 검증: `./gradlew :app:testDebugUnitTest --rerun :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck :app:assembleDebug`는 `BUILD SUCCESSFUL in 1m 42s`, JUnit XML 188개에서 1,416 tests, failures/errors/skipped=0이었다. PRD·계획·Phase 6 리뷰의 미완료 체크 검색은 0건이고 `GIT_MASTER=1 git diff --check HEAD`는 무출력(exit 0)이었다. +- `2026-10-02` P7-T5 완료: 성공 event의 Activity 연결 부재 RED를 확인한 뒤 기존 event 소비·Boolean 변경 marker·상세 재조회를 6줄로 연결했다. parent fresh focused 실행은 navigation 21개, detail 17개, recipient 8개, inbox 11개로 총 57개가 failures/errors/skipped=0이며 resource merge·Kotlin compile·ktlint도 성공했다. 명세·품질 리뷰는 모두 APPROVED이고 확정 finding은 없다. Phase 7은 `8/9`, 다음 Goal은 `P7-GATE`다. +- `2026-10-02` P7-R4·P7-GATE 완료: 최종 리뷰의 visibility·View 순서 직접 assertion을 제거하고 AddressForm 헤더를 기존 `선물 받기` 문자열로 분기했다. 헤더 회귀 RED 후 navigation 21개 GREEN, Oracle 재검토에서 두 finding RESOLVED와 P7-R4 APPROVED를 확인했다. 수정 후 직렬 Gate는 gift/modal 180개와 전체 local unit 1,447개가 failures/errors/skipped=0이며 resource/compile/ktlint·assembleDebug 성공, 전체 diff check와 staging 확인은 무출력이다. Phase 7은 `10/10`, 남은 Goal과 blocker는 없다. diff --git a/docs/20261002_선물_상세와_운송장_등록/reviews/phase7-final-review.md b/docs/20261002_선물_상세와_운송장_등록/reviews/phase7-final-review.md new file mode 100644 index 00000000..9bbf848a --- /dev/null +++ b/docs/20261002_선물_상세와_운송장_등록/reviews/phase7-final-review.md @@ -0,0 +1,85 @@ +# Phase 7 최종 코드 리뷰 + +## 1. 리뷰 정보 + +| 항목 | 내용 | +|---|---| +| 리뷰 대상 | Phase 7 전체 | +| 기준 commit 또는 working tree | 미커밋 working tree | +| 리뷰 일자 | 2026-10-02 | +| 리뷰어 | Sisyphus, Oracle | +| 기준 문서 | `prd.md`, `plan-task.md`, 기존 Phase 7 리뷰 3개 | +| 리뷰 상태 | 완료 | + +## 2. 리뷰 목적과 범위 + +- 받은 선물 상태·개인정보·배송지 입력·POST·재조회·목록 갱신의 최종 정합성을 검토한다. +- Phase 7 production, local unit test, resource, 문서를 포함한다. +- 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 저장소 규칙에 따라 제외한다. + +## 3. 판정 기준 + +- 심각도와 상태는 `docs/sample/sample-review.md`를 따른다. +- PRD 위반, 개인정보 노출, 기존 Gift 회귀, 저장소 테스트 정책 위반을 확정 finding으로 전환한다. + +## 4. 검토한 근거 + +- PRD: `GIFT-RECEIVED-*`, `GIFT-ADDRESS-FORM-*`, `GIFT-POSTCODE-*`, `DEC-017`~`020`. +- 계획: `P7-T1`~`P7-T5`, `P7-R1`~`R3`, `P7-GATE`. +- 사전 Gate: gift/modal 180개, 전체 unit 1,447개, resource/compile/ktlint, assembleDebug, diff check 모두 성공. +- 코드·테스트: Phase 7 변경 파일과 기존 SENT/tracking/cancel 영향 범위. + +## 5. 발견 사항 요약 + +| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal | +|---|---|---|---|---|---| +| `REV-P7-GATE-001` | Medium | 수정 완료 | Navigation test가 visibility와 View 자식 순서를 직접 검증함 | `P7-R4` | 금지 assertion 제거와 동작 검증 유지 | +| `REV-P7-GATE-002` | Low | 수정 완료 | 배송지 입력 전 헤더가 `선물 받기` 대신 `선물 상세`를 사용함 | `P7-R4` | AddressForm 전용 헤더 분기와 회귀 test | + +## 6. 발견 사항 상세 + +### REV-P7-GATE-001 — 레이아웃 속성 직접 검증 + +- **심각도:** Medium +- **상태:** 확정 +- **관련 요구사항:** AGENTS.md UI 테스트 정책, PRD 14.4 +- **소유 Task:** `P7-R4` +- **근거:** `GiftNavigationTest`가 `isVisible`과 `indexOfChild(sectionSeparator)`를 직접 assertion한다. +- **권장 조치:** 해당 assertion만 제거하고 상태 전환 후 추가 POST 0회, 정보 행과 제목 같은 허용된 동작 검증을 유지한다. + +### REV-P7-GATE-002 — 배송지 입력 헤더 분기 누락 + +- **심각도:** Low +- **상태:** 확정 +- **관련 요구사항:** PRD 9.2 받은 선물 배송지 입력 전 고정 `선물 받기` header +- **소유 Task:** `P7-R4` +- **근거:** `GiftDetailActivity.bindReceived()`가 모든 received mode에 `gift_recipient_detail_title`을 적용한다. +- **권장 조치:** AddressForm이면 기존 `gift_recipient_receive`, 나머지 received mode이면 `gift_recipient_detail_title`을 사용한다. + +## 7. 확정 항목의 plan·goal 전환 + +두 finding을 `plan-task.md`의 `P7-R4`로 전환했다. + +## 8. 리뷰 종료 판정 + +| 판정 항목 | 결과 | 근거 | +|---|---|---| +| 리뷰 범위 전체 확인 | 충족 | Phase 7 코드·테스트·문서 대조 | +| 후보 항목 판정 완료 | 충족 | 2건 확정 | +| 확정 항목 plan 반영 | 충족 | `P7-R4` 등록 | +| 보류 항목의 담당·재개 조건 기록 | 해당 없음 | 외부 차단 없음 | +| 검증 명령과 결과 기록 | 충족 | 수정 후 focused·전체 Gate 통과 | + +**최종 결론:** APPROVED + +**남은 항목:** 없음 + +## 9. 수정 후 검증 기록 + +- AddressForm 헤더 test는 production 수정 전 `expected:<선물 [받기]> but was:<선물 [상세]>`로 RED를 확인했다. +- `GiftDetailActivity.bindReceived()`는 AddressForm에 기존 `gift_recipient_receive`, 그 외 RECEIVED mode에 기존 `gift_recipient_detail_title`을 사용하도록 최소 수정했다. +- `GiftNavigationTest`에서 금지된 visibility·View 자식 순서 assertion을 제거하고 추가 POST 방지·정보 행·상태별 제목 검증을 유지했다. +- parent fresh `GiftNavigationTest` 21개는 `BUILD SUCCESSFUL in 18s`, resource/compile/ktlint는 `BUILD SUCCESSFUL in 1s`였다. +- Oracle 재검토는 `REV-P7-GATE-001`, `REV-P7-GATE-002` 모두 RESOLVED, P7-R4 APPROVED, 신규 finding 없음으로 판정했다. +- 수정 후 P7-GATE를 직렬 재실행했다. gift/modal 180개와 전체 local unit 1,447개는 failures/errors/skipped=0이며 resource/compile/ktlint와 assembleDebug가 성공했다. +- 전체 `git diff --check HEAD`와 staging 확인은 무출력이었다. 저장소 정책에 따라 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 실행하지 않았다. diff --git a/docs/20261002_선물_상세와_운송장_등록/reviews/phase7-recipient-address-routing-review.md b/docs/20261002_선물_상세와_운송장_등록/reviews/phase7-recipient-address-routing-review.md new file mode 100644 index 00000000..b9b2e840 --- /dev/null +++ b/docs/20261002_선물_상세와_운송장_등록/reviews/phase7-recipient-address-routing-review.md @@ -0,0 +1,91 @@ +# Phase 7 배송지 성공 재조회·목록 갱신 코드 리뷰 + +## 1. 리뷰 정보 + +| 항목 | 내용 | +|---|---| +| 리뷰 대상 | Phase 7 / P7-T5 | +| 기준 commit 또는 working tree | 미커밋 working tree | +| 리뷰 일자 | 2026-10-02 | +| 리뷰어 | Sisyphus, Oracle | +| 기준 문서 | `prd.md`, `plan-task.md` P7-T5 | +| 리뷰 상태 | 판정 완료 | + +## 2. 리뷰 목적과 범위 + +### 목적 + +- 배송지 POST 성공이 같은 신청번호의 상세 GET 재조회와 목록 갱신 결과로 연결되는지 확인한다. +- POST 응답 합성이나 개인정보 Intent·result·saved state 저장 없이 기존 Boolean 변경 marker를 재사용하는지 확인한다. + +### 포함 범위 + +- 코드: `GiftDetailActivity.kt`, 기존 recipient/detail/inbox ViewModel과 Activity result 연결. +- 테스트: `GiftNavigationTest`, `GiftDetailViewModelTest`, `GiftRecipientAddressViewModelTest`, `GiftInboxViewModelTest`. +- 문서: PRD 받은 선물 요구사항과 `P7-T5`. + +### 제외 범위 + +- P7-R3 이전 상태 전환·지역화 finding, 신규 UI 설계, P7-GATE 전체 회귀. +- 기기·에뮬레이터·androidTest·스크린샷·시각 QA. + +## 3. 판정 기준 + +- Blocker/High/Medium/Low 심각도와 후보/확정/오탐/보류/수정 완료 상태는 `docs/sample/sample-review.md`를 따른다. +- 확정 요구사항 위반, 중복 요청, PII 저장, POST 응답 기반 상세 합성, 기존 목록 갱신 회귀를 차단 finding으로 본다. + +## 4. 검토한 근거 + +### 문서와 코드 + +- 요구사항: `GIFT-RECEIVED-001`, `GIFT-ADDRESS-FORM-005`, `DEC-019`. +- 계획: `P7-T5`. +- 코드: `GiftDetailActivity.observe`, `GiftRecipientAddressViewModel.consumeRecipientAddressSuccessEvent`, `GiftDetailViewModel.reloadAfterRecipientAddressSuccess`, `GiftInboxActivity` result launcher. +- 테스트: `받은 선물 진입 후 주소 성공은 같은 상세를 한 번 재조회하고 완료 결과로 목록을 갱신한다`와 관련 focused suite. + +### 실행 환경 + +```text +OS: macOS +검증: Android local unit test, resource merge, Kotlin compile, ktlint +제외: 기기·에뮬레이터·androidTest·스크린샷 +``` + +### 실행한 검증 + +| 명령 또는 수동 검증 | 결과 | 핵심 증거 | +|---|---|---| +| 4개 focused test class `--rerun` | 성공 | `BUILD SUCCESSFUL in 19s`, 57 tests, failures/errors/skipped=0 | +| `:app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck` | 성공 | `BUILD SUCCESSFUL in 1s` | +| 명세 리뷰 | 승인 | 모든 P7-T5 코드 요구사항 MET, 문서 반영만 후속 처리 | +| 코드 품질 리뷰 | 승인 | Critical/Important/Minor finding 없음 | + +## 5. 발견 사항 요약 + +확정 발견 사항 없음. + +## 6. 발견 사항 상세 + +없음. + +## 7. 확정 항목의 plan·goal 전환 + +전환 항목 없음. + +## 8. 리뷰 종료 판정 + +| 판정 항목 | 결과 | 근거 | +|---|---|---| +| 리뷰 범위 전체 확인 | 충족 | 성공 event부터 상세 GET·RESULT_OK·목록 refresh까지 대조 | +| 후보 항목 판정 완료 | 충족 | 확정 finding 없음 | +| 확정 항목 plan 반영 | 해당 없음 | 신규 회귀 Task 불필요 | +| 보류 항목의 담당·재개 조건 기록 | 해당 없음 | 외부 차단 없음 | +| 검증 명령과 결과 기록 | 충족 | focused 57개와 resource/compile/ktlint 기록 | + +**최종 결론:** 확정 발견 사항 없음, APPROVED + +**남은 항목:** `P7-GATE` 전체 회귀 검증 + +## 9. 수정 후 검증 기록 + +수정 finding이 없어 해당 없음. diff --git a/docs/20261002_선물_상세와_운송장_등록/reviews/phase7-recipient-address-ui-review.md b/docs/20261002_선물_상세와_운송장_등록/reviews/phase7-recipient-address-ui-review.md new file mode 100644 index 00000000..d974e6a0 --- /dev/null +++ b/docs/20261002_선물_상세와_운송장_등록/reviews/phase7-recipient-address-ui-review.md @@ -0,0 +1,79 @@ +# Phase 7 받은 선물 배송지 UI 코드 리뷰 + +## 1. 리뷰 정보 + +| 항목 | 내용 | +|---|---| +| 리뷰 대상 | Phase 7 / P7-T4 | +| 기준 commit 또는 working tree | 미커밋 working tree | +| 리뷰 일자 | 2026-10-02 | +| 리뷰어 | Sisyphus, Oracle | +| 기준 문서 | `prd.md`, `plan-task.md`, Figma `2531:36290`, `2531:36399`, `2531:36330`, `2531:36422` | +| 리뷰 상태 | 수정 후 승인 | + +## 2. 리뷰 목적과 범위 + +- 배송지 form, Kakao 결과 연결, 받은 선물 4개 상태와 action이 PRD 및 Figma 구조를 충족하는지 확인했다. +- `GiftDetailActivity`, `activity_gift_detail.xml`, 한/영/일 문자열과 `GiftNavigationTest`를 검토했다. +- P7-T5의 성공 후 상세 재조회와 목록 변경 marker는 제외했다. + +## 3. 검토한 근거 + +- 우편번호 성공은 현재 form의 우편번호·주소만 변경하고 상세 주소에 focus를 요청한다. +- 비정상 결과는 form을 갱신하지 않으며 테스트가 객체 동일성을 검증한다. +- 입력 View에는 `saveEnabled=false`가 적용되고 PII를 Intent·Bundle·로그에 저장하지 않는다. +- Figma parent design context는 timeout됐고 metadata와 하위 노드 `2531:36321`, `2531:36431`, `2531:36401`, `2531:36335`를 대조했다. + +## 4. 발견 사항 요약 + +| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal | +|---|---|---|---|---|---| +| `REV-P7-T4-001` | High | 확정 | 받은 선물 header가 `선물 상세` 대신 SENT용 `신청 상세`를 사용함 | `P7-R2` | 전용 title과 회귀 test | +| `REV-P7-T4-002` | Low | 확정 | 전달 완료 action과 선물 정보 사이 divider 누락 | `P7-R2` | 기존 divider 조건 보완 | +| `REV-P7-T4-003` | Low | 확정 | 이용 약관 동의와 사유 섹션 header 누락 | `P7-R2` | Figma 문구 header 추가 | +| `REV-P7-T4-004` | High | 수정·검증 완료 | Loading/Error에서도 이전 배송지 CTA가 남아 제출 가능 | `P7-R3` | 현재 AddressForm mode로 CTA·progress 제한 | +| `REV-P7-T4-005` | High | 수정·검증 완료 | 수신 상태가 바꾼 정보 visibility와 divider 순서를 다음 bind에서 복원하지 않음 | `P7-R3` | 공통 기본 상태·순서 복원 | +| `REV-P7-T4-006` | Low | 수정·검증 완료 | 완료 hero와 주소 삭제 안내가 한국어 Raw 값으로 고정됨 | `P7-R3` | `GiftDetailText.Key` 지역화 | + +## 5. plan·goal 전환 + +`REV-P7-T4-001`~`003`은 `P7-R2`, 코드 품질 검토에서 확정된 `REV-P7-T4-004`~`006`은 `P7-R3`로 전환했다. 기존 완료 Task 기록은 다시 열거나 삭제하지 않는다. + +## 6. 리뷰 종료 판정 + +| 판정 항목 | 결과 | 근거 | +|---|---|---| +| 리뷰 범위 전체 확인 | 충족 | 코드·테스트·PRD·Figma metadata/context 대조 | +| 후보 항목 판정 완료 | 충족 | 6건 확정 | +| 확정 항목 plan 반영 | 충족 | `P7-R2`, `P7-R3` 등록 | +| 검증 명령과 결과 기록 | 충족 | P7-R2·P7-R3 focused 검증과 재검토 누적 | + +**최종 결론:** APPROVED + +**남은 항목:** 없음. P7-T5 성공 재조회·목록 marker는 기존 리뷰 범위 밖으로 유지한다. + +## 7. 수정 후 검증 기록 + +### 1차 수정 검증 — 2026-10-02 + +- 무엇을: `REV-P7-T4-001`~`003`을 해결했다. +- 왜: 받은 선물 고정 title과 Figma divider·섹션 계층 누락을 해소하기 위해서다. +- 어떻게: + - 제목 test RED에서 `신청 상세` 오출력을 확인하고 RECEIVED 전용 title로 수정했다. + - Figma 하위 context와 XML을 대조해 Delivered divider, `이용 약관 동의`, `사유`를 추가했다. + - focused 43개, resource/compile/ktlint, diff check를 통과했다. + - 명세 재검토에서 세 항목 모두 RESOLVED/APPROVED 판정을 받았다. +- 남은 항목: 코드 품질 검토의 `REV-P7-T4-004`~`006`. + +### 2차 수정 검증 — 2026-10-02 + +- 무엇을: `REV-P7-T4-004`~`006`을 해결했다. +- 왜: 동일 Activity에서 이전 배송지 form 상태가 Loading/Error·다른 상세에 남는 문제와 완료 문구의 한국어 고정을 해소하기 위해서다. +- 어떻게: + - 현재 `AddressForm` 렌더 여부로 CTA·progress 표시와 submit을 함께 제한했다. + - 공통 bind가 선물 정보 visibility와 divider 기본 위치를 먼저 복원하도록 했다. + - 완료 hero·주소 삭제 안내 3개를 `GiftDetailText.Key`와 한/영/일 resource로 연결했다. + - fresh focused 실행은 `BUILD SUCCESSFUL in 20s`, navigation 20개, presenter 24개, recipient ViewModel 8개, detail ViewModel 17개로 총 69개가 failures/errors/skipped=0이다. + - resource merge·Kotlin compile·ktlint는 `BUILD SUCCESSFUL in 1s`였다. + - 품질 재검토에서 세 finding 모두 RESOLVED, 최종 APPROVED 판정을 받았다. +- 남은 항목: 없음. P7-T5는 별도 Task에서 검증한다. diff --git a/docs/20261002_선물_상세와_운송장_등록/reviews/phase7-recipient-address-viewmodel-review.md b/docs/20261002_선물_상세와_운송장_등록/reviews/phase7-recipient-address-viewmodel-review.md new file mode 100644 index 00000000..4deeff41 --- /dev/null +++ b/docs/20261002_선물_상세와_운송장_등록/reviews/phase7-recipient-address-viewmodel-review.md @@ -0,0 +1,55 @@ +# Phase 7 배송지 ViewModel 코드 리뷰 + +## 1. 리뷰 정보 + +| 항목 | 내용 | +|---|---| +| 리뷰 대상 | Phase 7 / P7-T3 | +| 기준 commit 또는 working tree | 미커밋 working tree | +| 리뷰 일자 | 2026-10-02 | +| 리뷰어 | Sisyphus, Oracle | +| 기준 문서 | `prd.md`, `plan-task.md` | +| 리뷰 상태 | 판정 완료 | + +## 2. 리뷰 목적과 범위 + +- 배송지 form validation, POST 요청 매핑, 중복 제출 차단, 실패 복구, 성공 후 상세 재조회 이벤트가 확정 계약과 일치하는지 확인했다. +- `GiftRecipientAddressViewModel`, 관련 `GiftDetailViewModel`, Koin 등록, 한/영/일 문자열과 focused local unit test를 검토했다. +- Activity UI, Kakao 주소 검색 연결, 받은 선물 라우팅은 P7-T4와 P7-T5 범위이므로 제외했다. + +## 3. 검토한 근거 + +- 코드: `GiftRecipientAddressViewModel.kt`, `GiftDetailViewModel.kt`, `AppDI.kt`, `values*/strings.xml` +- 테스트: `GiftRecipientAddressViewModelTest.kt`, `GiftDetailViewModelTest.kt` +- 문서: `P7-T3`, `S7-01`, `S7-02`, `S7-07` + +| 명령 또는 검토 | 결과 | 핵심 증거 | +|---|---|---| +| focused local unit test `--rerun` | 성공 | JUnit XML 기준 8개 + 17개 = 25개 | +| `:app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck` | 성공 | lint 서식 수정 후 `BUILD SUCCESSFUL` | +| `GIT_MASTER=1 git diff --check HEAD` | 성공 | 출력 없음 | +| 명세 검토 | APPROVED | 계약 누락·범위 초과 없음 | +| 코드 품질·보안 검토 | APPROVED | 차단 결함 및 PII 노출 없음 | + +## 4. 발견 사항 요약 + +확정 발견 사항 없음. + +비차단 잔여 위험은 Activity lifecycle에서의 이벤트 소비와 실제 scheduler 전환이며, 각각 P7-T4 연결 테스트와 Phase Gate에서 확인한다. + +## 5. plan·goal 전환 + +전환 항목 없음. + +## 6. 리뷰 종료 판정 + +| 판정 항목 | 결과 | 근거 | +|---|---|---| +| 리뷰 범위 전체 확인 | 충족 | 코드·테스트·DI·리소스 검토 완료 | +| 후보 항목 판정 완료 | 충족 | 차단 finding 없음 | +| 확정 항목 plan 반영 | 해당 없음 | 확정 발견 사항 없음 | +| 검증 명령과 결과 기록 | 충족 | focused 25개, compile/resource/ktlint, diff check 성공 | + +**최종 결론:** 확정 발견 사항 없음 + +**남은 항목:** P7-T4 Activity/UI 연결과 P7-T5 라우팅 검증