Notes de version de la documentation

Cette page décrit les mises à jour de l’aide en ligne LaBRRI (MkDocs), publiée sous /doc/.

Elle ne remplace pas les notes de version de l’application LaBRRI, communiquées par votre administrateur lors des déploiements du logiciel.

Version courante de la documentation

Documentation 1.2 (2026) — refonte de l’aide utilisateur et administrateur, alignée sur l’instance de référence (Universités de Tours / Orléans, financement DSG 2021-2023).

Le numéro affiché dans la barre latérale de cette aide (1.2) est celui de la documentation, pas celui du logiciel installé chez vous.

Nouvelle organisation

• Arborescence en Guide utilisateur et Guide administrateur (fichiers mkdocs.yml, mkdocs.yml.test, mkdocs.yml.prod).
• Suppression des pages obsolètes input-data.md et version.md.
• Nouvelles pages :
• Utilisateur : Saisie manuelle, Export des données, Soumettre une demande d’ajout, Organisations — sélection, FAQ.
• Administrateur : Référentiels, Gestion des organisations, Traiter les demandes d’ajout, Import CSV, Co-publications depuis HAL, Tableaux de bord — administration, Historique.

Pages réécrites ou enrichies

• Introduction, Accueil, Démarrage rapide, Administration, Profils, Les rubriques, Recherche et sélection, Tableau de bord, Utilisateurs, Connexion, harmonisation du nom LaBRRI.

Alignement sur le comportement de l’application

Points vérifiés ou corrigés par rapport à l’interface et au code :

• Demandes d’ajout : boutons en création et édition ; rattachement à la fiche et liaison automatique uniquement depuis un formulaire d’édition.
• Import CSV : séparateur détecté automatiquement ; pas de rapport ligne par ligne ; formats de dates et résolution des partenaires conformes aux contrôleurs d’import.
• Tableaux de bord publics : partage par lien (/ui/viz/{id}), intégration iframe (edit: false en production), jeton Cube public sans données à caractère personnel.
• Historique : bouton Historique accessible en consultation et en édition d’une fiche.
• Organisations : références externes (ROR, HAL, Wikidata), comportement OrgaSearch documenté.

Historique des mises à jour de la documentation

Version doc	Date	Principales évolutions
1.2	2026	Refonte navigation ; 12 nouvelles pages ; réécriture profils, rubriques, dashboard, import/export, organisations, demandes d’ajout, FAQ ; suppression input-data.md / version.md ; corrections alignées sur le code ; placeholders de captures inline (17 fichiers PNG à déposer dans images/)
antérieur	—	Aide MkDocs initiale (rubriques, co-publications, saisie regroupée dans input-data.md, etc.)

Captures d’écran à intégrer

Les illustrations sont stockées dans doc/docs/images/ et insérées dans la page concernée (pas de page dédiée).

Convention dans les pages

Chaque emplacement est marqué par :

1. un commentaire HTML <!-- CAPTURE images/nom.png … --> avec le cadrage attendu (visible dans le source Markdown, pas à l’écran) ;
2. la ligne d’image MkDocs juste en dessous :

![Texte alternatif](images/nom-fichier.png)

Tant que le fichier PNG n’existe pas dans doc/docs/images/, la build affichera une image manquante : déposez le fichier au nom indiqué pour l’activer. Vous pouvez supprimer le commentaire HTML une fois la capture validée.

Réalisez les captures sur une instance de démonstration avec données anonymisées.

Priorité 1

Fichier	Écran	Page	Emplacement dans la page
connexion-cas.png	Login avec bouton CAS	Connexion	Après le 1er paragraphe de « Connexion au travers du CAS »
selection-panneau.png	Menu latéral — Sélection dépliée	Recherche et sélection	Fin de « Le panneau Sélection — Accès », avant « Critères disponibles »
selection-compteurs.png	Compteurs sélection / total	Recherche et sélection	Fin de « Compteurs et navigation », avant « Requêtes sauvegardées »
requetes-sauvegardees.png	Fenêtre Requêtes enregistrées	Recherche et sélection	Début de « Requêtes sauvegardées », avant « Mode sélection / activité »
import-csv-mapping.png	Assistant import — mapping	Import CSV	Procédure, après l’étape 4 (mapping), avant l’étape 5
export-colonnes.png	Sélection des colonnes à l’export	Export des données	« Comment exporter », après l’étape 4, avant l’étape 5
profil-matrice.png	Grille de droits (onglet Projets)	Profils	« Lecture de la matrice de droits », après la liste des actions
dashboard-explore.png	Mode Explore + constructeur	Tableau de bord	Début de « Mode Explore », avant « Créer un graphique »
demande-ajout.png	Boutons Demande d’ajout (création ou édition)	Soumettre une demande d’ajout	« Soumettre une demande », après l’étape 4
organisation-homonyme.png	Alerte homonyme à la création	Gestion des organisations	Après l’encadré « Alerte homonymes », avant « Références externes »

Priorité 2

Fichier	Écran	Page	Emplacement dans la page
organisation-selecteur.png	Sélecteur LaBRRI vs références externes	Organisations — sélection	« Lier un partenaire », avant « Résultats LaBRRI »
demande-ajout-traiter-assistant.png	Assistant organisation (recherche ou création)	Traiter les demandes d’ajout	« Traiter via l’assistant », après l’ouverture de l’assistant
demande-ajout-badge.png	Badge notification demandes traitées	Soumettre une demande d’ajout	« Suivre ses demandes », après la liste des emplacements du badge
dashboard-onglets.png	Onglets profil / personnel, publié / non publié	Tableau de bord	« Types de tableaux », après les indicateurs de visibilité
dashboard-publie-liens.png	Icônes Lien sur tableau publié	Tableau de bord	« Publication et liens publics », après le 1er paragraphe
historique-global.png	Liste Gestion → Historique	Historique	« Consulter l’historique global », après l’étape 1
historique-fiche.png	Bouton horloge + fenêtre modale	Historique	« Consulter l’historique d’une fiche », après l’étape 3

Application LaBRRI (hors scope de cette page)

Les montées de version du logiciel (correctifs, évolutions fonctionnelles) sont déployées par l’équipe technique de votre établissement.

Lors d’un déploiement applicatif :

1. Consultez la note de version fournie par votre administrateur local.
2. Parcourez les sections concernées de cette documentation.
3. Signalez toute anomalie ou écart à votre référent LaBRRI ou au support CETU.