Aller au contenu
Meubles Morinière

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

0001 · Un monorepo, des paquets en source

Les applications et le code qu’elles partagent sont dans un seul dépôt pnpm. Les paquets n’ont pas de build et pas de version.

Statut : acceptée · Décidée : 17 octobre 2026, complétée jusqu’au 13 novembre · Sources : d30dfaebac (PR #111), 90ccdfd846, a29008ebfa, 7703182e16

Contexte

Le dépôt est né le 23 août 2026, avec une seule application Next.js. C’était une boutique, et son administration est devenue l’ERP. Le 17 octobre, l’application passe dans apps/erp, le schéma Prisma dans packages/db, et un premier site public arrive dans apps/site (PR #111). Les paquets suivent : domain le même jour, auth, contracts, ui et config le 18 octobre, infra et orders le 7 novembre, testing le 9. La doc (apps/docs) arrive le 13 novembre.

Contraintes

  • L’ERP et le site lisent le même schéma, et ils doivent appliquer les mêmes règles sur l’argent.
  • Je suis le seul développeur, et je fais avancer plusieurs chantiers en même temps sur le même arbre, avec l’IA.
  • Les contrôles tournent sur mon poste. Il n’y a pas de CI (ADR 0010).

Alternatives

  • Avec un dépôt par application, un changement de schéma ou de contrat serait coupé en deux commits. Et aucun outil ne vérifie l’ordre dans lequel on les déploie.
  • Avec des paquets construits et versionnés (dist, registre privé), il y aurait un build de plus à attendre, et des versions internes à aligner entre les applications.
  • Un orchestrateur de tâches (Turborepo, Nx) apporterait un cache de build et un graphe de tâches. Rien ne dit qu’on l’a étudié.

Décision

Tout est dans un dépôt pnpm : apps/* pour ce qui se déploie, packages/* pour ce qui se partage. Les dépendances vont dans un seul sens : d’une application vers un paquet, et d’un paquet vers un paquet plus bas. Les exports d’un paquet pointent sur ses fichiers TypeScript, et Next les compile avec l’application qui l’importe. Les versions communes s’écrivent une fois, dans le catalogue de pnpm-workspace.yaml. Et les scripts de la racine délèguent avec pnpm --filter.

Raisons

Confirmées

  • Le schéma passe dans un paquet pour que l’ERP et le site puissent l’importer tous les deux. La PR #111 crée packages/db, avec un site qui ne fait que lire. Elle sort aussi formatEuro dans packages/domain, pour qu’il n’y ait « plus de copie dans le site » (d30dfaebac).
  • Le code commun sort des applications pour qu’on arrête de le recopier : « Code identique dans les deux apps : 144 fichiers → 31 » (a29008ebfa).

Hypothèses

  • Avec des paquets en source, on évite un build et un processus de surveillance. Aucune décision datée ne le dit. C’est la raison que donne après coup Paquets partagés.
  • Il n’y a pas besoin d’orchestrateur. Avec trois applications et des contrôles lancés en série sur un poste, pnpm --filter suffit.

Compromis

  • L’installation tire les dépendances des trois applications, même si on veut juste retoucher la doc.
  • Chaque application recompile les paquets qu’elle importe. Un paquet doit donc compiler avec les réglages TypeScript de chacune (le tsconfig strict de packages/config).
  • Un paquet ne peut pas servir en dehors de ce dépôt.
  • L’ignoreCommand de chaque projet Vercel compare son application et tout packages/. Du coup, quand on retouche un paquet, les trois projets sont reconstruits, même celui qui ne l’importe pas.

Conséquences

  • Un même commit change le schéma, le contrat et les deux côtés. Le hook pre-push vérifie les deux applications sur ce commit.
  • Le contrôle des jumeaux peut comparer l’ERP et le site, parce qu’ils sont dans le même arbre (ADR 0005).
  • pnpm packages:check lance le typage, le lint, les tests et knip sur les paquets. Le graphe des dépendances est dans Architecture.

Risques résiduels

  • Une erreur dans un paquet part dans toutes les applications au même push. Rien ne déploie l’une avant l’autre. La seule barrière, ce sont les tests des deux applications, que le hook lance sur ce commit.
  • Une version commune lie les applications. Si une montée de Next ou de React en casse une, les autres sont bloquées aussi (ADR 0014).

Quand la revoir

  • Un orchestrateur (Turborepo, Nx) servirait le jour où le hook pre-push durerait assez longtemps pour qu’on hésite à pousser, ou le jour où une quatrième application arriverait. Son cache ne relancerait que ce que le commit change.
  • Les paquets seraient construits et versionnés le jour où l’un d’eux devrait servir en dehors de ce dépôt.
  • Un deuxième dépôt ne servirait que pour une application qui ne partagerait ni la base ni les règles sur l’argent. Il n’y en a pas. Même la doc lit le dépôt au build.

Sur cette page