HeuJung
b10e89bef0
목록 조회 성능 축(깊은 OFFSET·정렬·색인)과 그 검증 계층에서 계획서 전수검수와 3회에 걸친 감사가 지적한 항목을 처리했다. 세부 경위는 의 각 회차 문서에 있다. 검증 계층 — 컨트롤러가 base Request 를 직접 주입받던 확장 13곳을 전용 FormRequest 로 옮겼다. 옮기면서 기존 동작 계약은 그대로 두었다: 상한 초과 limit 을 거부하지 않고 상한까지 반환하던 공개 API, per_page 를 범위로 조정하던 관리자 목록, 미지원 period 를 year 로 해석하던 인기글 목록 모두 종전과 같은 응답을 낸다. 상한/폴백을 rules 로 승격시키면 200 이던 응답이 422 가 되어 기존 링크가 깨지므로, 규칙은 타입만 닫고 클램프·폴백은 접근자가 맡는다. period 는 접근자가 닫힌 집합만 반환해 캐시 키 공간도 함께 닫힌다. ckeditor5 이미지 업로드만 ResponseHelper 봉투를 쓰지 않는다. 응답을 파싱하는 주체가 CDN 으로 로드되는 상위 CKEditor5 43.3.1 의 SimpleUploadAdapter 라 규약을 바꿀 수 없어, 각 응답 지점에 사유를 명시한 면제를 부착하고 근거를 API 문서에 남겼다. 하네스 — 룰 5개의 대상 경로 패턴이 매처와 맞지 않아 번들 확장 컨트롤러가 검사 대상에서 통째로 빠져 있었다. 패턴을 고치자 확장 위반 17건이 드러나 전건 처리했다. severity 오타가 요약 집계 양쪽에 안 잡혀 "0 error" 로 보고되던 문제도 런너 사전 검증으로 막았다. 정렬 게이트 대조 하네스는 관계 정렬 변형만 쓰는 저장소를 탐지하지 못한 채 통과시키고 있었다. 탐지·제외·인자 파싱을 함께 고치고 단위 테스트를 신설했다.
281 lines
9.6 KiB
PHP
281 lines
9.6 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Controllers\Api\Admin;
|
|
|
|
use App\Enums\ExtensionOwnerType;
|
|
use App\Http\Controllers\Api\Base\AdminBaseController;
|
|
use App\Http\Requests\Menu\CreateMenuRequest;
|
|
use App\Http\Requests\Menu\MenuListRequest;
|
|
use App\Http\Requests\Menu\UpdateMenuOrderRequest;
|
|
use App\Http\Requests\Menu\UpdateMenuRequest;
|
|
use App\Http\Resources\MenuCollection;
|
|
use App\Http\Resources\MenuResource;
|
|
use App\Models\Menu;
|
|
use App\Services\MenuService;
|
|
use Illuminate\Http\JsonResponse;
|
|
use Illuminate\Support\Facades\Auth;
|
|
use Illuminate\Validation\ValidationException;
|
|
|
|
/**
|
|
* 관리자용 메뉴 컨트롤러
|
|
*
|
|
* 관리자가 시스템 메뉴를 생성, 수정, 삭제, 순서 변경할 수 있는 기능을 제공합니다.
|
|
*/
|
|
class MenuController extends AdminBaseController
|
|
{
|
|
public function __construct(
|
|
private MenuService $menuService
|
|
) {
|
|
parent::__construct();
|
|
}
|
|
|
|
/**
|
|
* 관리용 메뉴 목록을 조회합니다.
|
|
*
|
|
* @param MenuListRequest $request 목록 필터·정렬 요청
|
|
* @return JsonResponse 메뉴 컬렉션을 담은 JSON 응답
|
|
*/
|
|
public function index(MenuListRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$filters = $request->validated();
|
|
$user = Auth::user();
|
|
|
|
// 필터 유무와 무관하게 같은 경로로 조회한다. 예전에는 필터가 없으면 filters 를
|
|
// 받지 않는 메서드로 분기했는데, 그 경로는 sort_by/sort_order 를 통째로 버려
|
|
// "필터를 하나라도 걸어야 정렬이 먹는" 상태가 됐다 (#492 D-22).
|
|
$menus = $this->menuService->getFilteredMenusForManagement($filters, $user);
|
|
|
|
return $this->successWithResource(
|
|
'menu.fetch_success',
|
|
new MenuCollection($menus)
|
|
);
|
|
} catch (\Exception $e) {
|
|
return $this->error('menu.fetch_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 최상위 메뉴들을 계층 구조로 반환합니다.
|
|
*
|
|
* @return JsonResponse 계층 구조로 정리된 메뉴 데이터를 포함한 JSON 응답
|
|
*/
|
|
public function hierarchy(): JsonResponse
|
|
{
|
|
try {
|
|
$menuHierarchy = $this->menuService->getMenuHierarchy();
|
|
$collection = new MenuCollection($menuHierarchy);
|
|
|
|
// 계층 구조로 변환
|
|
$hierarchicalData = $collection->toNavigationArray();
|
|
|
|
return $this->success('menu.fetch_success', $hierarchicalData);
|
|
} catch (\Exception $e) {
|
|
return $this->error('menu.fetch_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 활성화된 메뉴들을 네비게이션용으로 반환합니다.
|
|
*
|
|
* @return JsonResponse 네비게이션용 메뉴 데이터를 포함한 JSON 응답
|
|
*/
|
|
public function active(): JsonResponse
|
|
{
|
|
try {
|
|
// 현재 사용자 정보 가져오기
|
|
$user = Auth::user();
|
|
|
|
if ($user) {
|
|
// 사용자가 접근 가능한 메뉴만 조회
|
|
$navigationMenus = $this->menuService->getAccessibleNavigationMenus($user);
|
|
} else {
|
|
// 사용자 정보가 없으면 모든 활성화된 메뉴 조회 (fallback)
|
|
$navigationMenus = $this->menuService->getNavigationMenus();
|
|
}
|
|
|
|
$collection = new MenuCollection($navigationMenus);
|
|
|
|
// 네비게이션용 계층 구조로 변환
|
|
$navigationData = $collection->toNavigationArray();
|
|
|
|
return $this->success('menu.fetch_success', $navigationData['data']);
|
|
} catch (\Exception $e) {
|
|
return $this->error('menu.active_fetch_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 새로운 메뉴를 생성합니다.
|
|
*
|
|
* @param CreateMenuRequest $request 메뉴 생성 요청 데이터
|
|
* @return JsonResponse 생성된 메뉴 정보를 포함한 JSON 응답
|
|
*/
|
|
public function store(CreateMenuRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$menu = $this->menuService->createMenu($request->validated());
|
|
$menu->load(['creator', 'parent', 'children', 'roles']);
|
|
|
|
return $this->successWithResource(
|
|
'menu.create_success',
|
|
new MenuResource($menu),
|
|
201
|
|
);
|
|
} catch (ValidationException $e) {
|
|
return $this->error('menu.create_failed', 422, $e->errors());
|
|
} catch (\Exception $e) {
|
|
return $this->error('menu.create_error', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 특정 메뉴의 상세 정보를 조회합니다.
|
|
*
|
|
* @param Menu $menu 조회할 메뉴 모델
|
|
* @return JsonResponse 메뉴 상세 정보를 포함한 JSON 응답
|
|
*/
|
|
public function show(Menu $menu): JsonResponse
|
|
{
|
|
try {
|
|
$menu->load(['creator', 'parent', 'children', 'roles']);
|
|
|
|
return $this->successWithResource(
|
|
'menu.fetch_success',
|
|
new MenuResource($menu)
|
|
);
|
|
} catch (\Exception $e) {
|
|
return $this->error('menu.fetch_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 기존 메뉴 정보를 업데이트합니다.
|
|
*
|
|
* @param UpdateMenuRequest $request 메뉴 업데이트 요청 데이터
|
|
* @param Menu $menu 업데이트할 메뉴 모델
|
|
* @return JsonResponse 업데이트된 메뉴 정보를 포함한 JSON 응답
|
|
*/
|
|
public function update(UpdateMenuRequest $request, Menu $menu): JsonResponse
|
|
{
|
|
try {
|
|
$result = $this->menuService->updateMenu($menu, $request->validated());
|
|
|
|
if ($result) {
|
|
$menu->refresh();
|
|
$menu->load(['creator', 'parent', 'children', 'roles']);
|
|
|
|
return $this->successWithResource(
|
|
'menu.update_success',
|
|
new MenuResource($menu)
|
|
);
|
|
} else {
|
|
return $this->error('menu.update_failed');
|
|
}
|
|
} catch (ValidationException $e) {
|
|
return $this->error('menu.update_failed', 422, $e->errors());
|
|
} catch (\Exception $e) {
|
|
return $this->error('menu.update_error', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 메뉴를 삭제합니다.
|
|
*
|
|
* @param Menu $menu 삭제할 메뉴 모델
|
|
* @return JsonResponse 삭제 결과 JSON 응답
|
|
*/
|
|
public function destroy(Menu $menu): JsonResponse
|
|
{
|
|
try {
|
|
$menuId = $menu->id;
|
|
$result = $this->menuService->deleteMenu($menu);
|
|
|
|
if ($result) {
|
|
return $this->success('menu.delete_success');
|
|
} else {
|
|
return $this->error('menu.delete_failed');
|
|
}
|
|
} catch (ValidationException $e) {
|
|
return $this->error('menu.delete_failed', 422, $e->errors());
|
|
} catch (\Exception $e) {
|
|
return $this->error('menu.delete_error', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 메뉴의 순서를 업데이트합니다 (드래그 앤 드롭).
|
|
*
|
|
* @param UpdateMenuOrderRequest $request 메뉴 순서 업데이트 요청 데이터
|
|
* @return JsonResponse 순서 업데이트 결과 JSON 응답
|
|
*/
|
|
public function updateOrder(UpdateMenuOrderRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$validatedData = $request->validated();
|
|
$result = $this->menuService->updateMenuOrderWithHierarchy($validatedData);
|
|
|
|
if ($result) {
|
|
return $this->success('menu.order_update_success');
|
|
} else {
|
|
return $this->error('menu.order_update_failed');
|
|
}
|
|
} catch (ValidationException $e) {
|
|
return $this->error('menu.order_update_failed', 422, $e->errors());
|
|
} catch (\Exception $e) {
|
|
return $this->error('menu.update_error', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 메뉴의 활성화 상태를 토글합니다.
|
|
*
|
|
* @param Menu $menu 대상 메뉴 모델
|
|
* @return JsonResponse 상태 변경된 메뉴 정보를 포함한 JSON 응답
|
|
*/
|
|
public function toggleStatus(Menu $menu): JsonResponse
|
|
{
|
|
try {
|
|
$result = $this->menuService->toggleMenuStatus($menu);
|
|
|
|
if ($result) {
|
|
$menu->refresh();
|
|
|
|
return $this->successWithResource(
|
|
'menu.update_success',
|
|
new MenuResource($menu)
|
|
);
|
|
} else {
|
|
return $this->error('menu.update_failed');
|
|
}
|
|
} catch (\Exception $e) {
|
|
return $this->error('menu.update_error', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 특정 확장에 속한 메뉴들을 조회합니다.
|
|
*
|
|
* @param string $type 확장 타입 (module, plugin)
|
|
* @param string $identifier 확장 식별자
|
|
* @return JsonResponse 확장에 속한 메뉴 목록을 포함한 JSON 응답
|
|
*/
|
|
public function getByExtension(string $type, string $identifier): JsonResponse
|
|
{
|
|
try {
|
|
$extensionType = ExtensionOwnerType::from($type);
|
|
|
|
$menus = $this->menuService->getMenusByExtension($extensionType, $identifier);
|
|
|
|
return $this->successWithResource(
|
|
'menu.fetch_success',
|
|
new MenuCollection($menus)
|
|
);
|
|
} catch (\ValueError $e) {
|
|
return $this->error('menu.invalid_extension_type', 422, $e->getMessage());
|
|
} catch (\Exception $e) {
|
|
return $this->error('menu.fetch_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
}
|