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/features/inventory/summary/presentation/pages/inventory_summary_page_golden_test.dart

@@ -20,6 +20,8 @@ import 'package:superport_v2/features/inventory/summary/presentation/pages/inven
 import 'package:superport_v2/features/masters/warehouse/domain/entities/warehouse.dart';
 import 'package:superport_v2/features/masters/warehouse/domain/repositories/warehouse_repository.dart';
 
+import '../../../../../helpers/test_permissions.dart';
+
 class _MockInventoryRepository extends Mock implements InventoryRepository {}
 
 class _MockWarehouseRepository extends Mock implements WarehouseRepository {}
@@ -141,6 +143,7 @@ void _stubWarehouseList(_MockWarehouseRepository repository) {
 
 Future<void> _pumpInventoryPage(WidgetTester tester) async {
   await tester.binding.setSurfaceSize(const Size(1600, 1200));
+  addTearDown(() => tester.binding.setSurfaceSize(null));
   await tester.pumpWidget(
     _buildApp(
       InventorySummaryPage(
@@ -153,7 +156,7 @@ Future<void> _pumpInventoryPage(WidgetTester tester) async {
 }
 
 void main() {
-  final binding = TestWidgetsFlutterBinding.ensureInitialized();
+  TestWidgetsFlutterBinding.ensureInitialized();
 
   setUpAll(() {
     registerFallbackValue(const InventorySummaryFilter());
@@ -161,6 +164,7 @@ void main() {
   });
 
   setUp(() async {
+    grantTestPermissions(includeWrites: false);
     final inventoryRepository = _MockInventoryRepository();
     final warehouseRepository = _MockWarehouseRepository();
     _registerDependencies(
@@ -178,7 +182,6 @@ void main() {
   });
 
   tearDown(() async {
-    await binding.setSurfaceSize(null);
     await GetIt.I.reset();
   });
 

test/features/inventory/summary/presentation/pages/inventory_summary_page_test.dart

@@ -21,6 +21,8 @@ import 'package:superport_v2/features/inventory/summary/presentation/pages/inven
 import 'package:superport_v2/features/masters/warehouse/domain/entities/warehouse.dart';
 import 'package:superport_v2/features/masters/warehouse/domain/repositories/warehouse_repository.dart';
 
+import '../../../../../helpers/test_permissions.dart';
+
 class _MockInventoryRepository extends Mock implements InventoryRepository {}
 
 class _MockWarehouseRepository extends Mock implements WarehouseRepository {}
@@ -149,6 +151,11 @@ InventoryDetail _buildDetail() {
   );
 }
 
+Future<void> _tapVisible(WidgetTester tester, Finder finder) async {
+  await tester.ensureVisible(finder);
+  await tester.tap(finder);
+}
+
 void main() {
   TestWidgetsFlutterBinding.ensureInitialized();
 
@@ -157,6 +164,10 @@ void main() {
     registerFallbackValue(const InventoryDetailFilter());
   });
 
+  setUp(() {
+    grantTestPermissions();
+  });
+
   tearDown(() async {
     await GetIt.I.reset();
   });
@@ -201,7 +212,7 @@ void main() {
 
     expect(listCallCount, 2);
 
-    await tester.tap(find.bySemanticsLabel('자동 새로고침 전환'));
+    await _tapVisible(tester, find.bySemanticsLabel('자동 새로고침 전환'));
     await tester.pumpAndSettle();
 
     await tester.pump(const Duration(seconds: 31));
@@ -236,13 +247,16 @@ void main() {
     );
     await tester.pumpAndSettle();
 
-    await tester.tap(find.text('테스트 장비'));
+    await _tapVisible(tester, find.text('테스트 장비'));
     await tester.pumpAndSettle();
 
     expect(find.text('창고 잔량'), findsOneWidget);
     expect(find.byType(LinearProgressIndicator), findsWidgets);
     expect(find.text('최근 이벤트'), findsOneWidget);
-    expect(find.textContaining('거래처: QA 파트너'), findsOneWidget);
+    expect(
+      find.textContaining('거래처: QA 파트너'),
+      findsAtLeastNWidgets(1),
+    );
   });
 
   testWidgets('권한 오류가 발생하면 경고 배너를 노출한다', (tester) async {
@@ -311,7 +325,7 @@ void main() {
     );
     await tester.pump();
 
-    await tester.tap(find.byKey(const Key('inventory_filter_apply')));
+    await _tapVisible(tester, find.byKey(const Key('inventory_filter_apply')));
     await tester.pumpAndSettle();
 
     expect(capturedFilters.length, greaterThanOrEqualTo(2));
@@ -393,14 +407,14 @@ void main() {
 
     expect(recordedFilters, isNotEmpty);
     // 첫 정렬: 총 수량 헤더 탭 → 오름차순
-    await tester.tap(find.text('총 수량').first);
+    await _tapVisible(tester, find.text('총 수량').first);
     await tester.pumpAndSettle();
     final ascFilter = recordedFilters.last;
     expect(ascFilter.sort, 'total_quantity');
     expect(ascFilter.order, 'asc');
 
     // 두 번째 탭 → 내림차순
-    await tester.tap(find.text('총 수량').first);
+    await _tapVisible(tester, find.text('총 수량').first);
     await tester.pumpAndSettle();
     final descFilter = recordedFilters.last;
     expect(descFilter.sort, 'total_quantity');