Lucarne : documentation technique
Une fenêtre ouverte sur les laboratoires : la promesse au visiteur.
Lucarne (anciennement Saclay Research) est un socle open source de vitrine publique de la recherche, configurable par établissement (« marque blanche »). Il rend les laboratoires, les chercheurs, les projets et les expertises d'une université visibles et trouvables, à partir des données ouvertes de la recherche. Deux instances sont livrées : Université Paris-Saclay, commanditaire, et Université Paris 1 Panthéon-Sorbonne, pour éprouver la marque blanche.
Pas de base de données, pas de serveur applicatif : tout est calculé au build. Les pages lisent des JSON sur le disque, la recherche s'exécute chez le visiteur.
🪟 Les instances en ligne
Paris-Saclay
saclay.lucarne.vicode.frUniversité Paris-Saclay, commanditaire : 248 laboratoires, charte officielle, annuaire institutionnel.
Paris 1
paris1.lucarne.vicode.frUniversité Paris 1 Panthéon-Sorbonne, démonstration de la marque blanche : profil SHS, charte en maquette.
Les établissements candidats et la façon d'en ajouter un : Plan des instances.
🗺️ L'architecture en un schéma
Dix sources ouvertes sont moissonnées telles quelles, fusionnées par identifiant pérenne, publiées en JSON versionnés ; un site Next.js est généré statiquement à partir de ces fiches, indexé par Pagefind, et servi par Vercel ou en auto-hébergement. Une instance n'est qu'un fichier de configuration et deux logos.
🧭 Explorer la documentation
Projet
ProjetOrigine, journal daté de ce qui a été fait et appris, plan d'action, questions ouvertes, validations à obtenir, méthode de travail.
Projection
ProjectionLa trajectoire des données : sources ouvertes récupérées à la main, branchement à CRISalid Paris-Saclay, prochain test sur ses données.
Plan
PlanUne adresse par établissement sous lucarne.vicode.fr : les instances en service, les onze candidats du consortium CRISalid, la mise en ligne.
Architecture
TechniqueStack technique, chaîne de données, marque blanche, recherche : comment le socle est construit et pourquoi.
Données
TechniqueLes dix sources ouvertes, leurs identifiants et licences, la couverture mesurée, le rattachement aux Graduate Schools.
Interface
TechniqueCharte en quatre couleurs et deux polices, jetons CSS, catalogue Storybook, audit UX et ce qu'il reste à reprendre.
Exploitation
ExploitationDéploiement Vercel (un projet par instance), observabilité Prometheus et Matomo, runbook.
Sécurité
ExploitationCartographie des surfaces réseau, politique de dépendances, inventaire SPDX des licences.
Analytics
ExploitationPOC de mesure d'audience et d'observabilité auto-hébergées : Umami, Matomo, Rybbit, OpenObserve.
Décisions
DécisionsQuatorze décisions d'architecture, numérotées et datées, avec leur statut : acceptée, provisoire, remplacée.
⚡ Trois entrées pour arriver vite
S'orienter dans le dépôt
La pile, les dossiers, les trois paquets autonomes et les commandes avec leurs durées mesurées.
Savoir ce qui a été fait
Le journal : chaque étape datée, les mesures, et surtout ce que chaque correctif a appris.
Voir ce qui bloque et ce qui mord
Blocages qui ne dépendent pas de nous, blocages à nous, et les pièges par domaine.
🔁 Les workflows, du poste de travail au déploiement
🔒 Principes
- Sources ouvertes, brut conservé. Chaque source est copiée telle quelle avant toute fusion ; on peut toujours remonter à ce qu'elle a dit (ADR 008).
- Corriger dans la source, jamais localement. La vitrine ne porte aucune donnée saisie à la main ; une erreur se corrige chez celui qui la publie (ADR 001).
- Mesurer avant d'affirmer. Chaque chiffre de cette documentation est mesuré, et dit quand il ne l'est pas (méthodologie).
- Aucune donnée personnelle ne sort vers un tiers. Matomo sans cookie, métriques fermées par jeton, termes de recherche nettoyés (observabilité).
- Licence MIT, à confirmer par l'établissement avant toute reprise externe (ADR 014).