feat(app): add onboarding and harden alarms

lib/widgets/pluri_markdown.dart

@@ -0,0 +1,88 @@
+import 'package:flutter/material.dart';
+
+class PluriMarkdown extends StatelessWidget {
+  const PluriMarkdown(this.markdown, {super.key});
+
+  final String markdown;
+
+  @override
+  Widget build(BuildContext context) {
+    final widgets = <Widget>[];
+    for (final raw in markdown.split('\n')) {
+      final line = raw.trimRight();
+      if (line.trim().isEmpty) {
+        widgets.add(const SizedBox(height: 8));
+      } else if (line.startsWith('# ')) {
+        widgets.add(_Heading(line.substring(2), level: 1));
+      } else if (line.startsWith('## ')) {
+        widgets.add(_Heading(line.substring(3), level: 2));
+      } else if (line.startsWith('- ')) {
+        widgets.add(_Bullet(line.substring(2)));
+      } else if (!line.toLowerCase().startsWith('resumen:') &&
+          !line.toLowerCase().startsWith('summary:')) {
+        widgets.add(_Paragraph(line));
+      }
+    }
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: widgets,
+    );
+  }
+}
+
+class _Heading extends StatelessWidget {
+  const _Heading(this.text, {required this.level});
+
+  final String text;
+  final int level;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    return Padding(
+      padding: EdgeInsets.only(top: level == 1 ? 0 : 14, bottom: 8),
+      child: Text(
+        text,
+        style: (level == 1
+                ? theme.textTheme.headlineSmall
+                : theme.textTheme.titleMedium)
+            ?.copyWith(fontWeight: FontWeight.w900),
+      ),
+    );
+  }
+}
+
+class _Paragraph extends StatelessWidget {
+  const _Paragraph(this.text);
+
+  final String text;
+
+  @override
+  Widget build(BuildContext context) => Padding(
+    padding: const EdgeInsets.only(bottom: 8),
+    child: Text(text, style: Theme.of(context).textTheme.bodyMedium),
+  );
+}
+
+class _Bullet extends StatelessWidget {
+  const _Bullet(this.text);
+
+  final String text;
+
+  @override
+  Widget build(BuildContext context) => Padding(
+    padding: const EdgeInsets.only(bottom: 8),
+    child: Row(
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: [
+        Icon(
+          Icons.auto_awesome_rounded,
+          size: 18,
+          color: Theme.of(context).colorScheme.primary,
+        ),
+        const SizedBox(width: 8),
+        Expanded(child: Text(text)),
+      ],
+    ),
+  );
+}

lib/widgets/pluri_onboarding_dialog.dart

@@ -0,0 +1,198 @@
+import 'package:flutter/material.dart';
+
+import '../servicios/servicio_contenido_app.dart';
+import 'pluri_glass_surface.dart';
+import 'pluri_markdown.dart';
+
+class PluriOnboardingDialog {
+  PluriOnboardingDialog._();
+
+  static final _servicio = ServicioContenidoApp();
+
+  static Future<void> mostrarSiProcede(BuildContext context) async {
+    if (!await _servicio.debeMostrarInicio()) return;
+    if (!context.mounted) return;
+    await mostrar(context, soloPendientes: true);
+    await _servicio.marcarVisto();
+  }
+
+  static Future<void> mostrar(
+    BuildContext context, {
+    bool soloPendientes = false,
+  }) async {
+    final idioma = Localizations.localeOf(context).languageCode;
+    final contenido = await _servicio.cargar(
+      idioma,
+      soloPendientes: soloPendientes,
+    );
+    if (!context.mounted) return;
+    await showDialog<void>(
+      context: context,
+      barrierDismissible: false,
+      builder: (_) => _PluriOnboardingContent(contenido: contenido),
+    );
+  }
+}
+
+class _PluriOnboardingContent extends StatelessWidget {
+  const _PluriOnboardingContent({required this.contenido});
+
+  final ContenidoAyudaPluri contenido;
+
+  @override
+  Widget build(BuildContext context) {
+    final labels = _labels(Localizations.localeOf(context).languageCode);
+    final size = MediaQuery.sizeOf(context);
+    return Dialog(
+      insetPadding: const EdgeInsets.all(16),
+      backgroundColor: Colors.transparent,
+      child: ConstrainedBox(
+        constraints: BoxConstraints(
+          maxWidth: 720,
+          maxHeight: size.height * 0.86,
+        ),
+        child: PluriGlassSurface(
+          borderRadius: BorderRadius.circular(32),
+          glowColor: Theme.of(
+            context,
+          ).colorScheme.primary.withValues(alpha: 0.28),
+          child: Column(
+            children: [
+              Row(
+                children: [
+                  Container(
+                    width: 54,
+                    height: 54,
+                    decoration: BoxDecoration(
+                      shape: BoxShape.circle,
+                      gradient: LinearGradient(
+                        colors: [
+                          Theme.of(context).colorScheme.primary,
+                          Theme.of(context).colorScheme.tertiary,
+                        ],
+                      ),
+                    ),
+                    child: const Icon(
+                      Icons.graphic_eq_rounded,
+                      color: Colors.white,
+                    ),
+                  ),
+                  const SizedBox(width: 14),
+                  Expanded(
+                    child: Text(
+                      labels.title,
+                      style: Theme.of(context).textTheme.titleLarge?.copyWith(
+                        fontWeight: FontWeight.w900,
+                      ),
+                    ),
+                  ),
+                  IconButton(
+                    tooltip: labels.close,
+                    onPressed: () => Navigator.of(context).pop(),
+                    icon: const Icon(Icons.close_rounded),
+                  ),
+                ],
+              ),
+              const SizedBox(height: 12),
+              Expanded(
+                child: ListView(
+                  children: [
+                    if (contenido.onboarding.trim().isNotEmpty)
+                      PluriMarkdown(contenido.onboarding),
+                    if (contenido.notas.isNotEmpty) ...[
+                      const SizedBox(height: 18),
+                      Text(
+                        labels.news,
+                        style: Theme.of(context).textTheme.titleLarge?.copyWith(
+                          fontWeight: FontWeight.w900,
+                        ),
+                      ),
+                      const SizedBox(height: 8),
+                      for (final nota in contenido.notas)
+                        ExpansionTile(
+                          tilePadding: EdgeInsets.zero,
+                          title: Text('v${nota.version}'),
+                          subtitle:
+                              nota.resumen.isEmpty ? null : Text(nota.resumen),
+                          children: [
+                            Padding(
+                              padding: const EdgeInsets.only(bottom: 12),
+                              child: PluriMarkdown(nota.markdown),
+                            ),
+                          ],
+                        ),
+                    ],
+                  ],
+                ),
+              ),
+              const SizedBox(height: 12),
+              Align(
+                alignment: Alignment.centerRight,
+                child: FilledButton.icon(
+                  onPressed: () => Navigator.of(context).pop(),
+                  icon: const Icon(Icons.check_rounded),
+                  label: Text(labels.start),
+                ),
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+_OnboardingLabels _labels(String languageCode) {
+  return switch (languageCode) {
+    'es' => const _OnboardingLabels(
+      title: 'Bienvenido a PluriWave',
+      news: 'Novedades',
+      start: 'Empezar',
+      close: 'Cerrar',
+    ),
+    'fr' => const _OnboardingLabels(
+      title: 'Bienvenue sur PluriWave',
+      news: 'Nouveautés',
+      start: 'Commencer',
+      close: 'Fermer',
+    ),
+    'de' => const _OnboardingLabels(
+      title: 'Willkommen bei PluriWave',
+      news: 'Neuigkeiten',
+      start: 'Starten',
+      close: 'Schließen',
+    ),
+    'it' => const _OnboardingLabels(
+      title: 'Benvenuto in PluriWave',
+      news: 'Novità',
+      start: 'Inizia',
+      close: 'Chiudi',
+    ),
+    'pt' => const _OnboardingLabels(
+      title: 'Bem-vindo ao PluriWave',
+      news: 'Novidades',
+      start: 'Começar',
+      close: 'Fechar',
+    ),
+    _ => const _OnboardingLabels(
+      title: 'Welcome to PluriWave',
+      news: 'What’s new',
+      start: 'Start',
+      close: 'Close',
+    ),
+  };
+}
+
+class _OnboardingLabels {
+  const _OnboardingLabels({
+    required this.title,
+    required this.news,
+    required this.start,
+    required this.close,
+  });
+
+  final String title;
+  final String news;
+  final String start;
+  final String close;
+}