Audit de la documentation

Plan de correction du dossier

En bref : Avant la restitution : rédiger le document de compréhension, signaler formellement les failles à LPI, faire acter le porteur du service d'export, répéter les deux supports ; plus quelques corrections ponctuelles (réserve sur Nuxt 3 dans deux supports, chemin mort dans README.md). Garde-fous : pnpm run check enchaîne construction, routes et check:dossier (description et registre de dix règles). Le contrôle des decks, celui des pages du POC (check-crisalid-poc-trajectory.py) et les 28 autres scripts check-crisalid-* ne tournent qu'à la main, et rien ne vérifie le bloc « En bref ». Ensuite : la page « Données de Projects », la liste canonique des risques LPI, la réduction des annexes de veille, la génération de CONTEXT.md.

Priorités restantes

Ce qui reste, classé par impact et par effort
Chargement du schéma pédagogique...
Position selon l'impact et l'effort ; l'ordre de réalisation est donné par les tableaux ci-dessous.

Avant la restitution

ActionPourquoiPorteurEffort
Rédiger le document de compréhensionC'est le premier livrable ; la matière est sur le site, le texte n'existe pas : livrables/ ne contient que restitution-finale/01-audit.md, 02-proposition.md et annexes/Auteur de l'audit2 à 3 jours
Signaler formellement les failles à LPI, avec un délai de correction convenuRevérifiées le 30 octobre 2026 : toujours ouvertes (01-risques-conditions-go.mdx:7). Aucune trace de signalement dans le dépôt ; D2 le pose en engagement (docs/05-deck/02-atelier-qualification-lpi/deck.md:525, 542)Auteur, par le canal du RSSI30 min
Faire acter le porteur du service d'export : livré avec la vitrine et exploité par la DiBISO, 8–15 j.h en plus du lancement (page du POC)« Proposition à acter au comité » (03-extrait-et-comparatif-du-poc.mdx:12) ; sans porteur, la vitrine synchronisée n'a pas de source stableComitéDécision
Remettre au responsable de l'instance le détail d'exposition retiré du siteLe site n'en parle qu'en termes généraux (01-risques-conditions-go.mdx:34 ; Q23 de la grille) ; aucune trace de remiseAuteur30 min
Répéter les deux supports devant un public testAucune trace de répétition ; check-deck mesure la densité, pas le dérouléAuteur½ journée
Faire relire le dossier par un tiersCette section est une auto-relectureAuteurVariable

Corrections ponctuelles

FichierÉcartCorrection
docs/05-deck/02-atelier-qualification-lpi/deck.md:255« Nuxt 3 hors support standard depuis le 31 juillet 2026 », sans la réserve que portent désormais les pages LPI (00-avis-go-no-go.mdx:35, 01-stack-architecture.mdx:11, 57) et D3 (03-architecture-crisalid/deck.md:553)Ajouter « (date à confirmer) »
livrables/restitution-finale/01-audit.md:352Même affirmation sans réserve dans le deck de restitutionAjouter « (date à confirmer) »
README.md:28Page de référence 05-trajectoire-poc-saclay/scenario-export-statique : ce dossier n'existe plus, et scripts/check-crisalid-poc-trajectory.py:79 interdit son retourRenvoyer à 01-cadrage-saclay/02-scenarios/03-extrait-et-comparatif-du-poc
scripts/generate-navigation.mjs:157, docs/index.mdx:46, docs/05-deck/02-atelier-qualification-lpi/deck.md:561Libellé « Questions à LPI », alors que la page s'intitule « Questions à LPI et à CRISalid » (grille-evaluation.mdx:3)Aligner le libellé
docs/05-deck/01-direction-restitution-audit/, 04-securite-rgpd/, 05-valeur-impact/, 06-lancement-maquette/Dossiers vides, restes de decks supprimés, fondus ou sortis du site (catalogue)Supprimer les dossiers

Pendant la rédaction du document

ActionPourquoiPorteur
Ajouter une page « Données de Projects »La partie LPI n'a aucune page sur ce critère, pondéré à 15 % (Lisibilité)Auteur
Fixer la liste canonique des risques LPITrois décomptes : 8 risques LPI et 5 transverses (01-risques-conditions-go.mdx:15-34), 3 rangs (00-avis-go-no-go.mdx:22-37, repris par D2 deck.md:232), « quatre risques » (01-audit.md:339-346). Les niveaux concordent, la liste nonAuteur
Demander à la DiBISO l'écart entre 235 et 248 unités (Q19)Il touche la complétude (grille-evaluation.mdx:39)DiBISO
Demander une contre-expertise des coûts « depuis le socle »Projection d'un intéressé ; condition posée par 00-methode-estimation.mdx:60, 78DSI

Après la restitution

ChantierGain attenduPorteur
Réduire les annexes de veille à une ligne par plateformeLes 9 pages de docs/01-cadrage-saclay/03-veille/ comptent 21 570 mots bruts ; environ 15 000 de moinsAuteur
Exécuter le parcours des tutoriels de bout en bout sur un environnement isoléParcours prouvé, plus seulement écrit : il est « Non exécuté » (preparer-donnees-et-pile.mdx:9, 88)Auteur
Générer CONTEXT.md par scriptFin des divergences du fichier de reprise ; aucun générateur dans scripts/Auteur
Étendre check:dossier au bloc « En bref »Règle du README.md:36 tenue sans contrôle ponctuel ; le script ne la vérifie pas (scripts/check-dossier.mjs:27-45)Auteur
Étendre la règle des montants d'offreElle ne couvre que deux des montants de la proposition (scripts/chiffres-cles.json, entrée « Montants de la proposition »), pas le montant de l'étape 1 ni le cumul (livrables/restitution-finale/02-proposition.md). Aucun de ces montants n'est aujourd'hui dans docs/Auteur
Chaîner check-crisalid-poc-trajectory.py dans pnpm run checkIl passe (3/3) et ne demande aucun service, mais aucune commande de package.json ne le lanceAuteur

Les garde-fous désormais en place

Ce que vérifie pnpm run check, et ce qui reste manuel
Chargement du schéma pédagogique...
Source : package.json:10-18 et scripts/.
Garde-fouOùLancé parEffet
Navigation et liensscripts/check-routes.mjspnpm run check (package.json:15-16)Échec si une entrée du menu n'a pas de page, si une page est publiée hors menu et hors redirection, ou si un lien interne de docs/ n'aboutit pas
Description obligatoirescripts/check-dossier.mjs:30-33pnpm run check (package.json:16-17)Échec si une page de docs/ n'en a pas ; les aperçus de docs/05-deck/ sont exemptés
Registre des chiffres clésscripts/chiffres-cles.jsonMême scriptDix règles : coût de la Partie 1, anciens scénarios, vocabulaire de la décision, unités, disponibilité, licences, instance, failles LPI, montants d'offre, défauts de sécurité et détails de machine CRISalid
Formulations retiréesMême registreMême script« jamais lancée », « aucune instance Paris-Saclay trouvée », valeurs abandonnées
Détails de failleMême registre, règles partoutMême scriptLes deux règles de sécurité valent aussi pour les decks et cette section ; les huit autres les exemptent (chiffres-cles.json, liste exemptions)
Séparation des supportsMême registreMême scriptMontants de la proposition interdits dans tout docs/, pages d'audit et decks compris (voir l'extension à faire ci-dessus)
Date de mise à jourrecit.config.ts:63 (showLastModified)Affichage du siteDate tirée de Git, sous chaque page
Pages du POCscripts/check-crisalid-poc-trajectory.pyÀ la mainÉchec si une page du POC manque ou si l'ancien dossier de trajectoire revient
Densité et accessibilité des decksscripts/check-deck.mjsÀ la main (README.md:14)Santé, mots par diapositive, durée estimée

Limites de ces contrôles :

  • check-dossier.mjs ne parcourt que docs/ (scripts/check-dossier.mjs:22) : CONTEXT.md, README.md et livrables/ échappent au registre.
  • Aucun script ne vérifie le bloc « En bref », ni l'exactitude d'un chiffre hors des dix règles du registre.
  • Les 29 scripts check-crisalid-* ne contrôlent pas tous des contrats du code CRISalid : la plupart le font, mais check-crisalid-poc-trajectory.py vérifie des pages du site et un exemple d'export (docstring, l.2-11), et check-crisalid-tutorial-data.py les données de démonstration des tutoriels. Aucun n'est lancé par pnpm run check.
Last modified on