feat: Intégration d'un système complet d'alertes et de notifications par email

Cette mise à jour majeure introduit un système de notifications robuste, centré sur la création d'alertes et l'envoi d'emails via des Cloud Functions. Elle inclut la gestion des préférences utilisateur, la création automatique d'alertes lors d'événements critiques et une nouvelle interface dédiée. **Backend (Cloud Functions) :** - **Nouveau service d'alerting (`createAlert`, `processEquipmentValidation`) :** - `createAlert` : Nouvelle fonction pour créer une alerte. Elle détermine les utilisateurs à notifier (admins, workforce d'événement) et gère la persistance dans Firestore. - `processEquipmentValidation` : Endpoint appelé lors de la validation du matériel (chargement/déchargement). Il analyse l'état de l'équipement (`LOST`, `MISSING`, `DAMAGED`) et crée automatiquement les alertes correspondantes. - **Système d'envoi d'emails (`sendAlertEmail`, `sendDailyDigest`) :** - `sendAlertEmail` : Cloud Function `onCall` pour envoyer un email d'alerte individuel. Elle respecte les préférences de notification de l'utilisateur (canal email, type d'alerte). - `sendDailyDigest` : Tâche planifiée (tous les jours à 8h) qui envoie un email récapitulatif des alertes non lues des dernières 24 heures aux utilisateurs concernés. - Ajout de templates HTML (`base-template`, `alert-individual`, `alert-digest`) avec `Handlebars` pour des emails riches. - Configuration centralisée du SMTP via des variables d'environnement (`.env`). - **Triggers Firestore (`onEventCreated`, `onEventUpdated`) :** - Des triggers créent désormais des alertes d'information lorsqu'un événement est créé ou que de nouveaux membres sont ajoutés à la workforce. - **Règles Firestore :** - Mises à jour pour autoriser les utilisateurs authentifiés à créer et modifier leurs propres alertes (marquer comme lue, supprimer), tout en sécurisant les accès. **Frontend (Flutter) :** - **Nouvel `AlertService` et `EmailService` :** - `AlertService` : Centralise la logique de création, lecture et gestion des alertes côté client en appelant les nouvelles Cloud Functions. - `EmailService` : Service pour déclencher l'envoi d'emails via la fonction `sendAlertEmail`. Il contient la logique pour déterminer si une notification doit être immédiate (critique) ou différée (digest). - **Nouvelle page de Notifications (`/alerts`) :** - Interface dédiée pour lister toutes les alertes de l'utilisateur, avec des onglets pour filtrer par catégorie (Toutes, Événement, Maintenance, Équipement). - Permet de marquer les alertes comme lues, de les supprimer et de tout marquer comme lu. - **Intégration dans l'UI :** - Ajout d'un badge de notification dans la `CustomAppBar` affichant le nombre d'alertes non lues en temps réel. - Le `AutoLoginWrapper` gère désormais la redirection vers des routes profondes (ex: `/alerts`) depuis une URL. - **Gestion des Préférences de Notification :** - Ajout d'un widget `NotificationPreferencesWidget` dans la page "Mon Compte". - Les utilisateurs peuvent désormais activer/désactiver les notifications par email, ainsi que filtrer par type d'alerte (événements, maintenance, etc.). - Le `UserModel` et `LocalUserProvider` ont été étendus pour gérer ce nouveau modèle de préférences. - **Création d'alertes contextuelles :** - Le service `EventFormService` crée maintenant automatiquement une alerte lorsqu'un événement est créé ou modifié. - La page de préparation d'événement (`EventPreparationPage`) appelle `processEquipmentValidation` à la fin de chaque étape pour une détection automatisée des anomalies. **Dépendances et CI/CD :** - Ajout des dépendances `cloud_functions` et `timeago` (Flutter), et `nodemailer`, `handlebars`, `dotenv` (Node.js). - Ajout de scripts de déploiement PowerShell (`deploy_functions.ps1`, `deploy_firestore_rules.ps1`) pour simplifier les mises en production.
2026-01-15 23:15:25 +01:00
parent 60d0e1c6c4
commit beaabceda4
78 changed files with 4990 additions and 511 deletions
--- a/em2rp/lib/views/event_preparation_page.dart
+++ b/em2rp/lib/views/event_preparation_page.dart
@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 import 'package:provider/provider.dart';
+import 'package:cloud_functions/cloud_functions.dart';
 import 'package:em2rp/models/event_model.dart';
 import 'package:em2rp/models/equipment_model.dart';
 import 'package:em2rp/models/container_model.dart';
@@ -321,38 +322,40 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
        }
      }).toList();

-      // Si on est à la dernière étape (retour), vérifier les équipements LOST
-      if (_currentStep == PreparationStep.return_) {
-        await _checkAndMarkLostEquipment(updatedEquipment);
-      }
-
      // Mettre à jour Firestore selon l'étape
      final updateData = <String, dynamic>{
        'assignedEquipment': updatedEquipment.map((e) => e.toMap()).toList(),
      };

      // Ajouter les statuts selon l'étape et la checkbox
+      String validationType = 'CHECK';
      switch (_currentStep) {
        case PreparationStep.preparation:
          updateData['preparationStatus'] = preparationStatusToString(PreparationStatus.completed);
+          validationType = 'CHECK_OUT';
          if (_loadSimultaneously) {
            updateData['loadingStatus'] = loadingStatusToString(LoadingStatus.completed);
+            validationType = 'LOADING';
          }
          break;

        case PreparationStep.loadingOutbound:
          updateData['loadingStatus'] = loadingStatusToString(LoadingStatus.completed);
+          validationType = 'LOADING';
          break;

        case PreparationStep.unloadingReturn:
          updateData['unloadingStatus'] = unloadingStatusToString(UnloadingStatus.completed);
+          validationType = 'UNLOADING';
          if (_loadSimultaneously) {
            updateData['returnStatus'] = returnStatusToString(ReturnStatus.completed);
+            validationType = 'CHECK_IN';
          }
          break;

        case PreparationStep.return_:
          updateData['returnStatus'] = returnStatusToString(ReturnStatus.completed);
+          validationType = 'CHECK_IN';
          break;
      }

@@ -372,6 +375,41 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
        await _updateEquipmentStatuses(updatedEquipment);
      }

+      // NOUVEAU: Appeler la Cloud Function pour traiter la validation
+      // et créer les alertes automatiquement
+      try {
+        DebugLog.info('[EventPreparationPage] Appel processEquipmentValidation');
+
+        final equipmentList = updatedEquipment.map((eq) {
+          final equipment = _equipmentCache[eq.equipmentId];
+          return {
+            'equipmentId': eq.equipmentId,
+            'name': equipment?.name ?? 'Équipement inconnu',
+            'status': _determineEquipmentStatus(eq),
+            'quantity': _getQuantityForStep(eq),
+            'expectedQuantity': eq.quantity,
+            'isMissingAtPreparation': eq.isMissingAtPreparation,
+            'isMissingAtReturn': eq.isMissingAtReturn,
+          };
+        }).toList();
+
+        final result = await FirebaseFunctions.instanceFor(region: 'us-central1')
+            .httpsCallable('processEquipmentValidation')
+            .call({
+          'eventId': _currentEvent.id,
+          'equipmentList': equipmentList,
+          'validationType': validationType,
+        });
+
+        final alertsCreated = result.data['alertsCreated'] ?? 0;
+        if (alertsCreated > 0) {
+          DebugLog.info('[EventPreparationPage] $alertsCreated alertes créées automatiquement');
+        }
+      } catch (e) {
+        DebugLog.error('[EventPreparationPage] Erreur appel processEquipmentValidation', e);
+        // Ne pas bloquer la validation si les alertes échouent
+      }
+
      // Recharger l'événement depuis le provider
      final eventProvider = context.read<EventProvider>();
      // Recharger la liste des événements pour rafraîchir les données
@@ -667,38 +705,68 @@ class _EventPreparationPageState extends State<EventPreparationPage> with Single
    return result ?? false;
  }

-  /// Vérifier et marquer les équipements LOST (logique intelligente)
-  Future<void> _checkAndMarkLostEquipment(List<EventEquipment> updatedEquipment) async {
-    for (final eq in updatedEquipment) {
-      final isMissingNow = eq.isMissingAtReturn;
+  /// Détermine le statut d'un équipement selon l'étape actuelle
+  String _determineEquipmentStatus(EventEquipment eq) {
+    // Vérifier d'abord si l'équipement est perdu (LOST)
+    if (_shouldMarkAsLost(eq)) {
+      return 'LOST';
+    }

-      if (isMissingNow) {
-        // Vérifier si c'était manquant dès la préparation (étape 0)
-        final wasMissingAtPreparation = eq.isMissingAtPreparation;
+    // Vérifier si manquant à l'étape actuelle
+    if (_isMissingAtCurrentStep(eq)) {
+      return 'MISSING';
+    }

-        if (!wasMissingAtPreparation) {
-          // Était présent au départ mais manquant maintenant = LOST
-          try {
-            await _dataService.updateEquipmentStatusOnly(
-              equipmentId: eq.equipmentId,
-              status: EquipmentStatus.lost.toString(),
-            );
+    // Vérifier les quantités
+    final currentQty = _getQuantityForStep(eq);
+    if (currentQty != null && currentQty < eq.quantity) {
+      return 'QUANTITY_MISMATCH';
+    }

-            DebugLog.info('[EventPreparationPage] Équipement ${eq.equipmentId} marqué comme LOST');
+    return 'AVAILABLE';
+  }

-            // TODO: Créer une alerte "Équipement perdu"
-            // await _createLostEquipmentAlert(eq.equipmentId);
-          } catch (e) {
-            DebugLog.error('[EventPreparationPage] Erreur marquage LOST ${eq.equipmentId}', e);
-          }
-        } else {
-          // Manquant dès le début = PAS lost, juste manquant
-          DebugLog.info('[EventPreparationPage] Équipement ${eq.equipmentId} manquant depuis le début (pas LOST)');
-        }
-      }
+  /// Vérifie si un équipement doit être marqué comme LOST
+  bool _shouldMarkAsLost(EventEquipment eq) {
+    // Seulement aux étapes de retour
+    if (_currentStep != PreparationStep.return_ &&
+        !(_currentStep == PreparationStep.unloadingReturn && _loadSimultaneously)) {
+      return false;
+    }
+
+    // Si manquant maintenant mais PAS manquant à la préparation = LOST
+    return eq.isMissingAtReturn && !eq.isMissingAtPreparation;
+  }
+
+  /// Vérifie si un équipement est manquant à l'étape actuelle
+  bool _isMissingAtCurrentStep(EventEquipment eq) {
+    switch (_currentStep) {
+      case PreparationStep.preparation:
+        return eq.isMissingAtPreparation;
+      case PreparationStep.loadingOutbound:
+        return eq.isMissingAtLoading;
+      case PreparationStep.unloadingReturn:
+        return eq.isMissingAtUnloading;
+      case PreparationStep.return_:
+        return eq.isMissingAtReturn;
    }
  }

+  /// Récupère la quantité pour l'étape actuelle
+  int? _getQuantityForStep(EventEquipment eq) {
+    switch (_currentStep) {
+      case PreparationStep.preparation:
+        return eq.quantityAtPreparation;
+      case PreparationStep.loadingOutbound:
+        return eq.quantityAtLoading;
+      case PreparationStep.unloadingReturn:
+        return eq.quantityAtUnloading;
+      case PreparationStep.return_:
+        return eq.quantityAtReturn;
+    }
+  }
+
+
  @override
  Widget build(BuildContext context) {
    final allValidated = _isStepCompleted();