Le code7 min de lecture
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.
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
- Au commit, le hook
pre-commitpasse ESLint et Prettier sur les fichiers indexés, puis il cherche les secrets.commit-msgvérifie le message (Contrôles Git). - Avant le push, s’il y a une migration dans le changement,
pnpm db:pre-deployl’applique sur la base de prod, vérifie le résultat et laisse un reçu (Migrations Prisma). - Au push sur
main, le hookpre-pushrejoue 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). - 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). - 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.
- 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
| Risque | Garde, et où la lire | Quand elle tourne |
|---|---|---|
| Un commit qui ne compile pas part en prod | tsc6 --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 autre | les frontières d’ESLint, à zéro avertissement (packages/config/eslint.mjs) | commit, push |
| Une règle métier régresse | Vitest 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 plus | test: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 divergent | db: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 migration | le 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 encore | la détection des DROP et des RENAME (apps/erp/scripts/lib/destructive-migrations.ts) | db:pre-deploy |
| La base migrée perd une garantie | db: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 faut | ses droits comparés au plan (apps/site/scripts/setup-database-role.mts) | db:pre-deploy |
| Un secret quitte le poste | gitleaks et les règles du projet (.gitleaks.toml) | commit s’il est installé, push toujours |
| Le commit vérifié n’est pas celui qui part | worktree détaché, fichier de verrouillage comparé à l’installation (.husky/pre-push) | push |
| Une variable manque en prod | check:vercel-env, déduit du schéma d’environnement (apps/erp/scripts/check-vercel-env.mts) | push |
| Le JavaScript du site grossit | un 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ée | le 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 voit | la veille du matin et son témoin externe (apps/erp/app/api/veille/route.ts) | chaque matin |
| Une perte de données | la 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-verifyles 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
mainest vérifié. Le hookpre-pushlaisse passer un push vers une autre branche. Par contre, aucune autre branche ne se déploie (git.deploymentEnableddesvercel.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
CIde sa configuration (relances, rapport GitHub) ne servent plus à rien. - Il n’y a pas de seuil de couverture.
pnpm test:coveragemesure, mais il ne refuse rien (coveragedeapps/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_JOUEouPOIDS_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.
- TypeScript et ESLintLes options du compilateur et ce qu’elles empêchent, les règles de lint qui transforment une faute d’architecture en erreur, les autres contrôles statiques, et le moment où chacun tourne.
- TestsVitest 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.
- Contrôles GitLes hooks du commit et du push, le contrôle qui vérifie chaque commit envoyé en prod, les attestations pour pousser sans une garde, et ce que GitHub et pnpm ajoutent.
- Migrations PrismaPourquoi une migration part avant le code, le seul chemin vers la base de prod et ce qu’il refuse, et comment on retire une colonne en deux temps.
- Déploiement sur VercelTrois projets Vercel qui ne déploient que main, ce qui lance ou saute un build, ce qui est vérifié avant, ce qui surveille la prod après, et comment revenir en arrière.
- Sauvegardes et repriseCe qui protège vraiment les données aujourd’hui, la copie chiffrée et sa restauration vérifiée, la planification prête mais pas activée, et ce qui reste exposé.