Skip to content

[issue]: 어드민 지역(region) 관리 페이지 구현 (FE) #245

@hyejj19

Description

@hyejj19

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
}
```

Metadata

Metadata

Assignees

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions