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/data/dtos/menu_dto.dart

@@ -85,21 +85,35 @@ class MenuDto {
 
 /// 하위 메뉴 요약 정보를 담는 DTO.
 class MenuSummaryDto {
-  MenuSummaryDto({required this.id, required this.menuName});
+  MenuSummaryDto({
+    required this.id,
+    required this.menuName,
+    this.menuCode,
+    this.path,
+  });
 
   final int id;
   final String menuName;
+  final String? menuCode;
+  final String? path;
 
   /// JSON에서 요약 정보를 파싱한다.
   factory MenuSummaryDto.fromJson(Map<String, dynamic> json) {
     return MenuSummaryDto(
       id: json['id'] as int,
       menuName: json['menu_name'] as String,
+      menuCode: json['menu_code'] as String?,
+      path: json['path'] as String? ?? json['route_path'] as String?,
     );
   }
 
   /// DTO를 [MenuSummary] 엔티티로 변환한다.
-  MenuSummary toEntity() => MenuSummary(id: id, menuName: menuName);
+  MenuSummary toEntity() => MenuSummary(
+    id: id,
+    menuName: menuName,
+    menuCode: menuCode,
+    path: path,
+  );
 }
 
 /// 문자열/DateTime을 파싱해 [DateTime]으로 변환한다.

lib/features/masters/menu/domain/entities/menu.dart

@@ -79,10 +79,17 @@ class MenuItem {
 
 /// 상위 메뉴 요약 정보
 class MenuSummary {
-  MenuSummary({required this.id, required this.menuName});
+  MenuSummary({
+    required this.id,
+    required this.menuName,
+    this.menuCode,
+    this.path,
+  });
 
   final int id;
   final String menuName;
+  final String? menuCode;
+  final String? path;
 }
 
 /// 메뉴 생성/수정 입력 모델

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 재시도 버튼으로 처리하므로 무시한다.
+    }
+  }
 }

lib/features/masters/menu/presentation/pages/menu_page.dart

@@ -2,13 +2,14 @@ import 'package:flutter/material.dart';
 import 'package:get_it/get_it.dart';
 import 'package:shadcn_ui/shadcn_ui.dart';
 
-import 'package:superport_v2/core/constants/app_sections.dart';
+import 'package:superport_v2/core/navigation/route_paths.dart';
 import 'package:superport_v2/widgets/app_layout.dart';
 import 'package:superport_v2/widgets/components/filter_bar.dart';
 import 'package:superport_v2/widgets/components/superport_pagination_controls.dart';
 import 'package:superport_v2/widgets/components/superport_table.dart';
 
 import '../../../../../core/config/environment.dart';
+import '../../../../../core/navigation/menu_catalog.dart';
 import '../../../../../widgets/spec_page.dart';
 import '../../domain/entities/menu.dart';
 import '../../domain/repositories/menu_repository.dart';
@@ -107,12 +108,20 @@ class _MenuEnabledPageState extends State<_MenuEnabledPage> {
   final FocusNode _searchFocus = FocusNode();
   final DateFormat _dateFormat = DateFormat('yyyy-MM-dd HH:mm');
   String? _lastError;
+  bool _controllerInitialized = false;
 
   @override
-  void initState() {
-    super.initState();
-    _controller = menu.MenuController(repository: GetIt.I<MenuRepository>())
-      ..addListener(_handleControllerUpdate);
+  void didChangeDependencies() {
+    super.didChangeDependencies();
+    if (_controllerInitialized) {
+      return;
+    }
+    final catalog = MenuCatalogScope.of(context);
+    _controller = menu.MenuController(
+      repository: GetIt.I<MenuRepository>(),
+      catalog: catalog,
+    )..addListener(_handleControllerUpdate);
+    _controllerInitialized = true;
     WidgetsBinding.instance.addPostFrameCallback((_) async {
       await _controller.loadParents();
       await _controller.fetch();
@@ -133,8 +142,10 @@ class _MenuEnabledPageState extends State<_MenuEnabledPage> {
 
   @override
   void dispose() {
-    _controller.removeListener(_handleControllerUpdate);
-    _controller.dispose();
+    if (_controllerInitialized) {
+      _controller.removeListener(_handleControllerUpdate);
+      _controller.dispose();
+    }
     _searchController.dispose();
     _searchFocus.dispose();
     super.dispose();
@@ -166,7 +177,7 @@ class _MenuEnabledPageState extends State<_MenuEnabledPage> {
           subtitle: '메뉴 트리와 경로, 사용 상태를 관리합니다.',
           breadcrumbs: const [
             AppBreadcrumbItem(label: '대시보드', path: dashboardRoutePath),
-            AppBreadcrumbItem(label: '마스터', path: '/masters/menus'),
+            AppBreadcrumbItem(label: '마스터', path: settingsMenusRoutePath),
             AppBreadcrumbItem(label: '메뉴'),
           ],
           actions: [