From 2fffc7ccba92a245f1f85d06137b61fc4ddbb3f5 Mon Sep 17 00:00:00 2001 From: Imugiii Date: Tue, 16 Jun 2026 12:16:51 +0000 Subject: [PATCH] docs(borne): clarifie le repli JSON statique (fige, divergent de la DB) borne/data/produits.json (66) diverge de la table product (53) : c'est le jeu source ecole complet, fige, consomme par le front borne tant que l'API n'existe pas, et non un miroir de la base. Faute de note, on pouvait croire la borne synchrone avec la DB. Ajout d'un README dans src/public/borne/data/ : statut de repli statique, ecart produits attendu (categories alignees 9=9), point de bascule P4 (data.js -> /api/...) apres lequel ces fichiers deviennent obsoletes. --- src/public/borne/data/README.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 src/public/borne/data/README.md diff --git a/src/public/borne/data/README.md b/src/public/borne/data/README.md new file mode 100644 index 0000000..363ce16 --- /dev/null +++ b/src/public/borne/data/README.md @@ -0,0 +1,22 @@ +# Donnees statiques de la borne (repli P5) + +`categories.json` et `produits.json` sont un **repli statique fige** consomme par +le front de la borne (Bloc 1 / P5) tant que l'API REST n'existe pas. Ils sont +copies du jeu de donnees source de l'ecole (`docs/merise/_sources/`), **pas** +generes depuis la base. + +## Ces fichiers ne refletent pas la base + +Le catalogue servi ici est le jeu source complet (66 produits) ; le seed de la +base (`db/seeds/0002_catalogue.sql`) en est un sous-ensemble curate (53 produits). +Les categories, elles, coincident (9 de chaque cote). La borne est une demo front +sur donnees statiques : un ecart de comptage produits avec la table `product` est +**attendu**, ce n'est pas une incoherence a corriger. + +## Point de bascule (P4) + +`assets/js/data.js` lit ces fichiers via les constantes `CATEGORIES_URL` / +`PRODUCTS_URL`. En P4, ces constantes pointeront vers `/api/categories` et +`/api/products` (memes formes de retour, le reste du code est agnostique). La +borne refletera alors la base via l'API, et ces fichiers deviendront obsoletes +(a retirer a ce moment-la).