Skip to content

v1.12.0

Description

Montée de version centrée sur la consolidation de la base partenaires : identifiants multiples par établissement, recherche assistée via OrgaSearch, fusion de doublons, demandes d'ajout cadrées et import CSV repensé. Backend v1.2.0 (API Symfony) et interface admin v1.12.0 (React).

Documentation fonctionnelle détaillée : Consolidation de la base partenaires.

Base partenaires et références externes

  • Carnet d'identifiants partenaires par fiche : MoveOn, Mobility OnLine, ROR, HAL, Wikidata… avec détection de conflit si un identifiant est déjà lié à une autre organisation
  • Libellés multilingues mémorisés sur chaque référence externe (fr, en, de…), issus des annuaires ou de l'import CSV
  • Recherche OrgaSearch (service conteneurisé) : métarecherche ROR, HAL et Wikidata depuis l'écran organisation et le sélecteur partenaire, sans quitter LaBRRI
  • Fusion de doublons : assistant de consolidation (fiche conservée, fiches absorbées marquées « consolidée vers… », réaffectation des mobilités, conventions, projets…)
  • Alertes homonymes à la création ou à l'enregistrement ; blocage si libellé identique ou référence externe partagée non résolue

Demandes d'ajout

  • Côté référent : recherche LaBRRI puis OrgaSearch avant de soumettre une demande d'organisation
  • Côté administrateur : assistant de traitement dédié (recherche d'homonymes, création ou sélection, liaison optionnelle à la fiche d'origine)
  • Notification : badge lorsque des demandes ont été traitées

Import CSV organisations

  • Import des références SI en priorité (champ source obligatoire) ; création d'une fiche établissement conditionnelle (référence non liée, pas d'homonyme)
  • Résolution des partenaires lors des imports mobilités / accords par source + identifiant, avec repli sur le libellé

Matchtrain (service mutualisé)

  • Service unique partagé par toutes les instances LaBRRI : chaque instance pointe vers la même URL
  • Enregistrement asynchrone des décisions de liaison OrgaSearch et de fusion dans un corpus commun (sans impact immédiat sur le comportement de LaBRRI)

Documentation en ligne (doc v1.2)

Refonte de l'aide MkDocs : guides utilisateur et administrateur réorganisés, pages nouvelles ou réécrites (organisations, OrgaSearch, import CSV, demandes d'ajout, export, tableaux de bord, historique, FAQ…).

Hébergement : l'aide reste temporairement accessible sous https://labri.univ-tours.fr/doc/. Elle est cependant délocalisée vers un autre DNS : https://doc.labrri-services.univ-tours.fr/.

Liens contextuels dans l'admin : icône ou lien « En savoir plus » sur les écrans principaux (sélection, rubriques, référentiels, organisations, demandes d'ajout, tableaux de bord, historique…), ouvrant la page d'aide correspondante dans un nouvel onglet.

Nouvelle page administrateur : Co-publications depuis HAL — configuration du rapprochement unités LaBRRI / structures HAL (Code référentiel autre), synchronisation hebdomadaire et consultation de la rubrique Co-publications internationales.

Pages d'aide alignées sur les évolutions v1.12.0. Voir les notes de version documentation.

Images Docker

Variable d'environnement Tag
<IMAGE_DB> scm.univ-tours.fr:4567/iliad3/labrri-deploy/labrri_db:v15
<IMAGE_PHP> scm.univ-tours.fr:4567/iliad3/labrri-deploy/labrri_php:v1.2.0
<IMAGE_ADMIN> scm.univ-tours.fr:4567/iliad3/labrri-deploy/labrri_admin_<instance (ex. tours)>_<preprod/prod>:v1.12.0
<IMAGE_ORGASEARCH> scm.univ-tours.fr:4567/iliad3/labrri-deploy/orgasearch:v0.2.0

Migration de la base de données

Passage du modèle de données de la version du backend 1.0.0 à la version 1.2.0 : références externes, consolidation d'organisations, notifications des demandes d'ajout.

  • Script SQL de test avec affichage des résultats à transmettre à ILIAD3 avant de procéder à la migration effective
  • Script SQL de migration effective
  • Script SQL de liaison post-migration des références externes existantes (optionnel, selon l'état de la base)

    Paramètre à adapter

    Avant d'exécuter ce script, modifier la valeur de p_source (présente dans les 3 blocs WITH params AS …) pour y indiquer la source correspondant à votre contexte (valeur du champ source dans la table reference_externe). La valeur par défaut fixture-import-alpha est un exemple.

  • Script SQL de contrôle de cohérence des séquences d'identifiants auto-incrémentés

  • Script SQL de correction des séquences d'identifiants auto-incrémentés incohérentes
  • Utilitaire Windows de vérification (optionnel)

Mise à jour vers v1.12.0

Utilisateur dédié

Toutes les opérations ci-dessous (y compris OrgaSearch, docker compose, configuration-tool.sh et la migration SQL) doivent être exécutées en tant qu'utilisateur <LOGIN>, depuis le dossier <WORKDIR>, conformément à la documentation de déploiement.

1. Dépôt : récupérer les changements du repository labrri-deploy dans <WORKDIR> :

git pull

2. OrgaSearch, API et admin : télécharger <IMAGE_PHP> (v1.2.0), <IMAGE_ORGASEARCH> et <IMAGE_ADMIN> (v1.12.0) via Portainer (voir étape 7 de la documentation de déploiement), ajouter le service labri-orgasearch au docker-compose.yml (bloc dans docker-compose.yml.sample), renseigner ORGASEARCH_IMAGE, LABRI_PHP_IMAGE et LABRI_ADMIN_IMAGE dans .env, puis relancer la stack :

docker compose up -d

Clé OpenAlex (optionnel)

Il est possible d'ajouter une clé OpenAlex au service labri-orgasearch en renseignant OPENALEX_API_KEY dans son bloc environment du docker-compose.yml (en complément des variables déjà présentes dans le sample) :

labri-orgasearch:
    image: ${ORGASEARCH_IMAGE}
    restart: on-failure
    environment:
        ROOT_PATH: /orgasearch
        WIKIDATA_USER_AGENT: "Orgasearch/0.2.0 (labri@univ-tours.fr)"
        # 1 IP partagée (RP) → plafond d'instance, pas par utilisateur
        RATE_LIMIT_SEARCH: "60/minute"
        RATE_LIMIT_GLOBAL: "180/minute"
        RATE_LIMIT_READ: "120/minute"
        OPENALEX_API_KEY: "<CLE_OPENALEX>"
    networks:
        - traefik
    labels:
        # ...

3. Cron : copier docker/cron/Dockerfile.sample dans docker/cron/Dockerfile, puis reconstruire labri-cron (image dérivée de LABRI_PHP_IMAGE) :

docker compose build labri-cron

4. Clés JWT : configuration-tool.sh, opération 10

5. Cache Symfony : configuration-tool.sh, opération 12, ou suppression de <WORKDIR>/.cache/api/prod (voir étape 13 de la documentation de déploiement)

6. Relancer la stack pour prendre en compte le cron reconstruit :

docker compose up -d

7. Vérifier https://<DOMAINE>/ui et vider le cache navigateur si besoin