Les choix d’ingénierieDécisions d’architecture4 min de lecture
0007 · Tout en cache sur le site, presque rien dans l’ERP
L’ERP et le site rendent sur le serveur par défaut, avec un prérendu partiel. Le site met en cache par tags. L’ERP relit la base à chaque geste, sauf deux référentiels.
Statut : acceptée · Décidée : 23 août 2026 (cacheComponents), précisée depuis · Sources : a92deac307, 8a5afbd233, ancien journal (23 et 31 août 2026), apps/erp/modules/colors/data/get-admin-colors.ts, AGENTS.md (décision du 22 octobre 2026)
Contexte
Le site sert le même catalogue à tout Internet, surtout sur téléphone. L’ERP, lui, sert une équipe qui modifie ce qu’elle lit. Les deux applications ont la même stack, Next.js 16 et React 19. Ses options sont décrites dans Next.js et React.
Contraintes
- Avec un prix, un stock ou une date promise périmés, on vend une pièce déjà partie ou on annonce un délai faux.
- La base et les clés ne doivent jamais arriver dans le navigateur.
- Dans l’ERP, l’écran doit montrer ce qu’on vient d’écrire.
Alternatives
- Une application rendue dans le navigateur, avec une API. Chaque donnée passerait par une route à écrire et à protéger, et tout le JavaScript partirait sur le téléphone.
- Un cache client (TanStack Query, SWR). Ça ferait une copie de la base à invalider à la main.
- Le même cache dans les deux applications. L’ERP montrerait une valeur périmée à la personne qui vient de la modifier.
nuqspour l’état dans l’adresse. On l’a étudié et écarté le 23 août. À la place, il y a une synchronisation écrite et testée, qui ne coûte rien au bundle et qui garde la main sur la lecture dessearchParamssouscacheComponents.- Un nonce CSP par requête. On l’a étudié et écarté les 23 et 31 août. Sous
cacheComponents, la coquille statique est produite au build, à un moment où il n’y a aucune requête. Et les scripts d’amorçage qu’un nonce devrait couvrir sont produits avec elle.
Décision
Les deux applications activent cacheComponents, partialPrefetching, reactCompiler et typedRoutes. Un composant reste un composant serveur tant qu’il n’a pas besoin du navigateur. Il lit par modules/*/data, et les écritures passent par des Server Actions.
Sur le site, toute lecture commune aux visiteurs porte "use cache", un profil (apps/site/shared/constants/cache-life.ts#CACHE_LIFE) et des tags (packages/contracts/src/cache-tags.ts). L’ERP invalide ces tags après chaque écriture.
Dans l’ERP, les lectures ne passent pas par "use cache", sauf les fermetures du magasin et la grille de port (get-closures.ts, get-shipping-grid.ts), avec le profil catalogue et des tags. Une action qui écrit appelle refresh(). Et chaque page est découpée en Suspense, un par bloc secondaire.
Raisons
Confirmées
- L’ERP n’a presque pas de cache : « PAS de
use cache: la créatrice édite ce qu’elle lit » (get-admin-colors.ts). - Un écran entier n’attend jamais la lecture la plus lente. Je l’ai décidé le 22 octobre 2026 (
AGENTS.md). - Les profils de cache ont un nom, et leurs durées sont déclarées une seule fois (ancien journal, 23 août 2026). Il y a une exception : l’ERP recopie le profil
cataloguedu site dans sonnext.config.ts. - Le motif du refus du nonce a été corrigé. Ce n’est plus « on perdrait le prérendu partiel ». C’est qu’il n’y a pas d’échappatoire sous
cacheComponents(ancien journal, 31 août 2026).
Hypothèses
- Next.js lui-même vient de mon projet précédent. Le dépôt en a repris l’outillage dès le premier jour (« aligne l’outillage sur les conventions du projet synclune »,
8a5afbd233). Aucun comparatif de frameworks n’est écrit.
Compromis
- Chaque composant demande de la discipline. Une heure lue sans
io()devant elle se fige dans la coquille. - Tout le cache du site repose sur les tags. Une lecture qui affiche un prix sans le bon tag reste périmée jusqu’à la fin de son profil.
- L’ERP paie en requêtes ce qu’il gagne en fraîcheur. Sa vitesse perçue repose sur le streaming et sur le préchargement de la coquille.
'unsafe-inline'reste dans la CSP des scripts.- Plusieurs options sont expérimentales ou
unstable_. On les relit à chaque montée de Next.
Conséquences
- Une page s’affiche avec sa coquille, ses titres et ses squelettes avant toute lecture de la base.
- Le build prérend des pages qui lisent la base de prod. Une migration doit donc se jouer avant la fusion (ADR 0009).
- Des tests relèvent les actions qui doivent invalider un tag, et les tags lus qu’aucune écriture n’invalide.
Risques résiduels
- Une lecture en cache sans le bon tag sert une valeur périmée jusqu’à la fin de son profil. Par contre, au moment du paiement, chaque ligne est rapprochée du catalogue sans cache (
reconcileCartWithCatalogue). Un prix périmé peut donc s’afficher sur une page, mais il ne s’encaisse pas (Panier et paiement). 'unsafe-inline'laisse s’exécuter un script injecté. C’est l’échappement de React qui l’en empêche : les scripts écrits en ligne sont des constantes (apps/erp/app/layout.tsx), et le JSON-LD du site échappe<(apps/site/shared/components/json-ld.tsx).- Une option expérimentale peut changer de forme à une montée de Next, et casser le rendu des deux applications en même temps.
Quand la revoir
'unsafe-inline'partira le jour où Next permettra de couvrir la coquille statique avec des empreintes de scripts, plutôt qu’avec un nonce de requête.- Si des écrans lourds ralentissent avec le volume, l’ERP étendrait son cache court et tagué, celui qu’il a déjà pour les fermetures et la grille de port. Il ne couvrirait jamais ce que l’équipe vient d’écrire, et il ne serait pas dans le navigateur.
- Si une montée changeait une option expérimentale dont le rendu dépend, on figerait la version de Next le temps de réécrire.