Glossaire — mots techniques en français imagé
Tableau de conversion : mot anglais usuel → équivalent imagé français + explication concrète. Référencé par tous les runbooks
docs/dev-runbooks/. Aussi utile aux utilisatrices qui veulent comprendre ce que di l'administrateur.
Git — versionnage du code
| Mot anglais | Imagé français | Ce que ça fait concrètement |
|---|---|---|
| commit | sauvegarder une étape | Tu prends une photo de ton travail actuel avec un titre. Pas encore envoyé aux autres machines. |
| push | envoyer mes étapes au cloud | Tu publies tes photos sur GitHub. Les autres machines peuvent maintenant les voir. |
| pull | récupérer les étapes des autres | Tu télécharges les photos publiées par les autres machines depuis GitHub. |
| fetch | jeter un œil sans télécharger | Tu regardes ce qu'il y a de nouveau sur GitHub, sans encore l'intégrer. |
| branch | cahier de brouillon | Un espace séparé pour tester sans risquer le cahier principal (main). |
| main | cahier principal | La version officielle, celle que tout le monde voit en premier. |
| merge | recoller les cahiers | Tu prends le contenu de ton brouillon et tu l'ajoutes au cahier principal. |
| PR (Pull Request) | demande de relecture | Tu demandes l'administrateur (ou à quelqu'un) : « est-ce que je peux recoller mon brouillon ? » avant de le faire toi-même. |
| rebase | réécrire l'histoire des étapes | Opération risquée — réservée aux experts ou demande l'administrateur. |
| conflict | deux brouillons modifient la même page | Git ne sait pas quel choix garder, il te demande de trancher manuellement. |
| stash | mettre de côté temporairement | Tu caches tes modifs actuelles pour faire autre chose, tu pourras les ressortir plus tard. |
| revert | annuler une étape précise | Tu fais l'inverse d'une photo sauvegardée — propre, traçable. |
| reset --hard | jeter brutalement |  Destructif — tu perds tout ton travail récent. À éviter. |
Build et déploiement
| Mot anglais | Imagé français | Ce que ça fait concrètement |
|---|---|---|
| build | compiler / fabriquer le plugin | Le code source devient un fichier .dll que Revit peut charger. |
| deploy | installer la nouvelle version | Tu prends le .dll fabriqué et tu le mets dans le dossier que Revit lit au démarrage. |
| release | publier une version officielle | Tu marques une version comme « prête » et tu la publies sur GitHub Releases. L'auto-update la récupèrera. |
| rollback | revenir en arrière | Si la nouvelle version casse, tu remets l'ancienne. |
CI / Intégration continue
| Mot anglais | Imagé français | Ce que ça fait concrètement |
|---|---|---|
| CI | robot vérificateur | À chaque push, GitHub lance des tests automatiques. Vert  = tout va bien. Rouge  = quelque chose casse. |
| CI pipeline | série de vérifications | L'ensemble des étapes que le robot fait : compiler, tester, etc. |
| green / red build | vert / rouge | Vert = tests passent. Rouge = à corriger avant d'aller plus loin. |
| flaky test | test capricieux | Un test qui passe parfois et échoue parfois, sans raison claire. À investiguer. |
Réparation / debugging
| Mot anglais | Imagé français | Ce que ça fait concrètement |
|---|---|---|
| heal | réparer après une fusion cassée | Quand un merge a laissé du désordre, on remet droit (résout conflits + reconstruit). |
| smoke test | test rapide de fumée | Lancer le plugin et vérifier en 2 min que les fonctions principales marchent. |
| regression | retour en arrière non voulu | Une fonctionnalité qui marchait avant et qui est cassée maintenant. |
| breaking change | modification cassante | Un changement qui force tous les autres à adapter leur code. |
Architecture spécifique au projet
| Mot | Imagé français | Ce que ça fait concrètement |
|---|---|---|
| MCP | pont entre plugin et serveur local | Un mini-serveur (port 9710) que le plugin utilise pour communiquer avec Auguste ERP. |
| Sidebar | panneau latéral du plugin | L'interface qu'on voit dans Revit (boutons DPGF, Site, Setup…). |
| Stubs Revit | fausse API Revit pour compiler hors Revit | Permet à la CI de compiler le code sans avoir Revit installé sur le serveur. |
| DockablePane | panneau ancrable dans Revit | Type d'UI Revit qu'on utilise pour la sidebar. |
| ExternalEvent | évènement asynchrone Revit | Mécanisme Revit pour exécuter du code dans le bon thread (UI safe). |
Quand un mot manque ici
Ajouter une ligne. Si vous hésitez sur la traduction imagée, demander dans le commit message l'administrateur arbitrera.