# 🚀 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 !**