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 문서를 보강했다

test/core/permissions/permission_manager_test.dart

@@ -1,10 +1,16 @@
 import 'package:flutter_test/flutter_test.dart';
 
+import 'package:superport_v2/core/config/environment.dart';
+import 'package:superport_v2/core/navigation/route_paths.dart';
 import 'package:superport_v2/core/permissions/permission_manager.dart';
 import 'package:superport_v2/core/permissions/permission_resources.dart';
 
 void main() {
   group('PermissionManager', () {
+    tearDown(() {
+      Environment.setTestPermissions({});
+    });
+
     test('서버 권한을 적용하면 해당 리소스 권한이 설정된다', () {
       final manager = PermissionManager();
 
@@ -58,7 +64,7 @@ void main() {
       );
     });
 
-    test('서버 권한을 초기화하면 환경 설정으로 되돌아간다', () {
+    test('서버 권한을 초기화하면 기본 거부로 되돌아간다', () {
       final manager = PermissionManager();
       manager.applyServerPermissions({
         PermissionResources.vendors: {PermissionAction.view},
@@ -70,11 +76,27 @@ void main() {
 
       manager.clearServerPermissions();
 
-      // 환경 설정에 권한이 명시되지 않으면 기본적으로 허용한다.
+      // 환경 설정에 권한이 없으면 기본적으로 거부한다.
       expect(
         manager.can(PermissionResources.vendors, PermissionAction.edit),
+        isFalse,
+      );
+    });
+
+    test('환경 권한을 명시하면 폴백을 허용한다', () {
+      Environment.setTestPermissions({
+        PermissionResources.vendors: {'view'},
+      });
+      final manager = PermissionManager();
+
+      expect(
+        manager.can(PermissionResources.vendors, PermissionAction.view),
         isTrue,
       );
+      expect(
+        manager.can(PermissionResources.vendors, PermissionAction.edit),
+        isFalse,
+      );
     });
 
     test('별칭 경로도 normalize되어 권한을 확인한다', () {
@@ -88,7 +110,7 @@ void main() {
         isTrue,
       );
       expect(
-        manager.can('/inventory/outbound', PermissionAction.edit),
+        manager.can(inventoryIssuesRoutePath, PermissionAction.edit),
         isFalse,
       );
     });

test/core/permissions/permission_resources_test.dart

@@ -15,6 +15,25 @@ void main() {
       );
     });
 
+    test('백엔드 menus.route_path 전부를 인식한다', () {
+      expect(
+        PermissionResources.normalize('/inventory/receipts'),
+        PermissionResources.stockTransactions,
+      );
+      expect(
+        PermissionResources.normalize('/inventory/vendors'),
+        PermissionResources.vendors,
+      );
+      expect(
+        PermissionResources.normalize('/settings/group-permissions'),
+        PermissionResources.groupMenuPermissions,
+      );
+      expect(
+        PermissionResources.normalize('/utilities/zipcodes'),
+        PermissionResources.postalSearch,
+      );
+    });
+
     test('대소문자/공백/슬래시를 정리한다', () {
       expect(
         PermissionResources.normalize('  inventory/inbound/  '),