who
어드민 프론트엔드
what
어드민에 지역(region)을 직접 관리할 수 있는 페이지가 필요합니다.
백엔드 API는 모두 구현 완료되어, 프론트엔드 구현만 남아있는 상태입니다.
필요한 화면 기능
- 지역 목록 조회 및 표시 (parentId 기반 부모/자식 관계 시각화)
- 지역 추가 폼 (한글명/영문명/설명/
parentId/sortOrder)
- 지역 정보 수정 폼
- 지역 삭제 (확인 다이얼로그)
- 지역 노출 순서(sortOrder) 변경 ← 핵심
- drag&drop 또는 단건 PATCH 방식 (curation
display-order 패턴 참고: PATCH /admin/api/v1/curations/{id}/display-order)
- 부모/자식 지역 관계 관리 UI (
parentId 설정)
백엔드 API (구현 완료 ✅)
AdminRegionController.kt에 모두 반영됨 (커밋 f670c47b, 4ba6c659).
| API |
Endpoint |
Method |
상태 |
| 목록 조회 |
/admin/api/v1/regions |
GET |
✅ |
| 상세 조회 |
/admin/api/v1/regions/{regionId} |
GET |
✅ |
| 생성 |
/admin/api/v1/regions |
POST |
✅ |
| 수정 |
/admin/api/v1/regions/{regionId} |
PUT |
✅ |
| 삭제 |
/admin/api/v1/regions/{regionId} |
DELETE |
✅ |
| 정렬 순서 변경 |
/admin/api/v1/regions/{regionId}/sort-order |
PATCH |
✅ |
API 명세 상세는 admin-api asciidoc 문서 (admin-reference/reference.adoc) 참고.
why
배경: 이슈 #235 (국가 카테고리 스코틀랜드 토글 UI 개선)에서 "지역 목록 순서를 피그마 디자인 기준으로 맞춰주세요"라는 요청이 나왔습니다.
현 상황
- product API `GET /api/v1/regions` 응답 스키마에 `sortOrder` 필드는 추가됨 (백엔드 PR 반영 완료)
- 그러나 모든 지역의 `sortOrder` 값이 `9999` (미설정 기본값) 상태
- 디자인 순서대로 정렬하려면 담당자가 직접 sortOrder 값을 조정할 UI가 필요
기대 효과
- 기획/운영 담당자가 디자인/마케팅 의도에 맞춰 지역 노출 순서를 직접 관리 가능
- 신규 위스키 생산 지역 추가 시 즉시 대응 가능 (현재는 백엔드 직접 DB 수정 필요)
- 부모-자식 관계도 어드민에서 관리 가능 (현재 product API 응답에 `parentId` 필드 추가됨)
관련 이슈
참고 — 현재 product API 응답 스키마
```json
{
"regionId": 1,
"korName": "스코틀랜드/로우랜드",
"engName": "Scotland/Lowlands",
"description": "...",
"parentId": 19,
"sortOrder": 9999
}
```
who
어드민 프론트엔드
what
어드민에 지역(region)을 직접 관리할 수 있는 페이지가 필요합니다.
백엔드 API는 모두 구현 완료되어, 프론트엔드 구현만 남아있는 상태입니다.
필요한 화면 기능
parentId/sortOrder)display-order패턴 참고:PATCH /admin/api/v1/curations/{id}/display-order)parentId설정)백엔드 API (구현 완료 ✅)
AdminRegionController.kt에 모두 반영됨 (커밋f670c47b,4ba6c659)./admin/api/v1/regions/admin/api/v1/regions/{regionId}/admin/api/v1/regions/admin/api/v1/regions/{regionId}/admin/api/v1/regions/{regionId}/admin/api/v1/regions/{regionId}/sort-orderAPI 명세 상세는 admin-api asciidoc 문서 (
admin-reference/reference.adoc) 참고.why
배경: 이슈 #235 (국가 카테고리 스코틀랜드 토글 UI 개선)에서 "지역 목록 순서를 피그마 디자인 기준으로 맞춰주세요"라는 요청이 나왔습니다.
현 상황
기대 효과
관련 이슈
참고 — 현재 product API 응답 스키마
```json
{
"regionId": 1,
"korName": "스코틀랜드/로우랜드",
"engName": "Scotland/Lowlands",
"description": "...",
"parentId": 19,
"sortOrder": 9999
}
```