Module Notifications

Chemin : Notifications (ou accès via l’icône cloche dans la barre supérieure).

Ce module couvre la consultation des notifications (gardes, planning, échanges, rappels, alertes système) et la configuration des préférences de notification (canaux : email, push, in-app ; types activés). Les notifications urgentes ne peuvent pas être désactivées.

En bref : que faire dans ce module ?

Objectif	Où aller	Guide pas à pas
Consulter les notifications	Icône cloche (barre du haut)	Notifications
Configurer les préférences (canaux, types)	Notifications → Préférences	Notifications · Tutoriel

1. Liste des notifications

Aspects fonctionnels implémentés

Liste / grille : notifications avec pagination, tri ; colonnes (type, titre, message, priorité, date, statut lu/non lu, entité liée).
Filtres : par type (garde assignée, planning créé, échange demandé, rappel, alerte système, etc.), par priorité (faible, moyen, élevé, urgent), par statut (lu / non lu), par période (date début, date fin).
Statut lu / non lu : marquage d’une notification comme lue (action ou au clic) ; mise à jour en temps réel si possible.
Actions : marquer comme lu, marquer toutes comme lues, supprimer (si prévu pour nettoyage).
Lien vers l’entité : clic sur une notification pour accéder à l’élément concerné (ex. garde, planning, demande d’échange) via actionUrl ou navigation.
Badge : affichage du nombre de notifications non lues sur l’icône cloche dans la barre de navigation.
Rafraîchissement : rechargement des données ; mise à jour en temps réel (polling ou WebSocket) si implémenté.

2. Types de notifications

Aspects fonctionnels implémentés

Gardes : garde assignée, garde retirée.
Planning : planning créé, planning mis à jour, planning supprimé.
Échanges : demande d’échange, échange approuvé, échange rejeté.
Disponibilités : changement de disponibilité.
Système : alerte système, rappel (ex. soumission de planning, échéance), annonce.
Priorités : Faible, Moyen, Élevé, Urgent ; affichage avec style ou icône selon la priorité.
Règle : les notifications de priorité Urgent (et éventuellement Élevé) ne peuvent pas être désactivées dans les préférences.

3. Préférences de notification

Aspects fonctionnels implémentés

Canaux : activation/désactivation par canal — Email, Push, In-app.
Types : pour chaque type de notification (garde assignée, échange demandé, mise à jour planning, alertes système, rappels, annonces), choix d’activation et des canaux utilisés.
Fréquence : pour certains types, choix de la fréquence (immédiat, quotidien, hebdomadaire) si l’API le permet.
Heures calmes : configuration d’une plage horaire pendant laquelle les notifications (hors urgentes) ne sont pas envoyées ou sont regroupées, si prévu par l’API.
Sauvegarde : envoi des préférences au backend (ex. PUT /api/notifications/preferences) ; payload selon le schéma NotificationPreferences.
Chargement : chargement des préférences actuelles au démarrage de l’écran (GET /api/notifications/preferences).
Validation : au moins un canal actif pour les types activés ; les notifications urgentes restent toujours activées.

4. Centre de notifications (panneau / page)

Aspects fonctionnels implémentés

Panneau déroulant : depuis l’icône cloche, ouverture d’un panneau listant les dernières notifications (ex. 10 dernières) avec lien « Voir tout » vers la page complète.
Page dédiée : liste complète avec filtres et pagination ; accès depuis le menu ou le panneau.
Actions rapides : marquer comme lu, marquer toutes comme lues, depuis le panneau ou la page.
Indicateur : badge avec le nombre de non lues ; disparition ou mise à jour après lecture.

5. Intégration avec les autres modules

Aspects fonctionnels implémentés

Contexte : lorsqu’une action dans l’application génère une notification (ex. affectation de garde, approbation d’échange), celle-ci apparaît dans la liste et peut déclencher un toast ou une mise à jour du badge.
Backend : les notifications sont créées côté backend (ou via un service dédié) ; l’interface ne fait que les afficher et gérer les préférences.
Audit : les modifications de préférences peuvent être tracées (ex. UPDATE_NOTIFICATION_PREFS).

Rôles et accès

Consultation : chaque utilisateur ne voit que ses propres notifications.
Préférences : chaque utilisateur configure ses propres préférences ; un admin peut éventuellement consulter les préférences des utilisateurs selon les droits métier.

Voir aussi

Paramètres — Configuration système (les préférences de notifications sont dans ce module)
FAQ