Analytique d'occupation

En-tête

Domaine	Analytique — produire un indicateur et vérifier qu’il correspond aux données saisies
Durée	~6 min
Niveau	complet
Étiquette	automatisable — les indicateurs sont chiffrés et comparables ; seule la lecture de la matrice est visuelle

Préparation

Socle A — le jeu de démonstration. Le montage est sur la préparation commune.

Compte : demo@delacroix.example (administrateur, porte analytics.read).

Ce scénario mesure une variation, pas une valeur absolue. Il relève un taux d’occupation La part des heures ouvertes pendant lesquelles une salle est effectivement utilisée, sur une période choisie. , ajoute de l’occupation, et vérifie que le taux monte. C’est la seule façon honnête de recetter un indicateur sans recalculer la formule à la main.

1. Les indicateurs répondent

Pilotage.

#	Action	Résultat attendu
1.1	Ouvrir l’écran	« Occupation moyenne du parc » avec son détail « … occupées sur … ouvrées — 60 salle(s) »
1.2	Lire le bandeau de fraîcheur	« Calculé il y a … min », ou « Jamais calculé — lancez un rafraîchissement » au premier passage
1.3	Si jamais calculé, cliquer « Rafraîchir »	« Statistiques d’occupation rafraîchies. »
1.4	Lire le tableau « Taux d’occupation »	les campus, avec « Taux », « Occupées / ouvrées », « Capacité », « Effectif moyen »
1.5	Cliquer une ligne de campus	on descend d’un niveau : les bâtiments
1.6	Cliquer un bâtiment	les salles
1.7	Lire la matrice « Répartition jour × tranche horaire »	les heures creuses ressortent ; chaque cellule est annoncée avec son jour, son heure et son taux
1.8	Lire « Sous-utilisation & sur-sollicitation »	deux listes, « Sous 30 % » et « Au-delà de 85 % »
1.9	Chercher E-301, E-302, E-303 dans la liste basse	elles y sont — le jeu de démonstration les a câblées presque vides

2. La cohérence avec les données saisies

C’est le bloc qui donne sa valeur au scénario.

#	Action	Résultat attendu
2.1	Choisir une salle précise et relever son taux ainsi que ses « Occupées / ouvrées »	deux valeurs notées
2.2	Réservation → réserver cette salle sur un créneau libre de la période analysée, en confirmation immédiate	« Réservation confirmée. »
2.3	Revenir sur Pilotage, redescendre jusqu’à cette salle	le taux n’a pas bougé — le calcul est figé
2.4	Cliquer « Rafraîchir »	« Statistiques d’occupation rafraîchies. »
2.5	Relire la salle	le taux a monté, et les heures occupées ont augmenté du volume réservé
2.6	Annuler la réservation, « Rafraîchir », relire	le taux est revenu à sa valeur initiale

3. Ce qui ne compte pas

#	Action	Résultat attendu
3.1	Planification → poser une séance en brouillon sur une salle, sans publier	le bloc apparaît en pointillés
3.2	Pilotage → « Rafraîchir », relire cette salle	le taux n’a pas bougé : un brouillon ne compte pas
3.3	Publier ce périmètre, revenir, « Rafraîchir »	le taux monte
3.4	Créer une demande de réservation soumise à validation, sans la valider	—
3.5	« Rafraîchir », relire	le taux n’a pas bougé : une demande en attente ne compte pas

Trois exclusions vérifiées : les brouillons, les demandes en attente, et — sans étape dédiée — tout ce qui tombe hors de la plage d’ouverture de l’établissement.

4. Les filtres et l’export

#	Action	Résultat attendu
4.1	Changer « Période » pour un semestre	les chiffres changent, et l’adresse aussi
4.2	Copier l’adresse dans un nouvel onglet	les filtres sont restaurés
4.3	Filtrer sur un « Type de salle »	le tableau et la matrice se réduisent
4.4	Régler « Seuil bas (%) » à 50	la liste « Sous 50 % » s’allonge — les seuils sont un réglage, pas un verdict
4.5	« Exporter CSV »	un fichier reprenant le niveau affiché, filtres compris
4.6	Choisir une période sans aucune semaine matérialisée	« Aucune heure ouvrée sur cette période. »

Pièges connus

• Les taux sont calculés sur la plage d’ouverture complète, 7 jours sur 7. Une salle pleine tous les jours ouvrés de 9 h à 17 h plafonne mécaniquement bien en dessous de 100 %. L’écran le dit lui-même, et c’est la première source d’étonnement.
• Les périodes de type Vacances sortent du dénominateur ; une période gelée qui n’est pas des vacances y reste. On donne cours pendant les examens.
• Le rafraîchissement ne recalcule que la combinaison de filtres affichée. Changer de filtre juste après peut faire réapparaître une date de calcul plus ancienne.

Cet écran ne se met pas à jour tout seul, contrairement au reste du produit : ses données sont un calcul figé. C’est décrit sur Les pièges connus — cliquez « Rafraîchir » avant de comparer deux relevés.

Traçabilité

Ce qui est couvert	Story	Vue
Taux par campus, bâtiment et salle, matrice, seuils, export	STORY-037	V50, V51
Occupation retenue — séances publiées et réservations confirmées	STORY-013, STORY-030	—
Plage d’ouverture au dénominateur	STORY-005, STORY-008	—

Couvert par les tests automatisés : apps/api/src/analytics/analytics.e2e.spec.ts. Le calcul des heures ouvrées et occupées, les exclusions et l’agrégation par niveau y sont couverts ; la navigation descendante et la cohérence après un geste réel ne le sont pas.

Checklist

• « Occupation moyenne du parc » affichée avec son détail heures occupées / ouvrées
• Bandeau de fraîcheur lu, « Rafraîchir » si nécessaire
• Descente campus → bâtiment → salle dans le tableau
• Matrice « Répartition jour × tranche horaire » lisible, chaque cellule annoncée
• E-301, E-302, E-303 apparaissent dans la liste de sous-utilisation
• Taux d’une salle relevé, puis réservation confirmée sur cette salle
• Avant « Rafraîchir » → le taux n’a pas bougé
• Après « Rafraîchir » → le taux a monté, les heures occupées aussi
• Réservation annulée + rafraîchissement → retour à la valeur initiale
• Séance en brouillon → aucun effet ; publiée → le taux monte
• Demande de réservation en attente → aucun effet
• Filtres dans l’adresse, restaurés dans un nouvel onglet
• « Seuil bas (%) » à 50 → la liste basse s’allonge
• « Exporter CSV » → le niveau affiché, filtres compris
• Période sans semaine → « Aucune heure ouvrée sur cette période. »

Écrans concernés

• Analytique d'occupation — l’écran principal.
• Réservations et Publication du planning — les deux sources d’occupation.
• Calendrier académique — la plage d’ouverture et les vacances, au dénominateur.
• Détail d'une salle — les salles que le tableau désigne.