Aller au contenu
Meubles Morinière

Le produitSite public8 min de lecture

Continuité avec l’ERP

Ce 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.

Le site n’a pas de back-office à lui. Tout ce qu’il affiche, c’est l’équipe qui le décide dans l’ERP : le catalogue et son ordre, les photos et leur cadrage, les prix et les remises, le stock, les délais, la grille de livraison, les fermetures, la vitrine de l’accueil. Le site lit tout ça dans la même base Postgres. Il n’y a pas de copie, pas de synchronisation et pas de file d’attente (Échanges entre les applications).

Ce choix supprime toute une famille de pannes. Il n’y a pas d’export qui échoue la nuit, pas de catalogue du site en retard d’une journée, pas de sources qui divergent. Par contre, il en crée une autre. Le site doit supporter la charge de tout Internet sur la base de l’équipe, et il ne doit jamais servir une valeur périmée là où ça compte.

Ce que l’ERP décide et ce que le site montre

Décidé dans l’ERPMontré sur le siteCe qui garantit l’accord
Publier, archiver, ordonner les meubles (Product.position), nommer le choix (choiceTerm)la liste « Recommandé », les cartes, les fiches, une page « plus disponible » pour une pièce archivéeles transitions de statut écrites une fois dans l’ERP, et le site ne lit que les meubles publiés
Les déclinaisons actives, leurs cotes, couleurs et matièresles questions du choix, le tableau comparatif, le plan coté, les filtresune déclinaison inactive disparaît par la même condition des deux côtés (BUYABLE_VARIANT_WHERE)
Les familles de couleurs et de matièresles options des filtres, les mots que la recherche comprendune ancienne adresse retrouve sa famille (restrictToFacets)
Les photos, leur ordre, leur texte de remplacement, leur cadrage lu à l’importles cartes debout sur leur ligne de sol, les vignettes, la galerie, les images de partagela règle de cadrage est dans packages/ui, que l’aperçu de l’ERP lit aussi (Images)
Le prix, l’éco-contribution, la remise et sa fin, l’historique des prixle prix annoncé, le prix barré honnête, la fin d’une remise à minuitannouncedPriceCents, referencePriceCents, settleEndedDiscount (packages/domain)
Le stock, la politique de stock« En stock », « Dernière pièce », « Sur commande », « Épuisé », et le stock libre au panierofferAvailability, pendingReservationWhere (packages/domain)
Les délais (meuble, marque, atelier), les fermetures, le délai d’une pièce en stockles dates « livrée d’ici… » de la fiche, du panier et de la caissele même calcul que la commande (workshopDueDate, deliveryDueDate), sur la même brique (closures.ts)
La grille de livraison : zones, modes, tarifs, acheminementle prix par déclinaison, « Chez vous », le total du volet, les modes de la caisseshipping-grid.ts, checkout-totals.ts, appelés par le paiement du site et par l’ERP
La vitrine de l’accueil et son ordre, les critères de la sélectionla une, la bande « Prêtes à partir » ou les nouveautésles critères partagés avec l’ERP (IN_STOCK_WHERE, newPiecesWhere)
Les codes promo, leur période, leur plafondla remise du panier et de la caisse, ses refus précisle verrou du plafond commun aux deux applications (promotion-lock.ts)
Les horaires et les fermeturesle magasin ouvert ou fermé, le bandeau de fermeturestore-status.ts
Les devis, les commandes et leurs étapesla page du devis, le suivi en une phrase, les documents du comptecustomerOrderPhase, seule traduction des statuts de l’atelier pour le client

Ce que les deux applications doivent calculer de la même façon est dans packages/domain, qui n’ouvre aucune connexion et ne touche pas au réseau. Du coup, la fiche, le panier, le paiement, la vente au magasin et le devis de l’ERP appellent le même code (Logique métier). Un contrôle empêche qu’une copie se reforme d’un côté (pnpm check:twins, Deux applications nées d’un fork).

Une retouche se voit à la visite suivante

Le site met en cache tout ce qui est commun à ses visiteurs. C’est l’ERP qui lui dit quand une copie n’est plus bonne.

Chaque lecture en cache du site porte des tags (products, variants, shipping, closures, workshop, store-settings…), écrits une seule fois pour les deux applications (packages/contracts/src/cache-tags.ts). Une fiche a aussi le sien (product:<slug>).

Après chaque écriture, l’ERP de prod envoie au site les tags touchés (POST /api/revalidate, revalidateCatalogue, apps/erp/shared/lib/catalogue-cache.ts). Ce qui porte un prix, un stock, un port ou une date expire tout de suite, donc la lecture suivante est fraîche. La taxonomie (meubles, catégories, collections, couleurs, matières), elle, est servie périmée le temps de se refaire. Comme ça, une base lente au moment d’une écriture ne fait pas tomber la barre de chaque page (app/api/revalidate/route.ts). Toute lecture qui montre un prix, un stock ou un délai porte variants, et l’ERP l’envoie avec products dès qu’une écriture peut les changer, donc elle reste fraîche. Une retouche photo ne les change pas : elle n’envoie que products et la fiche (revalidateProductPhotos), et les listes se refont en arrière-plan au lieu de repartir à froid à chaque geste.

La durée d’un profil de cache, c’est seulement un filet, au cas où un avis se perdrait (CACHE_LIFE, shared/constants/cache-life.ts). Elle se raccourcit toute seule jusqu’à la prochaine fin de remise des pièces lues (catalogueLifeUntilDiscountEnds). Du coup, une promotion s’arrête à minuit sans que personne ne prévienne le site. Une remise échue se lit au prix d’avant dès son échéance, même si la veille de l’ERP ne l’a pas encore close en base (settleProductDiscounts).

Le site se corrige aussi tout seul. Quand l’ajout au panier découvre que la fiche affichée est périmée (la pièce vient d’être vendue au magasin), l’action expire elle-même l’entrée et redessine la fiche (Fiche produit).

Le paiement, lui, ne lit rien en cache. Le rapprochement du panier, la réservation du stock et le calcul des totaux passent par les lectures read-*, sans cache (Panier et paiement). Le cache peut retarder un affichage, mais il ne peut pas faire payer un prix faux.

Deux tests le vérifient. Le premier relève les actions de l’ERP qui doivent invalider (apps/erp/test/cache-invalidation.regression.test.ts). Le second vérifie que chaque tag lu par le site est touché par au moins une écriture (cache-tag-pairing.test.ts).

Ce que le site renvoie à l’ERP

Le site écrit peu, et seulement par des chemins étroits.

  • Une commande en attente de paiement, et rien d’autre, parce qu’un trigger de la base refuse toute autre forme. C’est l’ERP qui la marque payée quand il reçoit le webhook de Stripe (Stripe). Ensuite c’est lui qui la prépare, la facture et la livre.
  • Les comptes clients et leurs sessions (tables de l’authentification), la vue d’un devis, et son lien à la commande qui le paie.
  • Des événements signés (une rétractation, une suppression de compte). Ils ne portent que leur sorte et un identifiant : la commande pour une rétractation, que l’ERP relit dans la base, ou l’empreinte de l’adresse pour une suppression de compte. Il y a aussi des demandes de PDF (devis, factures), que l’ERP revérifie avant de servir (Échanges).

Le site se connecte avec son propre rôle, moriniere_site. Ses droits sont écrits table par table et colonne par colonne (apps/site/scripts/lib/database-grants.ts). Il lit le prix d’une déclinaison, pas son coût. Il insère une commande, puis il n’en modifie que quelques colonnes (sa session Stripe, son abandon, la demande de rétractation). Il ne touche jamais à ses lignes ni à ses montants (Le site n’a que les droits qu’il lui faut).

Les limites

  • Une écriture faite hors de l’ERP (une requête SQL à la main, une restauration) n’expire aucun cache. Le site ne la montre qu’à la fin du profil. C’est pour ça que l’index de la recherche, quand il est vide, se relit à la minute.
  • L’invalidation passe par le réseau. Si le site reste injoignable plus longtemps que les nouvelles tentatives de l’ERP, il sert sa copie jusqu’à la fin du profil.
  • Le CDN ne suit pas les tags. Du coup, l’index de la recherche peut avoir deux minutes de retard, et le flux du Merchant Center vingt. Le panier et le paiement revérifient.
  • Une preview ou un poste de développement de l’ERP ne purge jamais le site. Donc une retouche faite sur une preview ne se voit pas en prod, et c’est voulu.
  • Le site prérend des pages au build en lisant la base de prod. Donc une migration doit passer avant la fusion du code qui la lit (Données).

Sur cette page