Les sous-projets CRISalid, en clair et en images
En bref : La version lisible des sous-projets est dans la section CRISalid : la carte des briques fait foi pour l'inventaire des 21 dépôts, et cinq briques forment le produit (l'annuaire, le moissonneur, le graphe, l'API et SoVisu+), chacune avec une fiche, un schéma et une rubrique « Pour la vitrine ». Les fiches sont justes au regard de leurs sources. Restent trois chantiers : dix images sourcées ne sont publiées que dans cette page d'audit, et non dans les fiches ; Scénarios et coûts renvoie encore ici comme « inventaire » au lieu de la carte, et la carte elle-même range l'assemblage parmi les briques du produit et dit dans son « En bref » que les référentiels ne tournent pas sur l'instance, ce que son détail nuance ; le glossaire décrit les briques en jargon, sous des noms que les fiches n'emploient pas. Viennent ensuite une légende d'image à corriger dans la fiche du moissonneur, et deux avertissements qui doivent suivre leurs images si elles rejoignent une fiche.
Cette page vérifie si un lecteur non technique comprend, à partir du site, ce que fait chaque brique de CRISalid, et si ce qu'il lit est exact au regard des fiches et de leurs sources. Elle ne refait pas l'explication : celle qui fait foi est dans Comprendre CRISalid (circuit des données) et dans la carte des briques (inventaire et statuts).
Ce que le site explique bien
| Point | Où le lecteur le trouve |
|---|---|
| Un vocabulaire unique et simple : « l'annuaire », « le moissonneur », « le graphe », « l'API », « SoVisu+ », avec le nom du dépôt entre parenthèses dans le titre de chaque fiche | carte-des-sous-projets.mdx:10 et :48-52 ; comprendre-crisalid.mdx:35-41 ; titres des cinq fiches de docs/03-crisalid/02-sous-projets/coeur/ |
| Cinq briques du cœur, le même nombre dans l'« En bref » de la carte et dans Comprendre CRISalid (le tableau de la carte en compte six, voir priorité 2) | carte-des-sous-projets.mdx:10 ; comprendre-crisalid.mdx:23 |
| Chaque fiche commence par l'usage : « En bref », puis « Ce que c'est et à qui ça sert » ; la révision lue est renvoyée en fin de page | crisalid-apollo.mdx:9-17, :61 ; crisalid-directory-bridge.mdx:9-17, :60 ; crisalid-ikg.mdx:10-18, :73 ; sovisuplus.mdx:10-18, :71 ; svp-harvester.mdx:10-18, :73 |
| Un schéma par fiche et une rubrique « Pour la vitrine » (apporte, prouvé, bloque) | les cinq fiches, rubrique « Ce qui se passe dedans » et « Pour la vitrine » |
| Les limites sont dites dans la fiche : suppressions ignorées, enrichissement arrêté depuis le 7 septembre 2026, correction limitée aux identifiants, clé d'API qui ouvre l'écriture | crisalid-ikg.mdx:12, :52, :57 ; sovisuplus.mdx:12, :49-51 ; crisalid-apollo.mdx:11, :42 |
| API générée, mais à partir d'une description écrite à la main : les deux affirmations sont réconciliées | crisalid-apollo.mdx:17 et :44 |
| Le moissonneur ne déclenche rien seul : le graphe lui relaie les demandes, qui viennent de SoVisu+ ou d'une tâche de tirage au hasard | crisalid-ikg.mdx:18, :46 ; svp-harvester.mdx:18 ; exploitation-et-gouvernance.mdx:34 |
| Les briques hors décision sont réunies et motivées en une section, sans fiche propre | carte-des-sous-projets.mdx:135-139 |
| Chaque fiche cite la documentation officielle quand elle existe, et dit quand elle n'existe pas | rubrique « Liens » des cinq fiches ; crisalid-apollo.mdx:58 |
| L'absence de vue d'ensemble officielle est un constat écrit, avec la capture dans la présentation sur CRISalid | carte-des-sous-projets.mdx:78 ; docs/05-deck/03-architecture-crisalid/deck.md:196 |
| Les référentiels ne sont pas surestimés : registre des organisations, Taxi et JEL « À confirmer », Vocab Search « Partiel » | carte-des-sous-projets.mdx:55-58, :87, :95, :114 ; 00-ce-que-linstance-demontre.mdx:69 |
Ce qui reste à corriger, par priorité
Priorité 1 : publier les images là où le lecteur les cherche
Dix images sourcées ne sont publiées que dans cette page d'audit. Un grep de docs/ et src/ ne trouve aucune autre page qui les affiche : les trois écrans de SoVisu+ (tableau de bord, structures, activités) et l'écran de gestion des droits, une publication du graphe de l'instance, le schéma officiel des agents, l'interface doccano, le diagramme CERIF, l'accueil et la vue d'ensemble de la documentation officielle. La présentation sur CRISalid n'emploie que la version recadrée de la vue d'ensemble (deck.md:196). Les cinq fiches n'ont que trois images en tout : le graphe (crisalid-ikg.mdx:20-26), une maquette de SoVisu+ (sovisuplus.mdx:20-27) et le schéma du moissonneur (svp-harvester.mdx:37-44). La carte des briques n'en a aucune.
Si cette page d'audit sort de la navigation, comme le propose l'audit de lisibilité, ces images disparaissent du site. Emplacements proposés, sans fait nouveau à établir :
| Image | Emplacement proposé |
|---|---|
| Tableau de bord et vue par structure de SoVisu+ | fiche SoVisu+, après la maquette des publications : la vue par structure montre ce qu'un documentaliste suit par laboratoire |
| Une publication du graphe et ses sources | fiche du graphe, sous le schéma du rapprochement, avec sa légende, qui signale la limite de 30 liens (priorité 3) |
| Recherche des chercheurs d'un thème (agents) | carte des briques, bloc « L'assistant et la recherche d'experts » |
| Vue d'ensemble officielle « à venir » | carte des briques, à l'appui de la phrase qui la cite |
| Diagramme CERIF | modèle de données, section « CERIF : une inspiration, pas une implémentation » |
| Activités et gestion des droits de SoVisu+, doccano, accueil de la documentation officielle | facultatif : sans enjeu pour la décision |
L'API et l'annuaire resteront sans image : aucune capture sourcée n'existe dans public/images/crisalid/, et en produire une demanderait un nouvel accès à l'instance. Leur schéma reconstitué suffit au lecteur non technique.
Priorité 2 : faire pointer le lecteur vers la page qui fait foi, et la rendre exacte
Scénarios et coûts renvoie ici comme inventaire. La ligne scenarios-de-besoin.mdx:74 dit « Aucune des 21 briques inventoriées n'est une vitrine publique » et pointe vers cette page d'audit. L'inventaire qui fait foi est la carte des briques, qui dit la même chose (carte-des-sous-projets.mdx:11) et parle de « 21 dépôts », pas de « 21 briques » : CERIF-Core y est une référence externe, pas une brique (carte-des-sous-projets.mdx:72). Correction : remplacer le lien par celui de la carte et écrire « Aucun des 21 dépôts ».
Le tableau de la carte range l'assemblage parmi les briques du produit. L'« En bref » dit « Cinq briques forment le produit » (carte-des-sous-projets.mdx:10), mais dans le tableau des 21 dépôts, la ligne de groupe « Cœur : le produit » (:47) couvre six lignes : les cinq briques (:48-52) et crisalid-deployment, « L'assemblage » (:53). Le groupe suivant, « Référentiels et intégration », ne commence qu'à :54. Un lecteur qui compte les lignes trouve six briques. Correction : sortir crisalid-deployment du groupe « Cœur : le produit », sous une ligne de groupe propre (« Assemblage »), pour que le tableau montre les cinq briques annoncées.
L'« En bref » de la carte dit que les référentiels ne tournent pas sur l'instance ; son détail dit le contraire. La ligne :11 range les référentiels avec l'outillage et les expériences d'IA, « qui ne tournent pas sur l'instance ». Le détail de la même page écrit pourtant qu'« un service de ce type tourne sur l'instance, sans rattachement établi à ce dépôt » pour le registre des organisations (:87), et que « des services de calcul sémantique y tournent » pour Taxi (:95). Ce que montre l'instance classe les référentiels et services d'embeddings en « Tournent ; rattachement exact à confirmer » (00-ce-que-linstance-demontre.mdx:69). Le lecteur qui s'arrête à l'« En bref » retient l'inverse du détail. Correction : écrire à :11 que l'outillage et les expériences d'IA ne tournent pas sur l'instance, et que des services du type des référentiels y tournent, sans rattachement établi à un dépôt (« À confirmer »).
Le glossaire décrit les briques en jargon, sous leurs noms de dépôt. La rubrique « Composants CRISalid » (docs/03-crisalid/00-reperes/glossaire.md:49-63) définit « IKG », « Apollo », « Directory Bridge », « SVP Harvester » avec des termes que les fiches évitent : « projection PostgreSQL enrichie d'états applicatifs » (:54), « Pipelines Airflow » (:56), « publiant ses résultats sur RabbitMQ » (:57), « exposée en lecture seule via PostgREST » (:59), « plongements vectoriels » (:61). Les noms usuels du site, « l'annuaire », « le moissonneur », « le graphe », « l'API », n'y figurent pas comme entrées : un lecteur qui cherche « le graphe » ou « l'API » doit savoir qu'ils se cachent sous « IKG » (:53) et « Apollo » (:55), et « le moissonneur » n'apparaît que dans le corps des définitions (:46, :57, :63). Correction : ouvrir chaque définition par le nom usuel et une phrase simple reprise de la carte (carte-des-sous-projets.mdx:48-53), puis garder le détail technique.
Priorité 3 : une légende à corriger, deux avertissements à garder
Le schéma officiel du moissonneur ne montre pas OpenAlex. L'image publiée dans la fiche (svp-harvester.mdx:37-44) montre des moissonnages HAL, IdRef, scanR et un dernier marqué « XYZ ». C'est la seule légende inexacte publiée aujourd'hui sur le site. Le schéma reconstitué juste au-dessus cite OpenAlex en premier (svp-harvester.mdx:27), et OpenAlex est la première source de l'instance avec 200 569 notices (svp-harvester.mdx:57). La légende ne dit pas que le schéma des auteurs est un principe, antérieur ou générique, et que « XYZ » tient lieu des autres sources. Correction : ajouter à la légende « Le schéma des auteurs ne cite pas OpenAlex ; « XYZ » désigne les autres sources. »
Les deux points suivants portent sur des images qui ne sont publiées que dans cette page, où leurs légendes sont déjà justes : ce sont des avertissements à reprendre si elles rejoignent une fiche (priorité 1).
La capture d'une publication du graphe ne montre pas forcément toutes ses sources. La requête visible dans la capture retient une publication liée à au moins trois moissonneurs distincts (count(DISTINCT s.harvester) AS h WHERE h >= 3), puis s'arrête à 30 chemins (LIMIT 30) ; l'écran affiche 28 liens vers des concepts et 2 vers des notices sources, soit 30 : la troisième source, au moins, est coupée par la limite. La légende ci-dessous le dit ; elle doit suivre l'image si celle-ci rejoint la fiche du graphe.
L'écran de gestion des droits de SoVisu+ est une cible, pas un constat. La maquette affiche « Groupes Keycloak = source unique » et des droits partagés par SoVisu+, un assistant conversationnel, Projects et une couche d'outils d'IA. Le site constate autre chose dans le code : SoVisu+ définit lui-même huit rôles, chacun avec une portée (securite-droits-donnees-personnelles.mdx:73, Confirmé sur un exemple de configuration), et le rôle attribué à Paris-Saclay reste « À confirmer » (même page, :22). Toute reprise de cet écran doit le présenter comme la cible du consortium.
Priorité 4 : points mineurs
- Description de la fiche de l'API. Le front matter dit encore « générée automatiquement à partir du modèle » (
crisalid-apollo.mdx:4), et le schéma « Schéma généré à partir du modèle » (:27), alors que le corps précise que cette description du modèle est écrite à la main (:17, :44). C'est exact, mais la description est ce qu'on lit dans les cartes de navigation et les résultats de recherche : y ajouter « écrite à la main » évite la contradiction apparente. - Signaler au consortium l'absence de vue d'ensemble officielle. Aucune page du site n'en garde la trace ; les schémas reconstitués de Comprendre CRISalid et de la carte pourraient lui être proposés. C'est une décision de l'auteur.
Les images à replacer
Les dix images ci-dessous ne sont publiées nulle part ailleurs sur le site. Leurs sources sont indiquées sous chacune ; les écrans de SoVisu+ viennent des maquettes ou de l'aperçu officiel, avec des données fictives, et la capture de l'instance ne montre aucune personne.
Limites de cette page
L'application SoVisu+ de l'instance n'a pas été consultée au-delà de sa page de connexion (sovisuplus.mdx:56) : les écrans montrés ici sont des maquettes ou un aperçu officiel. La capture du graphe vient d'une instance de développement, qui prouve un déploiement de test et non une production (Sources et preuves). L'exactitude des fiches a été vérifiée contre les pages de la section CRISalid qu'elles citent, pas de nouveau contre le code des dépôts.