Skip to Content
Meubles Morinière

The product5 min read

Site public

Comment le site est construit, du catalogue au paiement, les règles qu’il suit et la carte de son code.

Not translated yet

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

Le site (apps/site), c’est la boutique en ligne. Il présente le catalogue, prend les commandes et les paiements, montre les devis et le suivi d’une commande, et propose un compte client facultatif. Il n’a pas de back-office. Tout ce qu’il affiche, c’est l’équipe qui le décide dans l’ERP, et le site le lit dans la même base.

Les principes

Il y a cinq règles qu’on retrouve dans toutes les pages de cette partie.

  1. Le prix affiché, c’est le vrai prix. L’ERP expire le cache à chaque écriture. Le cache ne dure pas plus longtemps que la prochaine fin de remise. Et au paiement, on relit tout sans cache, ligne par ligne. Le client paie ce qu’il a vu, ou on lui dit ce qui a changé.
  2. La date annoncée, c’est celle que la commande promettra. La fiche, le panier et la caisse la calculent avec les mêmes fonctions, toujours sur la borne haute du délai.
  3. Le serveur rend la page, puis le navigateur l’affine. La page part d’une coquille statique et de lectures en cache. Ce qui ne regarde que la personne (son code postal, les cotes de son meuble, les pièces qu’elle a vues) se calcule dans son navigateur et n’est jamais envoyé.
  4. Une surface fermée (recherche, filtres, panier, menu) ne se charge pas avec la page. Elle se charge quand on s’en approche.
  5. Quand le site refuse quelque chose, il l’explique et il donne de quoi agir. Une pièce partie, un code échu ou un paiement interrompu s’affichent sous le geste qui a reçu le refus. Et quand la page est relue, elle montre l’état présent sans refuser une seconde fois.

La carte du code

Cette partie reprend apps/site/ARCHITECTURE.md, et c’est là-bas qu’elle se met à jour.

Les couches

DossierRôlePeut importer
app/Routes : pages, mises en page, gestionnaires de route. Compose, ne lit jamais Prisma directement.modules/, shared/, packages/*
modules/<domaine>/Un domaine (panier, produits, commandes…) : data/, actions/, components/, lib/, services/…shared/, packages/*, les modules des couches qui précèdent (MODULE_LAYERS) — pas app/
shared/Ce que plusieurs domaines partagent : data/, server/, lib/, components/, constants/.packages/* seulement
packages/*Ce que le site partage avec l'ERP : schéma, règles d'argent, contrats, kit d'interface (README racine).—

Ces frontières sont des règles ESLint (packages/config/eslint.mjs, eslint.config.mjs). À l'intérieur d'un module comme d'un segment de app/(site), on importe ce qui est à côté en relatif (./, ../) ; l'alias @/… sert à franchir une frontière.

Dans app/ :

  • app/(site)/ porte la barre, le pied et les JSON-LD de l'organisation (layout.tsx) ;
  • les composants propres à une route vivent dans son _components/ ; ceux de toute la vitrine dans app/(site)/_components/ (barre et vocabulaire de navigation dans navbar/, pied de page, pages légales) ; l'accueil a les siens dans app/(site)/(accueil)/_components/ ;
  • la fermeture de la vitrine en production est désactivée (IS_PRODUCTION_CLOSURE_ENABLED, faux depuis le 02/11/2026) : isSiteUnderConstruction (shared/server/site-construction.ts) répond toujours non, et app/en-construction/ n'est plus servie.

Lire les données

  • get-* (modules/*/data, shared/data) : le point d'entrée d'une route. Une lecture commune à tous les visiteurs est en cache : "use cache", cacheLife(<profil>), cacheTag(<tags>). Une lecture liée au visiteur (cookie du panier, des favoris, session du compte) lit son cookie hors de tout cache ; ce qui reste commun à tous (les déclinaisons du panier, par exemple) passe ensuite par une fonction en cache, ses identifiants en argument.
  • read-* (shared/data) : la même lecture sans cache, pour une transaction ou un chemin qui ne doit pas lire une valeur périmée (paiement).
  • Profils (next.config.ts) : catalogue (5 min, 6 h au plus), reference (1 h, 7 j au plus), checkout (30 s, 5 min au plus).
  • Tags : packages/contracts/src/cache-tags.ts, communs aux deux apps. L'ERP de production les périme par POST /api/revalidate : ce qui porte un prix, un stock, un port ou une date expire immédiatement ({ expire: 0 } : la lecture suivante est fraîche) ; la taxonomie (products, categories, collections, colors, materials) passe en stale-while-revalidate ("max"), pour qu'une base lente au moment d'une écriture ne fasse pas tomber la barre de chaque page. Une lecture qui montre un prix, un stock ou un délai porte donc variants.
  • Écrire : une server action (modules/*/actions), qui valide son entrée (schemas/) et délègue la règle à services/.

Rendre

Avec cacheComponents, chaque page a une coquille statique, prérendue, et des trous servis à la requête :

  • ce qui lit un cookie, searchParams ou l'heure est sous sa propre <Suspense>, au plus près de l'usage : la barre, le pied et le reste de la page n'attendent pas ;
  • ce qui lit l'adresse au navigateur (usePathname, useParams) passe par shared/components/address-reader.tsx : sur une adresse absente du build (un meuble publié depuis), la lecture suspend, et hors frontière elle viderait la coquille de la route — le build le refuse ;
  • l'heure de la requête se lit par requestNow(), après await io() (sinon elle serait figée dans la coquille) ;
  • une route dynamique ([slug], [category], [collection]) renvoie au moins un paramètre depuis generateStaticParams (atLeastOneParam) : Next refuse une liste vide ;
  • les lectures indépendantes partent ensemble (Promise.all) ; une lecture n'en attend une autre que si elle en dépend.

Les composants sont serveur par défaut. "use client" marque l'interactif (formulaires, volets, galerie, recherche rapide) ; une page serveur lui passe des données sérialisables, ou des éléments déjà rendus au serveur : la fiche produit rend ainsi le bouton d'achat et les conditions de chaque déclinaison (ProductOfferList) avant de les confier à son sélecteur client (ProductOfferPicker).

Vérifier

pnpm --filter @meublesmoriniere/site check (lint, types, format, knip), pnpm site:test:run, pnpm check:twins à la racine : le code commun avec l'ERP vit dans packages/, et le contrôle refuse une copie qui se reformerait.

On this page