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

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

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

@@ -4,8 +4,8 @@
 
 use App\Helpers\ApiResponse;
 use App\Http\Controllers\Controller;
+use App\Http\Requests\Authz\UserRoleGrantRequest;
 use App\Services\Authz\UserRoleService;
-use Illuminate\Http\Request;
 
 class UserRoleController extends Controller
 {
@@ -13,27 +13,27 @@ public function index($id)
     {
         return ApiResponse::handle(function () use ($id) {
             return UserRoleService::list((int) $id);
-        }, '사용자의 역할 목록 조회');
+        }, __('message.fetched'));
     }
 
-    public function grant($id, Request $request)
+    public function grant($id, UserRoleGrantRequest $request)
     {
         return ApiResponse::handle(function () use ($id, $request) {
-            return UserRoleService::grant((int) $id, $request->all());
-        }, '사용자에게 역할 부여');
+            return UserRoleService::grant((int) $id, $request->validated());
+        }, __('message.updated'));
     }
 
-    public function revoke($id, Request $request)
+    public function revoke($id, UserRoleGrantRequest $request)
     {
         return ApiResponse::handle(function () use ($id, $request) {
-            return UserRoleService::revoke((int) $id, $request->all());
-        }, '사용자의 역할 회수');
+            return UserRoleService::revoke((int) $id, $request->validated());
+        }, __('message.updated'));
     }
 
-    public function sync($id, Request $request)
+    public function sync($id, UserRoleGrantRequest $request)
     {
         return ApiResponse::handle(function () use ($id, $request) {
-            return UserRoleService::sync((int) $id, $request->all());
-        }, '사용자의 역할 동기화');
+            return UserRoleService::sync((int) $id, $request->validated());
+        }, __('message.updated'));
     }
 }