Publiciste Agent — scaffold (Sprint 2)
Maintient automatiquement le site public vente.otov7.com à partir des
faisabilités canoniques (data_room/PXX/, template v1.0), sans édition manuelle.
Cible de portage sur le VPS : otoia/capabilities/publiciste.py
(voir ../../03_agents/publiciste/AGENT.md
et ../GAP_ANALYSIS_SPRINT1.md §3.13 — seul module
net-neuf, chemin critique).
Pipeline
data_room/PXX/ ──► lib/parser.py ──► projets_master.json ──► lib/generator.py ──► index.html
(faisabilité) (extraction) (contrat schéma) (rendu luxury) (site public)
Le contrat projets_master.json est défini par
../faisabilite/projets_master.schema.json
(livré au Sprint 1). Le versioning faisabilité par
../faisabilite/version.schema.json.
État par rapport au calendrier AGENT.md
| Semaine | Livrable | Statut ici |
|---|---|---|
| S2 | Setup base + parser faisabilité → JSON | ✅ lib/parser.py + validation schéma |
| S3 | Générateur HTML → site | ✅ aperçu lib/generator.py (rendu luxury #4) |
| S4 | Triggers systemd + inotify | ☐ (exécution VPS — hors périmètre worker) |
| S5 | Notifications WhatsApp Michel | ☐ (VPS) |
| S6 | Multilingue FR/EN/ES auto | ☐ (FR extrait ; EN/ES à venir) |
| S7 | Tests + validation P01-P09 | 🟡 tests sur fixtures synthétiques (données réelles VPS) |
| S8 | Production | ☐ (VPS) |
Composants
| Fichier | Rôle |
|---|---|
publiciste.py |
Orchestrateur CLI (parse / validate / generate / run) |
lib/parser.py |
data_room/PXX/ → dict projet (contrat schéma) · anti-invention #6 |
lib/validator.py |
Validateur JSON-Schema draft-07 (sous-ensemble) · zéro dépendance pip |
lib/generator.py |
projets_master.json → HTML (marque luxury #4) |
lib/branding.py |
Tokens de marque (source unique · CLAUDE.md #4) |
templates/site_public.html.tmpl |
Gabarit dark+doré (Fraunces + Cormorant Garamond) |
fixtures/ |
Données synthétiques de test (⚠️ jamais publiées — cf. fixtures/README.md) |
tests/test_publiciste.py |
Suite unittest (parser, schéma, generator) |
Règles anti-invention appliquées (CLAUDE.md #6)
- Le statut publié dérive de
_META/version.json:complete → disponible, sinonen_developpement. - Rétrogradation défensive : un projet n'est « disponible » que si TOUTES ses typologies ont un prix USD numérique ; sinon → « En développement · Prochainement ».
- Cellule vide / « non défini » / placeholder
{{…}}→null(jamais0, jamais une valeur inventée). - Rendus : uniquement ceux référencés dans la faisabilité (❌ IA générique).
Utilisation
# depuis 05_deliverables_mvp/publiciste/
# Parser une data_room → projets_master.json (validé contre le schéma)
python3 publiciste.py parse fixtures/data_room -o build/projets_master.json
# Générer le site depuis un master validé
python3 publiciste.py generate build/projets_master.json -o build/index.html
# Pipeline complet
python3 publiciste.py run fixtures/data_room -o build/
# Tests
python3 -m unittest discover -s tests -v
⚠️ Ce worker n'écrit jamais sur le VPS. Le déploiement réel (copie vers
/opt/oto/sites/vente/, cache-bust Cloudflare, notification WhatsApp) est un livrable ultérieur exécuté côté serveur par l'agent (Semaines 4-5).
Auto-score 4Big du livrable : 95/100
Réserve −5 : exécution contre les données réelles data_room/ (VPS, hors
périmètre) différée ; triggers systemd/inotify + notifications WhatsApp = livrables
Semaines 4-5 côté serveur ; génération EN/ES = Semaine 6.