Audit de la documentation

Audit de la section « Compréhension CRISalid »

En bref : La section CRISalid compte 35 pages et environ 23 800 mots de prose. Elle a un point d'entrée qui dit ce que CRISalid apporte et ce qui bloque, un ordre de lecture en neuf étapes, des fiches du cœur avec une rubrique « Pour la vitrine », et des constats d'instance tous au statut « Observé sur instance (dev) ». Aucun détail de la machine de développement n'est publié, et un garde-fou l'interdit. Deux affirmations sont à corriger en priorité. Les trois défauts de sécurité du code sont dits « signalés à l'équipe CRISalid » sans aucune trace de ce signalement, et une autre page dit qu'ils sont encore « à signaler ». La licence CeCILL est donnée « pour le cœur » au statut Confirmé, alors que l'annuaire, l'une des cinq briques du cœur, n'a pas de fichier de licence. Une décision reste au comité : qui porte le service d'export (Q5). Le reste est de moindre gravité : le menu ne suit pas tout à fait l'ordre de lecture, deux fiches du cœur n'ont pas de capture, la page des briques se contredit sur ce qui tourne, et quelques libellés de statut sortent de la règle annoncée : hors des huit statuts sur la page d'instance, hors des trois valeurs de sa colonne sur la page des briques.

La section en chiffres

DossierPagesMots de prose
Repères5≈ 4 160
Instance de Paris-Saclay2≈ 2 400
Briques (sous-projets)6≈ 3 710
Données7≈ 5 730
Fonctionnement transversal2≈ 2 290
Tutoriels13≈ 5 480
Total35≈ 23 800

Mots de prose hors front matter, code, schémas, cibles de liens et code en ligne. La section représente 35 pages sur les 84 du site (hors aperçus de deck) et environ 28 % de ses mots de prose comptés de la même façon. Les annexes de référence pour la DSI (dictionnaire, stockages, contrats d'API) et la trame des tutoriels restent entières, par choix : elles servent la DSI.

Ce qui tient

Ces points sont vrais sur le site actuel ; ils ne sont plus des constats, mais ils fixent ce qu'il ne faut pas défaire.

  • Pas de détail d'infrastructure. La page d'instance donne un accès « en lecture seule, temporaire, accordé par la DiBISO », un ordre de grandeur des ressources et une phrase agrégée sur l'exposition (Ce que montre l'instance, l.22, l.113 et l.120). Le registre scripts/chiffres-cles.json interdit les détails de la machine.
  • Un ordre de lecture. Comprendre CRISalid (l.85-99) donne neuf étapes, de « apporte / bloque » à l'exploitation ; l'instance est rangée juste après les repères dans le menu (scripts/generate-navigation.mjs, rangs des dossiers).
  • Des statuts de preuve. Les huit statuts sont définis dans Sources et preuves (l.19-28) et repris dans le glossaire et la page d'entrée. Les constats d'instance sont au statut « Observé sur instance (dev) », sans conclusion de production (instance, l.27 et l.136-138).
  • Ce que CRISalid apporte et ce qui bloque tient en deux tableaux (Comprendre CRISalid, l.55-74) ; les six inconnues sont dans Ce qui n'est pas prouvé (l.22-31), chacune reliée à une question du registre.
  • Les briques ont une page d'entrée de 21 lignes (Les briques de CRISalid) et cinq fiches du cœur, chacune avec un schéma et une rubrique « Pour la vitrine ». Les 16 autres dépôts tiennent en une ligne.
  • Le POC a sa page de travail, hors de la section : Extrait et comparatif du POC. Les tutoriels disent qu'ils ne servent pas au POC (Par où commencer, l.10).
  • Les huit contrôles ont chacun une ligne « Résultat » et une synthèse commune (Par où commencer, l.48-63). Les scripts qu'ils citent existent dans scripts/ ; le seul script cité absent, sort_structures.py, appartient au dépôt de l'annuaire et se lance depuis sa copie (charger-structures-et-personnes.mdx:31-32).
  • Les liens internes de la section sont valides, ancres comprises.

Ce qui reste à faire, par priorité

Priorité élevée

#ConstatPreuveAction
1Un signalement affirmé sans trace. Deux pages disent que les trois défauts de sécurité du code ont été « signalés à l'équipe CRISalid ». Rien sur le site ne date ni ne décrit ce signalement, aucune question du registre ne le suit, et la même page dit plus haut qu'ils sont encore « à signaler ». Elle range aussi l'accès à un interlocuteur de l'équipe CRISalid parmi ce qui manqueCe qui n'est pas prouvé, l.50 (« À signaler ») contre l.68 (« signalés ») ; l.45 (interlocuteur à obtenir) ; Sécurité, droits et données personnelles, l.92Si le signalement a eu lieu, le dater et dire par quel canal (date-fait). Sinon, écrire « à signaler » dans les deux pages et ajouter le signalement au registre des questions ou à la feuille de route
2Une licence « pour le cœur » au statut Confirmé, inexacte. La page d'entrée écrit « sous licence CeCILL pour le cœur », Confirmé. Or l'annuaire (Directory Bridge), l'une des cinq briques du cœur, n'a aucun fichier de licence, et la licence d'Apollo est incohérente entre ses fichiersComprendre CRISalid, l.63 ; Exploitation et gouvernance, l.81, l.83 et l.84 ; fiche de l'annuaire, l.43Écrire : « CeCILL 2.1 pour quatre briques du cœur ; l'annuaire n'a pas de fichier de licence », et renvoyer à Exploitation et gouvernance
3Le porteur du service d'export n'est pas décidé. Les pages s'accordent sur une proposition : un service livré avec la vitrine, exploité par la DiBISO, 8–15 j.h en plus. La décision revient au comitéComprendre CRISalid, l.69 (« à acter au comité (Q5) ») ; Ce qui n'est pas prouvé, l.28 ; Extrait et comparatif du POCFaire acter au comité (Q5), puis reporter la décision dans ces trois pages

Priorité moyenne

#ConstatPreuveAction
4La page des briques se contredit sur ce qui tourne. Son « En bref » dit que les briques hors du cœur, référentiels compris, « ne tournent pas » sur l'instance. Plus bas, la même page écrit qu'un service de registre des organisations tourne, et range deux référentiels en « À confirmer » parce qu'un service semblable tourne. La page d'instance dit que les référentiels tournentLes briques de CRISalid, l.11 contre l.43, l.55-56 et l.87 ; Ce que montre l'instance, l.69 ; Ce qui n'est pas prouvé, l.62 (Vocab Search : « Service présent »)Restreindre « qui ne tournent pas » aux expériences d'IA, comme le fait déjà l'intitulé du groupe (l.63), et dire que des services de référentiels tournent sans rattachement établi à leur dépôt
5Cinq briques dans le texte, six lignes sous « Cœur : le produit ». Le dépôt d'assemblage est rangé sous l'intitulé du cœur, alors que le texte annonce cinq briques : un lecteur qui compte les lignes en trouve sixLes briques de CRISalid, l.10 et l.47-53Ranger crisalid-deployment dans un groupe à part (« Assemblage »), ou dire en une phrase qu'il accompagne le cœur sans en faire partie
6Le menu ne suit pas l'ordre de lecture. Dans le menu, « Ce qui n'est pas prouvé », le glossaire et « Sources et preuves » précèdent l'instance, que l'ordre de lecture place avant (étapes 3-4 contre 5). Les six pages de référence des données (cartographie, provenance, catalogue, dictionnaire, stockages, contrats) s'intercalent entre l'étape 7 (modèle) et les étapes 8-9 (sécurité, exploitation)Comprendre CRISalid, l.87-99 ; scripts/generate-navigation.mjs : 00-reperes 10, 06-instance-saclay 15, 02-sous-projets 17, 01-donnees 20, 03-fonctionnement-transversal 40 ; dans 00-reperes, ce-qui-nest-pas-prouve 20, glossaire 40, sources-et-preuves 50Choix d'auteur : soit ranger le glossaire et « Sources et preuves » en annexe et ramener « Ce qui n'est pas prouvé » après l'instance, soit dire en tête de la page d'entrée que l'ordre de lecture diffère du menu
7Deux fiches du cœur sans capture. L'API (Apollo) et l'annuaire (Directory Bridge) n'ont qu'un schéma. Des captures existent dans public/images/crisalid/ mais ne servent qu'à la page d'audit Les sous-projets en clair, pas à la section : tableau de bord, structures, activités et droits de SoVisu+, publication dans le graphe, documentation officiellegrep -c "<Screenshot" : 0 dans crisalid-apollo.mdx et crisalid-directory-bridge.mdx ; grep -rn "images/crisalid" docs/03-crisalid : trois images seulement (graphe, publications de SoVisu+, moissonneur)Reprendre dans la section les captures utiles (structures de SoVisu+ pour l'annuaire, par exemple) ; prendre une capture pour Apollo s'il en faut une
8Le détail de la machine de développement doit être remis hors site. La page d'instance le réserve « au responsable de l'instance » ; rien ne permet de vérifier qu'il lui a été remisCe que montre l'instance, l.120Remettre la note au responsable de l'instance ; action hors site, sans correction éditoriale

Priorité faible

#ConstatPreuveAction
9Des libellés de statut hors de la règle annoncée. La page d'instance qualifie ses inconnues de « Montré », « Risque visible » et « Toujours à confirmer », qui ne font pas partie des huit statuts. La page des briques annonce trois statuts pour sa colonne, puis en emploie deux autres : « Partiel » (Vocab Search, l'ancien déploiement Kubernetes) et « Expérimental ». Ces deux-là font bien partie des huit (Sources et preuves, l.22 et l.26), mais la règle de la l.43 ne les annonce pasCe que montre l'instance, l.31-38 ; Les briques de CRISalid, l.43 contre l.57, l.65-66 et l.69Instance : renommer la colonne (« Ce que l'observation en dit ») pour qu'on n'y lise pas un statut. Briques : compléter la règle de la l.43, ou ramener Vocab Search à « Observé sur instance (dev) » ou « À confirmer » selon sa propre règle
10La page d'instance raconte l'histoire de la section. « Jusqu'au 29 octobre, la section reposait sur la lecture du code… » ; « ce qui n'était jusqu'ici qu'une lecture du code ». La date d'observation est un fait ; le récit de ce que la section disait avant ne sert pas le lecteurCe que montre l'instance, l.14 et l.72Garder le fait (« observée le 29 octobre 2026 ») et retirer le récit
11« POC de novembre ». Sept passages, dont l'« En bref » de la page d'entrée et ceux des tutoriels, situent le POC en novembre. Il court du 9 novembre au 4 décembre 2026Comprendre CRISalid, l.12 ; Par où commencer, l.4 et l.10 ; en-têtes des quatre pages du parcours (l.9)Écrire « le POC de pertinence » sans mois, ou donner les deux dates
12Des noms de nœuds non observés dans deux requêtes de tutoriel. HAS_TITLE/Literal et HAS_IDENTIFIER/AgentIdentifier sont marqués « Non relevés, À confirmer » dans la table de correspondance, mais restent dans des requêtesVérifier le graphe et l'API, l.31 ; Moissonner les publications, l.58 ; Charger structures et personnes, l.57Acceptable tant que la table le signale ; à corriger si une nouvelle observation de l'instance relève les noms réels
13Trois schémas du même circuit. Chacun annonce un angle différent et renvoie au schéma de référenceComprendre CRISalid, l.30 ; Les briques de CRISalid, l.15 et l.39 ; Cartographie globale, l.14-18Choix d'auteur : les garder tels quels ou n'en garder que deux

Méthode

Relecture en lecture seule des 35 pages de docs/03-crisalid/, avec :

  • des recherches ciblées sur les statuts employés dans les colonnes « Statut », les chiffres clés de l'instance (18,5 M nœuds, 51 et 184 unités sur 235, 3 353 et 3 362, 7 septembre) et les formulations d'état ;
  • une vérification de tous les liens internes de la section, ancres comprises, par un script ;
  • la vérification que chaque script cité par les tutoriels existe dans scripts/, et l'exécution de scripts/check-crisalid-poc-trajectory.py (3 contrôles sur 3) ;
  • un comptage des mots de prose par dossier ;
  • node scripts/check-dossier.mjs.

Les chiffres clés de l'instance sont cohérents d'une page à l'autre.

Ce que cette relecture n'a pas vérifié

  • L'exactitude technique des affirmations de code : les copies des dépôts CRISalid (official-crisalid) ne sont pas présentes à côté du dépôt de l'audit, donc les huit contrôles n'ont pas pu être relancés (Par où commencer, l.17).
  • Les références réglementaires de la page Sécurité, toujours marquées « À confirmer par le FSD » (Sécurité, droits et données personnelles, l.67).
  • Le rendu des pages : schémas et captures n'ont pas été vus construits, seul le texte source a été lu.
Last modified on