Claude Code DTP Worker
fbe298ffd0
Vérité-terrain : grep -c def test_negative_ = 10 (réparties Keywords/SchemaOrg/Hreflang/Manifest, PAS de classe dédiée) ; git show 0d3b242 = déjà 10 dès la création → jamais un état vrai antérieur (pas historical-repro). Piège confotur écarté : les 2 frères qui affichent un sous-compte négatif en prose sont EXACTS car adossés à une classe nommée countable (confotur « 8 négatifs » = classe TestNegative=8 ; devops « 14 injections négatives » = classe TestNegativeInjections=14) — SEO est le seul faux, ses négatifs ne forment pas de classe. Toute la classe « sous-compte négatif en prose » (seo/devops/confotur) auditée end-to-end.
Surfaces (balayage twin-fix) : seule seo/README.md:67 corrigée (présent-tense, doc vivante) ; les 2 autres occurrences du « 8 » sont dans daily_reports/2026-07-30-session18.md + 05_activity_log/2026-07-30.md = snapshots datés du 2026-07-30 → KEEP.
Effet de bord : audit_4big score le contenu README → quality_report.json régénéré EN DERNIER (seule ligne changée : evidence README.md 3900→3901 octets) · verdict PASS · 24/24 ≥95 (min 100) inchangé.
0 gate ajouté (#5 · erreur d'origine isolée, pas une dérive récurrente ; total déjà gaté ; précédent confotur = ne pas gater ces sous-comptes) · 0 édition d'autorité (le test file n'est pas modifié) · 0 chiffre inventé (#6) · 0 commande VPS (#8). run_ci.sh : 33 PASS
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
88 lines
3.8 KiB
Markdown
88 lines
3.8 KiB
Markdown
# 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](../publiciste/README.md) (elle-même dérivée de `data_room/PXX/` via
|
|
le contrat [`projets_master.schema.json`](../faisabilite/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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
python3 -m unittest discover -s tests -v # 36 tests (dont 10 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).
|