Les choix d’ingénierie13 min de lecture
Dette, risques et évolutions
Ce qu’on n’a pas construit et pourquoi, la dette qu’on garde en connaissance de cause, les risques qui restent malgré les gardes, et le signal qui ferait changer d’avis.
Les Décisions d’architecture expliquent d’où vient chaque choix et ce qu’il coûte. Ici, je regarde la suite : ce qui peut encore mal tourner, ce qu’il faudrait rembourser, et quel signal le déclencherait. Cette analyse date du 13 novembre 2026. Ce n’est pas une feuille de route : aucune des évolutions ci-dessous n’est décidée, et les chiffres sont ceux de ce jour-là.
Sur cette page, trois mots ont un sens précis :
- Une dette, c’est un raccourci qu’on connaît. On la garde tant que la rembourser coûte plus cher que son intérêt. Son intérêt, c’est ce qu’elle coûte en plus à chaque retouche qui passe par elle.
- Un risque résiduel, c’est ce qui peut encore arriver une fois les gardes en place. Je le décris avec ce qui le limite et ce qui manque. Je ne donne pas de probabilité, parce que le projet n’a pas d’historique d’incidents pour en calculer une.
- Une évolution n’a d’intérêt que si un signal la déclenche. Sans ce signal, on ajoute un service, une configuration ou une liste à maintenir pour un problème qu’on n’a pas.
Ce qu’on n’a pas construit, exprès
Le logiciel sert un magasin, et je le développe seul. À cette échelle, plusieurs briques qu’on s’attend à trouver dans un système de vente coûteraient plus cher à maintenir que ce qu’elles rapportent. Chacune manque pour une raison. Et pour chacune, il y a un seuil à partir duquel s’en passer deviendrait une mauvaise décision.
| Ce qui manque | Ce que ça coûte de s’en passer | Ce qui le rendrait nécessaire |
|---|---|---|
| Une file d’attente durable entre les applications | un événement du site part une seule fois. Si la perte compte, il y a une alerte. Une rétractation perdue est seulement journalisée (Webhooks et échanges) | des pertes répétées dans les journaux, ou d’autres sortes d’événements à livrer |
| Une API devant la base | le site dépend du schéma, et ses droits se mettent à jour à la main, table par table (ADR 0003) | un troisième client de la base, ou un site confié à quelqu’un d’autre |
| Une CI hébergée et des previews | le premier build de l’ERP se fait en prod (le hook ne build que le site, quand son bundle change), et l’e2e ne tourne que si on le lance (ADR 0010) | une deuxième personne qui pousse, ou une régression partie que seul l’e2e aurait vue |
| Un orchestrateur (Turborepo, Nx) | il n’y a pas de cache de tâches : le hook rejoue, en série, tout ce que le changement touche (ADR 0001) | un hook assez long pour qu’on hésite à pousser, ou une quatrième application |
| Un cache de données au navigateur (TanStack Query, SWR) | chaque écran relit le serveur, et Zustand ne garde que l’état de l’interface (toasts, dialogues, palette, sélection) | un écran qui doit marcher hors ligne, ou se mettre à jour sans geste de l’utilisateur |
| Des rôles du personnel | tout compte connecté peut tout faire dans l’ERP. Les gestes qui touchent à l’argent et aux données demandent une connexion récente (ADR 0011) | une personne qui ne doit pas rembourser, exporter ou effacer |
| Un SDK de supervision | un émetteur écrit à la main parle le protocole Sentry (packages/infra/src/collector.ts). Les erreurs arrivent, mais pas les traces de performance | une lenteur qu’on n’arrive pas à situer avec les journaux de Vercel |
| Une seconde région, un second hébergeur | Vercel héberge les trois applications à Paris (cdg1), la tâche du matin, les fichiers et la passerelle IA | une exigence de continuité qui ne tolère plus une panne de l’hébergeur |
| Des feature flags | une feature part pour tout le monde au push qui la livre | une feature à essayer sur une partie des clients, ou à couper sans redéployer |
À chaque fois, le coût se retrouve ailleurs. Sans file, sans CI et sans orchestrateur, la fiabilité repose sur des contrôles locaux et des alertes. Sans API et sans rôles, elle repose sur la base, qui limite ce que le site peut écrire. Et dans tous les cas, on paie la même chose : une discipline écrite (AGENTS.md, le lint, les tests de régression) et une personne pour la faire respecter. C’est le premier risque transverse.
La dette assumée
Le code ne signale pas sa dette. Il n’a aucun commentaire TODO ni FIXME (les noms en _TODO sont des consignes affichées à l’équipe, comme CARRIER_CLAIM_TODO). Donc je la liste ici, et chaque ligne dit ce qui la mesure.
| Dette | Son intérêt | Pourquoi elle reste | Ce qui la rembourserait |
|---|---|---|---|
| Des relais d’une ligne vers les paquets | il y a deux noms pour chaque élément partagé, et quand on cherche une règle, on tombe d’abord sur son relais | ils ont permis de sortir le code sans retoucher les tests. L’audit du 12 novembre n’en trouve que 20 sur 247 qui sont vraiment simulés (Deux applications nées d’un fork) | simuler le paquet lui-même dans les tests, puis retirer les relais module par module |
| Des copies tolérées entre l’ERP et le site | il faut corriger des deux côtés, et le contrôle des jumeaux vérifie que les copies restent identiques | environ 140 fichiers de test simulent le module des toasts, et des formulaires sortis dans un paquet passeraient à côté de cette simulation | sortir les toasts dans un paquet que les tests simulent, puis les formulaires, et vider scripts/twins.manifest.json |
| Des fichiers au-dessus du plafond | un fichier de mille lignes, il faut le relire en entier à chaque retouche, et ses tests aussi | la règle demande de découper seulement ce qu’on touche, et aucun contrôle ne l’impose. 23 composants dépassent 600 lignes (bulk-status-form.tsx, 1 241) ; les services, eux, sont tous repassés sous 500 | une liste d’exceptions qui ne peut que diminuer, comme pour les jumeaux. Comme ça, aucun fichier ne passe le plafond sans qu’on le voie |
| Des tests simulés qui doublent la suite sur base | quand on retouche un service, il faut réécrire ses simulations en plus de ses vrais tests | pour trier, il faut vérifier test par test que la suite sur base protège la même règle. Il reste 31 400 lignes à trier (Un ERP trop lourd à maintenir) | trier module par module, quand on retouche |
| Des textes maintenus à côté du code (manuel, lectures de Fisher, ces pages) | quand un comportement change, une phrase peut rester fausse | Fisher répond d’après le manuel, et cette doc explique ce que le code ne dit pas. manual:check existe, mais aucune porte ne le lance (ni check, ni validate) | brancher manual:check dans pnpm check de l’ERP, et déduire du code tout ce qui peut l’être |
| Des API instables de Next | à chaque montée de version de Next, il faut relire les options expérimentales et les unstable_ (unstable_rethrow revient 54 fois) | instantInsights, le compilateur React en Rust et la relance des erreurs internes de Next (unstable_rethrow) n’existent que sous ces noms (ADR 0007) | rien tant qu’elles ne sont pas stables. Ensuite, un renommage |
| Une configuration écrite pour une CI disparue | faible. Les branches CI de Playwright (relances, rapport GitHub) font croire qu’un pipeline les lit | elles ne coûtent presque rien, et elles resserviraient si une CI revenait | les retirer, ou les rebrancher avec une CI |
Les risques transverses
Les risques liés à une décision sont dans la section « Risques résiduels » de son ADR. Ceux d’ici ne dépendent d’aucune décision en particulier. Ils sont rangés du plus lourd au plus léger. Ce classement est un jugement, parce qu’il n’y a pas d’incidents pour les mesurer.
Tout repose sur une personne et un poste
Il n’y a qu’une personne pour écrire, relire, migrer et restaurer. Les procédures sont écrites (le README, les pages internes), outillées (pnpm db:pre-deploy, pnpm db:restore) et contrôlées. Mais quand on joue une restauration, ça ne laisse pas de trace dans le dépôt (Sauvegardes et reprise). Donc rien ne montre qu’elle a déjà été répétée en entier, et encore moins par quelqu’un d’autre que moi.
La porte avant la prod est sur un poste (ADR 0010), et l’URL directe de la base de prod aussi (ADR 0009). Si je perds ce poste, je ne perds rien : Neon redonne l’URL et Git garde le code. Mais sans lui, il n’y a plus ni contrôle ni migration.
La conformité de la caisse
L’ERP enregistre les règlements des particuliers, et la migration qui chaîne les encaissements cite l’article 286 du CGI. Les garanties techniques sont en place (ADR 0008). L’audit juridique du 18 novembre 2026 a relu la doctrine fiscale sur ce point (reports/Audit juridique 2026-2027.md, BOI-TVA-DECLA-30-10-30). Un logiciel développé en interne est concerné (§ 45). Une entreprise qui développe son logiciel pour elle-même ne peut pas s’attester toute seule : il lui faut le certificat d’un organisme accrédité (§ 375). Et comme le magasin encaisse des espèces, la tolérance des paiements qui passent tous par une banque ne joue pas (§ 35). Il reste donc deux voies : faire certifier la fonction de caisse de l’ERP, ou confier l’enregistrement des règlements à un logiciel de caisse certifié. Ce choix n’est pas fait. La question a été renvoyée à l’expert-comptable le 23 août 2026, et sa réponse n’est pas dans le dépôt. C’est le seul risque de cette page que le code ne peut pas réduire.
Tout dépend de quelques fournisseurs
Vercel héberge les trois applications dans une seule région, plus la tâche du matin, les fichiers et la passerelle IA. Neon a la base et la seule copie automatique. Si Vercel tombe, le site et l’ERP s’arrêtent, la vente au magasin aussi. Et si Neon perd la base, sa seule copie automatique part avec. Une chose limite les dégâts : quand aucun modèle n’est disponible, les formulaires de Fisher repassent en saisie à la main (ADR 0012). Ce qui manque, c’est un mode hors ligne et une copie hors de Neon qui se fasse toute seule.
Des gardes qui laissent passer quand elles tombent
Deux gardes laissent passer quand elles tombent, elles ne bloquent pas :
- Au magasin, la garde qui empêche d’enregistrer deux fois une vente ou un encaissement est dans Redis. Si Redis manque ou ne répond pas, l’envoi passe sans elle, et le journal le dit (
apps/erp/shared/server/idempotency.ts). Bloquer la caisse parce qu’un cache est tombé, ce serait pire. Sauf qu’un encaissement ne s’efface pas, et un doublon ne se corrige qu’avec une nouvelle écriture. git push --no-verifysaute les contrôles du poste, et une fusion faite sur GitHub ne passe pas par eux. Les attestations (MIGRATION_JOUEE,TEST_DB_JOUE,POIDS_JOUE) sont consignées, mais rien ne les empêche (Ce qui n’est pas couvert).
Une détection au rythme d’une veille par jour
Les échecs qui comptent déclenchent une alerte tout de suite, et le collecteur reçoit les erreurs du serveur et du navigateur. Par contre, il y a des choses que seule la veille relit : les chaînes d’encaissement, les paiements jamais confirmés, les commandes payées sans facture. Celles-là attendent son passage, chaque matin à 6 h UTC (crons de apps/erp/vercel.json). Donc une anomalie silencieuse peut rester près d’un jour sans que personne la voie. Un témoin externe signale une veille qui ne passe pas, mais ça ne raccourcit pas ce délai (Une veille qui dit ce qu’elle n’a pas pu lire).
Les évolutions, rangées par leur signal
Le détail de chaque évolution est dans la section « Quand la revoir » de l’ADR qu’elle toucherait. Ici, je les range selon leur signal : il est déjà là, il viendra au premier incident, ou il dépend d’un changement de contexte.
Pour celles-ci, le signal est déjà là :
- Copier la base hors de Neon automatiquement. L’ADR 0008 compte sur une copie gardée ailleurs pour repérer une chaîne réécrite, et l’ADR 0009 constate qu’aucune copie ne se fait toute seule. L’outil existe, il est testé, et il refuse de s’installer sans ses secrets (
pnpm backup:schedule). J’ai écarté la copie automatique le 6 novembre (ceae67825b). Ces deux décisions tirent dans des sens différents, et c’est à moi de trancher. - Brancher
manual:check. Le contrôle existe, il manque juste une porte pour le lancer.
Celles-ci attendent le premier incident :
- Essayer chaque migration sur une branche Neon tirée de la prod, dès le premier échec de
prisma migrate deploysur des données réelles, ou avant la première migration qui réécrit une table entière (ADR 0009). - Mettre une clé d’idempotence en base pour les encaissements, dès la première ligne « garde du double envoi indisponible » dans les journaux de prod. Une contrainte d’unicité, elle, ne tombe pas avec Redis.
- Contrôler le plafond de taille, dès qu’une retouche fait grossir un fichier déjà au-dessus.
Celles-ci dépendent d’un changement de contexte :
- Avec une deuxième personne, il faudrait une CI hébergée minimale, des previews et des rôles (ADR 0010, ADR 0011).
- Avec un troisième client de la base, ou un deuxième canal de vente, il faudrait une API de l’ERP à la place des droits par colonne et des secrets partagés entre les deux applications (ADR 0003, ADR 0004).
- Pour vendre hors de la zone euro, il faudrait un champ de devise sur chaque montant, donc une migration de tout le schéma de l’argent (ADR 0008).
Comment cette page reste vraie
- Chaque ligne donne le fichier, la commande ou la page qui la mesure. Les chiffres datent du 13 novembre 2026, et on peut les recompter depuis le dépôt.
- Quand une dette est remboursée, un risque couvert ou une évolution faite, elle sort de cette page dans le même commit. C’est la règle de maintenabilité.
- L’ordre des risques est un jugement. Ce n’est pas une mesure.