oto-enterprise-os-dtp/05_deliverables_mvp/seo

Générateur SEO trilingue · Sprint 6 · SEO

Roadmap Sprint 6 · SEO (L60) : « Refactor mission seo_autonome/ → 200+ mots-clés FR/EN/ES · schema.org · hreflang ».

Produit un bundle de hand-off SEO consommé ensuite par l'agent SEO/Frontend sur le VPS. Le worker n'écrit jamais sur le VPS (#8) : il émet des artefacts diffables, l'injection réelle des balises et la soumission Google Search Console restent côté serveur.

Ce que ça fait

Volet roadmap	Sortie
200+ mots-clés FR/EN/ES	out/seo_keywords.json — 258 mots-clés (fr=87 · en=87 · es=84), chacun sourcé
schema.org	out/seo_schema_org.json — graphe JSON-LD (Organization + une Residence par projet)
hreflang	out/seo_hreflang.json — carte alternate FR/EN/ES + x-default par page
compte-rendu	out/MANIFEST.json

Source de vérité (zéro invention · #6)

La 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 worker ne fabrique aucun fait de projet :

• un mot-clé est une composition de tokens factuels (nom / localisation du projet, sourçables projet:<code>.<champ>) et de vocabulaire éditorial générique (lexique immobilier / à vendre / … , non chiffré, lexicon:*) ;
• un mot-clé ne peut porter que les chiffres déjà présents dans son champ projet source (ex. « 1069 Crisfer » est admis ; un prix inventé est refusé) ;
• schema.org n'expose une offers/price que pour un projet disponible dont une typologie porte un prix_depuis_usd numérique sourcé dans le master ; devise USD (devise primaire · #10). Pour tout statut sans prix (en_developpement / bientot / en_processus) : aucun chiffre.

Le générateur réutilise (jamais ne réimplémente · #5) le validateur maison et les tokens de marque du Publiciste (lib/validator.py, lib/branding.py : STATUTS_SANS_PRIX, devise USD).

Utilisation

# Génère le bundle depuis la fixture de test (9 projets P01..P09)
python3 seo_gen.py build

# Ou depuis la vraie sortie Publiciste (VPS) :
python3 seo_gen.py build --master /chemin/projets_master.json -o out

# Valide (schéma de sortie + 15 invariants) sans écrire
python3 seo_gen.py validate

Garanties (15 invariants)

Volume ≥ cible roadmap (200) · 3 langues couvertes, minimum par langue · unicité (term, lang) · chaque mot-clé sourcé et résoluble · anti-invention de chiffre · un listing schema.org par projet (nom + localité = donnée source) · offres présentes ssi projet disponible + prix sourcé (USD) · aucun prix pour un statut sans prix · hreflang : une page par projet + accueil, alternate complètes + x-default = langue par défaut = canonical · toutes les URLs sous base_url en https · compteurs du manifeste cohérents.

Tests

python3 -m unittest discover -s tests -v   # 36 tests (dont 8 injections négatives)

Hors périmètre worker (VPS · #8)

• Injection des balises <link rel="alternate" hreflang> + <script type="application/ld+json"> 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.

Fixture

fixtures/projets_master.json est une entrée de test : 9 projets P01..P09 (noms sourcés de CLAUDE.md §Projets), tous en_developpement, sans aucun chiffre de prix/surface. En production, le générateur lit la vraie sortie du Publiciste.

---

Auto-score 4Big : 96/100. Livrable déterministe, testé, sans invention (#6), aligné ERPNext-natif-first et contraintes CLAUDE.md (#4 marque · #10 USD).