Alertes (notes)

Le système d'alertes dans OpenRevision est conçu pour permettre aux contrôleurs de déposer des annotations ou des points d'attention sur des contrôles spécifiques, fonctionnant comme des "post-it" numériques internes à l'application. Ces alertes facilitent le suivi des points importants et la communication entre les différents intervenants travaillant sur un même dossier.

Définition et objectifs

Une alerte est une note contextuelle attachée à un contrôle spécifique qui :

Reste strictement interne à l'application (non visible par les clients)

Sert à signaler un point d'attention, une anomalie, ou une action à entreprendre

Facilite la communication entre les contrôleurs, managers et experts-comptables

Permet de conserver une trace des questions ou problèmes rencontrés pendant le processus de contrôle

Caractéristiques fonctionnelles

Statuts d'une alerte

En cours (in_progress) : L'alerte est active et requiert attention ou action

Archivée (archived) : L'alerte a été traitée et archivée pour conserver l'historique

Structure d'une alerte

Chaque alerte contient :

Contenu (content) : Description détaillée du point d'attention

Statut : En cours ou Archivée

Auteur : Utilisateur ayant créé l'alerte

Date de création

Contrôle associé : Le contrôle auquel l'alerte est rattachée

Dossier et cycle : Le contexte de l'alerte

Date d'archivage (si applicable)

Archivé par (si applicable) : Utilisateur ayant archivé l'alerte

Spécifications techniques

Modèle de données

Alert {
    id: int (primary key)
    content: text
    status: enum (in_progress, archived)
    created_by: int (foreign key -> User)
    created_at: timestamp
    control_id: int (foreign key -> Control)
    dossier_id: int (foreign key -> Dossier)
    cycle_id: int (foreign key -> Cycle)
    archived_at: timestamp (nullable)
    archived_by: int (foreign key -> User, nullable)
}

Relations

Une alerte appartient à un contrôle spécifique

Un contrôle peut avoir plusieurs alertes

Une alerte est créée par un utilisateur

Une alerte est liée à un dossier et à un cycle

Interface utilisateur

Affichage sur la page d'accueil du cycle :
- Une section dédiée aux alertes est visible sur la page d'accueil de chaque cycle
- Affichage des alertes actives (statut "in_progress")
- Indication du nombre total d'alertes
- Bouton "Voir tout" pour accéder à la liste complète des alertes

Vue modale de la liste complète :
- Au clic sur "Voir tout", ouverture d'une modale similaire à celle des notes de synthèse
- Affichage de toutes les alertes avec pagination si nécessaire
- Possibilité de filtrer par statut (En cours, Archivée)
- Organisation par date (plus récentes en premier)
- Options de recherche dans le contenu des alertes

Création et gestion des alertes :
- Bouton "Ajouter une alerte" visible dans la modale et sur la page du cycle
- Actions disponibles sur chaque alerte : modifier, archiver, supprimer
- Formulaire simple pour la création/modification d'alertes avec champ de texte pour le contenu

Règles de gestion

Visibilité et permissions :
- Les alertes sont strictement internes à l'application
- Les utilisateurs avec le rôle "observateur" ne peuvent pas voir les alertes
- Seuls les utilisateurs ayant des droits de modification ou supérieurs peuvent voir les alertes
- Tous les utilisateurs avec droits de modification sur le dossier peuvent créer, modifier, archiver et supprimer des alertes

Cycle de vie des alertes :
- Toutes les alertes avec statut "in_progress" doivent être archivées pour permettre de passer le contrôle en statut "Contrôlé"
- Les alertes sont archivées plutôt que supprimées pour garder une trace des actions
- Une alerte archivée peut être consultée mais ne bloque plus la validation du contrôle

Suppression d'alertes :
- Une confirmation via une fenêtre modale est requise lors de la suppression d'une alerte
- La modale demande une double confirmation pour éviter les suppressions accidentelles
- Message suggéré : "Êtes-vous sûr de vouloir supprimer cette alerte ? Cette action est irréversible. Confirmez-vous la suppression ?"

Archivage vs Suppression :
- L'archivage est la méthode privilégiée pour conserver l'historique des alertes traitées
- La suppression ne devrait être utilisée que pour les alertes créées par erreurMasquage dans l'interface

Pour les utilisateurs "observateurs", il faut masquer complètement la section alertes dans l'interface

Conclusion

Le système d'alertes d'OpenRevision offre un mécanisme simplifié mais efficace pour signaler et suivre les points d'attention identifiés lors des contrôles financiers. Avec la restriction d'accès pour les utilisateurs "observateurs", le système garantit que ces notes de travail internes ne sont visibles que par les utilisateurs ayant un rôle actif dans le processus de contrôle. L'obligation d'archiver toutes les alertes en cours avant la validation d'un contrôle assure qu'aucun point important n'est négligé, tout en maintenant la confidentialité des discussions et annotations internes à l'équipe de contrôle