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` |
| 최종 수정일 | `2026-10-02` | | 최종 수정일 | `2026-10-02` |
| 대상 제품 | Android 선물 상세·운송장 등록·신청 취소 | | 대상 제품 | Android 선물 상세·운송장 등록·신청 취소·받은 선물 배송지 입력 |
| 작성자·결정권자 | 사용자 요청 및 인터뷰 기준 | | 작성자·결정권자 | 사용자 요청 및 인터뷰 기준 |
| 관련 API Contract | 이 문서 11장 | | 관련 API Contract | 이 문서 11장 |
| 관련 구현 계획 | `docs/20261002_선물_상세와_운송장_등록/plan-task.md` | | 관련 구현 계획 | `docs/20261002_선물_상세와_운송장_등록/plan-task.md` |
@@ -20,6 +20,8 @@
Figma의 화면 구조와 문구를 따르되 상태와 데이터 노출은 API 계약을 우선한다. 정상 진행 API 상태 5개는 보존하고, 화면에는 Figma처럼 `신청 접수`, `발송 확인`, `사서함 도착`, `전달 완료` 4개 진행 구간으로 표시한다. `INSPECTION_COMPLETED`는 별도 진행 구간을 추가하지 않고 `사서함 도착` 구간의 완료 상태와 선물 정보의 `검수일`에 반영한다. Figma의 화면 구조와 문구를 따르되 상태와 데이터 노출은 API 계약을 우선한다. 정상 진행 API 상태 5개는 보존하고, 화면에는 Figma처럼 `신청 접수`, `발송 확인`, `사서함 도착`, `전달 완료` 4개 진행 구간으로 표시한다. `INSPECTION_COMPLETED`는 별도 진행 구간을 추가하지 않고 `사서함 도착` 구간의 완료 상태와 선물 정보의 `검수일`에 반영한다.
Phase 7에서는 받는 크리에이터 관점(`direction=RECEIVED`)의 상세와 배송지 입력을 추가한다. 선물함 리스트 item은 기존처럼 `applicationNo`만 상세에 전달하고, 상세 API 응답이 `direction=RECEIVED`일 때만 받은 선물 전용 상태와 배송지 입력 UI를 렌더링한다. 보낸 선물 상세, 운송장 등록, 신청 취소의 완료 이력과 검증 기록은 보존한다.
## 2. Problem Statement ## 2. Problem Statement
아래는 최초 요구사항 수집 당시의 문제다. 이후 구현·검증 결과는 14장과 관련 리뷰에서 추적한다. 아래는 최초 요구사항 수집 당시의 문제다. 이후 구현·검증 결과는 14장과 관련 리뷰에서 추적한다.
@@ -41,6 +43,9 @@ Figma의 화면 구조와 문구를 따르되 상태와 데이터 노출은 API
- `trackingRequired=true`인 보낸 선물에서 운송장 정보를 한 번 등록한다. - `trackingRequired=true`인 보낸 선물에서 운송장 정보를 한 번 등록한다.
- `direction=SENT && status=RECEIVED` 신청을 확인 다이얼로그 후 취소한다. - `direction=SENT && status=RECEIVED` 신청을 확인 다이얼로그 후 취소한다.
- 취소 API 성공 또는 상세 조회의 `status=CANCELED`에서 취소 완료 화면을 표시한다. - 취소 API 성공 또는 상세 조회의 `status=CANCELED`에서 취소 완료 화면을 표시한다.
- `direction=RECEIVED && recipientAddressRequired=true`이면 받는 크리에이터가 배송지를 입력하고 약관 2개에 동의한 뒤 제출할 수 있다.
- 배송지 입력 성공 후 상세를 다시 조회해 배송지 입력 완료, 전달 완료, 전달 불가 상태를 API 계약대로 표시한다.
- 받은 선물 상세에서는 `senderInfo`, `mailbox`, `giftInfo.applicationNo`, `giftInfo.paidCan`, `giftInfo.tracking`을 표시하지 않는다.
### 3.2 UX 목표 ### 3.2 UX 목표
@@ -53,11 +58,12 @@ Figma의 화면 구조와 문구를 따르되 상태와 데이터 노출은 API
- iOS 구현 또는 iOS 문서. - iOS 구현 또는 iOS 문서.
- 운송장 등록 완료 후 수정 기능. - 운송장 등록 완료 후 수정 기능.
- 받는 사람 배송지 입력·수정 기능. - 받은 선물 배송지 수정 기능. 배송지 최초 입력은 Phase 7 범위에 포함한다.
- 택배사 목록 API 조회. - 택배사 목록 API 조회.
- 신규 디자인 시스템, 신규 공통 dialog 또는 전역 event bus. - 신규 디자인 시스템, 신규 공통 dialog 또는 전역 event bus.
- 상대방의 `recipientAddress` 노출. - 상대방의 `recipientAddress` 노출.
- 존재하지 않는 선물 리뷰 작성 또는 선물 정책 route 신규 구현. - 존재하지 않는 선물 리뷰 작성 또는 선물 정책 route 신규 구현.
- iOS 구현 또는 iOS 문서. Android 외 플랫폼 고려사항은 이번 문서 범위에서 제외한다.
- `app/src/androidTest`, 기기·에뮬레이터 조작, 스크린샷·시각 QA. - `app/src/androidTest`, 기기·에뮬레이터 조작, 스크린샷·시각 QA.
## 5. Target Users and Permissions ## 5. Target Users and Permissions
@@ -102,6 +108,19 @@ Figma의 화면 구조와 문구를 따르되 상태와 데이터 노출은 API
6. 성공하면 dialog를 닫고 취소 응답을 반영한 취소 완료 상태로 replace한다. 6. 성공하면 dialog를 닫고 취소 응답을 반영한 취소 완료 상태로 replace한다.
7. 뒤로가기는 취소 전 상세·운송장 화면이 아니라 선물함으로 이동한다. 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. 정보 구조와 라우팅 ## 7. 정보 구조와 라우팅
```text ```text
@@ -200,6 +219,57 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배,
| `GIFT-CANCEL-003` | 확정 | 취소 실패는 dialog와 상세 상태를 유지하고 재시도를 허용한다. | 실패 후 confirm을 다시 누를 수 있고 in-flight 중에는 중복 호출이 없다. | `P4-T2`, `P4-T3` | | `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` | | `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. UI/UX Expectations
### 9.1 Figma 기준 ### 9.1 Figma 기준
@@ -212,6 +282,10 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배,
- 취소 완료: `2481:19521` - 취소 완료: `2481:19521`
- 운송장 등록 비활성: `2481:19066` - 운송장 등록 비활성: `2481:19066`
- 운송장 등록 활성: `2481:19109` - 운송장 등록 활성: `2481:19109`
- 받은 선물 배송지 입력 전 상세: `2531:36290`
- 받은 선물 배송지 입력 완료 후 상세: `2531:36399`
- 받은 선물 전달 완료 상세: `2531:36330`
- 받은 선물 전달 불가 상세: `2531:36422`
### 9.2 화면 구조 ### 9.2 화면 구조
@@ -220,10 +294,15 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배,
- 전달 불가: progress 없이 accent 상태 tag와 설명, 문의하기, 사유 카드, 선물 정보 순서로 표시한다. route가 없는 `선물 정책 확인`은 만들지 않는다. - 전달 불가: progress 없이 accent 상태 tag와 설명, 문의하기, 사유 카드, 선물 정보 순서로 표시한다. route가 없는 `선물 정책 확인`은 만들지 않는다.
- 취소 완료: 고정 `취소 완료` header, 공통 hero illustration과 progress 없이 gray 상태 tag·좌측 정렬 제목·동적 안내문, `크리에이터/선물 사이즈/카테고리/신청번호/신청일/취소일/환불 캔` 7행 카드, 전체 폭 문의하기. - 취소 완료: 고정 `취소 완료` header, 공통 hero illustration과 progress 없이 gray 상태 tag·좌측 정렬 제목·동적 안내문, `크리에이터/선물 사이즈/카테고리/신청번호/신청일/취소일/환불 캔` 7행 카드, 전체 폭 문의하기.
- 운송장 등록: 고정 header, 신청 요약 카드, 보낼 주소, 운송장 정보, 등록 안내, 하단 `신청 취소`/`등록 완료` action bar. - 운송장 등록: 고정 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를 우선 재사용한다. - 기존 color, typography, spacing, card, input, button resource를 우선 재사용한다.
- 택배사 선택은 기존 Android 선택 UI 중 가장 가까운 spinner/dialog 패턴을 재사용한다. - 택배사 선택은 기존 Android 선택 UI 중 가장 가까운 spinner/dialog 패턴을 재사용한다.
- 정보 카드는 단일 multiline 문자열이 아니라 Figma의 고정 label 폭과 개별 value를 가진 행 구조로 표시한다. - 정보 카드는 단일 multiline 문자열이 아니라 Figma의 고정 label 폭과 개별 value를 가진 행 구조로 표시한다.
- Figma에만 있고 앱 route가 없는 리뷰·선물 정책 action은 이번 UI 재구현에서도 추가하지 않는다. - Figma에만 있고 앱 route가 없는 리뷰·선물 정책 action은 이번 UI 재구현에서도 추가하지 않는다.
- 받은 선물 전달 불가의 `선물 정책 확인`은 요구사항상 버튼/action handler만 만들고 임의 URL을 연결하지 않는다. 기존 앱 정책상 무동작 handler가 금지되면 `준비 중입니다.` toast를 사용한다.
### 9.3 취소 dialog 문구 ### 9.3 취소 dialog 문구
@@ -239,7 +318,9 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배,
- 앱의 기존 날짜 formatter 패턴에 맞춰 기기 timezone으로 변환한다. - 앱의 기존 날짜 formatter 패턴에 맞춰 기기 timezone으로 변환한다.
- progress: `MM.dd`. - progress: `MM.dd`.
- 정보 카드·신청 요약·취소 상세: `yyyy.MM.dd`. - 정보 카드·신청 요약·취소 상세: `yyyy.MM.dd`.
- 받은 선물 상세의 배송 신청일·배송 완료일도 `yyyy.MM.dd`를 사용한다.
- null 또는 파싱 실패 날짜는 임의 날짜를 만들지 않고 해당 값 또는 행을 숨긴다. - null 또는 파싱 실패 날짜는 임의 날짜를 만들지 않고 해당 값 또는 행을 숨긴다.
- 기존 상세 formatter가 이미 기기 timezone으로 표시하는지 `TimeZone.setDefault` 기반 local unit test로 확인한다. 그렇지 않으면 formatter를 수정해 보낸 것과 받은 것 모두 같은 기기 timezone 기준을 사용한다.
## 11. API 계약 ## 11. API 계약
@@ -304,6 +385,26 @@ POST /api/v2/gifts/{applicationNo}/cancel
- request body는 없다. - request body는 없다.
- response data는 `applicationNo`, `status`, `statusName`, `priceCan`, `canceledAt`을 사용한다. - 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. 보안과 데이터 취급 ## 12. 보안과 데이터 취급
- token, BuildConfig 값, 내부 URL, 전체 주소·전화번호를 log 또는 crash message에 기록하지 않는다. - 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`은 수정·검증 완료다. 최종 근거는 `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 ## 15. Open Questions
현재 구현을 차단하는 미결 질문은 없다. API 계약 변경 또는 gift 리뷰/정책 route가 추가되면 이 문서의 Decision Log와 계획 범위를 먼저 갱신한다. 현재 구현을 차단하는 미결 질문은 없다. API 계약 변경 또는 gift 리뷰/정책 route가 추가되면 이 문서의 Decision Log와 계획 범위를 먼저 갱신한다.
@@ -386,6 +503,7 @@ Figma/layout 증거는 소스와 리소스 대조에 한정한다. 화면 표현
| Figma 상태·4구간 progress·정보 카드 | 6 (`P6-T1`) | `GiftDetailPresenterTest`, Figma design context와 XML/resource source 대조 | | Figma 상태·4구간 progress·정보 카드 | 6 (`P6-T1`) | `GiftDetailPresenterTest`, Figma design context와 XML/resource source 대조 |
| ASCII 운송장 입력·오류·제출 차단 | 6 (`P6-T2`) | `GiftTrackingPresenterTest`, `GiftTrackingViewModelTest`, native input XML | | 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 | | 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 ## 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-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-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-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. 변경 관리 ## 18. 변경 관리