docs(gift): iOS 선물함 구현 프롬프트를 보강한다

This commit is contained in:
2026-10-08 17:38:56 +09:00
parent 5d8e71df83
commit f5f58e44f8
3 changed files with 631 additions and 15 deletions
@@ -177,6 +177,9 @@ Response `data` 예시:
"counterpartMemberId": 200,
"counterpartNickname": "달빛수집가",
"counterpartProfileImageUrl": "https://example.com/profile.png",
"recipientAddressRegistered": false,
"recipientAddressDeadlineAt": null,
"canceledAt": null,
"createdAt": "2026-09-18T03:00:00Z"
}
],
@@ -202,6 +205,9 @@ Response `data` 필드:
| `items[].counterpartMemberId` | number | 상대방 회원 ID. `SENT`에서는 받는 크리에이터, `RECEIVED`에서는 보낸 팬 |
| `items[].counterpartNickname` | string | 상대방 닉네임 |
| `items[].counterpartProfileImageUrl` | string 또는 null | 상대방 프로필 이미지 URL. 없으면 기본 프로필 이미지 표시 |
| `items[].recipientAddressRegistered` | boolean | 크리에이터 배송지 필수 정보가 모두 입력되었는지 여부 |
| `items[].recipientAddressDeadlineAt` | string 또는 null | `direction=RECEIVED`이고 배송지가 아직 입력되지 않은 경우의 배송지 입력 기한. 배송지 입력 완료 후에는 null |
| `items[].canceledAt` | string 또는 null | 취소 상태의 취소일. 취소되지 않은 선물은 null |
| `items[].createdAt` | string 또는 null | 신청일. UTC ISO 문자열 |
| `page` | number | 현재 페이지 |
| `size` | number | 페이지 크기 |
@@ -220,21 +226,11 @@ Response `data` 필드:
- `direction=SENT`에서는 받는 크리에이터 정보로 해석한다.
- `direction=RECEIVED`에서는 보낸 팬 정보로 해석한다.
현재 API만으로 부족한 Figma 표시값:
- 취소일 `canceledAt`
- 배송지 입력 마감일 또는 남은 일수
추가 API 보강이 가능하면 리스트 item에 아래 필드를 추가해달라고 요청한다.
```json
{
"canceledAt": "2026-09-18T03:00:00Z",
"recipientAddressDeadlineAt": "2026-09-25T03:00:00Z",
"sortAt": "2026-09-18T03:00:00Z"
}
```
- `canceledAt`: 취소 상태의 취소일 표시용
- `recipientAddressDeadlineAt`: 크리에이터 배송지 입력 안내 배너의 남은 일수 계산용
- `sortAt`: 신청/취소 최신순 정렬 기준. 취소 건은 취소일, 그 외에는 신청일
배송지/취소 표시 규칙:
- 배송지 입력 완료 여부는 `recipientAddressRegistered`로 판단한다.
- 배송지 입력 남은 기간은 `recipientAddressDeadlineAt` 기준으로 앱에서 계산한다.
- 배송지가 이미 입력되었으면 `recipientAddressDeadlineAt`은 null이다.
- 취소 상태의 날짜 라벨은 `canceledAt`이 있으면 `{canceledAt} 취소`로 표시하고, 그 외에는 `{createdAt} 신청`으로 표시한다.
로딩/에러/빈 상태:
- 최초 로딩 중에는 기존 앱 리스트 스켈레톤 또는 loading 패턴을 사용한다.