kasy-cli 1.37.0 → 1.38.0

package/templates/firebase/lib/i18n/en.i18n.json

@@ -12,9 +12,10 @@
             "overview": "Overview",
             "users": "Users",
             "requests": "Requests",
-            "kit": "Kit",
-            "tools": "Tools"
+            "tools": "Tools",
+            "debug": "Debug"
         },
+        "back_to_app": "Back to app",
         "overview": {
             "section": "Project",
             "backend": "Backend",
@@ -74,11 +75,12 @@
             "cancel": "Cancel"
         },
         "groups": {
+            "actions": "Actions",
             "features": "Features",
-            "showcase": "Showcase",
             "preview": "Preview",
             "debug_actions": "Debug actions",
-            "identity": "Identity"
+            "identity": "Identity",
+            "notification_test": "Notification test"
         },
         "settings_entry": {
             "title": "Admin",
@@ -452,8 +454,8 @@
         "specificDate": "Specific date",
         "timeLabel": "Time",
         "dayLabel": "Day of week",
-        "dateLabel": "Date and time",
-        "selectDate": "Select date and time"
+        "dateLabel": "Date",
+        "selectDate": "Select date"
     },
     "dailyReminder": {
         "title": "Reminder",
@@ -600,7 +602,13 @@
             "send_push_preview_now": "now",
             "send_push_preview_title_placeholder": "Notification title",
             "send_push_preview_body_placeholder": "Your message body shows here",
-            "device_preview_title": "Device Preview (web only)"
+            "device_preview_title": "Device Preview (web only)",
+            "send_push_section_recipients": "Recipients",
+            "send_push_section_content": "Content",
+            "send_push_section_advanced": "Advanced",
+            "send_push_audience_all": "Everyone",
+            "send_push_audience_specific": "Specific",
+            "send_push_audience_all_hint": "The notification will be sent to every subscribed user."
         }
     },
     "rate_banner": {
@@ -619,6 +627,7 @@
         "push_subtitle_disabled": "Tap to enable in Settings",
         "push_subtitle_waiting": "Enable to stay in the loop",
         "mark_all_read": "Mark as read",
+        "see_all": "See all",
         "group_today": "Today",
         "group_yesterday": "Yesterday",
         "group_older": "Older",
@@ -684,7 +693,10 @@
         "copyForAi": "Copy for AI",
         "selectWidgetFirst": "Select a widget on screen first, then tap Copy.",
         "inspectorHint": "Tap the UI to select a widget (purple outline). Then copy for your AI prompt.",
-        "statusActive": "Inspecting"
+        "statusActive": "Inspecting",
+        "fieldSize": "Size",
+        "fieldColor": "Color",
+        "copyJson": "Copy JSON"
     },
     "webDevicePreview": {
         "frame": "Frame",
@@ -692,7 +704,9 @@
         "darkTheme": "Dark theme",
         "landscape": "Landscape",
         "textScale": "Text scale",
-        "screenshot": "Screenshot"
+        "screenshot": "Screenshot",
+        "imageCopied": "Image copied — paste it in chat",
+        "imageDownloaded": "Image downloaded"
     },
     "biometric_prompt": {
         "title_ios_face": "Turn on Face ID for App Lock?",

package/templates/firebase/lib/i18n/es.i18n.json

@@ -12,9 +12,10 @@
             "overview": "Resumen",
             "users": "Usuarios",
             "requests": "Solicitudes",
-            "kit": "Kit",
-            "tools": "Herramientas"
+            "tools": "Herramientas",
+            "debug": "Depuración"
         },
+        "back_to_app": "Volver a la app",
         "overview": {
             "section": "Proyecto",
             "backend": "Backend",
@@ -74,11 +75,12 @@
             "cancel": "Cancelar"
         },
         "groups": {
+            "actions": "Acciones",
             "features": "Funciones",
-            "showcase": "Vitrina",
             "preview": "Vista previa",
             "debug_actions": "Acciones de debug",
-            "identity": "Identidad"
+            "identity": "Identidad",
+            "notification_test": "Prueba de notificación"
         },
         "settings_entry": {
             "title": "Admin",
@@ -452,8 +454,8 @@
         "specificDate": "Fecha específica",
         "timeLabel": "Hora",
         "dayLabel": "Día de la semana",
-        "dateLabel": "Fecha y hora",
-        "selectDate": "Seleccionar fecha y hora"
+        "dateLabel": "Fecha",
+        "selectDate": "Seleccionar fecha"
     },
     "dailyReminder": {
         "title": "Recordatorio",
@@ -600,7 +602,13 @@
             "send_push_preview_now": "ahora",
             "send_push_preview_title_placeholder": "Título de la notificación",
             "send_push_preview_body_placeholder": "El cuerpo del mensaje aparece aquí",
-            "device_preview_title": "Device Preview (solo web)"
+            "device_preview_title": "Device Preview (solo web)",
+            "send_push_section_recipients": "Destinatarios",
+            "send_push_section_content": "Contenido",
+            "send_push_section_advanced": "Avanzado",
+            "send_push_audience_all": "Todos",
+            "send_push_audience_specific": "Específicos",
+            "send_push_audience_all_hint": "La notificación se enviará a todos los usuarios suscritos."
         }
     },
     "rate_banner": {
@@ -619,6 +627,7 @@
         "push_subtitle_disabled": "Toca para activar en Configuración",
         "push_subtitle_waiting": "Activa para no perderte nada",
         "mark_all_read": "Marcar leídas",
+        "see_all": "Ver todas",
         "group_today": "Hoy",
         "group_yesterday": "Ayer",
         "group_older": "Más antiguas",
@@ -684,7 +693,10 @@
         "copyForAi": "Copiar para IA",
         "selectWidgetFirst": "Selecciona un widget en pantalla primero y luego toca Copiar.",
         "inspectorHint": "Toca la interfaz para seleccionar (borde morado). Luego copia para tu prompt de IA.",
-        "statusActive": "Inspeccionando"
+        "statusActive": "Inspeccionando",
+        "fieldSize": "Tamaño",
+        "fieldColor": "Color",
+        "copyJson": "Copiar JSON"
     },
     "webDevicePreview": {
         "frame": "Frame",
@@ -692,7 +704,9 @@
         "darkTheme": "Tema oscuro",
         "landscape": "Horizontal",
         "textScale": "Escala de texto",
-        "screenshot": "Captura de pantalla"
+        "screenshot": "Captura de pantalla",
+        "imageCopied": "Imagen copiada — pégala en el chat",
+        "imageDownloaded": "Imagen descargada"
     },
     "biometric_prompt": {
         "title_ios_face": "¿Activar Face ID en el bloqueo?",

package/templates/firebase/lib/i18n/pt.i18n.json

@@ -12,9 +12,10 @@
             "overview": "Visão geral",
             "users": "Usuários",
             "requests": "Solicitações",
-            "kit": "Kit",
-            "tools": "Ferramentas"
+            "tools": "Ferramentas",
+            "debug": "Depuração"
         },
+        "back_to_app": "Voltar ao app",
         "overview": {
             "section": "Projeto",
             "backend": "Backend",
@@ -74,11 +75,12 @@
             "cancel": "Cancelar"
         },
         "groups": {
+            "actions": "Ações",
             "features": "Recursos",
-            "showcase": "Vitrine",
             "preview": "Preview",
             "debug_actions": "Ações de debug",
-            "identity": "Identidade"
+            "identity": "Identidade",
+            "notification_test": "Teste de notificação"
         },
         "settings_entry": {
             "title": "Admin",
@@ -452,8 +454,8 @@
         "specificDate": "Data específica",
         "timeLabel": "Horário",
         "dayLabel": "Dia da semana",
-        "dateLabel": "Data e hora",
-        "selectDate": "Selecionar data e hora"
+        "dateLabel": "Data",
+        "selectDate": "Selecionar data"
     },
     "dailyReminder": {
         "title": "Lembrete",
@@ -600,7 +602,13 @@
             "send_push_preview_now": "agora",
             "send_push_preview_title_placeholder": "Título da notificação",
             "send_push_preview_body_placeholder": "O corpo da mensagem aparece aqui",
-            "device_preview_title": "Device Preview (somente web)"
+            "device_preview_title": "Device Preview (somente web)",
+            "send_push_section_recipients": "Destinatários",
+            "send_push_section_content": "Conteúdo",
+            "send_push_section_advanced": "Avançado",
+            "send_push_audience_all": "Todos",
+            "send_push_audience_specific": "Específicos",
+            "send_push_audience_all_hint": "A notificação será enviada para todos os usuários inscritos."
         }
     },
     "rate_banner": {
@@ -619,6 +627,7 @@
         "push_subtitle_disabled": "Toque para ativar nas configurações",
         "push_subtitle_waiting": "Ative para não perder novidades",
         "mark_all_read": "Marcar lidas",
+        "see_all": "Ver todas",
         "group_today": "Hoje",
         "group_yesterday": "Ontem",
         "group_older": "Mais antigas",
@@ -684,7 +693,10 @@
         "copyForAi": "Copiar para IA",
         "selectWidgetFirst": "Selecione um widget na tela primeiro e depois toque em Copiar.",
         "inspectorHint": "Toque na interface para selecionar (contorno roxo). Depois copie para usar na IA.",
-        "statusActive": "Inspecionando"
+        "statusActive": "Inspecionando",
+        "fieldSize": "Tamanho",
+        "fieldColor": "Cor",
+        "copyJson": "Copiar JSON"
     },
     "webDevicePreview": {
         "frame": "Frame",
@@ -692,7 +704,9 @@
         "darkTheme": "Tema escuro",
         "landscape": "Paisagem",
         "textScale": "Escala de texto",
-        "screenshot": "Screenshot"
+        "screenshot": "Screenshot",
+        "imageCopied": "Imagem copiada — cole no chat",
+        "imageDownloaded": "Imagem baixada"
     },
     "biometric_prompt": {
         "title_ios_face": "Ativar Face ID no bloqueio do app?",

package/templates/firebase/lib/router.dart

@@ -26,9 +26,7 @@ import 'package:kasy_kit/features/local_reminders/ui/reminder_page.dart';
 import 'package:kasy_kit/features/onboarding/ui/onboarding_page.dart';
 import 'package:kasy_kit/features/settings/ui/components/admin/admin_home_widgets.dart';
 import 'package:kasy_kit/features/settings/ui/components/admin/admin_page.dart';
-import 'package:kasy_kit/features/settings/ui/components/admin/admin_paywalls.dart';
 import 'package:kasy_kit/features/settings/ui/components/admin/admin_routes.dart';
-import 'package:kasy_kit/features/settings/ui/components/admin/send_push_notification_page.dart';
 import 'package:kasy_kit/features/subscriptions/ui/component/premium_page_factory.dart';
 import 'package:kasy_kit/features/subscriptions/ui/premium_page.dart';
 import 'package:logger/logger.dart';
@@ -71,6 +69,16 @@ String? _authRedirect(Ref ref, GoRouterState state) {
   // redirect yet — we re-run once the state resolves (refresh listenable).
   if (user.isLoading) return null;
 
+  // Admin area is role-gated at the ROUTING layer (URLs included), not just by
+  // hiding UI: in production, /admin and every /admin/* section open only for an
+  // authenticated admin (role == "admin"). Anyone else — including someone who
+  // types the URL directly — is bounced home. Open in debug for development.
+  // This sits on top of the server-side data rules that ultimately protect the
+  // data; here it guarantees the screens themselves are never even reachable.
+  if (state.uri.path.startsWith('/admin') && !kDebugMode && !user.isAdmin) {
+    return '/';
+  }
+
   final String loc = state.matchedLocation;
   final bool onAuthRoute = _authRoutes.contains(loc);
   final bool onboardingDone = ref
@@ -296,25 +304,42 @@ GoRouter generateRouter({
           child: const RecoverPasswordPage(),
         ),
       ),
-      // Admin console: registered always so administrators reach it in release
-      // builds too. Access is gated inside AdminPage (admin role || debug).
-      GoRoute(
-        name: 'admin',
-        path: '/admin',
-        pageBuilder: (context, state) => kasyTransitionPage(
+      // Admin console: a StatefulShellRoute so every section is a real,
+      // URL-addressable screen that keeps its own state while the navigation
+      // rail persists across them. The top-level sections (/admin, /admin/users,
+      // /admin/requests) and the four "Ferramentas" sub-screens (/admin/tools/*)
+      // are ALL branches — each its own URL, reached from the sidebar. Registered
+      // always (admins reach it in release too); the redirect above blocks
+      // /admin* for non-admins in production. adminSections() is the single
+      // source the sidebar reads too, so branches and nav rows stay aligned (the
+      // debug-only sections drop out of both together).
+      StatefulShellRoute.indexedStack(
+        // Enter /admin with the app's standard page transition
+        // (KasyNavigationConfig.push), same as every other route — pageBuilder
+        // (not builder), otherwise go_router falls back to its default platform
+        // transition. Switching sections is instant (IndexedStack), like tabs.
+        pageBuilder: (context, state, navigationShell) => kasyTransitionPage(
           key: state.pageKey,
-          child: const AdminPage(),
+          child: AdminShell(navigationShell: navigationShell),
         ),
+        branches: [
+          for (final section in adminSections())
+            StatefulShellBranch(
+              routes: [
+                GoRoute(
+                  path: section.path,
+                  pageBuilder: (context, state) => kasyTransitionPage(
+                    key: state.pageKey,
+                    child: section.build(),
+                  ),
+                ),
+              ],
+            ),
+        ],
       ),
+      // Drill-downs pushed full-screen from inside the console (their own back
+      // button), debug-only — the redirect above keeps /admin* admin-only.
       if (kDebugMode) ...[
-        GoRoute(
-          name: 'admin_paywalls',
-          path: adminRoutePaywalls,
-          pageBuilder: (context, state) => kasyTransitionPage(
-            key: state.pageKey,
-            child: const AdminPaywalls(),
-          ),
-        ),
         GoRoute(
           name: 'admin_home_widgets',
           path: adminRouteHomeWidgets,
@@ -323,6 +348,7 @@ GoRouter generateRouter({
             child: const AdminHomeWidgets(),
           ),
         ),
+        // Paywall variant preview — pushed from the Paywalls section.
         GoRoute(
           name: 'admin_premium_preview',
           path: '/admin/premium/:variant',
@@ -343,14 +369,6 @@ GoRouter generateRouter({
           },
         ),
       ],
-      GoRoute(
-        name: 'send_push',
-        path: adminRouteSendPush,
-        pageBuilder: (context, state) => kasyTransitionPage(
-          key: state.pageKey,
-          child: const SendPushNotificationPage(),
-        ),
-      ),
       GoRoute(
         name: '404',
         path: '/404',

package/templates/firebase/pubspec.yaml

@@ -16,7 +16,7 @@ publish_to: 'none' # Remove this line if you wish to publish to pub.dev
 # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
 # In Windows, build-name is used as the major, minor, and patch parts
 # of the product and file versions while build-number is used as the build suffix.
-version: 1.0.0+57
+version: 1.0.0+60
 
 environment:
   sdk: ^3.11.0

package/templates/firebase/test/admin_shell_chrome_test.dart

@@ -0,0 +1,104 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:go_router/go_router.dart';
+import 'package:kasy_kit/components/kasy_sidebar.dart';
+import 'package:kasy_kit/components/kasy_web_header.dart';
+import 'package:kasy_kit/core/data/models/user.dart';
+import 'package:kasy_kit/core/states/models/user_state.dart';
+import 'package:kasy_kit/features/settings/ui/components/admin/admin_page.dart';
+import 'package:kasy_kit/features/settings/ui/components/admin/admin_routes.dart';
+import 'package:kasy_kit/i18n/translations.g.dart';
+
+import 'test_utils.dart';
+
+/// Mirrors the real admin shell: every section (top-level AND the "Ferramentas"
+/// sub-screens) is its own branch, so they all share the same chrome and a
+/// persistent rail. Branch order/paths match [adminSections] so the shell's
+/// currentIndex lines up; the branch bodies are placeholders so the test stays
+/// focused on the chrome (sidebar + header), not on each page's providers.
+GoRouter _adminTestRouter(String initial) => GoRouter(
+  initialLocation: initial,
+  routes: [
+    GoRoute(path: '/', builder: (_, _) => const SizedBox()),
+    StatefulShellRoute.indexedStack(
+      builder: (c, s, shell) => AdminShell(navigationShell: shell),
+      branches: [
+        for (final section in adminSections())
+          StatefulShellBranch(
+            routes: [
+              GoRoute(
+                path: section.path,
+                builder: (_, _) =>
+                    Center(child: Text('section-${section.id.name}')),
+              ),
+            ],
+          ),
+      ],
+    ),
+  ],
+);
+
+UserState _adminUser() => UserState(
+  user: User.authenticated(
+    id: '1',
+    email: 'admin@email.com',
+    name: 'Admin',
+    onboarded: true,
+    role: 'admin',
+    creationDate: DateTime.now(),
+  ),
+);
+
+void main() {
+  testWidgets(
+    'admin section (desktop) renders the real KasySidebar + KasyWebHeader',
+    (tester) async {
+      tester.view.physicalSize = const Size(1400, 900);
+      tester.view.devicePixelRatio = 1.0;
+      addTearDown(tester.view.resetPhysicalSize);
+      addTearDown(tester.view.resetDevicePixelRatio);
+
+      await tester.pumpPage(
+        userState: _adminUser(),
+        routerConfig: _adminTestRouter('/admin'),
+      );
+      await tester.pump(const Duration(milliseconds: 300));
+
+      // The console uses the app's real chrome components, not a bespoke copy.
+      expect(find.byType(KasySidebar), findsOneWidget);
+      expect(find.byType(KasyWebHeader), findsOneWidget);
+      expect(find.text('section-overview'), findsOneWidget);
+    },
+  );
+
+  testWidgets(
+    'a Ferramentas sub-screen (desktop) is a real section: same rail + header, '
+    'submenu open',
+    (tester) async {
+      tester.view.physicalSize = const Size(1400, 900);
+      tester.view.devicePixelRatio = 1.0;
+      addTearDown(tester.view.resetPhysicalSize);
+      addTearDown(tester.view.resetDevicePixelRatio);
+
+      await tester.pumpPage(
+        userState: _adminUser(),
+        routerConfig: _adminTestRouter(adminRouteSendPush),
+      );
+      await tester.pump(const Duration(milliseconds: 300));
+
+      // Tools sub-screens get the SAME chrome as every other section now (the
+      // whole point of this change): the persistent rail AND the web header.
+      expect(find.byType(KasySidebar), findsOneWidget);
+      expect(find.byType(KasyWebHeader), findsOneWidget);
+      expect(find.text('section-sendPush'), findsOneWidget);
+
+      // The rail shows the "Ferramentas" group, auto-expanded because one of its
+      // children (Send push) is the active screen.
+      expect(find.text(t.admin_console.tabs.tools), findsOneWidget);
+      expect(
+        find.text(t.home.features_page.send_push_title),
+        findsWidgets,
+      );
+    },
+  );
+}

package/templates/firebase/test/features/authentication/data/api/user_api_fake.dart

@@ -83,4 +83,7 @@ class FakeUserApi implements UserApi {
   Future<void> updateLocale(String userId, String locale) {
     return Future.value();
   }
+
+  @override
+  Stream<String?> watchRole(String id) => const Stream.empty();
 }

package/templates/firebase/lib/features/settings/ui/components/admin/admin_paywalls.dart

@@ -1,53 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:go_router/go_router.dart';
-import 'package:kasy_kit/components/kasy_app_bar.dart';
-import 'package:kasy_kit/core/theme/theme.dart';
-import 'package:kasy_kit/core/widgets/kasy_scroll_behavior.dart';
-import 'package:kasy_kit/features/settings/ui/components/admin/admin_routes.dart';
-import 'package:kasy_kit/features/settings/ui/widgets/settings_tile.dart';
-import 'package:kasy_kit/features/subscriptions/ui/component/premium_page_factory.dart';
-import 'package:kasy_kit/i18n/translations.g.dart';
-
-class AdminPaywalls extends ConsumerWidget {
-  const AdminPaywalls({super.key});
-
-  @override
-  Widget build(BuildContext context, WidgetRef ref) {
-    return ScrollConfiguration(
-      behavior: const KasyKitScrollBehavior(),
-      child: KasyOverlayScaffold(
-        title: t.settings.admin.paywalls_title,
-        onBack: () => context.pop(),
-        slivers: [
-          SliverToBoxAdapter(
-            child: Container(
-              padding: const EdgeInsets.symmetric(
-                vertical: KasySpacing.smd,
-                horizontal: KasySpacing.md,
-              ),
-              decoration: BoxDecoration(
-                borderRadius: KasyRadius.smBorderRadius,
-                color: context.colors.surface,
-              ),
-              child: Wrap(
-                children: [
-                  for (final paywall in PaywallFactory.values) ...[
-                    SettingsTile(
-                      icon: KasyIcons.payment,
-                      title: paywall.name,
-                      onTap: () => context.push(
-                        adminRoutePremiumPreview(paywall.name),
-                      ),
-                    ),
-                    const SettingsDivider(),
-                  ],
-                ],
-              ),
-            ),
-          ),
-        ],
-      ),
-    );
-  }
-}