📋 Assiduité

Le module d'Assiduité permet d'enregistrer et de suivre la présence des élèves à chaque cours programmé. Il est conçu pour fonctionner directement depuis le calendrier de l'emploi du temps, permettant un flux rapide : voir le bloc → enregistrer l'assiduité de toute la section.

📍 Chemin d'accès : Menu latéral → Salle Virtuelle → Assiduité

1. Système d'États d'Assiduité

Les états d'assiduité sont configurables par l'administrateur et prennent en charge des couleurs personnalisées. Chaque état possède une couleur de fond et une couleur de texte pour son affichage dans l'interface.

Champ	Type	Description
Nom	Texte (20 car.)	Identifiant de l'état (ex : Présent, Absent, Justifié, Retard)
Actif	Oui/Non	Contrôle si l'état apparaît comme option disponible
Système	Oui/Non	Indique s'il s'agit d'un état de base du système (non supprimable)
Couleur	Hexadécimal	Couleur de fond du badge d'état
Couleur Texte	Hexadécimal	Couleur du texte à l'intérieur du badge

⚙️ Configuration : Menu latéral → Paramètres → Catégories → onglet États d'Assiduité

2. Flux d'Enregistrement — Depuis le Calendrier

La méthode principale d'enregistrement de l'assiduité se fait directement depuis un bloc de l'emploi du temps dans le calendrier. En cliquant sur le bouton 📋 Assiduité d'un bloc, le système transfère automatiquement le contexte (section, matière, date, horaire) vers l'écran d'enregistrement en masse.

Données transférées automatiquement au formulaire d'enregistrement :

Donnée	Origine
Année Scolaire	Filtre actif du calendrier
Section	Filtre actif du calendrier
Matière	Titre du bloc sélectionné
Date	Date du bloc dans le calendrier
Heure début / fin	Horaire du bloc sélectionné

3. Écran d'Enregistrement en Masse

L'écran d'enregistrement affiche le contexte du cours dans des badges informatifs et un tableau avec tous les élèves inscrits dans la section. Pour chaque élève, on peut sélectionner :

Colonne	Description
Nom Complet	Nom de l'élève (lecture seule)
Motif	Sélecteur de l'état d'assiduité (Présent, Absent, Justifié, Retard, etc.)
Description	Champ optionnel pour des notes supplémentaires (ex : « Arrivé 15 min en retard », « Certificat médical »)

💡 Note

Seuls les élèves ayant un état sélectionné sont enregistrés. Si un élève n'a pas d'état assigné, il est omis de l'enregistrement. Cela permet un enregistrement sélectif de l'assiduité (uniquement les absences/retards).

🔔 Notifications Automatiques

Lorsqu'un élève est marqué avec un état différent de « Présent » (ID ≠ 1), le système envoie automatiquement une notification push aux tuteurs de l'élève, les informant de l'état d'assiduité.

4. Liste des Enregistrements d'Assiduité

La vue principale affiche tous les enregistrements d'assiduité sous forme de tableau avec des filtres avancés :

Filtres disponibles (sélecteurs en cascade) :

🎓 Année Scolaire → 🏫 Section → 📚 Cours → 📅 Plage de Dates

Elle inclut également un champ de recherche par nom d'élève.

Colonnes du tableau :

Colonne	Description
Année Scolaire	Cycle scolaire de l'enregistrement
Section	Niveau et groupe
Cours	Matière associée
Élève	Nom complet
Date	Date de l'enregistrement
État	Badge de couleur avec l'état d'assiduité

Actions disponibles par enregistrement (menu à trois points) :

Action	Icône	Description
Modifier	✏️	Changer l'état ou la description de l'enregistrement individuel
Élève	🎓	Naviguer vers le dossier complet de l'élève
Supprimer	🗑️	Effacer l'enregistrement d'assiduité (avec confirmation)

5. Tableau de Bord Analytique d'Assiduité

Le module inclut un panneau d'analyse visuelle avec des graphiques interactifs. Il est accessible depuis le menu latéral → Salle Virtuelle → Panneau d'Assiduité.

📍 Chemin d'accès : Menu latéral → Salle Virtuelle → Panneau d'Assiduité

Cartes de Statistiques (Premium Cards) :

Carte	Icône	Couleur	Description
Présences	✅	Vert	Total des enregistrements avec état « Présent »
Absences Injustifiées	❌	Rouge	Total des absences sans justification
Absences Justifiées	⚠️	Orange	Total des absences avec justification
Retards	🕐	Bleu	Total des arrivées tardives

Graphiques disponibles :

Graphique	Type	Description
Assiduité par État	Barres	Distribution des enregistrements regroupés par état
Tendance (30 jours)	Ligne	Évolution quotidienne des enregistrements d'assiduité
Distribution par Niveau	Camembert (Donut)	Proportion des enregistrements par niveau scolaire
Distribution par Cycle	Camembert	Proportion des enregistrements par cycle éducatif

Le tableau de bord inclut également un tableau des absences récentes (10 derniers enregistrements) avec avatar de l'élève, section, cours, date et état avec badge de couleur.

🔍 Filtres du Tableau de Bord

Le panneau prend en charge les mêmes filtres en cascade que la liste principale (Année Scolaire → Section → Cours). Les graphiques se mettent à jour automatiquement lorsque vous changez un filtre.

Élément	Emplacement	Fonction
📋 Assiduité (Bouton)	Bloc du calendrier	Initier l'enregistrement en masse depuis l'emploi du temps
🔍 Rechercher	Barre supérieure de la liste	Exécuter la recherche avec les filtres actuels
Année Scolaire	Barre de filtres	Filtre principal du sélecteur en cascade
Section	Barre de filtres	Dépend de l'Année Scolaire sélectionnée
Cours	Barre de filtres	Dépend de la Section sélectionnée
Plage de Dates	Barre de filtres	Filtrer par période (date début/fin)
Élève	Barre de filtres	Recherche par nom de l'élève
✏️ Modifier	Menu d'actions par ligne	Modifier l'état et la description de l'enregistrement
🎓 Élève	Menu d'actions par ligne	Naviguer vers le dossier de l'élève
🗑️ Supprimer	Menu d'actions par ligne	Effacer l'enregistrement avec confirmation
💾 Enregistrer	Formulaire d'enregistrement en masse	Confirmer et sauvegarder l'assiduité de tous les élèves
📊 Tableau de Bord	Menu latéral	Accéder au panneau analytique avec graphiques interactifs

📋 Assiduité ​

1. Système d'États d'Assiduité ​

2. Flux d'Enregistrement — Depuis le Calendrier ​

3. Écran d'Enregistrement en Masse ​

4. Liste des Enregistrements d'Assiduité ​

5. Tableau de Bord Analytique d'Assiduité ​