Consolidation de la base partenaires¶
En résumé¶
LaBRRI dispose désormais d'une base partenaires plus fiable, grâce à six évolutions :
- Chaque partenaire peut porter plusieurs identifiants : numéros MoveOn ou Mobility OnLine, identifiants ROR, HAL, Wikidata… selon les sources connues.
- La recherche de partenaires est assistée : un moteur de recherche (OrgaSearch) interroge plusieurs annuaires en une seule saisie, sans quitter LaBRRI.
- Les doublons sont détectés et fusionnables : alerte d'homonyme à la saisie (ex. « Université de X » déjà présente) ou références externes communes (même MoveOn, ROR…) ; le système avertit l'utilisateur et propose de fusionner les fiches.
- Les demandes d'ajout sont mieux cadrées : l'utilisateur ne les dépose qu'après avoir épuisé la recherche dans LaBRRI et dans OrgaSearch ; l'administrateur dispose d'un assistant de traitement ; l'utilisateur est averti lorsque sa demande a été traitée.
- Les imports CSV ont changé de logique : on n'importe plus directement des fiches « organisation » : on alimente d'abord le carnet de références SI (identifiants MoveOn, MOL… et informations associées), puis LaBRRI ne crée une fiche établissement que si les contrôles le permettent (référence non liée, pas d'homonyme).
- Les décisions de consolidation peuvent être capitalisées : le service mutualisé Matchtrain enregistre, depuis chaque instance, les liaisons OrgaSearch et les fusions dans un corpus commun ; cela ne change pas le comportement de LaBRRI à court terme, mais prépare de meilleures propositions automatiques à terme (voir §8).
Objectif métier : une seule fiche partenaire fiable, reliée aux outils de mobilité et aux annuaires internationaux, utilisable partout (mobilités, conventions, projets…).
Important : les outils livrés en v1.2.0 (API) et v1.12.0 (admin) ne transforment pas la base du jour au lendemain. Un travail initial consiste à relier les organisations déjà présentes dans LaBRRI aux références proposées par OrgaSearch ; la consolidation des doublons se fait ensuite progressivement, au fil des éditions, imports et traitements de demandes.
Petite lexique¶
| Terme | En clair |
|---|---|
| Organisation / partenaire | Une fiche établissement dans LaBRRI (université, entreprise…) |
| Référence externe | Un identifiant officiel qui dit « cette fiche LaBRRI = ce partenaire-là dans tel système », avec, le cas échéant, plusieurs libellés traduits (fr, en, de…) issus des annuaires |
| MoveOn / Mobility OnLine | Logiciels de gestion des mobilités d'où viennent les exports CSV |
| ROR, HAL, Wikidata | Annuaires internationaux d'établissements (sources publiques) |
| OrgaSearch | Moteur de métarecherche qui interroge des sources (ROR, HAL, Wikidata, et désormais la base LaBRRI Tours si elle est configurée) en une fois ; ce n'est pas un annuaire en soi. Il sert l'interface LaBRRI, en parallèle de la recherche interne. Voir phase 3. |
| Consolidation / fusion | Regrouper deux fiches doublons en une seule, en réaffectant mobilités, conventions, etc. |
| Matchtrain | Service complémentaire mutualisé (une instance pour tout l'écosystème) qui enregistre les choix des administrateurs de chaque LaBRRI lorsqu'ils relient une fiche à des annuaires (OrgaSearch) ou fusionnent des doublons, afin d'apprendre à mieux proposer des correspondances à l'avenir, sans modifier le comportement de LaBRRI tant que les modèles ne sont pas validés |
| Administrateur LaBRRI | Profil habilité à gérer la base partenaires (consolidation, références externes, traitement des demandes d'ajout…) : c'est le référent fonctionnel de cette base dans l'application |
| Demande d'ajout | Demande déposée par un utilisateur qui, après avoir cherché l'établissement dans LaBRRI puis dans les annuaires proposés par OrgaSearch (ROR, HAL, Wikidata), n'a trouvé aucune correspondance et sollicite un administrateur pour le créer ou l'identifier |
Comprendre la logique : deux types d'identifiants¶
Imaginez la fiche partenaire LaBRRI comme une fiche d'identité. Elle peut porter plusieurs numéros de référence, selon d'où vient l'information :
| Type | D'où ça vient ? | Exemple | À quoi ça sert |
|---|---|---|---|
| Identifiant SI mobilité | Export MoveOn, Mobility OnLine… | moveon n° 12345 |
Retrouver le même partenaire lors des imports de mobilités et conventions |
| Identifiant annuaire public | Recherche OrgaSearch (ROR, HAL, Wikidata) | ror n° 02s376052 |
Aligner LaBRRI sur les annuaires internationaux |
OrgaSearch est un moteur de métarecherche : une saisie interroge en parallèle ROR, HAL et Wikidata et propose des correspondances. Ce qu'on retient dans LaBRRI, ce sont les identifiants des annuaires (ROR, HAL, Wikidata…) et les informations associées : libellés (y compris traductions), ville, pays, site web, coordonnées géographiques…
Une même fiche peut cumuler les deux : par exemple un partenaire importé depuis MoveOn, enrichi plus tard avec son identifiant ROR. Chaque référence annuaire peut aussi porter plusieurs libellés (allemand, anglais, français…), utiles à l'affichage, à l'enrichissement et à la recherche LaBRRI (libellés et identifiants des références externes).
Université de Tours (fiche LaBRRI)
├── mobility_online : 67890 ← vient de Mobility OnLine
└── ror : 02s376052 ← ajouté via la recherche OrgaSearch
flowchart TB
subgraph outils ["Vos outils métier"]
MO[MoveOn]
MOL[Mobility OnLine]
end
subgraph annuaires [Annuaires internationaux]
ROR[ROR]
HAL[HAL]
WD[Wikidata]
end
subgraph orgasearch [OrgaSearch - recherche unique]
OS[Moteur de recherche]
end
subgraph labri [LaBRRI]
Fiche[Fiche partenaire]
Refs["Identifiants de référence"]
end
MO -->|import CSV| Refs
MOL -->|import CSV| Refs
OS -->|propositions| Refs
ROR --> OS
HAL --> OS
WD --> OS
Refs --> Fiche
Import CSV : ce qui a changé concrètement¶
| Avant | Maintenant | |
|---|---|---|
| Ce qu'on importe | Des fiches « organisation » directement | Des identifiants partenaires et informations associées (MoveOn, MOL… : numéro, libellé, ville, pays…) alimentant le carnet de références |
| Création de fiche LaBRRI | Tentée à chaque ligne ; si le code_ref ( = idOrganisation) existait déjà → mise à jour du libellé, pas de doublon sur ce numéro |
Référence externe enregistrée d'abord ; fiche créée seulement si la référence n'est liée à aucune organisation et qu'aucun homonyme (libellé ou code_ref) n'existe déjà |
| Lien avec les mobilités | Par le nom ou le code_ref |
Par source + numéro (prioritaire) ou par le nom provenant de la référence externe |
Nuance importante : avant v1.2.0, un contrôle sur le code_ref existait déjà (ON CONFLICT → mise à jour). Ce qui change, c'est surtout l'objet de l'import (références SI d'abord) et les contrôles élargis (liaison référence ↔ organisation, homonyme de libellé), pas l'absence totale de dédoublonnage.
En une phrase : l'import « organisations » sert désormais à alimenter le carnet de références SI (identifiants et infos associées), pas à dupliquer des établissements.
Les 6 évolutions : vue métier¶
flowchart TB
subgraph evolutions ["6 évolutions"]
E1[Identifiants partenaires]
E2["Recherche assistée OrgaSearch"]
E3[Fusion des doublons]
E4["Assistant demandes d'ajout"]
E5["Imports CSV repensés"]
E6["Capitalisation Matchtrain"]
end
subgraph but [But]
BP[Base partenaires unique et fiable]
end
E1 --> BP
E2 --> BP
E3 --> BP
E4 --> BP
E5 --> BP
E6 --> BP
| Évolution | Avant | Maintenant | Gain |
|---|---|---|---|
| Identifiants partenaires | On ne savait pas « qui est qui » entre LaBRRI, MoveOn et les annuaires | Chaque fiche peut porter ses numéros MoveOn, MOL, ROR… | Traçabilité et imports fiables |
| Libellés multilingues | Un seul nom par fiche, souvent en français | Chaque référence externe mémorise les traductions (fr, en, de…) remontées des annuaires | Enrichissement immédiat ; base pour optimiser la recherche à terme |
| Recherche OrgaSearch | Pas de liaison avec les annuaires publics (ROR, HAL, Wikidata) | Propositions automatiques à partir du libellé (ROR, HAL, Wikidata) | Moins de saisie, données enrichies |
| Fusion des doublons | Plusieurs fiches pour le même établissement | Détection à la saisie + assistant de fusion ; export d'une liste partenaires consolidée | Statistiques propres ; retour utile vers les SI sources (MoveOn, MOL…) |
| Demandes d'ajout | L'utilisateur créait une demande sans avoir épuisé les recherches ; l'admin traitait sans guide ; pas de retour | Recherche LaBRRI + OrgaSearch d'abord ; demande seulement si échec ; assistant admin + badge de notification | Moins de demandes inutiles, moins de doublons |
| Imports CSV | Import direct en organisation ; dédoublonnage limité au code_ref |
Import des identifiants SI d'abord ; contrôles élargis (référence liée, homonyme) | Cohérence MoveOn / MOL / LaBRRI |
| Matchtrain | Décisions de liaison OrgaSearch et fusions non capitalisées | Événements envoyés vers un corpus mutualisé (sans impact immédiat sur LaBRRI) | Apprentissage futur des propositions de rapprochement |
1. Ce qui change côté « moteur » (API / serveur)¶
Cette section décrit le comportement du système, visible dans l'interface mais exécuté en arrière-plan.
1.1 Carnet d'identifiants partenaires¶
En pratique : LaBRRI mémorise désormais, pour chaque établissement, l'ensemble de ses identifiants : pour chacun, d'où il vient (MoveOn, Mobility OnLine, ROR, HAL, Wikidata…) et quel est le numéro correspondant. Une même fiche peut en cumuler plusieurs.
Pourquoi c'est important : quand on importe une mobilité avec « partenaire n° 12345, source MoveOn », le système retrouve la bonne fiche, même si le libellé a une légère variante.
Ce que le système vérifie aussi : si l'un de ces identifiants est déjà rattaché à une autre fiche, il signale le conflit (évitant deux fiches pour le même partenaire externe).
Libellés traduits : en plus du numéro d'identification, chaque référence externe peut porter plusieurs noms selon la langue (ReferenceExterneLibelle : locale + libellé). Ils sont remontés depuis OrgaSearch / ROR / HAL / Wikidata lors de la liaison, ou via import CSV (libelleFr, libelleEn…). La recherche interne LaBRRI ne s'appuie pas encore sur ces traductions, mais leur mémorisation prépare l'optimisation future du moteur de recherche : par exemple retrouver « Technical University of Munich » quand on saisit « Technische Universität München ».
1.2 Fusion de doublons (consolidation)¶
En pratique : l'administrateur choisit la fiche à garder et celle(s) à fusionner. Le système :
- Garde les meilleures informations (nom, site web, ville…)
- Déplace toutes les mobilités, conventions, projets, etc. vers la fiche conservée
- Marque l'ancienne fiche « consolidée vers … » ; elle disparaît des recherches mais reste traçable
Intérêt pour les SI sources (MoveOn, Mobility OnLine…) : une fois les doublons fusionnés, LaBRRI ne retient plus qu'une fiche active par établissement, avec l'ensemble de ses identifiants (moveon, mobility_online, ROR…). Cette base consolidée peut être exportée en CSV (outil d'export admin, ressource « organisations ») pour alimenter ou réconcilier les référentiels partenaires des logiciels sources, sans renvoyer plusieurs lignes pour le même établissement.
Analogie : fusionner deux dossiers papier en un seul, en déplaçant toutes les pièces jointes, puis fournir une liste de référence unique aux autres services.
sequenceDiagram
participant Admin
participant LaBRRI
Admin->>LaBRRI: Je garde la fiche A, je fusionne B et C
LaBRRI->>LaBRRI: Déplace mobilités, conventions, projets…
LaBRRI->>LaBRRI: Marque B et C comme fusionnées
LaBRRI-->>Admin: Fiche A à jour et complète
Avant : trois fiches « Université de X », statistiques faussées, imports incohérents.
1.3 Notification des demandes traitées¶
En pratique : lorsqu'un utilisateur a déposé une demande d'ajout (après avoir cherché sans succès dans LaBRRI et dans OrgaSearch), il est averti par un badge sur son menu dès qu'un administrateur y répond (« déjà présent », « ajouté », « refusé »). En consultant sa liste de demandes, il voit le statut et le commentaire de l'administrateur (incluant le libellé de l'établissement retenu lorsque la demande est acceptée).
Avant : il fallait revenir régulièrement vérifier manuellement.
1.4 Imports CSV : nouvelle logique¶
En pratique :
- Vous importez un fichier exporté de MoveOn ou Mobility OnLine
- LaBRRI enregistre d'abord les numéros partenaires (
source+idOrganisation) dans le carnet de références externes - Une fiche établissement n'est créée que si :
- la référence n'est pas déjà liée à une organisation existante, et
- aucune organisation avec le même libellé ou le même
code_refn'existe déjà - Les imports de mobilités et conventions retrouvent le partenaire par source + numéro, ou à défaut par le nom provenant de la référence externe
Ce qui existait déjà (v1.0.0) : à chaque import, une insertion directe en organisation avec code_ref = idOrganisation. Si ce code_ref existait déjà, le libellé était mis à jour (ON CONFLICT), sans créer de second doublon sur le même numéro.
Ce qui change (v1.2.0) : l'import alimente d'abord les références externes SI ; la création d'organisation est un effet secondaire conditionnel, avec des contrôles supplémentaires (liaison référence ↔ organisation, homonyme de libellé). Le champ source (MoveOn, MOL…) devient obligatoire pour tracer l'origine de chaque identifiant.
Exemple fichier MoveOn :
idOrganisation,libelle,source,ville,codePays
12345,Université de Heidelberg,moveon,Heidelberg,DE
Étapes automatiques : enregistrement de moveon:12345 → création de la fiche seulement si besoin → les mobilités avec partenaire=12345 et source=moveon pointent vers la même fiche.
Avant : pas de couche « référence externe » ; dédoublonnage limité au code_ref ; les homonymes (même nom, numéros différents) restaient possibles ; les mobilités étaient rattachées surtout par le nom ou le code_ref.
2. Ce qui change côté interface (écran admin)¶
2.1 Saisie assistée des partenaires¶
En pratique : en créant ou modifiant un établissement, dès que vous tapez le nom :
- LaBRRI propose des correspondances dans ROR, HAL, Wikidata (via OrgaSearch)
- Vous cochez la ou les bonnes références → pays, ville, site web et libellés dans plusieurs langues (fr, en, de…) sont proposés par la référence externe : vous choisissez ceux à reprendre pour alimenter la fiche ; l'identifiant est enregistré avec la référence
- Les identifiants déjà connus (MoveOn, etc.) s'affichent aussi
Alertes utiles :
- Nom identique à une fiche existante → il faut choisir la fiche existante ou fusionner
- Identifiant déjà utilisé par une autre fiche → consolidation proposée
Avant : tout à la main, sans lien avec les annuaires internationaux.
2.2 Demandes d'ajout : côté utilisateur et côté administrateur¶
Quand déposer une demande ?
Dès qu'il saisit un libellé, deux recherches se lancent automatiquement et leurs résultats s'affichent côte à côte :
- Les établissements déjà enregistrés dans la base LaBRRI
- Les correspondances proposées par OrgaSearch (ROR, HAL, Wikidata)
L'utilisateur puise dans ces deux listes : il sélectionne une organisation existante ou une référence OrgaSearch si l'une convient. Dans ce second cas, un processus automatique rattache la référence à une organisation (existante ou nouvelle) ; c'est l'organisation qui est ensuite reliée à la ressource parente (mobilité, projet, événement…), et non la référence directement. Ce n'est que si aucun résultat ne lui convient qu'il peut soumettre une demande d'ajout, en décrivant l'établissement recherché (souvent depuis une fiche en cours de saisie : mobilité, projet, événement…).
flowchart TD
Start["Utilisateur cherche un établissement"]
Start --> Parallel["Recherches automatiques LaBRRI + OrgaSearch"]
Parallel --> Choice{Un résultat convient ?}
Choice -->|Fiche LaBRRI| UseExisting["Sélectionne une organisation existante"]
Choice -->|Référence OrgaSearch| SelectRef["Sélectionne une référence externe"]
Choice -->|Non| DemandeAjout["Dépose une demande d'ajout"]
SelectRef --> Auto["Processus automatique"]
Auto --> Orga["Référence liée à une organisation existante ou nouvelle"]
Orga --> LinkParent["La ressource parente pointe vers l'organisation"]
UseExisting --> LinkParent
DemandeAjout --> AdminTraite["Administrateur traite via l'assistant"]
AdminTraite --> Notif["L'utilisateur est averti par un badge"]
LinkParent --> Fin[Terminé]
Notif --> Fin
Côté administrateur : assistant « Traiter la demande »
Quand une demande arrive, l'admin ne manipule plus trois interrupteurs sans contexte. Il clique « Traiter la demande » et suit un guide :
| Étape | Question posée | Résultat typique |
|---|---|---|
| 1. Recherche | « Un établissement proche existe-t-il déjà dans LaBRRI ? » | Réutiliser la fiche existante |
| 2. Création | « Faut-il en créer un ? » | Nouvelle fiche + identifiants OrgaSearch si trouvés |
| 3. Lien | « Rattacher à la mobilité / convention source ? » | Le champ partenaire se remplit automatiquement |
Avant : demandes déposées trop tôt ; traitement admin peu guidé ; risque de doublon ou d'oubli de liaison.
2.3 Badge « demandes non lues »¶
En pratique : chiffre orange sur le menu utilisateur = « X demandes ont été traitées depuis votre dernière visite ».
2.4 Outil d'import CSV (écran)¶
En pratique : le champ source est obligatoire pour les organisations : il indique d'où vient le fichier (moveon, mobility_online…).
3. Vue d'ensemble : comment tout s'articule¶
flowchart TB
subgraph entrees ["D'où viennent les données"]
CSV[Exports MoveOn MOL]
Saisie[Saisie manuelle]
Demande[Demandes utilisateurs]
end
subgraph ecran [Interface admin]
Recherche["Recherche assistée"]
Fusion[Assistant fusion]
Import[Import CSV]
Notif[Badge notifications]
end
subgraph coeur [Base LaBRRI]
Identifiants[Carnet identifiants]
Fiches[Fiches partenaires]
end
CSV --> Import --> Identifiants
Saisie --> Recherche --> Identifiants
Demande --> Fusion
Identifiants --> Fiches
Fusion --> Fiches
Notif --> Demande
4. Problèmes résolus : avant / après¶
| Situation vécue | Avant | Maintenant |
|---|---|---|
| « J'importe MoveOn, j'ai des doublons » | Dédoublonnage limité au code_ref ; homonymes possibles (même libellé, numéros différents) |
Import des numéros MoveOn en références ; contrôles élargis avant création de fiche |
| « La mobilité ne trouve pas le bon partenaire » | Recherche par le nom ou le code_ref |
Recherche par source + numéro (ex. moveon:12345) ou par le nom provenant de la référence externe |
| « Université de X existe 3 fois » | Aucun outil de fusion | Alerte à la saisie + assistant de fusion |
| « Je ne trouve pas mon établissement » | Pas de parcours clair ; demande même si l'établissement existe déjà ailleurs | Recherche LaBRRI puis OrgaSearch ; demande d'ajout seulement en dernier recours |
| « Je ne sais pas si ma demande est traitée » | Il fallait revenir vérifier | Badge sur le menu utilisateur |
| « Je ne connais pas l'identifiant ROR » | Aucun moyen de rattacher la fiche aux annuaires publics (ROR, HAL, Wikidata) | OrgaSearch propose des correspondances à partir du libellé |
| « Deux fiches partagent le même numéro MoveOn » | Conflit silencieux | Alerte + proposition de fusion |
5. Feuille de route : enrichir l'existant, consolider progressivement¶
Les évolutions v1.2.0 équipent LaBRRI ; elles ne nettoyent pas automatiquement des années de saisie. La consolidation de la base partenaires se déroule en deux temps.
Phase 1 : Travail initial (relier l'existant aux annuaires)¶
Les fiches partenaires déjà en base portent en général déjà leurs identifiants SI (MoveOn, MOL) ; il manque souvent les références externes (ROR, HAL, Wikidata).
Travail à prévoir (par les administrateurs) :
- Ouvrir les fiches partenaires existantes (priorité : les plus utilisées, mobilités, conventions, imports fréquents)
- Saisir ou rechercher le libellé → OrgaSearch propose des correspondances dans ROR, HAL, Wikidata
- Cocher et enregistrer la ou les références pertinentes → la fiche est « raccrochée » aux annuaires internationaux
flowchart LR
subgraph existant [Base actuelle]
Organisations["Organisations déjà en base"]
end
subgraph travail [Travail initial manuel]
Edit["Édition fiche par fiche"]
OS[Propositions OrgaSearch]
Lier["Lier références ROR HAL Wikidata"]
end
subgraph resultat [Base enrichie]
OrganisationsLiees["Fiches avec références annuaires"]
end
Organisations --> Edit
Edit --> OS
OS --> Lier
Lier --> OrganisationsLiees
Phase 2 : Consolidation au fil de l'eau¶
Une fois les références en place (ou dès qu'un doublon est détecté), la fusion ne se fait pas en une seule opération de masse :
- Alertes à la saisie : homonyme exact ou similaire, ou références externes communes → choix ou fusion
- Conflits de références : même identifiant ROR ou MoveOn sur deux fiches → assistant de consolidation
- Imports CSV : les nouveaux identifiants SI se rattachent aux fiches existantes plutôt qu'ils ne multiplient les doublons
- Demandes d'ajout : l'assistant admin vérifie avant de créer une nouvelle fiche
- Matchtrain (service mutualisé, si configuré) : les liaisons OrgaSearch et les fusions alimentent un corpus d'apprentissage commun pour améliorer les propositions à terme (voir §8)
En résumé : d'abord enrichir et relier le patrimoine existant ; ensuite fusionner et stabiliser progressivement, au rythme de l'activité métier.
Phase 3 : LaBRRI comme source OrgaSearch¶
L’API LaBRRI expose désormais un contrat partenaires (GET /api/partners/search et GET /api/partners/{id}, clé X-Api-Key). OrgaSearch 0.3.0 peut interroger l’instance de l'Université de Tours via l’adaptateur labri (source labrri-tours, variables LABRI_TOURS_API_URL / LABRI_TOURS_API_KEY fournies par l’administrateur Tours). Sans ces variables, la source reste inactive. Les autres instances de LaBRRI ne sont pas encore activables dans cette version.
La recherche interne de l’admin et OrgaSearch restent distinctes : l’écran fusionne les deux. Activer la source Tours côté OrgaSearch sert surtout à partager ce référentiel avec d’autres consommateurs d’OrgaSearch (autres instances, outils métier), pas à remplacer la recherche interne.
Mutualisation plus large (plusieurs bases LaBRRI en sources parallèles) reste une évolution : l’adaptateur le permet, mais seule labrri-tours est déclarée et activable en 0.3.0.
Intérêt : réutiliser le travail d’enrichissement et de consolidation ; éviter de recréer des partenaires déjà traités ; combiner annuaires publics et référentiel local (identifiants moveon, mobility_online, ror…, libellés, ville, pays, type). L’export vers MoveOn / MOL reste une possibilité pour réconcilier les référentiels sources.
flowchart LR
subgraph sources [Sources OrgaSearch]
ROR[ROR HAL Wikidata]
LabrriSrc["LaBRRI Tours"]
end
OS[OrgaSearch]
AdminLaBRRI["Interface admin LaBRRI"]
Autres["Autres applications"]
OS --> ROR
OS --> LabrriSrc
AdminLaBRRI --> OS
Autres --> OS
6. Bénéfices et pilotage¶
Ce qu'on peut suivre¶
- Couverture des références : part des fiches liées à MoveOn, MOL, ROR… (objectif : progression sur la phase 1)
- Libellés multilingues : volume de traductions mémorisées par référence (préparation recherche multilingue)
- Moins de doublons : alertes à la saisie + fusions tracées (objectif : progression sur la phase 2)
- Imports plus sûrs : réimport sans multiplication des fiches
- Demandes traitées plus visibles : badge et date de traitement
Qui gagne quoi ?¶
| Acteur | Ce que ça change au quotidien |
|---|---|
| Direction / pilotage | Base partenaires plus cohérente → statistiques et rapports plus fiables |
| Correspondants RI | Demandes d'ajout mieux cadrées ; parcours guidé ; notification lorsque la demande est traitée |
| Référents RI | Imports MoveOn / MOL alignés ; moins de corrections manuelles |
| Administrateur LaBRRI | Outils de fusion et de recherche ; traitement guidé des demandes |
| Utilisateur terrain | Effectue d'abord ses recherches dans LaBRRI et OrgaSearch ; ne dépose une demande qu'en dernier recours ; est averti lorsque sa demande est traitée |
| Équipe SI | Même logique source + numéro ou nom de la référence externe (organisations, mobilités, conventions) ; export CSV des organisations consolidées pour réconcilier MoveOn / MOL |
Points d'attention¶
- Travail initial : relier les organisations existantes aux références OrgaSearch est un effort manuel, fiche par fiche, à planifier (priorisation par usage)
- Consolidation progressive : les fusions interviennent au fil de l'activité, pas en une seule passe
- OrgaSearch doit être configuré côté admin pour proposer des correspondances ROR, HAL, Wikidata depuis l'écran d'édition. Sans cette configuration, la recherche annuaire est indisponible dans l'interface : seules les liaisons déjà enregistrées restent visibles et modifiables. Il n'existe pas, en v1.12.0, de formulaire de saisie manuelle d'un identifiant ROR/HAL/Wikidata dans l'écran organisation.
- Fusion de doublons : réservée aux administrateurs
- Les fiches fusionnées restent en historique (marquées « consolidée vers … ») mais n'apparaissent plus dans les recherches
7. Exemples concrets : histoires métier¶
Histoire 1 : Thomas ne trouve pas son établissement, puis Marie traite la demande¶
Thomas (utilisateur) saisit une mobilité et cherche « Hochschule München » :
- Rien dans la base LaBRRI
- Rien de satisfaisant dans les propositions OrgaSearch (ROR, HAL, Wikidata)
- Il dépose une demande d'ajout avec les informations dont il dispose
Marie (administratrice) reçoit la demande :
- Elle clique Traiter la demande
- L'assistant retrouve une fiche proche qu'Thomas n'avait pas vue → elle choisit Utiliser cette organisation
- Elle coche Renseigner automatiquement le champ Établissement
- Résultat : pas de doublon créé, la mobilité est à jour, Thomas voit un badge « 1 » sur son menu ; dans sa liste de demandes, le statut « déjà présent » et le commentaire avec le libellé retenu
Histoire 2 : Pierre importe les partenaires MoveOn¶
Pierre exporte la liste partenaires depuis MoveOn et l'importe dans LaBRRI.
- Chaque ligne contient
source=moveonetidOrganisation=12345 - LaBRRI enregistre les numéros MoveOn : met à jour les références existantes, ne crée une fiche que si les contrôles le permettent
- L'import des mobilités de la semaine suivante retrouve automatiquement les bons partenaires
Histoire 3 : Sophie enrichit le patrimoine existant (phase 1)¶
Dans le cadre du travail initial, Sophie reprend les fiches partenaires les plus sollicitées. Pour chacune, elle tape le libellé :
- OrgaSearch propose plusieurs correspondances (ROR, HAL, Wikidata)
- Elle coche l'identifiant pertinent → pays, ville, site web et libellés multilingues sont proposés ; elle choisit ceux à reprendre pour la fiche
- La fiche cumule ses numéros MoveOn, MOL, ROR…, soit plusieurs identifiants sur une même fiche
Progressivement, la base existante se raccroche aux annuaires.
Histoire 4 : Fusion progressive d'un doublon (phase 2)¶
Deux fiches « Université de X » coexistent. L'administrateur :
- Voit l'alerte « nom identique » lors d'une édition
- Lance Consolider → garde la fiche A, fusionne la fiche B
- Revue : 12 mobilités et 3 conventions seront déplacées
- Après validation : une seule fiche active, l'ancienne est marquée « consolidée vers A »
8. Matchtrain : apprendre des décisions de consolidation¶
Cette section explique comment les actions des administrateurs dans LaBRRI alimentent Matchtrain, un service d'apprentissage complémentaire.
8.1 À quoi sert Matchtrain ?¶
Quand un administrateur coche des références OrgaSearch (ROR, HAL, Wikidata…) ou fusionne des doublons, il prend une décision métier : « cette fiche LaBRRI correspond à tel(s) identifiant(s) annuaire » ou « ces deux fiches, c'est le même établissement ».
Matchtrain collecte ces décisions sous forme d'événements de consolidation, puis s'en sert pour :
- Mesurer si un modèle automatique aurait fait les mêmes choix qu'un humain (évaluation parallèle : la machine prédit en coulisse, mais ne remplace pas l'administrateur).
- Entraîner progressivement deux familles de modèles à partir des décisions réelles :
- un modèle de classement (ranker) qui ordonne les candidats (les plus pertinents en tête) ;
- un modèle de langage (LLM) entraîné à prédire quels identifiants un humain aurait cochés.
- Préparer, à terme et après validation formelle, de meilleures propositions dans les écrans de consolidation.
Point important : l'envoi des événements ne change pas le comportement de LaBRRI au moment où l'administrateur enregistre. C'est un retour d'expérience capturé en arrière-plan ; l'exploitation des modèles suit un cycle distinct (export, entraînement, seuils de promotion).
8.2 Quand LaBRRI envoie un événement ?¶
LaBRRI transmet un événement à Matchtrain dans deux situations (si le service est configuré dans l'environnement) :
| Situation | Déclencheur côté admin | En bref |
|---|---|---|
| Liaison OrgaSearch | Enregistrement réussi d'une fiche partenaire (création, édition, ou création via l'assistant d'ajout) après utilisation de la recherche OrgaSearch | « Voici la fiche, les propositions vues, et ce que j'ai coché (ou pas). » |
| Fusion de doublons | Validation de l'assistant Consolider (fusion LaBRRI) | « Voici la fiche conservée, les fiches absorbées, les références retenues. » |
Cas où aucun événement n'est envoyé (comportement normal) :
- Matchtrain n'est pas configuré pour cette instance (
REACT_APP_MATCHTRAIN_URLvide). - Enregistrement d'une fiche déjà absorbée par une fusion (
consolidée vers…). - Juste après une fusion, un nouvel enregistrement de la fiche conservée dans la même session (évite un doublon d'événement OrgaSearch).
L'envoi est asynchrone et non bloquant : un échec réseau n'empêche pas la sauvegarde ni la fusion.
8.3 Que contient un événement ?¶
Chaque événement décrit une décision humaine dans un format standardisé. On peut le lire comme une fiche de compte-rendu :
| Bloc | Contenu métier |
|---|---|
| Fiche concernée | Nom, ville, pays, type de l'établissement sur lequel portait la décision |
| Propositions vues | Liste des candidats affichés (identifiants ROR, HAL, Wikidata, MoveOn… avec leurs libellés) |
| Décision | Ce que l'utilisateur a tranché (voir tableau ci-dessous) |
| Contexte | Instance LaBRRI, date, identifiant technique pour éviter les doublons |
Les trois types de décision (vocabulaire Matchtrain) :
| Décision | Signification pour l'administrateur | Utilisation par Matchtrain |
|---|---|---|
Lien (link) |
Au moins une proposition a été cochée / retenue | Oui, exemple positif pour l'apprentissage |
Rejet (reject) |
Des propositions étaient visibles, mais aucune n'a été cochée | Oui, exemple négatif (« aucune de ces propositions ne convient ») |
Abstention (abstain) |
Pas de choix tranché (ex. fusion sans référence externe dans le cluster) | Stockage seulement, exclu de l'entraînement des modèles |
Les candidats non cochés dans une liste affichée comptent implicitement comme des refus pour l'apprentissage, même sans case « refuser » explicite.
Le détail des champs JSON (source_record, candidates, decision, etc.) est décrit en §9.
8.4 Les deux flux côté LaBRRI¶
flowchart TB
subgraph flux1 [Liaison OrgaSearch]
Save["Enregistrement fiche partenaire"]
OS["Propositions OrgaSearch à l'écran"]
E1["1 événement"]
Save --> OS --> E1
end
subgraph flux2 [Fusion LaBRRI]
Wiz["Assistant Consolider"]
E2["1 événement « conservée »"]
E3["0 à N événements « absorbée »"]
Wiz --> E2
Wiz --> E3
end
E1 --> MT[Matchtrain]
E2 --> MT
E3 --> MT
Flux 1 : enregistrement avec OrgaSearch¶
Exemple : Sophie édite « Université de Tours », OrgaSearch propose trois entrées ROR, elle en coche une et enregistre.
- 1 événement : fiche = Tours ; candidats = les trois propositions vues ; décision = lien vers la référence cochée.
Si elle avait lancé la recherche mais rien coché : décision = rejet.
Flux 2 : fusion de doublons¶
Exemple : l'administrateur conserve la fiche A, absorbe B et C, et garde cochées des références externes sur la fiche fusionnée.
- 1 événement « conservée » : décrit la fiche A telle que validée dans le wizard (nom, ville, type…) et toutes les références du cluster ; décision = lien si des références sont cochées.
- 1 événement par fiche absorbée (B, C) : décrit chaque fiche absorbée ; mêmes références retenues ; décision = lien.
Si aucune référence n'est cochée à l'étape « ressources » :
- 1 seul événement sur la fiche conservée, décision = rejet (références visibles mais refusées) ou abstention (aucune référence dans le cluster) ;
- aucun événement sur les fiches absorbées.
L'organisation conservée n'est pas forcément celle depuis laquelle le wizard a été ouvert : l'administrateur peut choisir de garder un doublon plutôt que la fiche en cours d'édition.
8.5 Comment Matchtrain exploite ces événements ?¶
Une fois les événements reçus, Matchtrain enchaîne un cycle distinct de l'interface LaBRRI :
flowchart LR
Collect["Collecte événements"]
Store["Stockage"]
Eval["Évaluation parallèle"]
Train["Entraînement modèles"]
Gates["Seuils de promotion"]
Future["Propositions améliorées à terme"]
Collect --> Store --> Eval --> Train --> Gates --> Future
| Étape | En clair |
|---|---|
| Collecte | LaBRRI (et d'autres instances ou outils) envoient les événements via une API dédiée |
| Stockage | Base d'événements horodatés, filtrables par instance, type de décision, période |
| Évaluation parallèle | Les modèles prédisent la décision humaine sans influer sur OrgaSearch ni sur l'écran admin ; on compare ensuite prédictions et choix réels |
| Entraînement | À partir d'un volume suffisant d'événements link et reject, affinage du modèle de classement (ordre des candidats) et du modèle de langage (liste des identifiants à retenir) |
| Promotion | Les modèles ne remplacent les propositions actuelles qu'après validation de seuils de qualité définis côté Matchtrain |
Volume minimal : avec très peu d'événements, Matchtrain stocke déjà les décisions mais reporte l'entraînement (comportement normal en début de déploiement).
8.6 Intérêt métier et gouvernance¶
| Bénéfice | Description |
|---|---|
| Capitalisation | Les heures passées à relier ROR/HAL/Wikidata et à fusionner des doublons deviennent un patrimoine d'exemples pour l'instance et, si mutualisé, pour l'écosystème |
| Cohérence multi-instances | Chaque instance LaBRRI peut être identifiée dans les métadonnées ; les exports permettent d'agréger ou de comparer |
| Sécurité fonctionnelle | Évaluation parallèle d'abord : on mesure avant de changer ce que voient les utilisateurs |
| Traçabilité | Chaque événement porte une date et l'identifiant de l'instance source |
Prérequis exploitation : Matchtrain est un service mutualisé (déployé une fois, partagé par toutes les instances LaBRRI). Chaque instance configure l'URL centrale (REACT_APP_MATCHTRAIN_URL) et son identifiant (REACT_APP_INSTANCE_NAME) dans l'admin ; les administrateurs poursuivent ensuite le travail de consolidation (phases 1 et 2). Les premiers mois servent surtout à constituer le corpus ; l'amélioration automatique des propositions vient ensuite.
Lien avec la feuille de route : Matchtrain ne remplace pas le travail initial (phase 1) ni les fusions manuelles (phase 2) ; il valorise ces actions pour réduire, à terme, la charge répétitive de rapprochement.
9. Annexe technique : OrgaSearch et Matchtrain¶
Pour les équipes de développement et d'exploitation. Cette annexe couvre deux services externes à LaBRRI : OrgaSearch (métarecherche partenaires : annuaires publics et, si configuré, bases LaBRRI) et Matchtrain (collecte des décisions de consolidation pour l'apprentissage automatique).
Déploiement commun¶
LaBRRI tourne en Docker : API Symfony, interface admin, bases de données, etc. sont des conteneurs orchestrés (docker compose), exposés via un reverse proxy (Traefik dans la stack d'orchestration). OrgaSearch est un service conteneurisé par instance (ou par environnement). Matchtrain est un service mutualisé : une seule instance pour tout l'écosystème, alimentée par toutes les LaBRRI via la même URL. Ces services ne remplacent ni n'embarquent la stack LaBRRI.
flowchart LR
Nav["Navigateur admin"]
Proxy["Reverse proxy (ex. Traefik)"]
Labri["Stack LaBRRI"]
OS["OrgaSearch"]
MT["Matchtrain"]
Nav --> Proxy
Proxy --> Labri
Proxy -->|"/orgasearch"| OS
Proxy -->|"/matchtrain"| MT
| Contexte | LaBRRI | OrgaSearch | Matchtrain |
|---|---|---|---|
| Recette / production | Stack Docker + proxy (Traefik) par instance | Conteneur Docker par instance, route /orgasearch |
Service unique mutualisé, route /matchtrain ; toutes les instances y envoient leurs événements |
| Développement | docker compose local |
Conteneur Docker ou uvicorn |
Instance mutualisée de recette ou uvicorn local ; URL centrale adaptée à l'environnement |
Configuration admin LaBRRI :
| Variable | Service | Effet si absente |
|---|---|---|
| URL OrgaSearch | OrgaSearch | Recherche annuaire indisponible dans l'interface (liaisons existantes modifiables) |
REACT_APP_MATCHTRAIN_URL |
Matchtrain | Aucun événement envoyé ; le reste de LaBRRI fonctionne normalement |
REACT_APP_INSTANCE_NAME |
Matchtrain | Identifiant de l'instance dans metadata.decided_by |
OrgaSearch¶
Rôle et périmètre¶
OrgaSearch est une API de métarecherche (Python / FastAPI) qui interroge en parallèle plusieurs sources (aujourd'hui ROR, HAL, Wikidata, OpenAlex si une clé est fournie, et l’instance LaBRRI Tours si LABRI_TOURS_API_URL et LABRI_TOURS_API_KEY sont renseignées) et renvoie des résultats normalisés. Ce n'est pas un référentiel : LaBRRI conserve sa propre base partenaires. L’admin appelle OrgaSearch pour les annuaires ; l’adaptateur labri permet en outre à OrgaSearch de consommer l’API partenaires LaBRRI. En 0.3.0, seule la source labrri-tours est activable.
Architecture¶
- Phase 1 : recherche textuelle parallèle sur les sources actives
- Phase 2 (
expand=true) : enrichissement par identifiants croisés
flowchart LR
Admin["Admin LaBRRI"]
OS[OrgaSearch]
ROR[ROR]
HAL[HAL]
WD[Wikidata]
API["API LaBRRI /api/partners"]
Admin -->|"GET /v1/partners/search"| OS
OS --> ROR
OS --> HAL
OS --> WD
OS -->|"X-Api-Key"| API
Endpoints utiles¶
| Méthode | Chemin | Description |
|---|---|---|
| GET | /health |
État et version du service |
| GET | /v1/sources |
Sources enregistrées (une source LaBRRI n’apparaît active que si URL et clé sont renseignées) |
| GET | /v1/partners/search |
Métarecherche (q, langs, sources, expand…) |
| GET | /v1/partners/{source}/{id} |
Fiche par identifiant natif (ex. ROR, HAL, Wikidata, labrri-tours) |
| GET | /api/doc |
Documentation Swagger |
Intégration LaBRRI¶
- L'admin appelle OrgaSearch via l'URL publique du service proxifié (ex.
https://labrri.example.fr/orgasearch). - L'interface fusionne côté écran les résultats de la recherche interne LaBRRI et ceux d'OrgaSearch.
- API partenaires (Symfony) :
GET /api/partners/search?q=…(limitmax 30,countryoptionnel) etGET /api/partners/{id}. AuthentificationX-Api-Key(PARTNERS_API_KEYdansdocker/api/.env). Clé vide = 401. - Source OrgaSearch 0.3.0 : seule
labrri-toursest activable. Elle pointe versLABRI_TOURS_API_URL(doit inclure/api) etLABRI_TOURS_API_KEY, fournies par l’administrateur Tours.
Matchtrain¶
Rôle et périmètre¶
Matchtrain est une API d'apprentissage (Python / FastAPI) qui reçoit des événements de consolidation décrivant une décision humaine (fiche partenaire + candidats vus + choix). Ce n'est pas un annuaire : il n'enrichit pas directement les fiches LaBRRI ; il stocke les décisions et sert à évaluer et entraîner des modèles de rapprochement.
Structure d'un événement (JSON)¶
Chaque message POSTé sur POST /v1/events/consolidation contient :
| Champ | Description |
|---|---|
domain |
Toujours organizations pour les partenaires LaBRRI |
source_record |
Fiche sur laquelle portait la décision : label, city, country, type |
search_context |
Contexte de recherche : q, langs (ex. fr, en), search_api_version ; pour une fusion LaBRRI, champs optionnels labri_merge, labri_merge_role |
candidates[] |
Toutes les propositions vues à l'écran (pas seulement celles cochées) : source, id, libellés, score… |
decision |
action : link, reject ou abstain ; chosen_ids : liste des identifiants retenus (ror:…, wikidata:…) |
metadata |
event_id (évite les doublons), decided_at, app_id, decided_by (nom de l'instance LaBRRI) |
Règles de validation :
action |
Règle |
|---|---|
link |
Au moins un identifiant dans chosen_ids |
reject |
chosen_ids vide (propositions vues, rien retenu) |
abstain |
chosen_ids vide (pas de choix tranché) ; stocké mais non utilisé pour l'entraînement |
Rôles de déploiement¶
Une même image Docker, rôle choisi par MATCHTRAIN_ROLE :
| Rôle | Usage |
|---|---|
collector |
Réception et stockage des événements, export JSONL |
standalone |
Collecte + évaluation parallèle + entraînement (petits déploiements) |
coordinator + worker |
File de tâches distribuée pour l'entraînement (gros volumes) |
Endpoints utiles¶
| Méthode | Chemin | Description |
|---|---|---|
| GET | /health |
État du service |
| POST | /v1/events/consolidation |
Ingestion d'un événement (idempotent via metadata.event_id) |
| GET | /v1/events |
Liste des événements stockés |
| GET | /v1/exports/dataset.jsonl |
Export pour entraînement (format=events, ranker_pairs ou llm_finetune) |
| POST | /v1/eval/run |
Lancement d'une évaluation parallèle (comparaison modèles / décisions humaines) |
| GET | /api/doc |
Documentation Swagger |
Authentification par jeton Bearer si API_AUTH_TOKEN est configuré.
Intégration LaBRRI¶
- L'admin envoie les événements après enregistrement d'une fiche partenaire ou validation d'une fusion.
- Documentation complète : dépôt matchtrain, fichiers
docs/consolidation_event.mdetdocs/promotion_gates.md.
Phase 3 : sources LaBRRI dans OrgaSearch¶
Le contrat API partenaires et l’adaptateur OrgaSearch 0.3.0 permettent d’exposer une base LaBRRI comme source de métarecherche, en complément des annuaires publics. Dans cette version, seule l’instance Tours (labrri-tours) est activable. Un OrgaSearch unique consommé par tout l’écosystème, avec plusieurs instances LaBRRI, reste une évolution. Les décisions capitalisées par Matchtrain pourraient à terme améliorer le rapprochement sur cet ensemble.