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

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

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

@@ -4,28 +4,30 @@
 
 use App\Helpers\ApiResponse;
 use App\Http\Controllers\Controller;
+use App\Http\Requests\Authz\RoleIndexRequest;
+use App\Http\Requests\Authz\RoleStoreRequest;
+use App\Http\Requests\Authz\RoleUpdateRequest;
 use App\Services\Authz\RoleService;
-use Illuminate\Http\Request;
 
 class RoleController extends Controller
 {
     /**
      * 역할 목록 조회
      */
-    public function index(Request $request)
+    public function index(RoleIndexRequest $request)
     {
         return ApiResponse::handle(function () use ($request) {
-            return RoleService::index($request->all());
+            return RoleService::index($request->validated());
         }, __('message.fetched'));
     }
 
     /**
      * 역할 생성
      */
-    public function store(Request $request)
+    public function store(RoleStoreRequest $request)
     {
         return ApiResponse::handle(function () use ($request) {
-            return RoleService::store($request->all());
+            return RoleService::store($request->validated());
         }, __('message.created'));
     }
 
@@ -42,10 +44,10 @@ public function show($id)
     /**
      * 역할 수정
      */
-    public function update(Request $request, $id)
+    public function update(RoleUpdateRequest $request, $id)
     {
         return ApiResponse::handle(function () use ($request, $id) {
-            return RoleService::update((int) $id, $request->all());
+            return RoleService::update((int) $id, $request->validated());
         }, __('message.updated'));
     }