feat(menu-permissions): 메뉴 API 연동으로 사이드바 권한 정비

- .env.development.example과 lib/core/config/environment.dart, lib/core/permissions/permission_manager.dart에서 PERMISSION__ 폴백을 view 전용으로 좁히고 기본 정책을 명시적으로 거부하도록 재정비했다

- lib/core/navigation/*, lib/core/routing/app_router.dart, lib/widgets/app_shell.dart, lib/main.dart에서 메뉴 매니페스트·카탈로그를 도입해 /menus 응답을 캐싱하고 라우터·사이드바·Breadcrumb가 동일 menu_code/route_path를 쓰도록 리팩터링했다

- lib/core/permissions/permission_resources.dart와 그룹 권한/메뉴 마스터 모듈을 menu_code 기반 CRUD 및 Catalog 경로 정합성 검사로 전환하고 PermissionSynchronizer·PermissionBootstrapper를 확장했다

- test/helpers/test_permissions.dart, test/widgets/app_shell_test.dart 등 신규 구조를 반영하는 테스트·골든과 doc/frontend_menu_permission_tasks.md 문서를 보강했다

lib/features/masters/menu/presentation/controllers/menu_controller.dart

@@ -1,4 +1,5 @@
 import 'package:flutter/foundation.dart';
+import 'package:superport_v2/core/navigation/menu_catalog.dart';
 import 'package:superport_v2/core/network/failure.dart';
 import 'package:superport_v2/core/common/models/paginated_result.dart';
 import 'package:superport_v2/core/common/utils/pagination_utils.dart';
@@ -14,10 +15,12 @@ enum MenuStatusFilter { all, activeOnly, inactiveOnly }
 /// - 목록, 필터, 페이지 상태를 관리한다.
 /// - CRUD 및 복구 요청을 처리한다.
 class MenuController extends ChangeNotifier {
-  MenuController({required MenuRepository repository})
-    : _repository = repository;
+  MenuController({required MenuRepository repository, MenuCatalog? catalog})
+    : _repository = repository,
+      _catalog = catalog;
 
   final MenuRepository _repository;
+  final MenuCatalog? _catalog;
 
   PaginatedResult<MenuItem>? _result;
   bool _isLoading = false;
@@ -42,17 +45,11 @@ class MenuController extends ChangeNotifier {
   List<MenuItem> get parents => _parents;
 
   /// 상위 메뉴 목록을 로드해 드롭다운에 표시한다.
-  Future<void> loadParents() async {
+  Future<void> loadParents({bool forceRefresh = false}) async {
     _isLoadingParents = true;
     notifyListeners();
     try {
-      final parents = await fetchAllPaginatedItems<MenuItem>(
-        request: (page, pageSize) => _repository.list(
-          page: page,
-          pageSize: pageSize,
-          includeDeleted: false,
-        ),
-      );
+      final parents = await _resolveParents(forceRefresh: forceRefresh);
       _parents = parents;
     } catch (error) {
       final failure = Failure.from(error);
@@ -133,6 +130,7 @@ class MenuController extends ChangeNotifier {
     try {
       final created = await _repository.create(input);
       await fetch(page: 1);
+      await _refreshCatalog();
       await loadParents();
       return created;
     } catch (error) {
@@ -151,6 +149,7 @@ class MenuController extends ChangeNotifier {
     try {
       final updated = await _repository.update(id, input);
       await fetch(page: _result?.page ?? 1);
+      await _refreshCatalog();
       await loadParents();
       return updated;
     } catch (error) {
@@ -169,6 +168,7 @@ class MenuController extends ChangeNotifier {
     try {
       await _repository.delete(id);
       await fetch(page: _result?.page ?? 1);
+      await _refreshCatalog();
       await loadParents();
       return true;
     } catch (error) {
@@ -187,6 +187,7 @@ class MenuController extends ChangeNotifier {
     try {
       final restored = await _repository.restore(id);
       await fetch(page: _result?.page ?? 1);
+      await _refreshCatalog();
       await loadParents();
       return restored;
     } catch (error) {
@@ -210,4 +211,31 @@ class MenuController extends ChangeNotifier {
     _isSubmitting = value;
     notifyListeners();
   }
+
+  Future<List<MenuItem>> _resolveParents({bool forceRefresh = false}) async {
+    final catalog = _catalog;
+    if (catalog != null) {
+      final menus = await catalog.ensureLoaded(forceRefresh: forceRefresh);
+      return menus.where((menu) => !menu.isDeleted).toList(growable: false);
+    }
+    return fetchAllPaginatedItems<MenuItem>(
+      request: (page, pageSize) => _repository.list(
+        page: page,
+        pageSize: pageSize,
+        includeDeleted: false,
+      ),
+    );
+  }
+
+  Future<void> _refreshCatalog() async {
+    final catalog = _catalog;
+    if (catalog == null) {
+      return;
+    }
+    try {
+      await catalog.refresh();
+    } catch (_) {
+      // 카탈로그 동기화 실패는 UI 재시도 버튼으로 처리하므로 무시한다.
+    }
+  }
 }