Skip to Content
Meubles Morinière

The codeQualité et livraison(in French)4 min read

Tests

Vitest en unitaire et sur une vraie base Postgres, Playwright pour les tests e2e avec un contrôle d’accessibilité, l’évaluation de Fisher, et ce qui tourne au push.

Not translated yet

This page is shown in its original French. Code excerpts, tests and figures read the same in either language.

Il y a trois niveaux de tests, plus l’évaluation de Fisher. Chaque niveau vérifie ce que le précédent ne peut pas voir. Et chacun refuse de tourner là où il pourrait faire des dégâts.

Vitest, en unitaire

Un test est dans un dossier __tests__/, à côté du fichier qu’il teste. C’est pareil pour les routes. Le dossier test/ de chaque application contient les tests transversaux, dont les *.regression.test.ts. Ceux-là figent un bug corrigé ou une garantie qui est dans le code. Par exemple, apps/erp/test/main-push-guard.regression.test.ts lit le hook pre-push et vérifie que ses gardes y sont toujours.

La configuration de l’ERP (apps/erp/vitest.config.ts) découpe la suite en trois projets :

  • node, pour la logique et les services.
  • jsdom, pour les composants (*.test.tsx) et les quelques tests qui ont besoin du DOM (DOM_TESTS).
  • horloge-hostile, qui lance les calculs d’exercice comptable dans un processus à part, avec un fuseau horaire loin de Paris (HOSTILE_CLOCK_TIME_ZONE). Si un calcul de date dépend du fuseau du serveur, il échoue ici, avant de se tromper en prod.

clearMocks, restoreMocks, unstubEnvs et unstubGlobals remettent tout à zéro entre deux tests. Et maxWorkers: "50%" laisse la moitié des cœurs au reste du poste.

Les outils de livraison ont leurs tests aussi (apps/erp/scripts/lib/__tests__) : le registre des migrations, la détection des migrations destructives, les invariants de la base, le chiffrement et la rétention des sauvegardes, la cible et la vérification d’une restauration, les règles du pare-feu.

Sur une vraie base Postgres

Il y a des choses qu’on ne peut vérifier que sur un vrai Postgres : les contraintes, les triggers, les verrous, la concurrence (apps/erp/test/db/concurrence.db.test.ts) et les droits du rôle du site (apps/site/test/db/site-database-role.db.test.ts). Cette suite a sa propre configuration (vitest.db.config.ts, dans chaque application). Elle passe un fichier à la fois (fileParallelism: false) et elle utilise de faux secrets. Comme ça, rien ne part vers un vrai service.

Elle écrit en base et elle consomme des numéros de facture. Sauf que cette série ne doit pas avoir de trou. Du coup, elle refuse de démarrer sans DB_BEHAVIOUR_TESTS=1, ou sur une base qui n’est pas celle de la machine locale (behaviourSuiteRefusal, packages/testing/src/behaviour-database-target.ts).

Playwright, les tests e2e

Les tests e2e de l’ERP (apps/erp/playwright.config.ts) tournent sur le build de prod (pnpm build && pnpm start), en français, à l’heure de Paris et sur plusieurs appareils :

  • Un Chrome de bureau et un iPhone pour tout. L’iPhone en mode paysage pour les écrans de l’ERP, une tablette et un bureau étroit pour les captures.
  • Le tunnel de paiement est dans un projet à part, répété sans relance (repeatEach, retries: 0). Un test instable s’y voit tout de suite, parce qu’il ne peut pas passer par chance.
  • La connexion par TOTP ou par clé d’accès est dans un projet à part, sans parallélisme interne. La déconnexion passe après tous les autres projets (dependencies).

Les services externes sont remplacés par des doubles (e2e/support/doubles-server.ts, pour Resend et Blob). Donc aucun e-mail et aucun fichier ne sort. Avant le build, e2e/support/database-guard.ts refuse une DATABASE_URL qui ne pointe pas vers une base locale (e2eDatabaseRefusal). Quand un test échoue, on garde sa capture et sa vidéo. La trace, elle, n’est enregistrée qu’à une relance, et il n’y a pas de relance en dehors du mode CI.

Les pages visitées passent un contrôle axe (analyzeConsole, packages/testing/src/axe.ts) avec les critères WCAG de AXE_TAGS. Le contrôle attend la fin des animations. Sinon, il trouverait trop pâle un texte en plein fondu.

Le site a ses propres tests e2e (apps/site/playwright.config.ts), sur Chrome et iPhone, plus Android et Firefox pour les tests marqués @pwa.

L’évaluation de Fisher

pnpm ai:eval et ai:eval:chat rejouent des lectures et des conversations de référence, puis leur donnent une note (apps/erp/scripts/ai-eval*.mts, scripts/lib/ai-eval-score.ts). Je la lance à la main. Ce qu’elle vérifie est décrit dans Fisher.

Ce qui tourne au push

Pour l’ERP puis pour le site, le hook pre-push lance dans le worktree du commit poussé :

  • vitest run --changed <main distant>, c’est-à-dire les tests qui dépendent d’un fichier modifié depuis le main distant.
  • vitest run test/ regression, les tests transversaux et de régression, à chaque push.
  • test:db de l’ERP et du site, après prisma migrate deploy sur la base locale, quand le push touche du code qui parle à la base (la liste db_guarded du hook).

La suite unitaire complète ne tourne qu’avec pnpm test:run ou pnpm validate. Playwright, la couverture et l’évaluation, il faut toujours les lancer à la main.

Ce qu’un test vérifie

Un test vérifie un comportement : une règle, un calcul, un refus. Il ne vérifie pas un libellé. Il retrouve un élément par son rôle, avec un nom importé depuis la constante du texte, sans le recopier. Et pour un nouveau cas, on étend un test existant, on n’ouvre pas un nouveau fichier.

On this page