Skip to Content
Meubles Morinière

The code7 min read

Qualité et livraison

Le trajet d’un changement de mon poste jusqu’à la prod, le contrôle qui le vérifie à chaque étape, le risque que chacun couvre, et ce qui n’est pas couvert.

Not translated yet

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

Le projet n’a pas de CI hébergée et pas de preview. J’ai retiré les GitHub Actions parce que leurs minutes étaient facturées (commit 7e12120ae0). Dans .github/, il ne reste que Dependabot, les propriétaires du code et les modèles de tickets. Du coup, les contrôles tournent sur mon poste, et le plus important, c’est le hook pre-push. Un push sur main déploie la prod. Le hook vérifie donc le commit poussé avant qu’il parte.

Dans cette rubrique, tout ce que j’affirme renvoie au fichier qui le prouve. Et je liste aussi ce qui n’existe pas, plus bas.

Le chemin d’un changement

  1. Au commit, le hook pre-commit passe ESLint et Prettier sur les fichiers indexés, puis il cherche les secrets. commit-msg vérifie le message (Contrôles Git).
  2. Avant le push, s’il y a une migration dans le changement, pnpm db:pre-deploy l’applique sur la base de prod, vérifie le résultat et laisse un reçu (Migrations Prisma).
  3. Au push sur main, le hook pre-push rejoue le commit poussé dans un worktree détaché. Il y contrôle les secrets, les dépendances, le client Prisma, les paquets et les jumeaux, les références de la doc, les types, le lint, les tests, la preuve sur Postgres, le poids du site et les variables Vercel. Si un seul contrôle échoue, le commit ne part pas (TypeScript et ESLint, Tests).
  4. Sur Vercel, chaque projet ne fait le build que de main, et il saute le build d’une application que le commit ne touche pas (Déploiement sur Vercel).
  5. En prod, la veille du matin repère les anomalies et envoie les alertes. À chaque passage réussi, elle prévient un témoin externe.
  6. Si on perd des données, on peut restaurer la base à un instant donné chez Neon. On peut aussi faire à la main une copie chiffrée et la restaurer, avec ses vérifications (Sauvegardes et reprise).

En dehors de ce chemin, il y a pnpm validate, qu’on lance à la main. Il passe tous les contrôles statiques et les tests unitaires des paquets, de l’ERP et du site, l’un après l’autre pour ne pas surcharger le poste (validate de package.json). Les tests e2e Playwright et l’évaluation de Fisher se lancent à la main aussi.

Les risques et leurs gardes

RisqueGarde, et où la lireQuand elle tourne
Un commit qui ne compile pas part en prodtsc6 --noEmit, le compilateur de next build, en mode strict, sur le commit poussé (.husky/pre-push, packages/config/tsconfig.base.json)push
Une route parle à Prisma, un module en importe un autreles frontières d’ESLint, à zéro avertissement (packages/config/eslint.mjs)commit, push
Une règle métier régresseVitest sur ce que le push change, plus les suites test/ et regression (.husky/pre-push)push
Une contrainte, un trigger, un droit ou un verrou ne marche plustest:db sur un Postgres local, avec les migrations rejouées (apps/erp/vitest.db.config.ts)push, quand le changement y touche
Le schéma et les migrations divergentdb:check : les migrations rejouées sur une base d’ombre locale vidée, puis comparée au schéma (apps/erp/scripts/local-db.mts)push, quand prisma/ change
Le code part avant sa migrationle push est refusé sans le reçu de db:pre-deploy (.husky/pre-push)push
Une migration retire ce que le code en ligne lit encorela détection des DROP et des RENAME (apps/erp/scripts/lib/destructive-migrations.ts)db:pre-deploy
La base migrée perd une garantiedb:invariants après chaque migration appliquée (apps/erp/scripts/check-db-invariants.mts)db:pre-deploy
Le rôle du site a plus de droits qu’il ne lui en fautses droits comparés au plan (apps/site/scripts/setup-database-role.mts)db:pre-deploy
Un secret quitte le postegitleaks et les règles du projet (.gitleaks.toml)commit s’il est installé, push toujours
Le commit vérifié n’est pas celui qui partworktree détaché, fichier de verrouillage comparé à l’installation (.husky/pre-push)push
Une variable manque en prodcheck:vercel-env, déduit du schéma d’environnement (apps/erp/scripts/check-vercel-env.mts)push
Le JavaScript du site grossitun build et des plafonds (apps/site/scripts/check-bundle-size.mjs)push, quand le bundle du site est touché
Une dépendance compromise ou tout juste publiéele délai et la politique de confiance de pnpm (pnpm-workspace.yaml), les licences refusées (scripts/check-licenses.mjs)installation, pnpm validate
Une panne en prod que personne ne voitla veille du matin et son témoin externe (apps/erp/app/api/veille/route.ts)chaque matin
Une perte de donnéesla restauration à un instant donné chez Neon, une copie chiffrée à la main (apps/erp/scripts/backup-database.mts)à la demande

Ce qui n’est pas couvert

  • Il n’y a pas de pipeline hébergé. Les hooks sont locaux. git push --no-verify les saute, et une fusion faite sur GitHub ne passe pas par eux (le README demande de fusionner en local, puis de pousser). En plus, ils vérifient avec l’installation et l’environnement du poste.
  • Seul main est vérifié. Le hook pre-push laisse passer un push vers une autre branche. Par contre, aucune autre branche ne se déploie (git.deploymentEnabled des vercel.json).
  • Il n’y a pas de preview. La première fois qu’un changement est buildé sur Vercel, c’est en prod.
  • Les tests e2e ne tournent qu’à la main. Aucun hook n’appelle Playwright, et les branches CI de sa configuration (relances, rapport GitHub) ne servent plus à rien.
  • Il n’y a pas de seuil de couverture. pnpm test:coverage mesure, mais il ne refuse rien (coverage de apps/erp/vitest.config.ts).
  • Certains contrôles ne tournent pas au push. Prettier, knip sur les applications, les licences, la doctrine d’interface et la doc ne sont vérifiés que par pnpm validate. Prettier passe aussi au commit, sur les fichiers indexés.
  • Une attestation fait sauter certaines gardes. Avec MIGRATION_JOUEE, TEST_DB_JOUE ou POIDS_JOUE, un push passe sans la garde correspondante. L’attestation est enregistrée, mais rien ne l’empêche (Les attestations).
  • Il n’y a pas de sauvegarde planifiée. Pour revenir en arrière sur la base, je compte sur la restauration à un instant donné de Neon (Sauvegardes et reprise).

La règle de maintenabilité

Tout ce que j’ajoute, il faudra le maintenir à chaque modification. Donc quand je modifie quelque chose, je retire dans le même changement ce qui ne sert plus : du code, un test, une constante, un passage du manuel. Ce que le code sait déjà (un seuil, un libellé, une liste), on ne le recopie pas dans le manuel, dans Fisher ou dans un test. On l’importe ou on le déduit. Un composant qui dépasse environ 600 lignes, on le découpe, et c’est pareil pour un service au-delà de 500. Un commentaire explique pourquoi. L’historique, lui, est déjà dans git. Cette doc suit la même règle. Quand elle a besoin d’un texte du dépôt, elle l’inclut. Et quand elle a besoin d’une valeur, elle cite le symbole de référence.

On this page