Pédagogie
Vérifié contre le produit le .
| Domaine | Pédagogie — la structure, les matières, les enseignants, les cours, les disponibilités |
| Durée | ~8 min |
| Niveau | complet |
| Étiquette | automatisable, sauf le bloc 5 : peindre une grille de disponibilités est un geste au pointeur |
Préparation
Section intitulée « Préparation »Socle B, avec le référentiel monté par Référentiel et patrimoine — au minimum une salle, un type de salle et un équipement.
Compte : alice (administratrice).
Chaque bloc finit par une vérification en aval : une promotion L'ensemble des étudiants qui suivent la même formation la même année, avec son effectif. saisie ici doit se retrouver dans un filtre, une exigence doit écarter une salle.
1. La structure
Section intitulée « 1. La structure »Pédagogie → Structure.
| # | Action | Résultat attendu |
|---|---|---|
| 1.1 | Ouvrir l’écran sur un établissement neuf | « Aucune année académique. Créez-en une via “Gérer les années”. » |
| 1.2 | « Gérer les années » → créer « 2026-2027 », du 1ᵉʳ septembre au 30 juin | l’année apparaît et ses semaines sont générées |
| 1.3 | Créer une seconde année du même nom | « Une année académique porte déjà ce nom. » |
| 1.4 | Créer une année dont la fin précède le début | « La date de fin doit être postérieure à la date de début. » |
| 1.5 | « Ajouter une formation » « L1 Informatique » | elle apparaît dans l’arbre |
| 1.6 | « Ajouter une promotion » « L1 A », « Effectif » = 30 | elle apparaît sous la formation |
| 1.7 | « Ajouter un sous-groupe » « TD1 », type « TD », effectif 16, puis « TD2 », effectif 16 | ils apparaissent sous la promotion |
| 1.8 | Regarder la promotion | « La somme des effectifs des sous-groupes (32) dépasse l’effectif de la promotion (30). » — un avertissement, pas un blocage |
| 1.9 | Tenter de supprimer l’année | « Impossible de supprimer : l’année contient encore des formations. » |
Vérification en aval : ouvrir Planification → le filtre « Groupe » propose la promotion et ses deux sous-groupes.
2. Les matières
Section intitulée « 2. Les matières »Pédagogie → Matières.
| # | Action | Résultat attendu |
|---|---|---|
| 2.1 | Ouvrir l’écran | « Aucune matière. » |
| 2.2 | « Ajouter une matière » « Algorithmique », sans exigence | elle apparaît, colonnes « Type de salle requis » et « Équipements requis » vides |
| 2.3 | Créer « Chimie » avec « Type de salle requis » = « Salle de TP » et « Équipements requis » = « Paillasse » | les deux colonnes sont renseignées |
| 2.4 | Recréer « Chimie » | « Une matière porte déjà ce nom. » |
Vérification en aval : au bloc 4, un cours de Chimie ne pourra se poser que dans une salle de TP équipée d’une paillasse.
3. Les enseignants
Section intitulée « 3. Les enseignants »Pédagogie → Enseignants.
| # | Action | Résultat attendu |
|---|---|---|
| 3.1 | Ouvrir l’écran | « Aucun enseignant. » |
| 3.2 | « Ajouter un enseignant » « Hugo Martin », compétences « algorithmique, réseaux » | il apparaît dans la liste |
| 3.3 | Ouvrir sa fiche → « Matières enseignées » → rattacher « Algorithmique » | la fiche l’affiche |
| 3.4 | « Compte utilisateur lié » → choisir le compte de bob | « Permet à l’enseignant de saisir ses disponibilités dans “Mon espace”. » |
| 3.5 | Lier le même compte à un second enseignant | « Ce compte est déjà lié à un autre enseignant. » |
| 3.6 | Chercher « martin » dans la recherche | la fiche remonte |
Vérification en aval : session bob → Mon espace → l’éditeur « Disponibilités & préférences » est apparu, alors qu’il affichait auparavant « Aucun profil enseignant n’est lié à votre compte… ».
4. Les cours
Section intitulée « 4. Les cours »Pédagogie → Cours à placer.
| # | Action | Résultat attendu |
|---|---|---|
| 4.1 | Ouvrir l’écran | « Aucun cours à placer. » |
| 4.2 | « Ajouter un cours » : matière « Algorithmique », type « TD », cible « Sous-groupe » = TD1, enseignant Hugo Martin, durée 90, 12 séances | le cours apparaît avec toutes ses colonnes |
| 4.3 | Laisser « Capacité requise » vide | « Laissez vide pour utiliser l’effectif de la cible. » — le cours vaudra 16 |
| 4.4 | Créer un second cours « Chimie », type « TP », cible TD2 | il apparaît |
| 4.5 | Tenter de supprimer l’enseignant Hugo Martin | « Impossible de supprimer : des cours référencent encore cet enseignant. » |
| 4.6 | Tenter de supprimer la promotion « L1 A » | « Impossible de supprimer : des cours ciblent encore cette promotion. » |
Vérification en aval : Planification → « Créer un cours » → les deux cours sont proposés. Choisir « Chimie » et lancer la détection → seules les salles de TP équipées d’une paillasse sont candidates ; une cellule sans salle valable est hachurée, avec la raison nommée.
5. Les disponibilités
Section intitulée « 5. Les disponibilités »Pédagogie → Enseignants → fiche de Hugo Martin → « Disponibilités & préférences ».
| # | Action | Résultat attendu |
|---|---|---|
| 5.1 | Ouvrir l’éditeur | la grille de peinture, avec « Cliquez ou glissez sur la grille pour peindre. Non renseigné = disponible. » |
| 5.2 | Ne rien peindre, quitter | l’enseignant est réputé disponible partout — c’est l’état par défaut |
| 5.3 | Peindre le mercredi entier en « Indisponible », portée « Toute l’année », enregistrer | « Disponibilités enregistrées » |
| 5.4 | Régler la préférence « Moment de la journée » = « Matin », intensité « Forte », enregistrer | « Préférences enregistrées » |
| 5.5 | Session bob → Mon espace | il voit les mêmes disponibilités : c’est le même éditeur |
Vérification en aval : Planification → détection sur le cours d’Algorithmique → les cellules du mercredi sont hachurées et leur infobulle nomme l’indisponibilité ; les créneaux d’après-midi sont notés plus bas que ceux du matin.
Pièges connus
Section intitulée « Pièges connus »- Les effectifs du scoring ne viennent pas de la liste des étudiants mais du champ saisi sur la promotion ou le sous-groupe. Une promotion sans aucun étudiant se planifie parfaitement.
- La cible d’un cours est exclusive : une promotion ou un sous-groupe, jamais les deux.
- L’avertissement d’effectif ne bloque rien. Il est légitime qu’un étudiant appartienne à plusieurs sous-groupes.
Les pièges transverses — environnement, authentification, fraîcheur des données — sont rassemblés sur Les pièges connus.
Traçabilité
Section intitulée « Traçabilité »| Ce qui est couvert | Story | Vue |
|---|---|---|
| Structure, matières, enseignants, cours | STORY-007 |
V43 |
| Disponibilités et préférences | STORY-009 |
V44, V72 |
| Effet des exigences sur la détection | STORY-021, STORY-026 |
V11 |
| Lien compte ↔ fiche enseignant | STORY-009, STORY-038 |
— |
Couvert par les tests automatisés : apps/api/src/pedagogy/pedagogy.e2e.spec.ts et
apps/api/src/pedagogy/availability.e2e.spec.ts. Les créations, les refus de suppression, la
cible exclusive et la résolution des disponibilités y sont couverts ; la peinture de la grille
et les vérifications en aval sur la heatmap ne le sont pas.
Checklist
Section intitulée « Checklist »- Établissement neuf → « Aucune année académique. Créez-en une via “Gérer les années”. »
- Année créée → ses semaines sont générées
- Effectifs des sous-groupes supérieurs à la promotion → avertissement, pas blocage
- Suppression d’année → « Impossible de supprimer : l’année contient encore des formations. »
- Le filtre « Groupe » de Planification propose la promotion et ses sous-groupes
- Matière avec type de salle et équipement requis créée
- Enseignant créé, matière rattachée, compte lié
- Même compte sur deux enseignants → « Ce compte est déjà lié à un autre enseignant. »
- Mon espace de bob affiche désormais l’éditeur de disponibilités
- Cours créés ; suppression d’enseignant → « Impossible de supprimer : des cours référencent encore cet enseignant. »
- Détection sur le cours de Chimie → seules les salles de TP équipées sont candidates
- Mercredi peint en « Indisponible » → « Disponibilités enregistrées »
- Détection → les cellules du mercredi sont hachurées, raison nommée au survol
- Préférence « Matin, Forte » → les créneaux d’après-midi sont notés plus bas
Écrans concernés
Section intitulée « Écrans concernés »- Structure pédagogique, Matières, Enseignants et Cours à placer — les quatre écrans de saisie.
- Disponibilités d'un enseignant et Mon espace — le même éditeur, des deux côtés.
- Heatmap et score de créneau — la vérification en aval de chaque bloc.