Référentiel et patrimoine

En-tête

Domaine	Référentiel & patrimoine — l’arborescence, les nomenclatures, la fiche de salle, les plans d’étage
Durée	~10 min
Niveau	complet
Étiquette	automatisable, sauf le bloc 4 : le traçage d’une forme sur un plan est un geste au pointeur

Préparation

Socle B. Le montage est sur la préparation commune.

Compte : alice (administratrice, porte referential.manage).

Une salle Un espace où l'on donne cours ou que l'on réserve, caractérisé par sa capacité, son type et ses équipements. saisie ici doit se retrouver ailleurs : le scénario ne s’arrête pas à la saisie : chaque bloc finit par une vérification dans un écran consommateur. C’est le seul moyen de savoir si une donnée sert à quelque chose.

1. L’arborescence

Référentiel & parc → Patrimoine.

#	Action	Résultat attendu
1.1	Sur un établissement neuf, ouvrir l’écran	« Aucun campus. Créez le premier. »
1.2	Créer le campus « Campus Nord », avec son adresse et sa géolocalisation	il apparaît dans l’arbre
1.3	Créer un second campus du même nom	« Un campus porte déjà ce nom. »
1.4	Créer un bâtiment « BAT-N » sur ce campus, puis une salle N-101 de 40 places	ils apparaissent, imbriqués
1.5	Tenter de supprimer le campus	« Impossible de supprimer : le campus contient encore des bâtiments. »
1.6	Tenter de supprimer le bâtiment	« Impossible de supprimer : le bâtiment contient encore des salles. »
1.7	Saisir un JSON invalide dans « Caractéristiques (JSON) »	« JSON invalide : corrigez les caractéristiques avant d’enregistrer. »

Vérification en aval : ouvrir Réservation et lancer une recherche large → N-101 apparaît dans les résultats. Une salle créée est immédiatement réservable.

2. Les nomenclatures

Référentiel & parc → Nomenclatures.

#	Action	Résultat attendu
2.1	Ouvrir l’écran sur un établissement neuf	« Aucun type de salle. » et un catalogue d’équipements vide
2.2	Créer les types « Amphithéâtre » et « Salle de TP »	ils apparaissent
2.3	Créer les équipements « Vidéoprojecteur » (Audiovisuel) et « Paillasse » (Laboratoire)	ils apparaissent avec leur catégorie
2.4	Recréer un type du même nom	« Un type de salle porte déjà ce nom. »
2.5	Fiche N-101 → poser le type « Salle de TP » et l’équipement « Vidéoprojecteur » en quantité 1	ils apparaissent sur la fiche
2.6	Retour aux nomenclatures, supprimer « Salle de TP »	« Impossible de supprimer : des salles utilisent encore ce type. »
2.7	Supprimer « Vidéoprojecteur »	« Impossible de supprimer : des salles utilisent encore cet équipement. »

Vérification en aval : dans Réservation, « Filtres avancés » → filtrer sur le type « Salle de TP » puis sur l’équipement « Vidéoprojecteur » → N-101 est retenue par les deux. Filtrer sur « Amphithéâtre » → aucune salle ne correspond.

3. La fiche de salle et ses indisponibilités

#	Action	Résultat attendu
3.1	Ouvrir N-101 depuis « Parc de salles »	la fiche s’ouvre, titrée « Salle N-101 »
3.2	Modifier la capacité, enregistrer	« Modifications enregistrées. »
3.3	Créer une salle avec le même code	« Une salle porte déjà ce code. »
3.4	« Archiver » la salle	l’avertissement précise que « La salle ne sera plus proposée à la planification ni à la réservation, mais son historique est conservé. » ; puis « Salle archivée. »
3.5	Rechercher cette salle dans Réservation	elle n’apparaît plus
3.6	« Réactiver »	elle est de nouveau proposée

Les indisponibilités ont leur propre scénario : Indisponibilités de salle.

4. Les plans d’étage

Référentiel & parc → Plans d’étage.

#	Action	Résultat attendu
4.1	Ouvrir l’écran	« Aucun plan. Créez le premier pour activer la vue Plan de la réservation. »
4.2	« Nouveau plan » → bâtiment « BAT-N », étage 1, une image PNG ou JPG	« Plan créé — associez maintenant les salles. »
4.3	Créer un second plan sur le même bâtiment et le même étage	« Un plan actif existe déjà pour ce bâtiment et cet étage. »
4.4	Déposer un fichier qui n’est ni SVG, ni PNG, ni JPG — un PDF renommé, par exemple	« Fichier non reconnu — SVG, PNG ou JPG attendu. » — le format est vérifié sur le contenu, pas sur l’extension
4.5	Regarder la ligne du plan dans la liste	« … · 0 salle(s) associée(s) »
4.6	« Ouvrir l’éditeur » → outil « Rectangle » → tracer une forme sur la salle, choisir N-101, « Associer », puis « Enregistrer »	« Associations enregistrées. » ; N-101 passe de « Salles restantes » à « Salles associées »

Vérification en aval : dans Réservation, basculer sur « Plan », choisir « BAT-N » et l’étage 1 → N-101 est cliquable sur le plan. Avant l’étape 4.6, le plan s’affichait sans aucune salle.

#	Action	Résultat attendu
4.7	« Archiver » le plan	« La vue Plan repassera automatiquement en liste pour ce bâtiment et cet étage. »
4.8	Retourner sur Réservation, mode « Plan », même bâtiment	« Aucun plan pour ce bâtiment — la liste reste affichée. » — jamais une erreur

Pièges connus

• Une salle se crée dans l’arborescence, pas dans la liste. L’écran « Parc de salles » est une lecture ; la création passe par « Patrimoine », ce qui garantit qu’une salle a toujours un bâtiment.
• Les caractéristiques libres ne sont lues par aucun moteur. Ni le scoring, ni la recherche, ni le solveur n’y touchent : c’est un pense-bête.
• La quantité d’un équipement n’est pas vérifiée par les contraintes. Une salle satisfait l’exigence dès qu’elle déclare l’équipement, quelle qu’en soit la quantité.

Un type ou un équipement créé ne contraint rien tant que personne ne l'exige

Le bloc 2 crée deux types et deux équipements, et rien ne change dans le comportement du moteur. C’est normal : les nomenclatures sont des vocabulaires.

Il faut trois saisies pour qu’une exigence morde :

1. le type ou l’équipement existe — bloc 2 ;
2. il est posé sur les salles qui en disposent — cas 2.5 ;
3. il est exigé par une matière ou un cours — scénario Pédagogie.

Le symptôme : « j’ai créé les équipements, le solveur les ignore ». Il ne les ignore pas — personne ne les demande, ou aucune salle ne les déclare.

Les pièges transverses — environnement, authentification, fraîcheur des données — sont rassemblés sur Les pièges connus.

Traçabilité

Ce qui est couvert	Story	Vue
Arborescence, nomenclatures, fiche de salle, archivage	STORY-013	V40, V41
Plans d’étage, import, association, repli en liste	STORY-019	V31
Recherche filtrée par type et équipement	STORY-015	V30
Audit du patrimoine	STORY-010	V62

Couvert par les tests automatisés : apps/api/src/referential/referential.e2e.spec.ts et apps/api/src/floor-plans/floor-plans.e2e.spec.ts. Les créations, les refus de suppression, la sanitisation des fichiers et les associations y sont couverts ; le traçage d’une forme et la vue Plan côté réservation ne le sont pas.

Checklist

• Établissement neuf → « Aucun campus. Créez le premier. »
• Campus, bâtiment et salle créés, imbriqués dans l’arbre
• Doublon de nom → « Un campus porte déjà ce nom. »
• Suppression bloquée → « Impossible de supprimer : le campus contient encore des bâtiments. »
• JSON invalide → « JSON invalide : corrigez les caractéristiques avant d’enregistrer. »
• La salle apparaît dans la recherche de Réservation
• Types et équipements créés ; suppression bloquée quand ils sont utilisés
• Le filtre par type et par équipement retient bien la salle
• Archivage → « Salle archivée. » et la salle disparaît de la recherche ; réactivation la ramène
• Plans → « Aucun plan. Créez le premier pour activer la vue Plan de la réservation. »
• Doublon bâtiment × étage → « Un plan actif existe déjà pour ce bâtiment et cet étage. »
• Mauvais format → « Fichier non reconnu — SVG, PNG ou JPG attendu. »
• Plan sans association → « … · 0 salle(s) associée(s) », et la vue Plan est vide
• Après association → « Associations enregistrées. » et la salle est cliquable sur le plan
• Plan archivé → « Aucun plan pour ce bâtiment — la liste reste affichée. »

Écrans concernés

• Patrimoine, Nomenclatures, Parc de salles et Détail d'une salle — les quatre écrans du référentiel.
• Plans d'étage et Détail d'un plan d'étage — les plans.
• Réservations — l’écran consommateur de chaque bloc.