📊 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é)