docs(gift): 선물 받을 주소 요구사항을 기록한다

docs/20260929_크리에이터_선물하기/admin-page-prompts.md

@@ -1,11 +1,12 @@
 # 선물 관리자 페이지 구현 프롬프트
 
-이 문서는 관리자 페이지의 선물 관련 3개 화면을 프론트엔드 구현 에이전트에게 전달하기 위한 프롬프트 모음이다.
+이 문서는 관리자 페이지의 선물 관련 4개 화면을 프론트엔드 구현 에이전트에게 전달하기 위한 프롬프트 모음이다.
 
 공통 전제:
 
-- 관리자 메뉴에는 parent 메뉴 `선물함 관리` 아래에 다음 3개 하위 메뉴가 있다.
+- 관리자 메뉴에는 parent 메뉴 `선물함 관리` 아래에 다음 4개 하위 메뉴가 있다.
   - `선물함 리스트` → `/gift/list`
+  - `받을 주소` → `/gift/mailbox`
   - `선물 카테고리` → `/gift/category`
   - `선물 사이즈` → `/gift/size`
 - 모든 API 응답은 기존 공통 envelope를 사용한다. 화면에서는 `response.data`를 실제 payload로 사용한다.
@@ -237,7 +238,84 @@ type AdminGiftOperationStatusResponse = {
 
 ---
 
-## 2. 선물 카테고리 CRUD 페이지 프롬프트
+## 2. 받을 주소 설정 페이지 프롬프트
+
+```text
+관리자 선물 받을 주소 설정 페이지를 구현해줘.
+
+목표:
+- 관리자 메뉴 `선물함 관리 > 받을 주소`에서 팬이 선물을 보낼 전역 단일 주소를 조회하고 저장한다.
+- 이 주소는 팬의 선물 상세 API에서 운송장 등록 전 상태일 때 `mailbox`로 노출된다.
+- 기존 관리자 페이지의 폼, 저장 버튼, 토스트, 에러 표시 패턴을 그대로 따른다.
+
+라우트:
+- `/gift/mailbox`
+
+필수 화면 구성:
+- 상단 제목: `받을 주소`
+- 설명 문구: `팬이 선물을 발송할 때 확인하는 받을 주소입니다.`
+- 입력 폼:
+  - 받을 사람 이름 `name`
+  - 연락처 `phoneNumber`
+  - 우편번호 `zipCode`
+  - 주소 `address`
+  - 상세주소 `addressDetail`
+- 저장 버튼: `저장`
+
+초기 조회 API:
+- Method: `GET`
+- URL: `/api/v2/admin/gift-mailbox`
+- response `data`:
+```ts
+type AdminGiftMailboxResponse = {
+  name: string;
+  address: string;
+  phoneNumber: string;
+} | null;
+```
+- `data`가 null이면 빈 폼을 표시한다.
+
+저장 API:
+- Method: `PUT`
+- URL: `/api/v2/admin/gift-mailbox`
+- Request:
+```ts
+type AdminGiftMailboxRequest = {
+  name: string;
+  phoneNumber: string;
+  zipCode: string;
+  address: string;
+  addressDetail: string | null;
+};
+```
+- Response `data`:
+```ts
+type AdminGiftMailboxResponse = {
+  name: string;
+  address: string;
+  phoneNumber: string;
+};
+```
+
+Validation:
+- `name`, `phoneNumber`, `zipCode`, `address`는 필수다.
+- 공백만 입력할 수 없다.
+- 저장 실패 시 기존 관리자 페이지의 공통 에러 표시 방식을 따른다.
+
+저장 성공 UX:
+- 성공 토스트를 표시한다.
+- 저장 API response 기준으로 화면 값을 갱신한다.
+- `address`는 서버가 조립한 `(우편번호) 주소, 상세주소` 형식으로 표시해도 되고, 입력 필드는 사용자가 입력한 값을 유지해도 된다.
+
+테스트/검증:
+- 초기 조회 시 null이면 빈 폼을 표시하는지 확인한다.
+- 저장 시 PUT body가 정확히 전달되는지 확인한다.
+- 필수값 공백 validation을 확인한다.
+```
+
+---
+
+## 3. 선물 카테고리 CRUD 페이지 프롬프트
 
 ```text
 관리자 선물 카테고리 CRUD 페이지를 구현해줘.
@@ -345,7 +423,7 @@ UX 요구사항:
 
 ---
 
-## 3. 선물 사이즈 가격 CRUD 페이지 프롬프트
+## 4. 선물 사이즈 가격 CRUD 페이지 프롬프트
 
 ```text
 관리자 선물 사이즈 가격 CRUD 페이지를 구현해줘.
@@ -464,7 +542,8 @@ type GiftSize = "SMALL" | "MEDIUM" | "LARGE";
 
 1. API client 함수와 TypeScript 타입을 먼저 추가한다.
 2. `/gift/list` 선물함 리스트와 상세/상태변경 모달을 구현한다.
-3. `/gift/category` 카테고리 CRUD를 구현한다.
-4. `/gift/size` 사이즈 가격 수정 화면을 구현한다.
-5. 기존 관리자 메뉴의 `선물함 관리` 하위 route와 연결되는지 확인한다.
-6. 각 페이지별 loading/empty/error/success 상태를 확인한다.
+3. `/gift/mailbox` 받을 주소 설정 화면을 구현한다.
+4. `/gift/category` 카테고리 CRUD를 구현한다.
+5. `/gift/size` 사이즈 가격 수정 화면을 구현한다.
+6. 기존 관리자 메뉴의 `선물함 관리` 하위 route와 연결되는지 확인한다.
+7. 각 페이지별 loading/empty/error/success 상태를 확인한다.