diff --git a/docs/20261002_선물_상세와_운송장_등록/prd.md b/docs/20261002_선물_상세와_운송장_등록/prd.md index cb208867..a5010986 100644 --- a/docs/20261002_선물_상세와_운송장_등록/prd.md +++ b/docs/20261002_선물_상세와_운송장_등록/prd.md @@ -12,7 +12,7 @@ | 관련 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) | +| 관련 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), [Phase 12 선물 상세 문구](reviews/phase12-gift-detail-copy-review.md) | ## 1. Overview @@ -277,7 +277,7 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배, | 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-RECEIVED-ACTION-002` | 정정 | 선물 정책 확인은 지정된 Notion 선물 정책 URL을 외부 브라우저로 연다. | 클릭 시 `ACTION_VIEW`로 `https://app.notion.com/p/3eb27b359673802b937ae741ab7b4ad3`을 열고 `준비 중입니다.` toast를 표시하지 않는다. | `P12-T2` | | `GIFT-DATE-001` | 확정 | 선물 상세 페이지의 모든 상세 필드 날짜는 UTC ISO를 기기 timezone 기준 `yyyy.MM.dd`로 표시한다. | 보낸 것과 받은 것 모두 timezone 경계 test가 통과한다. | `P7-T1`, `P7-T2` | | `GIFT-DATE-002` | 확정 | 날짜 값이 null이거나 파싱 실패하면 해당 row를 숨긴다. | 현재 날짜나 `-`로 대체하지 않는다. | `P7-T2` | @@ -313,6 +313,38 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배, | `GIFT-I18N-004` | 확정 | `AddressForm`은 배송지 입력 전용 section title을 표시한다. | 신규 `gift_detail_recipient_address_input`이 한국어 `배송지 입력`, 영어 `Enter delivery address`, 일본어 `配送先を入力`으로 해석되고 입력 form title만 이 key를 참조한다. | `P11-T1` | | `GIFT-I18N-005` | 확정 | `AddressCompleted`와 `Delivered`는 입력한 주소를 받는 주소 section으로 표시한다. | 기존 `gift_detail_recipient_address`가 한국어 `받는 주소`, 영어 `Delivery address`, 일본어 `受取住所`로 해석되고 주소 visibility·값 바인딩은 유지된다. | `P11-T1` | +### 8.16 Phase 12 받은 선물 상태별 hero와 전달 불가 안내 문구 + +이 절은 8.10과 9.2의 받은 선물 공통 완료 hero 및 8.3·8.10의 폐기·미반송 안내에서 **문구만** 대체한다. 기존 요구사항·완료 체크·검증 이력은 삭제하거나 덮어쓰지 않는다. API, 상태 진입 조건, 레이아웃, 색상, action, 주소 노출 정책은 변경하지 않는다. + +| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 | +|---|---|---|---|---| +| `GIFT-RECEIVED-COPY-001` | 확정 | `direction=RECEIVED`의 기존 `AddressCompleted`에서 세 status별 hero title/body를 아래 표로 분리한다. | `TRACKING_REGISTERED`, `ARRIVED_AT_MAILBOX`, `INSPECTION_COMPLETED`가 각 locale의 지정 문구로 해석되며 기존 상태 진입 조건을 유지한다. | `P12-T1` | +| `GIFT-UNDELIVERABLE-COPY-001` | 확정 | `SENT`와 `RECEIVED`의 전달 불가 사유 아래 공유 안내 문구를 아래 공통 안내로 교체한다. | 기존 공유 `Key.DISPOSAL_NON_RETURN_GUIDANCE`를 재사용하며 두 방향 모두 동일한 locale 문구를 사용한다. 기존 레이아웃 색상은 문구 변경 범위 밖이며 변경하지 않는다. | `P12-T1` | +| `GIFT-UNDELIVERABLE-COPY-002` | 확정 | 서버 `delivery.undeliverableReason`은 번역하거나 가공하지 않는다. | 값이 있으면 `GiftDetailText.Raw`로 원문을 보존하고 null 사유의 기존 fallback은 유지한다. | `P12-T1` | + +**승인된 hero 문구:** 한국어는 Figma 원문이며 `시일내로`의 붙여쓰기를 유지한다. EN/JA는 승인된 자연스러운 번역을 그대로 사용한다. + +| status | locale | title | body | +|---|---|---|---| +| `TRACKING_REGISTERED` | KO | 배송지 입력 완료! | 빠른 시일 내로 선물을 전달 드릴게요. | +| `TRACKING_REGISTERED` | EN | Delivery address saved! | We will deliver your gift as soon as possible. | +| `TRACKING_REGISTERED` | JA | 配送先の入力が完了しました! | できるだけ早くギフトをお届けします。 | +| `ARRIVED_AT_MAILBOX` | KO | 선물 검수 중 | 선물이 사서함에 도착하여 검수 중이에요. | +| `ARRIVED_AT_MAILBOX` | EN | Gift inspection in progress | Your gift has arrived at the mailbox and is being inspected. | +| `ARRIVED_AT_MAILBOX` | JA | ギフトを検品中 | ギフトが私書箱に届き、現在検品中です。 | +| `INSPECTION_COMPLETED` | KO | 선물 검수 완료 | 선물 검수를 완료했어요. 빠른 시일내로 보내드릴게요. | +| `INSPECTION_COMPLETED` | EN | Gift inspection complete | Your gift has passed inspection. We will send it to you as soon as possible. | +| `INSPECTION_COMPLETED` | JA | ギフトの検品が完了しました | ギフトの検品が完了しました。できるだけ早く発送します。 | + +**승인된 공통 전달 불가 안내:** + +| locale | 문구 | +|---|---| +| KO | 해당 선물은 보관기간(입고일 포함 최대 7일) 내에 반송 등 필요한 조치가 완료되지 않을 경우, 사전에 동의한 약관 및 폐기 동의 내용에 따라 폐기될 수 있습니다. 자세한 내용은 고객센터로 문의해 주세요. | +| EN | If the necessary arrangements, such as returning this gift, are not completed within the storage period (up to 7 days, including the day it arrives at our facility), it may be disposed of in accordance with the terms and disposal consent you previously agreed to. Please contact customer support for more information. | +| JA | このギフトは、保管期間(入庫日を含め最大7日間)内に返送などの必要な対応が完了しない場合、事前に同意いただいた利用規約および廃棄への同意内容に基づき、廃棄されることがあります。詳しくはカスタマーサポートへお問い合わせください。 | + ## 9. UI/UX Expectations ### 9.1 Figma 기준 @@ -345,7 +377,7 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배, - 택배사 선택은 기존 Android 선택 UI 중 가장 가까운 spinner/dialog 패턴을 재사용한다. - 정보 카드는 단일 multiline 문자열이 아니라 Figma의 고정 label 폭과 개별 value를 가진 행 구조로 표시한다. - Figma에만 있고 앱 route가 없는 리뷰·선물 정책 action은 이번 UI 재구현에서도 추가하지 않는다. -- 받은 선물 전달 불가의 `선물 정책 확인`은 요구사항상 버튼/action handler만 만들고 임의 URL을 연결하지 않는다. 기존 앱 정책상 무동작 handler가 금지되면 `준비 중입니다.` toast를 사용한다. +- 받은 선물 전달 불가의 `선물 정책 확인`은 기존 약관 링크 helper를 재사용해 지정된 Notion URL을 외부 브라우저로 연다. 신규 내부 화면·WebView·dependency는 추가하지 않는다. - 신청 상세 상단에는 선물 이미지를 표시하지 않는다. - 상태 배지는 일반 진행·전달 불가·취소 완료를 서로 다른 배경·전경 조합으로 표시한다. @@ -522,7 +554,7 @@ Figma/layout 증거는 소스와 리소스 대조에 한정한다. 화면 표현 - [x] `recipientAddress=null`이면 받는 주소 섹션 전체가 표시되지 않는다. - [x] `status=DELIVERED`이면 전달 완료 UI와 `DELIVERED.occurredAt` 기반 배송 완료일을 표시한다. - [x] `status=UNDELIVERABLE`이면 전달 불가 UI, 사유, 폐기·미반송 안내를 표시하고 배송지 입력·받는 주소를 숨긴다. -- [x] 문의하기는 기존 카카오 채널 문의로 연결하고, 선물 정책 확인은 임의 외부 URL을 열지 않는다. +- [x] 문의하기는 기존 카카오 채널 문의로 연결한다. 선물 정책 확인의 당시 toast 결정은 후속 `DEC-034`와 `P12-T2`에서 지정 URL 이동으로 대체한다. - [x] 보낸 것과 받은 것의 상세 날짜가 UTC ISO를 기기 timezone 기준 `yyyy.MM.dd`로 표시된다. Phase 7 구현 Task와 Task별 focused 검증은 완료했다. 상세 재조회·목록 갱신까지 명세·품질 리뷰에서 승인됐으며, 전체 local unit·assemble을 포함한 최종 완료 판정은 `P7-GATE` 실행 후 기록한다. @@ -555,6 +587,16 @@ Phase 7 구현 Task와 Task별 focused 검증은 완료했다. 상세 재조회 - [x] 입력 완료·배송 완료 주소 영역은 한국어 `받는 주소`, 영어 `Delivery address`, 일본어 `受取住所`를 표시한다. - [x] 기존 주소 visibility·값 바인딩과 null 주소 처리는 유지된다. +### 14.10 Phase 12 받은 선물 상태별 hero와 전달 불가 안내 문구 + +- [x] RECEIVED의 세 대상 status가 8.16의 서로 다른 hero title/body를 KO/EN/JA에서 정확히 표시한다. +- [x] 한국어 Figma 원문의 문장부호·띄어쓰기와 `시일내로` 표기를 유지한다. +- [x] SENT/RECEIVED의 전달 불가 공유 안내가 기존 공유 key로 8.16의 공통 문구를 표시한다. +- [x] 서버 사유는 `GiftDetailText.Raw` 원문으로 유지되고 null 사유의 기존 fallback은 보존된다. +- [x] SENT hero, RECEIVED 입력 form·전달 완료, 주소 표시 조건, API·레이아웃은 변경되지 않는다. +- [x] 받은 선물 전달 불가의 선물 정책 확인은 지정 Notion URL을 `ACTION_VIEW`로 열고 준비 중 toast를 표시하지 않는다. +- [x] presenter·locale local unit test 및 `P12-GATE`가 통과하고 실제 결과가 계획에 기록된다. 기기·androidTest·시각 QA는 실행하지 않는다. + ## 15. Open Questions 현재 구현을 차단하는 미결 질문은 없다. API 계약 변경 또는 gift 리뷰/정책 route가 추가되면 이 문서의 Decision Log와 계획 범위를 먼저 갱신한다. @@ -582,6 +624,7 @@ Phase 7 구현 Task와 Task별 focused 검증은 완료했다. 상세 재조회 | 선물 상세 크리에이터·취소 완료 라벨 | 10 (`P10-T1`) | `GiftDetailViewModelTest`, locale resource 검색, resource/compile/ktlint | | 선물 상세·운송장 등록 사서함 title | 10 (`P10-T2`) | `GiftDetailViewModelTest`, 두 layout의 공유 resource 참조, resource/compile/ktlint | | Receive 배송지 입력·표시 section title | 11 (`P11-T1`) | `GiftNavigationTest`, `GiftDetailViewModelTest`, resource/compile/ktlint | +| 받은 선물 상태별 hero·양방향 전달 불가 안내 문구·정책 링크 | 12 (`P12-T1`, `P12-T2`, `P12-GATE`) | gift 210개 tests failures/errors/skipped=0, KO/EN/JA resource·resolver와 정책 Intent 대조, resource/compile/ktlint/assemble 통과 | ## 17. Decision Log @@ -619,6 +662,8 @@ Phase 7 구현 Task와 Task별 focused 검증은 완료했다. 상세 재조회 | `2026-10-08` | `DEC-030` | 확정 | 상세 `CANCELED_LABEL`은 기존 `gift_detail_canceled_header`를 재사용하고 선물함용 `gift_inbox_canceled`는 변경하지 않는다. | 잘못된 resolver 매핑 원인 확인과 사용자 선택 권장안 1 | `GIFT-STATUS-005`, `P10-T1` | | `2026-10-08` | `DEC-031` | 확정 | 두 화면이 공유하는 `gift_tracking_destination` key를 유지하고 한국어·영어·일본어 값을 각각 `받는 사서함`, `Receiving mailbox`, `受取私書箱`으로 변경한다. | 사용자 다국어 변경 승인 | `GIFT-I18N-003`, `P10-T2` | | `2026-10-08` | `DEC-032` | 확정 | Receive 입력 form에는 신규 input 전용 resource를 사용하고, 기존 `gift_detail_recipient_address`는 입력 완료·배송 완료 주소 title로 유지해 세 locale 값을 각각 분리한다. | 사용자 권장안 승인 | `GIFT-I18N-004`, `GIFT-I18N-005`, `P11-T1` | +| `2026-10-08` | `DEC-033` | 확정 | RECEIVED의 세 진행 상태 hero title/body를 상태별 key로 최소 분리하고 양방향 전달 불가 안내는 기존 공유 key로 교체한다. KO Figma 원문과 승인된 EN/JA 번역을 사용하며 서버 사유는 Raw로 보존한다. 이전 문구만 8.16으로 대체하고 기존 완료·검증 이력은 유지한다. | 사용자 문구·자연스러운 번역·최소 매핑 방식 승인 | `GIFT-RECEIVED-COPY-001`, `GIFT-UNDELIVERABLE-COPY-001`, `GIFT-UNDELIVERABLE-COPY-002`, `P12-T1`, `P12-GATE` | +| `2026-10-08` | `DEC-034` | 정정 | `DEC-020`의 준비 중 toast 결정을 대체하고 받은 선물 전달 불가의 `선물 정책 확인`을 지정된 Notion URL의 외부 브라우저 이동으로 연결한다. 기존 `openGiftAgreementPage()`를 재사용하며 신규 route·WebView·dependency는 만들지 않는다. | 사용자 제공 URL과 후속 구현 요청 | `GIFT-RECEIVED-ACTION-002`, `P12-T2`, `P12-GATE` | ## 18. 변경 관리