Aller au contenu
Meubles Morinière

Le codeArchitecture3 min de lecture

Échanges entre les applications

Les quatre canaux HTTP entre l’ERP et le site, le contrat qu’ils partagent et ce qui les protège.

L’ERP et le site ont la même base. Mais certains gestes ne doivent appartenir qu’à l’un des deux : prévenir le personnel, inscrire un effacement de données, lire une archive comptable, vider un cache. Dans ces cas-là, une application appelle l’autre en HTTP.

Les canaux

CanalSensRôleProtection
POST /api/revalidate (site)ERP → siteinvalider les tags de cache touchés par une écrituresecret partagé, et seul l’ERP de prod l’appelle
POST /api/evenements-site (ERP)site → ERPannoncer une rétractation ou une suppression de comptecorps signé (HMAC-SHA256 de l’horodatage et du corps), refusé au-delà de cinq minutes d’écart
POST /api/devis-site (ERP)site → ERPrécupérer le PDF archivé d’un devis, avec son jeton publicsecret partagé
POST /api/factures-site (ERP)site → ERPrécupérer le PDF d’une facture ou d’un avoir pour le titulaire d’un comptesecret partagé. L’ERP revérifie que la pièce appartient à une commande payée de ce compte, et il contrôle l’empreinte de l’archive

Un événement du site contient seulement sa sorte et l’identifiant de l’enregistrement. Le reste, l’ERP le relit dans la base. Et avant de lire quoi que ce soit, il refuse une signature fausse ou un horodatage trop ancien. Du coup, si quelqu’un capture un message, il ne peut le rejouer que pendant la fenêtre de cinq minutes, et sans le modifier.

Un secret par usage

Le cache, les événements et les documents ont chacun leur secret. Ce qui protège ces canaux (signature, rejeu, comparaison à temps constant, échec bruyant) et les compromis qui vont avec, c’est dans Webhooks et échanges.

Le contrat partagé

packages/contracts contient tout ce que les deux applications doivent dire de la même façon :

  • Le schéma du corps de chaque canal. L’application qui reçoit le valide. Pour le cache et les événements, celle qui envoie vérifie aussi son corps avec satisfies. Les deux demandes de PDF passent par requestErpPdf (apps/site/shared/server/erp-pdf.ts), qui prend un objet sans type.
  • La forme, la signature et la vérification des événements (site-events.ts), appelées des deux côtés.
  • Les tags de cache (cache-tags.ts), les chemins publics du site (site-paths.ts) et les chemins machine de l’ERP (erp-paths.ts).
  • Les clés des verrous Postgres que les deux applications prennent sur un même enregistrement : le paiement d’un devis en ligne contre son accord au magasin (quote-payment-lock.ts), et l’usage d’un code promo contre le changement de son plafond (promotion-lock.ts).

Si une clé de verrou avait un caractère de différence d’un côté, le verrou ne protégerait plus rien, et sans aucune erreur. C’est pour ça qu’on ne l’écrit qu’une fois.

Il n’y a aucune route publique dans les constantes de l’ERP. Pour faire un lien vers le site, on prend l’origine du site et un chemin de SITE_PATHS. Et un chemin relatif du site ne compile pas comme lien de l’ERP.

Le cache du site

Après une écriture, l’ERP de prod envoie au site les tags à invalider. Tout ce qui porte un prix, un stock, un port ou une date expire tout de suite. Pour la taxonomie (meubles, catégories, collections, couleurs, matériaux), c’est différent : le site sert l’ancienne version le temps de la refaire. Comme ça, si la base est lente au moment d’une écriture, la barre de navigation de chaque page ne tombe pas. Une preview ou un poste de dev ne purge jamais le cache du site public. Le détail des profils de cache est dans Site public.

Sur cette page