Files
sam-manage/app/Http/Controllers/Api/Admin/RoleController.php
hskwon 5f50716d7f feat: Phase 4-2 역할 관리 시스템 구현 (HTMX + API 패턴)
- RoleService, RoleController (Blade/API) 생성
- 역할 CRUD 기능 완성 (목록/생성/수정/삭제)
- FormRequest 검증 (StoreRoleRequest, UpdateRoleRequest)
- HTMX 패턴 적용 (index, create, edit)
- 권한 선택 UI (체크박스, 전체 선택/해제)
- Tenant Selector 통합
- 레이아웃 패턴 문서화 (LAYOUT_PATTERN.md)
- Sidebar 메뉴에 역할 관리 추가
- Pagination partial 컴포넌트 추가
- Tenants 레이아웃 100% 폭으로 통일

주요 수정:
- UpdateRoleRequest 라우트 파라미터 수정 (role → id)
- RoleController permissions 조회 시 description 제거
- Conditional tenant filtering 적용
2025-11-24 16:36:02 +09:00

143 lines
3.9 KiB
PHP

<?php
namespace App\Http\Controllers\Api\Admin;
use App\Http\Controllers\Controller;
use App\Http\Requests\StoreRoleRequest;
use App\Http\Requests\UpdateRoleRequest;
use App\Services\RoleService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
class RoleController extends Controller
{
public function __construct(
private readonly RoleService $roleService
) {}
/**
* 역할 목록 조회
*/
public function index(Request $request): JsonResponse
{
$roles = $this->roleService->getRoles(
$request->all(),
$request->integer('per_page', 15)
);
// HTMX 요청 시 HTML 반환
if ($request->header('HX-Request')) {
$html = view('roles.partials.table', compact('roles'))->render();
return response()->json([
'html' => $html,
]);
}
// 일반 요청 시 JSON 반환
return response()->json([
'success' => true,
'data' => $roles->items(),
'meta' => [
'current_page' => $roles->currentPage(),
'last_page' => $roles->lastPage(),
'per_page' => $roles->perPage(),
'total' => $roles->total(),
],
]);
}
/**
* 역할 생성
*/
public function store(StoreRoleRequest $request): JsonResponse
{
$role = $this->roleService->createRole($request->validated());
// HTMX 요청 시 성공 메시지와 리다이렉트 헤더 반환
if ($request->header('HX-Request')) {
return response()->json([
'success' => true,
'message' => '역할이 생성되었습니다.',
'redirect' => route('roles.index'),
]);
}
return response()->json([
'success' => true,
'message' => '역할이 생성되었습니다.',
'data' => $role,
], 201);
}
/**
* 특정 역할 조회
*/
public function show(Request $request, int $id): JsonResponse
{
$role = $this->roleService->getRoleById($id);
if (!$role) {
return response()->json([
'success' => false,
'message' => '역할을 찾을 수 없습니다.',
], 404);
}
// HTMX 요청 시 HTML 반환
if ($request->header('HX-Request')) {
return response()->json([
'html' => view('roles.partials.detail', compact('role'))->render(),
]);
}
return response()->json([
'success' => true,
'data' => $role,
]);
}
/**
* 역할 수정
*/
public function update(UpdateRoleRequest $request, int $id): JsonResponse
{
$this->roleService->updateRole($id, $request->validated());
// HTMX 요청 시 성공 메시지와 리다이렉트 헤더 반환
if ($request->header('HX-Request')) {
return response()->json([
'success' => true,
'message' => '역할이 수정되었습니다.',
'redirect' => route('roles.index'),
]);
}
return response()->json([
'success' => true,
'message' => '역할이 수정되었습니다.',
]);
}
/**
* 역할 삭제 (Soft Delete)
*/
public function destroy(Request $request, int $id): JsonResponse
{
$this->roleService->deleteRole($id);
// HTMX 요청 시 테이블 행 제거 트리거
if ($request->header('HX-Request')) {
return response()->json([
'success' => true,
'message' => '역할이 삭제되었습니다.',
'action' => 'remove',
]);
}
return response()->json([
'success' => true,
'message' => '역할이 삭제되었습니다.',
]);
}
}