[DTP-Worker] Sprint 2 · Publiciste scaffold (parser faisabilité → JSON + generator + gate)

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>
This commit is contained in:
Claude Code DTP Worker
2026-07-30 01:37:47 +00:00
parent 1a87b22fd7
commit f0a7d71357
23 changed files with 1535 additions and 1 deletions
+17 -1
View File
@@ -43,10 +43,26 @@ jobs:
- name: Contrôle docs - name: Contrôle docs
run: bash ci/check_docs.sh run: bash ci/check_docs.sh
# --------------------------------------------------------------------------
# Publiciste (Sprint 2) : parser faisabilité → projets_master.json + generator.
# Tests unitaires stdlib pur (unittest) → aucune installation pip requise sur
# le runner. L'oracle jsonschema est utilisé s'il est présent, sinon ignoré.
# --------------------------------------------------------------------------
publiciste-tests:
name: Publiciste · parser + schéma + generator (unittest)
runs-on: ubuntu-latest
defaults:
run:
working-directory: 05_deliverables_mvp/publiciste
steps:
- uses: actions/checkout@v4
- name: Tests unitaires Publiciste
run: python3 -m unittest discover -s tests -v
gate: gate:
name: Gate qualité (agrégat) name: Gate qualité (agrégat)
runs-on: ubuntu-latest runs-on: ubuntu-latest
needs: [constraints-guard, validate-json, check-docs] needs: [constraints-guard, validate-json, check-docs, publiciste-tests]
steps: steps:
- name: Résultat - name: Résultat
run: echo "✅ Gate qualité 4Big franchi — tous les checks verts." run: echo "✅ Gate qualité 4Big franchi — tous les checks verts."
@@ -91,3 +91,51 @@ Rapport écrit dans `05_deliverables_mvp/daily_reports/` (chemin canonique fixé
--- ---
**Auto-score 4Big du livrable Baseline QA : 95/100.** Réserve 5 : exécution serveur différée (runner + `DTP_BASE_URL` VPS, hors périmètre) ; specs validées statiquement en-repo (JSON + YAML + gate vert). **Auto-score 4Big du livrable Baseline QA : 95/100.** Réserve 5 : exécution serveur différée (runner + `DTP_BASE_URL` VPS, hors périmètre) ; specs validées statiquement en-repo (JSON + YAML + gate vert).
---
# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 3)
**Session** : `20260730_012632`
## Tâche exécutée
**Sprint 2 · Livrable Publiciste « Setup base + parser faisabilité → JSON »**
(roadmap §Sprint 2 · AGENT.md Publiciste §Livrable Sprint · Semaine 2 · suggérée par session 2).
## Contexte / analyse
- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, `GAP_ANALYSIS_SPRINT1.md`, daily reports sessions 1-2, `AGENT.md` Publiciste, template canonique v1.0 + les 2 schémas (`projets_master.schema.json`, `version.schema.json`), `ci.yml`, `guard_constraints.sh`.
- **Sprint 1 bouclé côté repo** ; les 2 critères restants (cartographie DocTypes, runner/endpoints) touchent le VPS → hors périmètre worker.
- Priorité évidente : **Publiciste** — seul module net-neuf (`GAP_ANALYSIS §3.13`), chemin critique, démarre S2, contrat de données déjà défini au S1. 100 % autorable en-repo (parser + validateur + generator, zéro API externe, zéro VPS).
## Réalisé — module `05_deliverables_mvp/publiciste/` (cible portage : `otoia/capabilities/publiciste.py`)
- `lib/parser.py`**cœur du sprint** : `data_room/PXX/` (template v1.0) → dict projet conforme au schéma. Mapping colonnes **par en-tête** (résilient), parsing robuste des montants (USD/DOP, séparateurs FR/US), extraction localisation/services/positionnement FR/rendus.
- **Anti-invention #6 (défensif)** : statut dérivé de `_META/version.json` ; **rétrogradation** en « en_developpement » si un prix USD manque (jamais publier de prix douteux) ; cellule vide/`{{…}}`/« non défini » → `null` (jamais `0`).
- `lib/validator.py` — validateur **JSON-Schema draft-07 (sous-ensemble)** **zéro dépendance pip** (le runner Gitea n'a pas `pip`). Couvre type/enum/pattern/required/additionalProperties/items/allOf/if-then/const/min-max… Oracle `jsonschema` utilisé en test **s'il est présent**.
- `lib/generator.py` + `templates/site_public.html.tmpl` + `lib/branding.py` — rendu HTML **luxury #4** (dark `#0a0a12` + doré `#f0b429`, Fraunces + Cormorant Garamond). Projet sans prix → « Prochainement · Détails à venir » (aucun prix inventé).
- `publiciste.py` — orchestrateur CLI : `parse` / `validate` / `generate` / `run`.
- `fixtures/` — données **synthétiques** de test (P01 complète, P02 incomplète) clairement marquées « ne jamais publier » (respect #6).
- `tests/test_publiciste.py`**23 tests `unittest`** (stdlib pur) : parsing, extraction, rétrogradation défensive, conformité schéma (maison + oracle), rendu marque + zéro prix inventé.
- **CI** : job `publiciste-tests` ajouté au **gate** de `.gitea/workflows/ci.yml` (Gitea Actions uniquement · #2) → `unittest` sans installation pip.
- `README.md` module + `.gitignore` (artefacts `build/`).
## Vérifications effectuées (en-repo, sans toucher au VPS)
- **23/23 tests `unittest` verts.**
- Pipeline CLI complet sur fixtures : `run``projets_master.json` **conforme au schéma** + `index.html` (2 projets ; P01 « disponible » avec prix, P02 « en développement » sans prix).
- **Gate CI local vert (exit 0)** : `guard_constraints.sh`, `validate_json.sh` (inclut les 2 `version.json` fixtures), `check_docs.sh` (0 lien cassé ; ⚠ 4Big = SOFT sur fixtures uniquement).
- Aucun terme interdit introduit (guard #2/#3/#10 vert).
## Non fait (hors périmètre worker · touche au VPS ou calendrier ultérieur)
- Exécution contre les **données réelles** `data_room/` (VPS · ERPNext/Faisabilité).
- Triggers systemd `otoia-publiciste.timer` + watch inotify (Semaine 4 · VPS).
- Notifications WhatsApp Michel (Semaine 5 · VPS).
- Génération copy **EN/ES** automatique (Semaine 6 ; seul le FR est extrait aujourd'hui).
- DocType Frappe `Publiciste Log` (VPS · ERPNext).
## Prochaine tâche suggérée
- Publiciste S3 : brancher le generator sur un layout proche de `/waf-home` (Frontend) + intégrer les 6 vues/projet (dépend Rendu S3).
- Ou ERPNext S2 : spec **RBAC 50 rôles** (autorable en-repo comme document de conception).
- Ou Faisabilité S2 : générateur 4 volets auto consommant le template v1.0 (produit les `data_room/PXX/` que le parser Publiciste consomme).
---
**Auto-score 4Big du livrable Publiciste (parser) : 95/100.** Réserve 5 : exécution contre `data_room/` réel différée (VPS) ; triggers/notifications/EN-ES = livrables Semaines 4-6 ; validé statiquement en-repo (23 tests verts + gate CI vert + schéma conforme).
@@ -0,0 +1,4 @@
# Artefacts générés par le pipeline (jamais commit — reproductibles).
build/
__pycache__/
*.pyc
+83
View File
@@ -0,0 +1,83 @@
# 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.
@@ -0,0 +1,16 @@
# Fixtures Publiciste — ⚠️ DONNÉES SYNTHÉTIQUES DE TEST
**Ces fichiers ne proviennent d'AUCUNE archive réelle `data_room/` et ne doivent
JAMAIS être publiés.** Ils existent uniquement pour exercer le parser + le
générateur + le validateur de schéma en CI, sans dépendre du VPS.
- Les chiffres (prix, surfaces) sont **volontairement ronds et fictifs** — ils ne
décrivent aucun projet OTO. Aucun risque d'« invention » publiée (CLAUDE.md #6) :
rien ici n'alimente `vente.otov7.com`.
- `data_room/P01/` — faisabilité **complète** (statut `complete`, score ≥ 95) :
exerce le chemin « disponible » avec grille de prix.
- `data_room/P02/` — faisabilité **incomplète** (prix manquant) : exerce la
rétrogradation défensive → « En développement · Prochainement · Détails à venir ».
Codes projet réels réutilisés (P01/P02) car le schéma impose le motif `^P0[1-9]$` ;
la nature synthétique est portée par ce README + les valeurs manifestement fictives.
@@ -0,0 +1,7 @@
# Résidence Fixture Uno
> ⚠️ FIXTURE SYNTHÉTIQUE — données fictives pour test parser. Ne pas publier.
- **Localisation** : Test Province · Municipalité Fixture · 19.0000, -70.0000
- Superficie terrain : 10 000 m² / 159 tareas
- Zonage : Résidentiel touristique
@@ -0,0 +1,13 @@
# Architecture — Résidence Fixture Uno (SYNTHÉTIQUE)
## 3.1 Champs généraux
- Parti architectural : contemporain tropical (fixture)
- Nb de bâtiments : 3
## 3.2 Tableau des typologies
| Typologie | Nb unités | Surface intérieure (m²) | Surface terrasse (m²) | Surface totale (m²) | Prix « à partir de » (USD) | Prix (DOP) |
|---|---|---|---|---|---|---|
| Studio | 12 | 45 | 10 | 55 | USD 150,000 | DOP 8,850,000 |
| 1 Chambre | 20 | 68 | 15 | 83 | USD 210,000 | DOP 12,390,000 |
| 2 Chambres | 8 | 95 | 25 | 120 | USD 320,000 | DOP 18,880,000 |
@@ -0,0 +1,12 @@
# Paysage & Expérience — Fixture Uno (SYNTHÉTIQUE)
## 3.2 Amenities / équipements
- Piscine à débordement
- Beach club
## 3.3 Services inclus
- Conciergerie 24/7
- Sécurité périmétrique
- Gestion locative optionnelle
- Régime CONFOTUR (exonération fiscale)
- Structure Fideicomiso
@@ -0,0 +1,8 @@
# Commercial — Fixture Uno (SYNTHÉTIQUE)
Une adresse balnéaire confidentielle où l'architecture contemporaine dialogue avec
la nature tropicale. Des résidences pensées pour l'investissement locatif comme pour
l'art de vivre, sous régime CONFOTUR.
## Typologies (miroir §3.2)
Voir le tableau de l'architecture — prix « à partir de » USD 150,000.
@@ -0,0 +1,10 @@
# Manifeste rendus — Fixture Uno (SYNTHÉTIQUE)
> ⚠️ Fichiers non fournis (fixture) — seul le manifeste est testé.
> Rendus liés au projet réel obligatoires en production (❌ IA générique).
| Fichier | Vue | Hero |
|---|---|---|
| hero_aerien.jpg | Vue aérienne | hero |
| piscine.jpg | Piscine à débordement | non |
| lobby.jpg | Lobby | non |
@@ -0,0 +1,9 @@
{
"projet": "P01",
"template_version": "1.0.0",
"generated_at": "2026-07-30T00:00:00Z",
"score_4big": 96,
"statut_faisabilite": "complete",
"volets_complets": ["masterplan", "architecture", "paysage_experience", "ingenierie"],
"champs_manquants": []
}
@@ -0,0 +1,6 @@
# Résidence Fixture Dos
> ⚠️ FIXTURE SYNTHÉTIQUE — faisabilité volontairement INCOMPLÈTE (prix manquants).
- **Localisation** : Test Province Dos · Municipalité Fixture
- Zonage : Résidentiel touristique
@@ -0,0 +1,10 @@
# Architecture — Résidence Fixture Dos (SYNTHÉTIQUE · INCOMPLÈTE)
## 3.2 Tableau des typologies
> Prix « à partir de » NON défini → faisabilité incomplète → « En développement ».
| Typologie | Nb unités | Surface intérieure (m²) | Surface terrasse (m²) | Surface totale (m²) | Prix « à partir de » (USD) | Prix (DOP) |
|---|---|---|---|---|---|---|
| Villa A | 6 | 180 | 60 | 240 | non défini | non défini |
| Villa B | 4 | 220 | 80 | 300 | — | — |
@@ -0,0 +1,5 @@
# Paysage & Expérience — Fixture Dos (SYNTHÉTIQUE)
## 3.3 Services inclus
- Sécurité 24/7
- Espaces verts paysagers
@@ -0,0 +1,9 @@
{
"projet": "P02",
"template_version": "1.0.0",
"generated_at": "2026-07-30T00:00:00Z",
"score_4big": 71,
"statut_faisabilite": "incomplete",
"volets_complets": ["masterplan", "architecture"],
"champs_manquants": ["3.2.typo_1_prix_usd", "3.2.typo_2_prix_usd"]
}
@@ -0,0 +1,11 @@
"""Publiciste Agent · bibliothèque interne.
Modules :
- parser : data_room/PXX/ → dict projet (contrat projets_master.schema.json)
- validator : validation JSON-Schema draft-07 (sous-ensemble, zéro dépendance pip)
- generator : projets_master.json → HTML public (vente.otov7.com)
- branding : tokens de marque luxury (CLAUDE.md #4)
Cible de portage sur le VPS : otoia/capabilities/publiciste.py
(voir 03_agents/publiciste/AGENT.md · GAP_ANALYSIS_SPRINT1.md §3.13).
"""
@@ -0,0 +1,40 @@
"""Tokens de marque luxury · CLAUDE.md contrainte #4 (source unique de vérité).
Dark + doré : `#0a0a12` fond · `#f0b429` accent doré.
Typographies : Fraunces (titres) + Cormorant Garamond (corps éditorial).
Ces constantes sont importées par le générateur ET vérifiées par la baseline QA
Playwright (tests/e2e/_shared/contract.ts) — garder les valeurs synchronisées.
"""
from __future__ import annotations
# Couleurs canoniques (contrainte #4).
COLOR_BG = "#0a0a12" # fond dark
COLOR_ACCENT = "#f0b429" # doré
COLOR_INK = "#f5f3ee" # texte clair sur fond dark
COLOR_MUTED = "#8b8778" # texte secondaire
# Typographies canoniques (contrainte #4).
FONT_DISPLAY = "Fraunces"
FONT_BODY = "Cormorant Garamond"
# Devises canoniques (contrainte #10 · USD + DOP).
DEVISE_PRIMAIRE = "USD"
DEVISE_SECONDAIRE = "DOP"
# Libellés de statut affichés sur le site public (FR par défaut).
STATUT_LABELS = {
"disponible": "Disponible",
"en_developpement": "En développement",
"bientot": "Bientôt",
"en_processus": "En processus",
}
# Statuts pour lesquels on affiche « Prochainement · Détails à venir »
# au lieu d'une grille de prix (jamais de prix inventé — contrainte #6).
STATUTS_SANS_PRIX = {"en_developpement", "bientot", "en_processus"}
def statut_label(statut: str) -> str:
return STATUT_LABELS.get(statut, statut)
@@ -0,0 +1,162 @@
"""Générateur HTML · projets_master.json → site public (vente.otov7.com).
Livrable Publiciste · Sprint 2 · Semaine 3 (aperçu ; le parser Semaine 2 est le
cœur du sprint courant). Rendu server-side pur stdlib, marque luxury (#4).
Interdits appliqués (AGENT.md §Règles absolues) :
- ❌ Jamais éditer directement l'index publié : on passe TOUJOURS par ce
générateur, qui écrit une sortie complète et horodatée.
- ❌ Zéro prix inventé : un projet sans prix numérique n'affiche PAS de grille,
mais « Prochainement · Détails à venir » (contrainte #6).
- ❌ Rendus IA génériques interdits : on n'affiche que les rendus référencés
dans la faisabilité (liés au projet réel).
"""
from __future__ import annotations
import html
import os
from typing import Any
from . import branding
_TEMPLATE = os.path.join(os.path.dirname(__file__), "..", "templates", "site_public.html.tmpl")
_TAGLINE = "Résidences d'exception en République dominicaine · faisabilités 4 volets."
_A_VENIR = "Prochainement · Détails à venir"
def _esc(text: Any) -> str:
return html.escape(str(text), quote=True)
def _fmt_usd(value: float) -> str:
return f"USD {value:,.0f}".replace(",", " ")
def _fmt_dop(value: float) -> str:
return f"DOP {value:,.0f}".replace(",", " ")
def _fmt_m2(value: float) -> str:
txt = f"{value:,.0f}".replace(",", " ") if float(value).is_integer() else f"{value:,.1f}".replace(",", " ")
return f"{txt}"
def _prix_depuis(typologies: list[dict[str, Any]]) -> float | None:
"""Prix « à partir de » du projet = min des prix USD numériques présents."""
prices = [t["prix_depuis_usd"] for t in typologies if isinstance(t.get("prix_depuis_usd"), (int, float))]
return min(prices) if prices else None
def _render_typologies(typologies: list[dict[str, Any]]) -> str:
rows = []
for t in typologies:
surface = t.get("surface_totale_m2") or t.get("surface_interieure_m2")
surface_txt = _fmt_m2(surface) if isinstance(surface, (int, float)) else ""
prix = t.get("prix_depuis_usd")
prix_txt = (
f'<span class="prix-depuis">{_esc(_fmt_usd(prix))}</span>'
if isinstance(prix, (int, float))
else ""
)
rows.append(
" <tr>"
f"<td>{_esc(t.get('nom', ''))}</td>"
f"<td>{surface_txt}</td>"
f"<td>{prix_txt}</td>"
"</tr>"
)
return (
' <table class="prix">\n'
" <tr><th>Typologie</th><th>Surface</th><th>À partir de</th></tr>\n"
+ "\n".join(rows)
+ "\n </table>"
)
def _render_inclus(inclus: list[str]) -> str:
if not inclus:
return ""
items = "\n".join(f" <li>{_esc(x)}</li>" for x in inclus)
return f' <ul class="inclus">\n{items}\n </ul>'
def _hero_media(projet: dict[str, Any]) -> str:
rendus = projet.get("rendus", [])
hero = next((r for r in rendus if r.get("hero")), rendus[0] if rendus else None)
if not hero:
return ' <div class="media"></div>'
# Convention de chemin public (miroir de /opt/oto/sites/static/projets/pXX/).
code = projet["code"].lower()
src = f"/static/projets/{code}/{hero['fichier']}"
style = f"background-image:url('{_esc(src)}')"
return f' <div class="media" style="{style}" role="img" aria-label="{_esc(projet.get("nom",""))}"></div>'
def render_projet(projet: dict[str, Any]) -> str:
statut = projet.get("statut", "en_developpement")
statut_label = branding.statut_label(statut)
nom = projet.get("nom", projet.get("code", ""))
loc = projet.get("localisation", "")
parts = [f' <article class="projet" data-code="{_esc(projet.get("code",""))}">']
parts.append(_hero_media(projet))
parts.append(' <div class="corps">')
parts.append(f' <span class="statut {_esc(statut)}">{_esc(statut_label)}</span>')
parts.append(f" <h2>{_esc(nom)}</h2>")
if loc:
parts.append(f' <p class="localisation">{_esc(loc)}</p>')
positionnement = (projet.get("positionnement") or {}).get("fr")
if positionnement:
parts.append(f' <p class="positionnement">{_esc(positionnement)}</p>')
typologies = projet.get("typologies", [])
show_prices = statut not in branding.STATUTS_SANS_PRIX and _prix_depuis(typologies) is not None
if show_prices:
parts.append(_render_typologies(typologies))
else:
# Aucun prix inventé — message d'attente (contrainte #6).
parts.append(f' <p class="a-venir">{_esc(_A_VENIR)}</p>')
inclus_html = _render_inclus(projet.get("inclus", []))
if inclus_html:
parts.append(inclus_html)
parts.append(" </div>")
parts.append(" </article>")
return "\n".join(parts)
def render_site(master: dict[str, Any]) -> str:
"""projets_master.json (dict) → page HTML complète (str)."""
with open(_TEMPLATE, encoding="utf-8") as fh:
tmpl = fh.read()
projets_html = "\n".join(render_projet(p) for p in master.get("projets", []))
generated_at = master.get("generated_at", "")
template_version = master.get("template_version", "")
footer = (
f"Contenu généré automatiquement depuis les faisabilités canoniques · "
f"template {_esc(template_version)} · {_esc(generated_at)}. "
"Prix « à partir de » en USD + DOP (Cardnet). Aucune donnée inventée — "
"chaque valeur provient de la faisabilité du projet."
)
replacements = {
"{{TITRE}}": "Helios RD · Résidences d'exception",
"{{META_DESCRIPTION}}": _TAGLINE,
"{{TAGLINE}}": _TAGLINE,
"{{COLOR_BG}}": branding.COLOR_BG,
"{{COLOR_ACCENT}}": branding.COLOR_ACCENT,
"{{COLOR_INK}}": branding.COLOR_INK,
"{{COLOR_MUTED}}": branding.COLOR_MUTED,
"{{FONT_DISPLAY}}": branding.FONT_DISPLAY,
"{{FONT_BODY}}": branding.FONT_BODY,
"{{PROJETS}}": projets_html,
"{{FOOTER}}": footer,
}
for key, val in replacements.items():
tmpl = tmpl.replace(key, val)
return tmpl
@@ -0,0 +1,442 @@
"""Parser Faisabilité → contrat Publiciste (`projets_master.json`).
Livrable Publiciste · Sprint 2 · Semaine 2 (AGENT.md §Livrable Sprint).
Lit une faisabilité canonique `data_room/PXX/` (template v1.0) et produit le dict
`projet` conforme à `projets_master.schema.json`, consommé ensuite par le
générateur HTML.
Règles ANTI-INVENTION (CLAUDE.md #6) appliquées ici — le parser est volontairement
défensif : il n'invente JAMAIS un chiffre absent, et il **rétrograde** un projet
en « en_developpement » plutôt que de publier une donnée douteuse.
1. Le statut publié dérive de `_META/version.json.statut_faisabilite` :
complete → disponible
en_developpement→ en_developpement
incomplete → en_developpement
2. Un projet n'est « disponible » QUE si version.json le dit complete ET que
chaque typologie a un prix USD numérique (sinon rétrogradation défensive).
3. Une cellule vide / « non défini » / placeholder `{{...}}` → None (jamais 0,
jamais une valeur inventée).
Sources lues (ordre du template canonique v1.0) :
_META/version.json → statut, score, traçabilité
00_brief/brief.md → localisation (§1.1)
20_architecture/architecture.md → typologies + prix (§3.2, bloc anti-gap)
30_paysage_experience/paysage_experience.md→ services inclus (§3.3)
40_llm_outputs/commercial.md → positionnement FR (fallback prix §5.3)
60_photos_site/ → rendus (liés au projet réel)
"""
from __future__ import annotations
import json
import os
import re
from datetime import datetime, timezone
from typing import Any, Optional
# Marqueurs signalant une donnée ABSENTE (jamais inventer — contrainte #6).
_ABSENT = {
"", "", "-", "", "n/d", "nd", "na", "n.a.", "s/o", "so",
"non défini", "non defini", "non renseigné", "non renseigne",
"à définir", "a definir", "tbd", "todo", "", "...",
}
# --------------------------------------------------------------------------- #
# Helpers de bas niveau : nettoyage de cellules Markdown → valeurs typées.
# --------------------------------------------------------------------------- #
def _clean(cell: str) -> str:
"""Retire gras/italique/backticks et espaces d'une cellule Markdown."""
return cell.replace("**", "").replace("`", "").replace("*", "").strip()
def _is_absent(text: str) -> bool:
t = _clean(text).lower()
if not t:
return True
if "{{" in t and "}}" in t: # placeholder de template non rempli
return True
return t in _ABSENT
def parse_number(text: str) -> Optional[float]:
"""« USD 250,000 » / « 1 250,50 » / « 3.5 » → float ; absent → None.
Détecte le séparateur décimal (dernier « . » ou « , » suivi de 1-2 chiffres)
et traite les autres séparateurs comme des milliers. Ignore tout habillage
(devises, unités m², %, texte). Retourne None dès qu'aucun chiffre exploitable.
"""
if _is_absent(text):
return None
raw = _clean(text)
# Isole le premier bloc numérique (chiffres, points, virgules, espaces).
m = re.search(r"[0-9][0-9\s., ]*", raw)
if not m:
return None
token = m.group(0).strip().replace(" ", " ")
token = token.rstrip(" .,")
# Décide du séparateur décimal : le dernier '.' ou ',' suivi de 1-2 chiffres
# de fin de chaîne est décimal ; le reste = séparateurs de milliers.
dec = re.search(r"[.,](\d{1,2})$", token)
if dec:
int_part = token[: dec.start()]
int_part = re.sub(r"[^\d]", "", int_part)
value_str = f"{int_part}.{dec.group(1)}"
else:
value_str = re.sub(r"[^\d]", "", token)
if not value_str or value_str == ".":
return None
try:
return float(value_str)
except ValueError:
return None
def parse_int(text: str) -> Optional[int]:
n = parse_number(text)
if n is None:
return None
return int(round(n))
def parse_price(text: str) -> Optional[float]:
"""Prix « à partir de ». Alias sémantique de parse_number (garde None si absent)."""
return parse_number(text)
# --------------------------------------------------------------------------- #
# Tables Markdown.
# --------------------------------------------------------------------------- #
def _split_row(line: str) -> list[str]:
line = line.strip()
if line.startswith("|"):
line = line[1:]
if line.endswith("|"):
line = line[:-1]
return [c.strip() for c in line.split("|")]
def _is_separator_row(cells: list[str]) -> bool:
return all(re.fullmatch(r":?-{2,}:?", c.strip()) for c in cells if c.strip()) and any(cells)
def find_table_with_header(md: str, header_keywords: list[str]) -> tuple[list[str], list[list[str]]]:
"""(header, rows) de la première table Markdown dont l'en-tête contient TOUS
les mots-clés (insensible casse). ([], []) si aucune table correspondante.
"""
lines = md.splitlines()
keys = [k.lower() for k in header_keywords]
i = 0
while i < len(lines):
line = lines[i]
if line.count("|") >= 2:
header = _split_row(line)
header_txt = " ".join(header).lower()
nxt = lines[i + 1] if i + 1 < len(lines) else ""
if all(k in header_txt for k in keys) and _is_separator_row(_split_row(nxt)):
rows: list[list[str]] = []
j = i + 2
while j < len(lines) and lines[j].count("|") >= 2:
cells = _split_row(lines[j])
if not _is_separator_row(cells):
rows.append(cells)
j += 1
return header, rows
i += 1
return [], []
def find_table(md: str, header_keywords: list[str]) -> list[list[str]]:
"""Lignes de données seules (compat) — voir find_table_with_header."""
return find_table_with_header(md, header_keywords)[1]
def _col(header: list[str], *keywords: str) -> Optional[int]:
"""Index de la 1re colonne dont l'en-tête contient TOUS les mots-clés (casse ignorée)."""
keys = [k.lower() for k in keywords]
for idx, cell in enumerate(header):
low = _clean(cell).lower()
if all(k in low for k in keys):
return idx
return None
# --------------------------------------------------------------------------- #
# Extractions par volet.
# --------------------------------------------------------------------------- #
def parse_typologies(architecture_md: str) -> list[dict[str, Any]]:
"""Tableau §3.2 → liste de typologies. Ignore les lignes-placeholder.
Colonnes attendues (template v1.0) :
Typologie | Nb unités | Surface intérieure | Surface terrasse |
Surface totale | Prix « à partir de » (USD) | Prix (DOP)
"""
header, rows = find_table_with_header(architecture_md, ["typologie", "prix"])
if not header:
return []
# Mapping des colonnes PAR EN-TÊTE (résilient au ré-ordonnancement / ajout de
# colonnes). Une colonne absente de l'en-tête → valeur None (jamais deviner une
# position et risquer d'assigner la mauvaise donnée — contrainte #6).
i_nom = _col(header, "typologie")
i_qte = _col(header, "unit") # « Nb unités »
i_int = _col(header, "intérieure")
if i_int is None:
i_int = _col(header, "interieure")
i_terr = _col(header, "terrasse")
i_tot = _col(header, "totale")
i_usd = _col(header, "usd")
i_dop = _col(header, "dop")
if i_nom is None: # en-tête inexploitable → on ne parse pas de prix au hasard
return []
def cell(cells: list[str], idx: Optional[int]) -> str:
if idx is None or not (0 <= idx < len(cells)):
return ""
return cells[idx]
typologies: list[dict[str, Any]] = []
for cells in rows:
if _is_absent(cell(cells, i_nom)): # ligne entièrement placeholder → on saute
continue
typologies.append(
{
"nom": _clean(cell(cells, i_nom)),
"quantite": parse_int(cell(cells, i_qte)),
"surface_interieure_m2": parse_number(cell(cells, i_int)),
"surface_terrasse_m2": parse_number(cell(cells, i_terr)),
"surface_totale_m2": parse_number(cell(cells, i_tot)),
"prix_depuis_usd": parse_price(cell(cells, i_usd)),
"prix_depuis_dop": parse_price(cell(cells, i_dop)),
}
)
return typologies
def _parse_bullets_after(md: str, heading_keywords: list[str]) -> list[str]:
"""Puces (- / * / •) sous le premier titre/ligne contenant tous les mots-clés."""
lines = md.splitlines()
keys = [k.lower() for k in heading_keywords]
items: list[str] = []
capturing = False
for line in lines:
low = line.lower()
if not capturing:
if line.lstrip().startswith("#") and all(k in low for k in keys):
capturing = True
continue
if line.lstrip().startswith("#"): # section suivante → stop
break
m = re.match(r"\s*[-*•]\s+(.*)", line)
if m:
val = _clean(m.group(1))
if val and not _is_absent(val):
items.append(val)
return items
def parse_services_inclus(paysage_md: str) -> list[str]:
"""§3.3 « Services inclus » (+ §3.2 amenities en complément)."""
services = _parse_bullets_after(paysage_md, ["services", "inclus"])
amenities = _parse_bullets_after(paysage_md, ["amenities"])
# Dédoublonnage en conservant l'ordre.
seen: set[str] = set()
out: list[str] = []
for item in services + amenities:
key = item.lower()
if key not in seen:
seen.add(key)
out.append(item)
return out
def parse_localisation(brief_md: str) -> Optional[str]:
"""Ligne « Localisation : … » du brief (§1.1)."""
for line in brief_md.splitlines():
m = re.match(r"\s*[-*]?\s*\**localisation\**\s*[:]\s*(.+)", line, re.IGNORECASE)
if m:
val = _clean(m.group(1))
if val and not _is_absent(val):
return val
return None
def parse_nom(brief_md: str, code: str) -> str:
"""Nom commercial : 1er titre H1 du brief, sinon le code projet."""
for line in brief_md.splitlines():
m = re.match(r"\s*#\s+(.+)", line)
if m:
return _clean(m.group(1))
return code
def parse_positionnement_fr(commercial_md: str) -> Optional[str]:
"""Positionnement FR = 1er paragraphe non-titre de commercial.md.
NOTE : la génération EN/ES multilingue est le livrable Semaine 6 ; ici on ne
remplit que le FR à partir de la source documentée (jamais inventé — #6).
"""
for block in re.split(r"\n\s*\n", commercial_md):
block = block.strip()
if not block or block.startswith("#") or block.startswith("|"):
continue
text = _clean(block.replace("\n", " "))
if len(text) >= 20:
return text
return None
def parse_rendus(photos_dir: str) -> list[dict[str, Any]]:
"""Rendus liés au projet réel (jamais IA générique — contrainte CLAUDE.md).
Deux sources possibles :
1. Un manifeste `60_photos_site/README.md` (table : Fichier | Vue | Hero).
2. À défaut, la liste des fichiers image du dossier.
"""
rendus: list[dict[str, Any]] = []
if not os.path.isdir(photos_dir):
return rendus
manifest = os.path.join(photos_dir, "README.md")
if os.path.isfile(manifest):
with open(manifest, encoding="utf-8") as fh:
rows = find_table(fh.read(), ["fichier"])
for cells in rows:
cells = cells + [""] * (3 - len(cells))
fichier = _clean(cells[0])
if _is_absent(cells[0]):
continue
entry: dict[str, Any] = {"fichier": fichier}
vue = _clean(cells[1])
if vue and not _is_absent(cells[1]):
entry["vue"] = vue
entry["hero"] = "hero" in _clean(cells[2]).lower() or "oui" in _clean(cells[2]).lower()
rendus.append(entry)
if rendus:
return rendus
# Fallback : fichiers image présents.
exts = (".jpg", ".jpeg", ".png", ".webp", ".avif")
for fn in sorted(os.listdir(photos_dir)):
if fn.lower().endswith(exts):
rendus.append({"fichier": fn, "hero": False})
if rendus:
rendus[0]["hero"] = True # 1er rendu = hero par défaut
return rendus
# --------------------------------------------------------------------------- #
# Mapping de statut + assemblage projet.
# --------------------------------------------------------------------------- #
_STATUT_MAP = {
"complete": "disponible",
"en_developpement": "en_developpement",
"incomplete": "en_developpement",
}
def map_statut(version_statut: str) -> str:
return _STATUT_MAP.get(version_statut, "en_developpement")
def _read(path: str) -> str:
if os.path.isfile(path):
with open(path, encoding="utf-8") as fh:
return fh.read()
return ""
def parse_projet(projet_dir: str) -> dict[str, Any]:
"""Lit un dossier `data_room/PXX/` → dict `projet` (contrat schéma).
Lève FileNotFoundError si `_META/version.json` absent (donnée de vérité
obligatoire : sans elle on ne connaît ni le statut ni le score, on refuse
d'inventer).
"""
meta_path = os.path.join(projet_dir, "_META", "version.json")
if not os.path.isfile(meta_path):
raise FileNotFoundError(f"version.json manquant : {meta_path}")
with open(meta_path, encoding="utf-8") as fh:
version = json.load(fh)
code = version["projet"]
brief_md = _read(os.path.join(projet_dir, "00_brief", "brief.md"))
architecture_md = _read(os.path.join(projet_dir, "20_architecture", "architecture.md"))
paysage_md = _read(os.path.join(projet_dir, "30_paysage_experience", "paysage_experience.md"))
commercial_md = _read(os.path.join(projet_dir, "40_llm_outputs", "commercial.md"))
typologies = parse_typologies(architecture_md)
statut = map_statut(version.get("statut_faisabilite", "incomplete"))
# Rétrogradation défensive (contrainte #6) : « disponible » exige des prix USD
# numériques sur toutes les typologies, sinon on ne publie pas de prix douteux.
if statut == "disponible":
prix_ok = bool(typologies) and all(
isinstance(t["prix_depuis_usd"], (int, float)) for t in typologies
)
if not prix_ok:
statut = "en_developpement"
projet: dict[str, Any] = {
"code": code,
"nom": parse_nom(brief_md, code),
"statut": statut,
"localisation": parse_localisation(brief_md) or "",
# Les typologies (avec prix null tolérés) restent exposées même en
# « en_developpement » : le générateur choisit d'afficher ou non la grille.
"typologies": typologies,
"inclus": parse_services_inclus(paysage_md),
"rendus": parse_rendus(os.path.join(projet_dir, "60_photos_site")),
"source": {
"template_version": version.get("template_version", ""),
"score_4big": version.get("score_4big", 0),
"fichiers": _sources_presentes(projet_dir),
},
}
positionnement_fr = parse_positionnement_fr(commercial_md)
if positionnement_fr:
projet["positionnement"] = {"fr": positionnement_fr}
return projet
def _sources_presentes(projet_dir: str) -> list[str]:
"""Chemins relatifs des sources effectivement lues (traçabilité #6)."""
candidates = [
os.path.join("_META", "version.json"),
os.path.join("00_brief", "brief.md"),
os.path.join("20_architecture", "architecture.md"),
os.path.join("30_paysage_experience", "paysage_experience.md"),
os.path.join("40_llm_outputs", "commercial.md"),
os.path.join("60_photos_site", "README.md"),
]
return [c for c in candidates if os.path.isfile(os.path.join(projet_dir, c))]
def build_master(
data_room_dir: str,
generated_at: Optional[str] = None,
template_version: str = "1.0.0",
) -> dict[str, Any]:
"""Parcourt `data_room/` → objet `projets_master.json` complet et trié par code.
`generated_at` : horodatage ISO-8601 UTC ; par défaut « maintenant ».
Injectable pour des sorties déterministes (tests).
"""
if generated_at is None:
generated_at = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
projets: list[dict[str, Any]] = []
for name in sorted(os.listdir(data_room_dir)):
pdir = os.path.join(data_room_dir, name)
if re.fullmatch(r"P0[1-9]", name) and os.path.isfile(
os.path.join(pdir, "_META", "version.json")
):
projets.append(parse_projet(pdir))
return {
"generated_at": generated_at,
"template_version": template_version,
"projets": projets,
}
@@ -0,0 +1,159 @@
"""Validateur JSON-Schema draft-07 (sous-ensemble) · zéro dépendance pip.
Pourquoi un validateur maison plutôt que `jsonschema` ?
-----------------------------------------------------
Le gate CI (Gitea Actions, cf. .gitea/workflows/ci.yml) tourne sur un runner
`act_runner` sans installation `pip` (les guards Sprint 1 sont du bash pur).
Ce validateur couvre EXACTEMENT les constructions utilisées par les deux schémas
du contrat Faisabilité↔Publiciste (`version.schema.json`,
`projets_master.schema.json`) : type, required, additionalProperties, enum,
pattern, minLength, minItems, maxItems, uniqueItems, minimum, maximum, items,
properties, $ref (interne « #/definitions/... »), allOf, if/then, const, format.
Les tests (`tests/test_publiciste.py`) utilisent en plus la bibliothèque
`jsonschema` comme oracle *quand elle est disponible*, pour se prémunir d'un
écart entre ce validateur et la spec draft-07. En production le validateur
maison suffit et reste autonome.
API : validate(instance, schema) -> list[str] (liste d'erreurs, vide si OK).
"""
from __future__ import annotations
import re
from typing import Any
class SchemaError(Exception):
"""Schéma mal formé (bug du schéma, pas de la donnée)."""
def _resolve_ref(ref: str, root: dict) -> dict:
if not ref.startswith("#/"):
raise SchemaError(f"$ref non supporté (interne uniquement) : {ref}")
node: Any = root
for part in ref[2:].split("/"):
part = part.replace("~1", "/").replace("~0", "~")
node = node[part]
return node
def _type_ok(value: Any, expected: str) -> bool:
if expected == "object":
return isinstance(value, dict)
if expected == "array":
return isinstance(value, list)
if expected == "string":
return isinstance(value, str)
if expected == "integer":
# bool est un int en Python — on l'exclut explicitement.
return isinstance(value, int) and not isinstance(value, bool)
if expected == "number":
return isinstance(value, (int, float)) and not isinstance(value, bool)
if expected == "boolean":
return isinstance(value, bool)
if expected == "null":
return value is None
raise SchemaError(f"type inconnu dans le schéma : {expected}")
# Formats vérifiés (les autres sont acceptés sans contrôle, comme le veut draft-07).
_DATE_TIME = re.compile(
r"^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?$"
)
def _check_format(value: str, fmt: str, path: str, errors: list[str]) -> None:
if fmt == "date-time" and not _DATE_TIME.match(value):
errors.append(f"{path}: format date-time invalide ({value!r})")
def _validate(value: Any, schema: dict, root: dict, path: str, errors: list[str]) -> None:
if "$ref" in schema:
schema = _resolve_ref(schema["$ref"], root)
# const
if "const" in schema and value != schema["const"]:
errors.append(f"{path}: attendu const={schema['const']!r}, reçu {value!r}")
# enum
if "enum" in schema and value not in schema["enum"]:
errors.append(f"{path}: {value!r} hors enum {schema['enum']}")
# type (peut être une liste de types alternatifs)
if "type" in schema:
types = schema["type"]
types = [types] if isinstance(types, str) else types
if not any(_type_ok(value, t) for t in types):
errors.append(f"{path}: type {type(value).__name__}{types}")
# Inutile d'aller plus loin si le type de base est faux.
return
if isinstance(value, str):
if "minLength" in schema and len(value) < schema["minLength"]:
errors.append(f"{path}: chaîne trop courte (min {schema['minLength']})")
if "pattern" in schema and not re.search(schema["pattern"], value):
errors.append(f"{path}: {value!r} ne matche pas /{schema['pattern']}/")
if "format" in schema:
_check_format(value, schema["format"], path, errors)
if isinstance(value, (int, float)) and not isinstance(value, bool):
if "minimum" in schema and value < schema["minimum"]:
errors.append(f"{path}: {value} < minimum {schema['minimum']}")
if "maximum" in schema and value > schema["maximum"]:
errors.append(f"{path}: {value} > maximum {schema['maximum']}")
if isinstance(value, list):
if "minItems" in schema and len(value) < schema["minItems"]:
errors.append(f"{path}: {len(value)} items < minItems {schema['minItems']}")
if "maxItems" in schema and len(value) > schema["maxItems"]:
errors.append(f"{path}: {len(value)} items > maxItems {schema['maxItems']}")
if schema.get("uniqueItems") and _has_duplicates(value):
errors.append(f"{path}: items non uniques")
if "items" in schema:
for i, item in enumerate(value):
_validate(item, schema["items"], root, f"{path}[{i}]", errors)
if isinstance(value, dict):
props = schema.get("properties", {})
for req in schema.get("required", []):
if req not in value:
errors.append(f"{path}: propriété requise absente « {req} »")
if schema.get("additionalProperties") is False:
extra = set(value) - set(props)
if extra:
errors.append(f"{path}: propriétés interdites {sorted(extra)}")
for key, sub in props.items():
if key in value:
_validate(value[key], sub, root, f"{path}.{key}", errors)
# Combinateurs
for sub in schema.get("allOf", []):
_validate(value, sub, root, path, errors)
if "if" in schema:
cond_errors: list[str] = []
_validate(value, schema["if"], root, path, cond_errors)
branch = "then" if not cond_errors else "else"
if branch in schema:
_validate(value, schema[branch], root, path, errors)
def _has_duplicates(items: list) -> bool:
seen: list = []
for it in items:
if it in seen:
return True
seen.append(it)
return False
def validate(instance: Any, schema: dict) -> list[str]:
"""Valide `instance` contre `schema`. Retourne la liste des erreurs (vide = OK)."""
errors: list[str] = []
_validate(instance, schema, schema, "$", errors)
return errors
def is_valid(instance: Any, schema: dict) -> bool:
return not validate(instance, schema)
@@ -0,0 +1,160 @@
#!/usr/bin/env python3
"""Publiciste Agent · orchestrateur CLI (scaffold Sprint 2).
Cible de portage sur le VPS : `otoia/capabilities/publiciste.py`
(cf. 03_agents/publiciste/AGENT.md · GAP_ANALYSIS_SPRINT1.md §3.13).
Maintient le site public `vente.otov7.com` À PARTIR DES FAISABILITÉS CANONIQUES
(data_room/PXX/), sans édition manuelle. Zéro invention de chiffre (CLAUDE.md #6).
Sous-commandes :
parse data_room/ -> projets_master.json (validé contre le schéma)
validate projets_master.json
generate projets_master.json -> index.html
run data_room/ -> projets_master.json + index.html (pipeline complet)
Pipeline (AGENT.md §Architecture technique) :
data_room/PXX/ ──► parser ──► projets_master.json ──► generator ──► index.html
⚠ Ce worker n'écrit JAMAIS sur le VPS. La commande `run` produit les artefacts
dans un dossier de sortie local ; le déploiement réel (copie vers
/opt/oto/sites/vente/ + cache-bust + WhatsApp) est un livrable ultérieur exécuté
côté serveur par l'agent (Semaines 4-5).
"""
from __future__ import annotations
import argparse
import json
import os
import sys
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
from lib import generator, parser, validator # noqa: E402
_SCHEMA_DIR = os.path.normpath(
os.path.join(os.path.dirname(__file__), "..", "faisabilite")
)
def _load_schema(name: str) -> dict:
with open(os.path.join(_SCHEMA_DIR, name), encoding="utf-8") as fh:
return json.load(fh)
def _eprint(*args) -> None:
print(*args, file=sys.stderr)
# --------------------------------------------------------------------------- #
def cmd_parse(ns: argparse.Namespace) -> int:
master = parser.build_master(ns.data_room, generated_at=ns.generated_at)
errors = validator.validate(master, _load_schema("projets_master.schema.json"))
if errors:
_eprint("❌ projets_master.json NON conforme au schéma :")
for e in errors:
_eprint(" ·", e)
# On écrit quand même la sortie pour diagnostic si --force.
if not ns.force:
return 1
payload = json.dumps(master, ensure_ascii=False, indent=2)
if ns.out:
with open(ns.out, "w", encoding="utf-8") as fh:
fh.write(payload + "\n")
_eprint(f"{len(master['projets'])} projet(s) → {ns.out}")
else:
print(payload)
return 0
def cmd_validate(ns: argparse.Namespace) -> int:
with open(ns.master, encoding="utf-8") as fh:
master = json.load(fh)
errors = validator.validate(master, _load_schema("projets_master.schema.json"))
if errors:
_eprint(f"{ns.master} : {len(errors)} erreur(s)")
for e in errors:
_eprint(" ·", e)
return 1
_eprint(f"{ns.master} conforme ({len(master.get('projets', []))} projet(s)).")
return 0
def cmd_generate(ns: argparse.Namespace) -> int:
with open(ns.master, encoding="utf-8") as fh:
master = json.load(fh)
errors = validator.validate(master, _load_schema("projets_master.schema.json"))
if errors and not ns.force:
_eprint("❌ master non conforme — génération refusée (voir `validate`). --force pour outrepasser.")
return 1
html_out = generator.render_site(master)
if ns.out:
with open(ns.out, "w", encoding="utf-8") as fh:
fh.write(html_out)
_eprint(f"✅ site généré → {ns.out} ({len(master.get('projets', []))} projet(s))")
else:
sys.stdout.write(html_out)
return 0
def cmd_run(ns: argparse.Namespace) -> int:
os.makedirs(ns.out_dir, exist_ok=True)
master = parser.build_master(ns.data_room, generated_at=ns.generated_at)
schema = _load_schema("projets_master.schema.json")
errors = validator.validate(master, schema)
master_path = os.path.join(ns.out_dir, "projets_master.json")
with open(master_path, "w", encoding="utf-8") as fh:
fh.write(json.dumps(master, ensure_ascii=False, indent=2) + "\n")
if errors:
_eprint(f"❌ master non conforme ({len(errors)} erreur(s)) — index NON généré.")
for e in errors:
_eprint(" ·", e)
return 1
html_out = generator.render_site(master)
index_path = os.path.join(ns.out_dir, "index.html")
with open(index_path, "w", encoding="utf-8") as fh:
fh.write(html_out)
_eprint(f"✅ pipeline OK — {len(master['projets'])} projet(s)")
_eprint(f" · {master_path}")
_eprint(f" · {index_path}")
return 0
# --------------------------------------------------------------------------- #
def build_argparser() -> argparse.ArgumentParser:
ap = argparse.ArgumentParser(prog="publiciste", description=__doc__.splitlines()[0])
sub = ap.add_subparsers(dest="cmd", required=True)
p = sub.add_parser("parse", help="data_room/ -> projets_master.json")
p.add_argument("data_room")
p.add_argument("-o", "--out")
p.add_argument("--generated-at", dest="generated_at", default=None)
p.add_argument("--force", action="store_true", help="écrire même si non conforme")
p.set_defaults(func=cmd_parse)
p = sub.add_parser("validate", help="valide un projets_master.json")
p.add_argument("master")
p.set_defaults(func=cmd_validate)
p = sub.add_parser("generate", help="projets_master.json -> index.html")
p.add_argument("master")
p.add_argument("-o", "--out")
p.add_argument("--force", action="store_true")
p.set_defaults(func=cmd_generate)
p = sub.add_parser("run", help="pipeline complet data_room/ -> out_dir/")
p.add_argument("data_room")
p.add_argument("-o", "--out-dir", dest="out_dir", default="build")
p.add_argument("--generated-at", dest="generated_at", default=None)
p.set_defaults(func=cmd_run)
return ap
def main(argv: list[str] | None = None) -> int:
ns = build_argparser().parse_args(argv)
return ns.func(ns)
if __name__ == "__main__":
raise SystemExit(main())
@@ -0,0 +1,85 @@
<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>{{TITRE}}</title>
<meta name="description" content="{{META_DESCRIPTION}}" />
<!-- Généré automatiquement par le Publiciste Agent — NE PAS éditer à la main.
Source : faisabilités canoniques data_room/PXX/ (contrainte CLAUDE.md #6). -->
<style>
:root {
--bg: {{COLOR_BG}};
--accent: {{COLOR_ACCENT}};
--ink: {{COLOR_INK}};
--muted: {{COLOR_MUTED}};
--font-display: "{{FONT_DISPLAY}}", Georgia, serif;
--font-body: "{{FONT_BODY}}", Georgia, serif;
}
* { box-sizing: border-box; }
body {
margin: 0; background: var(--bg); color: var(--ink);
font-family: var(--font-body); font-size: 18px; line-height: 1.6;
}
header.hero {
padding: 96px 24px 64px; text-align: center;
border-bottom: 1px solid rgba(240,180,41,0.25);
}
header.hero h1 {
font-family: var(--font-display); font-weight: 600;
font-size: clamp(2.4rem, 6vw, 4rem); margin: 0 0 12px; color: var(--ink);
}
header.hero .accent { color: var(--accent); }
header.hero p.tagline { color: var(--muted); max-width: 640px; margin: 0 auto; }
main { max-width: 1120px; margin: 0 auto; padding: 48px 24px 96px; }
.grille { display: grid; grid-template-columns: repeat(auto-fill, minmax(320px, 1fr)); gap: 28px; }
article.projet {
background: #12121c; border: 1px solid rgba(240,180,41,0.18);
border-radius: 14px; overflow: hidden; display: flex; flex-direction: column;
}
article.projet .media {
aspect-ratio: 16/10; background: #0f0f18 center/cover no-repeat;
border-bottom: 1px solid rgba(240,180,41,0.12);
}
article.projet .corps { padding: 22px 24px 26px; flex: 1; display: flex; flex-direction: column; }
article.projet h2 {
font-family: var(--font-display); font-weight: 600; font-size: 1.6rem;
margin: 0 0 4px; color: var(--ink);
}
.localisation { color: var(--muted); font-size: 0.95rem; margin: 0 0 14px; }
.statut {
display: inline-block; font-family: var(--font-body); font-size: 0.8rem;
letter-spacing: 0.06em; text-transform: uppercase; padding: 4px 12px;
border-radius: 999px; margin-bottom: 14px;
}
.statut.disponible { color: var(--bg); background: var(--accent); }
.statut.en_developpement, .statut.bientot, .statut.en_processus {
color: var(--accent); border: 1px solid var(--accent);
}
.positionnement { color: var(--ink); opacity: 0.92; margin: 0 0 18px; }
table.prix { width: 100%; border-collapse: collapse; margin: 8px 0 6px; font-size: 0.98rem; }
table.prix th, table.prix td { text-align: left; padding: 7px 8px; border-bottom: 1px solid rgba(240,180,41,0.12); }
table.prix th { color: var(--accent); font-family: var(--font-display); font-weight: 600; }
.prix-depuis { color: var(--accent); font-weight: 600; white-space: nowrap; }
.a-venir { color: var(--muted); font-style: italic; margin: 6px 0 10px; }
ul.inclus { list-style: none; padding: 0; margin: 14px 0 0; }
ul.inclus li { padding: 3px 0 3px 20px; position: relative; color: var(--ink); opacity: 0.88; font-size: 0.96rem; }
ul.inclus li::before { content: "◆"; color: var(--accent); position: absolute; left: 0; font-size: 0.7rem; top: 6px; }
footer.legal { color: var(--muted); font-size: 0.82rem; text-align: center; padding: 32px 24px 56px; border-top: 1px solid rgba(240,180,41,0.15); }
</style>
</head>
<body>
<header class="hero">
<h1>Helios <span class="accent">RD</span></h1>
<p class="tagline">{{TAGLINE}}</p>
</header>
<main>
<div class="grille">
{{PROJETS}}
</div>
</main>
<footer class="legal">
{{FOOTER}}
</footer>
</body>
</html>
@@ -0,0 +1,219 @@
#!/usr/bin/env python3
"""Tests unitaires du Publiciste Agent (stdlib `unittest`, zéro dépendance).
Exécution : `python3 -m unittest discover -s tests` depuis le dossier publiciste/,
ou `python3 tests/test_publiciste.py`.
Couvre : parsing chiffres, extraction faisabilité, rétrogradation défensive
(anti-invention #6), conformité au schéma (validateur maison + oracle jsonschema
si présent), rendu HTML (marque luxury #4, zéro prix inventé).
"""
from __future__ import annotations
import json
import os
import sys
import unittest
HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(HERE) # dossier publiciste/
sys.path.insert(0, ROOT)
from lib import generator, parser, validator # noqa: E402
FIXTURES = os.path.join(ROOT, "fixtures", "data_room")
SCHEMA_DIR = os.path.normpath(os.path.join(ROOT, "..", "faisabilite"))
FIXED_TS = "2026-07-30T00:00:00Z"
def _schema(name: str) -> dict:
with open(os.path.join(SCHEMA_DIR, name), encoding="utf-8") as fh:
return json.load(fh)
class TestNumberParsing(unittest.TestCase):
def test_prix_formats(self):
self.assertEqual(parser.parse_price("USD 150,000"), 150000.0)
self.assertEqual(parser.parse_price("210000"), 210000.0)
self.assertEqual(parser.parse_price("DOP 8 850 000"), 8850000.0)
self.assertEqual(parser.parse_price("1,250,000.50"), 1250000.50)
def test_absents_donnent_none(self):
for token in ["", "", "-", "non défini", "n/d", "{{typo_1_prix_usd}}", "...", "TBD"]:
self.assertIsNone(parser.parse_price(token), f"{token!r} devrait être None")
def test_surfaces_et_entiers(self):
self.assertEqual(parser.parse_number("55"), 55.0)
self.assertEqual(parser.parse_number("3,5"), 3.5)
self.assertEqual(parser.parse_int("12 unités"), 12)
self.assertIsNone(parser.parse_int("non fourni"))
class TestMarkdownTable(unittest.TestCase):
def test_find_table_ignore_placeholders(self):
md = (
"| Typologie | Prix « à partir de » (USD) |\n"
"|---|---|\n"
"| Studio | USD 100,000 |\n"
"| `{{typo_2_nom}}` | `{{typo_2_prix_usd}}` |\n"
)
typ = parser.parse_typologies(md)
self.assertEqual(len(typ), 1)
self.assertEqual(typ[0]["nom"], "Studio")
self.assertEqual(typ[0]["prix_depuis_usd"], 100000.0)
class TestParserP01Complete(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.p = parser.parse_projet(os.path.join(FIXTURES, "P01"))
def test_statut_disponible(self):
self.assertEqual(self.p["statut"], "disponible")
def test_typologies_avec_prix(self):
self.assertEqual(len(self.p["typologies"]), 3)
for t in self.p["typologies"]:
self.assertIsInstance(t["prix_depuis_usd"], float)
self.assertEqual(self.p["typologies"][0]["prix_depuis_usd"], 150000.0)
def test_localisation_et_nom(self):
self.assertIn("Test Province", self.p["localisation"])
self.assertEqual(self.p["nom"], "Résidence Fixture Uno")
def test_services_inclus(self):
self.assertIn("Conciergerie 24/7", self.p["inclus"])
# amenities §3.2 complètent la liste
self.assertIn("Piscine à débordement", self.p["inclus"])
def test_positionnement_fr(self):
self.assertIn("fr", self.p.get("positionnement", {}))
self.assertIn("balnéaire", self.p["positionnement"]["fr"])
def test_rendus_hero(self):
heros = [r for r in self.p["rendus"] if r.get("hero")]
self.assertEqual(len(heros), 1)
self.assertEqual(heros[0]["fichier"], "hero_aerien.jpg")
def test_traçabilite_source(self):
self.assertEqual(self.p["source"]["score_4big"], 96)
self.assertIn("_META/version.json", "/".join(self.p["source"]["fichiers"]).replace(os.sep, "/"))
class TestParserP02DefensiveDowngrade(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.p = parser.parse_projet(os.path.join(FIXTURES, "P02"))
def test_en_developpement(self):
# Prix manquants → jamais « disponible » (anti-invention #6).
self.assertEqual(self.p["statut"], "en_developpement")
def test_prix_none(self):
for t in self.p["typologies"]:
self.assertIsNone(t["prix_depuis_usd"])
class TestSchemaConformance(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.master = parser.build_master(FIXTURES, generated_at=FIXED_TS)
cls.schema = _schema("projets_master.schema.json")
def test_validateur_maison(self):
errors = validator.validate(self.master, self.schema)
self.assertEqual(errors, [], f"erreurs schéma : {errors}")
def test_deux_projets_tries(self):
codes = [p["code"] for p in self.master["projets"]]
self.assertEqual(codes, ["P01", "P02"])
def test_oracle_jsonschema_si_present(self):
try:
import jsonschema
except ImportError:
self.skipTest("jsonschema non installé — oracle ignoré")
jsonschema.validate(self.master, self.schema) # lève si non conforme
def test_negatif_disponible_sans_prix_rejete(self):
# Un « disponible » avec prix null DOIT échouer (allOf if/then du schéma).
bad = {
"generated_at": FIXED_TS,
"template_version": "1.0.0",
"projets": [{
"code": "P03", "nom": "X", "statut": "disponible",
"localisation": "L",
"typologies": [{"nom": "T", "prix_depuis_usd": None}],
"inclus": [], "source": {"template_version": "1.0.0", "score_4big": 95},
}],
}
self.assertTrue(validator.validate(bad, self.schema), "devrait être NON conforme")
def test_validateur_maison_accord_oracle_sur_negatif(self):
try:
import jsonschema
except ImportError:
self.skipTest("jsonschema non installé")
bad = {
"generated_at": FIXED_TS, "template_version": "1.0.0",
"projets": [{
"code": "PX", "nom": "X", "statut": "disponible", "localisation": "L",
"typologies": [], "inclus": [],
"source": {"template_version": "1.0.0", "score_4big": 95},
}],
}
maison = bool(validator.validate(bad, self.schema))
oracle = False
try:
jsonschema.validate(bad, self.schema)
except jsonschema.ValidationError:
oracle = True
self.assertEqual(maison, oracle)
class TestVersionSchema(unittest.TestCase):
def test_fixtures_version_json_conformes(self):
schema = _schema("version.schema.json")
for code in ("P01", "P02"):
path = os.path.join(FIXTURES, code, "_META", "version.json")
with open(path, encoding="utf-8") as fh:
doc = json.load(fh)
self.assertEqual(validator.validate(doc, schema), [], f"{code} version.json")
class TestGenerator(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.master = parser.build_master(FIXTURES, generated_at=FIXED_TS)
cls.html = generator.render_site(cls.master)
def test_marque_luxury(self):
# Contrainte #4 : tokens dark+doré + typographies.
for token in ("#0a0a12", "#f0b429", "Fraunces", "Cormorant Garamond"):
self.assertIn(token, self.html, f"token de marque absent : {token}")
def test_html_valide_minimal(self):
self.assertIn("<!DOCTYPE html>", self.html)
self.assertIn('lang="fr"', self.html)
def test_projet_disponible_affiche_prix(self):
self.assertIn("USD 150 000", self.html) # prix P01 formaté
self.assertIn("Studio", self.html)
def test_projet_incomplet_sans_prix_invente(self):
# Le bloc P02 doit afficher « Prochainement » et AUCUN prix.
self.assertIn("Prochainement", self.html)
p02 = self._article(self.html, "P02")
self.assertNotIn("USD", p02, "aucun prix ne doit apparaître pour P02")
self.assertNotIn("prix-depuis", p02)
@staticmethod
def _article(html: str, code: str) -> str:
start = html.index(f'data-code="{code}"')
end = html.index("</article>", start)
return html[start:end]
if __name__ == "__main__":
unittest.main(verbosity=2)