Aller au contenu
Meubles Morinière

Le code7 min de lecture

Architecture

Le monorepo, ses applications Next.js et ses paquets : ce qui appartient à chacun, qui dépend de qui, qui parle à qui en prod, et où tout est hébergé.

Le dépôt, c’est un monorepo pnpm avec trois applications Next.js et les paquets qu’elles partagent. La règle est simple : les dépendances descendent. Une application importe des paquets, un paquet importe un paquet plus bas, et jamais dans l’autre sens. Une application assemble et s’exécute. Un paquet contient ce que les applications doivent dire ou calculer de la même façon. Pourquoi cette forme et ce qu’elle coûte, c’est expliqué décision par décision dans les Décisions d’architecture, avec les sources, les alternatives et ce qui reste supposé. Ce qu’on n’a pas construit, la dette assumée et les risques qui restent sont dans Dette, risques et évolutions.

Carte du dépôt

CheminRôlePort local
apps/erpERP de l'atelier : catalogue, commandes, devis, comptabilité, webhook Stripe, veille quotidienne3000
apps/siteSite public : catalogue, panier, paiement, suivi de commande, devis, compte client (ARCHITECTURE.md)3001
apps/docsDocumentation technique, en français et en anglais (Fumadocs) : architecture, ERP, site, logique métier, sécurité, qualité3002
packages/dbSchéma Prisma, migrations et client généré (@meublesmoriniere/db)
packages/domainRègles métier communes : TVA, prix, remises, port, totaux, numéros de pièce, délais et date promise, horaires, identité légale, textes de la rétractation (@meublesmoriniere/domain)
packages/authBetter Auth : comptes du personnel (ERP) et comptes clients (site), rôles, limites de débit (@meublesmoriniere/auth)
packages/uiKit d'interface commun aux deux apps (@meublesmoriniere/ui)
packages/contractsCe que les deux apps doivent dire pareil : routes publiques, chemins machine, tags de cache, Stripe, et le contrat HTTP de leurs échanges (corps, signature)
packages/infraBriques techniques : journaux, collecteur d'erreurs, traces, envoi d'e-mail (fabrique), e-mail d'alerte, adaptateur et arrêt de Prisma, comparaison à temps constant (@meublesmoriniere/infra)
packages/ordersTraitements de commande que les deux apps exécutent pareil, sur des ports qu'elles fournissent : la rétractation, l'annulation d'une commande en attente (@meublesmoriniere/orders)
packages/testingOutillage de test des deux apps : fixtures de la suite Postgres, doubles et contrôle axe des e2e, gardes de base locale (@meublesmoriniere/testing)
packages/configtsconfig de base, fabriques ESLint, motifs .gitignore (@meublesmoriniere/config)

Node 24, pnpm 10. Le schéma et les migrations vivent dans packages/db/prisma ; seul l'ERP les joue (pnpm db:migrate, pnpm db:pre-deploy). Le client Prisma se génère au pnpm install (postinstall de packages/db) ou par pnpm db:generate.

Les versions des dépendances communes vivent une seule fois, dans le catalog: de pnpm-workspace.yaml. Une version publiée depuis moins de 24 heures est refusée (minimumReleaseAge) ; une exception se déclare dans minimumReleaseAgeExclude.

packages/domain n'ouvre aucune connexion et ne lit ni le réseau ni les variables d'environnement : ses deux lectures communes (grille de port, stock libre au paiement) reçoivent le client Prisma de l'app. Un texte qui dépend de l'app (l'adresse du site dans la signature des e-mails) s'y passe en paramètre, et l'envoi d'un e-mail ou l'écriture en base restent dans l'app. Il ne dépend que de zod et de packages/db : ses enums, et les types Prisma des quelques formes de requête que les deux apps doivent lire pareil (BUYABLE_VARIANT_WHERE, grille de port, accueil). packages/ui ne dépend d'aucune app : les fichiers shared/components/ui/*.tsx des apps le réexportent, et app/globals.css déclare @source "../../../packages/ui/src" pour que Tailwind en lise les classes.

Qui dépend de qui

Les espaces de travail du monorepo et leurs dépendanceserp dépend de auth, contracts, db, domain, infra, orders, ui. En développement, erp dépend aussi de testing. site dépend de auth, contracts, db, domain, infra, orders, ui. En développement, site dépend aussi de testing. docs dépend de infra, ui. domain dépend de db. orders dépend de db, domain, infra. testing dépend de db, domain, infra. ui dépend de domain, infra. config — devDependency des 11 autres espaces : eslint, gitignore-globs, tsconfig.base.json.erpapps/erpsiteapps/sitedocsapps/docsauth9 entréescontracts9 entréesdb2 entréesdomain68 entréesinfra27 entréesorders2 entréestesting6 entréesui65 entréesconfigdevDependency des 11 autres espaces : eslint, gitignore-globs, tsconfig.base.json
Lu dans le package.json de chaque espace à chaque build de cette documentation. Trait plein : dependencies ; tirets : devDependencies ; à l’encre pleine : une application. Survoler un espace isole ses flèches.
  • Aucune application ne dépend d’une autre. L’ERP et le site ne s’importent pas. Ils partagent des paquets et une base. Pour ce qui ne doit appartenir qu’à l’un des deux, ils passent par HTTP (plus bas). Et aucun paquet ne dépend d’une application.
  • db, infra, contracts et auth ne dépendent d’aucun autre paquet. db contient le schéma et le client Prisma, infra l’outillage technique, contracts ce que les deux applications s’échangent, et auth l’authentification. auth ne dépend même pas de db, parce que chaque application lui passe son client Prisma.
  • domain ne dépend que de db, pour ses énumérations et ses types. Il n’ouvre aucune connexion et ne lit ni le réseau ni l’environnement. Ses deux lectures communes, la grille de port (shipping-grid-read.ts) et le stock libre au paiement (stock-reservation.ts), reçoivent le client Prisma de l’application.
  • ui, orders et testing assemblent les précédents. Le kit d’interface reprend les types de prix de domain. La rétractation enchaîne des règles de domain et des briques d’infra. Et l’outillage de test prépare une base avec db.
  • La doc ne prend que ui et infra, pour la palette de la marque et les en-têtes de sécurité. Elle n’a ni base ni secret.

Le détail de ce que chaque paquet contient et de ce qu’il s’interdit est dans Paquets partagés.

Ce qui appartient à chaque application

ApplicationCe qu’elle faitCe qu’elle est seule à avoir, ou ce qu’elle ne peut pas faire
ERP (apps/erp)l’outil de l’équipe (catalogue, ventes, achats, stock, comptabilité), le webhook Stripe, la veille du matin et Fisherles migrations et le rôle propriétaire de la base, les clés d’écriture (Stripe qui rembourse, Blob, notifications, passerelle IA), la confirmation d’un paiement, l’émission d’une facture
Site (apps/site)la boutique : catalogue, panier, paiement, suivi, devis, compte clientrien d’irréversible. Il a un rôle Postgres limité, une clé Stripe restreinte, pas de jeton Blob, et il ne peut créer qu’une commande en attente de paiement
Documentation (apps/docs)ces pages, en français et en anglaisrien. Elle n’a ni base ni secret, et elle lit le dépôt au build

Qui parle à qui en prod

Postgres · Neon

la base commune

  • ERP → DATABASE_URL · rôle propriétaire
  • Site → DATABASE_URL · rôle moriniere_site

Stripe

paiements

  • ERP → STRIPE_SECRET_KEY · clé secrète
  • ERP ← STRIPE_WEBHOOK_SECRET · webhook
  • Site → STRIPE_SECRET_KEY · clé restreinte

Vercel Blob

photos, pièces comptables

  • ERP → BLOB_READ_WRITE_TOKEN · photos, écriture
  • ERP → INVOICE_BLOB_READ_WRITE_TOKEN · factures et devis, écriture
  • Site → BLOB_PUBLIC_HOST · photos, lecture seule

Resend

e-mails

  • ERP → RESEND_API_KEY · envoi
  • Site → RESEND_API_KEY · envoi

Upstash Redis

limites de débit

  • ERP → KV_REST_API_URL · débit, idempotence
  • Site → KV_REST_API_URL · débit

Vercel AI Gateway

Fisher, modèles Anthropic

  • ERP → AI_GATEWAY_API_KEY · appels

Web Push

notifications du personnel

  • ERP → VAPID_PRIVATE_KEY · signature

La Poste

suivi des colis

  • ERP → LA_POSTE_OKAPI_KEY · API Suivi

Vercel Cron

tâche planifiée

  • ERP ← /api/veille · « 0 6 * * * », UTC

Entre les deux applications

  • ERP → Site /api/revalidate · REVALIDATE_SECRET · périmer le cache des pages
  • Site → ERP /api/evenements-site · SITE_EVENTS_SECRET · annoncer une rétractation, une suppression de compte
  • Site → ERP /api/devis-site · QUOTE_PDF_SECRET · obtenir le PDF d’un devis
  • Site → ERP /api/factures-site · QUOTE_PDF_SECRET · obtenir le PDF d’une facture
Un lien n’est tracé que si le code de l’application lit la variable d’environnement qui l’ouvre ; les chemins des canaux viennent de packages/contracts, la tâche planifiée du vercel.json. Relu dans le dépôt à chaque build de cette documentation.

Le site ne confirme jamais un paiement et n’écrit pas dans Blob. C’est l’ERP qui le fait, parce que lui seul a les clés. Avec son rôle Postgres, le site lit le catalogue, crée une commande web en attente de paiement et gère le compte client. Un paiement, un remboursement ou un litige, c’est le webhook qui le confirme à l’ERP. Côté Stripe, le site n’a qu’une clé restreinte. Elle ouvre des sessions de paiement et rien d’autre de sensible.

Pour les canaux entre les deux applications, leur contrat et leurs secrets, voyez Échanges entre les applications. Tous les services externes, y compris ceux qui ne demandent pas de clé, sont dans Intégrations.

Hébergement

  • Vercel, région Paris (cdg1). Il y a un projet Vercel par application, cette doc comprise. Chaque projet ne déploie que la branche main, et il saute le build quand le commit ne touche ni l’application ni les paquets (ignoreCommand de chaque vercel.json).
  • Neon pour Postgres, avec l’adaptateur de packages/infra (prisma-adapter.ts). La base de prod est aux États-Unis, en Virginie (us-east-1 d’AWS, packages/domain/src/legal-identity.ts#DATABASE_HOST). C’est loin des fonctions de Paris, donc chaque aller-retour entre une fonction et la base traverse l’Atlantique.
  • Une tâche planifiée : chaque matin, Vercel appelle la veille de l’ERP (crons de apps/erp/vercel.json). Elle est décrite dans ERP.

Sur cette page