From d907d2cdc2cc29e663b0ffdceac741cdf17f3586 Mon Sep 17 00:00:00 2001 From: klaus Date: Fri, 2 Oct 2026 18:30:05 +0900 Subject: [PATCH] =?UTF-8?q?docs(gift):=20=EC=84=A0=EB=AC=BC=20=EC=83=81?= =?UTF-8?q?=EC=84=B8=20=EC=9A=94=EA=B5=AC=EC=82=AC=ED=95=AD=EA=B3=BC=20?= =?UTF-8?q?=EA=B3=84=ED=9A=8D=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 | 1303 +++++++++++++++++ docs/20261002_선물_상세와_운송장_등록/prd.md | 416 ++++++ 2 files changed, 1719 insertions(+) create mode 100644 docs/20261002_선물_상세와_운송장_등록/plan-task.md create mode 100644 docs/20261002_선물_상세와_운송장_등록/prd.md diff --git a/docs/20261002_선물_상세와_운송장_등록/plan-task.md b/docs/20261002_선물_상세와_운송장_등록/plan-task.md new file mode 100644 index 00000000..7838b4ac --- /dev/null +++ b/docs/20261002_선물_상세와_운송장_등록/plan-task.md @@ -0,0 +1,1303 @@ +# 선물 상세와 운송장 등록 구현 계획/TASK + +> **For agentic workers:** REQUIRED SUB-SKILL: Use `superpowers:subagent-driven-development` 또는 `superpowers:executing-plans` to implement this plan task-by-task. 각 단계는 체크박스(`- [ ]`)로 추적하고 완료 즉시 `- [x]`로 갱신한다. 범위가 바뀌면 이 문서를 먼저 수정한다. + +**Goal:** Android 사용자가 선물함에서 신청 상세를 확인하고, 허용된 보낸 신청의 운송장 등록 또는 취소를 완료할 수 있게 한다. + +**Architecture:** 기존 `GiftApi` → `GiftRepository` → `BaseViewModel` → `BaseActivity`/ViewBinding 흐름을 확장한다. 상세와 운송장 등록은 각각 Activity로 분리하고 취소 완료는 상세 Activity의 상태로 렌더링한다. DTO와 Rx API는 기존 gift data 계층을 확장하고, 상태·개인정보·날짜·CTA·입력 validation은 순수 presenter로 분리해 local unit test로 검증한다. + +**Tech Stack:** Kotlin, Android XML Views, ViewBinding, RecyclerView, RxJava3 `Single`, Retrofit, Koin, JUnit4, Robolectric. + +--- + +## 문서 기준 + +- PRD: `docs/20261002_선물_상세와_운송장_등록/prd.md` +- 선행 구현: `docs/20261001_선물함_리스트_페이지/` +- Figma: `2481:19011`, `2481:19152`, `2481:19320`, `2481:19456`, `2481:19500`, `2481:19521`, `2481:19066`, `2481:19109` +- 최초 작성 당시에는 구현 계획만 작성하고 production/test/resource 코드를 변경하지 않았다. 이후 승인된 구현과 회귀 수정을 진행했으며 최종 상태와 증거는 아래에 누적한다. +- 기존 선물함 리스트 문서의 완료 기록과 당시 상태 toast 결정은 이력으로 보존한다. 실제 후속 구현에서만 카드 클릭을 상세 이동으로 교체한다. + +## 현재 상태 + +| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 | +|---:|---|---:|---|---| +| 1 | 완료 | `2/2` | 완료 | 없음 | +| 2 | 완료 | `3/3` | 완료 | 없음 | +| 3 | 완료 | `4/4` (`P3-R1` 포함) | 완료 | 없음 | +| 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` | 완료 | 없음 | + +`P5-D2`에서 최종 직렬 Gate와 재검토 증거에 따라 상태를 정리했다. 아래의 진행 중·대기·실패 기록은 각 실행 당시의 이력이며, 최신 판정은 현재 상태 표와 마지막 Verification Log를 기준으로 한다. 기존 완료 Task와 당시 검증 기록은 보존한다. + +## 범위 + +### 포함 + +- 목록 카드/배송지 안내 배너에서 `applicationNo` 상세 이동. +- 상세 GET API, 상태 hero, 정상 진행 5단계, 방향별 정보 섹션과 action. +- 운송장 등록 화면, 14개 로컬 택배사, POST API와 성공 후 상세 재조회. +- 신청 취소 `V2ModalDialog`, POST API, 실패 유지, 취소 완료 상태. +- 카카오 문의 route 재사용. +- local unit test, resource merge, Kotlin compile, ktlint, debug build. +- Figma 7개 상태의 상세·운송장·취소 완료 UI 재구현과 운송장 ASCII 숫자 10~14자리 검증. + +### 제외 + +- iOS. +- 운송장 수정, 받는 사람 배송지 입력·수정. +- 택배사 API. +- 신규 디자인 시스템·dialog·전역 event bus. +- 상대방 `recipientAddress` 노출. +- gift 리뷰/정책 route 신규 구현. +- `app/src/androidTest`, 기기·에뮬레이터 조작, 스크린샷·시각 QA. + +## 기술적 제약 + +- 신규 feature 코드는 `app/src/main/java/kr/co/vividnext/sodalive/v2/gift` 하위에 둔다. +- API는 기존 `ApiResponse`, Bearer header, RxJava3 `Single`을 재사용한다. +- `response.success && response.data != null`일 때만 payload 성공으로 처리한다. +- Intent는 `applicationNo`와 mutation 결과의 최소 필드만 전달한다. 주소·전화번호 DTO 전체를 전달하지 않는다. +- `direction=SENT` presentation model에는 응답 값이 있어도 `recipientAddress`를 넣지 않는다. +- `mailbox`와 `recipientAddress`를 대체하거나 합치지 않는다. +- 날짜는 UTC ISO를 parse해 기기 timezone의 `MM.dd` 또는 `yyyy.MM.dd`로 표시한다. 파싱 실패를 현재 날짜로 대체하지 않는다. +- `V2ModalDialog`의 기본 동작은 유지하고 취소 flow만 opt-in 비자동 닫힘을 사용한다. +- 신규 dependency는 추가하지 않는다. +- 구현 Task는 `RED → RED 확인 → GREEN → GREEN 확인 → REFACTOR` 순서를 지킨다. +- 정보 카드 label 폭은 Figma 기준으로 일반 정보 84dp, 주소 72dp이며 value와의 간격은 12dp다. +- `RECEIVED`, `CANCELED`, `UNDELIVERABLE`에는 공통 hero illustration과 progress를 표시하지 않는다. + +## 파일 구조 + +### 기존 파일 수정 + +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftApi.kt` + - 상세 조회, 운송장 등록, 신청 취소 Retrofit method. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftRepository.kt` + - 세 endpoint의 Bearer 전달 method. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftModels.kt` + - 상세·주소·delivery·timeline·tracking/cancel request/response DTO. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModel.kt` + - 상태 toast 대신 신청번호 navigation event. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxActivity.kt` + - 상세 Activity result launcher와 변경 후 refresh. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/components/modal/V2ModalDialog.kt` + - 기본값 호환 opt-in `dismissOnConfirm`과 명시적 `dismiss()`. +- `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt` + - 신규 ViewModel 등록. +- `app/src/main/AndroidManifest.xml` + - 상세·운송장 Activity 등록. +- `app/src/main/res/values/strings.xml`, `values-en/strings.xml`, `values-ja/strings.xml` + - 화면 문구. 한국어 외 locale은 기존 앱 정책에 맞는 번역 값을 사용하고 한국어 복제 placeholder를 남기지 않는다. +- `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModelTest.kt` + - 카드 상세 navigation event 회귀. +- `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftSendRequestViewModelTest.kt` + - 확장된 `GiftApi` fake의 미사용 method 구현. +- `app/src/test/java/kr/co/vividnext/sodalive/v2/components/modal/V2ModalDialogTest.kt` + - 기본 호환성과 opt-in 유지·dismiss 검증. +- `docs/agent-guides/build-test-style.md` + - 신규 focused test 클래스 실행 예시. + +### 신규 production 파일 + +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailModels.kt` + - hero, timeline, section, action, canceled completion UI model. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenter.kt` + - DTO → 개인정보 필터링 UI model, 날짜·상태·action 정책. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailViewModel.kt` + - 상세 조회·재시도·외부 mutation 결과 반영. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftCancelViewModel.kt` + - 상세/운송장 두 화면이 사용하는 취소 mutation 상태와 중복 요청 차단. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailActivity.kt` + - 일반 상세/전달 불가/취소 완료 렌더링, tracking result, cancel dialog. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingModels.kt` + - 14개 courier 표시명과 tracking form UI model. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingPresenter.kt` + - 신청 요약, mailbox, CTA validation과 request 변환. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingViewModel.kt` + - 상세 재조회, eligibility, 등록 mutation·event. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingActivity.kt` + - spinner/input/action bar, 등록·취소 result 연결. +- `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftStatusTimelineAdapter.kt` + - 5개 timeline item binding. +- `app/src/main/res/layout/activity_gift_detail.xml` +- `app/src/main/res/layout/activity_gift_tracking.xml` +- `app/src/main/res/layout/include_gift_canceled_completion.xml` +- `app/src/main/res/layout/item_gift_status_timeline.xml` + +### 신규 test 파일 + +- `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/data/GiftRepositoryTest.kt` +- `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenterTest.kt` +- `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailViewModelTest.kt` +- `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftCancelViewModelTest.kt` +- `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 1: API 계약과 data 계층 + +**Phase 결과:** 상세 조회·운송장 등록·신청 취소 계약을 기존 gift repository에서 호출하고 local test double로 검증할 수 있다. + +**선행조건:** PRD 11장 확정. + +### Task 1.1 상세·tracking·cancel DTO 추가 + +**Goal 실행 `P1-T1`:** API JSON을 임의 변환 없이 수용하는 DTO를 추가한다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftModels.kt` +- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/data/GiftRepositoryTest.kt` + +**Interfaces:** + +```kotlin +data class GiftDetailResponse( + val applicationNo: String, + val direction: String, + val status: String, + val statusName: String, + val giftInfo: GiftDetailInfoResponse, + val senderInfo: GiftAddressResponse?, + val recipientAddress: GiftAddressResponse?, + val mailbox: GiftAddressResponse?, + val trackingRequired: Boolean, + val recipientAddressRequired: Boolean, + val recipientAddressDeadlineAt: String?, + val delivery: GiftDeliveryResponse, + val statusTimeline: List +) + +data class GiftTrackingRequest(val courierCompanyName: String, val trackingNumber: String) +data class GiftTrackingResponse( + val applicationNo: String, + val status: String, + val statusName: String, + val courierCompanyName: String, + val trackingNumber: String, + val trackingRegisteredAt: String, + val recipientAddressDeadlineAt: String +) + +data class GiftCancelResponse( + val applicationNo: String, + val status: String, + val statusName: String, + val priceCan: Int, + val canceledAt: String +) +``` + +- [x] **RED:** Gson으로 상세 예시를 decode했을 때 nullable 주소·delivery·5개 timeline과 field 값이 보존되는 테스트를 작성한다. +- [x] **RED:** tracking request JSON key가 `courierCompanyName`, `trackingNumber`이고 cancel response의 `priceCan`, `canceledAt`이 보존되는 테스트를 작성한다. +- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftRepositoryTest"`를 실행해 DTO 부재의 의도한 compile 실패를 기록한다. +- [x] **GREEN:** `@Keep`, `@SerializedName`을 기존 `GiftModels.kt` 스타일로 적용해 PRD 계약의 DTO만 추가한다. +- [x] **GREEN 확인:** 같은 focused test를 실행해 DTO decode/encode assertion PASS를 확인한다. +- [x] **REFACTOR:** 반복 주소 구조만 `GiftAddressResponse`로 공유하고 실제 계약에 없는 fallback field·alternate name을 추가하지 않는다. + +### Task 1.2 Retrofit·repository method 추가 + +**Goal 실행 `P1-T2`:** 세 endpoint에 applicationNo, request, Bearer header를 정확히 전달한다. + +**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/test/java/kr/co/vividnext/sodalive/v2/gift/data/GiftRepositoryTest.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 +fun GiftApi.getGiftDetail(applicationNo: String, authHeader: String): Single> +fun GiftApi.registerGiftTracking( + applicationNo: String, + request: GiftTrackingRequest, + authHeader: String +): Single> +fun GiftApi.cancelGift(applicationNo: String, authHeader: String): Single> +``` + +- [x] **RED:** fake API가 각 path parameter, body, header를 기록하고 repository 호출과 정확히 일치하는지 검증한다. +- [x] **RED 확인:** focused repository test가 method 부재로 실패하는지 확인한다. +- [x] **GREEN:** `@Path("applicationNo")`, `@Body`, `@Header("Authorization")`을 사용하고 repository는 값을 그대로 전달한다. +- [x] **GREEN 확인:** repository test와 기존 `GiftInboxViewModelTest`, `GiftSendRequestViewModelTest`를 실행해 PASS를 확인한다. +- [x] **REFACTOR:** 기존 fake에는 미사용 신규 method가 명시적으로 `UnsupportedOperationException`을 반환하게 하고 production fallback은 추가하지 않는다. + +### Phase 1 Gate + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftRepositoryTest" +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestViewModelTest" +``` + +**Expected:** DTO 계약과 세 API 전달 test가 통과하고 기존 gift API fake 회귀가 없다. + +--- + +## Phase 2: 상세 presentation·조회·목록 navigation + +**Phase 결과:** 선물함에서 신청번호 상세를 열어 7개 상태, 5단계 이력, 허용된 정보와 action을 확인할 수 있다. + +**선행조건:** `P1-GATE` 완료. + +### Task 2.1 상세 presenter와 날짜·개인정보 정책 + +**Goal 실행 `P2-T1`:** 상세 응답을 Figma 구조와 개인정보 규칙에 맞는 UI model로 변환한다. + +**Files:** + +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailModels.kt` +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenter.kt` +- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenterTest.kt` + +**Interfaces:** + +```kotlin +object GiftDetailPresenter { + fun present(detail: GiftDetailResponse, cancel: GiftCancelResponse? = null): GiftDetailUiModel + fun formatProgressDate(occurredAt: String?): String? + fun formatCardDate(occurredAt: String?): String? +} +``` + +- [x] **RED:** 7개 status fixture의 chip/title/body가 PRD 8.2 표와 일치하는 test를 작성한다. +- [x] **RED:** timeline 응답 순서와 무관하게 정상 5개 상태를 지정 순서로 만들고 `occurredAt`이 있는 단계만 완료·`MM.dd`가 되는 test를 작성한다. +- [x] **RED:** 종료 상태가 timeline 이력을 보존하며 종료 status 자체는 step에 추가하지 않는 test를 작성한다. +- [x] **RED:** SENT 응답에 recipientAddress가 있어도 UI model에 없고, RECEIVED에서만 본인 주소가 표시되는 test를 작성한다. +- [x] **RED:** senderInfo/mailbox/reason/paidCan/tracking/검수일/완료일/취소일 nullable 표시와 undeliverable fallback을 검증한다. +- [x] **RED:** cancel response가 있으면 `canceledAt/priceCan`을 우선하고 직접 CANCELED 조회는 `delivery.canceledAt/giftInfo.paidCan`을 사용하는 test를 작성한다. +- [x] **RED 확인:** presenter focused test가 신규 type 부재로 실패하는지 확인한다. +- [x] **GREEN:** when mapping과 작은 UTC formatter로 test를 통과시키며 unknown status에서는 서버 `statusName`을 보존하고 mutation action을 열지 않는다. +- [x] **GREEN 확인:** focused test PASS를 확인한다. +- [x] **REFACTOR:** 상태별 매핑과 날짜 parser 중 이번 Task에서 생긴 중복만 정리한다. + +### Task 2.2 상세 ViewModel·Activity·resource 연결 + +**Goal 실행 `P2-T2`:** applicationNo로 상세를 조회하고 일반/전달 불가/취소 완료 화면과 오류 재시도를 렌더링한다. + +**Files:** + +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailViewModel.kt` +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailActivity.kt` +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftStatusTimelineAdapter.kt` +- Create: `app/src/main/res/layout/activity_gift_detail.xml` +- Create: `app/src/main/res/layout/include_gift_canceled_completion.xml` +- Create: `app/src/main/res/layout/item_gift_status_timeline.xml` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt` +- Modify: `app/src/main/AndroidManifest.xml` +- Modify: locale string files +- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailViewModelTest.kt` + +**State:** `Loading`, `Content(GiftDetailResponse)`, `Canceled(GiftDetailResponse, GiftCancelResponse?)`, `Error(message)`. + +- [x] **RED:** blank applicationNo는 request 0회와 종료용 오류 event, 유효 번호는 상세 request 1회를 만드는 test를 작성한다. +- [x] **RED:** loading → content, success=false, data=null, transport error, retry의 상태 전이를 검증한다. +- [x] **RED:** GET이 CANCELED이면 즉시 `Canceled`, 일반 status이면 `Content`가 되는 test를 작성한다. +- [x] **RED:** 문의 event가 기존 카카오 ACTION_VIEW URL을 한 번 반환하고 review/policy event는 존재하지 않는지 검증한다. +- [x] **RED 확인:** focused ViewModel test 실패를 확인한다. +- [x] **GREEN:** 기존 scheduler/token/toast 패턴으로 최소 ViewModel을 구현하고 Activity는 presenter model만 bind한다. +- [x] **GREEN 확인:** focused ViewModel/presenter test, `:app:mergeDebugResources`, `:app:compileDebugKotlin` PASS를 확인한다. +- [x] **REFACTOR:** Activity를 setup/observe/render/showCancelDialog 단위로만 정리하고 공통 UI abstraction은 만들지 않는다. +- [x] **TDD 예외 및 대체 검증:** 고정 header·scroll·safe area·Figma 간격은 layout source 대조와 resource/compile로 확인하고 View 속성 unit test는 작성하지 않는다. + +### Task 2.3 선물함 카드 상세 navigation과 result refresh + +**Goal 실행 `P2-T3`:** 기존 상태 toast를 신청번호 상세 이동으로 교체하고 변경 후 목록을 갱신한다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModel.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxActivity.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModelTest.kt` +- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` + +**Interface:** `onCardClick(card)` → 한 번 소비되는 `applicationNo`; Activity → `GiftDetailActivity.newIntent`. + +- [x] **RED:** 카드/주소 배너 클릭이 status toast 대신 같은 applicationNo navigation event를 한 번 발생시키는 test로 기존 toast test를 교체한다. +- [x] **RED:** 상세 Intent가 applicationNo를 보존하고 RESULT_OK일 때만 목록 refresh를 호출하는 routing test를 작성한다. +- [x] **RED 확인:** 기존 toast 구현 때문에 assertion이 실패하는지 확인한다. +- [x] **GREEN:** consumable navigation LiveData와 Activity Result launcher를 최소 연결한다. +- [x] **GREEN 확인:** `GiftInboxViewModelTest`, `GiftNavigationTest`, 상세 focused test PASS를 확인한다. +- [x] **REFACTOR:** 기존 pagination/refresh/inquiry 동작과 adapter click signature를 변경하지 않고 diff를 확인한다. + +### Phase 2 Gate + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailPresenterTest" +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailViewModelTest" +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" +./gradlew :app:mergeDebugResources :app:compileDebugKotlin +``` + +**Expected:** 5단계·7개 상태·주소 privacy·상세 조회/재시도·목록 navigation이 통과한다. + +--- + +## Phase 3: 운송장 등록 + +**Phase 결과:** 등록 가능한 보낸 신청에서 SODALIVE 사서함을 확인하고 유효한 운송장 정보를 한 번 제출한 뒤 갱신된 상세를 확인한다. + +**선행조건:** `P2-GATE` 완료. + +### Task 3.1 tracking form presenter와 로컬 택배사 + +**Goal 실행 `P3-T1`:** 신청 요약·mailbox·택배사·운송장 번호를 등록 가능한 form model과 request로 변환한다. + +**Files:** + +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingModels.kt` +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingPresenter.kt` +- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingPresenterTest.kt` + +**Interfaces:** + +```kotlin +val giftCourierCompanyNames: List +fun GiftTrackingPresenter.present(detail: GiftDetailResponse): GiftTrackingUiModel +fun GiftTrackingPresenter.isSubmitEnabled(courier: String?, trackingNumber: String): Boolean +fun GiftTrackingPresenter.toRequest(courier: String, trackingNumber: String): GiftTrackingRequest +``` + +- [x] **RED:** 14개 택배사의 정확한 순서·한글명과 API 조회 의존성이 없음을 검증한다. +- [x] **RED:** `trackingRequired=false`와 `mailbox=null`은 등록 불가, 유효 SENT detail은 신청 요약·RECEIVED 신청일 `yyyy.MM.dd`·mailbox를 만드는 test를 작성한다. +- [x] **RED:** 택배사 null/blank 또는 tracking number blank/공백은 CTA false, 두 값이 있으면 true인 test를 작성한다. +- [x] **RED:** request가 선택 표시명과 trim한 번호를 그대로 사용하는지 검증한다. +- [x] **RED 확인:** focused test 실패를 확인한다. +- [x] **GREEN:** 로컬 list와 순수 변환만 구현한다. +- [x] **GREEN 확인:** focused test PASS를 확인한다. +- [x] **REFACTOR:** 택배사 code나 validation 상한을 추가하지 않는다. + +### Task 3.2 tracking ViewModel + +**Goal 실행 `P3-T2`:** 상세를 재조회해 eligibility를 확인하고 tracking POST의 loading/error/success를 관리한다. + +**Files:** + +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingViewModel.kt` +- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingViewModelTest.kt` + +- [x] **RED:** 진입 시 상세 GET 1회, `trackingRequired=false` 또는 mailbox null에서 등록 불가 event와 POST 0회를 검증한다. +- [x] **RED:** invalid form submit은 POST 0회다. +- [x] **RED:** pending POST 중 재탭은 1회 요청, 실패는 입력 유지·toast·재시도 가능, 성공은 one-shot success event를 검증한다. +- [x] **RED:** request body가 선택한 한글명과 trim 번호인지 검증한다. +- [x] **RED 확인:** focused test 실패를 확인한다. +- [x] **GREEN:** 기존 Rx/token/toast 패턴과 `isSubmitting` guard로 최소 구현한다. +- [x] **GREEN 확인:** focused tracking presenter/ViewModel test PASS를 확인한다. +- [x] **REFACTOR:** 상세 조회 오류와 submit 오류 상태를 분리하고 retry 대상이 섞이지 않게 한다. + +### Task 3.3 tracking Activity와 상세 재조회 + +**Goal 실행 `P3-T3`:** Figma 구조의 운송장 화면을 연결하고 성공 후 상세를 재조회한다. + +**Files:** + +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingActivity.kt` +- Create: `app/src/main/res/layout/activity_gift_tracking.xml` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailActivity.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt` +- Modify: `app/src/main/AndroidManifest.xml` +- Modify: locale string files +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` + +- [x] **RED:** detail의 tracking CTA Intent와 tracking 성공 RESULT_OK가 같은 applicationNo를 보존하고 상세 reload를 호출하는 test를 작성한다. +- [x] **RED:** 일반 back/취소는 성공 result를 만들지 않는 test를 작성한다. +- [x] **RED 확인:** 신규 Activity/result 연결 부재로 실패를 확인한다. +- [x] **GREEN:** 기존 spinner 선택 패턴, EditText listener, enabled/disabled button resource를 재사용해 화면을 연결한다. +- [x] **GREEN:** 등록 성공 toast 후 RESULT_OK로 finish하고 상세 launcher callback에서 `reload()`를 호출한다. +- [x] **GREEN 확인:** navigation/tracking focused test와 resource merge/Kotlin compile PASS를 확인한다. +- [x] **REFACTOR:** Activity에 API 로직을 두지 않고 입력 read/bind와 navigation만 유지한다. +- [x] **TDD 예외 및 대체 검증:** layout 간격·색상·constraint는 Figma와 resource source 대조로 확인한다. + +### Task 3.R1 tracking 실패 Toast 중복 노출 회귀 수정 + +**Goal 실행 `P3-R1`:** 확정 review 항목 `REV-P3-T3-001`을 수정해 소비한 실패 Toast가 Activity 재생성 시 다시 표시되지 않게 한다. + +- **시작 조건:** `REV-P3-T3-001` 확정, P3-T3 spec review APPROVED, quality review CHANGES REQUESTED. +- **대상 파일:** `GiftTrackingViewModel.kt`, `GiftTrackingActivity.kt`, `GiftTrackingViewModelTest.kt`. +- **수정 범위:** Toast 소비 함수와 Activity 소비 연결만 추가한다. +- **회귀 테스트:** 이전 Toast는 한 번만 소비되고 새 실패 Toast는 다시 소비되는지 검증한다. +- **완료 증거:** 재현 test RED → 최소 수정 GREEN → tracking/navigation focused test → Phase 3 Gate → 리뷰 보고서 수정 검증 기록. +- **범위 밖:** 성공 후 재제출 guard, CTA 계측 test, Phase 4 취소, UI 재설계. + +- [x] Toast 소비 회귀 test를 먼저 추가하고 기존 구현에서 의도한 실패를 확인한다. +- [x] ViewModel 소비 함수와 Activity 소비 연결만 최소 수정한다. +- [x] tracking/navigation focused test와 Phase 3 Gate를 실행한다. +- [x] `plan-task.md`와 review 보고서에 수정 검증 결과를 누적한다. + +### Phase 3 Gate + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftTrackingPresenterTest" +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftTrackingViewModelTest" +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" +./gradlew :app:mergeDebugResources :app:compileDebugKotlin +``` + +**Expected:** validation, POST payload, duplicate suppression, 성공 후 상세 재조회가 통과한다. + +--- + +## Phase 4: V2 dialog와 신청 취소 + +**Phase 결과:** 상세와 운송장 화면에서 확인 후 신청을 취소하고 실패 시 dialog를 유지하며 성공 시 취소 완료 상세로 돌아간다. + +**선행조건:** `P2-GATE`, `P3-GATE` 완료. + +### Task 4.1 V2ModalDialog 호환 확장 + +**Goal 실행 `P4-T1`:** 기존 호출 동작을 유지하면서 confirm 후 자동으로 닫지 않는 opt-in을 제공한다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/components/modal/V2ModalDialog.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/components/modal/V2ModalDialogTest.kt` + +**Interface:** 생성자 끝에 `dismissOnConfirm: Boolean = true`, public `dismiss()` 추가. 기존 인자 순서와 기본 동작은 유지한다. + +- [x] **RED:** 기본 dialog는 confirm 1회 실행 후 닫히며 기존 테스트가 그대로 통과하는 회귀 test를 유지한다. +- [x] **RED:** `dismissOnConfirm=false`이면 confirm callback 후에도 열려 있고, 실패 복구 후 재클릭 callback이 가능하며 `dismiss()`로 닫히는 test를 작성한다. +- [x] **RED:** cancel은 opt-in 여부와 무관하게 dialog만 닫는 test를 작성한다. +- [x] **RED 확인:** 신규 parameter/dismiss 부재로 실패를 확인한다. +- [x] **GREEN:** confirm branch만 기본 자동 dismiss와 opt-in callback으로 나누고 기존 `dismissAndRun` one-shot 동작은 기본 branch에 보존한다. +- [x] **GREEN 확인:** 전체 `V2ModalDialogTest` PASS를 확인한다. +- [x] **REFACTOR:** loading·API 상태를 공통 dialog에 넣지 않고 feature Activity가 `dialogView` enabled/loading 표현을 제어하게 한다. + +### Task 4.2 공용 gift 취소 ViewModel + +**Goal 실행 `P4-T2`:** 상세와 운송장 두 화면에서 같은 취소 mutation·중복 방지·오류·성공 event를 사용한다. + +**Files:** + +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftCancelViewModel.kt` +- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftCancelViewModelTest.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt` + +- [x] **RED:** dialog open 또는 `나가기`만으로 API가 호출되지 않는 ViewModel/Activity 계약 test를 작성한다. +- [x] **RED:** `direction=SENT && status=RECEIVED`가 아니면 POST 0회다. +- [x] **RED:** pending 상태의 double confirm은 POST 1회다. +- [x] **RED:** 실패는 loading false·toast·성공 event 없음이며 같은 applicationNo 재시도가 가능하다. +- [x] **RED:** 성공은 `GiftCancelResponse` one-shot event를 내보낸다. +- [x] **RED 확인:** focused test 실패를 확인한다. +- [x] **GREEN:** eligibility와 in-flight guard를 적용해 repository cancel을 호출한다. +- [x] **GREEN 확인:** focused cancel test PASS를 확인한다. +- [x] **REFACTOR:** Activity별 취소 로직 중복을 만들지 않고 cancellation만 이 ViewModel이 소유한다. + +### Task 4.R1 열린 dialog의 나가기 계약 회귀 검증 + +**Goal 실행 `P4-R1`:** 확정 review 항목 `REV-P4-T2-001`을 해소해 열린 dialog의 나가기에서 취소 API가 호출되지 않음을 독립 검증한다. + +- **시작 조건:** P4-T2 구현 완료, `REV-P4-T2-001` 확정. +- **대상 파일:** `GiftCancelViewModelTest.kt`. +- **수정 범위:** 뒤로가기와 나가기를 각각 새 dialog에서 실행하는 test 순서 보강만 수행한다. +- **회귀 테스트:** 열린 dialog에서 나가기 클릭 후 dialog 닫힘, POST 0회, loading false, 성공 event 없음. +- **완료 증거:** 보강된 focused test PASS → P4-T2 reviewer 재검토 → 문서 검증 기록. +- **범위 밖:** production 코드, P4-T3 Activity 연결, dialog 구현 변경. + +- [x] 열린 dialog의 나가기 계약을 별도 인스턴스로 검증한다. +- [x] focused cancel test와 production/test Kotlin compile을 실행한다. +- [x] 원 reviewer 재검토와 문서 검증 기록을 완료한다. + +### Task 4.3 상세·tracking 취소 dialog와 완료 상태 연결 + +**Goal 실행 `P4-T3`:** 두 화면의 `신청 취소`가 동일한 V2 dialog 흐름을 사용하고 성공 후 상세의 취소 완료 상태를 표시한다. + +**Files:** + +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftCancellation.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailActivity.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailViewModel.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingActivity.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingViewModel.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailViewModelTest.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingViewModelTest.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` +- Modify: locale string files + +**범위 보강:** tracking 화면은 기존 상세 GET 응답을 UI model로 변환한 뒤 원본을 보존하지 않아 `GiftCancelViewModel`의 SENT+RECEIVED eligibility 입력을 제공할 수 없다. 추가 GET이나 DTO 합성 대신 `GiftTrackingViewModel`이 이미 받은 원본 상세를 읽기 전용으로 보존·노출하고 local unit test로 고정한다. + +- [x] **RED:** 상세 취소 응답을 적용하면 cancel 값 우선의 `Canceled` 상태가 되고 뒤로가기 result가 목록 refresh를 유도하는 test를 작성한다. +- [x] **RED:** tracking 화면 취소 성공 result가 canceledAt/priceCan을 상세에 전달하고 tracking 화면을 제거하는 test를 작성한다. +- [x] **RED:** 실패 상태에서 dialog가 열린 채 confirm이 다시 활성화되고 성공에서만 dismiss되는 source/routing 계약을 검증한다. +- [x] **RED 확인:** 연결 부재로 focused test 실패를 확인한다. +- [x] **GREEN:** 두 Activity가 `V2ModalDialog(dismissOnConfirm=false)`를 생성하고 cancel ViewModel loading 동안 버튼을 비활성화한다. +- [x] **GREEN:** 실패는 toast 후 버튼을 복구하고, 성공은 dismiss 후 상세 `Canceled` 반영 또는 tracking result 전달을 수행한다. +- [x] **GREEN 확인:** cancel/detail/navigation/modal focused test와 resource/compile PASS를 확인한다. +- [x] **REFACTOR:** dialog title/body/action 문구 생성과 결과 extra key만 중복 없이 한 feature helper 경계에 둔다. 신규 dialog class는 만들지 않는다. + +### Task 4.R2 조회 중 취소 결과 유실 회귀 수정 + +**Goal 실행 `P4-R2`:** 확정 review 항목 `REV-P4-T3-001`을 해소해 상세 최초 조회 중 도착한 동일 신청의 취소 결과를 조회 완료 후 우선 적용한다. + +- **시작 조건:** P4-T3 구현 완료, `REV-P4-T3-001` 확정. +- **대상 파일:** `GiftDetailViewModel.kt`, `GiftDetailViewModelTest.kt`. +- **수정 범위:** 현재 신청번호와 일치하는 pending 취소 응답 1개를 ViewModel에 보존하고 성공 상세 응답에 적용한다. +- **회귀 테스트:** 조회 중 동일 신청 취소 결과 보존·성공 상세 적용, 다른 신청번호 무시, 조회 실패 후 재시도 성공 시 보존 결과 적용. +- **완료 증거:** 실패 재현 test → 최소 수정 → focused test → Phase 4 Gate → 원 reviewer 재검토 → 문서 검증 기록. +- **범위 밖:** 추가 상세 GET, API/repository/DTO/Activity 변경, 신규 공통 추상화, UI 재설계. + +- [x] 조회 중 동일 신청 취소 결과가 현재 구현에서 유실되는 회귀 test를 먼저 추가하고 의도한 assertion 실패를 확인한다. +- [x] pending 취소 응답을 최소 상태로 보존하고 성공 상세 응답에 우선 적용한다. +- [x] 다른 신청번호 무시와 조회 실패·재시도 보존을 local unit test로 검증한다. +- [x] 관련 focused test와 Phase 4 Gate를 실행한다. +- [x] 원 reviewer 재검토와 문서 검증 기록을 완료한다. + +### Phase 4 Gate + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.components.modal.V2ModalDialogTest" +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftCancelViewModelTest" +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" +./gradlew :app:mergeDebugResources :app:compileDebugKotlin +``` + +**Expected:** 확인 전 POST 0회, 중복 0회, 실패 dialog 유지, 성공 취소 완료 전환과 back stack 안전성이 통과한다. + +--- + +## Phase 5: 통합 검증과 문서 갱신 + +**Phase 결과:** PRD의 전체 흐름과 공통 modal 회귀가 자동 검증·source 대조·문서 증거로 추적된다. + +**선행조건:** Phase 1~4 Gate 완료. + +### Task 5.1 최종 Gate + +**Goal 실행 `P5-GATE`:** 전체 gift와 modal 영향 범위를 검증하고 실제 결과를 누적한다. + +- **TDD 예외 사유:** 신규 동작을 만드는 Task가 아니라 완료 결과를 판정하는 검증 Task다. +- **대체 검증 방법:** 아래 명령과 PRD 요구사항 대조표를 사용한다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --tests "kr.co.vividnext.sodalive.v2.components.modal.*" +./gradlew :app:testDebugUnitTest +./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck +./gradlew :app:assembleDebug +git diff --check HEAD +``` + +**Expected:** + +- 모든 명령 exit 0. +- 정상 progress 5개와 7개 hero 상태 test PASS. +- SENT recipientAddress 노출 0건, RECEIVED 본인 주소 조건부 표시 PASS. +- invalid tracking/cancel POST 0회, in-flight 중복 POST 0회. +- 취소 실패 dialog 유지, 성공 canceled completion, tracking 성공 상세 재조회 PASS. +- 신규 취소 완료 Activity, tracking 수정, courier API, gift 리뷰/정책 route가 없다. +- 기존 gift 목록 pagination/refresh/inquiry와 기본 V2ModalDialog 동작이 유지된다. + +### Task 5.R1 gift test ktlint 회귀 수정 + +**Goal 실행 `P5-R1`:** 최종 Gate에서 확인된 gift production/test 10개 파일의 ktlint 위반을 동작 변경 없이 정리한다. + +- **시작 조건:** P5-GATE의 test lint 104건과 후속 main lint 26건 실패, gift production/test 10개 파일 확인. +- **대상 파일:** test의 `GiftCancelViewModelTest.kt`, `GiftDetailPresenterTest.kt`, `GiftDetailViewModelTest.kt`, `GiftNavigationTest.kt`, `GiftTrackingPresenterTest.kt`, `GiftTrackingViewModelTest.kt`; production의 `GiftDetailActivity.kt`, `GiftDetailPresenter.kt`, `GiftDetailViewModel.kt`, `GiftTrackingActivity.kt`. +- **수정 범위:** argument/wrapping, annotation 사이 공백, multiline if braces, max line length 서식만 수정한다. +- **완료 증거:** formatter 변경 범위 확인 → gift/modal test → 전체 unit test → compile/ktlint → assemble → diff check. +- **범위 밖:** production 동작, 테스트 assertion·fixture·동작 변경, lint 설정 변경. + +- [x] formatter와 수동 서식 수정을 실행하고 변경 파일이 report의 gift production/test 파일에만 제한되는지 확인한다. +- [x] 포맷 전후 테스트 동작이 동일함을 gift/modal 및 전체 unit test로 검증한다. +- [x] 최종 Gate의 compile/ktlint, assemble, diff check를 다시 실행한다. +- [x] 실행 결과를 Progress와 Verification Log에 누적한다. + +### Task 5.R2 Gift 개인정보 네트워크 로그 차단 + +**Goal 실행 `P5-R2`:** High 확정 항목 `REV-P5-001`을 수정해 Gift 요청·응답의 개인정보가 debug BODY 로그에 남지 않게 한다. + +- **시작 조건:** quality/context의 PII 지적과 직접 focused security 재시도 FAIL로 확정. 사용자가 레거시 `AppDI.kt`의 Gift 전용 네트워크 격리를 명시 승인했다. +- **대상 파일:** Modify: `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt`; Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/data/GiftNetworkPrivacyTest.kt`. +- **수정 범위:** 공유 client의 debug BODY/release NONE을 유지한다. `AppDI.kt`에 `named("giftHttpClient")`와 `named("giftRetrofit")`를 등록하고 Gift 로깅은 debug/release 모두 NONE으로 고정한다. `GiftApi`만 named Gift Retrofit에 바인딩한다. 기존 인증·언어·timeout·converter·Rx 설정을 유지하고 BODY interceptor를 Gift client에 상속하지 않는다. +- **회귀 테스트:** 실제 DI 연결을 통해 Gift client의 로깅 NONE 및 공유 client와의 분리를 검증한다. 가상 PII 요청·응답이 Gift 경로에서 로그에 출력되지 않고 공유 debug BODY/release NONE 정책은 유지되는지 확인한다. 실데이터·토큰·BuildConfig 값을 증거로 출력하지 않는다. +- **완료 증거:** test-first RED → 최소 수정 GREEN → focused privacy/repository 검증 → 직접 focused security 재검토 → `P5-R3` 후 전체 `P5-GATE` 재실행 결과 누적. +- **범위 밖:** 신규 dependency, 공유 로깅 정책 변경, 다른 API 바인딩 변경, 레거시 리팩터링, 보안 가이드 변경. + +- [x] **RED:** `GiftNetworkPrivacyTest`에 Gift 로그 차단·DI 분리·공유 로깅 정책 회귀 테스트를 먼저 작성한다. +- [x] **RED 확인:** 아래 focused 명령으로 기존 Gift 공유 BODY 연결 때문에 실패함을 확인하고 실제 실패 원인을 기록한다. +- [x] **GREEN:** 승인된 named Gift client/Retrofit 등록과 `GiftApi` 바인딩만 최소 수정한다. +- [x] **GREEN 확인:** 같은 focused 명령으로 privacy와 repository 계약 PASS를 확인하고 security 재검토 결과를 누적한다. +- [x] **전체 Gate 의존성:** `P5-R3` 수정 후 Task 5.1의 모든 명령을 재실행하고, 결과가 확인되기 전에는 이 Task를 완료로 판정하지 않는다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftNetworkPrivacyTest" --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftRepositoryTest" --rerun +``` + +**Task 검증 기록:** RED 완료. `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftNetworkPrivacyTest" --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftRepositoryTest" --rerun`은 `GiftNetworkPrivacyTest.kt:59`의 `GiftApi must not use the shared debug BODY Retrofit` assertion에서 의도대로 실패했고, 기존 `GiftRepositoryTest` 6개는 통과했다. GREEN 완료. 같은 명령은 `BUILD SUCCESSFUL in 20s`로 종료했고 privacy 1개와 repository 6개, 총 7개 test가 통과했다. debug 공유 BODY/release 공유 NONE, Gift NONE·별도 logger, Gift Retrofit 바인딩, 인증·언어 interceptor·timeout 보존, 가상 개인정보 request/response의 로그 미출력을 local test로 확인했다. focused security 재검토와 `P5-R3` 후 전체 Gate는 미실행이며 수정·검증 대기다. + +**최종 검증 추가:** 직접 standalone security 재시도 PASS로 `REV-P5-001`을 닫았다. `P5-R4` 이후 최종 직렬 Gate에서 gift/modal 142개와 전체 unit 1409개가 failures/errors/skipped=0으로 통과했고 resource/compile/ktlint, assemble, diff check도 통과했다. `P5-R2` 수정·검증 완료다. + +### Task 5.R3 상세 Activity 재생성 후 변경 결과 보존 + +**Goal 실행 `P5-R3`:** Medium 확정 항목 `REV-P5-002`를 수정해 mutation 성공 후 상세 Activity를 재생성해도 선물함 갱신용 `RESULT_OK`를 보존한다. + +- **시작 조건:** quality review의 Activity result 유실 확정. `P5-R2` 후 진행한다. +- **대상 파일:** 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`. +- **수정 범위:** 변경 여부 boolean 하나만 saved state에 저장·복원하고 true일 때 `RESULT_OK`를 복원한다. tracking 성공, 상세 직접 취소 성공, tracking 취소 성공의 기존 결과 경로를 연결한다. 주소·전화번호·DTO·취소 응답을 saved state에 추가하지 않는다. +- **회귀 테스트:** Robolectric `ActivityController.recreate()`로 tracking 성공 후 재생성, 직접/하위 화면 취소 성공 후 재생성의 양성 결과를 검증한다. 변경 없는 상세 및 mutation 없는 CANCELED 조회는 재생성 후에도 성공 결과를 만들지 않는 음성 결과를 유지한다. 추가 saved state는 boolean뿐인지 확인한다. +- **완료 증거:** 실제 Activity 결과의 RED → boolean 최소 수정 GREEN → navigation/detail/cancel focused 검증 → `P5-R2`와 함께 전체 `P5-GATE` 재실행 결과 누적. +- **범위 밖:** ViewModel/DTO/API 계약 변경, 개인정보 영속화, 취소 상태 전체 복원, 기기·에뮬레이터 조작, UI 속성 테스트. + +- [x] **RED:** `GiftNavigationTest`에 mutation 성공과 변경 없는 경우의 Robolectric recreate 회귀 테스트를 먼저 추가한다. +- [x] **RED 확인:** 아래 focused 명령으로 tracking 성공 후 재생성에서 `RESULT_OK`가 유실되는 assertion 실패를 확인한다. 기존 취소·음성 결과도 함께 기록한다. +- [x] **GREEN:** 변경 여부 boolean의 저장·복원과 성공 결과 연결만 구현한다. +- [x] **GREEN 확인:** 같은 focused 명령으로 tracking/cancel 양성 결과와 변경 없는 음성 결과가 모두 통과하고 저장 상태에 PII가 추가되지 않았는지 확인한다. +- [x] **REFACTOR:** 이번 회귀 수정의 중복만 점검하고 기존 결과 payload·DTO·API 계약을 변경하지 않는다. +- [x] **전체 Gate 의존성:** `P5-R2` 수정과 focused 검증이 끝난 뒤 Task 5.1 전체 명령을 재실행하고 결과를 누적한다. 과거 Gate PASS로 대체하지 않는다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftCancelViewModelTest" --rerun +``` + +**Task 검증 기록:** RED 완료. `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftCancelViewModelTest" --rerun`은 20초 후 `GiftNavigationTest.kt:230`의 tracking 성공 → recreate → 종료 결과 `RESULT_OK` assertion에서 1건 실패했다. 재생성 인스턴스의 결과는 `RESULT_CANCELED`였으며 production 코드는 수정하지 않았다. 직접 취소·tracking 자식 취소와 서버 `CANCELED` 조회의 recreate 양성/음성 assertion도 같은 RED test에 추가했다. GREEN 완료. 같은 명령은 27초 후 `BUILD SUCCESSFUL`로 종료했고 navigation 11개, detail 15개, cancel 12개, 총 38개 test가 failures/errors/skipped=0으로 통과했다. `GiftDetailActivity`는 `hasChanged` Boolean과 `STATE_CHANGED` key만 Bundle에 저장하며 DTO·주소·전화번호·취소 응답을 저장하지 않는다. 재생성 후 GET과 취소 mutation counter가 반복되지 않는 assertion도 통과했다. 전체 Gate는 미실행이다. + +**최종 검증 추가:** quality 재검토 PASS와 `P5-R4` 이후 전체 직렬 Gate PASS를 확보해 `REV-P5-002` 수정·검증을 완료했다. 일반 상세 무변경 음성 경로는 아래 `P5-R4`로 별도 보강했으며, 저장 상태는 변경 여부 Boolean만 추가했다. + +### Task 5.R4 변경 없는 일반 상세 재생성 음성 회귀 검증 + +**Goal 실행 `P5-R4`:** Low 확정 항목 `REV-P5-004`를 해소해 mutation 없는 일반 상세의 recreate/back이 성공 결과나 추가 요청을 만들지 않음을 독립 검증한다. + +- **시작 조건:** `P5-R3` focused GREEN 이후 context 재검토에서 일반 상세 음성 테스트 누락 확정. 기존 완료 체크박스와 CANCELED 조회 음성 테스트는 그대로 보존한다. +- **대상 파일:** Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt`. +- **수정 범위:** mutation 없는 일반 상세 진입 → `ActivityController.recreate()` → back 종료의 local Robolectric 테스트만 추가한다. production 코드는 변경하지 않는다. +- **회귀 테스트:** 서버 `CANCELED` 조회가 아닌 일반 상세에서 tracking/cancel 성공 결과를 전달하지 않는다. recreate 후 back 결과는 `RESULT_CANCELED`이고 최초 GET 이후 추가 GET은 0회, tracking/cancel mutation은 각각 0회임을 검증한다. +- **TDD 예외 사유:** 이미 정상인 동작의 누락된 음성 검증을 추가하는 test-only Task다. RED는 테스트 누락 확인이며 인위적인 production 결함이나 실패를 만들지 않는다. 추가 테스트의 첫 실행부터 PASS가 예상된다. 예상 밖 실패는 원인 확인과 별도 수정 범위 등록 없이 production 수정으로 확대하지 않는다. +- **완료 증거:** 누락 확인 → 테스트 추가 → 아래 focused 명령 PASS와 XML failures/errors/skipped=0 → Task 5.1 전체 Gate 직렬 재실행 → context 재검토 결과 누적. +- **범위 밖:** production 변경, 개인정보 저장, 레이아웃 속성 검증, 기기·에뮬레이터 조작. + +- [x] **누락 확인:** 일반 상세 무변경 경로가 기존 CANCELED 조회 음성 경로와 별도로 검증되지 않았음을 확인한다. +- [x] **테스트 추가:** recreate/back 후 `RESULT_CANCELED`, 추가 GET 0회, tracking/cancel mutation 0회를 검증한다. +- [x] **focused 검증:** 아래 명령과 XML 결과를 Task 검증 기록에 남긴다. +- [x] **전체 Gate·재검토:** 다른 Gradle 실행이 끝난 뒤 Task 5.1 전체 Gate를 직렬 실행하고 context 재검토로 `REV-P5-004` 해소를 확인한다. 이후에만 완료 판정한다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun +``` + +**Task 검증 기록:** test-only 보강 완료. `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun`은 `BUILD SUCCESSFUL in 33s`로 종료했다. 일반 상세 무변경 recreate/back의 `RESULT_CANCELED`, 추가 GET 0회, tracking/cancel mutation 0회 assertion을 추가했으며 production 코드는 변경하지 않았다. 전체 Gate와 context 재검토는 대기다. + +**최종 검증 추가:** focused navigation은 12개, failures/errors/skipped=0이다. 이후 직렬 Gate PASS와 R4·문서 범위 보강 후 context PASS를 확보해 `REV-P5-004` 수정·검증을 완료했다. + +### Task 5.D2 검증 후 최종 종료 문서 정합성 갱신 + +**Goal 실행 `P5-D2`:** Low 확정 항목 `REV-P5-003`을 해소해 오래된 Phase 요약과 누락된 최종 종료 기록을 실제 검증 결과에 연결한다. + +- **시작 조건:** `P5-R2`, `P5-R3`, `P5-R4`의 focused 검증, 수정 후 전체 `P5-GATE` 직렬 재실행, 확정 항목 재검토 결과 확보. security INCONCLUSIVE는 해소 근거 없이 PASS로 바꾸지 않는다. 이 문서 등록 단계에서는 종료 문서를 완료 처리하지 않는다. +- **대상 파일:** Modify: `docs/20261002_선물_상세와_운송장_등록/plan-task.md`; Modify: `docs/20261002_선물_상세와_운송장_등록/prd.md`; Modify: `docs/20261002_선물_상세와_운송장_등록/reviews/phase5-final-regression-review.md`; Modify: `docs/agent-guides/build-test-style.md`. +- **수정 범위:** 현재 상태 요약, PRD 관련 review·성공 기준, P5-GATE 최종 판정, Progress/Verification Log 및 이번 리뷰의 수정 후 검증 기록을 증거에 따라 갱신한다. `REV-P5-003`의 context 재검토 보강으로 build guide에 `GiftNetworkPrivacyTest`, `GiftNavigationTest`, gift/modal focused suite 실행 예시를 추가한다. Phase 1~4의 완료 Task·과거 실행 기록과 기존 리뷰 보고서는 보존한다. +- **RED/GREEN 확인:** 문서 Task이므로 신규 자동 테스트는 작성하지 않는다. RED는 Phase 4 요약의 `2/3`과 완료된 P4-T3 기록 불일치, PRD 관련 review `없음`, 최종 리뷰·종료 증거 누락을 대조하는 것으로 대신한다. GREEN은 모든 확정 review ID가 Task·실제 검증·종료 판정에 연결되는 문서 대조다. +- **focused 검증:** 위 네 문서의 상태·체크박스·review ID·검증 수치가 수정 후 증거와 일치하고 원래 lane 결과가 보존되었는지 읽어 확인한다. build guide의 세 실행 예시는 아래 명령과 대조한다. +- **전체 Gate 의존성/완료 증거:** 수정 후 전체 Gate 명령·결과와 security/quality 재검토 근거를 먼저 확보하고 문서를 갱신한다. 확인된 snapshot diff check와 네 문서 읽기 대조를 근거로 종료 상태를 반영한 뒤, 편집 이후 `tasks --all`·diff check도 별도로 실행한다. + +- [x] **RED 확인:** 오래된 요약과 누락된 종료 기록을 실제 Task·PRD·리뷰 근거와 대조한다. +- [x] **선행 검증:** `P5-R2`, `P5-R3`, `P5-R4` 및 전체 `P5-GATE`의 직렬 재실행 결과와 확정 항목 재검토 근거를 확보한다. +- [x] **build guide 보강:** `docs/agent-guides/build-test-style.md`에 아래 privacy, navigation, gift/modal focused 실행 예시를 추가하고 실제 검증 명령과 일치하는지 확인한다. +- [x] **GREEN:** 확인된 항목에 한해서만 최종 문서와 PRD 성공 기준을 갱신하고 과거 이력은 그대로 둔다. +- [x] **GREEN 확인:** 네 문서를 focused 대조하고 최종 snapshot과 문서 편집 이후의 검증 결과를 Verification Log에 누적해 context의 두 누락 해소 및 Phase 5 종료를 기록한다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftNetworkPrivacyTest" --rerun +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --tests "kr.co.vividnext.sodalive.v2.components.modal.*" --rerun +``` + +**Task 검증 기록:** 문서 불일치 근거와 후속 Task만 등록했다. 최종 종료 정리와 PRD 성공 체크박스 갱신은 아직 수행하지 않았다. + +**최종 검증 추가:** 위 기록은 최초 등록 당시 이력이다. `P5-D2`에서 지정된 PRD·계획·Phase 5 리뷰·build guide 네 문서를 갱신했다. Phase별 완료 수, review 링크, 성공 기준, 네 finding의 수정·검증 상태와 focused 명령 세 개를 최종 증거에 맞췄다. 전달된 snapshot의 `GIT_MASTER=1 git diff --check HEAD`는 출력 없이 exit 0이었다. 문서 담당은 Read/apply_patch만 사용했으며 이번 편집 이후의 명령 실행 결과를 새로 주장하지 않는다. + +--- + +## Phase 6: Figma UI 재구현 + +**Phase 결과:** 신청 완료·운송장 등록·등록 후 상세·전달 완료·전달 불가·취소 완료가 Figma의 콘텐츠 계층과 상태 노출 규칙을 사용하고, 운송장 번호가 ASCII 숫자 10~14자리일 때만 제출된다. + +**선행조건:** 승인된 PRD `DEC-013`~`DEC-016`. + +### Task 6.1 상세·취소 완료 presentation과 행 카드 + +**Goal 실행 `P6-T1`:** API 정상 상태 5개를 보존하면서 Figma 4구간 progress와 상태별 section/행 카드를 렌더링한다. + +**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/main/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailActivity.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftStatusTimelineAdapter.kt` +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftInfoRows.kt` +- Modify: `app/src/main/res/layout/activity_gift_detail.xml` +- Modify: `app/src/main/res/layout/include_gift_canceled_completion.xml` +- Modify: `app/src/main/res/layout/item_gift_status_timeline.xml` +- Create: `app/src/main/res/layout/item_gift_info_row.xml` +- Modify: `app/src/main/res/values/strings.xml`, `values-en/strings.xml`, `values-ja/strings.xml` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftDetailPresenterTest.kt` + +**Interfaces:** + +- `GiftDetailUiModel.timeline`은 기존 5개 API 이력을 유지한다. +- `progressSegments`는 `신청 접수`, `발송 확인`, `사서함 도착`, `전달 완료` 4개만 제공한다. +- `INSPECTION_COMPLETED`는 별도 구간 없이 `사서함 도착` 완료에 반영하되 도착일이 있으면 도착일을 우선하고 검수일은 정보 카드에 별도 표시한다. +- `showProgress`는 `TRACKING_REGISTERED`, `ARRIVED_AT_MAILBOX`, `INSPECTION_COMPLETED`, `DELIVERED`에서만 true다. +- 취소 presentation은 실제 수신 크리에이터 닉네임, 신청번호, 신청일, 취소일, 환불 캔을 제공한다. +- `GiftInfoRows.bind(container, rows, labelWidth)`는 feature 내부에서 일반 84dp·주소 72dp 행을 렌더링하고 null 값 행은 추가하지 않는다. + +- [x] **RED:** `GiftDetailPresenterTest`에 5개 API 이력 보존과 4구간 projection, 도착일 우선/검수일 fallback, `RECEIVED/CANCELED/UNDELIVERABLE` progress 비노출, 동적 취소 본문 인자와 7행 데이터, nullable 날짜 행을 검증하는 테스트를 추가한다. +- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailPresenterTest" --rerun`을 실행해 신규 model/segment assertion이 기존 구현에서 실패하는지 확인한다. +- [x] **GREEN:** 기존 API/Activity를 유지하며 presenter/model, 좌측 정렬 상태 section, 4열 progress, 행 카드, 취소 완료 section을 최소 구현한다. `RECEIVED/CANCELED/UNDELIVERABLE`에서는 선물 아이콘과 progress를 숨긴다. +- [x] **GREEN 확인:** 같은 presenter test와 아래 상세 회귀·resource/compile 명령을 직렬 실행한다. +- [x] **REFACTOR:** 이번 변경으로 불필요해진 multiline 카드 조합과 숫자형 timeline binding만 제거하고 focused test를 재실행한다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailPresenterTest" --rerun +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftCancelViewModelTest" --rerun +./gradlew :app:mergeDebugResources :app:compileDebugKotlin +``` + +**TDD 예외:** XML 크기·간격·visibility 자체를 테스트하지 않는다. Figma design context와 XML source 대조, resource merge, Kotlin compile로 확인한다. + +**P6-T1 검증 기록 (2026-10-02):** production/resource 수정 전에 접수 chip 기대값을 null로 바꾼 focused 실행에서 `GiftDetailPresenterTest.kt:52`의 `java.lang.AssertionError`, `12 tests completed, 1 failed`, `BUILD FAILED in 40s`를 확인했다. 이후 4구간 projection·진행 표시 정책·취소 본문/7행 테스트를 먼저 추가한 같은 명령은 신규 `progressSegments`, `showProgress`, `cancellationRows`, `CancellationBody`, `CanAmount` 부재로 `:app:compileDebugUnitTestKotlin FAILED`, `BUILD FAILED in 5s`였다. 그 뒤에만 production/resource를 수정했다. + +| P6-T1 직렬 GREEN 명령 | 실제 결과 | +|---|---| +| `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailPresenterTest" --rerun` | `BUILD SUCCESSFUL in 1m 51s`, 15 tests, failures/errors/skipped=0 | +| `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftCancelViewModelTest" --rerun` | `BUILD SUCCESSFUL in 15s`, navigation 12개·detail 15개·cancel 12개, 총 39 tests, failures/errors/skipped=0 | +| `./gradlew :app:mergeDebugResources :app:compileDebugKotlin` | `BUILD SUCCESSFUL in 1s`, 24 tasks up-to-date (위 focused 실행에서 변경 리소스·Kotlin 컴파일 수행) | + +승인 PRD 8~10장과 전달된 Figma 수치를 XML 소스와 대조했다. 기존 gray_900/radius_14 카드, 14dp 외측·카드 padding, 24dp section 간격, 12dp 행 간격, 84dp/72dp label 폭과 22sp/16sp/14sp typography를 적용했다. 정상 5개 이력은 유지하고 4열 진행은 도착일 우선·검수일 fallback을 사용한다. 취소 본문은 실제 수신 크리에이터와 최상위 신청번호를 쓰며 닉네임 누락 시 지역화된 일반 명칭을 사용한다. 취소 카드의 nullable 행만 제외하고 환불 0은 유지한다. multiline 정보/주소/취소 조합과 숫자형 timeline binding을 제거한 상태로 GREEN을 확인했다. API/DTO/ViewModel, 기존 취소 observer·Boolean 결과 복원·문의 route와 SENT 주소 필터는 유지했다. 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 실행하지 않았으며 렌더링/픽셀 일치를 주장하지 않는다. 기존 Gradle deprecated 및 범위 밖 Kotlin 경고는 남아 있다. P6-T2, 전체 Gate, ktlint/assemble은 이번 Task에서 실행하지 않았다. + +### Task 6.R1 상세 재조회 중 이전 운송장 CTA 노출 회귀 수정 + +**Goal 실행 `P6-R1`:** 확정 review 항목 `REV-P6-T1-001`을 수정해 상세 재조회 Loading/Error에서 이전 content의 운송장 CTA가 남지 않게 한다. + +- **시작 조건:** `P6-T1` 구현 완료, 명세 review APPROVED, quality review에서 `REV-P6-T1-001` 확정. +- **대상 파일:** 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`. +- **수정 범위:** `tracking`이 content 밖의 하단 action bar로 이동한 구조에 맞춰 비-content 상태에서 visibility를 초기화한다. +- **회귀 테스트:** tracking 가능한 content 표시 후 재조회 Loading과 Error에서 tracking CTA가 숨겨지고 route를 제공하지 않는지 local Robolectric test로 검증한다. +- **완료 증거:** 실패 재현 test RED → Activity render 최소 수정 GREEN → navigation/detail focused test → resource/Kotlin compile → review 재검토. +- **범위 밖:** ViewModel/API/DTO 변경, tracking validation, XML 구조 변경, 신규 dependency, 기기·에뮬레이터·스크린샷 QA. + +- [x] stale tracking CTA 회귀 test를 먼저 추가하고 기존 구현에서 의도한 visibility assertion 실패를 확인한다. +- [x] `render()`의 비-content 상태에서 하단 tracking CTA만 숨기는 최소 수정으로 test를 통과시킨다. +- [x] navigation/detail focused test와 resource/Kotlin compile을 실행한다. +- [x] 원 quality reviewer 재검토와 review·계획 문서 검증 기록을 완료한다. + +**P6-R1 검증 기록 (2026-10-02):** `GiftNavigationTest`에 tracking 가능한 content 표시 후 RESULT_OK 재조회가 지연되는 실제 Activity 경로를 추가했다. production 수정 전 단일 test는 Loading 시점 `GiftNavigationTest.kt:219`의 visibility assertion에서 1건 실패해 `BUILD FAILED in 15s`였고 root cause를 재현했다. `GiftDetailActivity.render()` 진입 시 content 밖 하단 tracking CTA를 숨기고 Content/Canceled의 기존 `bind()`가 허용 상태에서만 다시 표시하게 하는 한 줄 수정 후 동일 test는 `BUILD SUCCESSFUL in 22s`였다. navigation 13개·detail 15개·cancel 12개, 총 40개 회귀 test는 `BUILD SUCCESSFUL in 15s`, failures/errors/skipped=0이고 `:app:mergeDebugResources :app:compileDebugKotlin`은 `BUILD SUCCESSFUL in 1s`였다. 대상 코드·test·계획·review 문서 scoped `GIT_MASTER=1 git diff --check`는 출력 없이 exit 0이었다. 원 quality reviewer 재검토는 PASS, 필수 추가 수정 없음으로 `REV-P6-T1-001`을 수정 완료 처리했다. + +### Task 6.2 운송장 입력 계약과 화면 계층 + +**Goal 실행 `P6-T2`:** 운송장 화면을 Figma 계층으로 렌더링하고 동일한 ASCII 숫자 10~14자리 규칙으로 오류와 제출을 결정한다. + +**Files:** + +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingModels.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingPresenter.kt` +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingActivity.kt` +- Modify: `app/src/main/res/layout/activity_gift_tracking.xml` +- Modify: locale string files +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingPresenterTest.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftTrackingViewModelTest.kt` +- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt` +- Reuse: `app/src/main/res/layout/item_gift_info_row.xml`, `GiftInfoRows.kt` + +**Validation:** `Regex("[0-9]{10,14}")`를 단일 기준으로 사용한다. 빈 값은 오류를 숨기고 제출을 막으며, 1~9자리·15자리 이상·공백·하이픈·문자·전각/Arabic-Indic 숫자는 오류 및 제출 불가다. leading zero는 문자열 그대로 보존한다. XML은 `inputType="number"`, `digits="0123456789"`, `maxLength="14"`를 사용한다. + +- [x] **RED:** presenter test에 빈 값, 1·9·10·14·15자리, leading zero, 공백, 하이픈, 영문, 전각/Arabic-Indic 숫자, 택배사 미선택, 오류 해제 상태를 추가한다. +- [x] **RED:** ViewModel test에 각 invalid 입력의 POST 0회를 추가하고 기존 성공 fixture만 10~14자리 ASCII 숫자로 교체한다. +- [x] **RED 확인:** 아래 tracking focused 명령에서 기존 permissive validation 때문에 의도한 assertion 실패를 확인한다. +- [x] **GREEN:** 신청 요약·주소를 행 카드로 바꾸고, native input 제한·inline 오류·CTA 상태를 기존 listener와 submit guard에 연결한다. +- [x] **GREEN 확인:** tracking focused, navigation, resource/compile 명령을 직렬 실행해 invalid POST 0회와 valid 요청 원문 보존을 확인한다. +- [x] **REFACTOR:** 대체된 multiline summary/address와 중복 validation만 제거한다. + +```bash +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftTrackingPresenterTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftTrackingViewModelTest" --rerun +./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun +./gradlew :app:mergeDebugResources :app:compileDebugKotlin +``` + +**P6-T2 검증 기록 (2026-10-02):** production 수정 전에 위 tracking focused 명령을 실행해 `BUILD FAILED in 12s`, 23 tests 중 2 failures를 확인했다. JUnit XML에서 presenter 8 tests/1 failure, ViewModel 15 tests/1 failure, 양쪽 errors/skipped=0이었다. 실패는 각각 `GiftTrackingPresenterTest.kt:101`에서 `한진택배 / 1 expected:false but was:true`, `GiftTrackingViewModelTest.kt:132`에서 `1 expected:0 but was:1`로, 1자리 번호 허용과 잘못된 POST 호출을 직접 재현했다. 이어 오류 표시/해제 테스트를 먼저 추가한 동일 명령은 아직 없는 `hasTrackingNumberError` 참조로 `:app:compileDebugUnitTestKotlin FAILED`, `BUILD FAILED in 4s`였다. 그 뒤에만 production/resource를 수정했다. + +| P6-T2 최종 직렬 GREEN 명령 | 실제 결과 | +|---|---| +| `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftTrackingPresenterTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftTrackingViewModelTest" --rerun` | `BUILD SUCCESSFUL in 10s`, JUnit XML presenter 9개 + ViewModel 15개 = 24 tests, failures/errors/skipped=0 | +| `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun` | `BUILD SUCCESSFUL in 12s`, JUnit XML 13 tests, failures/errors/skipped=0 | +| `./gradlew :app:mergeDebugResources :app:compileDebugKotlin` | `BUILD SUCCESSFUL in 1s`, 24 tasks up-to-date. 최초 GREEN tracking 실행(`BUILD SUCCESSFUL in 1m 8s`)에서 변경 리소스와 Kotlin을 실제 재컴파일했다. | + +단일 `Regex("[0-9]{10,14}")`를 presenter CTA/오류 판단과 기존 ViewModel submit guard가 공유한다. 빈 값은 오류 없이 비활성이고 non-empty invalid는 오류이며, 10/14자리와 leading zero 원문 보존, 각 invalid의 POST 0회를 local unit으로 검증했다. 기존 조회/부적격/중복 제출 guard 테스트는 유효한 10~14자리 입력을 사용해 새 validation에 가려지지 않게 유지했다. `toRequest`는 trim 없이 원문만 전달한다. 모델·ViewModel 파일은 기존 구조로 충족되어 수정하지 않았다. + +변경 파일을 요구사항과 소스로 자체 대조했다. `GiftInfoRows`/`item_gift_info_row.xml`을 수정 없이 재사용해 일반 label 84dp·주소 72dp·value gap 12dp를 유지하고 multiline 조합을 제거했다. XML의 number/digits/maxLength=14, 기존 고정 header·section·안내·spinner·하단 action bar와 한국어/영어/일본어 오류 문자열을 확인했다. 기존 `bg_gift_send_input_error`(gray_900/radius_14/red_400)를 재사용하므로 신규 drawable은 없다. API/DTO/repository·취소·navigation·개인정보 규칙은 변경하지 않았다. LSP 진단 도구는 제공되지 않아 Kotlin compile 결과를 사용했다. 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 실행하지 않았으며 화면 픽셀 일치를 주장하지 않는다. 범위 밖 기존 Kotlin/Gradle deprecated 경고는 남아 있다. P6-GATE와 독립 review는 이 Task에 포함하지 않는다. + +P6-T2에서 변경한 presenter·Activity·layout·3개 locale·3개 test·본 계획 문서 10개 경로만 지정한 `GIT_MASTER=1 git diff --check -- <해당 10개 경로>`는 출력 없이 exit 0이었다. 커밋·stage·push·revert는 실행하지 않았다. + +**독립 검토·재검증 추가:** 독립 spec reviewer는 `GIFT-TRACKING-003/005`의 단일 regex, 경계값, POST 0회, native 입력 제한, inline 오류, 행 카드와 기존 흐름 보존을 확인해 APPROVED로 판정했다. 이후 독립 quality reviewer도 상태 전이·제출/취소 상호 차단·접근성·재생성·테스트 실효성을 검토해 필수 finding 없이 APPROVED로 판정했다. 부모 에이전트가 tracking focused 명령을 재실행해 presenter 9개와 ViewModel 15개, 총 24개가 `BUILD SUCCESSFUL in 9s`, failures/errors/skipped=0임을 JUnit XML에서 확인했다. navigation 13개도 `BUILD SUCCESSFUL in 13s`, failures/errors/skipped=0이었다. `:app:mergeDebugResources :app:compileDebugKotlin`은 `BUILD SUCCESSFUL in 1s`, scoped diff check는 출력 없이 exit 0이었다. 품질 reviewer의 운송장 Activity 재생성 test 제안은 확정 요구사항이 아닌 선택 사항이므로 범위에 추가하지 않았다. + +### Task 6.R2 Phase 6 Kotlin ktlint 회귀 수정 + +**Goal 실행 `P6-R2`:** 첫 `P6-GATE`에서 확인된 Phase 6 Kotlin source의 ktlint 서식 위반만 동작 변경 없이 수정한다. + +- **시작 조건:** P6-T1·P6-R1·P6-T2 완료, gift/modal 149개와 전체 unit 1416개 PASS, `:app:ktlintMainSourceSetCheck` 실패. +- **대상 파일:** production의 `GiftDetailActivity.kt`, `GiftDetailPresenter.kt`, `GiftTrackingActivity.kt`, `ui/GiftInfoRows.kt`; test의 `GiftDetailPresenterTest.kt`, `GiftNavigationTest.kt`, `GiftTrackingPresenterTest.kt`, `GiftTrackingViewModelTest.kt`. +- **수정 범위:** multiline argument/when braces/max line length 서식만 수정한다. +- **회귀 테스트:** production 동작은 변경하지 않으며 formatter 대상 diff와 compile/ktlint, 이후 전체 P6-GATE 재실행으로 확인한다. +- **완료 증거:** production 27개와 후속 test source 위반 최소 수정 → compile/ktlint PASS → P6-GATE 전체 직렬 재실행 → 검증 기록. +- **범위 밖:** 로직·XML·resource·test assertion 변경, lint 설정 변경, 범위 밖 경고 수정. + +- [x] ktlint report의 Phase 6 대상 production/test 8개 파일과 위반 종류를 확인한다. +- [x] 보고된 줄만 수동 서식 수정한다. +- [x] compile/ktlint와 scoped diff check를 실행한다. +- [x] P6-GATE 전체 명령을 처음부터 직렬 재실행한다. + +중간 검증 기록: production 4개 파일에서 시작해 `ktlintTestSourceSetCheck`가 추가로 보고한 test 4개 파일까지 대상 범위를 먼저 갱신한 뒤 multiline 서식만 수정했다. 2026-10-02 `./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck`는 `BUILD SUCCESSFUL`(31 actionable tasks: 4 executed, 27 up-to-date), 대상 8개 파일의 `GIT_MASTER=1 git diff --check -- `는 무출력(exit 0)으로 통과했다. 기존 `.editorconfig`의 `disabled_rules` deprecation 경고는 본 Task 범위 밖이며 실패가 아니다. + +완료 검증 기록: 아래 `P6-GATE` 5개 명령을 처음부터 직렬 재실행해 focused 149개와 전체 1,416개 tests, resource/compile/ktlint, assembleDebug, 전체 diff check가 모두 통과했다. 따라서 동작·assertion 변경 없이 서식만 수정한 `P6-R2`를 완료한다. + +### Task 6.3 통합 Gate + +**Goal 실행 `P6-GATE`:** Phase 6과 기존 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`를 실행한다. + +```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 +``` + +검증 기록: 2026-10-02 위 명령을 병렬 실행하지 않고 순서대로 재실행했다. focused suite는 `BUILD SUCCESSFUL in 25s`, JUnit XML 15개에서 149 tests, failures/errors/skipped=0이었다. 전체 local unit suite는 `BUILD SUCCESSFUL in 1m 3s`, JUnit XML 188개에서 1,416 tests, failures/errors/skipped=0이었다. resource merge·Kotlin compile·ktlint는 `BUILD SUCCESSFUL in 1s`, `assembleDebug`는 `BUILD SUCCESSFUL in 43s`, `GIT_MASTER=1 git diff --check HEAD`는 무출력(exit 0)이었다. Gradle 및 기존 ktlint 설정의 deprecation 경고는 실패가 아니며 본 작업 범위에서 수정하지 않았다. + +### Task 6.R3 stale tracking CTA 테스트 정책 회귀 수정 + +**Goal 실행 `P6-R3`:** 확정 review 항목 `REV-P6-REVIEW-001`을 수정해 stale tracking CTA 회귀를 View 속성 직접 assertion 없이 허용된 presentation 결정 로직으로 검증한다. + +- **시작 조건:** `P6-GATE` PASS, 최종 context review에서 `GiftNavigationTest`의 `tracking.visibility` 직접 assertion이 저장소 테스트 정책 위반으로 확정. +- **대상 파일:** `GiftDetailActivity.kt`, `GiftDetailPresenterTest.kt`, `GiftNavigationTest.kt`, `plan-task.md`, `reviews/phase6-gift-ui-contract-review.md`. +- **수정 범위:** 기존 비-content CTA 초기화 동작은 보존하고, 상태별 tracking action 노출을 순수 presentation 결정으로 추출해 Activity와 local unit test가 공유한다. +- **회귀 테스트:** 신규 presentation 결정 test를 production 함수 부재로 RED 확인한 뒤 Loading/Error/Canceled=false, 허용 Content=true를 GREEN으로 검증한다. 금지된 View 크기·간격·constraint·visibility assertion은 제거한다. +- **완료 증거:** RED → 최소 production 연결 GREEN → navigation/detail focused test → P6-GATE 전체 직렬 재실행 → 독립 재검토와 문서 기록. +- **범위 밖:** ViewModel/API/DTO/XML/resource 변경, stale CTA production 동작 변경, 신규 dependency, 기기·에뮬레이터·androidTest·시각 QA. + +- [x] `GiftDetailPresenterTest`에 상태별 tracking action presentation test를 추가하고 함수 부재 RED를 확인한다. +- [x] 최소 순수 결정 함수와 Activity 연결을 추가하고 `GiftNavigationTest`의 visibility assertion을 제거한다. +- [x] focused test와 전체 P6-GATE를 직렬 재실행한다. +- [x] 원 context finding과 security lane을 재검토하고 review·PRD·계획 문서를 종료한다. + +중간 검증 기록: test 변경 후 첫 실행은 신규 함수 부재 외에 기존 dialog test가 사용하는 `View` import 제거로 컴파일 오류가 섞여 해당 import만 복원했다. 다시 실행한 RED는 `GiftDetailPresenterTest.kt:230~233`의 `showsTrackingAction` 미정의만으로 `BUILD FAILED in 5s`였다. 최소 순수 결정 함수와 Activity 연결 후 presenter test는 `BUILD SUCCESSFUL in 16s`, navigation/detail/cancel 39개는 `BUILD SUCCESSFUL in 14s`였고 `tracking.visibility` 검색은 결과 0건이었다. 이후 전체 Gate를 직렬 재실행해 focused 149개(`BUILD SUCCESSFUL in 18s`)와 전체 1,416개(`BUILD SUCCESSFUL in 1m 16s`)가 failures/errors/skipped=0, resource/compile/ktlint는 `BUILD SUCCESSFUL in 6s`, assembleDebug는 `BUILD SUCCESSFUL in 5s`, 전체 diff check는 무출력(exit 0)이었다. + +### Task 6.4 리뷰와 문서 종료 + +**Goal 실행 `P6-REVIEW`:** 최신 diff와 Gate 증거를 독립 검토하고 Phase 6 완료 근거를 누적한다. + +- [x] `docs/sample/sample-review.md` 형식으로 `reviews/phase6-gift-ui-contract-review.md`를 작성한다. +- [x] 요구사항·코드 품질·보안·실행 QA·기존 맥락 검토를 통과한다. +- [x] 확정 finding은 기존 Task를 다시 열지 않고 `P6-R*` 회귀 수정 Task를 먼저 추가한 뒤 수정한다. +- [x] 승인 후 PRD 14.4, Phase 6 상태, Progress, Verification Log만 실제 증거로 갱신한다. + +최종 리뷰 기록: goal PASS, 실행 QA PASS, quality PASS, 직접 단일 Oracle security PASS, context는 `REV-P6-REVIEW-001` 확정 후 `P6-R3` 수정·재검토 PASS다. security 최초 lane은 Team Mode 의존 skill의 실행 제약으로 INCONCLUSIVE였으며 코드 실패가 아니었다. 이후 같은 범위를 실제 소스·diff로 검사한 직접 security lane이 High/Critical finding 0건으로 PASS했다. 5개 review 영역에 남은 차단 항목은 없다. + +**수동 검증 제한:** 저장소 규칙과 승인된 Non-Goal에 따라 기기·에뮬레이터·`androidTest`·스크린샷·시각 QA는 실행하지 않는다. 완료 증거는 Figma design context/XML source 대조와 local unit/resource/compile/lint/build다. + +## 실행 순서와 의존성 + +| 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 | +|---:|---|---|---|---| +| 1 | `P1-T1` | PRD | 아니요 | API 계약 재대조 | +| 2 | `P1-T2` | `P1-T1` | 아니요 | fake/API signature 일치 확인 | +| 3 | `P1-GATE` | Phase 1 Task | 아니요 | 실패 소유 Task 수정 | +| 4 | `P2-T1` | `P1-GATE` | 아니요 | 상태·privacy 표 재대조 | +| 5 | `P2-T2` | `P2-T1` | 아니요 | 상세 state 계약 확인 | +| 6 | `P2-T3` | `P2-T2` | 아니요 | 목록 기존 회귀 확인 | +| 7 | `P2-GATE` | Phase 2 Task | 아니요 | 실패 소유 Task 수정 | +| 8 | `P3-T1` | `P2-GATE` | 아니요 | courier/form 계약 확인 | +| 9 | `P3-T2` | `P3-T1` | 아니요 | request/state 확인 | +| 10 | `P3-T3` | `P3-T2` | 아니요 | result routing 확인 | +| 11 | `P3-GATE` | Phase 3 Task | 아니요 | 실패 소유 Task 수정 | +| 12 | `P4-T1` | PRD `DEC-007` | `P3`와 파일 비중복 시 가능 | modal 기본 회귀 우선 복구 | +| 13 | `P4-T2` | `P1-GATE` | `P3`와 파일 비중복 시 가능 | cancel eligibility 확인 | +| 14 | `P4-T3` | `P3-GATE`, `P4-T1`, `P4-T2` | 아니요 | Activity result 흐름 대조 | +| 15 | `P4-R2` | `P4-T3`, `REV-P4-T3-001` | 아니요 | pending 취소 결과 수명주기 확인 | +| 16 | `P4-GATE` | Phase 4 Task | 아니요 | 실패 소유 Task 수정 | +| 17 | `P5-GATE` | 모든 Gate | 아니요 | 회귀 수정 Task 추가 | +| 18 | `P5-R1` | P5-GATE lint 실패 시 | 아니요 | test 서식만 수정 후 P5-GATE 재실행 | +| 19 | `P5-R2` | `REV-P5-001`, 사용자 레거시 예외 승인 | 아니요 | Gift DI 경로와 로그 차단 RED 재확인 | +| 20 | `P5-R3` | `REV-P5-002`, `P5-R2` focused 검증 | 아니요 | 실제 Activity recreate 결과 대조 | +| 21 | `P5-R4` | `REV-P5-004`, `P5-R3` focused 검증 | 아니요 | test-only 범위에서 일반 상세 음성 계약 확인 | +| 22 | `P5-GATE` 재검증 | `P5-R2`, `P5-R3`, `P5-R4` focused 검증 | 아니요 | XML 쓰기 충돌을 피하도록 직렬 재실행 | +| 23 | `P5-D2` | 수정 후 전체 Gate와 확정 항목 재검토 | 아니요 | 완료 판정 없이 실제 차단 사유 기록 | +| 24 | `P6-T1` | 승인된 PRD `DEC-013`~`DEC-016` | 아니요 | presenter contract와 Figma section 재대조 | +| 25 | `P6-T2` | `P6-T1` 공통 행 resource | 아니요 | 입력 경계와 submit guard 재대조 | +| 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*` 등록 후 재검증 | + +```text +P1-T1 → P1-T2 → P1-GATE + → P2-T1 → P2-T2 → P2-T3 → P2-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 +``` + +## 변경 금지 항목 + +- SENT 화면 또는 UI model에 `recipientAddress`를 노출하지 않는다. +- `mailbox`를 상대방 주소로 표현하지 않는다. +- API 정상 상태 5개를 삭제·축약하지 않는다. 화면 projection만 승인된 4구간으로 표시한다. +- tracking 수정 endpoint·화면, 택배사 API, 리뷰/정책 route를 만들지 않는다. +- 기존 `V2ModalDialog` 호출의 기본 자동 닫힘을 변경하지 않는다. +- 레거시 파일을 직접 수정하지 않는다. +- **승인된 예외 `PLAN-DEC-005`:** `P5-R2`에서만 레거시 `AppDI.kt`의 named Gift client/Retrofit 추가와 `GiftApi` 연결 변경을 허용한다. 공유 debug BODY/release NONE과 다른 API 설정은 유지한다. +- test를 삭제·skip·완화하거나 타입 오류를 우회하지 않는다. +- token·실제 주소·전화번호를 log·fixture·문서에 기록하지 않는다. + +## 의사결정 및 중단 규칙 + +- PRD와 API 응답이 충돌하면 API 계약을 우선하고 Decision Log를 먼저 갱신한다. +- Figma와 API 상태 개수가 충돌하면 5개 API 상태를 우선한다. +- 신규 공통 component나 dependency가 필요해 보이면 구현을 중단하고 사용자 확인을 받는다. +- 범위 변경은 이 문서 체크박스·Files·Interfaces를 먼저 갱신한다. +- 완료 Task의 체크박스와 검증 기록을 되돌리거나 삭제하지 않는다. 리뷰 후 수정은 신규 회귀 Task로 추가한다. + +## Progress + +실제 구현을 시작하면 Goal별 실행 결과를 아래 형식으로 누적한다. + +### P1-T1 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 상세·주소·delivery·timeline·tracking·cancel DTO와 Gson 계약 테스트 3개를 추가했다. +- 왜: 후속 repository와 presentation 계층이 사용할 API 경계를 PRD 11.2~11.4와 동일하게 고정하기 위해서다. +- 어떻게: + - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftRepositoryTest"` — RED, `GiftDetailResponse`, `GiftTrackingRequest`, `GiftCancelResponse` 부재의 compile 실패를 확인했다. + - 같은 focused test — GREEN, `BUILD SUCCESSFUL`, 3 tests, failures 0, errors 0, skipped 0. + - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftRepositoryTest" --rerun` — 독립 검증 `BUILD SUCCESSFUL`, test task 1 executed. + - 대상 두 파일 `git diff --check` — exit 0. +- 남은 항목: 없음 +- 다음 행동: `P1-T2`에서 Retrofit endpoint와 repository 전달 계약을 TDD로 추가한다. + +### P1-T2 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 상세 GET, 운송장 등록 POST, 신청 취소 POST와 repository 무변환 전달, 기존 `GiftApi` fake 호환을 추가했다. +- 왜: 상세·tracking·cancel ViewModel이 사용할 인증·path·body 계약을 기존 data 계층에 고정하기 위해서다. +- 어떻게: + - focused repository test — RED, `getGiftDetail`, `registerGiftTracking`, `cancelGift` 미정의 및 override 부재 compile 실패를 확인했다. + - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftRepositoryTest" --rerun` — `BUILD SUCCESSFUL`, 6 tests, failures 0, errors 0, skipped 0. + - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestViewModelTest" --rerun` — `BUILD SUCCESSFUL`, 17 tests, failures 0, errors 0, skipped 0. + - 대상 다섯 파일 `git diff --check`와 untracked repository test 별도 check — exit 0. +- 남은 항목: 없음 +- 다음 행동: `P1-GATE` 명령을 독립 실행해 data 계층 전체를 검증한다. + +### P1-GATE 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: DTO/repository focused test와 기존 gift API fake 회귀를 독립 재실행했다. +- 왜: Phase 2가 의존하는 data 계층 계약을 완료 상태로 고정하기 위해서다. +- 어떻게: + - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftRepositoryTest" --rerun` — `BUILD SUCCESSFUL`, 6 tests, failures 0, errors 0, skipped 0. + - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftSendRequestViewModelTest" --rerun` — `BUILD SUCCESSFUL`, 17 tests, failures 0, errors 0, skipped 0. +- 남은 항목: 없음 +- 다음 행동: `P2-T1` 상세 presenter와 개인정보·날짜 정책을 TDD로 구현한다. + +### P2-T1 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 7개 hero, 정상 5단계 timeline, 방향별 개인정보, nullable 정보, UTC 날짜, action, 전달 불가와 취소 완료 presentation 계약을 추가했다. +- 왜: Activity가 DTO를 직접 해석하지 않고 개인정보와 상태 정책이 검증된 UI model만 bind하도록 하기 위해서다. +- 어떻게: + - focused presenter test — RED, 신규 `GiftDetailHero`/`GiftDetailPresenter` 부재 compile 실패를 확인했다. + - tracking action 계약 보강 — RED, `UNDELIVERABLE SENT trackingRequired=true expected true but was false`를 확인한 뒤 알려진 7개 상태로 최소 수정했다. + - 다국어 계약 보강 — RED, `GiftDetailText`/`Key` 부재 compile 실패를 확인한 뒤 앱 고정 문구 key와 서버 raw 문구를 분리했다. + - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailPresenterTest" --rerun` — `BUILD SUCCESSFUL`, 12 tests, failures 0, errors 0, skipped 0. + - 대상 세 파일 scoped/untracked diff check — exit 0. +- 남은 항목: 실제 한국어·영어·일본어 key→resource 매핑은 `P2-T2`에서 검증한다. +- 다음 행동: `P2-T2` 상세 ViewModel·Activity·layout·resource를 연결한다. + +### P2-T2 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 상세 ViewModel, Activity, 5단계 adapter/layout, 취소 완료 include, Koin/manifest, 한국어·영어·일본어 리소스를 연결했다. +- 왜: 신청번호 상세 조회를 상태별 화면과 안전한 개인정보 표시로 제공하기 위해서다. +- 어떻게: + - focused ViewModel test — RED, `GiftDetailViewModel`/`GiftDetailUiState` 부재 compile 실패를 확인했다. + - locale resolver test — RED, `resolveGiftDetailText` 부재 실패를 확인했다. + - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailPresenterTest" --rerun` — 23 tests, failures 0, errors 0, skipped 0. + - `./gradlew :app:mergeDebugResources :app:compileDebugKotlin --rerun` 및 resource merge 별도 재실행 — exit 0. + - P2-T2 12개 경로 scoped `git diff --check` — exit 0. +- 남은 항목: tracking/cancel 동작은 각각 Phase 3/4 범위다. +- 다음 행동: `P2-T3` 목록 카드 상세 navigation과 RESULT_OK refresh를 연결한다. + +### P2-T3 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 카드·주소 배너의 one-shot 상세 이동과 RESULT_OK 전용 목록 refresh를 연결했다. +- 왜: 기존 상태 toast를 실제 상세 진입으로 교체하고 mutation 이후 목록을 안전하게 갱신하기 위해서다. +- 어떻게: + - focused test — RED, 기존 toast로 인해 `GiftInboxViewModelTest.kt:185` assertion 실패, 23 tests 중 1 failed를 확인했다. + - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailViewModelTest" --rerun` — 25 tests, failures 0, errors 0, skipped 0. + - 대상 네 파일 scoped diff check — exit 0. +- 남은 항목: 없음 +- 다음 행동: `P2-GATE`를 실행한다. + +### P2-GATE 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 상세 presentation/ViewModel/navigation 회귀와 resource/Kotlin compile을 독립 재실행했다. +- 왜: tracking 구현 전에 상세 흐름과 개인정보 정책을 완료 상태로 고정하기 위해서다. +- 어떻게: + - `GiftDetailPresenterTest` — 12 tests, failures 0, errors 0, skipped 0. + - `GiftDetailViewModelTest` — 11 tests, failures 0, errors 0, skipped 0. + - `GiftInboxViewModelTest` + `GiftNavigationTest` — 14 tests, failures 0, errors 0, skipped 0. + - `./gradlew :app:mergeDebugResources :app:compileDebugKotlin --rerun` — `BUILD SUCCESSFUL`. +- 남은 항목: 없음 +- 다음 행동: `P3-T1` tracking form presenter와 14개 택배사를 구현한다. + +### P3-T1 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 14개 로컬 택배사, tracking eligibility·신청 요약·mailbox·입력 validation·request 변환을 순수 presenter로 구현했다. +- 왜: ViewModel과 Activity가 API 코드나 임의 validation 없이 검증된 form 계약을 재사용하도록 하기 위해서다. +- 어떻게: + - focused test RED — `:app:compileDebugUnitTestKotlin FAILED`, `giftCourierCompanyNames`, `GiftTrackingPresenter`, `GiftTrackingUiModel` unresolved reference와 `BUILD FAILED in 4s`를 확인했다. + - focused test GREEN — 8 tests, failures 0, errors 0, skipped 0. + - 독립 spec review — APPROVED. 독립 quality review — CONFIRMED, 필수·선택 수정 없음. + - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftTrackingPresenterTest"` 독립 재실행 — `BUILD SUCCESSFUL in 29s`. +- 남은 항목: 없음 +- 다음 행동: `P3-T2` tracking ViewModel을 구현한다. + +### P3-T2 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 상세 최초 조회, eligibility 종료, tracking 제출 validation·중복 방지·오류 복구·one-shot 성공 event를 ViewModel에 구현했다. +- 왜: Activity가 입력만 소유하고 API 상태와 mutation lifecycle은 기존 Rx/ViewModel 패턴으로 관리하기 위해서다. +- 어떻게: + - focused test RED — `GiftTrackingViewModel`/`GiftTrackingUiState` unresolved reference, `:app:compileDebugUnitTestKotlin FAILED`, `BUILD FAILED in 16s`를 확인했다. + - focused presenter/ViewModel GREEN — 20 tests, failures 0, errors 0, skipped 0, `BUILD SUCCESSFUL in 33s`. + - 독립 spec review — APPROVED. 독립 quality review — CONFIRMED, 필수 수정 없음. + - 동일 focused suite `--rerun` 독립 재실행 — `BUILD SUCCESSFUL in 10s`. +- 남은 항목: 없음 +- 다음 행동: `P3-T3` tracking Activity·layout과 상세 reload를 연결한다. + +### P3-T3 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: tracking Activity/layout, 14개 택배사 입력, 성공 RESULT_OK, 상세 재조회, DI/manifest/KR·EN·JA 리소스를 연결했다. +- 왜: 등록 가능한 보낸 신청이 사서함을 확인하고 운송장을 한 번 제출한 뒤 갱신된 상세를 보게 하기 위해서다. +- 어떻게: + - navigation test RED — `GiftTrackingActivity` unresolved reference, `compileDebugUnitTestKotlin FAILED`, `BUILD FAILED in 6s`. + - 최종 focused suite — navigation 8, presenter 8, tracking ViewModel 12, detail ViewModel 11, 총 39 tests, failures/errors/skipped 0. + - resource merge와 Kotlin compile — `BUILD SUCCESSFUL`. + - spec review — APPROVED. quality review에서 `REV-P3-T3-001` 1건을 확정하고 `P3-R1`로 전환했다. +- 남은 항목: 없음 +- 다음 행동: `P3-R1` Toast 중복 노출 회귀를 수정한다. + +### P3-R1 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 실패 Toast를 소비 후 제거하고 Activity가 소비된 값만 표시하도록 수정했다. +- 왜: Activity 재생성 시 이전 등록 실패 Toast가 다시 표시되는 `REV-P3-T3-001`을 방지하기 위해서다. +- 어떻게: + - 회귀 test RED — `consumeToast` unresolved reference, `compileDebugUnitTestKotlin FAILED`, `BUILD FAILED in 11s`. + - focused ViewModel test — 13 tests, failures/errors/skipped 0. + - Phase 3 focused suite 독립 재실행 — navigation 8, presenter 8, tracking ViewModel 13, detail ViewModel 11, 총 40 tests, failures/errors/skipped 0, `BUILD SUCCESSFUL in 1m 21s`. + - `./gradlew :app:mergeDebugResources :app:compileDebugKotlin --rerun` — `BUILD SUCCESSFUL in 52s`. + - 원 quality reviewer 재검토 — CONFIRMED, 추가 수정 없음. +- 남은 항목: 없음 +- 다음 행동: `P4-T1` V2ModalDialog 호환 확장을 구현한다. + +### P4-T1 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: `V2ModalDialog` 생성자 끝에 기본 true인 `dismissOnConfirm`과 public `dismiss()`를 추가했다. +- 왜: 기존 호출의 자동 닫힘·one-shot을 보존하면서 취소 API 실패 시 dialog를 유지하고 재시도할 수 있게 하기 위해서다. +- 어떻게: + - focused test RED — `dismissOnConfirm` parameter 2건과 `dismiss` unresolved reference, `compileDebugUnitTestKotlin FAILED`, `BUILD FAILED in 10s`. + - focused GREEN — 8 tests, failures 0, errors 0, skipped 0, `BUILD SUCCESSFUL in 28s`. + - 독립 재실행 — `BUILD SUCCESSFUL in 9s`. + - 독립 spec/quality review — APPROVED/CONFIRMED, 추가 수정 없음. +- 남은 항목: 없음 +- 다음 행동: `P4-T2` 공용 gift 취소 ViewModel을 구현한다. + +### P4-T2 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: SENT+RECEIVED eligibility, pending 중복 방지, 실패 복구·Toast 소비, `GiftCancelResponse` one-shot 성공 event를 공용 ViewModel에 구현하고 Koin에 등록했다. +- 왜: 상세와 tracking 화면의 취소 mutation을 한 곳에서 일관되게 관리하기 위해서다. +- 어떻게: + - focused test RED — `GiftCancelViewModel` unresolved reference, `compileDebugUnitTestKotlin FAILED`, `BUILD FAILED in 4s`. + - focused GREEN — 12 tests, failures 0, errors 0, skipped 0, production/test Kotlin compile 성공. + - spec/quality review에서 `REV-P4-T2-001` 테스트 공백을 확정하고 `P4-R1`로 전환했다. +- 남은 항목: 없음 +- 다음 행동: `P4-R1` 열린 dialog 나가기 계약을 독립 검증한다. + +### P4-R1 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 뒤로가기·나가기·확인을 각각 별도로 열린 dialog에서 검증하도록 기존 테스트를 보강했다. +- 왜: 열린 dialog의 나가기에서 API가 호출되지 않는 계약을 직접 증명하기 위해서다. +- 어떻게: + - focused cancel test와 production/test Kotlin compile 독립 재실행 — 12 tests, failures/errors/skipped 0, `BUILD SUCCESSFUL in 13s`. + - 원 reviewer 재검토 — APPROVED/CONFIRMED, 추가 수정 없음. +- 남은 항목: 없음 +- 다음 행동: `P4-T3` 상세·tracking 취소 dialog와 완료 상태를 연결한다. + +### P4-T3 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 상세·tracking 취소 dialog, 공용 결과 codec, 취소 완료 상세 반영과 tracking 종료 결과 전달을 연결했다. +- 왜: 두 화면이 같은 취소 mutation을 사용하고 실패 시 재시도·성공 시 목록 갱신까지 일관되게 수행하도록 하기 위해서다. +- 어떻게: + - tracking 원본 상세 RED — `loadedDetail` unresolved reference, `BUILD FAILED in 4s`. + - 상세 취소 적용 RED — `applyCancellation` unresolved reference, `BUILD FAILED in 3s`. + - dialog 연결 RED — navigation 22 tests 중 1 failed, `BUILD FAILED in 22s`. + - 최종 focused suite — modal 8, cancel 12, detail 13, navigation 9, tracking ViewModel 13, presenter 8의 총 63 tests, failures/errors/skipped 0, `BUILD SUCCESSFUL in 17s`. + - resource/Kotlin compile — `BUILD SUCCESSFUL in 40s`; 별도 resource merge — `BUILD SUCCESSFUL in 7s`. + - spec review — APPROVED. quality review에서 `REV-P4-T3-001` 1건을 확정하고 `P4-R2`로 전환했다. +- 남은 항목: 없음 +- 다음 행동: `P4-R2`에서 조회 중 취소 결과 유실을 수정한다. + +### P4-R2 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 현재 신청번호와 일치하는 취소 응답을 ViewModel에 보존하고 상세 조회 성공 시 우선 적용했다. +- 왜: Activity 재생성 후 최초 GET 중 tracking 취소 결과가 도착하면 결과가 유실되는 `REV-P4-T3-001`을 방지하기 위해서다. +- 어떻게: + - focused test RED — 15 tests 중 조회 중 적용과 실패 후 재시도 적용 2개가 실패했고 `BUILD FAILED in 23s`. + - focused test GREEN — 15 tests, failures/errors/skipped 0; 독립 재실행 `BUILD SUCCESSFUL in 17s`. + - Phase 4 Gate — modal 8, cancel 12, detail 15, navigation 9의 총 44 tests, failures/errors/skipped 0, `BUILD SUCCESSFUL in 21s`. + - `./gradlew :app:mergeDebugResources :app:compileDebugKotlin --rerun` — `BUILD SUCCESSFUL in 40s`. + - 대상 implementation/test scoped `git diff --check` — exit 0. 원 quality reviewer 재검토 — CONFIRMED. +- 남은 항목: 없음 +- 다음 행동: `P5-GATE` 전체 gift/modal 회귀와 build를 검증한다. + +### P5-R1 1차 실행 — 2026-10-02 +- 상태: 완료 +- 무엇을: 최종 Gate가 검출한 gift production/test 10개 파일의 ktlint 서식 위반 130건을 동작 변경 없이 정리했다. +- 왜: 전체 기능 검증은 통과했지만 test lint 104건과 main lint 26건으로 최종 Gate가 실패했기 때문이다. +- 어떻게: + - 첫 compile/ktlint Gate — `ktlintTestSourceSetCheck`가 6개 test 파일의 104건으로 `BUILD FAILED in 6s`. + - `ktlintTestSourceSetFormat` — `BUILD FAILED in 6s`; 대상 6개 파일 SHA-1 전후 동일로 부분 수정 없음 확인. + - test 파일 수동 서식 수정 후 test lint와 gift/modal focused test 성공. + - 후속 compile/ktlint Gate — test lint는 통과하고 4개 production 파일의 main lint 26건으로 `BUILD FAILED in 2s`. + - production 파일 수동 서식 수정 후 main lint와 gift/modal focused test 성공. + - 최종 재검증 — gift/modal suite `BUILD SUCCESSFUL in 22s`, 전체 local unit test `BUILD SUCCESSFUL in 1m 28s`, resource/Kotlin/ktlint `BUILD SUCCESSFUL in 3s`, assembleDebug `BUILD SUCCESSFUL in 56s`, `git diff --check HEAD` exit 0. +- 남은 항목: 없음 +- 다음 행동: 5개 독립 review lane 결과를 반영해 `P5-GATE`를 판정한다. + +### P5-R2 1차 실행 — 2026-10-02 +- 상태: 진행 중 +- 무엇을: 실제 `AppDI`를 기동하는 Gift 네트워크 privacy 회귀 test와 named Gift client/Retrofit 바인딩을 추가했다. +- 왜: 공유 debug BODY 정책은 유지하면서 Gift 요청·응답의 개인정보만 로그에서 차단하기 위해서다. +- 어떻게: + - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftNetworkPrivacyTest" --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftRepositoryTest" --rerun` — RED, `GiftNetworkPrivacyTest.kt:59`에서 GiftApi가 공유 debug BODY Retrofit과 동일하다는 assertion 실패를 확인했고 repository 6개는 통과했다. + - 같은 명령 — GREEN, `BUILD SUCCESSFUL in 20s`; privacy 1개와 repository 6개, 총 7개 test가 통과했다. +- 남은 항목: focused security 재검토, `P5-R3`, 수정 후 전체 `P5-GATE` 재실행. +- 다음 행동: `P5-R3`의 Activity 재생성 결과 보존 회귀를 test-first로 처리한다. + +### P5-R3 1차 실행 — 2026-10-02 +- 상태: focused 검증 완료, 전체 Gate 대기 +- 무엇을: `GiftDetailActivity`의 로컬 변경 결과를 Boolean 하나로 instance state에 저장·복원하고 recreate navigation 회귀 test를 추가했다. +- 왜: tracking 성공 뒤 Activity가 재생성되면 목록 갱신용 `RESULT_OK`가 기본 `RESULT_CANCELED`로 유실되는 `REV-P5-002`를 수정하기 위해서다. +- 어떻게: + - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftCancelViewModelTest" --rerun` — RED, 20초 후 navigation 1개 실패. tracking 성공 → recreate → 종료에서 `GiftNavigationTest.kt:230`의 `RESULT_OK` 기대값이 `RESULT_CANCELED`로 유실됐다. + - 같은 명령 — GREEN, 27초 후 `BUILD SUCCESSFUL`; navigation 11개, detail 15개, cancel 12개, 총 38개 test의 failures/errors/skipped=0을 XML 결과로 확인했다. + - Robolectric `ActivityController.recreate()` 뒤 tracking 성공의 toolbar/system back, 직접 취소와 tracking 자식 취소 성공, 서버 `CANCELED` 조회만인 음성 경로를 검증했다. recreate 전후 GET과 취소 mutation counter가 증가하지 않았다. +- 남은 항목: `P5-R2`와 함께 수행할 수정 후 전체 `P5-GATE` 및 후속 재검토. 이번 Task에서는 실행하거나 완료 판정하지 않았다. +- 다음 행동: 전체 Gate 의존성은 별도 후속 Task에서 실행한다. + +### P5-R2 최종 검증: 2026-10-02 +- 상태: 완료 +- 근거: 공유 Retrofit assertion의 RED와 privacy 1개·repository 6개의 GREEN을 보존한다. 직접 standalone security 재시도 PASS 및 R4 후 최종 직렬 Gate PASS로 `REV-P5-001`을 수정·검증 완료 처리했다. +- 남은 항목: 없음. 선택적 `callFactory` assertion은 비차단 의견으로 채택하지 않았다. + +### P5-R3 최종 검증: 2026-10-02 +- 상태: 완료 +- 근거: tracking 성공 후 recreate 결과가 CANCELED였던 RED, navigation 11개·detail 15개·cancel 12개 총 38개의 GREEN, quality PASS와 최종 직렬 Gate PASS를 연결해 `REV-P5-002`를 닫았다. +- 남은 항목: 없음. DTO·주소·전화번호가 아니라 Boolean 변경 마커만 저장한다. + +### P5-R4 최종 검증: 2026-10-02 +- 상태: 완료 +- 근거: navigation focused `BUILD SUCCESSFUL in 33s`, 12개 tests, failures/errors/skipped=0. 일반 상세 무변경 recreate/back의 `RESULT_CANCELED`, 추가 GET 0회, tracking/cancel mutation 0회를 test-only로 보강했다. R4·문서 범위 보강 후 context PASS와 최종 직렬 Gate로 `REV-P5-004`를 닫았다. +- 남은 항목: 없음. + +### P5-GATE 최종 직렬 실행: 2026-10-02 +- 상태: 완료 +- 근거: R4 이후 gift/modal 142개, 18초; 전체 unit 1409개, 1분 5초. 두 suite 모두 failures/errors/skipped=0이며 resource/compile/ktlint 4초, assembleDebug 3초, diff check exit 0이다. 상세 명령과 결과는 마지막 Verification Log에 기록한다. +- 이력: 앞선 동시 XML 쓰기 충돌은 코드 실패도 최종 성공 근거도 아니다. 재검증 첫 ktlint의 unused-import 실패는 수정한 뒤 최종 직렬 Gate가 통과했다. +- 남은 항목: 없음. goal·QA·quality·직접 security·context 재검토가 모두 PASS다. + +### P5-D2 최종 문서 정리: 2026-10-02 +- 상태: 완료 +- 근거: 기존 네 문서만 갱신해 Phase 1~5 완료 수를 2/2, 3/3, 4/4, 5/5, 6/6으로 맞췄다. PRD review 링크·성공 기준·결정 이력, 리뷰의 네 finding과 최종 PASS, build guide의 focused 명령 세 개를 대조했다. +- 이력 보존: 초기 문서 전용 결정, RED와 lint 실패, security INCONCLUSIVE/FAIL, context FAIL 및 XML 충돌 기록을 삭제하지 않았다. Figma/layout 검증은 source/resource 대조이며 기기·시각 QA를 포함하지 않는다. +- 남은 항목: 기능·리뷰 차단 없음. 문서 편집 이후 `./gradlew tasks --all`은 `BUILD SUCCESSFUL in 1s`, `GIT_MASTER=1 git diff --check HEAD`는 출력 없이 exit 0이었다. + +```markdown +### N차 실행 — YYYY-MM-DD +- 상태: 진행 중 / 완료 / 차단 감사 중 / 차단 +- 무엇을: 완료한 체크박스와 산출물 +- 왜: 요구사항과 Task objective +- 어떻게: + - `<명령>` — 성공/실패, exit code, test 수와 핵심 결과 +- 남은 항목: 체크박스, 외부 조건 또는 없음 +- 다음 행동: 같은 Goal에서 이어갈 가장 작은 단계 +``` + +## Decision Log + +| 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 | +|---|---|---|---|---|---| +| `2026-10-02` | `PLAN-DEC-001` | 확정 | 별도 작업 디렉터리에서 상세·tracking 계획을 관리한다. | 사용자 승인 | 전체 | +| `2026-10-02` | `PLAN-DEC-002` | 확정 | 상세/운송장 Activity를 분리하고 canceled completion은 상세 상태로 둔다. | 승인된 접근안 1 | Phase 2~4 | +| `2026-10-02` | `PLAN-DEC-003` | 확정 | 상세·tracking 양쪽의 신청 취소는 `GiftCancelViewModel`로 공유한다. | 동일 API·중복 방지·실패 유지 계약을 두 화면에서 재사용 | `P4-T2`, `P4-T3` | +| `2026-10-02` | `PLAN-DEC-004` | 확정 | V2ModalDialog는 opt-in 비자동 닫힘만 추가하고 기본 호출을 보존한다. | 사용자 선택 A | `P4-T1` | +| `2026-10-02` | `PLAN-DEC-005` | 사용자 승인 | 레거시 `AppDI.kt`에 Gift 전용 named client/Retrofit을 추가하고 Gift 로깅은 NONE으로 격리한다. 공유 debug BODY/release NONE은 유지하며 신규 dependency는 추가하지 않는다. | 최종 리뷰 PII 확정 및 사용자 명시 승인 | `REV-P5-001`, `P5-R2` | +| `2026-10-02` | `PLAN-DEC-006` | 사용자 승인 | API 정상 상태 5개를 유지하고 UI는 4개 가로 progress 구간으로 projection한다. | PRD `DEC-013` | `P6-T1` | +| `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` | + +## 발견된 문제 + +| ID | 심각도 | 상태 | 발견 내용 | 영향 Goal | 처리 계획 | +|---|---|---|---|---|---| +| `ISSUE-001` | High | 수정·검증 완료 | 기존 `V2ModalDialog`는 confirm 전에 닫혀 취소 실패 유지 요구를 만족하지 못한다. | `P4-T1`, `P4-T3` | 승인된 opt-in 비자동 닫힘·명시적 dismiss를 추가했고 Phase 4와 최종 gift/modal Gate로 검증했다. | +| `REV-P3-T3-001` | Medium | 수정 완료 | 등록 실패 Toast가 Activity 재생성 시 다시 표시된다. | `P3-R1` | 소비형 Toast와 local unit 회귀 test로 해결했다. | +| `REV-P4-T2-001` | Low | 수정 완료 | 열린 dialog의 나가기 API 0회 계약이 독립 검증되지 않는다. | `P4-R1` | 별도 열린 dialog test로 해결했다. | +| `REV-P4-T3-001` | Medium | 수정 완료 | 상세 최초 조회 중 tracking 취소 결과가 도착하면 `Loading` 상태에서 버려진다. | `P4-R2` | pending 취소 응답 보존과 조회 완료 후 우선 적용을 회귀 test로 고정했다. | +| `REV-P5-001` | High | 수정·검증 완료 | 공유 debug BODY 경로의 Gift 개인정보 로그 문제 | `P5-R2`, `P5-GATE` | Gift NONE 격리, privacy/repository 7개 GREEN, 직접 standalone security PASS, 최종 직렬 Gate PASS | +| `REV-P5-002` | Medium | 수정·검증 완료 | mutation 후 상세 recreate의 목록 갱신 결과 유실 | `P5-R3`, `P5-GATE` | saved Boolean 최소 복원, lifecycle 38개 GREEN, quality PASS, 최종 직렬 Gate PASS | +| `REV-P5-003` | Low | 수정·검증 완료 | Phase 요약·최종 문서·build guide 실행 예시 누락 | `P5-D2` | 네 문서 정합성 대조와 명령 추가, 기존 이력 보존, context PASS 및 snapshot diff check exit 0 | +| `REV-P5-004` | Low | 수정·검증 완료 | 일반 상세 무변경 recreate/back 음성 테스트 누락 | `P5-R4`, `P5-GATE` | navigation 12개 PASS, RESULT_CANCELED·추가 GET/변경 요청 0회 검증, 최종 직렬 Gate·context PASS | +| `REV-P6-REVIEW-001` | Low | 수정·검증 완료 | stale tracking CTA 회귀 test가 View visibility를 직접 assertion해 테스트 정책을 위반한다. | `P6-R3` | 순수 presentation 결정 RED/GREEN, View 속성 assertion 제거, 전체 Gate와 context 재검토 PASS | + +## Verification Log + +아래 기록은 각 실행 당시의 상태를 보존한다. 최신 종료 판정은 이 절 마지막의 최종 증거를 기준으로 한다. + +- `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`: 계획 작성 단계이며 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이었다. +- `2026-10-02`: Phase 2 gate를 독립 재실행했다. 상세 presenter 12개, 상세 ViewModel 11개, inbox/navigation 14개가 모두 통과했고 resource merge와 Kotlin compile이 성공했다. +- `2026-10-02`: Phase 3 gate를 회귀 수정 후 독립 재실행했다. navigation 8개, tracking presenter 8개, tracking ViewModel 13개, detail ViewModel 11개가 모두 통과했고 resource merge와 Kotlin compile이 성공했다. +- `2026-10-02`: Phase 4 gate를 `REV-P4-T3-001` 수정 후 독립 재실행했다. modal 8개, cancel ViewModel 12개, detail ViewModel 15개, navigation 9개의 총 44개가 모두 통과했고 resource merge와 Kotlin compile이 성공했다. +- `2026-10-02`: P5 lint 회귀 수정 후 gift/modal 전체와 전체 local unit test가 통과했다. resource merge, Kotlin compile, ktlint, assembleDebug가 모두 성공했고 `git diff --check HEAD`는 exit 0이었다. 기존 `disabled_rules`와 Gradle deprecated 경고는 남아 있으나 이번 변경의 실패 원인은 아니다. +- `2026-10-02`: 최종 리뷰 원 판정은 goal PASS, executable QA PASS(148 tests), quality FAIL(PII 로그·Activity result 유실 2건), context FAIL(PII·문서), 첫 security INCONCLUSIVE다. 직접 focused security 재시도는 FAIL로 PII를 확정했다. 이는 전달받은 리뷰 결과이며 이번 문서 등록에서 실행한 테스트 결과가 아니다. +- `2026-10-02`: `REV-P5-001`(High), `REV-P5-002`(Medium), `REV-P5-003`(Low)을 `P5-R2`, `P5-R3`, `P5-D2`로 등록하고 `reviews/phase5-final-regression-review.md`에 근거와 승인 범위를 기록했다. Phase 5는 진행 중이며 수정 후 검증은 대기다. 이번 작업은 Read와 apply_patch만 사용했고 production/test·PRD·기존 리뷰는 변경하지 않았으며 Gradle·git은 실행하지 않았다. +- `2026-10-02` P5-R3 RED/GREEN: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftDetailViewModelTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftCancelViewModelTest" --rerun`의 RED는 20초 후 tracking 성공 → recreate → 종료 결과를 확인하는 `GiftNavigationTest.kt:230`에서 1개 실패했다. Boolean 변경 마커 저장·복원과 기존 성공 경로 연결 뒤 같은 명령은 27초 후 `BUILD SUCCESSFUL`로 통과했으며 navigation 11개, detail 15개, cancel 12개, 총 38개가 failures/errors/skipped=0이다. 이 기록은 focused 검증만이며 전체 `P5-GATE`는 실행·완료 처리하지 않았다. + +### 최종 snapshot 증거와 종료 판정: 2026-10-02 + +- `P5-R2`: 공유 Retrofit assertion RED 후 privacy 1개와 repository 6개, 총 7개 GREEN. 직접 standalone security 재시도 PASS로 `REV-P5-001`을 닫았다. 앞선 INCONCLUSIVE는 검토 거절 이력이며 새 PASS로 덮어쓰지 않는다. +- `P5-R3`: recreate 결과 `RESULT_OK` 기대, `RESULT_CANCELED` 관측의 RED 후 navigation/detail/cancel 38개 GREEN. `P5-R4`: navigation focused `BUILD SUCCESSFUL in 33s`, 12개 tests, failures/errors/skipped=0. +- 재검토: goal PASS, QA PASS(7개·38개·R4 전 gift/modal 141개, 중복 suite이므로 합산하지 않음), quality PASS. 선택적 `callFactory` assertion은 채택하지 않았다. context는 두 누락으로 FAIL이었다가 R4·문서 범위 보강 후 PASS로 전환했다. +- 실행 이력: 첫 ktlint의 unused-import 실패는 수정했다. 동시 실행의 XML 쓰기 충돌은 비코드 실패로 분리하고 그 실행을 최종 성공 증거로 사용하지 않았다. 이후 아래 Gate를 직렬 실행한 결과만 최종 근거로 사용한다. +- 문서 후속 검증: 네 종료 문서 편집 후 `./gradlew tasks --all`은 `BUILD SUCCESSFUL in 1s`, `GIT_MASTER=1 git diff --check HEAD`는 출력 없이 exit 0이었다. + +| 최종 직렬 Gate 명령 | 확인된 결과 | +|---|---| +| `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --tests "kr.co.vividnext.sodalive.v2.components.modal.*"` | `BUILD SUCCESSFUL in 18s`, 142 tests, failures/errors/skipped=0 | +| `./gradlew :app:testDebugUnitTest` | `BUILD SUCCESSFUL in 1m 5s`, 1409 tests, failures/errors/skipped=0 | +| `./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck` | `BUILD SUCCESSFUL in 4s` | +| `./gradlew :app:assembleDebug` | `BUILD SUCCESSFUL in 3s` | +| `GIT_MASTER=1 git diff --check HEAD` | 출력 없음, exit 0 | + +- `P5-D2`: PRD·계획·Phase 5 리뷰·build guide를 읽고 최종 증거와 대조해 갱신했다. privacy/navigation/gift-modal 명령 세 개는 Task 5.D2와 동일하다. 문서 담당은 Gradle·git을 실행하지 않았다. 위 diff check는 전달된 최종 snapshot의 결과이며 이번 문서 편집 이후의 결과가 아니다. parent가 수행할 `tasks --all`·diff check는 별도 후속 확인이다. +- 최종 판정: `REV-P5-001`~`REV-P5-004` 수정·검증 완료, `P5-GATE`와 `P5-D2` 완료, Phase 5 `6/6`, 차단 없음. 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 수행하지 않았고 Figma/layout 증거는 source/resource 대조에 한정한다. +- `2026-10-02` Phase 6 계획 등록: 승인된 PRD와 Figma 7개 노드의 design context를 기준으로 `P6-T1`, `P6-T2`, `P6-GATE`, `P6-REVIEW`를 추가했다. production/test/resource는 아직 변경하지 않았으며 RED/GREEN과 Gate 결과는 미실행이다. +- `2026-10-02` P6-T1 완료: Task 6.1 아래 실제 RED 2회와 GREEN 직렬 실행 결과를 누적했다. presenter 15개, navigation/detail/cancel 39개는 모두 failures/errors/skipped=0이며 resource merge·Kotlin compile 성공을 확인했다. Phase 6은 `1/4`, 다음 Task는 P6-T2다. 기존 완료 이력은 보존했고 tracking 파일·API·DTO·레거시·PRD는 수정하지 않았다. 화면 근거는 승인 계약과 소스/리소스 대조이며 실기기 또는 픽셀 검증이 아니다. +- `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)이었다. diff --git a/docs/20261002_선물_상세와_운송장_등록/prd.md b/docs/20261002_선물_상세와_운송장_등록/prd.md new file mode 100644 index 00000000..d4d0a13e --- /dev/null +++ b/docs/20261002_선물_상세와_운송장_등록/prd.md @@ -0,0 +1,416 @@ +# PRD: 선물 상세와 운송장 등록 + +## 문서 정보 + +| 항목 | 내용 | +|---|---| +| 문서 상태 | 기존 Phase 1~5 완료, Figma UI 재구현 요구사항 승인·구현 준비 | +| 작성일 | `2026-10-02` | +| 최종 수정일 | `2026-10-02` | +| 대상 제품 | Android 선물 상세·운송장 등록·신청 취소 | +| 작성자·결정권자 | 사용자 요청 및 인터뷰 기준 | +| 관련 API Contract | 이 문서 11장 | +| 관련 구현 계획 | `docs/20261002_선물_상세와_운송장_등록/plan-task.md` | +| 선행 구현 | `docs/20261001_선물함_리스트_페이지/` | +| 관련 review | [Phase 3 운송장 화면](reviews/phase3-tracking-screen-review.md), [Phase 4 취소 ViewModel](reviews/phase4-cancel-viewmodel-review.md), [Phase 4 취소 화면](reviews/phase4-cancel-screen-review.md), [Phase 5 최종 회귀](reviews/phase5-final-regression-review.md) | + +## 1. Overview + +로그인 사용자가 선물함 카드에서 신청번호로 상세 화면에 진입해 선물의 현재 상태와 허용된 정보를 확인할 수 있게 한다. 보낸 선물 중 운송장 등록이 필요한 신청은 SODALIVE 사서함 주소를 확인하고 택배사와 운송장 번호를 등록할 수 있으며, 접수 상태의 보낸 신청은 확인 다이얼로그를 거쳐 취소할 수 있다. + +Figma의 화면 구조와 문구를 따르되 상태와 데이터 노출은 API 계약을 우선한다. 정상 진행 API 상태 5개는 보존하고, 화면에는 Figma처럼 `신청 접수`, `발송 확인`, `사서함 도착`, `전달 완료` 4개 진행 구간으로 표시한다. `INSPECTION_COMPLETED`는 별도 진행 구간을 추가하지 않고 `사서함 도착` 구간의 완료 상태와 선물 정보의 `검수일`에 반영한다. + +## 2. Problem Statement + +아래는 최초 요구사항 수집 당시의 문제다. 이후 구현·검증 결과는 14장과 관련 리뷰에서 추적한다. + +- 현재 선물함 카드는 상세 화면 대신 상태 toast만 표시한다. +- 사용자는 신청 이후 운송장 등록, 정상 진행 이력 확인, 전달 불가 사유 확인, 신청 취소를 완료할 화면이 없다. +- 보낸 사람과 받는 사람의 주소 데이터는 의미가 다르므로 상대방 개인정보를 노출하지 않는 방향별 표시 정책이 필요하다. +- 기존 `V2ModalDialog`는 확인 탭 즉시 닫혀 취소 API 실패 시 다이얼로그를 유지할 수 없다. + +문제를 해결했다는 판단은 선물함에서 `applicationNo`로 상세를 열고, 상세 조회·운송장 등록·취소 API와 화면 상태가 계약대로 연결되며, 방향별 개인정보 노출과 5개 API 상태의 4구간 진행 표시가 local unit test로 검증되는 것으로 한다. + +## 3. Goals + +### 3.1 제품 목표 + +- 선물함 카드에서 `applicationNo`로 선물 상세를 연다. +- 상세 화면은 `GET /api/v2/gifts/{applicationNo}`의 `response.data`를 렌더링한다. +- 정상 진행 5개 API 상태와 상태별 안내·섹션·action을 정확히 표시한다. +- `trackingRequired=true`인 보낸 선물에서 운송장 정보를 한 번 등록한다. +- `direction=SENT && status=RECEIVED` 신청을 확인 다이얼로그 후 취소한다. +- 취소 API 성공 또는 상세 조회의 `status=CANCELED`에서 취소 완료 화면을 표시한다. + +### 3.2 UX 목표 + +- 상단 고정 내비게이션과 하단 safe area는 기존 Android 패턴을 따른다. +- loading·content·error·retry·submit 상태에서 사용자가 현재 동작을 이해할 수 있게 한다. +- mutation 중 중복 탭을 막고 실패 시 입력 또는 취소 확인 문맥을 유지한다. +- Figma의 레이아웃·문구를 우선하되 API 상태·데이터 계약과 충돌하면 API를 우선한다. + +## 4. Non-Goals + +- iOS 구현 또는 iOS 문서. +- 운송장 등록 완료 후 수정 기능. +- 받는 사람 배송지 입력·수정 기능. +- 택배사 목록 API 조회. +- 신규 디자인 시스템, 신규 공통 dialog 또는 전역 event bus. +- 상대방의 `recipientAddress` 노출. +- 존재하지 않는 선물 리뷰 작성 또는 선물 정책 route 신규 구현. +- `app/src/androidTest`, 기기·에뮬레이터 조작, 스크린샷·시각 QA. + +## 5. Target Users and Permissions + +| 사용자 | 목표 | 허용 정보·작업 | +|---|---|---| +| 보낸 팬 (`SENT`) | 신청 상태 확인, 운송장 등록, 접수 상태 신청 취소 | 크리에이터 닉네임, 본인의 `senderInfo`, SODALIVE `mailbox`; 상대방 `recipientAddress` 비노출 | +| 받는 크리에이터 (`RECEIVED`) | 수령 예정 선물 상태와 본인 배송지 확인 | 보낸 팬 닉네임, 본인이 입력한 `recipientAddress` | + +- 인증은 기존 `SharedPreferenceManager.token`의 Bearer header 패턴을 재사용한다. +- 서버는 로그인 사용자가 접근 가능한 신청만 반환한다. +- `applicationNo`가 blank이면 API를 호출하지 않고 기존 오류 feedback 후 안전하게 종료한다. + +## 6. 핵심 사용자 흐름 + +### 6.1 상세 조회 + +1. 사용자가 선물함 카드 또는 배송지 안내 배너를 누른다. +2. 앱은 카드의 `applicationNo`만 상세 Activity에 전달한다. +3. 상세 화면은 `GET /api/v2/gifts/{applicationNo}`를 호출한다. +4. 성공하면 상태·방향·nullable 데이터에 맞는 상태 안내, 4구간 progress, action, 정보 섹션을 표시한다. +5. `status=CANCELED`이면 일반 상세 대신 취소 완료 화면을 표시한다. +6. 실패하면 기존 오류 표시와 같은 신청번호 재시도를 제공한다. + +### 6.2 운송장 등록 + +1. `trackingRequired=true`인 상세에서 `운송장 작성하기`를 누른다. +2. 운송장 등록 화면은 같은 상세 API를 다시 조회한다. +3. `trackingRequired=false`이면 오류를 표시하고 상세로 돌아간다. +4. `mailbox=null`이면 `받을 주소가 등록되어 있지 않습니다.`를 표시하고 등록을 막는다. +5. 사용자는 로컬 택배사 목록에서 한글 표시명을 선택하고 운송장 번호를 입력한다. +6. 유효한 입력에서 `POST /api/v2/gifts/{applicationNo}/tracking`을 한 번 호출한다. +7. 성공 toast 후 상세를 다시 열어 상세 API를 재조회하고 `TRACKING_REGISTERED`를 표시한다. + +### 6.3 신청 취소 + +1. `direction=SENT && status=RECEIVED`에서 `신청 취소`를 누른다. +2. API를 호출하지 않고 `V2ModalDialog`를 먼저 표시한다. +3. `나가기`는 dialog만 닫고 현재 화면 상태를 유지한다. +4. `취소하기`는 중복 탭을 막고 `POST /api/v2/gifts/{applicationNo}/cancel`을 호출한다. +5. 실패하면 dialog를 유지하고 기존 오류 feedback을 표시해 재시도할 수 있게 한다. +6. 성공하면 dialog를 닫고 취소 응답을 반영한 취소 완료 상태로 replace한다. +7. 뒤로가기는 취소 전 상세·운송장 화면이 아니라 선물함으로 이동한다. + +## 7. 정보 구조와 라우팅 + +```text +GiftInboxActivity + -> GiftDetailActivity(applicationNo) + -> GiftTrackingActivity(applicationNo) + -> V2ModalDialog -> cancel API + -> Canceled completion state + -> Kakao inquiry +``` + +- `GiftDetailActivity.newIntent(context, applicationNo)`와 `GiftTrackingActivity.newIntent(context, applicationNo)`를 제공한다. +- DTO 전체나 주소 데이터는 Intent로 전달하지 않는다. +- 취소 완료 전용 Activity는 만들지 않고 `GiftDetailActivity`의 취소 완료 상태로 렌더링한다. +- 운송장 등록 성공은 상세를 재조회하도록 결과를 반환하거나 기존 상세를 제거하는 replace navigation을 사용한다. +- 취소 성공은 취소 전 상세·등록 화면이 back stack에 남지 않도록 선물함으로 안전하게 돌아가는 경로를 보장한다. +- 상세에서 변경이 발생한 뒤 선물함으로 돌아오면 기존 `GiftInboxViewModel.refresh()`를 사용해 목록을 갱신한다. +- mutation 성공 후 상세 Activity가 재생성되어도 변경 여부 Boolean을 저장·복원해 `RESULT_OK`를 유지한다. 변경 없는 일반 상세와 mutation 없는 `CANCELED` 조회는 재생성 후에도 성공 결과를 만들지 않는다. + +## 8. 기능 요구사항 + +### 8.1 상세 진입과 조회 + +| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 | +|---|---|---|---|---| +| `GIFT-DETAIL-001` | 확정 | 목록 카드 탭은 상태 toast 대신 `applicationNo` 상세 이동 event를 발생시킨다. | event가 한 번 소비되고 Intent에 같은 신청번호가 담긴다. | `P2-T3` | +| `GIFT-DETAIL-002` | 확정 | 상세는 진입 시 상세 API를 호출하고 `response.data`를 사용한다. | loading/content/error/retry와 null payload 오류가 검증된다. | `P1-T1`, `P1-T2`, `P2-T2` | +| `GIFT-DETAIL-003` | 확정 | `status=CANCELED`는 일반 상세가 아닌 취소 완료 상태로 렌더링한다. | 직접 진입과 취소 성공 경로가 같은 완료 모델을 사용한다. | `P2-T1`, `P2-T2`, `P4-T3` | + +### 8.2 hero와 진행 상태 + +| status | chip | title | body | +|---|---|---|---| +| `RECEIVED` | 없음 또는 `접수 완료` | `선물 신청 완료!` | `선물이 정상적으로 접수되었어요!` | +| `TRACKING_REGISTERED` | `발송 확인` | `사서함으로 이동 중이에요` | 없음 | +| `ARRIVED_AT_MAILBOX` | `사서함 도착` | `선물이 사서함에 도착했어요` | 없음 | +| `INSPECTION_COMPLETED` | `검수 완료` | `선물 검수를 완료했어요` | 없음 | +| `DELIVERED` | `전달 완료` | `크리에이터에게 선물을 전달했어요` | 없음 | +| `UNDELIVERABLE` | `전달 불가` | `전달할 수 없는 품목입니다` | `보내주신 선물은 SODALIVE 선물 정책에 따라 크리에이터에게 전달할 수 없는 품목으로 확인되었습니다.` | +| `CANCELED` | `취소 완료` | `선물 신청이 취소되었어요` | `{크리에이터}에게 보내는 선물 신청({신청번호})이 취소되었습니다. 취소한 신청은 되돌릴 수 없으며, 다시 보내려면 새로 신청해 주세요.` | + +| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 | +|---|---|---|---|---| +| `GIFT-STATUS-001` | 확정 | `RECEIVED`는 `선물 신청 완료!`/`선물이 정상적으로 접수되었어요!`를 표시한다. | chip은 없거나 `접수 완료`다. | `P2-T1` | +| `GIFT-STATUS-002` | 확정 | `TRACKING_REGISTERED`, `ARRIVED_AT_MAILBOX`, `INSPECTION_COMPLETED`, `DELIVERED`는 명세의 chip/title을 표시한다. | 각 status가 지정 문구에 매핑된다. | `P2-T1` | +| `GIFT-STATUS-003` | 확정 | `UNDELIVERABLE`과 `CANCELED`는 명세의 종료 상태 안내를 표시한다. | 종료 상태가 정상 progress step으로 추가되지 않는다. | `P2-T1`, `P4-T3` | +| `GIFT-STATUS-004` | 확정 | `RECEIVED`, `CANCELED`, `UNDELIVERABLE`은 공통 hero illustration과 progress를 표시하지 않고 Figma의 좌측 정렬 상태 안내 섹션만 표시한다. | 선물 아이콘·중앙 정렬 hero·progress가 숨겨지고 상태별 tag/title/body만 지정 위치에 표시된다. | `P6-T1` | +| `GIFT-TIMELINE-001` | 정정 | API의 `RECEIVED`, `TRACKING_REGISTERED`, `ARRIVED_AT_MAILBOX`, `INSPECTION_COMPLETED`, `DELIVERED` 상태를 보존하되 화면 progress는 Figma의 4개 가로 구간으로 표시한다. | `INSPECTION_COMPLETED`는 `사서함 도착` 구간 완료와 `검수일`에 반영되고 별도 다섯 번째 구간을 만들지 않는다. | `P6-T1` | +| `GIFT-TIMELINE-002` | 확정 | `occurredAt`이 있으면 완료 색상과 `MM.dd`, null이면 비활성 색상과 날짜 미표시다. | 순수 formatter/presenter test가 완료·미완료를 검증한다. | `P2-T1` | +| `GIFT-TIMELINE-003` | 확정 | 종료 상태에서도 `statusTimeline`의 정상 진행 이력을 유지한다. | `UNDELIVERABLE`, `CANCELED` fixture가 이력 손실 없이 매핑된다. | `P2-T1` | + +### 8.3 정보 섹션과 개인정보 + +| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 | +|---|---|---|---|---| +| `GIFT-INFO-001` | 확정 | 선물 정보는 항상 표시하며 direction별 상대 닉네임과 nullable 필드를 계약대로 표시한다. | paidCan, tracking, 검수일, 전달 완료일, 취소일의 조건부 표시가 검증된다. | `P2-T1` | +| `GIFT-PRIVACY-001` | 확정 | `direction=SENT`는 `recipientAddress`를 절대 노출하지 않는다. | 응답에 값이 있어도 presentation model에 포함되지 않는다. | `P2-T1` | +| `GIFT-PRIVACY-002` | 확정 | `direction=RECEIVED`는 본인이 입력한 `recipientAddress.name/phoneNumber/address`만 배송지로 표시할 수 있다. | nullable이면 섹션을 숨긴다. | `P2-T1` | +| `GIFT-MAILBOX-001` | 확정 | `mailbox`는 관리자 등록 SODALIVE 전역 사서함이며 SENT 상세와 운송장 등록의 보낼 주소로 사용한다. | `recipientAddress`와 대체·혼합하지 않는다. | `P2-T1`, `P3-T1` | +| `GIFT-SENDER-001` | 확정 | `senderInfo`가 있으면 본인이 신청 시 입력한 이름·전화번호·주소를 표시한다. | null이면 섹션을 숨긴다. | `P2-T1` | +| `GIFT-UNDELIVERABLE-001` | 확정 | 전달 불가 사유 제목은 reason 또는 `전달 불가`, 안내는 폐기·미반송 문구를 사용한다. | null reason fallback과 지정 안내가 검증된다. | `P2-T1` | + +### 8.4 action + +| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 | +|---|---|---|---|---| +| `GIFT-ACTION-001` | 확정 | `trackingRequired=true`이면 `운송장 작성하기`를 표시한다. | false에서는 route 직접 진입도 제출할 수 없다. | `P2-T1`, `P2-T2`, `P3-T1`, `P3-T2` | +| `GIFT-ACTION-002` | 확정 | `direction=SENT && status=RECEIVED`이면 `신청 취소`를 표시한다. | 다른 조합에서는 취소 API를 호출할 수 없다. | `P2-T1`, `P4-T2`, `P4-T3` | +| `GIFT-ACTION-003` | 확정 | 문의하기는 기존 카카오 문의 route를 재사용한다. | 기존 URL의 ACTION_VIEW intent를 사용한다. | `P2-T2` | +| `GIFT-ACTION-004` | 제외 | gift 전용 리뷰 작성 및 선물 정책 route가 없으므로 두 action은 숨긴다. | 신규 route를 만들지 않는다. | `P2-T2` | + +### 8.5 운송장 등록 + +| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 | +|---|---|---|---|---| +| `GIFT-TRACKING-001` | 확정 | 등록 화면은 상세 API를 재조회해 신청 요약과 `mailbox`를 표시한다. | 신청일은 RECEIVED 이력의 `YYYY.MM.dd`다. | `P3-T1`, `P3-T2` | +| `GIFT-TRACKING-002` | 확정 | 택배사는 앱 로컬 상수 14개를 사용하고 한글 표시명을 그대로 전송한다. | 택배사 API 호출이 없고 request body가 선택한 표시명과 일치한다. | `P3-T1` | +| `GIFT-TRACKING-003` | 정정 | 택배사 선택과 ASCII 숫자 10~14자리 운송장 번호가 있어야 CTA가 활성화된다. | 9자리 이하·15자리 이상·비숫자·택배사 미선택 입력은 API를 호출하지 않는다. 15번째 문자는 입력 단계에서 차단한다. | `P6-T2` | +| `GIFT-TRACKING-005` | 확정 | 운송장 입력은 숫자 키패드를 요청하고 ASCII 숫자만 허용하며 14자로 제한한다. | 1~9자리 입력에는 `올바른 운송장 번호를 입력해 주세요`와 accent border를 표시하고 빈 입력은 오류를 숨긴다. | `P6-T2` | +| `GIFT-TRACKING-004` | 확정 | submit 중 중복 요청을 막고 성공 후 상세를 재조회한다. | 성공 event는 한 번 소비되고 `TRACKING_REGISTERED` 상세가 표시된다. | `P3-T2`, `P3-T3` | + +택배사 로컬 상수: + +```text +CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배, +한진택배, 롯데택배, 로젠택배, 경동택배, 대신택배, 일양로지스, +천일택배, 합동택배, 건영택배, 농협택배 +``` + +### 8.6 신청 취소와 V2 dialog + +| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 | +|---|---|---|---|---| +| `GIFT-CANCEL-001` | 확정 | 취소 버튼은 API 전에 `V2ModalDialog`를 표시한다. | dialog 표시만으로 API 호출이 발생하지 않는다. | `P4-T1`, `P4-T2`, `P4-T3` | +| `GIFT-CANCEL-002` | 확정 | `V2ModalDialog`는 기존 호출 호환성을 유지하며 opt-in 비자동 닫힘과 명시적 dismiss를 지원한다. | 기본 호출은 기존처럼 닫히고 opt-in 확인은 API 결과 전까지 유지된다. | `P4-T1` | +| `GIFT-CANCEL-003` | 확정 | 취소 실패는 dialog와 상세 상태를 유지하고 재시도를 허용한다. | 실패 후 confirm을 다시 누를 수 있고 in-flight 중에는 중복 호출이 없다. | `P4-T2`, `P4-T3` | +| `GIFT-CANCEL-004` | 확정 | 취소 성공은 `canceledAt`, `priceCan`을 우선 사용해 취소 완료 상태를 표시한다. | 상세 재조회 시에는 delivery/giftInfo fallback을 사용한다. | `P2-T1`, `P4-T2`, `P4-T3` | + +## 9. UI/UX Expectations + +### 9.1 Figma 기준 + +- 운송장 등록 전 상세: `2481:19011` +- 운송장 등록 후 상세: `2481:19152` +- 전달 완료 상세: `2481:19320` +- 전달 불가: `2481:19456` +- 취소 확인 dialog: `2481:19500` +- 취소 완료: `2481:19521` +- 운송장 등록 비활성: `2481:19066` +- 운송장 등록 활성: `2481:19109` + +### 9.2 화면 구조 + +- 신청 완료: 우측 닫기 navigation, 공통 hero illustration과 progress 없이 좌측 정렬 제목·설명, 보낼 주소, 등록 안내, 선물 정보와 신청 취소, 하단 `운송장 작성하기` action bar. +- 일반 상세: 고정 `신청 상세` header, 좌측 정렬 상태 tag/title, 4구간 가로 progress, 상태별 action, 행 단위 정보 카드와 구분선. +- 전달 불가: progress 없이 accent 상태 tag와 설명, 문의하기, 사유 카드, 선물 정보 순서로 표시한다. route가 없는 `선물 정책 확인`은 만들지 않는다. +- 취소 완료: 고정 `취소 완료` header, 공통 hero illustration과 progress 없이 gray 상태 tag·좌측 정렬 제목·동적 안내문, `크리에이터/선물 사이즈/카테고리/신청번호/신청일/취소일/환불 캔` 7행 카드, 전체 폭 문의하기. +- 운송장 등록: 고정 header, 신청 요약 카드, 보낼 주소, 운송장 정보, 등록 안내, 하단 `신청 취소`/`등록 완료` action bar. +- 기존 color, typography, spacing, card, input, button resource를 우선 재사용한다. +- 택배사 선택은 기존 Android 선택 UI 중 가장 가까운 spinner/dialog 패턴을 재사용한다. +- 정보 카드는 단일 multiline 문자열이 아니라 Figma의 고정 label 폭과 개별 value를 가진 행 구조로 표시한다. +- Figma에만 있고 앱 route가 없는 리뷰·선물 정책 action은 이번 UI 재구현에서도 추가하지 않는다. + +### 9.3 취소 dialog 문구 + +- 제목: `신청 취소` +- 본문 첫 줄: `{크리에이터}에게 보내는 선물을 취소할까요?` +- 본문 둘째 줄: `선물 보내기 규정에 따라 선물 취소 및 사용한 캔이 모두 환불됩니다.` +- 왼쪽: `나가기` +- 오른쪽: `취소하기` + +## 10. 날짜 표시 정책 + +- 입력은 UTC ISO 문자열이다. +- 앱의 기존 날짜 formatter 패턴에 맞춰 기기 timezone으로 변환한다. +- progress: `MM.dd`. +- 정보 카드·신청 요약·취소 상세: `yyyy.MM.dd`. +- null 또는 파싱 실패 날짜는 임의 날짜를 만들지 않고 해당 값 또는 행을 숨긴다. + +## 11. API 계약 + +### 11.1 공통 규칙 + +- 모든 endpoint는 로그인 Bearer 인증을 사용한다. +- Retrofit 반환형은 기존 `Single>`를 사용한다. +- 성공 payload는 `response.data`다. +- `success=false`, `data=null`, transport 오류는 성공 화면으로 처리하지 않는다. + +### 11.2 상세 조회 + +```http +GET /api/v2/gifts/{applicationNo} +``` + +`GiftDetailResponse` 필드: + +| 필드 | 타입 | +|---|---| +| `applicationNo` | `String` | +| `direction` | `SENT` 또는 `RECEIVED` | +| `status`, `statusName` | `String` | +| `giftInfo` | `GiftDetailInfoResponse` | +| `senderInfo` | `GiftAddressResponse?` | +| `recipientAddress` | `GiftAddressResponse?` | +| `mailbox` | `GiftAddressResponse?` | +| `trackingRequired`, `recipientAddressRequired` | `Boolean` | +| `recipientAddressDeadlineAt` | `String?` | +| `delivery` | `GiftDeliveryResponse` | +| `statusTimeline` | `List` | + +중첩 DTO: + +| DTO | 필드 | +|---|---| +| `GiftDetailInfoResponse` | `recipientCreatorNickname: String?`, `senderNickname: String?`, `sizeName: String`, `categoryName: String`, `applicationNo: String?`, `paidCan: Int?`, `tracking: String?`, `shippingRequestedAt: String?` | +| `GiftAddressResponse` | `name: String`, `phoneNumber: String`, `address: String` | +| `GiftDeliveryResponse` | `canceledAt: String?`, `undeliverableAt: String?`, `undeliverableReason: String?` | +| `GiftStatusTimelineResponse` | `status: String`, `statusName: String`, `occurredAt: String?` | + +### 11.3 운송장 등록 + +```http +POST /api/v2/gifts/{applicationNo}/tracking +Content-Type: application/json + +{ + "courierCompanyName": "한진택배", + "trackingNumber": "123456789012" +} +``` + +- response data는 `applicationNo`, `status`, `statusName`, `courierCompanyName`, `trackingNumber`, `trackingRegisteredAt`, `recipientAddressDeadlineAt`을 사용한다. + +### 11.4 신청 취소 + +```http +POST /api/v2/gifts/{applicationNo}/cancel +``` + +- request body는 없다. +- response data는 `applicationNo`, `status`, `statusName`, `priceCan`, `canceledAt`을 사용한다. + +## 12. 보안과 데이터 취급 + +- token, BuildConfig 값, 내부 URL, 전체 주소·전화번호를 log 또는 crash message에 기록하지 않는다. +- SENT 화면에는 응답에 값이 있어도 상대방 `recipientAddress`를 전달하거나 표시하지 않는다. +- Intent에는 `applicationNo`만 전달하고 주소·전화번호를 extra로 전달하지 않는다. +- fixture는 가상 이름·전화번호·주소를 사용한다. +- 승인된 Gift 전용 예외로 `AppDI.kt`의 named Gift client/Retrofit만 분리한다. Gift 로깅은 debug/release 모두 NONE이며 공유 client의 debug BODY/release NONE 정책과 다른 API 연결은 유지한다. +- 상세 Activity saved state에 새로 저장하는 값은 변경 여부 Boolean뿐이다. 주소·전화번호·DTO·취소 응답을 추가 저장하지 않는다. + +## 13. 성능과 품질 요구사항 + +- 화면별 최초 조회와 mutation의 중복 요청을 막는다. +- 취소·등록 실패 시 사용자가 입력하거나 보고 있던 상태를 유지한다. +- local unit test는 presenter/formatter, repository 전달, ViewModel 상태, navigation event, modal 호환성을 검증한다. +- layout 크기·간격·constraint·visibility를 직접 검증하는 테스트는 작성하지 않는다. +- 공통 `V2ModalDialog` 수정으로 인해 기존 modal local unit test와 전체 local unit test를 최종 회귀로 실행한다. + +## 14. 성공 기준 + +### 14.1 기능 (Phase 1~5 완료 이력) + +- [x] 목록 item이 `applicationNo` 상세로 이동한다. +- [x] 상세 API의 `response.data`로 상태별 화면을 렌더링한다. +- [x] 정상 progress 5개가 순서대로 표시된다. +- [x] `trackingRequired=true`에서만 운송장 작성 흐름이 동작한다. +- [x] 취소 확인 전에는 취소 API를 호출하지 않는다. +- [x] 취소 실패 시 dialog가 유지되고 성공 시 취소 완료 상태로 전환된다. +- [x] 운송장 등록 성공 후 상세를 재조회한다. + +### 14.2 개인정보·UI (Phase 1~5 완료 이력) + +- [x] SENT에서 `recipientAddress`가 노출되지 않는다. +- [x] RECEIVED에서 본인의 `recipientAddress`만 조건부 표시된다. +- [x] `mailbox`는 SODALIVE 사서함으로만 표시된다. +- [x] Figma 구조와 문구를 source/resource 대조로 확인했으며 5단계·API 데이터 계약을 우선한다. +- [x] review/policy route를 새로 만들지 않는다. +- [x] Gift 요청·응답은 전용 NONE 로깅 경로를 사용하며 공유 네트워크 정책을 바꾸지 않는다. + +Figma/layout 증거는 소스와 리소스 대조에 한정한다. 화면 표현 로직과 라우팅은 local unit test로 검증했으며 기기·에뮬레이터·androidTest·스크린샷·시각 QA는 제외했다. 위 체크는 실기기 렌더링이나 픽셀 일치 검증을 뜻하지 않는다. + +### 14.3 품질 (Phase 1~5 완료 이력) + +- [x] focused gift/modal local unit test가 통과한다. +- [x] 전체 local unit test, resource merge, Kotlin compile, ktlint가 통과한다. +- [x] 모든 확정 요구사항이 `plan-task.md`의 Task와 검증 증거에 연결된다. +- [x] mutation 성공 결과는 recreate 후 보존되고 변경 없는 일반 상세·CANCELED 조회는 성공 결과를 만들지 않는다. + +### 14.4 Phase 6 Figma UI 재구현 + +- [x] 신청 완료·운송장 등록·등록 오류·등록 후 상세·전달 완료·전달 불가·취소 완료의 콘텐츠 계층이 대응 Figma 노드와 일치한다. +- [x] 정상 진행 API 상태 5개가 Figma의 4구간 progress에 손실 없이 매핑된다. +- [x] 신청 완료·전달 불가·취소 완료에는 공통 hero illustration과 progress가 표시되지 않는다. +- [x] 취소 완료가 동적 안내문과 7행 취소 상세 카드를 표시한다. +- [x] 운송장 번호는 ASCII 숫자 10~14자리만 유효하고 15번째 문자는 입력되지 않는다. +- [x] layout 속성을 직접 검증하는 테스트를 추가하지 않고 presenter/validation의 화면 결정 로직을 local unit test로 검증한다. +- [x] 관련 local unit, resource merge, Kotlin compile, ktlint와 debug assemble이 통과한다. + +기존 14.1~14.3의 완료 체크는 Phase 1~5 당시 증거를 보존한다. Phase 6 항목이 완료되기 전에는 최신 Figma UI가 구현 완료됐다고 판정하지 않는다. + +최종 근거는 `plan-task.md` 마지막 Verification Log와 Phase 6 리뷰의 2차 수정 검증 기록이다. P6-R3 이후 직렬 Gate는 gift/modal 149개, 전체 unit 1,416개, failures/errors/skipped=0이다. resource/compile/ktlint와 assembleDebug가 성공했고 diff check는 exit 0이었다. goal·QA·quality·직접 security·context review는 모두 PASS, `REV-P6-T1-001`과 `REV-P6-REVIEW-001`은 수정·검증 완료다. + +## 15. Open Questions + +현재 구현을 차단하는 미결 질문은 없다. API 계약 변경 또는 gift 리뷰/정책 route가 추가되면 이 문서의 Decision Log와 계획 범위를 먼저 갱신한다. + +## 16. 요구사항 추적표 + +| 범위 | 계획 Phase | 검증 근거 | +|---|---:|---| +| API·DTO·repository | 1 | `GiftRepositoryTest` 및 기존 API fake 회귀 | +| 상세 presenter·5단계·개인정보 | 2 | `GiftDetailPresenterTest` | +| 상세 조회·목록 navigation | 2 | `GiftDetailViewModelTest`, `GiftInboxViewModelTest`, `GiftNavigationTest` | +| 운송장 등록 | 3 | `GiftTrackingViewModelTest`, `GiftNavigationTest` | +| V2 dialog·신청 취소 | 4 | `V2ModalDialogTest`, `GiftDetailViewModelTest` | +| Gift 네트워크 개인정보·공유 정책 보존 | 5 (`P5-R2`) | `GiftNetworkPrivacyTest`, `GiftRepositoryTest`: DI 격리·NONE 로깅·가상 개인정보 로그 미출력 | +| mutation 결과 recreate 보존 | 5 (`P5-R3`) | `GiftNavigationTest`, `GiftDetailViewModelTest`, `GiftCancelViewModelTest`: tracking·직접 취소·하위 화면 취소 성공과 CANCELED 조회 음성 회귀 | +| 일반 상세 무변경 recreate/back | 5 (`P5-R4`) | `GiftNavigationTest`: RESULT_CANCELED, 추가 GET 0회, tracking/cancel mutation 0회 | +| 통합 품질 | 5 (`P5-GATE`) | gift/modal 142개, 전체 local unit 1409개, resource/compile/lint, assembleDebug | +| 종료 문서·검증 명령 | 5 (`P5-D2`) | PRD·계획·Phase 5 리뷰·build guide 대조, snapshot diff check | +| Figma 상태·4구간 progress·정보 카드 | 6 (`P6-T1`) | `GiftDetailPresenterTest`, Figma design context와 XML/resource source 대조 | +| ASCII 운송장 입력·오류·제출 차단 | 6 (`P6-T2`) | `GiftTrackingPresenterTest`, `GiftTrackingViewModelTest`, native input XML | +| Phase 6 통합 품질·리뷰 | 6 (`P6-GATE`, `P6-R3`, `P6-REVIEW`) | gift/modal 149개, 전체 1,416개, resource/compile/ktlint/assemble, 5개 review 영역 PASS | + +## 17. Decision Log + +| 날짜 | ID | 상태 | 결정 | 근거 | 영향 | +|---|---|---|---|---|---| +| `2026-10-02` | `DEC-001` | 확정 | Android만 구현한다. | 사용자 인터뷰 | 전체 | +| `2026-10-02` | `DEC-002` | 확정 | 기존 선물함 리스트 문서와 분리해 신규 PRD/계획을 작성한다. | 상세 기능은 독립 화면·API 흐름임 | 문서 구조 | +| `2026-10-02` | `DEC-003` | 확정 | 상세와 운송장 등록은 별도 Activity로 만들고 취소 완료는 상세 Activity 상태로 처리한다. | 승인된 접근안 1 | 라우팅·파일 구조 | +| `2026-10-02` | `DEC-004` | 확정 | SENT는 상대방 `recipientAddress`를 노출하지 않고 RECEIVED만 본인 주소를 표시한다. | 사용자 인터뷰 | `GIFT-PRIVACY-*` | +| `2026-10-02` | `DEC-005` | 확정 | `recipientAddress`는 `name/phoneNumber/address` 구조다. | 사용자 API 계약 보완 | DTO | +| `2026-10-02` | `DEC-006` | 확정 | `mailbox`는 전역 SODALIVE 사서함이며 recipientAddress와 구분한다. | 사용자 전제 | 상세·운송장 주소 | +| `2026-10-02` | `DEC-007` | 확정 | 취소 실패 시 dialog 유지를 위해 `V2ModalDialog`를 opt-in 방식으로 최소 확장한다. | 기존 component가 확인 즉시 닫히는 충돌 해소 | 공통 modal·취소 흐름 | +| `2026-10-02` | `DEC-008` | 확정 | gift 리뷰·정책 route가 없으므로 관련 action은 숨긴다. | 기존 경로 조사 및 사용자 규칙 | 상세 action | +| `2026-10-02` | `DEC-009` | 최초 결정 이력, 후속 `DEC-010`으로 대체 | 최초 요청에서는 문서만 작성하고 코드는 구현하지 않는다. | 최초 사용자 요청 | 초기 PRD·계획 작성 단계 | +| `2026-10-02` | `DEC-010` | 확정 | 초기 문서 전용 단계 이후 승인된 계획에 따라 Phase 1~5 구현·회귀 수정·최종 검증을 진행한다. `DEC-009`는 당시 이력으로 보존한다. | 후속 구현 승인과 Goal별 실행 기록 | 전체 구현·최종 Gate | +| `2026-10-02` | `DEC-011` | 사용자 승인 | 레거시 `AppDI.kt`에 Gift 전용 named client/Retrofit을 추가하는 좁은 예외를 허용한다. Gift 로깅은 debug/release NONE, 공유 debug BODY/release NONE과 다른 API 설정은 유지한다. | `PLAN-DEC-005`, PII finding에 대한 명시 승인 | `REV-P5-001`, `P5-R2` | +| `2026-10-02` | `DEC-012` | 확정 | mutation 후 결과 보존은 saved state의 Boolean 변경 마커만 사용한다. 재생성 후 true일 때 RESULT_OK를 복원하고 DTO·주소·전화번호·취소 응답은 추가 저장하지 않는다. | 결과 유실 회귀의 최소 수정 범위와 양성·음성 local 검증 | `REV-P5-002`, `P5-R3`, `P5-R4` | +| `2026-10-02` | `DEC-013` | 정정 | API 정상 상태 5개는 유지하되 진행 UI는 Figma의 4구간 가로 progress로 표시한다. `INSPECTION_COMPLETED`는 사서함 도착 구간과 검수일에 반영한다. | 사용자의 Figma UI 재구현 승인과 노드 `2481:19152`, `2481:19320` 직접 대조 | `GIFT-TIMELINE-001`, `P6-T1` | +| `2026-10-02` | `DEC-014` | 확정 | 기존 Activity/API 흐름을 유지하고 행 레이아웃·상태별 section binding만 재구현한다. 신규 디자인 시스템, Activity, dependency, 리뷰·정책 route는 추가하지 않는다. | 승인된 최소 변경 접근과 기존 route 조사 | Phase 6 전체 | +| `2026-10-02` | `DEC-015` | 확정 | 운송장 번호는 ASCII 숫자 10~14자리이며 15번째 문자는 native length filter로 차단한다. | 사용자 입력 계약과 Android native input/filter 공식 계약 | `GIFT-TRACKING-003`, `GIFT-TRACKING-005`, `P6-T2` | +| `2026-10-02` | `DEC-016` | 사용자 확인 | 신청 완료와 취소 완료는 기존 공통 hero 영역을 재사용하지 않는다. 전달 불가를 포함한 종료 상태에서는 progress를 표시하지 않고 Figma의 좌측 정렬 상태 안내 섹션만 사용한다. | 사용자의 Figma 직접 대조 보완 | `GIFT-STATUS-004`, `P6-T1` | + +## 18. 변경 관리 + +- 요구사항 변경 시 Decision Log와 관련 수용 기준을 갱신한다. +- 구현 범위가 바뀌면 `plan-task.md`를 먼저 수정한다. +- 기존 선물함 리스트 문서의 완료 기록과 당시 toast 결정을 삭제하거나 덮어쓰지 않는다. +- API field, endpoint, validation 제한 또는 route를 추정해 추가하지 않는다.