# Du changement à la production

Le chemin d'un changement, qui le fait, qui le contrôle.


Rien ne part en production par accident. Chaque changement suit cinq étapes, et un échec à n'importe laquelle l'arrête.

<figure class="schema"><svg viewBox="0 0 520 424" role="img" aria-label="Les cinq étapes d&#x27;un changement" xmlns="http://www.w3.org/2000/svg"><defs><marker id="f" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse"><path d="M1 1.5L8.5 5L1 8.5z" class="mk"/></marker><filter id="o" x="-5%" y="-5%" width="110%" height="120%"><feDropShadow dx="0" dy="1.5" stdDeviation="2" flood-opacity=".14"/></filter></defs><g class="cc c-gris"><rect x="40" y="10" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 10 H45 a5 5 0 0 0 -5 5 V63 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="39.0" r="12" class="bad"/><text x="67" y="44.0" class="num" text-anchor="middle">1</text><text x="90" y="36.0" class="tt" text-anchor="start">La demande</text><text x="90" y="55.0" class="ts" text-anchor="start">confiée à l&#x27;équipe du module</text></g><path d="M260.0 71 V93" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-bleu"><rect x="40" y="96" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 96 H45 a5 5 0 0 0 -5 5 V149 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="125.0" r="12" class="bad"/><text x="67" y="130.0" class="num" text-anchor="middle">2</text><text x="90" y="122.0" class="tt" text-anchor="start">L&#x27;écriture</text><text x="90" y="141.0" class="ts" text-anchor="start">contrôles automatiques au commit</text></g><path d="M260.0 157 V179" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-bleu"><rect x="40" y="182" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 182 H45 a5 5 0 0 0 -5 5 V235 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="211.0" r="12" class="bad"/><text x="67" y="216.0" class="num" text-anchor="middle">3</text><text x="90" y="208.0" class="tt" text-anchor="start">La vérification</text><text x="90" y="227.0" class="ts" text-anchor="start">copie locale, jamais la production</text></g><path d="M260.0 243 V265" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-violet"><rect x="40" y="268" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 268 H45 a5 5 0 0 0 -5 5 V321 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="297.0" r="12" class="bad"/><text x="67" y="302.0" class="num" text-anchor="middle">4</text><text x="90" y="294.0" class="tt" text-anchor="start">Les relecteurs</text><text x="90" y="313.0" class="ts" text-anchor="start">code, base, écrans, second regard</text></g><path d="M260.0 329 V351" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-vert plein"><rect x="40" y="354" width="440" height="58" rx="12" class="card" filter="url(#o)"/><path d="M52 354 H45 a5 5 0 0 0 -5 5 V407 a5 5 0 0 0 5 5 H52z" class="bar" transform="translate(0 0)"/><circle cx="67" cy="383.0" r="12" class="bad"/><text x="67" y="388.0" class="num" text-anchor="middle">5</text><text x="90" y="380.0" class="tt" text-anchor="start">Le « pousse »</text><text x="90" y="399.0" class="ts" text-anchor="start">accord du propriétaire, migrations puis code</text></g></svg></figure>

## Les cinq étapes

1. **La demande.** Elle vient du propriétaire. Il la confie à l'équipe du module concerné. Un bug signalé par un client est un correctif direct.
2. **L'écriture.** Un petit changement va sur la branche principale. Un gros chantier ou un nouveau module a sa branche. Les règles de code sont les mêmes pour toutes les équipes. Au commit, des outils vérifient la mise en forme, le style, les doublons, la règle « le cœur n'importe jamais un module » et la taille des fichiers.
3. **La vérification.** Elle se fait sur une copie locale, jamais sur la production : types, règles, tests unitaires, rejeu des fonctions de la base, budget de lectures par écran.
4. **Les relecteurs.** Quatre lectures indépendantes du même changement : le code, la base, les écrans, et un second regard d'un autre moteur. Leurs remarques vont à qui a écrit le code. Une faille de droits, une panne possible ou un risque pour les données arrête la mise en ligne. Le reste part et se corrige ensuite.
5. **Le « pousse » du propriétaire.** Sans son accord, rien ne part. Les migrations de la base sont jouées avant le code, et l'ancien code doit tenir avec le nouveau schéma. Une migration lourde ne se joue pas pendant les heures de travail des clients. Ensuite, une vérification du déploiement et un suivi continu des erreurs surveillent.

## Les lieux

| Lieu | Usage |
| --- | --- |
| Copie locale | Essais, tests, rejeu. Aucun risque pour les données. |
| Recette | Une copie des données pour que le client essaie. |
| Staging | Les gros chantiers sur branche, à la demande du propriétaire. |
| Production | Après le « pousse ». |

<figure class="schema"><svg viewBox="0 0 520 120" role="img" aria-label="De la copie locale à la production" xmlns="http://www.w3.org/2000/svg"><defs><marker id="f" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse"><path d="M1 1.5L8.5 5L1 8.5z" class="mk"/></marker><filter id="o" x="-5%" y="-5%" width="110%" height="120%"><feDropShadow dx="0" dy="1.5" stdDeviation="2" flood-opacity=".14"/></filter></defs><g class="cc c-vert"><rect x="8" y="10" width="118" height="64" rx="12" class="card" filter="url(#o)"/><text x="67.0" y="39.0" class="tt" text-anchor="middle">Copie locale</text><text x="67.0" y="58.0" class="ts" text-anchor="middle">essais, tests</text></g><path d="M127 42 H134" class="ln" marker-end="url(#f)"/><g class="cc c-bleu"><rect x="135" y="10" width="118" height="64" rx="12" class="card" filter="url(#o)"/><text x="194.0" y="39.0" class="tt" text-anchor="middle">Recette</text><text x="194.0" y="58.0" class="ts" text-anchor="middle">le client essaie</text></g><path d="M254 42 H261" class="ln" marker-end="url(#f)"/><g class="cc c-ambre"><rect x="262" y="10" width="118" height="64" rx="12" class="card" filter="url(#o)"/><text x="321.0" y="39.0" class="tt" text-anchor="middle">Staging</text><text x="321.0" y="58.0" class="ts" text-anchor="middle">gros chantiers</text></g><path d="M381 42 H388" class="ln" marker-end="url(#f)"/><g class="cc c-rouge plein"><rect x="389" y="10" width="118" height="64" rx="12" class="card" filter="url(#o)"/><text x="448.0" y="39.0" class="tt" text-anchor="middle">Production</text><text x="448.0" y="58.0" class="ts" text-anchor="middle">après le « pousse »</text></g><text x="260" y="104" class="ts" text-anchor="middle">risque croissant  →</text></svg></figure>

## La vie d'un module

<figure class="schema"><svg viewBox="0 0 520 290" role="img" aria-label="Un module passe de sa branche à l&#x27;essai puis à l&#x27;état actif" xmlns="http://www.w3.org/2000/svg"><defs><marker id="f" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse"><path d="M1 1.5L8.5 5L1 8.5z" class="mk"/></marker><filter id="o" x="-5%" y="-5%" width="110%" height="120%"><feDropShadow dx="0" dy="1.5" stdDeviation="2" flood-opacity=".14"/></filter></defs><g class="cc c-gris"><rect x="60" y="10" width="400" height="62" rx="12" class="card" filter="url(#o)"/><path d="M72 10 H65 a5 5 0 0 0 -5 5 V67 a5 5 0 0 0 5 5 H72z" class="bar" transform="translate(0 0)"/><circle cx="87" cy="41.0" r="12" class="bad"/><text x="87" y="46.0" class="num" text-anchor="middle">1</text><text x="110" y="38.0" class="tt" text-anchor="start">Sur sa branche</text><text x="110" y="57.0" class="ts" text-anchor="start">l&#x27;équipe y travaille</text></g><path d="M260 75 V103" class="ln" fill="none" marker-end="url(#f)"/><rect x="268.0" y="78.0" width="156.8" height="20" rx="10" class="pill"/><text x="346.4" y="93.0" class="tl" text-anchor="middle">accord du propriétaire</text><g class="cc c-ambre"><rect x="60" y="106" width="400" height="62" rx="12" class="card" filter="url(#o)"/><path d="M72 106 H65 a5 5 0 0 0 -5 5 V163 a5 5 0 0 0 5 5 H72z" class="bar" transform="translate(0 0)"/><circle cx="87" cy="137.0" r="12" class="bad"/><text x="87" y="142.0" class="num" text-anchor="middle">2</text><text x="110" y="134.0" class="tt" text-anchor="start">En essai</text><text x="110" y="153.0" class="ts" text-anchor="start">allumé pour qui l&#x27;essaie</text></g><path d="M260 171 V199" class="ln" fill="none" marker-end="url(#f)"/><rect x="268.0" y="174.0" width="54.400000000000006" height="20" rx="10" class="pill"/><text x="295.2" y="189.0" class="tl" text-anchor="middle">validé</text><g class="cc c-vert plein"><rect x="60" y="202" width="400" height="62" rx="12" class="card" filter="url(#o)"/><path d="M72 202 H65 a5 5 0 0 0 -5 5 V259 a5 5 0 0 0 5 5 H72z" class="bar" transform="translate(0 0)"/><circle cx="87" cy="233.0" r="12" class="bad"/><text x="87" y="238.0" class="num" text-anchor="middle">3</text><text x="110" y="230.0" class="tt" text-anchor="start">Actif</text><text x="110" y="249.0" class="ts" text-anchor="start">allumé pour les sociétés</text></g></svg></figure>

1. **Sur sa branche.** L'équipe y travaille, hors de la branche principale.
2. **En essai.** Le module est livré, mais allumé seulement pour qui l'essaie.
3. **Actif.** Il est allumé pour les sociétés qui le choisissent. L'équipe reste propriétaire : elle le fait évoluer et corrige ses bugs.

## Ce qu'un nouvel arrivant ne fait jamais

- Écrire ou rejouer quoi que ce soit sur la production, même un essai.
- Jouer une migration à la main ou réécrire une migration déjà jouée.
- Ajouter un paquet sans validation.
- Lire ou écrire un secret dans une conversation.
- Envoyer un courriel à un client depuis un test.
- Mettre dans le cœur ce qui est propre à un module ou à une société.
- Pousser sans la vérification et les relectures.
