docs(gift): 받은 선물 요구사항을 정리한다

This commit is contained in:
2026-10-02 23:55:20 +09:00
parent 8ef6fdc7a6
commit 5f2965b915
@@ -4,10 +4,10 @@
| 항목 | 내용 |
|---|---|
| 문서 상태 | 기존 Phase 1~5 완료, Figma UI 재구현 요구사항 승인·구현 준비 |
| 문서 상태 | 기존 Phase 1~6 완료, Phase 7 받은 선물 상세·배송지 입력 문서 기준 확정 |
| 작성일 | `2026-10-02` |
| 최종 수정일 | `2026-10-02` |
| 대상 제품 | Android 선물 상세·운송장 등록·신청 취소 |
| 대상 제품 | Android 선물 상세·운송장 등록·신청 취소·받은 선물 배송지 입력 |
| 작성자·결정권자 | 사용자 요청 및 인터뷰 기준 |
| 관련 API Contract | 이 문서 11장 |
| 관련 구현 계획 | `docs/20261002_선물_상세와_운송장_등록/plan-task.md` |
@@ -20,6 +20,8 @@
Figma의 화면 구조와 문구를 따르되 상태와 데이터 노출은 API 계약을 우선한다. 정상 진행 API 상태 5개는 보존하고, 화면에는 Figma처럼 `신청 접수`, `발송 확인`, `사서함 도착`, `전달 완료` 4개 진행 구간으로 표시한다. `INSPECTION_COMPLETED`는 별도 진행 구간을 추가하지 않고 `사서함 도착` 구간의 완료 상태와 선물 정보의 `검수일`에 반영한다.
Phase 7에서는 받는 크리에이터 관점(`direction=RECEIVED`)의 상세와 배송지 입력을 추가한다. 선물함 리스트 item은 기존처럼 `applicationNo`만 상세에 전달하고, 상세 API 응답이 `direction=RECEIVED`일 때만 받은 선물 전용 상태와 배송지 입력 UI를 렌더링한다. 보낸 선물 상세, 운송장 등록, 신청 취소의 완료 이력과 검증 기록은 보존한다.
## 2. Problem Statement
아래는 최초 요구사항 수집 당시의 문제다. 이후 구현·검증 결과는 14장과 관련 리뷰에서 추적한다.
@@ -41,6 +43,9 @@ Figma의 화면 구조와 문구를 따르되 상태와 데이터 노출은 API
- `trackingRequired=true`인 보낸 선물에서 운송장 정보를 한 번 등록한다.
- `direction=SENT && status=RECEIVED` 신청을 확인 다이얼로그 후 취소한다.
- 취소 API 성공 또는 상세 조회의 `status=CANCELED`에서 취소 완료 화면을 표시한다.
- `direction=RECEIVED && recipientAddressRequired=true`이면 받는 크리에이터가 배송지를 입력하고 약관 2개에 동의한 뒤 제출할 수 있다.
- 배송지 입력 성공 후 상세를 다시 조회해 배송지 입력 완료, 전달 완료, 전달 불가 상태를 API 계약대로 표시한다.
- 받은 선물 상세에서는 `senderInfo`, `mailbox`, `giftInfo.applicationNo`, `giftInfo.paidCan`, `giftInfo.tracking`을 표시하지 않는다.
### 3.2 UX 목표
@@ -53,11 +58,12 @@ Figma의 화면 구조와 문구를 따르되 상태와 데이터 노출은 API
- iOS 구현 또는 iOS 문서.
- 운송장 등록 완료 후 수정 기능.
- 받는 사람 배송지 입력·수정 기능.
- 받은 선물 배송지 수정 기능. 배송지 최초 입력은 Phase 7 범위에 포함한다.
- 택배사 목록 API 조회.
- 신규 디자인 시스템, 신규 공통 dialog 또는 전역 event bus.
- 상대방의 `recipientAddress` 노출.
- 존재하지 않는 선물 리뷰 작성 또는 선물 정책 route 신규 구현.
- iOS 구현 또는 iOS 문서. Android 외 플랫폼 고려사항은 이번 문서 범위에서 제외한다.
- `app/src/androidTest`, 기기·에뮬레이터 조작, 스크린샷·시각 QA.
## 5. Target Users and Permissions
@@ -102,6 +108,19 @@ Figma의 화면 구조와 문구를 따르되 상태와 데이터 노출은 API
6. 성공하면 dialog를 닫고 취소 응답을 반영한 취소 완료 상태로 replace한다.
7. 뒤로가기는 취소 전 상세·운송장 화면이 아니라 선물함으로 이동한다.
### 6.4 받은 선물 배송지 입력과 상세 상태
1. 사용자가 선물함 리스트의 받은 선물 item 또는 배송지 입력 안내 배너를 누른다.
2. 앱은 item의 `applicationNo`만 `GiftDetailActivity`에 전달한다.
3. 상세 화면은 `GET /api/v2/gifts/{applicationNo}`를 호출하고 `response.data`를 사용한다.
4. `direction=SENT`이면 기존 보낸 선물 상세 정책을 유지하고 받은 선물 전용 UI를 렌더링하지 않는다.
5. `direction=RECEIVED && recipientAddressRequired=true`이면 Figma `2531:36290` 기준의 `선물 받기` 화면과 배송지 입력 form을 표시한다.
6. 이름, 휴대폰 번호, 우편번호, 주소, 약관 2개가 유효할 때만 `선물 받기` CTA를 활성화한다. 상세 주소는 선택 입력이다.
7. 우편번호 검색은 기존 `KakaoPostcodeSearchActivity`의 embed 기반 Kakao 우편번호 서비스를 재사용하고 선택 결과는 우편번호·주소만 채운다.
8. CTA 탭 시 `POST /api/v2/gifts/{applicationNo}/recipient-address`를 호출한다. submit 중 중복 탭은 막고 실패 시 입력값과 약관 체크 상태를 유지한다.
9. 성공하면 기존 toast 패턴으로 성공 feedback을 표시하고 같은 상세를 다시 조회한다.
10. 재조회 결과가 배송지 입력 완료, 전달 완료, 전달 불가 중 하나이면 각 Figma 상태 UI를 표시한다.
## 7. 정보 구조와 라우팅
```text
@@ -200,6 +219,57 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배,
| `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` |
### 8.7 받은 선물 상세 분기와 개인정보
| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 |
|---|---|---|---|---|
| `GIFT-RECEIVED-001` | 확정 | 선물함 리스트 item 탭은 `applicationNo`만 상세로 전달한다. | DTO·주소·전화번호를 Intent extra로 전달하지 않는다. | `P7-T5` |
| `GIFT-RECEIVED-002` | 확정 | 상세 진입 시 `GET /api/v2/gifts/{applicationNo}`를 호출하고 `response.data`로 렌더링한다. | `response.success && data != null`만 content로 처리한다. | `P7-T2`, `P7-T3` |
| `GIFT-RECEIVED-003` | 확정 | `direction=RECEIVED`가 아니면 받은 선물 전용 화면을 렌더링하지 않는다. | `SENT`는 기존 보낸 선물 상세로 유지되고, 잘못된 접근은 기존 오류/재라우팅 정책을 따른다. | `P7-T3` |
| `GIFT-RECEIVED-004` | 확정 | RECEIVED 화면에서 `senderInfo`, `mailbox`, `giftInfo.applicationNo`, `giftInfo.paidCan`, `giftInfo.tracking`은 표시하지 않는다. | presenter/UI model에 받은 선물 노출 금지 필드가 포함되지 않는다. | `P7-T2` |
| `GIFT-RECEIVED-005` | 확정 | `recipientAddress=null`이면 받는 주소 섹션 전체를 숨긴다. | 빈 섹션, skeleton, `-` 값이 없다. | `P7-T2`, `P7-T4` |
### 8.8 배송지 입력 전 UI와 제출
| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 |
|---|---|---|---|---|
| `GIFT-ADDRESS-FORM-001` | 확정 | `direction=RECEIVED && recipientAddressRequired=true`이면 Figma `2531:36290`의 `선물 받기` 화면을 표시한다. | 개인정보 이용 안내, 전달 예정 선물, 배송지 입력, 이용 약관 동의, 하단 CTA가 있다. | `P7-T2`, `P7-T4` |
| `GIFT-ADDRESS-FORM-002` | 확정 | 전달 예정 선물 섹션은 `giftInfo.senderNickname`, `sizeName`, `categoryName`만 표시한다. | 금지 필드는 표시하지 않는다. | `P7-T2` |
| `GIFT-ADDRESS-FORM-003` | 확정 | 이름, 휴대폰 번호, 우편번호, 주소가 공백이 아니고 약관 2개가 모두 체크되어야 제출 가능하다. | 상세 주소는 선택 입력이고 누락돼도 CTA 활성 조건을 막지 않는다. | `P7-T1`, `P7-T3` |
| `GIFT-ADDRESS-FORM-004` | 확정 | `POST /api/v2/gifts/{applicationNo}/recipient-address`는 화면 입력값과 약관 boolean을 그대로 전송한다. | request body key가 API 명세와 일치하고 submit 중 중복 POST가 없다. | `P7-T1`, `P7-T3` |
| `GIFT-ADDRESS-FORM-005` | 확정 | 성공 시 성공 toast를 표시하고 상세를 다시 조회한다. | 재조회 후 `recipientAddressRequired=false` 상태 UI가 표시된다. | `P7-T3`, `P7-T5` |
| `GIFT-ADDRESS-FORM-006` | 확정 | 실패 시 기존 form error/toast/dialog 패턴을 따르고 입력값을 유지한다. | 실패 뒤 이름·전화번호·주소·약관 체크가 초기화되지 않는다. | `P7-T3`, `P7-T4` |
| `GIFT-ADDRESS-FORM-007` | 확정 | 약관 상세 링크는 기존 약관/webview 경로가 있을 때만 연결한다. | 기존 경로가 없으면 새 페이지를 만들지 않는다. | `P7-T4` |
### 8.9 Kakao 우편번호 검색
| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 |
|---|---|---|---|---|
| `GIFT-POSTCODE-001` | 확정 | 기존 `KakaoPostcodeSearchActivity`를 재사용한다. | 공식 script `https://t1.kakaocdn.net/mapjsapi/bundle/postcode/prod/postcode.v2.js`와 `embed()` 기반 구현을 유지한다. | `P7-T4` |
| `GIFT-POSTCODE-002` | 확정 | 선택 결과의 `zonecode`는 `recipientZipCode`, 도로명/지번 주소는 `recipientAddress`에 넣는다. | `userSelectedType == "R"`이면 `roadAddress`, 아니면 `jibunAddress`를 사용한다. | `P7-T4` |
| `GIFT-POSTCODE-003` | 확정 | 상세 주소는 Kakao 결과로 채우지 않고 사용자가 직접 입력한다. | 주소 선택 후 상세 주소 입력으로 focus를 이동한다. | `P7-T4` |
| `GIFT-POSTCODE-004` | 확정 | 주소 검색 실패·취소는 기존 form 값을 초기화하지 않는다. | 이름, 전화번호, 약관 체크, 기존 입력 주소 상태가 유지된다. | `P7-T3`, `P7-T4` |
### 8.10 받은 선물 상태별 완료 UI
| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 |
|---|---|---|---|---|
| `GIFT-RECEIVED-COMPLETE-001` | 확정 | `recipientAddressRequired=false`이고 status가 `TRACKING_REGISTERED`, `ARRIVED_AT_MAILBOX`, `INSPECTION_COMPLETED` 중 하나이며 `recipientAddress`가 있으면 Figma `2531:36399`를 표시한다. | title `선물 상세`, hero `배송지 입력 완료!`, 문의하기, 선물 정보, 받는 주소가 표시된다. | `P7-T2`, `P7-T4` |
| `GIFT-RECEIVED-COMPLETE-002` | 확정 | `status=DELIVERED`이면 Figma `2531:36330`의 전달 완료 UI를 표시한다. | hero `선물 전달 완료!`, 배송 완료일은 `statusTimeline`의 `DELIVERED.occurredAt`을 사용한다. | `P7-T2`, `P7-T4` |
| `GIFT-RECEIVED-COMPLETE-003` | 확정 | 전달 완료의 받는 주소 섹션은 주소가 있을 때만 표시하고 보조 문구 `배송 완료 3일 후 해당 정보는 사라져요`를 포함한다. | `recipientAddress=null`이면 섹션 전체를 숨긴다. | `P7-T2`, `P7-T4` |
| `GIFT-RECEIVED-UNDELIVERABLE-001` | 확정 | `status=UNDELIVERABLE`이면 Figma `2531:36422`의 전달 불가 UI를 표시하고 배송지 입력 UI를 표시하지 않는다. | chip/title/body, 문의하기, 선물 정책 확인, 사유 섹션이 표시된다. | `P7-T2`, `P7-T4` |
| `GIFT-RECEIVED-UNDELIVERABLE-002` | 확정 | 전달 불가 사유는 `delivery.undeliverableReason` 또는 `전달 불가`, 안내는 `해당 선물은 정책에 따라 폐기되며 반송되지 않습니다.`를 사용한다. | reason null fallback이 검증된다. | `P7-T2` |
| `GIFT-RECEIVED-UNDELIVERABLE-003` | 확정 | 전달 불가에서는 응답에 `recipientAddress`가 있어도 받는 주소 섹션을 표시하지 않는다. | Figma에 없는 주소 섹션이 없다. | `P7-T2`, `P7-T4` |
### 8.11 받은 선물 action과 날짜
| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 |
|---|---|---|---|---|
| `GIFT-RECEIVED-ACTION-001` | 확정 | 문의하기는 기존 카카오 채널 문의 연결과 동일하게 처리한다. | 기존 ACTION_VIEW URL을 재사용한다. | `P7-T3`, `P7-T4` |
| `GIFT-RECEIVED-ACTION-002` | 확정 | 선물 정책 확인은 action handler만 만들고 임의 URL을 연결하지 않는다. | no-op 금지 정책이 있으면 `준비 중입니다.` toast만 표시한다. | `P7-T3`, `P7-T4` |
| `GIFT-DATE-001` | 확정 | 선물 상세 페이지의 모든 상세 필드 날짜는 UTC ISO를 기기 timezone 기준 `yyyy.MM.dd`로 표시한다. | 보낸 것과 받은 것 모두 timezone 경계 test가 통과한다. | `P7-T1`, `P7-T2` |
| `GIFT-DATE-002` | 확정 | 날짜 값이 null이거나 파싱 실패하면 해당 row를 숨긴다. | 현재 날짜나 `-`로 대체하지 않는다. | `P7-T2` |
## 9. UI/UX Expectations
### 9.1 Figma 기준
@@ -212,6 +282,10 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배,
- 취소 완료: `2481:19521`
- 운송장 등록 비활성: `2481:19066`
- 운송장 등록 활성: `2481:19109`
- 받은 선물 배송지 입력 전 상세: `2531:36290`
- 받은 선물 배송지 입력 완료 후 상세: `2531:36399`
- 받은 선물 전달 완료 상세: `2531:36330`
- 받은 선물 전달 불가 상세: `2531:36422`
### 9.2 화면 구조
@@ -220,10 +294,15 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배,
- 전달 불가: progress 없이 accent 상태 tag와 설명, 문의하기, 사유 카드, 선물 정보 순서로 표시한다. route가 없는 `선물 정책 확인`은 만들지 않는다.
- 취소 완료: 고정 `취소 완료` header, 공통 hero illustration과 progress 없이 gray 상태 tag·좌측 정렬 제목·동적 안내문, `크리에이터/선물 사이즈/카테고리/신청번호/신청일/취소일/환불 캔` 7행 카드, 전체 폭 문의하기.
- 운송장 등록: 고정 header, 신청 요약 카드, 보낼 주소, 운송장 정보, 등록 안내, 하단 `신청 취소`/`등록 완료` action bar.
- 받은 선물 배송지 입력 전: 고정 `선물 받기` header, 개인정보 이용 안내 배너, 전달 예정 선물 카드, 배송지 입력 form, 약관 2개, 하단 `선물 받기` action bar.
- 받은 선물 배송지 입력 완료: 고정 `선물 상세` header, `배송지 입력 완료!` hero, 문의하기, 선물 정보, 받는 주소 섹션. `recipientAddress=null`이면 받는 주소 섹션은 없다.
- 받은 선물 전달 완료: 고정 `선물 상세` header, `선물 전달 완료!` hero, 문의하기, 배송 완료일 포함 선물 정보, 주소가 있을 때만 받는 주소 섹션과 3일 후 삭제 안내.
- 받은 선물 전달 불가: 고정 `선물 상세` header, `전달 불가` chip, 문의하기·선물 정책 확인 action, 사유 카드만 표시한다. 배송지 입력과 받는 주소 섹션은 표시하지 않는다.
- 기존 color, typography, spacing, card, input, button resource를 우선 재사용한다.
- 택배사 선택은 기존 Android 선택 UI 중 가장 가까운 spinner/dialog 패턴을 재사용한다.
- 정보 카드는 단일 multiline 문자열이 아니라 Figma의 고정 label 폭과 개별 value를 가진 행 구조로 표시한다.
- Figma에만 있고 앱 route가 없는 리뷰·선물 정책 action은 이번 UI 재구현에서도 추가하지 않는다.
- 받은 선물 전달 불가의 `선물 정책 확인`은 요구사항상 버튼/action handler만 만들고 임의 URL을 연결하지 않는다. 기존 앱 정책상 무동작 handler가 금지되면 `준비 중입니다.` toast를 사용한다.
### 9.3 취소 dialog 문구
@@ -239,7 +318,9 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배,
- 앱의 기존 날짜 formatter 패턴에 맞춰 기기 timezone으로 변환한다.
- progress: `MM.dd`.
- 정보 카드·신청 요약·취소 상세: `yyyy.MM.dd`.
- 받은 선물 상세의 배송 신청일·배송 완료일도 `yyyy.MM.dd`를 사용한다.
- null 또는 파싱 실패 날짜는 임의 날짜를 만들지 않고 해당 값 또는 행을 숨긴다.
- 기존 상세 formatter가 이미 기기 timezone으로 표시하는지 `TimeZone.setDefault` 기반 local unit test로 확인한다. 그렇지 않으면 formatter를 수정해 보낸 것과 받은 것 모두 같은 기기 timezone 기준을 사용한다.
## 11. API 계약
@@ -304,6 +385,26 @@ POST /api/v2/gifts/{applicationNo}/cancel
- request body는 없다.
- response data는 `applicationNo`, `status`, `statusName`, `priceCan`, `canceledAt`을 사용한다.
### 11.5 받은 선물 배송지 입력
```http
POST /api/v2/gifts/{applicationNo}/recipient-address
Content-Type: application/json
{
"recipientName": "크리에이터이름",
"recipientPhoneNumber": "01012345678",
"recipientZipCode": "04030",
"recipientAddress": "서울특별시 마포구 양화로 000",
"recipientAddressDetail": "3층",
"recipientTermsAgreed": true,
"recipientPrivacyAgreed": true
}
```
- response data는 `applicationNo`, `status`, `statusName`, `recipientAddressRegisteredAt`을 사용한다.
- 성공 후 화면은 이 응답만으로 최종 렌더링하지 않고 상세를 다시 조회한다.
## 12. 보안과 데이터 취급
- token, BuildConfig 값, 내부 URL, 전체 주소·전화번호를 log 또는 crash message에 기록하지 않는다.
@@ -365,6 +466,22 @@ Figma/layout 증거는 소스와 리소스 대조에 한정한다. 화면 표현
최종 근거는 `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`은 수정·검증 완료다.
### 14.5 Phase 7 받은 선물 상세·배송지 입력
- [x] 받은 선물 상세 진입 시 `GET /api/v2/gifts/{applicationNo}`를 호출하고 `direction=RECEIVED` 상태만 받은 선물 UI로 렌더링한다.
- [x] `recipientAddressRequired=true`이면 배송지 입력 form과 약관 2개, `선물 받기` CTA가 표시된다.
- [x] 필수 입력 또는 약관이 누락되면 배송지 POST를 호출하지 않는다.
- [x] 배송지 POST request body가 API 명세와 일치하고 submit 중 중복 요청이 없다.
- [x] 배송지 입력 성공 후 상세를 재조회하고 배송지 입력 완료 UI를 표시한다.
- [x] 배송지 입력 완료/전달 완료 상태에서 `recipientAddress`가 있을 때만 받는 주소 섹션을 표시한다.
- [x] `recipientAddress=null`이면 받는 주소 섹션 전체가 표시되지 않는다.
- [x] `status=DELIVERED`이면 전달 완료 UI와 `DELIVERED.occurredAt` 기반 배송 완료일을 표시한다.
- [x] `status=UNDELIVERABLE`이면 전달 불가 UI, 사유, 폐기·미반송 안내를 표시하고 배송지 입력·받는 주소를 숨긴다.
- [x] 문의하기는 기존 카카오 채널 문의로 연결하고, 선물 정책 확인은 임의 외부 URL을 열지 않는다.
- [x] 보낸 것과 받은 것의 상세 날짜가 UTC ISO를 기기 timezone 기준 `yyyy.MM.dd`로 표시된다.
Phase 7 구현 Task와 Task별 focused 검증은 완료했다. 상세 재조회·목록 갱신까지 명세·품질 리뷰에서 승인됐으며, 전체 local unit·assemble을 포함한 최종 완료 판정은 `P7-GATE` 실행 후 기록한다.
## 15. Open Questions
현재 구현을 차단하는 미결 질문은 없다. API 계약 변경 또는 gift 리뷰/정책 route가 추가되면 이 문서의 Decision Log와 계획 범위를 먼저 갱신한다.
@@ -386,6 +503,7 @@ Figma/layout 증거는 소스와 리소스 대조에 한정한다. 화면 표현
| 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 |
| 받은 선물 상세·배송지 입력 | 7 (`P7-T1`~`P7-GATE`) | 예정: `GiftDetailPresenterTest`, `GiftRecipientAddressViewModelTest`, `GiftNavigationTest`, resource/compile/ktlint |
## 17. Decision Log
@@ -407,6 +525,10 @@ Figma/layout 증거는 소스와 리소스 대조에 한정한다. 화면 표현
| `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` |
| `2026-10-02` | `DEC-017` | 확정 | Phase 7은 Android 앱 구현만 대상으로 하며 iOS 문서는 작성하지 않는다. | 사용자 확인 | Phase 7 전체 |
| `2026-10-02` | `DEC-018` | 확정 | 받은 선물 상세·배송지 입력은 기존 `GiftDetailActivity`, gift API 계층, Kakao 우편번호 Activity, 카카오 채널 문의 패턴을 확장해 구현한다. 신규 디자인 시스템은 만들지 않는다. | 저장소 패턴 조사와 사용자 전제 | `P7-T1`~`P7-T5` |
| `2026-10-02` | `DEC-019` | 확정 | 배송지 입력 성공 후 POST 응답으로 화면을 완성하지 않고 상세 GET을 다시 조회한다. | 사용자 요구와 서버 상태 source of truth | `P7-T3`, `P7-T5` |
| `2026-10-02` | `DEC-020` | 확정 | 받은 선물 전달 불가의 `선물 정책 확인`은 임의 URL을 열지 않는다. 무동작이 정책상 금지되면 `준비 중입니다.` toast만 표시한다. | 사용자 명시 조건 | `GIFT-RECEIVED-ACTION-002`, `P7-T4` |
## 18. 변경 관리