[DTP-Worker 20260730_085719] Auto exec · session 20260730_085719

05_deliverables_mvp/daily_reports/2026-07-30-session18.md

@@ -0,0 +1,94 @@
+# Rapport de session · 2026-07-30 · session 18
+
+## Tâche
+
+**Sprint 6 · SEO** — Générateur **SEO trilingue** (mots-clés FR/EN/ES +
+schema.org + hreflang). Roadmap L60 : « Refactor mission `seo_autonome/` →
+**200+ mots-clés FR/EN/ES · schema.org · hreflang** ».
+
+Sprint 5 étant clos en repo (ONAPI/Legal session 16 · QA Audit 5D session 17,
+Mobile hors périmètre VPS · #8), c'est le premier volet Sprint 6 réalisable dans
+le repo. Les deux autres volets Sprint 6 (OTOIA voice Amélie pilote AEC · chat
+OTOIA embarqué) dépendent d'API externes / du desk VPS → hors périmètre worker.
+
+## Décision d'architecture
+
+Le SEO est un livrable de **second niveau** : sa matière première est
+**`projets_master.json`**, la sortie canonique du **Publiciste** (elle-même
+dérivée de `data_room/PXX/` via le contrat `projets_master.schema.json`). Le
+générateur **ne fabrique aucun fait de projet** — il compose du SEO à partir de
+données déjà sourcées + un lexique éditorial générique non chiffré.
+
+Ce choix respecte #6 (zéro invention) et #5 (zéro duplication) : le générateur
+**réutilise** le validateur maison et les tokens de marque du Publiciste
+(`lib/validator.py`, `lib/branding.py` → `STATUTS_SANS_PRIX`, devise USD), sans
+les réimplémenter.
+
+## Fichiers créés — `05_deliverables_mvp/seo/`
+
+- `seo_spec.json` — config site (base_url, langs FR/EN/ES, préfixes, x-default)
+  + **lexique éditorial générique** (immobilier / à vendre / résidence / pays /
+    régime CONFOTUR) + org schema.org + cibles. **Zéro donnée de projet, zéro
+    chiffre.**
+- `seolib/{__init__,deps,keywords,schemaorg,hreflang,builder}.py`
+  - `deps` réutilise validateur + branding Publiciste ; `slugify`/`digits`
+    déterministes.
+  - `keywords` : génération déterministe, chaque mot-clé porte `scope`, `projet`,
+    `intent`, `category` et une liste `sources` non vide.
+  - `schemaorg` : graphe JSON-LD (`Organization` + une `Residence`/projet),
+    `offers` **uniquement** si projet disponible + prix sourcé (USD).
+  - `hreflang` : `alternate` FR/EN/ES + `x-default` par page.
+- `seo_gen.py` — CLI `build`/`validate` · **15 invariants** de cross-cohérence
+  et d'anti-invention.
+- `seo.schema.json` — contrat de sortie draft-07 (bundle keywords + schema.org +
+  hreflang + manifest).
+- `fixtures/projets_master.json` — entrée **de test** : 9 projets P01..P09 (noms
+  sourcés de `CLAUDE.md §Projets`), tous `en_developpement`, **sans aucun chiffre**.
+- `out/{seo_keywords,seo_schema_org,seo_hreflang,MANIFEST}.json` (hand-off) ·
+  `tests/test_seo.py` (**36 tests** dont 8 injections négatives) · `README.md` ·
+  `.gitignore`.
+
+## Fichiers modifiés
+
+- `.gitea/workflows/ci.yml` : job `seo-tests` + ajout au `gate`.
+
+## Anti-invention (cœur · #6)
+
+- Un **mot-clé** = composition de *tokens factuels* (`projet:<code>.nom` /
+  `.localisation`, sourçables) et de *lexique éditorial* (`lexicon:*`, générique
+  non chiffré). Un invariant vérifie que chaque mot-clé est **sourcé et
+  résoluble**.
+- Un mot-clé **ne peut porter que les chiffres présents dans son champ projet
+  source** : « 1069 Crisfer » (P09) passe ; un prix injecté (`… 250000`) est
+  **refusé** par l'invariant #7 (test négatif dédié).
+- **schema.org** n'émet une `offers`/`price` **que** pour un projet `disponible`
+  dont une typologie porte un `prix_depuis_usd` **numérique sourcé** ; devise
+  **USD** (#10). Pour tout statut sans prix : **aucun chiffre** (invariant #11 +
+  tests). La fixture livrée (9 projets `en_developpement`) produit donc
+  **0 offre** — aucune valeur inventée dans le hand-off committé.
+
+## Résultat
+
+- **258 mots-clés** — fr=87 · en=87 · es=84 (cible roadmap 200 dépassée) ;
+- schema.org : **10 nœuds** (1 Organization + 9 Residence), 0 offre ;
+- hreflang : **10 pages** (accueil + 9 projets), 4 `alternate`/page (FR/EN/ES +
+  x-default).
+
+## Vérifs
+
+- **36/36 tests** SEO verts (dont oracle `jsonschema` si présent) ;
+- gate CI local vert : guard contraintes · JSON bien formés · docs (liens +
+  score) · YAML valide ;
+- **régression 377 tests verts** au total (341 → +36), 0 module en échec ;
+- build déterministe (test dédié : deux builds identiques).
+
+## Hors périmètre worker (VPS · #8)
+
+- Injection des balises `<link hreflang>` + `<script JSON-LD>` dans les pages
+  `www/` (agent Frontend/SEO) ;
+- Génération + soumission `sitemap.xml` et Google Search Console ;
+- Traduction éditoriale des contenus longs FR/EN/ES ;
+- Branchement du générateur sur la **vraie** sortie Publiciste (9 projets réels
+  `data_room/PXX/`) via `--master`.
+
+## Auto-score 4Big : 96/100.