refactor: [authz] 역할/권한 API 품질 개선

- Validator::make를 FormRequest로 분리 (6개 생성)
- 하드코딩 한글 문자열을 i18n 키로 교체
- RoleMenuPermission 데드코드 제거
- Role 모델 SpatieRole 상속으로 일원화
- 권한 변경 후 캐시 무효화 추가 (AccessService::bumpVersion)
- 미문서화 8개 Swagger 엔드포인트 추가
- 역할/권한 라우트에 perm.map+permission 미들웨어 추가

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

@@ -4,37 +4,38 @@
 
 use App\Helpers\ApiResponse;
 use App\Http\Controllers\Controller;
+use App\Http\Requests\Authz\RolePermissionGrantRequest;
+use App\Http\Requests\Authz\RolePermissionToggleRequest;
 use App\Services\Authz\RolePermissionService;
-use Illuminate\Http\Request;
 
 class RolePermissionController extends Controller
 {
-    public function index($id, Request $request)
+    public function index($id)
     {
         return ApiResponse::handle(function () use ($id) {
             return RolePermissionService::list((int) $id);
-        }, '역할 퍼미션 목록 조회');
+        }, __('message.fetched'));
     }
 
-    public function grant($id, Request $request)
+    public function grant($id, RolePermissionGrantRequest $request)
     {
         return ApiResponse::handle(function () use ($id, $request) {
-            return RolePermissionService::grant((int) $id, $request->all());
-        }, '역할 퍼미션 부여');
+            return RolePermissionService::grant((int) $id, $request->validated());
+        }, __('message.updated'));
     }
 
-    public function revoke($id, Request $request)
+    public function revoke($id, RolePermissionGrantRequest $request)
     {
         return ApiResponse::handle(function () use ($id, $request) {
-            return RolePermissionService::revoke((int) $id, $request->all());
-        }, '역할 퍼미션 회수');
+            return RolePermissionService::revoke((int) $id, $request->validated());
+        }, __('message.updated'));
     }
 
-    public function sync($id, Request $request)
+    public function sync($id, RolePermissionGrantRequest $request)
     {
         return ApiResponse::handle(function () use ($id, $request) {
-            return RolePermissionService::sync((int) $id, $request->all());
-        }, '역할 퍼미션 동기화');
+            return RolePermissionService::sync((int) $id, $request->validated());
+        }, __('message.updated'));
     }
 
     /**
@@ -60,10 +61,10 @@ public function matrix($id)
     /**
      * 특정 메뉴의 특정 권한 토글
      */
-    public function toggle($id, Request $request)
+    public function toggle($id, RolePermissionToggleRequest $request)
     {
         return ApiResponse::handle(function () use ($id, $request) {
-            return RolePermissionService::toggle((int) $id, $request->all());
+            return RolePermissionService::toggle((int) $id, $request->validated());
         }, __('message.updated'));
     }