vault backup: 2026-08-01 16:32:03

2026-08-01 16:32:03 -04:00
parent 50341b49c4
commit 006017c6b2
3 changed files with 490 additions and 65 deletions
@@ -1,3 +1,5 @@
+# Consultation fournisseurs sites: proposition de publication JSON
+
 ## Objectif

 Nous évaluons une nouvelle façon de fournir les données de programmation et de contenus aux sites web TFO, IDELLO, ONFR et linéaire.
@@ -312,6 +314,34 @@ Logique:
 - les fichiers des runs ne changent jamais;
 - un rollback peut être fait en repointant le manifest vers un run précédent.

+## Garanties attendues
+
+Le modèle proposé vise à garantir les comportements suivants:
+
+- un run publié est complet pour la plateforme concernée;
+- `manifest.json` pointe seulement vers un run valide;
+- si une génération échoue, le manifest reste sur le dernier run valide;
+- les fichiers d'un run ne changent pas après publication;
+- les changements sont visibles via `latest.json`;
+- les produits retirés ne sont plus présents dans les indexes du nouveau run;
+- les anciens runs peuvent servir au rollback pendant la période de rétention.
+
+Ce modèle permet aussi de publier rapidement des corrections ciblées. Par exemple, si une correction interne touche une collection ou un produit, seuls les fichiers impactés devraient changer dans le prochain run.
+
+Limite importante: cette publication ne rend pas la source officielle instantanée. Si une donnée n'a pas encore été reçue par notre système, elle ne peut pas apparaître dans les JSON.
+
+## Ce que ce feed n'est pas
+
+Ce feed JSON n'est pas destiné à devenir:
+
+- une API dynamique publique;
+- un CMS éditorial;
+- un moteur de recherche complet;
+- un outil d'édition fournisseur;
+- une refonte de votre site.
+
+L'objectif est de fournir un contrat de données stable, versionné et facile à consommer.
+
 ## Points importants pour les sites

 - Les JSON seraient versionnés dans le chemin: `/v1/`, puis éventuellement `/v2/`.