Les tests et les contrôles
Ce qui empêche une erreur d'arriver en production, niveau par niveau.
Ironlane ne se fie pas à la vigilance de celui qui écrit. Chaque erreur qu’on sait nommer a un contrôle qui la refuse.
Ce que chaque niveau attrape
Section intitulée « Ce que chaque niveau attrape »| Niveau | Il attrape | Quand |
|---|---|---|
| Au commit | Un type faux, un style cassé, un composant réécrit, un bloc écrit deux fois, un commentaire d’histoire, un fichier trop long | À chaque commit, puis dans l’intégration continue |
| Tests unitaires | Une règle métier fausse, une action serveur qui laisse passer sans droit | À chaque changement |
| Contrôles de la base | Une table sans règle d’accès, une fonction à droits élevés ouverte sans garde, un lien entre deux sociétés | Avant la mise en ligne |
| Rejeu des fonctions SQL | Une fonction d’écriture qui plante, une écriture qui laisse une trace | Avant la mise en ligne, en transaction annulée |
| Droits et étanchéité | Une fuite entre sociétés, une fonction gardée qui passe sans son droit | Avant la mise en ligne, sur la copie locale |
| Vitesse | Un écran qui lit plus que son budget | Avant la mise en ligne |
| Parcours | Un parcours utilisateur cassé | Sur une copie, jamais sur la production |
Les règles du test
Section intitulée « Les règles du test »- Une règle métier nouvelle a un test qui échoue sans elle. Un test qui passe avec ou sans la règle ne prouve rien.
- Un bug corrigé a un test qui l’aurait vu.
- Une action serveur a un test de refus : sans droit, hors de son périmètre, avec une entrée invalide.
- Deux écrans qui montrent le même chiffre montrent la même valeur. Un contrôle les compare.
- Un compteur égale la liste qu’il ouvre.
Prouver plutôt que regarder
Section intitulée « Prouver plutôt que regarder »- Une conversion qui ne doit rien changer se compare avant et après. Zéro différence, ou chaque différence expliquée.
- Un changement de CSS se prouve par les styles calculés de chaque élément, relevés par un script.
- Un calcul se compare sur toutes les lignes, dans une transaction annulée.
- Les captures d’écran servent à l’œil, jamais à la preuve.
Jamais sur la production
Section intitulée « Jamais sur la production »- Aucun essai de bout en bout ne tourne contre la production : le test refuse de démarrer si la cible est la production.
- Aucun test n’envoie de courriel à un client, quelle que soit la configuration : une garde dans le code arrête tout envoi vers un client.
- La vitesse se juge sur des mesures de production prises en transaction annulée. La copie locale compare deux versions, elle ne donne pas les temps de la production.
Les listes de cas connus ne font que baisser
Section intitulée « Les listes de cas connus ne font que baisser »Une liste d’exceptions (style, doublons, règles de la base) sert à ne pas bloquer le travail courant. Un fichier en sort quand il est corrigé et un nouveau n’y entre jamais. Un contrôle rouge se comprend, se corrige ou se documente. On ne le fait jamais taire.
L’intégration continue
Section intitulée « L’intégration continue »Chaque push rejoue la compilation, l’analyse, la mise en forme, la détection de code mort, les tests unitaires et la vérification des routes. Un échec bloque la fusion et le déploiement.
Ce qui n’est pas testé
Section intitulée « Ce qui n’est pas testé »Une documentation honnête dit aussi ce que rien ne vérifie. Ces règles sont tenues par la relecture seulement :
- une définition métier nouvelle, et le vocabulaire écrit en dur ;
- la longueur d’une fonction, les valeurs de style arbitraires, la largeur choisie pour une page ;
- les textes des écrans (boutons, erreurs, écrans vides) ;
- la validation des entrées d’une action serveur : les refus de la base sont rejoués, l’action elle-même n’a pas de contrôle commun ;
- un secret dans le contenu d’un commit : aucun outil ne le cherche, c’est la relecture avant le commit qui le voit ;
- « un commit fait une chose » ;
- les durées de conservation des données personnelles ;
- le type et la taille d’un fichier déposé, contrôlés côté serveur mais sans test commun à tous les dépôts de fichiers ;
- la liste d’exceptions du style, qui est censée ne faire que baisser mais que rien ne force.
Chaque règle sans outil est un point que la relecture doit couvrir. Elle n’est pas facultative pour autant.
Dire ce qui n’a pas été vérifié
Section intitulée « Dire ce qui n’a pas été vérifié »Un compte rendu nomme ce qui n’a pas été regardé : la largeur d’un téléphone, les survols, le mode sombre, les boutons désactivés.