feat(API): 역할/권한 관리 API 개선

- RoleController: 역할 CRUD API 개선
- RolePermissionController: 역할별 권한 설정 API 추가
- RoleService/RolePermissionService: 비즈니스 로직 분리
- Role 모델: is_hidden 필드 추가 (시스템 역할 숨김)
- 역할 숨김 마이그레이션 추가

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

app/Http/Controllers/Api/V1/RoleController.php

@@ -9,38 +9,73 @@
 
 class RoleController extends Controller
 {
+    /**
+     * 역할 목록 조회
+     */
     public function index(Request $request)
     {
         return ApiResponse::handle(function () use ($request) {
             return RoleService::index($request->all());
-        }, '역할 목록 조회');
+        }, __('message.fetched'));
     }
 
+    /**
+     * 역할 생성
+     */
     public function store(Request $request)
     {
         return ApiResponse::handle(function () use ($request) {
             return RoleService::store($request->all());
-        }, '역할 생성');
+        }, __('message.created'));
     }
 
+    /**
+     * 역할 상세 조회
+     */
     public function show($id)
     {
         return ApiResponse::handle(function () use ($id) {
             return RoleService::show((int) $id);
-        }, '역할 상세 조회');
+        }, __('message.fetched'));
     }
 
+    /**
+     * 역할 수정
+     */
     public function update(Request $request, $id)
     {
         return ApiResponse::handle(function () use ($request, $id) {
             return RoleService::update((int) $id, $request->all());
-        }, '역할 수정');
+        }, __('message.updated'));
     }
 
+    /**
+     * 역할 삭제
+     */
     public function destroy($id)
     {
         return ApiResponse::handle(function () use ($id) {
             return RoleService::destroy((int) $id);
-        }, '역할 삭제');
+        }, __('message.deleted'));
+    }
+
+    /**
+     * 역할 통계 조회
+     */
+    public function stats()
+    {
+        return ApiResponse::handle(function () {
+            return RoleService::stats();
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 활성 역할 목록 (드롭다운용)
+     */
+    public function active()
+    {
+        return ApiResponse::handle(function () {
+            return RoleService::active();
+        }, __('message.fetched'));
     }
 }

app/Http/Controllers/Api/V1/RolePermissionController.php

@@ -36,4 +36,64 @@ public function sync($id, Request $request)
             return RolePermissionService::sync((int) $id, $request->all());
         }, '역할 퍼미션 동기화');
     }
+
+    /**
+     * 권한 매트릭스용 메뉴 트리 조회
+     */
+    public function menus()
+    {
+        return ApiResponse::handle(function () {
+            return RolePermissionService::menus();
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 역할의 권한 매트릭스 조회
+     */
+    public function matrix($id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return RolePermissionService::matrix((int) $id);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 특정 메뉴의 특정 권한 토글
+     */
+    public function toggle($id, Request $request)
+    {
+        return ApiResponse::handle(function () use ($id, $request) {
+            return RolePermissionService::toggle((int) $id, $request->all());
+        }, __('message.updated'));
+    }
+
+    /**
+     * 모든 권한 허용
+     */
+    public function allowAll($id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return RolePermissionService::allowAll((int) $id);
+        }, __('message.updated'));
+    }
+
+    /**
+     * 모든 권한 거부
+     */
+    public function denyAll($id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return RolePermissionService::denyAll((int) $id);
+        }, __('message.updated'));
+    }
+
+    /**
+     * 기본 권한으로 초기화 (view만 허용)
+     */
+    public function reset($id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return RolePermissionService::reset((int) $id);
+        }, __('message.updated'));
+    }
 }