Glossaire

Termes techniques utilisés à travers les projets LCL Environnement, tirés du Guide des systèmes informatiques et des README.md de chaque dépôt.

Vocabulaire ODK

ODK (Open Data Kit) : Système gratuit et ouvert de collecte de données sur le terrain, même sans connexion Internet. Deux moitiés : ODK Collect, l'application mobile où les techniciens remplissent les formulaires (hors ligne si besoin), et ODK Central, le serveur (odk.lclchantiers.com) qui publie les formulaires et reçoit les données.

Projet (ODK) : Un regroupement de formulaires dans ODK Central.

Formulaire (form) / XLSForm : Un questionnaire conçu dans Excel, au format XLSForm (une ligne = une question). Fait exprès en Excel pour qu'une personne non-programmeuse puisse en concevoir un.

Soumission (submission) : Un formulaire rempli et envoyé (une visite de chantier = une soumission).

Version de formulaire : Quand un formulaire est modifié, une nouvelle version est publiée. Les anciennes soumissions ne changent pas : elles restent attachées à la version avec laquelle elles ont été remplies. Renommer un champ dans un formulaire déjà utilisé orphelinerait les anciennes données.

Entités (entities) : Une liste de références partagée entre les formulaires (ex. la liste des projets en cours), qui se remplit automatiquement pour éviter à un technicien de retaper une valeur à la main, ce qui réduit les erreurs de saisie. C'est ce que produit ScoroOdkBridge.

Utilisateurs (ODK) : Chaque technicien a son propre compte. Les comptes ne se partagent pas, pour savoir qui a soumis quoi.

Glossaire général

Droplet : Un ordinateur loué au mois chez DigitalOcean, sans écran ni clavier (accès à distance), qui roule Linux (Ubuntu). C'est le seul serveur qui héberge tous les projets LCL Environnement. Voir Infrastructure.

DNS / enregistrement A : L'annuaire mondial qui associe un sous-domaine (ex. rapports.lclchantiers.com) à l'adresse du droplet. Ajouter un enregistrement A est la première étape pour exposer un nouveau service sur Internet.

Coolify : Le gestionnaire des applications sur le droplet. Il installe, démarre, met à jour et donne accès aux logs de chaque application, via une interface web. Équivalent auto-hébergé de Heroku/Vercel. Voir Infrastructure.

Caddy : Le reverse proxy utilisé par Coolify : il redirige chaque requête entrante vers la bonne application selon le sous-domaine visé, et gère automatiquement les certificats HTTPS.

Variables d'environnement : Réglages et mots de passe d'une application, stockés dans Coolify plutôt que dans le code, ce qui permet au code d'être public sur GitHub sans exposer de secret. Un changement ne prend effet qu'après un redéploiement.

Scoro : L'outil de gestion de projets de l'entreprise. Source de vérité sur les projets en cours (numéro, statut, contacts) pour ScoroOdkBridge et ScoroPost.

Échantillon / éprouvette : Vocabulaire du suivi labo (LabTracker). Un échantillon est le matériau physique prélevé sur site ; il est divisé en une ou plusieurs éprouvettes, l'unité réellement suivie (statut, échéance, laboratoire, tests). Un échantillon de béton donne plusieurs cylindres (éprouvettes) testés à des dates différentes ; un échantillon de granulats ou d'enrobé donne une seule éprouvette.

Non-conformité : Un résultat de test qui ne respecte pas le devis ou la norme applicable. Déclenche une alerte courriel automatique dans lcl-rapports et fait passer une éprouvette au statut Non-conformité dans LabTracker.

PWA (Progressive Web App) : Un site web qui peut être « installé » sur un téléphone comme une application, avec son icône sur l'écran d'accueil, sans passage par un App Store ni compte développeur. Utilisée par le chatbot technique.

RAG (Retrieval-Augmented Generation) : Technique qui consiste à retrouver les passages les plus pertinents d'une base documentaire avant de les fournir à un modèle de langage, pour que sa réponse s'appuie strictement sur ces extraits plutôt que sur ses seules connaissances générales. C'est le principe du chatbot technique.

pgvector : Extension PostgreSQL qui permet de stocker des empreintes numériques de texte (embeddings) et de chercher par similarité de sens plutôt que par mot-clé. Utilisée par le chatbot technique pour retrouver les passages de normes pertinents à une question.

Entra ID (Azure AD) : Le système de connexion par compte d'entreprise Microsoft. Utilisé par LabTracker (obligatoire) et prévu pour ScoroPost et le chatbot technique (pas encore fait).

Outbox (file d'attente de livraison) : Motif utilisé pour l'envoi des rapports de LabTracker vers lcl-rapports : la mise en file d'attente d'un envoi est enregistrée immédiatement, puis un worker en arrière-plan l'envoie avec réessais. Une panne du destinataire retarde l'envoi, elle ne le perd jamais.