# Vérifier

Tests, preuves, compte rendu : dire comment on sait que c'est fait.


Dire « c'est fait » demande de dire comment on le sait. Chaque erreur qu'on sait nommer a un contrôle qui la refuse.

:::note[En bref]
- **TEST-01** · [Écrivez le test qui échoue sans la règle](#test-01--écrivez-le-test-qui-échoue-sans-la-règle)
- **TEST-02** · [Testez le refus](#test-02--testez-le-refus)
- **TEST-03** · [Lancez les tests ciblés](#test-03--lancez-les-tests-ciblés)
- **TEST-04** · [Prouvez plutôt que regardez](#test-04--prouvez-plutôt-que-regardez)
- **TEST-05** · [Ne testez jamais sur de vraies données](#test-05--ne-testez-jamais-sur-de-vraies-données)
- **TEST-06** · [Ne faites pas taire un contrôle rouge](#test-06--ne-faites-pas-taire-un-contrôle-rouge)
- **TEST-07** · [Dites ce que vous n'avez pas vérifié](#test-07--dites-ce-que-vous-navez-pas-vérifié)
- **TEST-08** · [Passez la liste avant de dire « c'est fait »](#test-08--passez-la-liste-avant-de-dire--cest-fait-)
:::

## Écrire les tests

### TEST-01 · Écrivez le test qui échoue sans la règle

:::tip[Règle]
Une règle métier nouvelle a un test qui échoue sans elle. Un bug corrigé a un test qui l'aurait vu.
:::

**Pourquoi.** Un test qui passe avec ou sans la règle ne prouve rien.

<div class="avant-apres">

```ts title="À éviter"
test("la facture est calculée", () => {
  assert.ok(calculerLaFacture(devis));  // passe toujours
});
```

```ts title="À faire"
test("une facture partagée se répartit au prorata des montants", () => {
  assert.deepEqual(repartir(facture, [opA, opB]), [600, 400]);
});
```

</div>

<span class="puce relecture">Relecture</span> Que le test échoue sans la règle ne se vérifie qu'en l'essayant.

### TEST-02 · Testez le refus

:::tip[Règle]
Une action serveur a un test de refus : sans droit, hors de son périmètre, avec une entrée invalide.
:::

<span class="puce outil">Outil</span> Le rejeu des fonctions et la simulation des droits sous chaque compte couvrent les gardes de la base.

<span class="puce relecture">Relecture</span> L'action serveur elle-même se relit.

### TEST-03 · Lancez les tests ciblés

:::tip[Règle]
Lancez les tests de ce que vous avez changé. La suite complète, une relecture par agents ou un script qui verrouille une base partagée se lancent sur demande.
:::

<span class="puce relecture">Relecture</span> C'est une consigne de travail, pas un verrou du dépôt.

## Prouver

### TEST-04 · Prouvez plutôt que regardez

:::tip[Règle]
Une conversion qui ne doit rien changer se compare avant et après. Un calcul se compare sur toutes les lignes. Un changement de CSS se prouve par les styles calculés. Zéro différence, ou chaque différence expliquée.
:::

**Pourquoi.** Les captures d'écran servent à l'œil, jamais à la preuve.

<span class="puce outil">Outil</span> Des scripts comparent les chiffres entre écrans, les styles calculés et les budgets de lectures.

### TEST-05 · Ne testez jamais sur de vraies données

:::tip[Règle]
Un essai passe par une transaction annulée ou par une copie de la base posée sur la machine, d'où rien ne sort.
:::

<span class="puce outil">Outil</span> Les tests de bout en bout refusent de démarrer si la cible est la production.

### TEST-06 · Ne faites pas taire un contrôle rouge

:::tip[Règle]
Un contrôle rouge se comprend, se corrige ou se documente. Les listes de cas connus ne font que baisser : un fichier en sort quand il est corrigé, un nouveau n'y entre jamais.
:::

<span class="puce outil">Outil</span> Les contrôles de la base et des doublons refusent un cas nouveau ou qui grossit.

<span class="puce relecture">Relecture</span> La liste d'exceptions du style n'est pas vérifiée par un script.

## Dire ce qui est vérifié

### TEST-07 · Dites ce que vous n'avez pas vérifié

:::tip[Règle]
Un compte rendu dit ce qui est fait, où (branche, commit), ce qui a été vérifié et comment, ce qui ne l'a pas été par son nom (largeur téléphone, survols, mode sombre, boutons désactivés), ce qui reste, la décision attendue.
:::

**Pourquoi.** Quand un chiffre change à l'écran à cause d'une correction, dites-le avant : de combien, et pourquoi.

<span class="puce relecture">Relecture</span> Aucun outil ne lit un compte rendu.

### TEST-08 · Passez la liste avant de dire « c'est fait »

:::tip[Règle]
Douze points, dans cet ordre.
:::

1. Ce qui existait a été réutilisé, pas réécrit.
2. L'état du dépôt ne montre que les fichiers voulus, ajoutés un par un.
3. Le contenu mis en attente est relu : ni secret, ni fichier d'une autre personne.
4. La compilation, l'analyse et la mise en forme sont à zéro.
5. Les tests ciblés passent, et la règle nouvelle a son test.
6. La règle écrite n'existe nulle part ailleurs ; aucun libellé n'est écrit dans un écran.
7. Le compteur touché égale la liste qu'il ouvre.
8. L'action d'écriture vérifie le droit côté serveur et rend son refus.
9. La migration a été jouée à blanc, l'ancien code marche encore dessus, et elle dit comment elle se défait.
10. Les types de la base sont régénérés.
11. L'écran a été regardé, ou le compte rendu dit qu'il ne l'a pas été.
12. Ce qui change pour l'utilisateur se dit en une phrase.

<span class="puce relecture">Relecture</span> La liste est une consigne, pas un verrou.

## Référence rapide

| Règle | À retenir | Tenue par |
| --- | --- | --- |
| **TEST-01** | Écrivez le test qui échoue sans la règle | Relecture |
| **TEST-02** | Testez le refus | Outil, Relecture |
| **TEST-03** | Lancez les tests ciblés | Relecture |
| **TEST-04** | Prouvez plutôt que regardez | Outil |
| **TEST-05** | Ne testez jamais sur de vraies données | Outil |
| **TEST-06** | Ne faites pas taire un contrôle rouge | Outil, Relecture |
| **TEST-07** | Dites ce que vous n'avez pas vérifié | Relecture |
| **TEST-08** | Passez la liste avant de dire « c'est fait » | Relecture |

## Voir aussi

- [Les tests et les contrôles](/ingenierie/tests/)
