Avant une démonstration

Dix minutes de pré-vol, à dérouler debout dans le couloir. Elle ne teste pas le produit — elle vérifie qu’il est prêt à être testé.

L’ordre, et le temps

	Ce qu’on fait	Temps
1	Démarrer les services et la base	~2 min
2	Charger le jeu de démonstration	~2 min
3	Vérifier les quatre repères de la démonstration	~4 min
4	Ouvrir les onglets et se connecter	~2 min

Au premier lancement de la journée, comptez le double : le solveur met une trentaine de secondes à se déclarer prêt, et les images Docker doivent être là.

1. Les services

docker compose up -d postgres redis solver
cd packages/db && bun run db:migrate
cd ../.. && bun run dev

L’application répond sur http://localhost:3000, l’API sur http://localhost:3001. La table complète des adresses est sur le gabarit — ne vous fiez pas à docs/demo-script.md sur ce point, il annonce des ports faux.

Le solveur est le seul service dont la disponibilité n’est pas immédiate :

curl http://localhost:8082/q/health/ready

2. Le jeu de démonstration

bun run demo:seed

La commande détruit et recrée le tenant de démonstration. Elle est idempotente : même graine, mêmes données, octet pour octet. À la fin, elle affiche un récapitulatif des quatre scénarios câblés — s’il n’apparaît pas, quelque chose a échoué.

Établissement	Institut Supérieur Delacroix — DÉMO
Connexion	demo@delacroix.example / Demo-Delacroix-2026!
Rôle	administrateur
Regénérer	relancer bun run demo:seed

Le nom du tenant porte la mention « DÉMO », et c’est délibéré : personne, devant un client, ne doit se demander s’il regarde de vraies données. Si la mention a disparu, vous n’êtes pas sur le bon établissement.

3. Les quatre repères

Ce sont les quatre points que la démonstration nomme à voix haute. Si l’un manque, le script se casse en direct.

Repère	Où le vérifier	Ce qu’on doit voir
La grille est dense	Planification	un emploi du temps peuplé sur toute la semaine — pas un écran vide
Algorithmique — TD est sans séance	Planification → « Créer un cours »	le cours existe dans la liste et n’a aucune séance posée
B-201 est réservée	Planification, semaine 2, mardi 09:45	la plage est occupée par « Conseil pédagogique »
Les cinq DEMO-MULTI-* sont sans séance	Pédagogie → « Cours à placer »	cinq cours en attente, matière du placement optimisé

4. Les onglets

Ouvrez à l’avance ce que vous allez montrer, et connectez-vous avant d’entrer dans la salle :

• la grille de Planification, sur la semaine que vous démontrerez ;
• l’écran de Réservation ;
• éventuellement Pilotage, si vous comptez parler patrimoine.

Le limiteur de débit d'authentification — une heure perdue s'il n'est pas connu

Les endpoints d’authentification sont limités à 100 requêtes / 60 s en fenêtre glissante — le compteur ne se remet à zéro qu’après une minute de silence complet. Saturé, l’API répond 400 avec un corps vide. Si des inscriptions enchaînées échouent sans message, cesser toute requête une minute puis reprendre.

Le symptôme est trompeur : le message affiché est « Une erreur est survenue. Veuillez réessayer. », le générique. Rien n’indique le limiteur, et les identifiants sont bons.

Quand il frappe : quand on enchaîne les connexions et les créations de compte pour préparer une démonstration ou un test d’isolation. Autrement dit, exactement maintenant.

Ce qu’il faut faire : ne rien envoyer pendant une minute, puis reprendre. Ne changez pas de mot de passe, ne réinstallez rien.

La checklist

• docker compose up -d postgres redis solver → les trois services démarrent
• cd packages/db && bun run db:migrate → les migrations passent sans erreur
• bun run dev → l’application répond sur http://localhost:3000
• curl http://localhost:8082/q/health/ready → le solveur répond
• bun run demo:seed exécuté sans erreur, récapitulatif des quatre scénarios affiché
• Connexion avec demo@delacroix.example → l’accueil s’affiche
• Le nom de l’établissement porte bien la mention « DÉMO »
• Planification → la grille montre un emploi du temps dense
• « Algorithmique — TD » apparaît dans les cours sans séance placée
• Semaine 2, mardi 09:45 → B-201 porte la réservation « Conseil pédagogique »
• Les cinq cours DEMO-MULTI-* sont sans séance
• Les onglets de démonstration sont ouverts et la session est active

Et ensuite

• Vous démontrez — le script de démonstration est dans docs/demo-script.md, séquencé en dix minutes : la grille, le placement avec heatmap, l’anti-conflit, le placement optimisé, la lecture patrimoine.
• Vous recettez — enchaînez sur le chemin critique, qui part exactement de l’état que cette page vient de produire.

Traçabilité

STORY-042 (jeu de démonstration Delacroix), STORY-031 et STORY-032 (solveur et son orchestration — la sonde de disponibilité), STORY-011 (le seed et ses commandes).

Pages liées

• Chemin critique — la suite immédiate, trente minutes.
• Le gabarit d’un scénario — les comptes, les ports, le format.
• La recette — les deux niveaux de parcours.
• Les pièges connus — le recueil, dont celui du limiteur de débit.