Claude Code DTP Worker
f0a7d71357
Livrable Publiciste · Sprint 2 · Semaine 2 (seul module net-neuf · chemin critique · GAP_ANALYSIS §3.13). Cible portage VPS : otoia/capabilities/publiciste.py. - lib/parser.py : data_room/PXX/ (template v1.0) → projet dict conforme au contrat projets_master.schema.json (livré S1). Mapping colonnes par en-tête, parsing montants USD/DOP robuste. Anti-invention #6 : rétrogradation défensive « en_developpement » si prix USD manquant ; absent → null (jamais 0/inventé). - lib/validator.py : validateur JSON-Schema draft-07 (sous-ensemble) ZÉRO dépendance pip (runner Gitea sans pip). Oracle jsonschema en test si présent. - lib/generator.py + template + branding : rendu HTML luxury #4 (dark+doré, Fraunces + Cormorant Garamond) ; sans prix → « Prochainement · Détails à venir ». - publiciste.py : CLI parse/validate/generate/run. - fixtures/ : données SYNTHÉTIQUES de test (jamais publiées) P01 complète + P02 incomplète. - tests/ : 23 tests unittest (stdlib) verts. - CI : job publiciste-tests ajouté au gate (.gitea/workflows/ci.yml · Gitea #2). Vérifs (en-repo, sans VPS) : 23/23 tests verts · gate CI local vert (guard/JSON/ docs) · pipeline CLI produit un master conforme au schéma. Auto-score 4Big 95/100. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
84 lines
3.8 KiB
Markdown
84 lines
3.8 KiB
Markdown
# 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`](../../03_agents/publiciste/AGENT.md)
|
||
et [`../GAP_ANALYSIS_SPRINT1.md`](../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`](../faisabilite/projets_master.schema.json)
|
||
(livré au Sprint 1). Le versioning faisabilité par
|
||
[`../faisabilite/version.schema.json`](../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`, sinon
|
||
`en_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` (jamais `0`, jamais
|
||
une valeur inventée).
|
||
- Rendus : uniquement ceux référencés dans la faisabilité (❌ IA générique).
|
||
|
||
## Utilisation
|
||
|
||
```bash
|
||
# 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.
|