Runbooks développeur — Auguste Revit

Guides étape-par-étape des opérations git, build et déploiement. Public : développeurs et développeuses futurs, freelances, personnes qui reprennent le projet. À terme : les architectes 91STUDIO eux et elles-mêmes quand l'équipe passera à l'étape 3 (contribuer directement au code).

Vocabulaire imagé

Chaque runbook utilise du français imagé dans son titre, avec le mot anglais entre parenthèses pour la recherche.

Le glossaire complet explique chaque terme technique.

Sommaire

Travail quotidien

Action	Runbook	Difficulté
Sauvegarder mes étapes (commit + push)	sauvegarder-mes-etapes.md
Récupérer les étapes des autres (pull)	recuperer-les-changements-distants.md
Proposer un changement (PR)	proposer-un-changement.md

Déploiement & tests

Action	Runbook	Difficulté
Installer la nouvelle version du plugin dans Revit (deploy)	installer-le-plugin-dans-revit.md
Lancer la suite de tests (test)	Cf. skill /test

Réparation

Action	Runbook	Difficulté
Réparer après une fusion cassée (heal)	reparer-apres-merge-casse.md

Conventions

• Tous les runbooks suivent le template.
• Aucune commande destructrice en copy-paste direct (force-push, reset --hard, rm -rf). Si une étape est risquée, drapeau + confirmation explicite de l'administrateur obligatoire avant exécution.
• Les commandes sont prêtes à coller dans un terminal PowerShell (workflow typique de l'administrateur sur Mac via Parallels Windows) ou Bash (Mac natif, Git Bash sur Windows). Précisé en haut de chaque commande quand ça compte.
• Toutes les commandes destructrices peuvent être annulées via git reflog dans les 30 jours — pas de panique en cas d'erreur, sauf pour rm -rf qui supprime vraiment.

Pré-requis pour suivre ces runbooks

1. Git installé : git --version doit retourner un numéro de version.
2. Cloner le repo : gh repo clone 91STUDIO971/auguste-revit (utilise GitHub CLI car le repo est privé).
3. Compte GitHub avec accès au repo 91STUDIO971/auguste-revit — demander à l'administrateur si pas encore configuré.
4. Connaître son terminal : PowerShell (Windows) ou Bash (Mac/Linux/Git Bash sur Windows).

Pas besoin d'avoir Revit installé pour la plupart des runbooks — seulement pour le déploiement final sur poste de production.

Pour aller plus loin

• Charte d'écriture : ../../handoff/DOC-RULES.md
• Patterns techniques (anti-patterns Revit/.NET/XAML) : ../../handoff/patterns.md
• Leçons apprises (bugs résolus) : ../../handoff/lessons/