Le modèle de connaissances en détail

Trois registres distincts

• Le graphe de concepts ne contient que de l'abstrait : un trouble, une profession, un type de structure, une aide. 788 concepts, dont 23 notions obsolètes conservées pour qu'un ancien terme mène à la notion actuelle.
• L'annuaire et le catalogue contiennent les instances concrètes : tel professionnel, telle association, tel guide. Une instance n'est jamais un concept : elle se rattache à des concepts. Les déclarations de l'annuaire (« ce professionnel déclare pratiquer telle approche ») forment une couche à part : 4 167 déclarations, non comptées dans les relations ci-dessous.
• Le registre des sources (317 émetteurs) et le corpus documentaire (1 333 documents) portent la preuve. Une source n'est pas un nœud du graphe : c'est la propriété d'une relation.

Les 22 types de concepts

Chaque type a son préfixe d'identifiant ; une hiérarchie (« est un sous-type de ») relie un concept à un concept plus général du même type.

Les 50 types de relations

2 726 relations relient aujourd'hui les concepts. Chaque type de relation a une signature : les types de concepts qu'il peut relier. Une relation hors signature est refusée à l'écriture comme au contrôle d'intégrité ; un lien qu'aucune signature n'admet devient une question d'ontologie, jamais une relation écrite « en attendant ». Le vocabulaire défini dans le code compte 59 types, dont ceux de l'annuaire et des attestations de documents.

Une relation, une liste d'attestations

Une relation est un triplet unique (concept, type de relation, concept). Elle porte la liste des documents qui l'attestent ; chaque élément donne la citation mot pour mot, le document, la page et le grade du document. Il n'y a ni source « principale » ni source « secondaire » : une redite est une attestation de plus, elle n'est jamais jetée, et un document ne compte qu'une fois par relation.

MDPH  —instruit ou verse→  AEEH
attestations : [
  { document : « Guide du parent aidant », CAF et MSA, 2024,
    page : 27, grade : B,
    citation : « Il existe une demande d'aide unique auprès de la MDPH.
                Elle sert aussi bien à l'AEEH que pour la PCH. » },
  { document : « Mon Parcours Handicap — Vidéo AEEH », CNSA, 2024, grade : AE, … },
  …
]

Fiabilité d'une relation = nombre de documents qui l'attestent + meilleur grade de la liste. Pas de score composite : les deux nombres sont lus tels quels.

En moyenne, une relation porte 1,5 attestation ; 655 relations en portent au moins deux, la plus attestée 18. Sur 4 092 attestations, 3 270 (79,9 %) renvoient à un document identifié du corpus ou du registre (428 documents distincts). 125 sont des renvois internes vers un parcours ou l'ontologie : la relation y est justifiée par la structure du modèle, pas par un document extérieur, et nous les comptons à part.

Des citations héritées, sans document rattaché

Restent 697 attestations (17 %) qui ne renvoient à aucun document identifié : elles ont été écrites avant que le rattachement à un document devienne obligatoire. Elles ne sont pas fausses pour autant, mais un lecteur ne peut pas encore remonter de la phrase au document. Nous les répartissons en quatre cas, chacun avec son traitement :

Le chantier est en cours, en commençant par les relations les plus affichées (AEEH, TDAH, autisme…) ; il est suivi dans notre registre des lacunes et ces chiffres sont remesurés à chaque étape. Une citation n'est rattachée à un document que si elle s'y trouve mot pour mot ; sinon, elle est relue ou retirée, jamais rattachée « au plus proche ».

D'abord le corpus, ensuite le graphe

Une source nouvelle n'est jamais inscrite directement dans le graphe. Elle entre d'abord dans le corpus documentaire (on parle de RAG, retrieval-augmented generation) : un document par page web ou par PDF, découpé en passages, chacun doté d'un vecteur sémantique et relié aux concepts qu'il nomme. Puis une étape de dérivation relit le document au regard de l'ontologie et propose des relations, chacune accompagnée de la phrase qui la fonde. Ce qui est retenu devient une attestation : nouvelle relation, ou attestation de plus sur une relation existante.

Un concept manquant se traite de la même façon : on ingère ou on relit la source qui le décrit, et le concept naît de la dérivation, avec ses citations. Toute création de concept est soumise à validation humaine.

1 333documents

de 89 émetteurs

18 105passages

100 % vectorisés

57,9 %des passages

reliés à au moins un concept

Un document peut être marqué périmé ou retiré (9 le sont aujourd'hui) : ses passages ne sont alors plus utilisés pour rédiger.

Un document est une référence, pas un nœud

Un guide de la Caf ou une recommandation de la HAS ne devient pas une « fiche » du graphe. Ce qu'il dit d'un concept est une attestation document → concept (« ce document documente ce concept »), avec les extraits qui le montrent : 1 624 attestations de ce type, portant sur 326 concepts. Les 657 références « à lire » proposées aux familles dans le parcours par besoin se rangent sous un concept par ces attestations, pas par un classement manuel.

Les garde-fous d'ingestion

Ces contrôles sont du code, appelé par chaque script d'ingestion ; un script qui ne les appelle pas est refusé au moment du commit.

• La source doit exister au registre avant toute ingestion ; les identifiants portent un préfixe de type, jamais un identifiant nu.
• Un PDF doit en être un (vérification de sa signature binaire) : une page anti-robot déguisée est rejetée.
• Un passage fait majoritairement de liens de téléchargement est écarté ; un document dont le contenu ne correspond pas au titre (domaine parqué, page d'erreur, hors sujet) est refusé.
• Après écriture, un contrôle d'intégrité bloquant : liste d'attestations bien formée, aucune relation sans source, aucun doublon, signature respectée.
• Chaque concept créé est relié aux passages de tout le corpus qui le nomment, en mot entier, avec une preuve renforcée pour les libellés trop courants.

S'y ajoutent deux règles de méthode, vérifiées en revue plutôt que par le code : un document par page ou par article, jamais une concaténation ; un site se parcourt en entier, à partir de son plan, et pas par sa seule page d'accueil.

Ce que nous savons ne pas savoir

Nous tenons un registre des lacunes du graphe : chaque trou repéré y est décrit, rattaché au contrôle automatique qui le détecte, et suivi jusqu'à sa résolution. Une lacune résolue qui réapparaît est signalée comme une régression. Le registre est tenu dans notre dépôt de code ; nous en publions ici le décompte.

Au 8 octobre 2026 : 47 entrées — 29 ouvertes, 9 en cours de traitement, 9 résolues.

Quelques exemples

• Métadonnée non citée : des tranches d'âge qui décident de l'affichage d'une fiche ne sont pas encore toutes appuyées par une citation.
• Concept absent : l'accueil temporaire, décrit par plusieurs sources, n'existe pas encore comme concept du graphe.
• Relation non modélisée : les orientations décidées par la CDAPH ne sont pas encore représentées.
• Processus manquant : aucun outil ne réintègre encore une page déjà ingérée dont le contenu a changé.
• Relation sans source : aucune source officielle accessible ne relie le trouble du développement intellectuel à l'Ulis TFC. Nous ne l'écrivons donc pas, même si elle paraît évidente.
• Attestations sans document : des citations héritées d'une version antérieure du graphe ne renvoient encore à aucun document identifié (détail plus haut, « Des citations héritées, sans document rattaché »).

Vous connaissez une source qui comblerait l'une de ces 38 lacunes ? Proposez-la.

Comment ces chiffres sont comptés

Les chiffres de cette section sont produits par un script de mesure en lecture seule sur la base de production, relancé à chaque mise à jour de ces pages. Dernière mesure : 8 octobre 2026.

Concepts

Lignes de la table des concepts (kg_entities) dont le type appartient à l'ontologie, c'est-à-dire est admis par au moins une signature de relation du code (kg-relation-signatures.mjs). Les notions obsolètes, conservées pour rediriger un ancien terme, sont incluses et comptées à part.

Types de concepts

Nombre de types distincts parmi ces concepts.

Relations entre concepts

Lignes de la table des relations sourcées (sourced_relations) dont les deux extrémités sont des concepts. Une relation = un triplet unique (concept source, type de relation, concept cible). Les déclarations de l'annuaire (un professionnel déclare une spécialité, une approche) sont comptées à part.

Types de relations

Types distincts utilisés par ces relations, rapportés au vocabulaire défini dans le code (signatures de relations, couche annuaire et verbes d'attestation compris).

Relations attestées

Relations dont la liste d'attestations (additional_citations) compte au moins un élément.

Attestations

Somme, sur ces relations, des éléments de la liste d'attestations. Un élément = une citation d'un document, avec sa page quand elle existe et le grade de ce document ; un document ne compte qu'une fois par relation.

Attestations rattachées à un document identifié

Attestations dont le document est un document du corpus (rag_documents) ou une source du registre (evidence_sources). Les autres sont soit des renvois internes, soit des citations héritées sans document (définitions ci-dessous).

Renvois internes vers un parcours ou l’ontologie

Attestations dont le « document » est un parcours de Serenaid (identifiant pw-…) ou la spécification de l'ontologie (ontology-…) : la relation est justifiée par la structure du modèle, pas par un document extérieur. Elles ne manquent pas de document et sont comptées à part.

Citations héritées sans document

Attestations ni rattachées à un document identifié, ni renvois internes : créées avant que le rattachement à un document soit obligatoire. Réparties en quatre cas, évalués dans cet ordre : D, aucune source sur la relation ; C, source connue mais aucun de ses documents n'est au corpus ; B, résumé rédigé au lieu d'une citation (texte contenant « URL : », « § », une année entre parenthèses ou un tiret cadratin), source présente au corpus ; A, vraie phrase, source présente au corpus.

Grade d’une relation

Meilleur grade de sa liste d’attestations, dans l’ordre A > AE > B > CP > C > RE.

Sources du registre

Lignes du registre des sources (evidence_sources), classées par famille d'autorité selon la liste fermée du code (authority-canonical.mjs).

Documents du corpus

Lignes de rag_documents : une page web ou un document PDF par ligne, jamais une concaténation.

Passages

Lignes de rag_document_chunks. « Vectorisé » = passage doté d'un vecteur sémantique ; « relié » = passage lié à au moins un concept (rag_chunk_entity_links vers kg_entities).

Références « à lire »

Lignes de la vue kg_references : guides, pages, vidéos… montrés aux familles. Ce ne sont pas des concepts.

Attestations document → concept

Lignes de concept_attestations : « ce document parle de ce concept », avec la liste des extraits qui le montrent.

Textes rédigés

Lignes de kg_articles_generated : un texte par concept et par public. « Repli » = la synthèse a échoué à la validation et le texte servi est composé des extraits des sources.

Lacunes connues

Entrées du registre des lacunes (data/kg-lacunes/registre-lacunes-kg.json), par statut : ouverte, en cours, résolue, acceptée.