Aller au contenu
Meubles Morinière

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 manqueCe que ça coûte de s’en passerCe qui le rendrait nécessaire
Une file d’attente durable entre les applicationsun é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 basele 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 previewsle 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 personneltout 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 supervisionun émetteur écrit à la main parle le protocole Sentry (packages/infra/src/collector.ts). Les erreurs arrivent, mais pas les traces de performanceune lenteur qu’on n’arrive pas à situer avec les journaux de Vercel
Une seconde région, un second hébergeurVercel héberge les trois applications à Paris (cdg1), la tâche du matin, les fichiers et la passerelle IAune exigence de continuité qui ne tolère plus une panne de l’hébergeur
Des feature flagsune feature part pour tout le monde au push qui la livreune 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.

DetteSon intérêtPourquoi elle resteCe qui la rembourserait
Des relais d’une ligne vers les paquetsil y a deux noms pour chaque élément partagé, et quand on cherche une règle, on tombe d’abord sur son relaisils 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 siteil faut corriger des deux côtés, et le contrôle des jumeaux vérifie que les copies restent identiquesenviron 140 fichiers de test simulent le module des toasts, et des formulaires sortis dans un paquet passeraient à côté de cette simulationsortir les toasts dans un paquet que les tests simulent, puis les formulaires, et vider scripts/twins.manifest.json
Des fichiers au-dessus du plafondun fichier de mille lignes, il faut le relire en entier à chaque retouche, et ses tests aussila 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 500une 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 basequand on retouche un service, il faut réécrire ses simulations en plus de ses vrais testspour 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 fausseFisher 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 disparuefaible. Les branches CI de Playwright (relances, rapport GitHub) font croire qu’un pipeline les litelles ne coûtent presque rien, et elles resserviraient si une CI revenaitles 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-verify saute 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 deploy sur 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.

Sur cette page