Les choix d’ingénierieÉtudes de cas techniques6 min de lecture
Un ERP trop lourd à maintenir
Un ERP de 600 000 lignes, dont la moitié de tests, construit vite avec l’IA. Il grossissait quatre fois plus vite qu’il ne maigrissait. Il n’y a pas eu de grand nettoyage, c’est la règle d’écriture qui a changé.
Le problème
Le 9 novembre 2026, un audit en lecture seule a compté l’ERP (git show b3f1e845d2:docs/allegement-erp.md). Il a trouvé 605 000 lignes de TypeScript, dont 295 000 de code et 302 000 de tests. Ça fait une ligne de test par ligne de code. D’après git log, du 18 octobre, quand l’ERP a déménagé dans apps/erp, au 9 novembre, il avait gagné 331 000 lignes et en avait retiré 131 000, soit 2,5 pour une.
Écrire ne coûtait presque rien. Par contre, garder coûtait de plus en plus cher. L’audit a trouvé trois choses qui pesaient.
- Des textes répétaient le code : 32 chapitres de manuel qui recopiaient 3 825 libellés d’écran, un registre des décisions où 43 des 299 sources
fichier:ligneétaient cassées, et des fichiers jumeaux entre l’ERP et le site. Sur les cinq fichiers de l’ERP les plus retouchés en soixante jours, quatre étaient des chapitres du manuel. - Les tests recopiaient aussi : 2 861 recherches d’éléments par un libellé écrit en dur, et 51 fichiers de tests simulés (31 400 lignes) qui faisaient doublon avec une suite jouée sur une vraie base.
- On ajoutait bien plus vite qu’on ne retirait, avec 15 composants de plus de 800 lignes.
Quand on changeait un libellé, ça cassait un test, un chapitre et une carte du registre. Du coup, tout ce qu’on ajoutait coûtait ensuite à chaque retouche.
Les contraintes
- Je décide seul. Plusieurs chantiers avancent en même temps sur le même poste, et il n’y a pas de CI hébergée (ADR 0010).
- Ce qui protège l’argent, la loi et la sécurité reste : les gardes de la base, les tests de régression, les preuves sur une vraie base.
- Le magasin tourne, donc on ne gèle pas les features le temps d’un chantier.
- Les auteurs suivent ce qui est écrit. Une session d’IA applique les règles de
AGENTS.md. Une habitude qui n’y est pas écrite n’existe pas pour elle.
Les alternatives
- Lancer un grand nettoyage. Il entre en conflit avec les sessions qui travaillent en même temps, il se relit mal, et il ne change pas la façon d’écrire. Donc le poids revient.
- Geler les features jusqu’à ce que le code ait maigri. C’est impossible pour un magasin en activité.
- Ajouter un contrôle pour chaque dérive. Sauf que chaque contrôle, c’est du code à entretenir. L’audit en comptait déjà une série, dont un contrôle de doctrine d’interface de 497 lignes et une vérification de la base de 345 lignes, retouchée 27 fois en soixante jours.
- Changer la règle d’écriture, pour que chaque retouche rembourse un peu au lieu d’emprunter. C’est l’option retenue.
La décision
Le 9 novembre 2026, j’ai ajouté une section « Maintenabilité » dans AGENTS.md. Chaque session la lit :
- Supprimer avant d’ajouter. Une retouche retire dans le même changement ce qu’elle rend inutile : code, test, constante, passage du manuel, carte du registre. Et on étend ce qui existe avant de créer.
- Pas de nouvelle copie à tenir à la main. Ce que le code sait (un seuil, un libellé, une liste, un état), on l’importe ou on le déduit. Une référence vise un symbole (
fichier.ts#SYMBOLE), jamais un numéro de ligne, parce qu’il se décale à chaque modification. - Un test vérifie un comportement, pas un libellé. Il trouve un élément par son rôle, avec un nom importé de la constante du texte.
- Un composant ne dépasse pas environ 600 lignes. Avant d’y ajouter quelque chose, on extrait le bloc qu’on touche (500 pour un service).
- Les commentaires disent pourquoi, pas l’historique. L’historique est dans git.
Le même audit propose une règle pour les contrôles. On n’ajoute un nouveau verrou que s’il protège l’argent, la loi ou la sécurité. Le reste passe par la relecture.
L’implémentation
- L’audit a mesuré en comptant (
find,grep,git log), sans lancer de serveur ni de tests, parce que le poste fait déjà tourner les sessions. - Avant de réduire les copies, on les a rendues vérifiables.
pnpm --filter @meublesmoriniere/erp manual:check(apps/erp/scripts/check-manual.mjs, 11 novembre) échoue sur une section absente du sommaire, un lien ou une ancre cassés, une source citée introuvable, une capture orpheline ou une ancre visée par le code qui n’existe plus. Avec--ui, il liste les libellés du manuel qui ne sont pas dans le code. - Les références mortes sont parties d’un coup. Les citations de documents supprimés (
docs/fisher-*.md) étaient dans 55 fichiers. Le 10 novembre, elles ont été retirées du code, des tests et des scripts. - Les gros composants ont été découpés là où ils se séparaient proprement. Le 12 novembre (
b3f1e845d2), plusieurs sessions ont découpé la création de meuble, la palette ⌘K, le formulaire de devis, les filtres de liste,AdminFormet le brouillon d’achat. Elles ont aussi sorti Prisma et les règles métier des actions, et retiré le code mort que Knip signalait. Ça fait 499 fichiers, 11 218 lignes ajoutées et 9 865 retirées. - Le reste attend la prochaine retouche. On ne découpe pas un fichier juste pour le découper. S’il est trop gros, on le coupe quand on y touche.
Les résultats
Voici le comptage du 13 novembre 2026 sur apps/erp (wc -l, fichiers .ts, .tsx et .mts, tests séparés par leur chemin), quatre jours après l’audit :
| Indicateur | 9 novembre | 13 novembre |
|---|---|---|
| Création de meuble, palette, devis, filtres | 1 922, 1 707, 1 521, 1 370 lignes | 620, 665, 617, 619 lignes |
| Composants de plus de 800 lignes | 15 | 8 |
| Module du registre des décisions, tests compris | 5 405 lignes | 2 181 lignes |
| Lignes ajoutées pour une ligne retirée | 2,5 (18 octobre – 9 novembre) | 1,35 (4 jours) |
| Code de l’application, hors tests | 295 000 lignes | 292 000 lignes |
| Tests | 302 000 lignes | 304 000 lignes |
Le rythme a changé. Maintenant, l’ERP retire presque autant qu’il ajoute, et les fichiers qui coûtaient le plus à chaque retouche ont fondu. Par contre, le volume total n’a pas encore baissé, parce que découper un composant répartit ses lignes sans les supprimer.
Les limites
- Quatre jours, c’est trop tôt pour conclure. Le tableau montre une tendance, pas un résultat acquis.
- Les tests pèsent toujours autant que le code. Il reste à trier, module par module, les 31 400 lignes de tests simulés qui font doublon avec la suite sur base.
- Une règle écrite dépend de celui qui la lit. Une session qui ignore
AGENTS.mdpeut recopier un libellé, et seuls quelques contrôles (lint, jumeaux, manuel) le rattrapent. Au 13 novembre,manual:checkn’était pas encore branché danspnpm check. - Les composants découpés sont juste au-dessus du plafond. À environ 620 lignes, il faudra les recouper à la prochaine retouche.
- Les outils sont les mêmes, mais pas forcément le périmètre. Les chiffres du 9 novembre viennent de l’audit, et ceux du 13 d’un nouveau comptage. On peut comparer les ordres de grandeur, pas les dernières unités.