HeuJung
71abdeaf60
위임 관리자(부관리자)가 권한·역할·표현식·비밀 콘텐츠 경계를 우회하던 결함군을 계층 대칭성 원칙으로 전건 차단한다. 약한 경로가 정상 응답을 내보내는 것이 유일한 증상이라, 게이트를 생산 지점 한 곳(SSoT)에 두고 같은 데이터를 내보내는 소비 경로 전부가 그 게이트를 경유하도록 맞췄다. - 등급 상한(rank ceiling): 슈퍼관리자 보호·역할/사용자 역할 배정(추가·제거 대칭)·일괄 상태변경·순서변경을 상세 경로와 동일 강도로 재적용. 가드는 DB 쓰기에 선행하여 거부 시 상태 불변. - 레이아웃 표현식: new Function/with 실행을 AST 화이트리스트 평가기로 교체. 비-문자열 computed 키 정규화(normalizeKey)·Object facade(리플렉션 static 제거)·legacy 접근자 차단. 저장측 검증·정적 검사와 3계층 동형. - secret 게이트: 비밀글의 댓글·첨부·문의 독립 경로 재적용, hash 파일서빙 소유권·비밀·발행 상태 검사 통일. - 신뢰 스크립트 호스트: 확장 선언 기반 + same-origin 브라우저 정규화를 런타임·저장측·정적검사 3층 동형화. - 회귀 감지: 단위·Feature·E2E·시나리오 매니페스트 전축 + audit 룰 4종 신설.
286 lines
10 KiB
PHP
286 lines
10 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\Auth\Access\AuthorizationException;
|
|
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 (AuthorizationException $e) {
|
|
// 스코프 밖 메뉴가 포함된 경우. 제네릭 catch 보다 앞에 둬야 인가 거부가 500 으로
|
|
// 뭉개지지 않고 상세 경로(403)와 같은 응답이 된다.
|
|
return $this->error('auth.scope_denied', 403, $e->getMessage());
|
|
} 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());
|
|
}
|
|
}
|
|
}
|