1. 🏠 Accueil

📚 Documentation de la Plateforme

Bienvenue dans la documentation de votre plateforme de gestion de la conformité.

💡 Vous n'êtes pas encore connecté ? Cette documentation vous présente les fonctionnalités de la plateforme. Se connecter ou Demander une démo

🎯 À propos de cette documentation

Cette documentation présente l'ensemble des rôles et des fonctions de la plateforme. Elle est organisée de manière hiérarchique pour vous permettre de comprendre :

• 🔧 Superadmin : Configuration globale, gestion des organisations et référentiels système
• 👨‍💼 Admin : Gestion des utilisateurs, services et référentiels de votre organisation
• ✅ Validateur : Validation des études, suivi des demandes et bonnes pratiques
• 👤 Utilisateur : Création d'études, plan d'action, historique et exports

Navigation : Utilisez le menu de gauche pour explorer les différentes sections.

📚 Référentiels Disponibles

Découvrez nos référentiels publics et prévisualisez-les en lecture seule :

Conformité et Sécurité

• ISO 27001 - Système de management de la sécurité de l'information
• RGPD - Règlement Général sur la Protection des Données
• DORA - Résilience opérationnelle numérique
• NIS 2 - Directive sur la sécurité des réseaux et des systèmes d'information
• ISO 27002 - Code de bonnes pratiques pour la sécurité de l'information

Qualité et Environnement

• ISO 9001 - Système de management de la qualité
• ISO 14001 - Système de management environnemental
• ISO 45001 - Système de management de la santé et de la sécurité au travail

Vie Quotidienne (Exemples)

• Montage Meuble IKEA - Guide pas à pas sans stress
• Préparation Voyage - Checklist complète
• Organisation Mariage - De A à Z
• Révision Véhicule - Entretien automobile
• Entretien Maison - Maintenance préventive
• Adoption Animal - Guide responsable
• Déménagement - Organisation optimale

💡 Astuce : Cliquez sur un référentiel pour le prévisualiser et voir son contenu détaillé !

🚀 Commencer avec la Plateforme

Pour les Organisations

La plateforme vous permet de :
- 📋 Centraliser tous vos référentiels de conformité (ISO, RGPD, DORA, NIS 2...)
- ✅ Créer des checklists intelligentes et processus dynamiques
- 🛡️ Tracer et maîtriser votre conformité avec des preuves d'audit
- 📊 Suivre votre progression en temps réel

Rôles Disponibles

🔧 Superadmin

Configuration globale, gestion des organisations et référentiels système

👨‍💼 Admin

Gestion des utilisateurs, services et référentiels de votre organisation

✅ Validateur

Validation des études, suivi des demandes et bonnes pratiques

👤 Utilisateur

Création d'études, plan d'action, historique et exports

📖 Sections Principales

• Workflow Complet - Comprendre le processus global
• Gestion des Organisations
• Gestion des Utilisateurs
• Gestion des Référentiels
• Création d'Études

🎯 Prêt à Démarrer ?

1. Demander une démo - Testez la solution gratuitement
2. Créer un compte - Lancez votre organisation
3. Se connecter - Accédez à votre espace

🆘 Besoin d'Aide ?

• 📧 Email : support@complianceguard.fr
• 💬 Chat : Disponible en bas à droite
• 📞 Téléphone : +33 (0)1 XX XX XX XX

🔒 Sécurité et Conformité

La plateforme est conçue avec la sécurité au cœur :
- 🔐 Chiffrement des données
- 🇫🇷 Hébergement en France
- ✅ Conforme RGPD
- 🛡️ Audits réguliers

2. 🔐 Rôles et Permissions

🔐 Rôles et Permissions - SmartRef

📋 Vue d'ensemble des rôles

SmartRef propose 5 rôles avec des niveaux de permissions différents, du plus basique au plus avancé.

👤 1. Utilisateur (utilisateur)

Portée : Organisation locale
Niveau : Basique

✅ Permissions

• Voir les référentiels affectés à son organisation
• Créer et gérer ses propres études
• Répondre aux questionnaires
• Voir ses propres actions
• Consulter le calendrier (ses événements)
• Accéder à la documentation
• Gérer son profil

❌ Restrictions

• Ne voit PAS les études des autres utilisateurs
• Ne peut PAS valider d'études
• Ne peut PAS gérer les utilisateurs
• Ne peut PAS affecter de référentiels

🎯 Cas d'usage

• Employé qui remplit des questionnaires de conformité
• Collaborateur qui suit ses actions assignées

🔍 2. Auditeur (auditeur)

Portée : Organisation locale
Niveau : Lecture seule étendue

✅ Permissions

• Toutes les permissions d'un utilisateur
• Voir TOUTES les études de son organisation (lecture seule)
• Voir tous les référentiels de son organisation
• Générer des rapports d'audit
• Consulter les actions de tous les utilisateurs de l'organisation
• Vue d'ensemble de la conformité de l'organisation

❌ Restrictions

• Lecture seule : ne peut PAS modifier les études des autres
• Ne peut PAS créer d'études pour d'autres utilisateurs
• Ne peut PAS valider d'études
• Ne peut PAS gérer les utilisateurs
• Ne voit QUE son organisation (pas les autres)

🎯 Cas d'usage

• Auditeur interne qui doit vérifier la conformité
• Responsable qualité qui supervise sans modifier
• Consultant externe avec accès en lecture

✅ 3. Validateur (validateur)

Portée : Organisation locale
Niveau : Validation

✅ Permissions

• Toutes les permissions d'un utilisateur
• Valider/invalider les études de son organisation
• Voir les études en attente de validation
• Ajouter des commentaires de validation
• Demander des corrections

❌ Restrictions

• Ne peut PAS gérer les utilisateurs
• Ne peut PAS affecter de référentiels
• Ne peut PAS modifier les paramètres de l'organisation

🎯 Cas d'usage

• Responsable qui valide les études avant publication
• Manager qui approuve les réponses

👨‍💼 4. Admin (admin)

Portée : Organisation locale
Niveau : Administration

✅ Permissions

• Toutes les permissions d'un validateur
• Gérer les utilisateurs de son organisation
• Créer des plans d'action pour son organisation
• Assigner des actions aux utilisateurs
• Voir les statistiques de l'organisation
• Configurer les paramètres de l'organisation
• Gérer les services de l'organisation
• Accéder au Studio PDF (création de modèles)

❌ Restrictions

• Ne peut PAS créer/supprimer d'organisations
• Ne peut PAS affecter de référentiels (géré par superadmin)
• Ne peut PAS voir les autres organisations
• Ne peut PAS modifier les paramètres système

🎯 Cas d'usage

• Responsable de l'organisation
• Gestionnaire qui administre son équipe
• Créateur de plans d'action

🔧 5. Superadmin (superadmin)

Portée : Globale (toutes les organisations)
Niveau : Administration système

✅ Permissions

• Toutes les permissions
• Gérer toutes les organisations
• Créer/supprimer des organisations
• Affecter les référentiels aux organisations
• Gérer les référentiels (création, import, activation)
• Gérer les types d'actions
• Gérer les prompts IA
• Accéder aux logs (emails, application)
• Configurer le système (SMTP, paramètres globaux)
• Sidebar Builder (configuration de la navigation)
• Approuver les demandes d'inscription
• Voir et gérer toutes les données du système

🎯 Cas d'usage

• Administrateur système
• Support technique
• Gestionnaire de la plateforme

🔐 Matrice de permissions

📊 Hiérarchie des rôles

Superadmin (Système)
    ↓
Admin (Organisation)
    ↓
Validateur (Organisation)
    ↓
Auditeur (Organisation - Lecture seule)
    ↓
Utilisateur (Organisation)

Principe : Chaque niveau hérite des permissions du niveau inférieur, avec des droits supplémentaires.

🔄 Workflow typique

1. Superadmin crée une organisation et affecte des référentiels
2. Admin crée des utilisateurs dans son organisation
3. Utilisateurs créent des études et répondent aux questionnaires
4. Validateur valide les études terminées
5. Admin crée des plans d'action basés sur les résultats
6. Auditeur génère des rapports de conformité
7. Superadmin supervise l'ensemble du système

📝 Notes importantes

Auditeur vs Admin

• Auditeur : Lecture seule, voit tout dans son organisation, génère des rapports
• Admin : Gestion complète, peut modifier, créer des plans d'action

Portée organisationnelle

• Utilisateur, Auditeur, Validateur, Admin : Limités à leur organisation (client_id)
• Superadmin : Accès global à toutes les organisations

Sécurité

• Chaque route vérifie le rôle ET l'organisation
• Les auditeurs doivent avoir client_id défini
• Les filtres par organisation sont obligatoires pour les rôles locaux
• Tous les accès sont tracés dans les logs

🎯 Choisir le bon rôle

Pour un collaborateur qui saisit des données

→ Utilisateur

Pour un auditeur interne ou consultant

→ Auditeur

Pour un responsable qui valide les études

→ Validateur

Pour un gestionnaire d'équipe

→ Admin

Pour l'administrateur de la plateforme

→ Superadmin

🔗 Guides par rôle

• Guide Utilisateur
• Guide Auditeur
• Guide Validateur
• Guide Admin
• Guide Superadmin

Dernière mise à jour : 2025-11-06

3. 🔄 Workflow Complet

🔄 Workflow Complet de la Plateforme

📊 Vue d'ensemble

La plateforme suit un workflow structuré pour garantir la conformité de votre organisation.

Diagramme Visuel

Figure 1 : Workflow complet de la plateforme - Du superadmin à l'utilisateur

┌─────────────────┐
│   Superadmin    │ Crée l'organisation et affecte les référentiels
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│      Admin      │ Crée les utilisateurs et gère les services
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   Utilisateur   │ Crée et remplit une étude
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   Utilisateur   │ Demande la validation
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   Validateur    │ Examine et valide/invalide
└────────┬────────┘
         │
    ┌────┴────┐
    │         │
    ▼         ▼
✅ Validé   ❌ Invalidé
    │         │
    │         └──► Corrections ──┐
    │                            │
    └────────────────────────────┘
                 │
                 ▼
         📋 Plan d'action
                 │
                 ▼
         📊 Suivi et exports

1️⃣ Phase de Configuration (Superadmin)

Créer une organisation

1. Menu Organisations → Nouvelle organisation
2. Remplir les informations :
3. Nom de l'organisation
4. SIREN
5. Adresse, email, téléphone
6. Statut (trial/active)
7. Cliquer sur "Créer"

Affecter des référentiels

1. Menu Affectation des Référentiels
2. Sélectionner l'organisation
3. Cocher les référentiels à affecter (ISO 27001, RGPD, etc.)
4. Cliquer sur "Enregistrer"

Créer des utilisateurs

1. Menu Utilisateurs → Nouvel utilisateur
2. Définir :
3. Nom d'utilisateur
4. Email
5. Rôle (utilisateur, validateur, admin)
6. Organisation
7. Service (optionnel)
8. L'utilisateur reçoit un email avec ses identifiants

2️⃣ Phase de Gestion (Admin)

Gérer les services

1. Menu Services
2. Créer des services (IT, RH, Finance, etc.)
3. Affecter des utilisateurs aux services

Gérer les utilisateurs

1. Menu Utilisateurs
2. Modifier les rôles et permissions
3. Désactiver/Réactiver des comptes
4. Réinitialiser les mots de passe

3️⃣ Phase d'Évaluation (Utilisateur)

Créer une étude

1. Menu Mes études → Nouvelle étude
2. Sélectionner un référentiel
3. Donner un nom (optionnel)
4. Cliquer sur "Créer"

Remplir le questionnaire

1. Répondre aux questions section par section
2. Les réponses sont sauvegardées automatiquement
3. Utiliser "Suivant" et "Précédent" pour naviguer
4. Le statut reste "Brouillon" tant que non soumis

Consulter les résultats

1. Aller sur "Résultats"
2. Voir le score de conformité
3. Consulter le graphique radar par section
4. Lire les recommandations

Plan d'action généré

• 📋 Généré automatiquement à la création
• 🎯 Actions basées sur les réponses
• 📊 Organisé en Kanban (À faire, En cours, Bloqué, Terminé)

4️⃣ Phase de Validation (Utilisateur → Validateur)

Demander la validation (Utilisateur)

1. Sur la page "Récapitulatif"
2. Vérifier toutes les réponses
3. Cliquer sur "Demander la validation"
4. 📸 Une version est créée automatiquement
5. Le statut passe à "En attente de validation"

Examiner l'étude (Validateur)

1. Menu Mes études → Filtrer par "En attente"
2. Ouvrir l'étude à valider
3. Consulter les réponses et les scores
4. Vérifier la cohérence

Valider ✅ (Validateur)

1. Cliquer sur "Valider"
2. 📸 Une version est créée
3. Le statut passe à "Validé"
4. L'utilisateur est notifié

Invalider ❌ (Validateur)

1. Cliquer sur "Invalider"
2. Ajouter un commentaire expliquant les corrections à apporter
3. 📸 Une version est créée avec le commentaire
4. Le statut passe à "Invalidé"
5. L'utilisateur peut corriger et redemander la validation

5️⃣ Phase de Suivi (Utilisateur)

Utiliser le plan d'action

1. Onglet "Plan d'action"
2. Drag & Drop des actions entre les colonnes
3. Modifier les actions (priorité, échéance, responsable)
4. Ajouter des commentaires pour documenter
5. Suivre l'avancement

Consulter l'historique

1. Onglet "Historique"
2. Voir toutes les versions créées
3. Comparer les versions
4. Restaurer une version si nécessaire

Exporter les résultats

1. Cliquer sur "Exporter en PDF" ou "Exporter en Excel"
2. Partager avec les parties prenantes
3. Archiver pour les audits

🎭 Rôles et Permissions

👤 Utilisateur

• ✅ Créer des études
• ✅ Remplir les questionnaires
• ✅ Demander la validation
• ✅ Gérer le plan d'action
• ✅ Consulter l'historique
• ✅ Exporter les résultats
• ❌ Valider des études
• ❌ Gérer les utilisateurs

✅ Validateur

• ✅ Tout ce que l'utilisateur peut faire
• ✅ Valider des études
• ✅ Invalider des études avec commentaires
• ✅ Voir toutes les études de son organisation
• ❌ Gérer les utilisateurs
• ❌ Gérer les référentiels

👨‍💼 Admin

• ✅ Tout ce que le validateur peut faire
• ✅ Gérer les utilisateurs de son organisation
• ✅ Créer des services
• ✅ Affecter des utilisateurs aux services
• ✅ Voir les statistiques de son organisation
• ❌ Créer des organisations
• ❌ Gérer les référentiels système

🔧 Superadmin

• ✅ Tous les droits
• ✅ Créer et gérer les organisations
• ✅ Gérer les référentiels système
• ✅ Affecter les référentiels aux organisations
• ✅ Gérer la bibliothèque de questions
• ✅ Import/Export JSON
• ✅ Configuration système

📸 Système de Versioning

Création automatique de versions

Des "photos" de l'étude sont prises automatiquement lors de :
- 🎯 Demande de validation
- ✅ Validation
- ❌ Invalidation (avec commentaire)
- ⏮️ Restauration d'une version

Contenu d'une version

• Toutes les réponses
• Les scores calculés
• Le statut de l'étude
• L'auteur du changement
• La date et l'heure
• Le type de changement

Utilité

• 📊 Traçabilité complète
• 🔍 Audit facilité
• ↔️ Comparaison entre versions
• ⏮️ Restauration en cas d'erreur
• 📈 Suivi de l'évolution

💡 Bonnes Pratiques

Pour les Utilisateurs

• ✅ Remplir toutes les questions obligatoires
• ✅ Être précis dans les réponses texte
• ✅ Consulter les documents de référence
• ✅ Vérifier avant de demander la validation
• ✅ Suivre régulièrement le plan d'action

Pour les Validateurs

• ✅ Examiner attentivement toutes les réponses
• ✅ Vérifier la cohérence globale
• ✅ Donner des commentaires constructifs en cas d'invalidation
• ✅ Valider rapidement pour ne pas bloquer le processus

Pour les Admins

• ✅ Créer des services logiques
• ✅ Affecter les bons rôles aux utilisateurs
• ✅ Former les utilisateurs au processus
• ✅ Suivre les statistiques régulièrement

Pour les Superadmins

• ✅ Affecter les référentiels pertinents
• ✅ Maintenir la bibliothèque de questions à jour
• ✅ Surveiller l'utilisation de la plateforme
• ✅ Assurer la sécurité des données

❓ Questions Fréquentes

Q : Combien de temps pour remplir une étude ?
R : Selon le référentiel, entre 30 minutes et 2 heures. Vous pouvez sauvegarder et reprendre à tout moment.

Q : Puis-je modifier une étude validée ?
R : Non, mais vous pouvez créer une nouvelle étude ou demander une invalidation.

Q : Que se passe-t-il si je perds ma connexion ?
R : Vos réponses sont sauvegardées automatiquement. Vous ne perdez rien.

Q : Combien de validateurs par étude ?
R : Un seul validateur valide ou invalide l'étude.

Q : Puis-je exporter plusieurs études en une fois ?
R : Pas encore, vous devez exporter étude par étude.

Q : Les versions prennent-elles beaucoup d'espace ?
R : Non, le système est optimisé pour minimiser l'espace utilisé.

🔗 Liens Utiles

• Guide Utilisateur
• Guide Validateur (à venir)
• Guide Admin (à venir)
• Guide Superadmin (à venir)
• Documentation Technique (à venir)

4. ⚙️ Configuration

⚙️ Configuration Système

🏢 Gestion des Organisations

Créer une organisation

1. Menu "Organisations" → "Nouvelle organisation"
2. Remplir les informations :
3. Nom (ex: "Acme Corp")
4. SIREN (9 chiffres, unique)
5. Adresse complète
6. Email de contact
7. Téléphone
8. Statut (trial/active)
9. Cliquer sur "Créer"

Statuts d'organisation

🆓 Trial (Essai)

• Durée limitée (ex: 30 jours)
• Fonctionnalités limitées
• Nombre d'utilisateurs limité
• Idéal pour tester la plateforme

✅ Active

• Accès complet
• Utilisateurs illimités
• Toutes les fonctionnalités
• Support prioritaire

❌ Inactive

• Accès bloqué
• Données conservées
• Peut être réactivée

Modifier une organisation

1. Liste des organisations
2. Cliquer sur "Modifier"
3. Mettre à jour les informations
4. Changer le statut si nécessaire
5. Enregistrer

Paramètres avancés

• Logo personnalisé
• Couleurs de la marque
• Domaine personnalisé (à venir)
• Intégrations (API, SSO)

📚 Affectation des Référentiels

Principe

Les référentiels publics doivent être affectés aux organisations pour être utilisables.

Processus d'affectation

1. Menu "Affectation des Référentiels"
2. Sélectionner une organisation
3. Cocher les référentiels à affecter :
4. ISO 27001
5. RGPD
6. ISO 22301
7. DORA
8. NIS2
9. etc.
10. Cliquer sur "Enregistrer"

Affectation automatique

• Les référentiels publics sont automatiquement affectés à l'organisation "Démo SA"
• Cela permet aux utilisateurs de démo d'avoir immédiatement accès aux référentiels
• Géré par system_referentials_loader.py

Retirer un référentiel

1. Décocher le référentiel
2. Enregistrer
3. ⚠️ Les études existantes restent accessibles
4. ⚠️ Nouvelles études ne pourront plus utiliser ce référentiel

👥 Gestion Globale des Utilisateurs

Vue d'ensemble

• Voir tous les utilisateurs de toutes les organisations
• Filtrer par organisation, rôle, statut
• Rechercher par nom ou email

Actions possibles

• Créer des utilisateurs pour n'importe quelle organisation
• Modifier les rôles (y compris promouvoir en admin)
• Réinitialiser les mots de passe
• Désactiver/Réactiver des comptes
• Supprimer des comptes (avec précaution)

Créer un superadmin

1. Créer un utilisateur normal
2. Modifier son rôle → "superadmin"
3. ⚠️ À faire avec précaution !
4. Informer l'utilisateur de ses nouvelles responsabilités

📚 Gestion des Référentiels Système

Créer un référentiel public

1. Menu "Gestion des Référentiels"
2. Cliquer sur "Nouveau référentiel"
3. Remplir :
4. Nom (ex: "ISO 27001")
5. Description
6. Type : Public
7. Statut : Actif
8. Créer les sections et questions

Bibliothèque de Questions

1. Menu "Bibliothèque de Questions"
2. Créer des questions réutilisables
3. Les affecter à plusieurs référentiels
4. Maintenir la cohérence

Import/Export JSON

1. Menu "Gestion des Référentiels"
2. Exporter : Télécharger un référentiel en JSON
3. Importer : Charger un référentiel depuis JSON
4. Utile pour :
5. Sauvegardes
6. Partage entre environnements
7. Versioning

🎨 Personnalisation

Logo et Branding

• Logo de la plateforme
• Logo par organisation
• Couleurs personnalisées
• Favicon

Emails

• Templates d'emails
• Personnalisation des messages
• Configuration SMTP

Fonctionnalités

• Activer/Désactiver des modules
• Configurer les limites (trial)
• Paramètres de sécurité

🔒 Sécurité

Paramètres de sécurité

• Politique de mots de passe
• Durée de session
• Authentification à deux facteurs (à venir)
• Logs d'audit

Surveillance

• Logs d'accès
• Tentatives de connexion échouées
• Actions sensibles
• Performances

📊 Statistiques Globales

Indicateurs disponibles

• Nombre total d'organisations
• Nombre total d'utilisateurs
• Nombre total d'études
• Taux d'utilisation par référentiel
• Performances système

Rapports

• Rapport mensuel d'activité
• Statistiques par organisation
• Tendances d'utilisation

❓ Questions fréquentes

Q : Puis-je supprimer une organisation ?
R : Oui, mais toutes ses données seront supprimées. Préférez la désactivation.

Q : Combien d'organisations puis-je créer ?
R : Illimité (selon votre infrastructure).

Q : Puis-je transférer des utilisateurs entre organisations ?
R : Oui, en modifiant leur organisation d'appartenance.

Q : Comment gérer les licences ?
R : Via le statut (trial/active) et les limites configurées.

5. 🔧 Maintenance

🔧 Maintenance et Support

🛠️ Maintenance Régulière

Tâches quotidiennes

• ✅ Vérifier les logs d'erreurs
• ✅ Surveiller les performances
• ✅ Vérifier les sauvegardes
• ✅ Répondre aux tickets de support

Tâches hebdomadaires

• ✅ Analyser les statistiques d'utilisation
• ✅ Vérifier les comptes inactifs
• ✅ Nettoyer les logs anciens
• ✅ Mettre à jour la documentation

Tâches mensuelles

• ✅ Rapport d'activité global
• ✅ Revue des performances
• ✅ Mise à jour des référentiels
• ✅ Formation des admins

💾 Sauvegardes

Base de données

• Fréquence : Quotidienne (automatique)
• Rétention : 30 jours
• Localisation : /backups/
• Test de restauration : Mensuel

Fichiers

• Logos et documents
• Exports utilisateurs
• Logs système

Procédure de restauration

1. Arrêter l'application
2. Restaurer la base de données
3. Restaurer les fichiers
4. Redémarrer l'application
5. Vérifier l'intégrité

📊 Monitoring

Indicateurs à surveiller

• CPU : < 70% en moyenne
• Mémoire : < 80% utilisée
• Disque : > 20% libre
• Temps de réponse : < 500ms
• Taux d'erreur : < 1%

Alertes configurées

• Disque plein (> 90%)
• Erreurs critiques
• Temps de réponse élevé
• Tentatives de connexion suspectes

Outils

• Logs applicatifs
• Logs système
• Monitoring serveur
• Analytics utilisateurs

🐛 Résolution de Problèmes

Problèmes courants

Utilisateur ne peut pas se connecter

1. Vérifier que le compte est actif
2. Vérifier l'organisation est active
3. Réinitialiser le mot de passe
4. Vérifier les logs de connexion

Étude ne se charge pas

1. Vérifier que l'étude existe
2. Vérifier les permissions
3. Vérifier les logs d'erreurs
4. Vérifier la base de données

Performance lente

1. Vérifier la charge serveur
2. Analyser les requêtes lentes
3. Vérifier les connexions DB
4. Optimiser si nécessaire

Logs

Localisation

• Application : /logs/app.log
• Erreurs : /logs/error.log
• Accès : /logs/access.log
• Audit : /logs/audit.log

Niveaux de log

• DEBUG : Développement uniquement
• INFO : Informations générales
• WARNING : Avertissements
• ERROR : Erreurs
• CRITICAL : Erreurs critiques

🔄 Mises à Jour

Processus de mise à jour

1. Sauvegarde complète
2. Notification aux utilisateurs
3. Fenêtre de maintenance (hors heures)
4. Mise à jour du code
5. Migration de la base de données
6. Tests de validation
7. Redémarrage de l'application
8. Vérification post-mise à jour

Rollback

En cas de problème :
1. Arrêter l'application
2. Restaurer la version précédente
3. Restaurer la base de données
4. Redémarrer
5. Analyser le problème

📞 Support Utilisateurs

Niveaux de support

Niveau 1 : Utilisateurs

• Questions d'utilisation
• Réinitialisation de mot de passe
• Problèmes mineurs
  → Traité par : Admins

Niveau 2 : Admins

• Configuration organisation
• Gestion utilisateurs avancée
• Problèmes techniques
  → Traité par : Superadmins

Niveau 3 : Superadmins

• Problèmes système
• Bugs critiques
• Développements
  → Traité par : Équipe technique

Tickets de support

• Utiliser un système de ticketing
• Prioriser selon l'urgence
• Documenter les résolutions
• Suivre les SLA

🔐 Sécurité

Audits de sécurité

• Revue des accès (trimestriel)
• Analyse des logs (mensuel)
• Test de pénétration (annuel)
• Mise à jour des dépendances (mensuel)

Incidents de sécurité

1. Détection : Logs, alertes, signalement
2. Isolation : Bloquer l'accès si nécessaire
3. Investigation : Analyser les logs
4. Correction : Patcher la faille
5. Communication : Informer les concernés
6. Documentation : Post-mortem

📚 Documentation

À maintenir

• Cette documentation
• Procédures techniques
• Configurations système
• Historique des changements

Bonnes pratiques

• Documenter chaque changement important
• Tenir un changelog
• Partager les connaissances
• Former les nouveaux superadmins

❓ Questions fréquentes

Q : Que faire en cas de panne majeure ?
R : 1) Informer les utilisateurs, 2) Analyser les logs, 3) Restaurer depuis sauvegarde si nécessaire.

Q : Comment gérer une charge inhabituelle ?
R : Surveiller les ressources, identifier la cause, scaler si nécessaire.

Q : Fréquence des mises à jour ?
R : Selon les besoins, généralement mensuel pour les correctifs, trimestriel pour les fonctionnalités.

Q : Qui contacter en cas de problème critique ?
R : Équipe technique ou support éditeur selon votre contrat.

6. 📊 Gestion des Logs

📊 Gestion des Logs

Vue d'ensemble

La plateforme dispose d'un système complet de gestion des logs permettant de surveiller l'activité de l'application et les emails envoyés.

📧 Logs Emails

Accès

Menu : ⚙️ Configuration → Onglet "Logs Emails"

Fonctionnalités

Visualisation

• Historique complet des emails envoyés
• Statuts détaillés :
• ✅ SUCCESS : Email envoyé avec succès
• ❌ ERREUR : Échec d'envoi (avec détails de l'erreur)
• ⚠️ SMTP_NON_CONFIGURE : Configuration SMTP manquante

Filtrage

• Tous les statuts : Affiche tous les emails
• Succès uniquement : Emails envoyés avec succès
• Erreurs uniquement : Emails en échec
• SMTP non configuré : Emails bloqués par configuration manquante

Informations Affichées

• Timestamp : Date et heure d'envoi
• Destinataire : Adresse email du destinataire
• Sujet : Sujet de l'email
• Aperçu : Aperçu du contenu (100 premiers caractères)
• Statut : Badge coloré indiquant le résultat

Archivage

• Bouton "Archiver les logs" : Sauvegarde les logs actuels
• Format : emails_AAAAMMJJ_HHMM.log
• Exemple : emails_20251028_1226.log
• Emplacement : backend/logs/archives/
• Comportement :
• Copie le fichier actuel vers les archives
• Vide le fichier actif
• Feedback visuel sur le bouton (pas de popup)

📊 Logs Application

Accès

Menu : ⚙️ Configuration → Onglet "Logs Application"

Fonctionnalités

Visualisation

• Logs système de l'application
• Nombre de lignes : 100, 200, 500 ou 1000 lignes
• Affichage : Les plus récents en premier

Niveaux de Log

• 🔍 DEBUG : Traces détaillées (recherches, tokens, formulaires)
• ℹ️ INFO : Opérations importantes (démarrage, créations, succès)
• ⚠️ WARNING : Avertissements (ressources introuvables, accès refusés)
• ❌ ERROR : Erreurs (exceptions, échecs d'opérations)
• 🚨 CRITICAL : Erreurs critiques système

Filtrage

• Tous les niveaux : Affiche tous les logs
• Par niveau : Filtre par DEBUG, INFO, WARNING, ERROR ou CRITICAL

Informations Affichées

• Timestamp : Date et heure précise (avec millisecondes)
• Logger : Nom du composant ayant généré le log
• Niveau : Badge coloré selon la sévérité
• Message : Message complet (support multi-ligne)

Archivage

• Bouton "Archiver les logs" : Sauvegarde les logs actuels
• Format : app_AAAAMMJJ_HHMM.log
• Exemple : app_20251028_1226.log
• Emplacement : backend/logs/archives/
• Comportement : Identique aux logs emails

🗄️ Archives

Emplacement

Tous les fichiers archivés sont stockés dans : backend/logs/archives/

Format des Noms

• Logs emails : emails_AAAAMMJJ_HHMM.log
• Logs applicatifs : app_AAAAMMJJ_HHMM.log

Exemple : emails_20251028_1226.log = Logs emails archivés le 28 octobre 2025 à 12h26

Avantages

• ✅ Conservation de l'historique pour audit
• ✅ Pas de perte de données
• ✅ Facilite le débogage rétroactif
• ✅ Noms courts compatibles Windows
• ✅ Tri chronologique automatique

Gestion

• Les archives ne sont jamais supprimées automatiquement
• Vous pouvez les supprimer manuellement si nécessaire
• Elles sont ignorées par Git (pas de commit accidentel)

🔒 Sécurité

Accès

• Réservé aux superadmins uniquement
• Vérification des permissions sur toutes les routes

Protection des Données

• Échappement HTML : Les messages sont sécurisés contre les injections XSS
• Logs locaux : Stockés uniquement sur le serveur
• Traçabilité : Chaque archivage est tracé dans les logs applicatifs

Bonnes Pratiques

1. Archivez régulièrement pour éviter des fichiers trop volumineux
2. Surveillez les erreurs pour détecter les problèmes rapidement
3. Conservez les archives pour l'audit et la conformité
4. Nettoyez les anciennes archives si l'espace disque est limité

💡 Cas d'Usage

Débogage

1. Consultez les logs applicatifs pour identifier les erreurs
2. Filtrez par niveau ERROR ou CRITICAL
3. Analysez le timestamp et le message pour comprendre le problème

Audit des Emails

1. Consultez les logs emails pour vérifier les envois
2. Filtrez par statut pour identifier les échecs
3. Vérifiez les destinataires et sujets

Maintenance

1. Archivez les logs avant une mise à jour importante
2. Conservez les archives pour comparaison après mise à jour
3. Nettoyez les archives anciennes (> 6 mois) si nécessaire

📝 Configuration Technique

Fichiers de Logs

• Emails : backend/logs/emails.log
• Application : backend/logs/application.log
• Archives : backend/logs/archives/

Format des Logs

Emails :

================================================================================
[2025-10-28 12:26:15] SUCCESS
Destinataire: user@example.com
Sujet: Votre accès ComplianceGuard
Corps (aperçu): Bonjour, votre compte a été créé...
================================================================================

Application :

2025-10-28 12:26:15,123 - complianceguard - INFO - Démarrage de l'application
2025-10-28 12:26:16,456 - complianceguard - DEBUG - Connexion utilisateur: admin

Rotation

• Manuelle : Via le bouton "Archiver les logs"
• Automatique : Non implémentée (à faire si nécessaire)
• Limite : Aucune limite de taille (archivage manuel recommandé)

7. 🔄 Auto-Affectation

🔄 Auto-Affectation des Référentiels

Vue d'ensemble

L'auto-affectation permet d'assigner automatiquement certains référentiels à toutes les organisations (existantes et nouvelles) sans intervention manuelle.

🎯 Principe

Fonctionnement

Lorsqu'un référentiel est marqué en auto-affectation :
- Il est immédiatement affecté à toutes les organisations existantes
- Il sera automatiquement affecté à chaque nouvelle organisation créée
- Les organisations peuvent l'utiliser sans action de l'administrateur

Cas d'Usage

• Référentiels obligatoires : RGPD, ISO 27001, etc.
• Référentiels de base : Disponibles pour tous
• Référentiels de démonstration : Pour faciliter les tests

⚙️ Configuration

Accès

Menu : 👥 Organisations & Référentiels → Onglet "Par Référentiel"

Activation

1. Activer l'Auto-Affectation

1. Cliquez sur le toggle à côté du référentiel
2. Le toggle devient vert 🟢
3. Le référentiel est immédiatement affecté à toutes les organisations
4. Message : "✅ X organisation(s) affectée(s)"

2. Désactivation Intelligente

1. Cliquez sur le toggle vert pour désactiver
2. Le système vérifie les études en cours
3. Comportement :
4. ❌ Retire le référentiel des organisations sans études
5. ✅ Conserve le référentiel pour les organisations avec études en cours
6. Message détaillé : "Retiré de X org(s), conservé pour Y org(s) avec études en cours (noms)"

Protection des Données

⚠️ Important : La désactivation ne supprime jamais les études ou réponses existantes.

🔍 Interface

Vue Par Référentiel

Affichage

• Liste des référentiels avec statistiques
• Nombre d'organisations affectées
• Toggle auto-affectation (vert = actif, gris = inactif)
• Bouton de prévisualisation 👁️

Actions

• Toggle : Activer/désactiver l'auto-affectation
• Prévisualiser : Voir le contenu du référentiel
• Statistiques : Nombre d'organisations affectées

Vue Par Organisation

Affichage

• Liste des organisations avec leurs référentiels
• Référentiels affectés par organisation
• Bouton d'ajout/retrait manuel

🚀 Déclencheurs Automatiques

Au Démarrage de l'Application

• Vérification : Tous les référentiels en auto-affectation
• Synchronisation : Affectation aux organisations manquantes
• Garantie : Cohérence totale du système

À la Création d'une Organisation

• Détection : Nouvelle organisation approuvée
• Affectation : Tous les référentiels en auto-affectation
• Résultat : Organisation prête à l'emploi immédiatement

À la Création d'un Référentiel Public

• Détection : Nouveau référentiel is_public=True
• Affectation : Organisation "Démo SA" automatiquement
• Objectif : Faciliter les démonstrations

📊 Cas Pratiques

Exemple 1 : Référentiel Obligatoire (RGPD)

Situation : Le RGPD doit être disponible pour toutes les organisations.

Solution :
1. Activez l'auto-affectation sur le référentiel RGPD
2. Toutes les organisations existantes reçoivent le RGPD
3. Chaque nouvelle organisation aura automatiquement le RGPD

Résultat : Conformité garantie pour tous.

Exemple 2 : Retrait d'un Référentiel

Situation : Un référentiel de test ne doit plus être auto-affecté.

Solution :
1. Désactivez l'auto-affectation
2. Le système retire le référentiel des organisations sans études
3. Les organisations avec études en cours le conservent

Résultat : Pas de perte de données, nettoyage intelligent.

Exemple 3 : Nouvelle Organisation

Situation : Une nouvelle entreprise s'inscrit.

Solution :
1. L'administrateur approuve la demande
2. L'organisation est créée
3. Tous les référentiels en auto-affectation sont affectés automatiquement

Résultat : Organisation opérationnelle immédiatement.

🔒 Sécurité et Permissions

Accès

• Superadmin : Gestion complète de l'auto-affectation
• Admin : Consultation uniquement (pas de modification)
• Autres rôles : Pas d'accès

Traçabilité

• Chaque activation/désactivation est tracée dans les logs
• Les affectations automatiques sont enregistrées en base
• Audit complet des actions

💡 Bonnes Pratiques

Référentiels à Auto-Affecter

✅ Recommandé :
- Référentiels obligatoires (RGPD, ISO 27001)
- Référentiels de base (qualité, sécurité)
- Référentiels de démonstration

❌ Déconseillé :
- Référentiels spécifiques à un secteur
- Référentiels payants ou premium
- Référentiels en cours de développement

Gestion

1. Activez l'auto-affectation pour les référentiels de base
2. Surveillez le nombre d'organisations affectées
3. Désactivez si un référentiel devient obsolète
4. Vérifiez régulièrement la cohérence

Maintenance

• Revue trimestrielle : Vérifier les référentiels auto-affectés
• Nettoyage : Désactiver les référentiels non utilisés
• Documentation : Tenir à jour la liste des référentiels obligatoires

🛠️ Technique

Base de Données

Table norms

- id: INTEGER PRIMARY KEY
- name: TEXT
- auto_assign_to_new_orgs: BOOLEAN  -- Flag d'auto-affectation
- is_public: BOOLEAN

Table client_norms

- id: INTEGER PRIMARY KEY
- client_id: INTEGER  -- Organisation
- norm_id: INTEGER    -- Référentiel

Logique d'Affectation

Activation

# 1. Mettre le flag à True
norm.auto_assign_to_new_orgs = True

# 2. Récupérer toutes les organisations (sauf Moujik)
clients = db.query(Client).filter(Client.name != "Moujik").all()

# 3. Affecter à chaque organisation
for client in clients:
    if not exists(client, norm):
        create_client_norm(client, norm)

Désactivation

# 1. Mettre le flag à False
norm.auto_assign_to_new_orgs = False

# 2. Pour chaque organisation
for client in clients:
    # Vérifier s'il y a des études en cours
    has_studies = db.query(QuestionAnswer).join(Study).filter(
        Study.client_id == client.id,
        Study.norm_id == norm.id
    ).first()

    # Retirer uniquement si pas d'études
    if not has_studies:
        delete_client_norm(client, norm)

Exclusions

• Organisation "Moujik" : Toujours exclue de l'auto-affectation
• Référentiels privés : Peuvent être auto-affectés si nécessaire
• Organisations inactives : Incluses dans l'auto-affectation

📈 Statistiques

Métriques Disponibles

• Nombre de référentiels en auto-affectation
• Nombre d'organisations affectées par référentiel
• Nombre d'affectations automatiques créées

Suivi

Consultez les logs applicatifs pour voir :
- Les activations/désactivations d'auto-affectation
- Les affectations automatiques au démarrage
- Les affectations lors de création d'organisation

8. 👁️ Prévisualisation Publique

👁️ Prévisualisation Publique des Référentiels

Vue d'ensemble

La prévisualisation publique permet aux visiteurs non connectés de consulter le contenu des référentiels publics avant de s'inscrire.

🌐 Accès Public

Référentiels Publics

Les référentiels marqués comme publics (is_public=True) sont accessibles sans connexion :
- ISO 27001, RGPD, DORA, NIS-2, ISO 27002
- ISO 9001, ISO 14001, ISO 45001
- Référentiels "Vie Quotidienne" (IKEA, Voyage, Mariage, etc.)

Référentiels Privés

Les référentiels privés nécessitent une connexion :
- Redirection automatique vers /login
- Accès après authentification selon les permissions

🔗 URLs de Prévisualisation

Par ID

Format : /norms/{id}/preview

Exemple : /norms/1/preview

Usage : Liens directs depuis l'interface

Par Nom (Recommandé)

Format : /norms/preview?name={nom_exact}

Exemple : /norms/preview?name=ISO%2027001%3A2022%20-%20S%C3%A9curit%C3%A9%20de%20l%27information

Usage : Liens dans la documentation publique

Avantages :
- URLs lisibles et mémorisables
- Indépendant des IDs (peuvent changer)
- Meilleure expérience utilisateur

📚 Noms Exacts des Référentiels

Conformité et Sécurité

• ISO 27001:2022 - Sécurité de l'information
• RGPD - Protection des données personnelles
• DORA - Résilience opérationnelle numérique
• NIS-2 - Sécurité des réseaux et systèmes d'information
• ISO 27002:2022 - Contrôles de sécurité

Qualité et Environnement

• ISO 9001:2015 - Management de la qualité
• ISO 14001:2015 - Management environnemental
• ISO 45001:2018 - Santé et sécurité au travail

Vie Quotidienne

• Montage Meuble IKEA
• Préparation Voyage Parfait
• Organisation Mariage Parfait
• Révision Complète Véhicule
• Entretien Saisonnier Maison
• Adoption Animal de Compagnie
• Déménagement Sans Stress

⚠️ Important : Les noms doivent correspondre exactement (casse, espaces, ponctuation).

🎨 Interface de Prévisualisation

Affichage

• Titre du référentiel
• Description complète
• Catégories et sections
• Questions avec leurs détails
• Mode lecture seule (pas d'édition)

Éléments Visibles

• ✅ Structure complète du référentiel
• ✅ Toutes les questions et leurs descriptions
• ✅ Catégories et organisation
• ❌ Réponses (non applicables en prévisualisation)
• ❌ Plans d'action (non applicables)

Bannière

Pour les visiteurs non connectés :

ℹ️ Vous consultez ce référentiel en mode prévisualisation.
   Inscrivez-vous pour créer des études et suivre votre conformité.

🔒 Sécurité et Permissions

Visiteurs Non Connectés

• Accès : Référentiels publics uniquement
• Mode : Lecture seule
• Redirection : Vers /login si référentiel privé

Utilisateurs Connectés

• Accès : Référentiels publics + référentiels affectés
• Mode : Lecture seule en prévisualisation
• Permissions : Vérification habituelle (ownership, superadmin)

Vérification

1. Tentative de récupération du token JWT (optionnel)
2. Si token invalide/expiré : user = None (pas d'erreur)
3. Vérification is_public du référentiel
4. Si privé et non connecté : redirection /login
5. Si privé et connecté : vérification ownership

📝 Documentation Publique

Intégration

La page d'accueil publique (/documentation) liste tous les référentiels disponibles avec des liens de prévisualisation.

Format des Liens

[ISO 27001](/norms/preview?name=ISO%2027001%3A2022%20-%20S%C3%A9curit%C3%A9%20de%20l%27information)

Catégorisation

• 🔐 Conformité et Sécurité
• 🏆 Qualité et Environnement
• 🏠 Vie Quotidienne

🛠️ Technique

Ordre des Routes (CRITIQUE)

⚠️ TRÈS IMPORTANT : L'ordre de déclaration des routes dans FastAPI est crucial !

# ✅ CORRECT : /norms/preview AVANT /norms/{norm_id}
@app.get("/norms/preview")
async def preview_by_name(...):
    # Recherche par nom

@app.get("/norms/{norm_id}/preview")
async def preview_by_id(...):
    # Prévisualisation par ID

@app.get("/norms/{norm_id}")
async def get_norm(...):
    # Détails du référentiel (authentification requise)

Raison : Si /norms/preview est après /norms/{norm_id}, FastAPI matche /norms/preview avec norm_id="preview", ce qui déclenche la dépendance get_current_user_from_cookie et redirige vers /login.

Décodage JWT Optionnel

from jose import jwt, JWTError

try:
    token = request.cookies.get("access_token")
    if token:
        payload = jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM])
        user = get_user_from_payload(payload)
    else:
        user = None
except JWTError:
    user = None  # Token invalide, pas d'erreur

Contexte Template

{
    "is_authenticated": bool(user),
    "user_role": user.role if user else "public",
    "user": user,
    "norm": norm,
    "readonly": True
}

💡 Cas d'Usage

Cas 1 : Visiteur Découvre le RGPD

1. Visiteur arrive sur /documentation
2. Clique sur "RGPD - Protection des données personnelles"
3. Redirigé vers /norms/preview?name=RGPD...
4. Consulte le contenu complet en lecture seule
5. Décide de s'inscrire pour créer une étude

Cas 2 : Client Partage un Référentiel

1. Client veut montrer un référentiel à un prospect
2. Copie l'URL de prévisualisation
3. Envoie le lien au prospect
4. Prospect consulte sans connexion
5. Prospect s'inscrit après avoir vu le contenu

Cas 3 : Référentiel Privé

1. Visiteur tente d'accéder à un référentiel privé
2. Système détecte is_public=False
3. Redirection vers /login?next=/norms/{id}/preview
4. Après connexion, vérification des permissions
5. Accès accordé si autorisé

📊 Avantages

Pour les Visiteurs

• ✅ Découverte du contenu avant inscription
• ✅ Transparence sur les référentiels disponibles
• ✅ Décision éclairée pour s'inscrire ou non

Pour l'Entreprise

• ✅ Marketing : Montre la valeur du produit
• ✅ Conversion : Incite à l'inscription
• ✅ Crédibilité : Démontre l'expertise

Pour les Clients

• ✅ Partage facile avec des prospects
• ✅ Démonstration sans créer de compte
• ✅ Validation du contenu avant achat

🎯 Bonnes Pratiques

Référentiels à Rendre Publics

✅ Recommandé :
- Référentiels de démonstration
- Référentiels standards (ISO, RGPD)
- Référentiels "Vie Quotidienne"

❌ Déconseillé :
- Référentiels propriétaires
- Référentiels clients spécifiques
- Référentiels en cours de développement

Maintenance

1. Vérifiez régulièrement les liens de prévisualisation
2. Mettez à jour la documentation publique
3. Testez l'accès sans connexion
4. Surveillez les statistiques de consultation

Communication

• Incluez les liens de prévisualisation dans les emails marketing
• Partagez sur les réseaux sociaux
• Intégrez dans les présentations commerciales
• Utilisez dans la documentation externe

9. 📚 Documentation

📚 Maintenance de la Documentation

🎯 Vue d'ensemble

En tant que superadmin, vous êtes responsable de maintenir la documentation à jour avec des captures d'écran et des diagrammes.

Cette page sert également de mémo pour les fonctionnalités clés à documenter, notamment :

• La création et l'assignation des actions (plans d'action)
• L'intégration avec le calendrier
• La gestion des lots d'actions (batchs)

📸 Gestion des Captures d'Écran

Outils nécessaires

Windows 11

• Outil Capture : Win + Shift + S (natif)
• ShareX (recommandé) : https://getsharex.com/
• ScreenToGif : Pour les animations GIF

Installation ShareX

1. Télécharger depuis https://getsharex.com/
2. Installer l'application
3. Configurer :
4. Format : PNG
5. Qualité : 90%
6. Destination : Dossier personnalisé

Préparation

Checklist avant de commencer

• [ ] Serveur démarré (.\scripts\dev.ps1 -Start)
• [ ] Données de démo créées
• [ ] Navigateur en mode normal (pas d'extensions visibles)
• [ ] Résolution écran : 1920x1080 ou 1280x720
• [ ] Zoom navigateur : 100%
• [ ] Fond d'écran neutre

Organisation des fichiers

backend/app/documentation/images/
├── user/                    # Captures utilisateur
│   ├── creer-etude-01.png
│   ├── creer-etude-02.png
│   ├── plan-action-kanban.png
│   ├── plan-action-dragdrop.gif
│   └── historique-versions.png
├── validateur/              # Captures validateur
│   ├── valider-etude.png
│   ├── invalider-commentaire.png
│   └── suivi-demandes.png
├── admin/                   # Captures admin
│   ├── creer-utilisateur.png
│   ├── gerer-services.png
│   └── affecter-referentiels.png
├── superadmin/              # Captures superadmin
│   ├── creer-organisation.png
│   ├── gestion-referentiels.png
│   └── bibliotheque-questions.png
└── workflow/                # Diagrammes
    ├── workflow-complet.png
    └── workflow-complet.drawio

Liste des captures à réaliser

🔴 Priorité Haute (14 captures + nouvelles vues Actions/Calendrier)

Utilisateur (5 captures)

1. creer-etude-01.png - Formulaire de création d'étude
2. Page : /studies/create

3. Contenu : Sélection référentiel, champ nom, bouton créer

4. creer-etude-02.png - Questionnaire en cours

5. Page : /studies/{id}/edit

6. Contenu : Questions, boutons réponse, barre progression

7. plan-action-kanban.png - Vue Kanban

8. Page : /studies/{id} (onglet Plan d'action)

9. Contenu : Colonnes Kanban, cartes d'actions, compteurs

10. plan-action-dragdrop.gif - Animation drag & drop

11. Page : /studies/{id} (onglet Plan d'action)

12. Contenu : Déplacement d'une carte entre colonnes

13. historique-versions.png - Liste des versions

14. Page : /studies/{id} (onglet Historique)
15. Contenu : Versions, dates, auteurs, types

Validateur (3 captures)

1. valider-etude.png - Bouton de validation
2. Page : /studies/{id} (onglet Résultats)

3. Contenu : Bouton valider, score, graphique

4. invalider-commentaire.png - Modal d'invalidation

5. Page : Modal d'invalidation

6. Contenu : Champ commentaire, bouton invalider

7. suivi-demandes.png - Liste des études en attente

8. Page : /studies (filtré)
9. Contenu : Liste études, filtres, statuts

Admin (3 captures)

1. creer-utilisateur.png - Formulaire création utilisateur
2. Page : /organisation-users (modal)

3. Contenu : Champs formulaire, sélecteur rôle

4. gerer-services.png - Liste des services

5. Page : /services

6. Contenu : Liste services, boutons actions

7. affecter-referentiels.png - Affectation référentiels

8. Page : /admin/assign-norms
9. Contenu : Sélection organisation, checkboxes

Superadmin (3 captures)

1. creer-organisation.png - Formulaire création organisation
2. Page : /organisations (modal)

3. Contenu : Formulaire complet, sélecteur statut

4. gestion-referentiels.png - Liste des référentiels

5. Page : /admin/norms

6. Contenu : Liste référentiels, actions

7. bibliotheque-questions.png - Bibliothèque de questions

8. Page : /admin/questions
9. Contenu : Liste questions, filtres

Actions & Calendrier (nouvelles captures)

1. plan-action-creation-assignment-scopes.png
2. Page : /admin/action-plans/{id} (modal "Nouvelle action")

3. Contenu : champs principaux + liste des scopes d'assignation :

   • 👤 Utilisateur individuel
   • 👥 Tous les utilisateurs d'un rôle (superadmin)
   • 🏛️ Service entier
   • 🏢 Organisation entière (avec sélecteur d'organisation pour superadmin)
   • 🌍 Tous les utilisateurs de la plateforme

4. plan-action-detail-batch.png

5. Page : /admin/action-plans/{id}

6. Contenu :

   • Une ligne "Lot d'assignation" dans le tableau des actions
   • Badge "X actions individuelles"
   • Bloc déployé montrant les actions détaillées (utilisateurs, priorités, échéances)

7. calendrier-actions-auto.png

8. Page : /calendar
9. Contenu :
   • Événements d'actions créés automatiquement (avec préfixe 📋)
   • Exemple d'action datée (due_date) + action sans due_date (positionnée à aujourd'hui)
   • Si possible, un exemple issu d'une assignation de masse (plusieurs utilisateurs le même jour)

Bonnes pratiques

Format et qualité

• Format : PNG pour images statiques
• Format : GIF pour animations (< 5 Mo)
• Résolution : 1920x1080 ou 1280x720
• Compression : Optimiser avec TinyPNG
• Taille : < 500 Ko par image

Contenu

• ✅ Masquer les données sensibles
• ✅ Utiliser des données de démo
• ✅ Annoter les points importants (flèches, encadrés)
• ✅ Fond d'écran neutre
• ✅ Zoom sur les éléments importants

Nommage

• Format : [section]-[action]-[numero].png
• Exemples :
• creer-etude-01.png
• plan-action-kanban.png
• valider-etude.png

Intégration dans la documentation

Syntaxe Markdown

![Description](../images/user/creer-etude-01.png)

Avec légende

![Création d'une étude](../images/user/creer-etude-01.png)
*Figure 1 : Page de création d'une nouvelle étude*

GIF animé

![Drag & Drop](../images/user/plan-action-dragdrop.gif)
*Animation : Déplacer une action par drag & drop*

Mise à jour

Quand mettre à jour les captures

• Changement majeur d'interface
• Nouvelles fonctionnalités
• Correction de bugs visuels
• Feedback utilisateurs

Processus de mise à jour

1. Identifier les captures obsolètes
2. Préparer l'environnement
3. Réaliser les nouvelles captures
4. Optimiser les images
5. Remplacer dans le dossier images/
6. Vérifier l'affichage dans la doc

🎨 Gestion des Diagrammes

Outil : draw.io

Accès

https://app.diagrams.net/

Avantages

• ✅ Gratuit et en ligne
• ✅ Pas d'installation nécessaire
• ✅ Export multiple formats
• ✅ Sauvegarde locale (.drawio)

Configuration du Canvas

Nouveau diagramme

1. Aller sur https://app.diagrams.net/
2. Cliquer sur "Create New Diagram"
3. Sélectionner "Blank Diagram"
4. Nommer : workflow-complet

Paramètres

• Taille : 1200 x 2400 px
• Grille : Activée (20px)
• Snap to Grid : Activé
• Background : Blanc

Palette de couleurs

Par rôle

• Superadmin : #3498db (Bleu)
• Admin : #2ecc71 (Vert)
• Validateur : #f39c12 (Orange)
• Utilisateur : #e74c3c (Rouge)
• Processus : #95a5a6 (Gris)

Texte

• Couleur : Blanc (#FFFFFF)
• Police : Arial
• Taille : 14pt (titres), 12pt (contenu)

Formes à utiliser

Rectangles arrondis (Étapes)

• Largeur : 200px
• Hauteur : 60px
• Rayon : 10px
• Bordure : 2px, #2c3e50

Losanges (Décisions)

• Largeur : 150px
• Hauteur : 100px
• Bordure : 2px, #2c3e50

Flèches (Connexions)

• Épaisseur : 2px
• Couleur : #34495e
• Style : Ligne droite avec flèche

Structure du diagramme

Phase 1 : Configuration (Superadmin)

SUPERADMIN (Bleu)
    ↓
Créer Organisation
    ↓
Affecter Référentiels
    ↓

Phase 2 : Gestion (Admin)

ADMIN (Vert)
    ↓
Créer Services
    ↓
Créer Utilisateurs
    ↓

Phase 3 : Évaluation (Utilisateur)

UTILISATEUR (Rouge)
    ↓
Créer Étude
    ↓
Remplir Questionnaire
    ↓
Demander Validation
    ↓

Phase 4 : Validation (Validateur)

VALIDATEUR (Orange)
    ↓
┌────┴────┐
│         │
▼         ▼
Valider  Invalider
  ✅       ❌
  │        │
  │        └──► Corrections ──┐
  │                           │
  └───────────────────────────┘
              ↓

Phase 5 : Suivi (Utilisateur)

Plan d'Action (Rouge)
    ↓
Historique
    ↓
Exports

Icônes à utiliser

• 🔧 Superadmin
• 👨‍💼 Admin
• ✅ Validateur
• 👤 Utilisateur
• 📝 Créer
• 📊 Résultats
• 📋 Plan d'action
• 📸 Version
• ✅ Valider
• ❌ Invalider

Export

Format PNG (recommandé)

1. File → Export as → PNG
2. Résolution : 300 DPI
3. Transparent background : Non
4. Border width : 10px
5. Nom : workflow-complet.png
6. Emplacement : backend/app/documentation/images/workflow/

Format SVG (optionnel)

1. File → Export as → SVG
2. Embed fonts : Oui
3. Nom : workflow-complet.svg

Sauvegarder le fichier source

1. File → Save as
2. Format : .drawio
3. Nom : workflow-complet.drawio
4. Emplacement : Même dossier que les exports

⚠️ Important : Toujours sauvegarder le fichier .drawio pour faciliter les modifications futures !

Intégration dans la documentation

Dans workflow.md

## 📊 Diagramme Visuel

![Workflow de la plateforme](../images/workflow/workflow-complet.png)
*Figure 1 : Workflow complet de la plateforme*

Mise à jour

Quand mettre à jour le diagramme

• Ajout d'une nouvelle phase
• Modification du workflow
• Nouveau rôle
• Changement majeur de processus

Processus de mise à jour

1. Ouvrir le fichier workflow-complet.drawio
2. Effectuer les modifications
3. Exporter en PNG (300 DPI)
4. Remplacer l'ancien PNG
5. Vérifier l'affichage dans la documentation
6. Sauvegarder le .drawio mis à jour

📋 Checklist de Maintenance

Mensuelle

• [ ] Vérifier que toutes les captures sont à jour
• [ ] Vérifier que le diagramme reflète le workflow actuel
• [ ] Optimiser les images trop lourdes
• [ ] Vérifier les liens dans la documentation

Après chaque mise à jour majeure

• [ ] Identifier les captures impactées
• [ ] Réaliser les nouvelles captures
• [ ] Mettre à jour le diagramme si nécessaire
• [ ] Tester l'affichage dans tous les navigateurs

Annuelle

• [ ] Refaire toutes les captures avec le design actuel
• [ ] Recréer le diagramme si changements importants
• [ ] Archiver les anciennes versions
• [ ] Documenter les changements

🛠️ Outils Recommandés

Captures d'écran

• ShareX : https://getsharex.com/ (Windows)
• Greenshot : https://getgreenshot.org/ (Windows)
• ScreenToGif : https://www.screentogif.com/ (GIF)

Édition d'images

• Paint.NET : https://www.getpaint.net/ (Windows)
• GIMP : https://www.gimp.org/ (Multiplateforme)

Compression

• TinyPNG : https://tinypng.com/ (En ligne)
• ImageOptim : https://imageoptim.com/ (Mac)

Diagrammes

• draw.io : https://app.diagrams.net/ (En ligne)
• Excalidraw : https://excalidraw.com/ (En ligne, style dessiné)

❓ Questions fréquentes

Q : Quelle résolution pour les captures ?
R : 1920x1080 ou 1280x720, selon la taille de votre écran.

Q : Comment annoter les captures ?
R : Utiliser ShareX ou Paint.NET pour ajouter flèches et encadrés.

Q : Faut-il refaire toutes les captures après chaque mise à jour ?
R : Non, seulement celles des pages modifiées.

Q : Le diagramme doit-il être en PNG ou SVG ?
R : PNG pour la compatibilité, mais garder le .drawio pour les modifications.

Q : Comment optimiser les GIF ?
R : Limiter à 5 secondes, réduire la résolution, supprimer les frames inutiles.

Q : Où trouver les données de démo ?
R : Organisation "Démo SA" créée automatiquement au démarrage.

📞 Support

Pour toute question sur la maintenance de la documentation :
- Consulter backend/app/documentation/images/README.md
- Consulter backend/app/documentation/GUIDE_CAPTURES.md
- Consulter backend/app/documentation/images/workflow/INSTRUCTIONS_DRAWIO.md

10. 🏢 Organisations

🏢 Gérer les Organisations

📋 Vue d'ensemble

En tant qu'admin, vous gérez votre organisation et ses paramètres.

⚙️ Paramètres de l'organisation

Accéder aux paramètres

1. Menu utilisateur (dropdown)
2. "Paramètres de l'organisation" (si superadmin)
3. Modifier les informations

Informations modifiables

• Nom de l'organisation
• SIREN (identifiant unique)
• Adresse complète
• Email de contact
• Téléphone
• Logo (optionnel)

Statut de l'organisation

• Trial : Période d'essai (fonctionnalités limitées)
• Active : Organisation active (toutes fonctionnalités)
• Inactive : Organisation désactivée

🏛️ Gérer les services

Créer un service

1. Menu "Services"
2. Cliquer sur "Nouveau service"
3. Remplir :
4. Nom du service (ex: IT, RH, Finance)
5. Description (optionnel)
6. Cliquer sur "Créer"

Modifier un service

1. Liste des services
2. Cliquer sur "Modifier"
3. Mettre à jour les informations
4. Enregistrer

Supprimer un service

1. Liste des services
2. Cliquer sur "Supprimer"
3. Confirmer (les utilisateurs seront désaffectés)

Affecter des utilisateurs

1. Lors de la création/modification d'un utilisateur
2. Sélectionner le service dans la liste déroulante
3. Enregistrer

📊 Statistiques

Indicateurs disponibles

• Nombre d'utilisateurs par rôle
• Nombre d'études par statut
• Taux de conformité moyen
• Nombre d'études validées/invalidées

Accès aux statistiques

1. Menu "Tableau de bord"
2. Consulter les graphiques et tableaux
3. Filtrer par période si disponible

💡 Bonnes pratiques

✅ Structure des services

• Créer des services logiques et clairs
• Aligner avec l'organigramme réel
• Ne pas créer trop de services (max 10-15)

✅ Maintenance

• Mettre à jour les informations régulièrement
• Vérifier les affectations des utilisateurs
• Nettoyer les services inutilisés

✅ Communication

• Informer les utilisateurs des changements
• Documenter l'organisation des services
• Former les nouveaux admins

❓ Questions fréquentes

Q : Puis-je renommer mon organisation ?
R : Oui, via les paramètres (si superadmin) ou en contactant le support.

Q : Combien de services puis-je créer ?
R : Illimité, mais restez raisonnable (10-15 max recommandé).

Q : Puis-je supprimer un service avec des utilisateurs ?
R : Oui, mais les utilisateurs seront désaffectés du service.

Q : Les services sont-ils visibles par tous ?
R : Oui, tous les utilisateurs de l'organisation voient les services.

11. 👥 Utilisateurs

👥 Gérer les Utilisateurs

📋 Vue d'ensemble

En tant qu'admin, vous gérez les utilisateurs de votre organisation.

➕ Créer un utilisateur

Processus de création

1. Menu "Utilisateurs" (dropdown superadmin)
2. Cliquer sur "Nouvel utilisateur"
3. Remplir le formulaire :
4. Nom d'utilisateur (unique)
5. Email (unique)
6. Mot de passe (temporaire)
7. Rôle (utilisateur, validateur, admin)
8. Organisation (la vôtre par défaut)
9. Service (optionnel)
10. Cliquer sur "Créer"
11. L'utilisateur reçoit un email avec ses identifiants

Rôles disponibles

👤 Utilisateur

• Créer et remplir des études
• Gérer son plan d'action
• Exporter ses résultats
• Ne peut pas valider ou gérer d'autres utilisateurs

✅ Validateur

• Tout ce que l'utilisateur peut faire
• Valider/Invalider des études
• Voir toutes les études de l'organisation
• Ne peut pas gérer les utilisateurs

👨‍💼 Admin

• Tout ce que le validateur peut faire
• Gérer les utilisateurs de son organisation
• Créer des services
• Voir les statistiques
• Ne peut pas gérer d'autres organisations

✏️ Modifier un utilisateur

Informations modifiables

1. Liste des utilisateurs
2. Cliquer sur "Modifier"
3. Modifier :
4. Email
5. Rôle
6. Service
7. Statut (actif/inactif)
8. Enregistrer

Changer le rôle

• Peut promouvoir utilisateur → validateur → admin
• Peut rétrograder admin → validateur → utilisateur
• Attention : Vérifier les permissions avant de changer

Désactiver un compte

1. Modifier l'utilisateur
2. Cocher "Inactif"
3. L'utilisateur ne peut plus se connecter
4. Ses données sont conservées

🔑 Réinitialiser un mot de passe

Processus

1. Liste des utilisateurs
2. Cliquer sur "Réinitialiser le mot de passe"
3. Un nouveau mot de passe temporaire est généré
4. L'utilisateur reçoit un email
5. Il devra le changer à la première connexion

📊 Suivre les utilisateurs

Informations visibles

• Nom et email
• Rôle et service
• Date de création
• Dernière connexion
• Nombre d'études créées
• Statut (actif/inactif)

Filtres disponibles

• Par rôle
• Par service
• Par statut
• Par activité récente

🔒 Sécurité

Bonnes pratiques

✅ Création de comptes

• Vérifier l'identité avant de créer
• Attribuer le rôle minimum nécessaire
• Utiliser des emails professionnels

✅ Gestion des accès

• Réviser les rôles régulièrement
• Désactiver les comptes des départs
• Révoquer les accès inutilisés

✅ Mots de passe

• Imposer des mots de passe forts
• Forcer le changement régulier
• Ne jamais partager les identifiants

⚠️ Erreurs à éviter

❌ Trop d'admins

• Ne pas donner le rôle admin à tout le monde
• Limiter aux personnes qui en ont vraiment besoin
• Préférer le rôle validateur si suffisant

❌ Comptes inactifs

• Ne pas laisser des comptes actifs pour des personnes parties
• Désactiver immédiatement en cas de départ
• Nettoyer régulièrement

❌ Mauvaise affectation

• Vérifier le service avant d'affecter
• S'assurer que le rôle correspond aux responsabilités
• Documenter les changements importants

📧 Communication

Notifications automatiques

• Email de bienvenue avec identifiants
• Email de réinitialisation de mot de passe
• Notifications de changement de rôle

Communication manuelle

• Informer des changements de rôle
• Expliquer les responsabilités
• Former aux nouvelles fonctionnalités

💡 Cas d'usage

Cas 1 : Nouvel employé

1. Créer le compte (rôle: utilisateur)
2. Affecter au bon service
3. Envoyer un email de bienvenue personnalisé
4. Planifier une formation
5. Suivre les premières connexions

Cas 2 : Promotion

1. Modifier le rôle (utilisateur → validateur)
2. Informer l'utilisateur
3. Former aux nouvelles responsabilités
4. Suivre les premières validations

Cas 3 : Départ

1. Désactiver le compte immédiatement
2. Réaffecter ses études en cours
3. Archiver ses données si nécessaire
4. Documenter le départ

❓ Questions fréquentes

Q : Combien d'utilisateurs puis-je créer ?
R : Selon votre plan (trial: limité, active: illimité).

Q : Puis-je supprimer un utilisateur ?
R : Non, vous pouvez seulement le désactiver pour conserver l'historique.

Q : Un utilisateur peut-il avoir plusieurs rôles ?
R : Non, un seul rôle par utilisateur.

Q : Puis-je gérer des utilisateurs d'autres organisations ?
R : Non, seulement ceux de votre organisation.

Q : Comment voir qui a créé un utilisateur ?
R : Cette information est dans l'historique (si disponible).

12. 📚 Référentiels

📚 Gérer les Référentiels

📋 Vue d'ensemble

Les référentiels sont les cadres normatifs (ISO 27001, RGPD, etc.) sur lesquels sont basées les études.

🔍 Consulter les référentiels

Accès

1. Menu "Référentiels"
2. Voir tous les référentiels disponibles pour votre organisation

Informations affichées

• Nom du référentiel (ex: ISO 27001)
• Description
• Type (public/privé)
• Nombre de questions
• Nombre d'études basées dessus
• Statut (actif/inactif)

📊 Référentiels publics vs privés

Référentiels publics

• ✅ Créés par les superadmins
• ✅ Disponibles pour toutes les organisations (si affectés)
• ✅ Basés sur des normes officielles
• ✅ Maintenus par l'équipe technique
• ❌ Non modifiables par les admins

Exemples :
- ISO 27001 (Sécurité de l'information)
- RGPD (Protection des données)
- ISO 22301 (Continuité d'activité)
- DORA (Résilience opérationnelle digitale)
- NIS2 (Cybersécurité)

Référentiels privés

• ✅ Créés par votre organisation
• ✅ Personnalisés selon vos besoins
• ✅ Modifiables par les admins
• ❌ Non partagés avec d'autres organisations

Cas d'usage :
- Politiques internes
- Procédures spécifiques
- Audits personnalisés
- Checklists métier

🎯 Affectation des référentiels

Comment sont affectés les référentiels ?

Pour les référentiels publics

• Affectés par le superadmin
• Via le menu "Affectation des Référentiels"
• L'admin ne peut pas les affecter lui-même

Pour les référentiels privés

• Créés directement dans votre organisation
• Automatiquement disponibles pour vos utilisateurs

Demander un nouveau référentiel public

1. Contacter votre superadmin
2. Indiquer le référentiel souhaité
3. Le superadmin l'affecte à votre organisation

📖 Utilisation des référentiels

Par les utilisateurs

• Sélectionner un référentiel lors de la création d'une étude
• Répondre aux questions du référentiel
• Obtenir un score de conformité

Statistiques

• Nombre d'études par référentiel
• Scores moyens de conformité
• Référentiels les plus utilisés

💡 Bonnes pratiques

✅ Choix des référentiels

• Affecter uniquement les référentiels pertinents
• Ne pas surcharger avec trop de référentiels
• Former les utilisateurs aux référentiels disponibles

✅ Suivi

• Suivre l'utilisation de chaque référentiel
• Identifier les référentiels inutilisés
• Demander des mises à jour si nécessaire

✅ Communication

• Informer les utilisateurs des nouveaux référentiels
• Expliquer l'intérêt de chaque référentiel
• Partager les bonnes pratiques

🔄 Mises à jour des référentiels

Référentiels publics

• Mis à jour par les superadmins
• Notifications des changements importants
• Les études existantes ne sont pas affectées
• Nouvelles études utilisent la version à jour

Référentiels privés

• Modifiables par les admins
• Attention aux impacts sur les études en cours
• Documenter les changements

❓ Questions fréquentes

Q : Puis-je créer mes propres référentiels ?
R : Oui, en tant qu'admin vous pouvez créer des référentiels privés (fonctionnalité à venir).

Q : Puis-je modifier un référentiel public ?
R : Non, seuls les superadmins peuvent modifier les référentiels publics.

Q : Combien de référentiels puis-je avoir ?
R : Illimité, mais restez raisonnable pour ne pas perdre vos utilisateurs.

Q : Puis-je supprimer un référentiel ?
R : Non si des études l'utilisent. Vous pouvez le désactiver.

Q : Les référentiels sont-ils multilingues ?
R : Actuellement en français uniquement. Autres langues à venir.

🎓 Référentiels disponibles

Sécurité de l'information

• ISO 27001 : Système de management de la sécurité de l'information
• ISO 27002 : Bonnes pratiques pour la sécurité de l'information
• NIS2 : Directive sur la cybersécurité

Protection des données

• RGPD : Règlement Général sur la Protection des Données
• ISO 27701 : Extension de l'ISO 27001 pour la vie privée

Continuité d'activité

• ISO 22301 : Système de management de la continuité d'activité
• DORA : Résilience opérationnelle digitale

Autres

• ISO 9001 : Système de management de la qualité
• HDS : Hébergement de Données de Santé

Liste non exhaustive. Contactez votre superadmin pour plus d'informations.

13. 🔧 Gestion des référentiels

📚 Gestion des Référentiels (Admin)

Studio des Référentiels

L'interface Studio (/admin/referentiels/studio) permet de gérer tous les référentiels de votre organisation.

🔍 Types de référentiels

Référentiels Publics

• Créés par le système
• Accessibles à toutes les organisations
• Peuvent être clonés pour personnalisation

Référentiels Privés

• Créés par votre organisation
• Visibles uniquement par votre organisation
• Entièrement personnalisables

Référentiels Clonés

• Copies de référentiels publics
• Appartiennent à votre organisation
• Peuvent être modifiés librement

📋 Actions disponibles

Cloner un référentiel public

1. Dans la liste, repérez un référentiel public
2. Cliquez sur "Cloner"
3. Le référentiel est copié dans votre organisation
4. Vous pouvez maintenant le modifier

Note : Le clone est indépendant de l'original. Les modifications de l'original n'affectent pas votre clone.

Gérer les doublons à l'import

Lors de l'import d'un référentiel :
- Si le nom existe déjà, un compteur est ajouté automatiquement
- Exemple : ISO 27001 devient ISO 27001 (2)
- Vous êtes informé du changement de nom

Supprimer un référentiel

Pour les Admins

Vous pouvez supprimer un référentiel si :
- Il est inactif (désactivé)
- Il n'a aucune attribution à une organisation
- Il n'a aucune étude en cours

Si des attributions existent, vous devez d'abord les retirer manuellement.

Pour les Superadmins

Les superadmins peuvent supprimer n'importe quel référentiel :
- Les attributions sont retirées automatiquement
- Les études associées sont également supprimées
- Une confirmation est demandée

📤 Import de référentiels

Format JSON

Les référentiels s'importent au format JSON avec la structure :

{
  "metadata": {
    "name": "Nom du référentiel",
    "category": "conformite",
    "description": "Description..."
  },
  "sections": [...],
  "questions": [...]
}

Accès

1. Allez sur /admin/referentiels/import
2. Collez votre JSON ou uploadez un fichier
3. Cliquez sur "Importer"

🎯 Prévisualisation

Avant d'activer un référentiel, vous pouvez le prévisualiser :
1. Cliquez sur l'icône 👁️ dans la liste
2. Consultez toutes les sections et questions
3. Vérifiez le contenu avant activation

⚙️ Activation/Désactivation

• Actif : Le référentiel peut être utilisé pour créer des études
• Inactif : Le référentiel est masqué mais conservé

Pour changer le statut, utilisez le toggle dans la liste.

💡 Bonnes pratiques

• Clonez les référentiels publics avant de les modifier
• Prévisualisez toujours avant d'activer
• Désactivez plutôt que supprimer (conservation de l'historique)
• Documentez vos modifications dans la description

14. 📋 Actions & Calendrier

📋 Actions & Calendrier

🎯 Objectif

Cette page explique comment fonctionnent les actions dans les plans d'action, leurs modes d'assignation, et la façon dont elles sont intégrées automatiquement au calendrier.

Elle s'adresse principalement aux admins et superadmins.

1. Création d'une action dans un plan

• Page : /admin/action-plans/{id}
• Bouton : Nouvelle action

Champs principaux :
- Titre (obligatoire)
- Description (optionnelle)
- Type d'action (optionnel)
- Priorité : Basse, Moyenne, Haute, Critique
- Criticité / Effort / Impact : utilisés pour calculer un score de priorisation
- Date d'échéance (due_date) :
- Si renseignée, l'action sera positionnée à cette date dans le calendrier.
- Sinon, l'action sera positionnée à la date du jour dans le calendrier.

2. Scopes d'assignation des actions

Lors de la création d'une action, le champ Assignation permet de définir le scope de l'action.

2.1. Utilisateur individuel

• Choix d'un utilisateur unique dans la liste.
• L'action est :
• liée à cet utilisateur (assigned_to_user_id),
• créée une seule fois.

2.2. Tous les utilisateurs d'un rôle (superadmin)

• Accessible uniquement au superadmin.
• Étapes :
• Choisir un rôle (admin, validateur, utilisateur, auditeur).
• (Optionnel) cocher/décocher des utilisateurs spécifiques dans la liste filtrée.
• Effet :
• Une action est créée pour chaque utilisateur sélectionné.
• Toutes ces actions font partie d'un même lot (batch).

2.3. Service entier

• Choisir un service.
• Effet :
• Une action par utilisateur du service.
• Toutes ces actions partagent le même lot.

2.4. Organisation entière

• Pour un admin : l'action est ciblée sur son organisation.
• Pour un superadmin :
• un sélecteur permet de choisir l'organisation cible.
• Effet :
• Une action est créée pour chaque utilisateur actif de l'organisation cible.
• Toutes ces actions appartiennent au même lot.

2.5. Tous les utilisateurs de la plateforme (superadmin)

• Accessible uniquement au superadmin.
• Effet :
• Une action par utilisateur actif dans la plateforme.
• Toutes ces actions sont regroupées dans un même lot.

💡 Dans tous les cas de scope "de masse" (rôle, service, organisation, tout le monde), les actions sont dupliquées par utilisateur, mais restent regroupées logiquement via un identifiant de lot.

3. Lots d'actions (batchs)

Quand un scope de masse est utilisé, les actions sont regroupées sous un lot.

Dans la page /admin/action-plans/{id} :

• Le tableau des actions affiche :
• Une ligne principale par lot, avec :
  • le titre de l'action,
  • un libellé "Lot d'assignation" (rôle, service, organisation, toute la plateforme),
  • un badge X actions individuelles.
• Un bouton Détails qui permet de déplier le lot.
• En dépliant un lot, on voit :
• la liste des actions individuelles,
• l'utilisateur assigné,
• la priorité, le statut, l'échéance,
• les boutons pour éditer ou supprimer chaque action.

Les actions créées de manière individuelle apparaissent comme avant, une ligne par action, en dehors des lots.

4. Intégration automatique au calendrier

Chaque action créée est automatiquement synchronisée avec le calendrier.

4.1. Création automatique d'un événement

Lors de la création d'une action :

• Un événement de calendrier est créé pour :
• l'utilisateur assigné (assigned_to_user_id),

• ou, si non défini, le propriétaire du plan d'action (owner / créateur).

• La date de l'événement est :

• la due_date de l'action si renseignée,

• sinon, la date du jour.

• L'événement :

• est de type "action",
• apparaît comme un événement journée entière,
• a un titre préfixé par 📋.

4.2. Synchronisation depuis la page Calendrier

Depuis la page /calendar :

• Un bouton "Synchroniser les actions" permet de :
• recréer les événements manquants pour les actions non terminées,
• s'assurer que toutes les actions à échéance future sont visibles dans le calendrier.

ℹ️ La création automatique lors de l'ajout d'une action évite normalement de recourir à ce bouton, mais il reste disponible en cas de doute.

5. Bonnes pratiques pour les admins

• Utiliser les scopes de masse (rôle, service, organisation, tout le monde) pour lancer des campagnes d'actions cohérentes.
• Vérifier dans le détail du plan :
• que le lot contient bien le bon nombre d'actions,
• que chaque utilisateur ciblé apparaît bien dans le lot.
• Contrôler dans le calendrier que :
• les actions datées sont bien positionnées à la bonne date,
• les actions sans due_date apparaissent à la date de création.
• En cas d'actions non assignées créées par erreur :
• les réassigner à un utilisateur,
• ou les supprimer si elles ne sont plus pertinentes.

6. Mises à jour de la documentation

Lors de modifications futures sur les actions ou le calendrier :

• Vérifier :
• le comportement des scopes d'assignation,
• la création automatique d'événements,
• l'affichage des lots.
• Mettre à jour :
• cette page actions_calendrier.md,
• la liste des captures dans superadmin/documentation.md,
• et les captures associées dans backend/app/documentation/images/.

15. ✅ Valider une étude

✅ Valider une Étude

📋 Processus de validation

1. Accéder aux études en attente

1. Menu "Mes études"
2. Filtrer par statut "En attente de validation"
3. Vous voyez toutes les études de votre organisation à valider

2. Examiner l'étude

Consulter les résultats

1. Cliquer sur l'étude à valider
2. Aller sur "Résultats"
3. Examiner :
4. Score global de conformité
5. Graphique radar par section
6. Scores détaillés par section
7. Recommandations générées

Vérifier les réponses

1. Cliquer sur "Récapitulatif"
2. Parcourir toutes les réponses
3. Vérifier la cohérence
4. S'assurer que toutes les questions sont remplies

Consulter le plan d'action

1. Onglet "Plan d'action"
2. Vérifier que les actions sont pertinentes
3. S'assurer qu'elles correspondent aux réponses

Consulter l'historique

1. Onglet "Historique"
2. Voir les versions précédentes
3. Identifier les changements depuis la dernière soumission

3. Valider l'étude ✅

Si l'étude est conforme et complète :

1. Sur la page "Résultats" ou "Récapitulatif"
2. Cliquer sur "Valider"
3. Confirmer l'action
4. 📸 Une version est créée automatiquement
5. Le statut passe à "Validé"
6. L'utilisateur est notifié

✅ Critères de validation

Vérifications obligatoires

Complétude

• ✅ Toutes les questions obligatoires sont remplies
• ✅ Les réponses texte sont suffisamment détaillées
• ✅ Les choix multiples sont cohérents

Cohérence

• ✅ Les réponses sont logiques entre elles
• ✅ Pas de contradictions flagrantes
• ✅ Le score reflète la réalité

Qualité

• ✅ Les réponses sont précises
• ✅ Les justifications sont claires
• ✅ Les preuves sont mentionnées si nécessaire

Cas particuliers

Score très bas (< 40%)

• Vérifier que l'utilisateur a bien compris les questions
• S'assurer que les réponses reflètent la réalité
• Valider si c'est effectivement l'état actuel

Score très haut (> 90%)

• Vérifier qu'il n'y a pas de surévaluation
• S'assurer que les réponses sont justifiées
• Valider si c'est effectivement l'état actuel

Réponses "Partiellement"

• Vérifier que c'est justifié
• S'assurer que le plan d'action couvre les manques

💡 Bonnes pratiques

✅ Rapidité

• Traiter les demandes dans les 48h
• Ne pas bloquer le processus
• Prioriser selon l'urgence

✅ Objectivité

• Être impartial
• Se baser sur les faits
• Ne pas avoir d'a priori

✅ Communication

• Être disponible pour les questions
• Expliquer les décisions si nécessaire
• Encourager les bonnes pratiques

⚠️ Erreurs à éviter

❌ Validation trop rapide

• Ne pas valider sans examiner
• Prendre le temps de vérifier
• Lire toutes les réponses importantes

❌ Validation trop stricte

• Ne pas exiger la perfection
• Accepter les situations réelles
• Valider si globalement conforme

❌ Manque de cohérence

• Appliquer les mêmes critères à tous
• Ne pas être plus strict avec certains
• Documenter vos critères

📊 Après la validation

Ce qui se passe

• 📸 Version créée avec score et date
• ✉️ Notification à l'utilisateur
• 🔒 Étude verrouillée (non modifiable)
• 📊 Statistiques mises à jour

Que peut faire l'utilisateur ?

• ✅ Consulter les résultats
• ✅ Exporter en PDF/Excel
• ✅ Suivre le plan d'action
• ✅ Créer une nouvelle étude pour amélioration
• ❌ Modifier l'étude validée

❓ Questions fréquentes

Q : Puis-je annuler une validation ?
R : Non, mais vous pouvez invalider l'étude avec un commentaire expliquant l'erreur.

Q : Combien de temps ai-je pour valider ?
R : Il n'y a pas de limite stricte, mais visez 48h pour ne pas bloquer l'utilisateur.

Q : Puis-je valider mes propres études ?
R : Oui, mais ce n'est pas recommandé pour garantir l'objectivité.

Q : Que faire si je ne suis pas sûr ?
R : Demandez des clarifications à l'utilisateur via invalidation avec commentaire.

Q : Puis-je modifier les réponses ?
R : Non, seul l'utilisateur peut modifier. Vous pouvez invalider pour demander des corrections.

16. ❌ Invalider une étude

❌ Invalider une Étude

📋 Quand invalider ?

Invalidez une étude lorsque :
- ❌ Des réponses sont incomplètes ou manquantes
- ❌ Des réponses sont incohérentes entre elles
- ❌ Des justifications sont nécessaires
- ❌ Des preuves doivent être fournies
- ❌ Le score ne reflète pas la réalité
- ❌ Des corrections sont nécessaires

🔄 Processus d'invalidation

1. Examiner l'étude

Suivez les mêmes étapes que pour la validation :
1. Consulter les résultats
2. Vérifier les réponses
3. Identifier les problèmes

2. Invalider avec commentaire

1. Sur la page "Résultats" ou "Récapitulatif"
2. Cliquer sur "Invalider"
3. IMPORTANT : Rédiger un commentaire détaillé
4. Confirmer l'action
5. 📸 Une version est créée avec le commentaire
6. Le statut passe à "Invalidé"
7. L'utilisateur est notifié

3. L'utilisateur corrige

L'utilisateur peut alors :
- Modifier les réponses problématiques
- Ajouter des justifications
- Compléter les informations manquantes
- Redemander la validation

💬 Rédiger un bon commentaire

✅ Commentaire constructif

Étude globalement bien remplie, mais quelques points à corriger :

1. Section "Sécurité des accès" :
   - Question 3.2 : Préciser quels contrôles sont en place
   - Question 3.5 : Ajouter la fréquence des revues d'accès

2. Section "Gestion des incidents" :
   - Question 5.1 : La réponse "Partiellement" nécessite une justification
   - Question 5.3 : Fournir un exemple de procédure

3. Incohérence :
   - Q2.1 indique "Oui" mais Q2.3 indique "Non" → À clarifier

Merci de corriger ces points et de redemander la validation.

❌ Commentaire à éviter

Étude incomplète, à refaire.

→ Trop vague, l'utilisateur ne sait pas quoi corriger !

Structure recommandée

[Introduction positive si applicable]

[Points à corriger, organisés par section]
- Section X :
  - Question Y : [Problème précis]
  - Question Z : [Action attendue]

[Incohérences ou points globaux]

[Conclusion encourageante]

🎯 Types de problèmes courants

1. Réponses incomplètes

Problème :

Question : "Décrivez votre processus de gestion des incidents"
Réponse : "Oui"

Commentaire :

Question 5.1 : La réponse "Oui" n'est pas suffisante. 
Merci de décrire concrètement le processus : 
- Comment les incidents sont détectés ?
- Qui est responsable ?
- Quelles sont les étapes de traitement ?

2. Incohérences

Problème :

Q2.1 : "Avez-vous une politique de sécurité ?" → Oui
Q2.5 : "Quand a-t-elle été mise à jour ?" → Jamais

Commentaire :

Incohérence entre Q2.1 et Q2.5 :
Si vous avez une politique (Q2.1 = Oui), elle doit avoir 
une date de création/mise à jour. Merci de clarifier.

3. Justifications manquantes

Problème :

Q3.2 : "Contrôles d'accès en place ?" → Partiellement
[Pas de justification]

Commentaire :

Question 3.2 : La réponse "Partiellement" nécessite une justification.
Merci de préciser :
- Quels contrôles sont en place ?
- Quels contrôles manquent ?
- Pourquoi ne sont-ils pas tous en place ?

4. Preuves nécessaires

Problème :

Q4.1 : "Audits réguliers ?" → Oui
[Pas de preuve mentionnée]

Commentaire :

Question 4.1 : Merci de fournir des éléments de preuve :
- Date du dernier audit
- Nom de l'auditeur/organisme
- Principaux résultats

💡 Bonnes pratiques

✅ Être spécifique

• Indiquer les numéros de questions
• Expliquer précisément le problème
• Donner des exemples de ce qui est attendu

✅ Être constructif

• Commencer par les points positifs si possible
• Expliquer pourquoi c'est important
• Encourager l'utilisateur

✅ Être pédagogique

• Expliquer les attentes
• Donner des exemples
• Orienter vers les bonnes pratiques

✅ Être disponible

• Indiquer que vous êtes disponible pour questions
• Proposer un échange si nécessaire
• Être réactif aux corrections

⚠️ Erreurs à éviter

❌ Commentaires vagues

"Étude à refaire"
"Pas assez détaillé"
"Manque de cohérence"

→ L'utilisateur ne sait pas quoi corriger !

❌ Ton négatif

"Cette étude est mal faite"
"Vous n'avez rien compris"
"C'est du n'importe quoi"

→ Démotivant et non professionnel !

❌ Trop d'exigences

[Liste de 50 corrections]

→ Décourageant, prioriser l'essentiel !

❌ Manque de clarté

"Voir section 3"

→ Trop vague, préciser les questions !

📊 Après l'invalidation

Ce qui se passe

• 📸 Version créée avec commentaire
• ✉️ Notification à l'utilisateur avec le commentaire
• 🔓 Étude déverrouillée (modifiable)
• 📝 Utilisateur peut corriger

Que peut faire l'utilisateur ?

• ✅ Lire votre commentaire
• ✅ Modifier les réponses
• ✅ Ajouter des justifications
• ✅ Redemander la validation
• ✅ Vous contacter pour clarifications

Votre rôle ensuite

• 📧 Être disponible pour questions
• 🔄 Examiner la nouvelle soumission
• ✅ Valider si les corrections sont OK
• ❌ Ré-invalider si encore des problèmes

🔄 Cycle d'amélioration

Soumission → Invalidation (commentaire détaillé)
     ↓
Corrections → Nouvelle soumission
     ↓
Validation ✅

Objectif : Aider l'utilisateur à s'améliorer, pas le bloquer !

❓ Questions fréquentes

Q : Combien de fois puis-je invalider une étude ?
R : Autant que nécessaire, mais essayez d'être complet dès la première fois.

Q : Dois-je invalider pour des détails mineurs ?
R : Non, validez si globalement conforme. L'amélioration continue se fera sur les prochaines études.

Q : Puis-je invalider sans commentaire ?
R : Techniquement oui, mais c'est fortement déconseillé. Le commentaire est essentiel !

Q : L'utilisateur peut-il contester mon invalidation ?
R : Oui, il peut vous contacter. Soyez ouvert au dialogue.

Q : Que faire si l'utilisateur ne corrige pas ?
R : Relancer par email. Si pas de réponse, escalader à l'admin.

💬 Exemples de bons commentaires

Exemple 1 : Manque de détails

Bonjour,

Votre étude est sur la bonne voie, mais nécessite quelques compléments :

Section "Gestion des accès" :
- Q3.1 : Préciser les types de contrôles (biométrie, badge, code, etc.)
- Q3.4 : Indiquer la fréquence des revues d'accès (mensuelle, trimestrielle ?)

Section "Sauvegarde" :
- Q6.2 : Ajouter où sont stockées les sauvegardes (sur site, cloud, les deux ?)
- Q6.3 : Mentionner la date du dernier test de restauration

Merci de compléter ces informations et de redemander la validation.

Cordialement

Exemple 2 : Incohérences

Bonjour,

J'ai relevé quelques incohérences à clarifier :

1. Q2.1 indique "Politique de sécurité : Oui"
   Mais Q2.3 indique "Date de mise à jour : Aucune"
   → Une politique doit avoir une date. Merci de préciser.

2. Q4.5 indique "Audits annuels : Oui"
   Mais Q4.6 indique "Dernier audit : Jamais"
   → Merci de clarifier si des audits ont eu lieu.

Ces points doivent être cohérents pour valider l'étude.

Merci

Exemple 3 : Justifications manquantes

Bonjour,

Plusieurs réponses "Partiellement" nécessitent des justifications :

- Q3.2 : Quels contrôles sont en place ? Lesquels manquent ?
- Q5.1 : Quelles étapes du processus sont couvertes ? Lesquelles ne le sont pas ?
- Q7.3 : Quels types de formation sont dispensés ? À quelle fréquence ?

Ces justifications sont importantes pour comprendre votre niveau de conformité réel.

Merci de les ajouter.

Cordialement

17. 📊 Suivre les demandes

📊 Suivre les Demandes de Validation

🎯 Vue d'ensemble

En tant que validateur, vous devez suivre et traiter les demandes de validation de votre organisation.

📋 Accéder aux demandes

Menu "Mes études"

1. Cliquer sur "Mes études" dans le menu
2. Utiliser les filtres de statut :
3. "En attente de validation" → Études à traiter
4. "Validé" → Études que vous avez validées
5. "Invalidé" → Études que vous avez invalidées

Informations affichées

Pour chaque étude :
- 📝 Nom de l'étude
- 📚 Référentiel utilisé
- 👤 Auteur (utilisateur)
- 📅 Date de soumission
- 📊 Score de conformité
- 🎯 Statut actuel

🔔 Notifications

Vous êtes notifié quand :

• ✉️ Une nouvelle demande de validation arrive
• 🔄 Une étude invalidée est resoumise
• 📝 Un utilisateur commente une invalidation

Où voir les notifications ?

• Badge sur l'icône utilisateur
• Email (si configuré)
• Page "Mes études"

📊 Prioriser les demandes

Critères de priorisation

1. Urgence

• 🔴 Haute : Demandes de plus de 48h
• 🟠 Moyenne : Demandes de 24-48h
• 🟢 Normale : Demandes récentes

2. Complexité

• Études simples (< 50 questions) → Rapide
• Études complexes (> 100 questions) → Plus long

3. Historique

• Première soumission → Examiner attentivement
• Resoumission après invalidation → Vérifier les corrections

📈 Statistiques

Vos indicateurs

• 📊 Nombre d'études validées
• ⏱️ Temps moyen de traitement
• 📉 Taux d'invalidation
• 🔄 Nombre de resoumissions

Objectifs recommandés

• ✅ Traiter dans les 48h
• ✅ Taux d'invalidation < 30%
• ✅ Taux de revalidation après correction > 80%

💡 Bonnes pratiques

✅ Organisation

• Traiter les demandes par ordre chronologique
• Bloquer du temps dédié à la validation
• Ne pas accumuler les demandes

✅ Communication

• Répondre rapidement aux questions
• Être disponible pour clarifications
• Donner des feedbacks constructifs

✅ Qualité

• Prendre le temps nécessaire
• Ne pas bâcler les examens
• Être cohérent dans vos critères

❓ Questions fréquentes

Q : Combien d'études dois-je traiter par jour ?
R : Cela dépend de la complexité. Visez 2-5 études simples ou 1-2 études complexes.

Q : Puis-je déléguer des validations ?
R : Non, chaque validateur est responsable de ses validations.

Q : Que faire si je suis débordé ?
R : Contactez votre admin pour répartir la charge ou ajouter des validateurs.

18. 💡 Bonnes pratiques

💡 Bonnes Pratiques du Validateur

🎯 Principes fondamentaux

1. Objectivité

• ✅ Être impartial
• ✅ Se baser sur les faits
• ✅ Appliquer les mêmes critères à tous

2. Rapidité

• ✅ Traiter dans les 48h
• ✅ Ne pas bloquer le processus
• ✅ Prioriser selon l'urgence

3. Qualité

• ✅ Examiner attentivement
• ✅ Vérifier la cohérence
• ✅ Assurer la conformité

4. Pédagogie

• ✅ Expliquer les décisions
• ✅ Guider les utilisateurs
• ✅ Encourager l'amélioration

✅ Checklist de validation

Avant de valider

• [ ] Toutes les questions obligatoires sont remplies
• [ ] Les réponses sont cohérentes entre elles
• [ ] Les justifications sont suffisantes
• [ ] Le score reflète la réalité
• [ ] Le plan d'action est pertinent
• [ ] Pas d'incohérences flagrantes

Avant d'invalider

• [ ] J'ai identifié les problèmes précis
• [ ] Mon commentaire est détaillé et constructif
• [ ] J'ai indiqué les numéros de questions
• [ ] J'ai expliqué ce qui est attendu
• [ ] Le ton est professionnel et encourageant

🎯 Gestion du temps

Temps recommandés

• Étude simple (< 50 questions) : 15-30 min
• Étude moyenne (50-100 questions) : 30-60 min
• Étude complexe (> 100 questions) : 1-2h

Organisation

• Bloquer des créneaux dédiés
• Traiter par lots (3-5 études)
• Ne pas interrompre l'examen

💬 Communication efficace

Avec les utilisateurs

• ✅ Être disponible pour questions
• ✅ Répondre rapidement
• ✅ Expliquer clairement
• ✅ Encourager les bonnes pratiques

Avec les admins

• ✅ Remonter les problèmes systémiques
• ✅ Suggérer des améliorations
• ✅ Partager les retours d'expérience

⚠️ Pièges à éviter

❌ Validation trop rapide

• Ne pas valider sans examiner
• Prendre le temps de vérifier
• Lire les réponses importantes

❌ Validation trop stricte

• Ne pas exiger la perfection
• Accepter les situations réelles
• Valider si globalement conforme

❌ Manque de cohérence

• Appliquer les mêmes critères
• Documenter vos standards
• Être prévisible

❌ Commentaires vagues

• Être spécifique
• Indiquer les questions
• Expliquer ce qui est attendu

📊 Amélioration continue

Auto-évaluation

• Suivre vos statistiques
• Analyser vos invalidations
• Identifier vos biais

Formation

• Se tenir à jour sur les référentiels
• Échanger avec d'autres validateurs
• Participer aux formations

🎓 Cas d'école

Cas 1 : Score très bas

Situation : Étude avec 25% de conformité

Bonne pratique :
- Valider si les réponses reflètent la réalité
- Ne pas invalider juste pour le score
- Encourager l'amélioration via le plan d'action

Cas 2 : Réponses "Partiellement"

Situation : Beaucoup de "Partiellement" sans justification

Bonne pratique :
- Invalider en demandant les justifications
- Expliquer pourquoi c'est important
- Donner des exemples de bonnes justifications

Cas 3 : Première étude d'un utilisateur

Situation : Utilisateur novice, étude imparfaite mais honnête

Bonne pratique :
- Être pédagogue
- Expliquer les attentes
- Valider si acceptable, guider pour les prochaines

✅ Résumé

Un bon validateur :
- 🎯 Est objectif et cohérent
- ⚡ Traite rapidement les demandes
- 💬 Communique clairement
- 📚 Guide et forme les utilisateurs
- 📊 S'améliore continuellement

19. 💡 Bonnes pratiques

💡 Bonnes Pratiques du Validateur

🎯 Principes fondamentaux

1. Objectivité

• ✅ Être impartial
• ✅ Se baser sur les faits
• ✅ Appliquer les mêmes critères à tous

2. Rapidité

• ✅ Traiter dans les 48h
• ✅ Ne pas bloquer le processus
• ✅ Prioriser selon l'urgence

3. Qualité

• ✅ Examiner attentivement
• ✅ Vérifier la cohérence
• ✅ Assurer la conformité

4. Pédagogie

• ✅ Expliquer les décisions
• ✅ Guider les utilisateurs
• ✅ Encourager l'amélioration

✅ Checklist de validation

Avant de valider

• [ ] Toutes les questions obligatoires sont remplies
• [ ] Les réponses sont cohérentes entre elles
• [ ] Les justifications sont suffisantes
• [ ] Le score reflète la réalité
• [ ] Le plan d'action est pertinent
• [ ] Pas d'incohérences flagrantes

Avant d'invalider

• [ ] J'ai identifié les problèmes précis
• [ ] Mon commentaire est détaillé et constructif
• [ ] J'ai indiqué les numéros de questions
• [ ] J'ai expliqué ce qui est attendu
• [ ] Le ton est professionnel et encourageant

🎯 Gestion du temps

Temps recommandés

• Étude simple (< 50 questions) : 15-30 min
• Étude moyenne (50-100 questions) : 30-60 min
• Étude complexe (> 100 questions) : 1-2h

Organisation

• Bloquer des créneaux dédiés
• Traiter par lots (3-5 études)
• Ne pas interrompre l'examen

💬 Communication efficace

Avec les utilisateurs

• ✅ Être disponible pour questions
• ✅ Répondre rapidement
• ✅ Expliquer clairement
• ✅ Encourager les bonnes pratiques

Avec les admins

• ✅ Remonter les problèmes systémiques
• ✅ Suggérer des améliorations
• ✅ Partager les retours d'expérience

⚠️ Pièges à éviter

❌ Validation trop rapide

• Ne pas valider sans examiner
• Prendre le temps de vérifier
• Lire les réponses importantes

❌ Validation trop stricte

• Ne pas exiger la perfection
• Accepter les situations réelles
• Valider si globalement conforme

❌ Manque de cohérence

• Appliquer les mêmes critères
• Documenter vos standards
• Être prévisible

❌ Commentaires vagues

• Être spécifique
• Indiquer les questions
• Expliquer ce qui est attendu

📊 Amélioration continue

Auto-évaluation

• Suivre vos statistiques
• Analyser vos invalidations
• Identifier vos biais

Formation

• Se tenir à jour sur les référentiels
• Échanger avec d'autres validateurs
• Participer aux formations

🎓 Cas d'école

Cas 1 : Score très bas

Situation : Étude avec 25% de conformité

Bonne pratique :
- Valider si les réponses reflètent la réalité
- Ne pas invalider juste pour le score
- Encourager l'amélioration via le plan d'action

Cas 2 : Réponses "Partiellement"

Situation : Beaucoup de "Partiellement" sans justification

Bonne pratique :
- Invalider en demandant les justifications
- Expliquer pourquoi c'est important
- Donner des exemples de bonnes justifications

Cas 3 : Première étude d'un utilisateur

Situation : Utilisateur novice, étude imparfaite mais honnête

Bonne pratique :
- Être pédagogue
- Expliquer les attentes
- Valider si acceptable, guider pour les prochaines

✅ Résumé

Un bon validateur :
- 🎯 Est objectif et cohérent
- ⚡ Traite rapidement les demandes
- 💬 Communique clairement
- 📚 Guide et forme les utilisateurs
- 📊 S'améliore continuellement

20. 📝 Créer une étude

📝 Créer une Étude

1. Accéder à la création d'étude

1. Cliquez sur "Nouvelle étude" dans le menu principal
2. Sélectionnez un référentiel (ISO 27001, RGPD, etc.)
3. Donnez un nom à votre étude (optionnel)
4. Cliquez sur "Créer"

2. Remplir le questionnaire

Navigation

• Les questions sont organisées par sections
• Utilisez les boutons "Suivant" et "Précédent" pour naviguer
• Votre progression est sauvegardée automatiquement

Types de questions

Questions à choix unique

• Sélectionnez une seule réponse
• Exemple : Oui / Non / Partiellement

Questions à choix multiples

• Sélectionnez plusieurs réponses si nécessaire
• Toutes les options conformes doivent être cochées

Questions à échelle

• Sélectionnez un niveau sur l'échelle proposée
• Exemple : 1 (Faible) à 5 (Excellent)

Questions texte

• Répondez librement
• Ces réponses ne sont pas notées

3. Sauvegarder et reprendre

• Vos réponses sont sauvegardées automatiquement
• Vous pouvez quitter et reprendre à tout moment
• L'étude reste en statut "Brouillon" tant qu'elle n'est pas soumise

4. Demander la validation

Une fois toutes les questions remplies :
1. Allez sur la page "Récapitulatif"
2. Vérifiez vos réponses
3. Cliquez sur "Demander la validation"
4. Un validateur recevra votre demande

💡 Conseils

• ✅ Remplissez toutes les questions obligatoires
• ✅ Soyez précis dans vos réponses texte
• ✅ Consultez les documents de référence si nécessaire
• ✅ N'hésitez pas à sauvegarder régulièrement

❓ Questions fréquentes

Q : Puis-je modifier une étude après validation ?
R : Non, mais vous pouvez créer une nouvelle version si elle est invalidée.

Q : Combien de temps ai-je pour remplir une étude ?
R : Il n'y a pas de limite de temps. Prenez le temps nécessaire.

Q : Que se passe-t-il si je ferme mon navigateur ?
R : Vos réponses sont sauvegardées. Vous pouvez reprendre où vous en étiez.

21. ✏️ Saisie des réponses

✏️ Saisie des Réponses

Interface de saisie

Lors de la saisie de vos réponses, chaque question affiche plusieurs informations pour vous guider.

📋 Informations affichées

Badge "Obligatoire"

Les questions obligatoires sont marquées d'un badge rouge pour vous alerter.

💡 Aide contextuelle (Help text)

Un encadré bleu avec une icône ℹ️ vous donne des indications rapides sur la question.

📖 Justification

Un encadré gris explique pourquoi cette question est importante et ce qu'elle évalue.

🛠️ Guide de mise en œuvre

Un encadré avec bordure bleue vous indique comment répondre à la question et quelles sont les bonnes pratiques.

🔗 Exigences liées

Les références normatives (ex: ISO 27001:2022 - A.5.1) sont affichées en bas pour traçabilité.

🎨 Formatage Markdown

Tous les textes supportent le formatage Markdown :
- **texte** s'affiche en gras
- Les retours à la ligne sont préservés
- Les listes sont correctement formatées

🔄 Navigation

Boutons en haut et en bas

Pour faciliter la navigation, les boutons "← Précédent" et "Suivant →" sont disponibles :
- En haut de la page (avant les questions)
- En bas de la page (après les questions)

Enregistrement automatique

Les boutons "Précédent" et "Suivant" enregistrent automatiquement vos réponses. Pas besoin de bouton "Enregistrer" séparé !

💬 Commentaires

Certaines questions permettent d'ajouter un commentaire :
- Utilisez cette zone pour justifier votre réponse
- Ajoutez des précisions ou du contexte
- Les commentaires obligatoires sont marqués d'un badge jaune

📊 Barre de progression

En haut de la page, une barre de progression vous indique :
- Le nombre de questions répondues
- Le nombre total de questions
- Le pourcentage de complétion

💡 Conseils

• Lisez attentivement les guides de mise en œuvre
• Justifiez vos réponses dans les commentaires
• Naviguez librement entre les sections
• Vos réponses sont sauvegardées automatiquement

22. 📋 Plan d'action

📋 Plan d'Action

Le plan d'action est généré automatiquement à partir de vos réponses pour vous aider à améliorer votre conformité.

🎯 Vue Kanban

Le plan d'action est organisé en 4 colonnes :

📝 À faire

Actions qui n'ont pas encore été démarrées

🔄 En cours

Actions sur lesquelles vous travaillez actuellement

🚫 Bloqué

Actions qui rencontrent un obstacle

✅ Terminé

Actions complétées

🎨 Drag & Drop

Changer le statut d'une action

1. Cliquez et maintenez sur une carte d'action
2. Glissez vers une autre colonne
3. Relâchez pour déposer
4. Le statut est mis à jour automatiquement !

✏️ Modifier une action

1. Cliquez sur une carte d'action
2. Dans le modal, cliquez sur "Modifier"
3. Modifiez les informations :
4. Statut : À faire, En cours, Bloqué, Terminé
5. Priorité : Basse, Moyenne, Haute, Critique
6. Assigné à : Nom de la personne responsable
7. Échéance : Date limite
8. Notes : Informations complémentaires
9. Cliquez sur "Enregistrer"

💬 Commentaires

Ajouter un commentaire

1. Ouvrez une action
2. Scrollez en bas du modal
3. Tapez votre commentaire
4. Cliquez sur "Ajouter"

Utilité des commentaires

• 📝 Documenter l'avancement
• 🤝 Communiquer avec l'équipe
• 📅 Tracer les décisions
• ⚠️ Signaler des blocages

🎯 Priorités

🔴 Critique

Actions urgentes et importantes. À traiter en priorité absolue.

🟠 Haute

Actions importantes. À traiter rapidement.

🟡 Moyenne

Actions standard. À traiter dans les délais normaux.

🟢 Basse

Actions secondaires. À traiter quand possible.

💡 Bonnes pratiques

✅ Organisation

• Mettez à jour régulièrement les statuts
• Utilisez le drag & drop pour gagner du temps
• Assignez des responsables clairs

✅ Suivi

• Ajoutez des commentaires pour documenter
• Définissez des échéances réalistes
• Priorisez selon l'impact

✅ Communication

• Utilisez les commentaires pour communiquer
• Signalez les blocages rapidement
• Célébrez les actions terminées !

📊 Indicateurs

Le plan d'action affiche :
- Nombre d'actions par colonne
- Priorités avec des badges de couleur
- Échéances avec alerte si dépassées
- Responsables assignés

❓ Questions fréquentes

Q : Le plan d'action est-il généré automatiquement ?
R : Oui, lors de la création de l'étude.

Q : Puis-je ajouter des actions manuellement ?
R : Pas encore, mais cette fonctionnalité est prévue.

Q : Les modifications sont-elles sauvegardées automatiquement ?
R : Oui, chaque modification est sauvegardée immédiatement.

Q : Puis-je exporter le plan d'action ?
R : Oui, via l'export Excel ou PDF des résultats.

23. 🔄 Régénérer un plan d'action

🔄 Régénérer un Plan d'Action

Quand régénérer ?

Vous pouvez régénérer le plan d'action dans les cas suivants :
- Vous avez modifié vos réponses à l'audit
- Les priorités ont changé dans votre organisation
- Vous souhaitez repartir de zéro avec un nouveau plan

📍 Accès

1. Allez sur la page Résultats de votre étude
2. Cliquez sur l'onglet "Plan d'action"
3. En haut à droite, cliquez sur le bouton "🔄 Régénérer"

⚠️ Attention

La régénération :
- Supprime le plan actuel et toutes ses actions
- Crée un nouveau plan basé sur vos réponses actuelles
- Efface tous les commentaires et modifications manuelles

Une confirmation vous sera demandée avant la suppression.

💡 Conseil

Si vous souhaitez conserver l'historique :
1. Exportez d'abord le plan actuel (Excel ou PDF)
2. Puis régénérez le nouveau plan

24. 🕐 Historique

🕐 Historique et Versioning

Le système d'historique enregistre automatiquement toutes les étapes importantes de vos études.

📸 Qu'est-ce qu'une version ?

Une version est une "photo" complète de votre étude à un moment donné, incluant :
- ✅ Toutes vos réponses
- ✅ Les scores calculés
- ✅ Le statut de l'étude
- ✅ La date et l'auteur du changement

🔄 Création automatique de versions

Des versions sont créées automatiquement lors de :

1. Demande de validation

Quand vous soumettez votre étude pour validation

2. Validation

Quand un validateur approuve votre étude

3. Invalidation

Quand un validateur refuse votre étude (avec commentaire)

4. Restauration

Quand vous restaurez une ancienne version

👁️ Consulter l'historique

1. Allez sur la page "Résultats" de votre étude
2. Cliquez sur l'onglet "Historique"
3. Vous voyez toutes les versions, de la plus récente à la plus ancienne

Informations affichées

• Numéro de version (1, 2, 3...)
• Type de changement (🎯 Création, ✅ Validation, ❌ Invalidation...)
• Auteur (qui a fait le changement)
• Date et heure
• Score de conformité à ce moment-là
• Description du changement

↔️ Comparer des versions

Pourquoi comparer ?

• Voir ce qui a changé entre deux versions
• Comprendre l'évolution de votre conformité
• Identifier les améliorations apportées

Comment comparer ?

1. Dans l'onglet "Historique"
2. Cliquez sur "Comparer" sur une version ancienne
3. Un modal s'ouvre avec :
4. Nombre total de changements
5. Réponses modifiées
6. Réponses ajoutées
7. Réponses supprimées
8. Évolution du score de conformité

⏮️ Restaurer une version

⚠️ Attention !

Restaurer une version remplace toutes vos réponses actuelles par celles de la version sélectionnée.

Quand restaurer ?

• Vous avez fait une erreur de manipulation
• Vous voulez revenir à un état antérieur
• Une validation a été faite par erreur

Comment restaurer ?

1. Dans l'onglet "Historique"
2. Cliquez sur "Restaurer" sur la version souhaitée
3. Confirmez l'action
4. Une nouvelle version est créée (l'historique n'est jamais perdu !)

📊 Cas d'usage pratiques

Exemple 1 : Audit de conformité

Version 1 → Création (conformité: 45%)
Version 2 → Demande validation (conformité: 45%)
Version 3 → Invalidation "Manque justificatifs"
Version 4 → Corrections (conformité: 78%)
Version 5 → Validation finale (conformité: 78%)

→ Vous avez la preuve de toute l'évolution !

Exemple 2 : Erreur de manipulation

Vous validez une étude par erreur
→ Restaurez la version précédente
→ Aucune perte de données !

Exemple 3 : Suivi des améliorations

Comparez Version 1 vs Version 5
→ Voyez exactement ce qui a été amélioré
→ Mesurez les progrès réalisés

💡 Bonnes pratiques

✅ Consultation régulière

• Consultez l'historique avant une validation
• Vérifiez les changements importants
• Documentez les raisons des modifications

✅ Comparaison

• Comparez avant/après des corrections
• Mesurez l'impact de vos actions
• Justifiez les évolutions

✅ Restauration prudente

• Réfléchissez bien avant de restaurer
• Vérifiez quelle version restaurer
• Documentez la raison de la restauration

🔒 Sécurité

• Les versions sont en lecture seule
• Impossible de modifier une version passée
• L'historique complet est toujours préservé
• Chaque action est tracée et datée

❓ Questions fréquentes

Q : Puis-je supprimer une version ?
R : Non, l'historique est immuable pour garantir la traçabilité.

Q : Combien de versions puis-je avoir ?
R : Illimité. Toutes les versions sont conservées.

Q : La restauration supprime-t-elle des versions ?
R : Non, elle crée une nouvelle version. Rien n'est jamais supprimé.

Q : Puis-je voir qui a fait quoi ?
R : Oui, chaque version indique l'auteur et la date.

Q : Les versions prennent-elles beaucoup d'espace ?
R : Non, seules les données modifiées sont stockées.

25. 📥 Exports

📥 Exporter les Résultats

Exportez vos résultats pour les partager, les archiver ou les présenter.

📄 Export PDF

Contenu du PDF

• Vue d'ensemble avec score global
• Graphique radar des sections
• Tableau détaillé des scores
• Recommandations
• Plan d'action

Comment exporter en PDF ?

1. Allez sur la page "Résultats" de votre étude
2. Cliquez sur "Exporter en PDF"
3. Une fenêtre d'impression s'ouvre
4. Sélectionnez "Enregistrer au format PDF"
5. Choisissez l'emplacement et enregistrez

💡 Astuce

Le PDF est optimisé pour l'impression. Les éléments interactifs (boutons, etc.) sont masqués automatiquement.

📊 Export Excel

Contenu du fichier Excel

• Feuille 1 : Résumé (scores globaux)
• Feuille 2 : Détail par section
• Feuille 3 : Toutes les réponses
• Feuille 4 : Plan d'action

Comment exporter en Excel ?

1. Allez sur la page "Résultats" de votre étude
2. Cliquez sur "Exporter en Excel"
3. Le fichier se télécharge automatiquement
4. Ouvrez-le avec Excel, LibreOffice ou Google Sheets

Utilisation du fichier Excel

• ✅ Analyse approfondie des données
• ✅ Création de graphiques personnalisés
• ✅ Partage avec des parties prenantes
• ✅ Archivage long terme

📋 Récapitulatif détaillé

Accès au récapitulatif

1. Allez sur la page "Résultats" de votre étude
2. Cliquez sur "Récapitulatif"
3. Vous voyez toutes vos réponses question par question

Contenu

• Toutes les questions et réponses
• Scores par question
• Organisation par section
• Possibilité de modifier (si en brouillon)

🎯 Cas d'usage

Présentation à la direction

1. Exportez en PDF
2. Présentez le graphique radar
3. Détaillez les recommandations
4. Montrez le plan d'action

Audit externe

1. Exportez en Excel
2. Partagez le fichier avec l'auditeur
3. Fournissez le détail des réponses
4. Justifiez les scores

Archivage

1. Exportez en PDF et Excel
2. Stockez dans votre GED
3. Conservez pour référence future
4. Utilisez pour les audits de suivi

Analyse comparative

1. Exportez plusieurs études en Excel
2. Comparez les scores dans un tableur
3. Identifiez les tendances
4. Mesurez les progrès

💡 Bonnes pratiques

✅ Exports réguliers

• Exportez après chaque validation
• Conservez les versions successives
• Archivez dans un emplacement sûr

✅ Nommage des fichiers

Conformité_ISO27001_2024-10-27.pdf
Conformité_ISO27001_2024-10-27.xlsx

✅ Partage sécurisé

• Utilisez des canaux sécurisés
• Protégez les fichiers sensibles
• Respectez la confidentialité

🔒 Sécurité et confidentialité

• Les exports contiennent des données sensibles
• Protégez les fichiers exportés
• Ne partagez qu'avec les personnes autorisées
• Respectez le RGPD et les politiques internes

❓ Questions fréquentes

Q : Puis-je personnaliser le contenu des exports ?
R : Pas encore, mais cette fonctionnalité est prévue.

Q : Les exports incluent-ils le plan d'action ?
R : Oui, le plan d'action est inclus dans les deux formats.

Q : Puis-je exporter plusieurs études en une fois ?
R : Pas encore, vous devez exporter étude par étude.

Q : Les graphiques sont-ils inclus dans l'Excel ?
R : Non, seulement les données brutes. Vous pouvez créer vos propres graphiques.

Q : Le PDF est-il modifiable ?
R : Non, c'est un document figé pour garantir l'intégrité.