Skip to Content
Meubles Morinière

Engineering choicesDécisions d’architecture(in French)3 min read

0005 · Le code commun sort du fork sans casser les tests

L’application câble ses paquets, des relais gardent le chemin d’origine, et un contrôle empêche deux copies d’une même règle de diverger.

Not translated yet

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

Statut : acceptée · Décidée : 18 octobre 2026 (contrôle des jumeaux), 7 et 9 novembre (sortie dans les paquets) · Sources : 90ccdfd846, dd2a27b932, a29008ebfa, README.md (« Le code commun vit dans packages/ »)

Contexte

Le site est né d’une copie de l’ERP (ADR 0002). Le 9 novembre 2026, le contrôle des jumeaux surveillait encore 191 fichiers identiques et 83 écarts entre les deux applications (a29008ebfa).

Contraintes

  • Les tests de chaque application simulent un fichier par son chemin (vi.mock("@/shared/server/email")). Si un paquet importait lui-même l’e-mail, Prisma ou l’alerte, il échapperait à ces simulations. Ses effets partiraient pour de vrai pendant les tests, ou ne seraient plus vérifiés.
  • Plusieurs sessions retouchent le dépôt en parallèle. Une règle écrite quelque part ne suffit pas.

Alternatives

  • Tout sortir d’un coup. C’était impossible sans réécrire une grande partie des tests.
  • Garder des copies et compter sur la relecture. Rien ne signalerait une règle corrigée d’un seul côté.
  • Des paquets qui importent leurs dépendances (env, prisma, e-mail). Ce serait plus direct, mais les simulations des applications ne les atteindraient plus.

Décision

  1. Un traitement commun, c’est une fabrique qui reçoit ses briques de l’application (createEmailSender, createWithdrawalNotices, createAuth). env, prisma et alert restent dans chaque application (Un câblage, des ports).
  2. Chaque application garde un relais : un fichier d’une ligne, au chemin que ses imports et ses simulations visent déjà. La règle moriniere/prefer-relay oblige à passer par lui.
  3. Un contrôle des jumeaux, pnpm check:twins (scripts/check-twins.mjs), refuse deux choses : un fichier identique des deux côtés s’il n’est pas dans une liste qui ne peut que diminuer, et une déclaration commune qui diverge. Il tourne dans le hook pre-push.

Raisons

Confirmées

  • Les relais préservent les tests : le code sort « au chemin que ses imports et ses vi.mock visent déjà » (a29008ebfa).
  • Les fabriques suivent le README : « Un paquet n’importe jamais directement une brique qu’un test de l’app simule : un vi.mock de l’app atteint ainsi toujours son code » (README.md).
  • Les formulaires restent des jumeaux, parce que environ 140 fichiers de test mockent @/shared/lib/toast (README.md).

Hypothèses

  • Les fabriques suffisent, sans conteneur d’injection de dépendances, parce que seuls quelques traitements traversent les applications. Rien ne montre qu’on a envisagé un conteneur.

Compromis

  • Chaque élément partagé a deux noms, et quand on cherche une règle, on tombe d’abord sur son relais. L’audit de rangement du 12 novembre a relevé que peu de relais sont vraiment simulés. Il propose de simuler directement le paquet (Deux applications nées d’un fork).
  • Il faut une fabrique, et un fichier de câblage par traitement dans chaque application.
  • Le contrôle ne compare que des fichiers rangés au même chemin, ou appariés (SITE_RENAMES). Un code recopié sous un autre nom lui échappe.

Conséquences

  • Le code identique dans les deux applications est passé de 144 fichiers à 31 le 9 novembre (a29008ebfa).
  • Une règle de calcul corrigée d’un seul côté est refusée au push.
  • Un paquet se teste sans environnement. Et chaque application garde un seul env, un seul prisma et une seule alert.

Risques résiduels

  • Une règle recopiée sous un autre nom diverge sans que personne le voie. Le contrôle ne compare que des chemins identiques ou appariés. Contre ça, il n’y a que la règle du README (un code commun sort dans un paquet) et la relecture.
  • La liste des copies tolérées ne peut pas grossir, mais rien ne la fait diminuer non plus. Elle baisse quand quelqu’un sort un fichier. Sinon elle ne bouge pas, et chaque copie continue de coûter.

Quand la revoir

  • On peut retirer les relais. L’audit du 12 novembre propose de simuler le paquet lui-même, puisque peu de relais sont vraiment simulés. Le signal est là. Il reste à faire le travail, module par module (Dette, risques et évolutions).
  • Le jour où sa liste sera vide, le contrôle des jumeaux se réduira à refuser toute copie.
  • Un conteneur d’injection ne servirait que si les fabriques devenaient assez nombreuses pour que le câblage de chaque application pèse plus lourd que lui.

On this page