Le produit5 min de lecture
Site public
Comment le site est construit, du catalogue au paiement, les règles qu’il suit et la carte de son code.
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.
- 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é.
- 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.
- 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é.
- Une surface fermée (recherche, filtres, panier, menu) ne se charge pas avec la page. Elle se charge quand on s’en approche.
- 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
| Dossier | Rôle | Peut 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 dansapp/(site)/_components/(barre et vocabulaire de navigation dansnavbar/, pied de page, pages légales) ; l'accueil a les siens dansapp/(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, etapp/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 parPOST /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 doncvariants. - É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,
searchParamsou 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 parshared/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èsawait io()(sinon elle serait figée dans la coquille) ; - une route dynamique (
[slug],[category],[collection]) renvoie au moins un paramètre depuisgenerateStaticParams(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.
- Catalogue et rechercheLe catalogue lit ses meubles une fois et juge les filtres en mémoire. Il ne propose que les filtres qui retirent quelque chose, il remplace la pagination par « Voir plus » et sa recherche tourne dans le navigateur.
- Fiche produit et déclinaisonsLa fiche se rend en trois temps. On choisit sa déclinaison question par question, on a la date de livraison avant de payer, et on vérifie la taille au mètre.
- Panier et paiementLe client paie ce qu’il a vu. Le panier n’a pas de table, le volet donne le total pour son code postal et le formulaire ne fait rien retaper. On suit aussi une commande jusqu’à Stripe, y compris quand ça ne se passe pas comme prévu.
- Compte client, suivi et favorisLe compte est facultatif et s’ouvre avec un code reçu par e-mail. On peut suivre une commande sans compte, et son état tient en une phrase. Les favoris se partagent sans rien envoyer au serveur.
- Demandes au magasinUn projet sur mesure ou un souci après l’achat partent du site par e-mail, sans table ni ticket. Chaque formulaire demande ce qu’il faut pour que le magasin réponde du premier coup. La boîte de l’atelier est protégée, et une demande de sur-mesure devient un devis dans l’ERP.
- ImagesL’ERP lit chaque photo une fois, à l’import. Le site la pose sur une ligne de sol commune. Un optimiseur réglé pour le meuble la sert, et il n’accepte que le store des photos.
- RéférencementChaque page a son adresse canonique et les listes filtrées restent hors index. Le balisage et le flux marchand disent exactement ce que la page affiche, et les images de partage n’affichent pas de prix.
- Continuité avec l’ERPCe que l’équipe décide dans l’ERP et que le site affiche, sans copie ni synchronisation, comment un prix retouché se voit à la visite suivante, et ce que le site renvoie à l’ERP.
- Performance et accessibilitéLe budget de JavaScript est vérifié au build, les surfaces se chargent quand on s’en approche et une coquille statique part avant toute lecture. Pour l’accessibilité, il y a des règles écrites et des contrôles automatiques, et il reste des choses à prouver.