oto-enterprise-os-dtp/05_deliverables_mvp/daily_reports/2026-07-30-session18.md

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.