diff --git a/docs/20261002_선물_상세와_운송장_등록/prd.md b/docs/20261002_선물_상세와_운송장_등록/prd.md index 6df34a20..fb10a9b9 100644 --- a/docs/20261002_선물_상세와_운송장_등록/prd.md +++ b/docs/20261002_선물_상세와_운송장_등록/prd.md @@ -4,9 +4,9 @@ | 항목 | 내용 | |---|---| -| 문서 상태 | 기존 Phase 1~7 완료, Phase 8 선물 UI 회귀 수정 기준 확정 | +| 문서 상태 | 기존 Phase 1~7 완료, Phase 8 진행 이력 보존, Phase 9 딥링크·한글 브랜드 표기 기준 확정 | | 작성일 | `2026-10-02` | -| 최종 수정일 | `2026-10-06` | +| 최종 수정일 | `2026-10-08` | | 대상 제품 | Android 선물 상세·운송장 등록·신청 취소·받은 선물 배송지 입력 | | 작성자·결정권자 | 사용자 요청 및 인터뷰 기준 | | 관련 API Contract | 이 문서 11장 | @@ -22,6 +22,8 @@ Figma의 화면 구조와 문구를 따르되 상태와 데이터 노출은 API Phase 7에서는 받는 크리에이터 관점(`direction=RECEIVED`)의 상세와 배송지 입력을 추가한다. 선물함 리스트 item은 기존처럼 `applicationNo`만 상세에 전달하고, 상세 API 응답이 `direction=RECEIVED`일 때만 받은 선물 전용 상태와 배송지 입력 UI를 렌더링한다. 보낸 선물 상세, 운송장 등록, 신청 취소의 완료 이력과 검증 기록은 보존한다. +Phase 9에서는 기존 외부 딥링크·푸시의 단일 진입점인 `DeepLinkActivity` 흐름에 `gift-detail/{applicationNo}`를 추가한다. 별도 딥링크 Activity는 만들지 않으며 foreground 직접 라우팅과 cold start의 `SplashActivity` → `MainV2Activity` 전달 흐름을 모두 유지한다. 또한 한국어 기본 resource에서 gift 화면에 표시되는 브랜드명 `SODALIVE`를 `소다라이브`로 바꾸고 영어·일본어 번역은 유지한다. + ## 2. Problem Statement 아래는 최초 요구사항 수집 당시의 문제다. 이후 구현·검증 결과는 14장과 관련 리뷰에서 추적한다. @@ -88,6 +90,7 @@ Phase 7에서는 받는 크리에이터 관점(`direction=RECEIVED`)의 상세 4. 성공하면 상태·방향·nullable 데이터에 맞는 상태 안내, 4구간 progress, action, 정보 섹션을 표시한다. 5. `status=CANCELED`이면 일반 상세 대신 취소 완료 화면을 표시한다. 6. 실패하면 기존 오류 표시와 같은 신청번호 재시도를 제공한다. +7. `voiceon://gift-detail/{applicationNo}` 또는 `voiceon-test://gift-detail/{applicationNo}`로 진입하면 기존 딥링크 흐름을 통해 같은 신청번호의 상세를 연다. ### 6.2 운송장 등록 @@ -131,6 +134,11 @@ GiftInboxActivity -> V2ModalDialog -> cancel API -> Canceled completion state -> Kakao inquiry + +External URI / Push deep link + -> DeepLinkActivity + -> foreground: GiftDetailActivity(applicationNo) + -> cold start: SplashActivity -> MainV2Activity -> GiftDetailActivity(applicationNo) ``` - `GiftDetailActivity.newIntent(context, applicationNo)`와 `GiftTrackingActivity.newIntent(context, applicationNo)`를 제공한다. @@ -140,6 +148,8 @@ GiftInboxActivity - 취소 성공은 취소 전 상세·등록 화면이 back stack에 남지 않도록 선물함으로 안전하게 돌아가는 경로를 보장한다. - 상세에서 변경이 발생한 뒤 선물함으로 돌아오면 기존 `GiftInboxViewModel.refresh()`를 사용해 목록을 갱신한다. - mutation 성공 후 상세 Activity가 재생성되어도 변경 여부 Boolean을 저장·복원해 `RESULT_OK`를 유지한다. 변경 없는 일반 상세와 mutation 없는 `CANCELED` 조회는 재생성 후에도 성공 결과를 만들지 않는다. +- custom scheme은 빌드별 기존 `${URISCHEME}` 설정을 그대로 사용하며 `voiceon`과 `voiceon-test`를 production 코드에서 별도 분기하지 않는다. +- `gift-detail`의 첫 path segment는 숫자로 변환하지 않고 신청번호 문자열 그대로 `GiftDetailActivity`에 전달한다. ## 8. 기능 요구사항 @@ -279,6 +289,15 @@ CJ대한통운, 우체국택배, GS25 편의점택배, CU 편의점택배, | `GIFT-UI-DEBUG-002` | 확정 | 상태 배지는 Figma의 상태별 배경·전경 조합을 사용한다. | 일반 진행 상태는 흰 배경·검은 글자, `UNDELIVERABLE`은 빨간 배경·검은 글자, `CANCELED`는 회색 배경·흰 글자이며 chip이 없는 상태는 숨긴다. | `P8-R2` | | `GIFT-UI-DEBUG-003` | 정정 | 받은 사람 배송지 입력의 이용약관과 개인정보 `(필수)` 터치 처리를 전용 함수로 분리한다. | 두 함수 모두 `ACTION_VIEW`로 `https://app.notion.com/p/3eb27b359673802b937ae741ab7b4ad3`을 열고 체크 상태·CTA 계산을 유지한다. | `P8-R3` | +### 8.13 Phase 9 선물 상세 딥링크와 한국어 브랜드 표기 + +| ID | 상태 | 요구사항 | 수용 기준 | 계획 연결 | +|---|---|---|---|---| +| `GIFT-DEEPLINK-001` | 확정 | 기존 `DeepLinkActivity` 중심 경로에서 `gift-detail/{applicationNo}`를 인식한다. | 별도 exported gift 진입 Activity 없이 외부 custom scheme과 FCM deep link가 기존 단일 진입점을 사용한다. | `P9-T1` | +| `GIFT-DEEPLINK-002` | 확정 | foreground와 cold start 모두 동일한 신청번호의 `GiftDetailActivity`를 연다. | `A-1002609300001` 같은 문자열 신청번호가 손실 없이 전달되고 blank 또는 path 누락 시 상세를 열지 않는다. | `P9-T1`, `P9-T2` | +| `GIFT-DEEPLINK-003` | 확정 | 빌드별 URI scheme은 기존 Manifest placeholder로 구분한다. | `voiceon`, `voiceon-test`를 위한 production 분기나 중복 intent-filter를 추가하지 않는다. | `P9-T1` | +| `GIFT-I18N-001` | 확정 | 한국어 기본 resource의 gift 화면 브랜드명 `SODALIVE`를 `소다라이브`로 표시한다. | `kr.co.vividnext.sodalive.v2.gift` 화면에서 사용하는 한국어 문자열의 `SODALIVE`가 남지 않고 영어·일본어 resource의 `SODALIVE`는 유지된다. | `P9-T3` | + ## 9. UI/UX Expectations ### 9.1 Figma 기준 @@ -501,6 +520,14 @@ Phase 7 구현 Task와 Task별 focused 검증은 완료했다. 상세 재조회 - [ ] 받은 사람 약관 2개의 `(필수)` 터치 함수가 분리되고 모두 지정된 Notion URL을 열며 기존 체크·CTA 동작이 유지된다. - [ ] 선물함 리스트의 받는 사람/보내는 사람 카드와 배송지 미입력 배너는 Figma 대조 결과 기존 구현을 유지한다. +### 14.7 Phase 9 선물 상세 딥링크·한글 브랜드 표기 + +- [ ] 외부 custom scheme과 FCM deep link가 기존 `DeepLinkActivity`를 통해 `gift-detail` 신청 상세로 이동한다. +- [ ] foreground와 cold start에서 신청번호 문자열이 동일하게 보존된다. +- [ ] path가 없거나 신청번호가 blank이면 상세 Activity를 열지 않는다. +- [ ] 별도 exported gift 딥링크 Activity와 scheme별 production 분기를 추가하지 않는다. +- [ ] 한국어 gift 화면은 `소다라이브`를 표시하고 영어·일본어 번역은 기존 `SODALIVE`를 유지한다. + ## 15. Open Questions 현재 구현을 차단하는 미결 질문은 없다. API 계약 변경 또는 gift 리뷰/정책 route가 추가되면 이 문서의 Decision Log와 계획 범위를 먼저 갱신한다. @@ -524,6 +551,7 @@ Phase 7 구현 Task와 Task별 focused 검증은 완료했다. 상세 재조회 | 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 | | 상태 배지·상단 이미지·약관 함수 회귀 수정 | 8 (`P8-R1`~`P8-GATE`) | 예정: `GiftDetailPresenterTest`, `GiftNavigationTest`, Figma·source 대조, resource/compile/ktlint/assemble | +| 선물 상세 딥링크·한국어 브랜드 표기 | 9 (`P9-T1`~`P9-GATE`) | 예정: 딥링크 parser/routing local test, `GiftNavigationTest`, 한국어 resource 검색, resource/compile/ktlint/assemble | ## 17. Decision Log @@ -553,6 +581,10 @@ Phase 7 구현 Task와 Task별 focused 검증은 완료했다. 상세 재조회 | `2026-10-06` | `DEC-022` | 확정 | 상태 배지는 일반 진행 흰색, 전달 불가 빨간색, 취소 완료 회색 스타일로 분리하고 chip이 없는 상태는 숨긴다. | 제공된 Figma 상세 노드와 승인된 설계 | `GIFT-UI-DEBUG-002`, `P8-R2` | | `2026-10-06` | `DEC-023` | 확정 | 받은 사람 약관은 실제 route 없이 이용약관·개인정보 터치 함수만 분리한다. | 사용자 선택 “함수만 분리” | `GIFT-UI-DEBUG-003`, `P8-R3` | | `2026-10-06` | `DEC-024` | 정정 | `DEC-023`을 대체하고 받은 사람의 이용약관·개인정보 터치 시 모두 지정된 Notion URL을 외부 브라우저로 연다. | 사용자 제공 URL과 후속 명시 요청 | `GIFT-UI-DEBUG-003`, `P8-R3` | +| `2026-10-08` | `DEC-025` | 확정 | `gift-detail`은 별도 진입 Activity를 만들지 않고 기존 외부 딥링크·푸시의 단일 진입점인 `DeepLinkActivity` 흐름에 추가한다. | Manifest, FCM, 알림 목록의 실제 진입 경로 조사와 사용자 정정 승인 | `GIFT-DEEPLINK-001`, `P9-T1`, `P9-T2` | +| `2026-10-08` | `DEC-026` | 사용자 승인 | 중앙 딥링크 흐름 유지에 필요한 최소 범위로 레거시 `DeepLinkActivity` 수정을 허용한다. | 별도 v2 gift 진입 Activity가 기존 경로와 중복된다는 조사 결과 | `GIFT-DEEPLINK-001`, `P9-T1` | +| `2026-10-08` | `DEC-027` | 확정 | `voiceon`과 `voiceon-test`는 기존 `${URISCHEME}` 빌드 설정을 사용하고 기능 코드에서 구분하지 않는다. | 사용자 명시 요청과 현행 Manifest 구조 | `GIFT-DEEPLINK-003`, `P9-T1` | +| `2026-10-08` | `DEC-028` | 확정 | 브랜드명 변경은 한국어 기본 resource만 대상으로 하고 영어·일본어 `SODALIVE`는 유지한다. | 사용자 인터뷰 답변 B | `GIFT-I18N-001`, `P9-T3` | ## 18. 변경 관리