feat: add concil page

docs/GUIDE_CONSEIL_DE_CLASSE.md

@@ -0,0 +1,283 @@
+# 🚀 Guide de Démarrage - Conseil de Classe
+
+## 📋 Vue d'ensemble
+
+Le module **Conseil de Classe** permet de préparer efficacement vos conseils en centralisant notes et appréciations des élèves.
+
+### ⚡ Démarrage en 3 étapes
+
+1. **Accéder** : `Classes → [Nom classe] → Dashboard → Conseil T[X]`
+2. **Analyser** : Consulter statistiques et identifier élèves prioritaires  
+3. **Rédiger** : Activer Mode Focus et rédiger appréciation par appréciation
+
+---
+
+## 🎯 Interface Principale
+
+### Navigation vers le conseil
+```
+📁 Classes
+  └── 📚 6ème A  
+      └── 📊 Dashboard
+          └── 📋 Conseil de classe T2  ← Cliquez ici
+```
+
+### Sélection du trimestre
+- **Sélecteur** dans le breadcrumb pour changer de trimestre
+- **URL persistante** : `/classes/5/council?trimestre=2`
+- **Validation** : Seuls T1, T2, T3 autorisés
+
+---
+
+## 📊 Données Affichées
+
+### Statistiques de classe automatiques
+```
+📈 Moyenne générale : 14.2/20
+📉 Minimum : 8.5/20  |  📈 Maximum : 18.5/20
+📊 Médiane : 14.5/20  |  📏 Écart-type : 2.1
+
+👥 Répartition des performances :
+- 🌟 Excellents (≥16) : 3 élèves  
+- 🟢 Bons (≥14) : 8 élèves
+- 🟡 Moyens (≥10) : 12 élèves  
+- 🔴 En difficulté (<10) : 2 élèves
+```
+
+### Informations par élève
+```
+👤 MARTIN Léa
+📊 Moyenne : 15.8/20  |  🏆 Statut : Bon élève
+📝 Appréciation : [Rédigée ✅ | À rédiger ⏳]
+
+📋 Détail des évaluations :
+- Contrôle Chapitre 1 : 16.5/20
+- Devoir Maison 3 : 14.0/20  
+- Contrôle Chapitre 2 : 17.0/20
+```
+
+---
+
+## 🔧 Outils de Filtrage
+
+### Filtres disponibles
+- **🔍 Recherche** : Par nom/prénom (instantané)
+- **📊 Tri** : Alphabétique | Par moyenne | Par statut
+- **🎯 Filtre statut** : Tous | Appréciations terminées | En attente | En difficulté
+
+### Utilisation efficace
+```javascript
+// Workflow recommandé :
+1. Filtrer par "En difficulté" → Traiter les cas prioritaires
+2. Filtrer par "En attente" → Rédiger appréciations manquantes  
+3. Tri par "Moyenne" → Vue d'ensemble performances
+```
+
+---
+
+## 🎯 Mode Focus - Nouveauté !
+
+### Activation
+- **Bouton** : "Mode Focus" en haut à droite
+- **Interface minimale** : Seul l'élève courant affiché
+- **Navigation** : Boutons ←/→ ou raccourcis clavier
+
+### Avantages du Mode Focus
+✅ **Concentration maximale** : Un seul élève visible  
+✅ **Navigation rapide** : ←/→ pour changer d'élève  
+✅ **Focus automatique** : Curseur directement dans l'appréciation  
+✅ **Pas de scroll** : Interface optimisée pleine hauteur  
+✅ **Synchronisation** : Modifications synchronisées avec mode liste
+
+### Navigation en Mode Focus
+```
+⌨️ Raccourcis clavier :
+← (Flèche gauche) : Élève précédent
+→ (Flèche droite) : Élève suivant  
+Échap : Retour au mode liste
+
+🖱️ Boutons :
+[← Précédent] [1/25] [Suivant →]
+[Mode Liste] (pour sortir du focus)
+```
+
+---
+
+## 💾 Sauvegarde Automatique
+
+### Fonctionnement
+- **Auto-sauvegarde** : 2 secondes après arrêt de frappe
+- **Sauvegarde manuelle** : Bouton "Sauvegarder"  
+- **Sauvegarde sur blur** : Quand on change de champ
+- **Synchronisation** : Entre Mode Focus et Mode Liste
+
+### Indicateurs visuels
+```
+🟡 Modifié      : Texte changé, pas encore sauvé
+🔵 Sauvegarde... : En cours d'envoi au serveur  
+🟢 Sauvegardé   : Confirmation de réussite (2s)
+🔴 Erreur       : Problème de sauvegarde
+```
+
+---
+
+## ⚡ Workflow Optimal
+
+### 📋 Préparation (5 min)
+1. **Analyser les statistiques** de classe générale
+2. **Identifier les priorités** avec filtres :
+   - Élèves en difficulté (< 10/20)
+   - Appréciations manquantes
+3. **Choisir le mode** : Liste pour vue d'ensemble, Focus pour rédaction
+
+### ✏️ Rédaction (20-30 min pour 25 élèves)
+1. **Activer Mode Focus** pour concentration maximale
+2. **Commencer par les cas prioritaires** (élèves en difficulté)
+3. **Naviguer élève par élève** avec ←/→
+4. **Rédiger directement** (focus automatique sur textarea)
+5. **Laisser l'auto-sauvegarde** fonctionner
+
+### ✅ Finalisation (5 min)  
+1. **Retour Mode Liste** pour vue d'ensemble
+2. **Vérifier** que toutes les appréciations sont "Rédigées ✅"
+3. **Exporter en PDF** si nécessaire
+4. **Consulter synthèse** de classe finale
+
+---
+
+## 🎯 Cas d'Usage Concrets
+
+### Scénario 1 : Conseil T1 - Première impression
+```
+📊 Situation : Première évaluation des élèves
+🎯 Objectif : Poser les bases et identifier les besoins
+
+Workflow :
+1. Analyser statistiques → Identifier groupes de niveau
+2. Mode Focus → Rédiger appréciations encourageantes
+3. Focus sur adaptation et méthodologie
+4. Tons positifs pour démarrer l'année
+```
+
+### Scénario 2 : Conseil T2 - Ajustements
+```  
+📊 Situation : Mi-année, tendances établies  
+🎯 Objectif : Ajuster et remotiver
+
+Workflow :
+1. Filtrer "En difficulté" → Traiter en priorité
+2. Comparer avec T1 → Noter évolutions  
+3. Mode Focus → Appréciations ciblées
+4. Conseils précis pour T3
+```
+
+### Scénario 3 : Conseil T3 - Bilan annuel
+```
+📊 Situation : Fin d'année, orientation
+🎯 Objectif : Bilan et perspectives
+
+Workflow :
+1. Vue d'ensemble → Évolution sur l'année
+2. Statistiques finales → Validation niveau  
+3. Mode Focus → Appréciations bilans
+4. Conseils pour année suivante
+```
+
+---
+
+## 🛠️ Raccourcis et Astuces
+
+### ⌨️ Raccourcis globaux
+```
+Ctrl/Cmd + S : Sauvegarder toutes les appréciations
+Ctrl/Cmd + F : Focus sur recherche élèves
+F11 : Plein écran (recommandé pour Mode Focus)
+```
+
+### 🚀 Astuces de productivité
+- **Templates mentaux** : Préparer structure type d'appréciation
+- **Filtrage intelligent** : Commencer par élèves en difficulté
+- **Mode Focus** : Idéal pour sessions de rédaction intensive  
+- **Double écran** : Notes perso sur écran 2, Notytex sur écran 1
+
+### 🎯 Formulation d'appréciations efficaces
+```
+✅ Structure recommandée :
+1. Constat factuel : "Résultats en progression..."
+2. Points positifs : "Participation active, sérieux..."  
+3. Axes d'amélioration : "Attention à l'organisation..."
+4. Encouragement : "Continue ainsi pour le T3 !"
+
+❌ Éviter :
+- Appréciations trop génériques
+- Négativité excessive  
+- Manque de conseils concrets
+```
+
+---
+
+## 🐛 Problèmes Courants
+
+### Auto-sauvegarde ne fonctionne pas
+```
+🔧 Solutions :
+1. Vérifier connection internet
+2. Actualiser la page (F5)  
+3. Vider cache navigateur
+4. Contacter admin si persistant
+```
+
+### Mode Focus ne s'active pas
+```
+🔧 Solutions :
+1. Désactiver bloqueur de pub
+2. Autoriser JavaScript
+3. Navigateur récent recommandé (Chrome, Firefox, Safari)
+4. Tester avec F12 Console pour erreurs
+```
+
+### Synchronisation Focus/Liste
+```
+🔧 Solutions :
+1. Les modifications sont automatiques
+2. Si désynchronisé, revenir mode Liste puis Focus
+3. Sauvegarde manuelle en cas de doute
+4. F5 pour recharger données serveur
+```
+
+---
+
+## ❓ Questions Fréquentes
+
+**Q: Les appréciations sont-elles sauvegardées automatiquement ?**  
+R: Oui, 2 secondes après arrêt de frappe + sur changement de champ + bouton manuel.
+
+**Q: Peut-on perdre du travail en changeant de mode ?**  
+R: Non, synchronisation bidirectionnelle automatique entre Mode Focus et Liste.
+
+**Q: Combien de temps pour rédiger 25 appréciations ?**  
+R: Environ 20-30 minutes avec Mode Focus (1-2 min/élève).
+
+**Q: Les données sont-elles partagées entre enseignants ?**  
+R: Chaque enseignant accède à ses classes. Partage via export PDF.
+
+**Q: Peut-on travailler hors ligne ?**  
+R: Non, connexion requise pour auto-sauvegarde. Travail local temporaire possible.
+
+---
+
+## 📞 Support
+
+### 🆘 En cas de problème
+1. **F12** → Console pour voir erreurs JavaScript  
+2. **Tester** avec navigateur différent
+3. **Contacter** administrateur avec capture d'écran
+
+### 📧 Ressources
+- **Documentation complète** : `/docs/features/CONSEIL_DE_CLASSE.md`  
+- **Architecture technique** : `/docs/backend/CONSEIL_DE_CLASSE_ARCHITECTURE.md`
+- **Issues GitHub** : Pour bugs et suggestions
+
+---
+
+**🎓 Bon conseil de classe avec Notytex !**