doc: document mailing

CLAUDE.md

@@ -603,6 +603,53 @@ Après avoir lu ce guide :
 
 ---
 
+## 📧 **Système d'Envoi de Bilans par Email (Nouvelle Fonctionnalité - 2025)**
+
+**Notytex** intègre désormais un système complet d'envoi automatique des bilans d'évaluation individuels par email aux élèves et à leurs familles.
+
+### **🎯 Fonctionnalités Principales**
+
+- ✅ **Configuration SMTP flexible** via interface web (Gmail, Outlook, serveurs personnalisés)
+- ✅ **Génération automatique** de bilans individualisés avec analyses détaillées
+- ✅ **Templates HTML responsives** optimisés pour tous clients email
+- ✅ **Analyses par compétences et domaines** avec visualisations graphiques
+- ✅ **Serveur de test intégré** (`debug_smtp_server.py`) pour développement
+- ✅ **Gestion d'erreurs robuste** avec logs structurés et rapports détaillés
+
+### **🏗️ Architecture**
+
+```
+services/
+├── email_service.py           # Service d'envoi SMTP
+└── student_report_service.py  # Génération de bilans
+
+templates/email/
+├── base_email.html           # Template de base responsive
+└── student_report.html       # Template de bilan détaillé
+```
+
+### **📊 Contenu des Bilans**
+
+Chaque bilan inclut :
+- **Note globale** avec visualisation colorée et position dans la classe
+- **Détail par exercice** et questions individuelles
+- **Analyses par compétences** avec système d'étoiles visuelles
+- **Performances par domaines** avec codes couleur
+- **Statistiques de classe** (moyenne, médiane, écart-type)
+- **Message personnalisé** du professeur (optionnel)
+
+### **📧 Workflow d'Envoi**
+
+1. **Configuration SMTP** via `Configuration > Email`
+2. **Sélection d'élèves** depuis la page de résultats d'évaluation
+3. **Prévisualisation** des bilans via `/preview-report`
+4. **Envoi groupé** avec rapport détaillé des succès/erreurs
+5. **Réception professionnelle** par les élèves et familles
+
+**📖 Documentation complète** : [docs/features/EMAIL_REPORTS.md](docs/features/EMAIL_REPORTS.md)
+
+---
+
 # 🚀 **Améliorations Phase 1 - Architecture Refactorisée (2025)**
 
 ## ✅ **Refactoring Complet Selon les Principes 12 Factor App**