Paillasse/docs/dette.md

Dette technique

Ce qui est connu, accepté pour l'instant, et à traiter. Une ligne par sujet ; retirer la ligne (et le noter dans le journal) quand c'est fait.

Sujet	Pourquoi c'est une dette	Quand	Origine
Image Uptime Kuma non figée (louislam/uptime-kuma:1)	Une version différente peut arriver à n'importe quel redéploiement, sans test. Figer un tag précis (voire le digest) dans une variable du rôle supervision, et documenter la mise à jour par Ansible (changer la variable, relancer le rôle, vérifier) — jamais par le bouton de l'interface. Kuma lui-même qualifie ce tag d'« historique » (il injecte docker-latest-warning.js dans les images latest/1, constaté le 2026-10-09) : prévoir la migration vers un tag versionné, en testant la page de statut et les sondes.	Avant le pilote	Demande d'Adam, 2026-10-09
Larastan (PHPStan niveau 6) absent	Exigé par le CLAUDE.md depuis l'étape 8, jamais installé.	Bloc B	Étape 8
Temps d'ouverture d'un lab : p95 non mesuré	Deux mesures seulement (4,06 et 4,35 s, critère < 5 s). Il faut une série.	Étape 13	Étape 11
Capacité : 15 VM au pire cas	Une classe de 30 sur le lab 08 demande 90 VM. Mesurer en charge, décider du surengagement mémoire (KSM).	Étape 13	Étape 11
Vitrine : Tailwind par CDN d'exécution (cdn.tailwindcss.com, 19 pages)	Non destiné à la production selon Tailwind, lent, et oblige la vitrine à tolérer les scripts en ligne dans sa CSP. Compiler ces styles avec Vite.	Avant ouverture publique	Étape 12 (design)
Vitrine : 52 scripts en ligne, Google Fonts, jsDelivr (démos xterm, CodeMirror)	CSP vitrine avec 'unsafe-inline' ; CDN parfois filtrés par les réseaux scolaires. Auto-héberger polices et bibliothèques, passer les scripts en fichiers.	Avant ouverture publique	Étape 12
xterm.js 5.5.0 (6.0.0 disponible)	Version majeure à évaluer séparément.	Bloc B	Étape 12
NodeSource installé par curl … | bash	Script distant exécuté en root au premier déploiement. Déclarer le dépôt (deb822) avec une clé vérifiée.	Bloc B	Étape 8
Aucune vérification dans un vrai navigateur	Extension Chrome non connectée (étapes 8 et 12). La CSP n'est contrôlée que par ses rapports.	Dès que possible	Étapes 8 et 12
Pas de sonde hors du serveur	Si le serveur tombe, personne n'est prévenu.	À décider avec Adam	Étape 7
Kolla installé depuis une branche, pas un tag	Reproductibilité.	Montée de version	ADR 0001
Correction séquentielle (~5 s pour le lab 08)	Acceptable ; à paralléliser si la charge l'exige.	Étape 13	Étape 11
Tâches Ansible toujours « modifiées » (composer, npm, build, cache)	Brouille la lecture de l'idempotence.	Bloc B	Étape 8
Permissions-Policy ferme caméra et micro	À ouvrir pour la visio.	Étape 15	Étape 12