Aller au contenu
Meubles Morinière

Les choix d’ingénierieDécisions d’architecture3 min de lecture

0006 · Le lint garde les frontières du code

Les couches, l’isolement des modules et l’accès à la base sont vérifiés par ESLint. Si on franchit une frontière, c’est une erreur, et plus une simple consigne.

Statut : acceptée · Décidée : 23 août 2026 (arborescence modules/ et shared/), étendue depuis · Sources : f57b18eb97, 9086def499, b3f1e845d2, packages/config/eslint.mjs, apps/erp/AGENTS.md, apps/site/AGENTS.md

Contexte

Depuis le premier jour, le code est rangé en modules/ (un domaine par dossier) et shared/, avec une règle : « un module importe shared/, jamais un autre module » (f57b18eb97). Aujourd’hui, l’ERP compte plusieurs dizaines de modules, et plusieurs sessions y écrivent en parallèle.

Contraintes

  • On doit pouvoir retirer un module sans chercher qui l’importe.
  • Prisma ne doit être appelé que là où la session est vérifiée et où les règles sont appliquées.
  • Le code serveur ne doit jamais partir dans le navigateur.

Alternatives

  • Des consignes et de la relecture. La règle se perd à la première retouche faite dans l’urgence.
  • Un paquet par module. Ses exports imposeraient les frontières, mais il faudrait un package.json et un câblage par module.
  • Un outil dédié (dependency-cruiser, les règles de frontières de Nx). Ça ferait un outil de plus. Rien ne dit qu’on l’a étudié.

Décision

Chaque application a trois couches : app/ compose, modules/ porte un domaine, et shared/ contient ce qui sert à plusieurs. Dans un module, chaque couche a son rôle : actions/, services/, data/, lib/, schemas/, components/ (Rangement du code). La fabrique ESLint commune (packages/config/eslint.mjs) refuse un import de shared/ vers un module, d’un module vers app/, et d’un module de l’ERP vers un autre. Elle refuse aussi Prisma dans app/. L’ERP étend ce refus aux actions/, components/ et lib/ de ses modules (apps/erp/eslint.config.mjs). Le site ne l’étend pas, et ses actions parlent encore à Prisma. Dans le site, un module n’importe que les couches qui viennent avant la sienne (MODULE_LAYERS, apps/site/eslint.config.mjs). Les points d’entrée serveur (le câblage de Prisma et de l’authentification, les services) commencent par import "server-only".

Raisons

Confirmées

  • Une règle qui doit durer doit être dans le code ou dans un test. Un document ne suffit pas. C’est ce qui est sorti du retrait du journal des décisions et de docs/, que j’ai décidé les 1er et 5 septembre 2026 (9086def499).
  • Une action ne porte « ni Prisma, ni règle métier », et on n’ajoute pas de couche qui ne fait que passer l’appel (apps/erp/AGENTS.md). Le 12 novembre, les dernières actions qui lisaient Prisma sont passées par leur service (b3f1e845d2).

Hypothèses

  • Les modules de l’ERP sont isolés pour qu’on puisse en retirer un d’un seul geste. La règle le permet, et l’allègement de novembre l’a fait. Mais aucune décision ne le dit comme ça.

Compromis

  • shared/ grossit. Ce que deux modules partagent doit y descendre, ou alors c’est l’ERP lui-même qui le fournit, comme les créateurs de référentiels (ConsoleReferentialCreators, 90ccdfd846).
  • Les couches des modules du site sont dans une liste écrite à la main (MODULE_LAYERS).
  • Un geste simple passe par une couche de plus : l’action, le service, puis la lecture.

Conséquences

  • Une frontière franchie fait échouer le lint, sur mon poste comme au push, avec un message qui dit laquelle (Rangement du code).
  • Si un composant client importe un fichier serveur, le build échoue. Le fichier ne part pas dans le navigateur.
  • Chaque couche se teste en simulant la suivante par son chemin. Ça sert aussi l’ADR 0005.

Risques résiduels

  • shared/ sert de soupape. Ce que deux modules partagent y descend, et rien ne mesure sa croissance. Un module peut donc en atteindre un autre par ce détour, sans que le lint le voie.
  • On peut lever une frontière avec un eslint-disable. Aujourd’hui il n’y en a pas, mais rien ne l’empêche, et seule la relecture le verrait.

Quand la revoir

  • Un outil dédié (dependency-cruiser) servirait le jour où les motifs d’ESLint ne suffiraient plus pour exprimer une frontière, ou si on voulait lire le graphe des modules plutôt que ses refus.
  • Il faudrait un paquet par domaine si shared/ devenait le chemin habituel entre deux modules. Ce serait le signe que leur découpage n’est plus le bon, et que des exports explicites vaudraient leur câblage.

Sur cette page