[DTP-Worker 20260730_085719] Auto exec · session 20260730_085719

Audit de second niveau : lit les hand-off out/ des livrables (workflow vente,
Dossier Vente, commissions, e-CF DGII, CONFOTUR) et vérifie 17 contrôles en
5 dimensions (D1 Traçabilité/ISA 500 · D2 AML-UAF/Ley 155-17 · D3 Fiscal
e-CF/Ley 32-23 · D4 Intégrité/IFRS · D5 Gouvernance-SoD/ISA 315).

Anti-invention #6 : paramètre réglementaire non confirmé → A_CONFIRMER (open
item assigné au métier), jamais fabriqué. Verdict PASS_WITH_OPEN_ITEMS (13 PASS,
0 FAIL, 4 à confirmer). Réutilise validateur Publiciste + RoleResolver CRM +
roles_targeting CONFOTUR (zéro duplication).

37 tests · 15 invariants · build déterministe · régression 341 tests verts.
Job CI qa-audit-5d-tests + gate.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

.gitea/workflows/ci.yml

@@ -0,0 +1,360 @@
+# ============================================================================
+# CI · OTO Enterprise OS DTP · Gitea Actions
+# ----------------------------------------------------------------------------
+# Gate qualité DevOps (roadmap Sprint 1 · GAP_ANALYSIS §7).
+# Plateforme : Gitea Actions UNIQUEMENT (CLAUDE.md #2 · JAMAIS GitHub).
+# Runner : act_runner enregistré sur le VPS avec le label « ubuntu-latest ».
+#          Voir ci/README.md pour l'enregistrement du runner.
+# Aucune dépendance réseau/marketplace externe hors actions/checkout.
+# ============================================================================
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  constraints-guard:
+    name: Contraintes NON-NÉGOCIABLES (CLAUDE.md)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Guard des contraintes
+        run: bash ci/guard_constraints.sh
+
+  validate-json:
+    name: Validation JSON (schémas Faisabilité)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Valider les JSON
+        run: bash ci/validate_json.sh
+
+  check-docs:
+    name: Qualité documentaire (liens + 4Big)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Contrôle docs
+        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
+
+  # --------------------------------------------------------------------------
+  # RBAC 50 rôles (Sprint 2 · ERPNext Backend) : contrat rbac_50_roles.json vs
+  # rbac.schema.json. Réutilise le validateur maison Publiciste (pas de pip).
+  # --------------------------------------------------------------------------
+  rbac-tests:
+    name: RBAC · 50 rôles + schéma (unittest)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/rbac
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests contrat RBAC
+        run: python3 -m unittest discover -s tests -v
+
+  # --------------------------------------------------------------------------
+  # Générateur Faisabilité 4 volets (Sprint 2 · Faisabilité) : brief.json →
+  # data_room/PXX/ (template v1.0). Le round-trip via le parser Publiciste est
+  # testé ici (générateur → parser → schéma). stdlib pur, aucune install pip.
+  # --------------------------------------------------------------------------
+  faisabilite-gen-tests:
+    name: Faisabilité · générateur 4 volets + round-trip (unittest)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/faisabilite/generator
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur Faisabilité
+        run: python3 -m unittest discover -s tests -v
+
+  # --------------------------------------------------------------------------
+  # Générateur de fixtures ERPNext (Sprint 2 · ERPNext Backend) : le contrat
+  # rbac_50_roles.json → fixtures Frappe `Role` + `Custom DocPerm`. Valide le
+  # bundle contre fixtures.schema.json + invariants (50 rôles, séparation des
+  # pouvoirs, round-trip fidèle au contrat). stdlib pur, aucune install pip.
+  # --------------------------------------------------------------------------
+  rbac-fixtures-tests:
+    name: RBAC · fixtures ERPNext (Role + Custom DocPerm)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/rbac/fixtures_gen
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur de fixtures RBAC
+        run: python3 -m unittest discover -s tests -v
+
+  # --------------------------------------------------------------------------
+  # Générateur de plan User Permission (Sprint 2 · ERPNext Backend) : le contrat
+  # rbac_50_roles.json → plan row-level (scope_donnees → mécanisme Frappe natif +
+  # template User Permission allow=Company pour la portée `entite`). Valide le
+  # plan contre userperm.schema.json + invariants (couverture bijective des 50
+  # rôles, template SSI `entite`, anti-invention utilisateur). stdlib pur.
+  # --------------------------------------------------------------------------
+  rbac-userperm-tests:
+    name: RBAC · plan User Permission (row-level)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/rbac/userperm_gen
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur de plan User Permission
+        run: python3 -m unittest discover -s tests -v
+
+  # --------------------------------------------------------------------------
+  # Générateur de Role Profile (Sprint 2 · ERPNext Backend) : le contrat
+  # rbac_50_roles.json → un `Role Profile` ERPNext v15 natif par portail (bundle
+  # de rôles assignable en un geste). Valide le bundle contre
+  # roleprofile.schema.json + invariants (couverture bijective des 50 rôles, un
+  # profil par portail, cohérence portail, anti-invention). stdlib pur.
+  # --------------------------------------------------------------------------
+  rbac-roleprofile-tests:
+    name: RBAC · Role Profile (bundles par portail)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/rbac/roleprofile_gen
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur de Role Profile
+        run: python3 -m unittest discover -s tests -v
+
+  # --------------------------------------------------------------------------
+  # Agrégateur RBAC (Sprint 2 · ERPNext Backend) : recoud les 3 volets RBAC
+  # (fixtures Role+DocPerm, plan User Permission, Role Profile) en un run-book
+  # d'application VPS ordonné (SPEC §7) + un manifeste agrégé. Valide contre
+  # apply_plan.schema.json + invariants (ordre + graphe de dépendances SPEC §7,
+  # cohérence inter-volets, couverture bijective des 50 rôles). stdlib pur.
+  # --------------------------------------------------------------------------
+  rbac-applyplan-tests:
+    name: RBAC · run-book d'application unifié (agrégat 3 volets)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/rbac/apply_plan
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests agrégateur RBAC
+        run: python3 -m unittest discover -s tests -v
+
+  # --------------------------------------------------------------------------
+  # Générateur de dossier bancable trilingue (Sprint 3 · Faisabilité) : le même
+  # brief.json → data_room/PXX/50_financier_bancable/{fr,en,es}.md + manifest.json
+  # (répertoire jusqu'ici vide qu'exige le Portail Bancables 4Big). Figures
+  # sourcées verbatim + agrégats calculés de façon traçable (formule recoupée).
+  # Valide le manifeste contre bancable.schema.json + invariants (3 langues,
+  # bannière CONFIDENTIEL, anti-invention, recalcul des figures). stdlib pur.
+  # --------------------------------------------------------------------------
+  bancable-tests:
+    name: Faisabilité · dossier bancable trilingue FR/EN/ES
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/faisabilite/bancable
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur bancable trilingue
+        run: python3 -m unittest discover -s tests -v
+
+  # --------------------------------------------------------------------------
+  # Générateur de workflow vente ERPNext (Sprint 4 · CRM natif) : le contrat
+  # pipeline workflow_vente_spec.json (lead → visite → devis → réservation →
+  # contrat → CONFOTUR) → fixtures Frappe Workflow + Workflow State + Workflow
+  # Action Master. Rôles résolus depuis rbac_50_roles.json (zéro duplication).
+  # Valide le schéma de sortie + 9 invariants de graphe (monotonie doc_status,
+  # atteignabilité, séparation des pouvoirs). stdlib pur, zéro pip.
+  # --------------------------------------------------------------------------
+  crm-workflow-vente-tests:
+    name: CRM · workflow vente ERPNext (lead → CONFOTUR)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/crm/workflow_vente
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur workflow vente
+        run: python3 -m unittest discover -s tests -v
+
+  # --------------------------------------------------------------------------
+  # Générateur du DocType porteur (Sprint 4 · CRM natif) : doctype_spec.json +
+  # workflow_vente_spec.json → fixture Frappe `DocType` custom `OTO Dossier
+  # Vente`, cible du Workflow `OTO Vente Pipeline`. Cross-cohérence workflow ↔
+  # DocType : champ d'état + valeurs de statut + is_submittable + permissions
+  # DÉDUITS du pipeline ; rôles résolus depuis rbac_50_roles.json (zéro
+  # duplication). Valide le schéma de sortie + 12 invariants. stdlib pur, zéro pip.
+  # --------------------------------------------------------------------------
+  crm-dossier-vente-tests:
+    name: CRM · DocType porteur OTO Dossier Vente
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/crm/dossier_vente
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur DocType Dossier Vente
+        run: python3 -m unittest discover -s tests -v
+
+  # --------------------------------------------------------------------------
+  # Barème commissions vendeurs (Sprint 4 · ERPNext Backend « commissions
+  # vendeurs auto »). Cross-cohérence barème ↔ workflow ↔ DocType ↔ RBAC : chaque
+  # évènement paie sur un état SOUMIS, sur un champ Currency réel du Dossier
+  # Vente, pour un rôle ventes résolu. Anti-invention (#6) : aucun taux fixé
+  # (taux_pct null tant qu'à confirmer) ; calcul commission = base × taux
+  # traçable. Valide le schéma de sortie + 10 invariants. stdlib pur, zéro pip.
+  # --------------------------------------------------------------------------
+  crm-commissions-tests:
+    name: CRM · barème commissions vendeurs
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/crm/commissions
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur barème commissions
+        run: python3 -m unittest discover -s tests -v
+
+  # --------------------------------------------------------------------------
+  # Intégration e-CF DGII (Sprint 4 · ERPNext Backend « e-CF DGII intégration
+  # (Compupar) »). Génère un plan de configuration de facturation électronique
+  # dominicaine cross-cohérent : chaque émission se déclenche sur un état SOUMIS
+  # du workflow, sur un champ Currency réel du Dossier Vente, par le rôle Compta
+  # Fiscaliste eCF résolu. Anti-invention (#6) : RNC / ITBIS / TipoCambio /
+  # endpoints Compupar restent null (a_confirmer) — jamais fabriqués ; composeur
+  # d'e-NCF traçable (E+tipo(2)+seq(10)). Schéma de sortie + 12 invariants +
+  # FormaPago Cardnet (#10). stdlib pur, zéro pip.
+  # --------------------------------------------------------------------------
+  fiscal-ecf-tests:
+    name: Fiscal · e-CF DGII (Compupar)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/fiscal/ecf_dgii
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur e-CF DGII
+        run: python3 -m unittest discover -s tests -v
+
+  # --------------------------------------------------------------------------
+  # Générateur de Workspaces ERPNext (Sprint 4 · Frontend Console « 5 portails
+  # rôle »). Un `Workspace` natif v15 par portail métier (Ventes/Construction/
+  # Achat/Compta/Direction) — le portail de landing par rôle du desk (#1 ERPNext
+  # natif). Cross-cohérence Workspace ↔ RBAC : chaque lien/raccourci vise un
+  # DocType présent dans les permissions_cibles du portail (anti-invention #6),
+  # couverture exhaustive, rôles restreints dérivés du contrat, tokens de marque
+  # repris de CLAUDE.md #4. Schéma de sortie + 12 invariants. stdlib pur, zéro pip.
+  # --------------------------------------------------------------------------
+  frontend-portails-tests:
+    name: Frontend · Workspaces 5 portails rôle
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/frontend/portails
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur de Workspaces
+        run: python3 -m unittest discover -s tests -v
+
+  # --------------------------------------------------------------------------
+  # Générateur du DocType `CONFOTUR Application` (Sprint 5 · ONAPI/Legal · roadmap
+  # L55 « Refactor oto_module_confotur_application.py → dépôts automatiques »).
+  # DocType custom porteur des dossiers d'incitation touristique CONFOTUR
+  # (Ley 158-01, RD). Cross-cohérence DocType ↔ RBAC ↔ workflow : les permissions
+  # SONT, mot pour mot, les permissions_cibles RBAC (rôles ventes-confotur /
+  # legal-onapi / legal-directeur) ; le caractère soumissible en découle ;
+  # `estado`/`dossier_vente` dérivent du workflow_vente ; aucun taux/loi/montant
+  # CONFOTUR n'est fabriqué (#6). Schéma de sortie + 14 invariants. stdlib pur.
+  # --------------------------------------------------------------------------
+  legal-confotur-tests:
+    name: Legal · DocType CONFOTUR Application
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/legal/confotur
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur CONFOTUR Application
+        run: python3 -m unittest discover -s tests -v
+
+  qa-audit-5d-tests:
+    name: QA · Audit 5D conformité
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/qa/audit_5d
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur Audit 5D
+        run: python3 -m unittest discover -s tests -v
+
+  seo-tests:
+    name: SEO · mots-clés trilingues + schema.org + hreflang
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: 05_deliverables_mvp/seo
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tests générateur SEO
+        run: python3 -m unittest discover -s tests -v
+
+  gate:
+    name: Gate qualité (agrégat)
+    runs-on: ubuntu-latest
+    needs: [constraints-guard, validate-json, check-docs, publiciste-tests, rbac-tests, faisabilite-gen-tests, rbac-fixtures-tests, rbac-userperm-tests, rbac-roleprofile-tests, rbac-applyplan-tests, bancable-tests, crm-workflow-vente-tests, crm-dossier-vente-tests, crm-commissions-tests, fiscal-ecf-tests, frontend-portails-tests, legal-confotur-tests, qa-audit-5d-tests, seo-tests]
+    steps:
+      - name: Résultat
+        run: echo "✅ Gate qualité 4Big franchi — tous les checks verts."
+
+  # --------------------------------------------------------------------------
+  # E2E baseline (QA · Sprint 1). MANUEL uniquement (workflow_dispatch) : exige
+  # un serveur live + navigateurs → hors du gate push/PR (checks statiques).
+  # Cible via DTP_BASE_URL (variable/secret repo). Voir tests/README.md.
+  # --------------------------------------------------------------------------
+  e2e-baseline:
+    name: E2E baseline Playwright (manuel)
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch'
+    defaults:
+      run:
+        working-directory: tests
+    env:
+      CI: "true"
+      DTP_BASE_URL: ${{ vars.DTP_BASE_URL }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Installer dépendances + navigateurs
+        run: |
+          npm install
+          npm run install:browsers
+      - name: Lancer la baseline E2E
+        run: npm test
+      - name: Publier le rapport
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: tests/playwright-report/

05_activity_log/2026-07-30.md

@@ -0,0 +1,357 @@
+# Activity Log · 2026-07-30 · Claude Code DTP
+
+## Session `20260730_085719` (session 18)
+
+**Tâche** : **Sprint 6 · SEO** — Générateur **SEO trilingue** (roadmap L60 :
+« Refactor mission `seo_autonome/` → **200+ mots-clés FR/EN/ES · schema.org ·
+hreflang** »). Premier volet Sprint 6 réalisable en repo — les volets OTOIA voice
+Amélie (pilote AEC) et chat OTOIA embarqué dépendent d'API externes / desk VPS
+(hors périmètre worker · #8).
+
+**Décision d'architecture** : livrable de **second niveau** — la matière première
+est **`projets_master.json`**, la sortie canonique du **Publiciste** (dérivée de
+`data_room/PXX/`). Le générateur ne fabrique aucun fait de projet ; il **réutilise**
+(zéro duplication · #5) le validateur maison + les tokens de marque du Publiciste
+(`lib/validator.py`, `lib/branding.py`).
+
+**Fichiers créés** — `05_deliverables_mvp/seo/` :
+- `seo_spec.json` (config site + **lexique éditorial générique** FR/EN/ES + org
+  schema.org + cibles · zéro donnée projet, zéro chiffre)
+- `seolib/{__init__,deps,keywords,schemaorg,hreflang,builder}.py` (`deps` réutilise
+  validateur + branding Publiciste ; `keywords`/`schemaorg`/`hreflang` purs et
+  déterministes ; `builder` assemble bundle + manifeste)
+- `seo_gen.py` (CLI `build`/`validate` · **15 invariants**)
+- `seo.schema.json` (contrat de sortie draft-07)
+- `fixtures/projets_master.json` (test only · 9 projets P01..P09, noms sourcés
+  `CLAUDE.md §Projets`, tous `en_developpement`, **zéro chiffre**)
+- `out/{seo_keywords,seo_schema_org,seo_hreflang,MANIFEST}.json` (hand-off) ·
+  `tests/test_seo.py` (**36 tests** dont 8 injections négatives) · `README.md` ·
+  `.gitignore`
+
+**Fichiers modifiés** :
+- `.gitea/workflows/ci.yml` : job `seo-tests` + ajout au `gate`.
+
+**Anti-invention (cœur · #6)** : un mot-clé = composition de tokens factuels
+(`projet:<code>.nom`/`.localisation`, sourçables) + lexique éditorial générique
+non chiffré (`lexicon:*`) ; un invariant vérifie que chaque mot-clé est sourcé et
+résoluble ; un mot-clé ne peut porter que les chiffres de son champ source
+(« 1069 Crisfer » passe ; un prix injecté est refusé). schema.org n'émet un prix
+que pour un projet `disponible` à typologie **sourcée** (USD · #10) — la fixture
+`en_developpement` produit donc **0 offre**, aucun chiffre inventé dans le hand-off.
+
+**Résultat** : **258 mots-clés** (fr=87 · en=87 · es=84 · cible 200 dépassée) ·
+schema.org 10 nœuds (1 Organization + 9 Residence) · hreflang 10 pages (accueil +
+9 projets) × 4 alternates (FR/EN/ES + x-default).
+
+**Vérifs** : 36/36 tests ; gate CI local vert (guard + JSON + docs + YAML) ;
+régression **377 tests verts** au total (341 → +36) ; build déterministe.
+
+**Hors périmètre worker (VPS · #8)** : injection balises hreflang/JSON-LD dans
+`www/` + sitemap + Google Search Console + branchement sur la vraie sortie
+Publiciste (9 projets réels) → agent SEO / Frontend.
+
+**Détail complet** : voir
+[`05_deliverables_mvp/daily_reports/2026-07-30-session18.md`](../05_deliverables_mvp/daily_reports/2026-07-30-session18.md).
+
+**Auto-score 4Big** : 96/100.
+
+## Session `20260730_082714` (session 17)
+
+**Tâche** : **Sprint 5 · QA** — Générateur de l'**Audit 5D de conformité**
+(roadmap Sprint 5 · QA « **Audit UAF + normes ISA/IFRS 5D** »). Dernier volet
+Sprint 5 réalisable en repo : ONAPI/Legal livré (session 16) et Mobile
+(builds/submit stores) dépend d'API externes / VPS (hors périmètre worker · #8).
+
+**Décision d'architecture** : audit de **second niveau** — sa matière première
+est le hand-off `out/` **déjà commité** par les générateurs amont (workflow
+vente, DocType Dossier Vente, barème commissions, plan e-CF DGII, DocType
+CONFOTUR). Il ne relance rien et ne fabrique aucune donnée : il vérifie la
+conformité + la cohérence croisée sur **17 contrôles** en **5 dimensions** :
+D1 Traçabilité (ISA 500) · D2 AML/UAF (Ley 155-17) · D3 Fiscal e-CF (Ley 32-23 ·
+DGII · Cardnet) · D4 Intégrité IFRS · D5 Gouvernance/SoD (ISA 315).
+
+**Fichiers créés** — `05_deliverables_mvp/qa/audit_5d/` :
+- `audit_spec.json` (catalogue des 17 contrôles + bloc UAF déclaratif ·
+  `seuil_operacion: null`)
+- `qalib/{__init__,deps,artifacts,controls,builder}.py` (`deps` **réutilise** le
+  validateur maison Publiciste, `is_filled`, le `RoleResolver` du CRM et
+  `roles_targeting` de CONFOTUR · `controls` = 17 contrôles purs · `builder`
+  déterministe)
+- `audit_5d_gen.py` (CLI `build`/`validate` · **15 invariants**)
+- `audit.schema.json` (contrat de sortie draft-07)
+- `out/{audit_report,MANIFEST}.json` (hand-off) · `tests/test_audit_5d.py`
+  (**37 tests** · une injection négative par contrôle) · `README.md` · `.gitignore`
+
+**Fichiers modifiés** :
+- `.gitea/workflows/ci.yml` : job `qa-audit-5d-tests` + ajout au `gate`.
+
+**Anti-invention (cœur · #6)** : l'audit **remonte, ne fabrique pas**. Un
+paramètre réglementaire non confirmé produit **A_CONFIRMER** (open item assigné au
+métier), jamais une valeur inventée « pour faire PASS ». **FAIL** = incohérence
+inter-livrables OU valeur chiffrée **sans `source`**. Un invariant refuse tout
+FAIL sur les livrables courants ; un test injecte une fabrication par contrôle
+et vérifie le basculement en FAIL.
+
+**Résultat** : verdict `PASS_WITH_OPEN_ITEMS` — **13 PASS · 0 FAIL · 4 à
+confirmer** (D1.1 taux → Direction ; D1.2 RNC émetteur → Compta ; D1.3
+ITBIS/TipoCambio → Fiscaliste eCF ; D2.3 seuil UAF → Oficial de Cumplimiento).
+Ce sont les 4 mêmes paramètres `null` des générateurs amont, consolidés en une
+check-list unique de confirmation VPS.
+
+**Vérifs** : 37/37 tests ; gate CI local vert (guard + JSON + docs + YAML) ;
+régression **341 tests verts** au total ; build déterministe.
+
+**Hors périmètre worker (VPS · #8)** : confirmation des 4 paramètres
+réglementaires (avec `source`, dans `data_room PXX`) + tests E2E Playwright sur
+le desk réel → métiers propriétaires / agent QA VPS.
+
+**Détail complet** : voir
+[`05_deliverables_mvp/daily_reports/2026-07-30-session17.md`](../05_deliverables_mvp/daily_reports/2026-07-30-session17.md).
+
+**Auto-score 4Big** : 96/100.
+
+## Session `20260730_075712` (session 16)
+
+**Tâche** : **Sprint 5 · ONAPI/Legal** — Générateur du **DocType porteur
+`CONFOTUR Application`** (roadmap **L55** « Refactor `oto_module_confotur_application.py`
+→ dépôts automatiques »). Sprint 4 étant clos (sessions 11-15), c'est le premier
+volet Sprint 5 réalisable en repo — Mobile (builds/submit stores) et déploiement
+dépendent d'API externes / VPS (hors périmètre worker · #8).
+
+**Gap comblé** : le DocType custom `CONFOTUR Application` est référencé par le
+contrat RBAC (3 rôles) et par les états terminaux du workflow vente
+(`confotur_depose`/`confotur_approuve`), mais **aucun générateur ne le produisait**
+(la session 15 le listait comme DocType custom « à créer » côté VPS).
+
+**Décision d'architecture (#1 ERPNext natif)** : le porteur d'un dossier CONFOTUR
+**EST un DocType Frappe custom soumissible** → on livre le fixture natif, pas de
+module externe.
+
+**Fichiers créés** — `05_deliverables_mvp/legal/confotur/` :
+- `confotur_spec.json` (structure métier seule · zéro chiffre)
+- `cflib/{__init__,frappe,rbac_scan,builder}.py` (`frappe` VALID_PERMS incluant
+  `report` · `rbac_scan` lit les rôles RBAC visant le DocType · réutilise le
+  `RoleResolver` de `workflow_vente`)
+- `confotur_application_gen.py` (CLI `build`/`validate` · **14 invariants**)
+- `confotur.schema.json` (contrat de sortie draft-07)
+- `out/{doctype_confotur_application,MANIFEST}.json` (hand-off) ·
+  `tests/test_confotur.py` (**44 tests** dont 8 négatifs) · `README.md` · `.gitignore`
+
+**Fichiers modifiés** :
+- `.gitea/workflows/ci.yml` : job `legal-confotur-tests` + ajout au `gate`.
+
+**Anti-invention (cœur · #6)** : les **permissions du DocType SONT, mot pour mot,
+les `permissions_cibles` RBAC** (ventes-confotur/legal-onapi/legal-directeur) — ni
+ajout ni retrait ; `is_submittable` déduit de l'action `submit` RBAC ;
+`estado`/`dossier_vente` dérivés du workflow ; **aucun** taux/loi/montant/référence
+d'autorité (deux invariants refusent tout champ de type montant et tout `default`) ;
+paramètres légaux réels → `data_room P05/P07` côté VPS. Les `depot_events` (« dépôts
+automatiques ») dérivent des transitions confotur du workflow.
+
+**Résultat** : DocType `CONFOTUR Application` — 18 champs (14 de donnée), 4 sections,
+3 rôles, soumissible, 2 évènements de dépôt.
+
+**Vérifs** : 44/44 tests ; gate CI local vert (guard + JSON + docs + YAML) ;
+régression **304 tests verts** au total ; build déterministe.
+
+**Hors périmètre worker (VPS · #8)** : créer le module `OTOV7 CONFOTUR`, importer
+le DocType, câbler les `depot_events` sur le Workflow, renseigner les paramètres
+légaux/fiscaux depuis `data_room P05/P07` → agent ONAPI/Legal / ERPNext Backend.
+
+**Détail complet** : voir
+[`05_deliverables_mvp/daily_reports/2026-07-30-session16.md`](../05_deliverables_mvp/daily_reports/2026-07-30-session16.md).
+
+**Auto-score 4Big** : 96/100.
+
+## Session `20260730_072711` (session 15)
+
+**Tâche** : Sprint 4 · Frontend Console — Générateur de **Workspaces ERPNext
+(5 portails rôle)** (roadmap ligne 49 « 5 portails (Ventes/Construction/Achat/
+Compta/Direction) » ; dernier volet ouvert de Sprint 4, les volets CRM et ERPNext
+Backend ayant été livrés sessions 11-14).
+
+**Décision d'architecture (#1 ERPNext natif)** : dans ERPNext v15, le portail de
+landing par rôle **EST le DocType `Workspace`** → on livre 5 Workspaces natifs,
+pas de framework de dashboard externe.
+
+**Fichiers créés** — `05_deliverables_mvp/frontend/portails/` :
+- `portails_spec.json` (mise en page seule : cartes/raccourcis/thème · aucun
+  DocType ni rôle hors contrat)
+- `wslib/{__init__,frappe,builder}.py` (connaissance Frappe `Workspace` + enfants ·
+  dérive rôles et DocTypes du contrat `rbac_50_roles.json`)
+- `workspaces_gen.py` (CLI `build`/`validate` · 12 invariants de cross-cohérence)
+- `workspace.schema.json` (contrat de sortie draft-07)
+- `out/{workspace,MANIFEST}.json` (hand-off) · `tests/test_workspaces.py`
+  (19 tests dont 4 négatifs) · `README.md` · `.gitignore`
+
+**Fichiers modifiés** :
+- `.gitea/workflows/ci.yml` : job `frontend-portails-tests` + ajout au `gate`.
+
+**Anti-invention (cœur · #6)** : la source de vérité est le contrat RBAC, jamais
+la spec. Tout lien/raccourci vise un DocType présent dans les `permissions_cibles`
+du portail (droit prouvé) ; couverture exhaustive sans doublon ; flag `custom`
+issu du contrat ; aucun chiffre stocké (compteurs live du desk) ; tokens de marque
+(`#0a0a12`/`#f0b429`/Fraunces/Cormorant) repris verbatim de CLAUDE.md #4 avec source.
+
+**Résultat** : 5 Workspaces (Ventes/Construction/Achat/Compta/Direction), 44 rôles
+restreints ; console technique `plateforme` exclue (roadmap = 5 portails métier).
+
+**Vérifs** : 19/19 tests ; gate CI local vert (guard + JSON + docs + YAML) ;
+régression **260 tests verts** au total ; build déterministe.
+
+**Hors périmètre worker (VPS · #8)** : fixer `Workspace.module` à l'import + créer
+les DocTypes custom (`CONFOTUR Application`, `Faisabilité`, `Publiciste Log`) +
+appliquer le thème desk → agents ERPNext Backend / Frontend Console.
+
+**Détail complet** : voir
+[`05_deliverables_mvp/daily_reports/2026-07-30-session15.md`](../05_deliverables_mvp/daily_reports/2026-07-30-session15.md).
+
+**Auto-score 4Big** : 96/100.
+
+## Session `20260730_065711` (session 14)
+
+**Tâche** : Sprint 4 · ERPNext Backend — Générateur de **configuration e-CF DGII
+(Compupar)** (roadmap ligne 51 « e-CF DGII intégration (Compupar) » ; les
+commissions ayant été livrées session 13, l'e-CF restait ouvert · GAP §Backend).
+
+**Fichiers créés** — `05_deliverables_mvp/fiscal/ecf_dgii/` :
+- `ecf_spec.json` (catalogue 10 types e-CF DGII · table FormaPago · format e-NCF ·
+  moneda USD/DOP · RNC/ITBIS/TipoCambio `null` · provider Compupar · 2 évènements
+  d'émission · `field_map` Dossier Vente → e-CF)
+- `ecflib/{__init__,deps,ncf,builder}.py` (réutilise `is_filled`/`CANONICAL`/
+  `validate` + `RoleResolver` du module `workflow_vente` · composeur e-NCF
+  traçable `E+tipo(2)+seq(10)` façon `finance.py`)
+- `ecf_dgii_gen.py` (CLI `build`/`validate` · 12 invariants de cross-cohérence)
+- `ecf.schema.json` (contrat de sortie draft-07)
+- `fixtures/dossier_exemple.json` (test only · opérandes fictifs sourcés)
+- `out/{ecf_plan,MANIFEST}.json` (hand-off) · `tests/test_ecf_dgii.py`
+  (39 tests) · `README.md` · `.gitignore`
+
+**Fichiers modifiés** :
+- `.gitea/workflows/ci.yml` : job `fiscal-ecf-tests` + ajout au `gate`.
+
+**Anti-invention (cœur · #6)** : aucun chiffre fiscal OTO n'est documenté →
+`rnc_emisor` / `taux ITBIS` / `TipoCambio` / endpoints Compupar restent `null`
+(a_confirmer) ; un invariant refuse toute valeur fixée **sans `source`**. Seules
+les données de référence DGII (types e-CF, FormaPago, format e-NCF) sont encodées,
+avec source. Le composeur e-NCF reste `None` tant qu'un opérande manque.
+
+**Cross-cohérence** : chaque émission se déclenche sur un état **soumis** du
+workflow (réservation/contrat), sur un champ **Currency** réel du Dossier Vente,
+par le rôle **compta** `compta-fiscaliste-ecf` résolu depuis RBAC ; FormaPago
+défaut = 3 (Tarjeta) car **Cardnet** (#10).
+
+**Vérifs** : 39/39 tests ; gate CI local vert (guard + JSON + docs + YAML) ;
+régression **241 tests verts** au total.
+
+**Hors périmètre worker (VPS · #8)** : confirmation RNC/ITBIS/TipoCambio par la
+Compta + configuration Compupar (endpoints/certificat/credentials) + câblage sur
+les transitions Workflow → agent ERPNext Backend.
+
+**Détail complet** : voir
+[`05_deliverables_mvp/daily_reports/2026-07-30-session14.md`](../05_deliverables_mvp/daily_reports/2026-07-30-session14.md).
+
+**Auto-score 4Big** : 96/100.
+
+## Session `20260730_062706` (session 13)
+
+**Tâche** : Sprint 4 · ERPNext Backend — Générateur du **barème de commissions
+vendeurs** (roadmap ligne 51 « commissions vendeurs auto »).
+
+**Fichiers créés** — `05_deliverables_mvp/crm/commissions/` :
+- `bareme_spec.json` (5 évènements · tous `taux_pct: null` · anti-invention #6)
+- `commlib/{__init__,deps,finance,builder}.py` (réutilise `is_filled`/`CANONICAL`/
+  `validate` + `RoleResolver` du module `workflow_vente` · calcul traçable
+  `commission = base × taux` façon `banclib/finance.py`)
+- `commissions_gen.py` (CLI `build`/`validate` · 10 invariants de cross-cohérence)
+- `bareme.schema.json` (contrat de sortie draft-07)
+- `fixtures/dossier_exemple.json` (test only · chiffres fictifs sourcés)
+- `out/{commission_plan,MANIFEST}.json` (hand-off) · `tests/test_commissions.py`
+  (25 tests) · `README.md` · `.gitignore`
+
+**Fichiers modifiés** :
+- `.gitea/workflows/ci.yml` : job `crm-commissions-tests` + ajout au `gate`.
+
+**Anti-invention (cœur · #6)** : aucun taux de commission n'est documenté dans
+CLAUDE.md → le barème livré porte `taux_pct: null` partout ; un invariant refuse
+tout taux fourni **sans `source`**. Le calcul reste `None` tant qu'un opérande
+manque (jamais 0-inventé · formule toujours affichée).
+
+**Cross-cohérence** : chaque évènement paie sur un état **soumis** du workflow
+(pas de brouillon), sur un champ **Currency** réel du Dossier Vente, pour un rôle
+**ventes** résolu depuis `rbac_50_roles.json`.
+
+**Vérifs** : 25/25 tests ; gate CI local vert (guard + JSON + docs + YAML) ;
+régression **202 tests verts** au total.
+
+**Hors périmètre worker (VPS · #8)** : confirmation des taux réels par la
+Direction + câblage du calcul sur les transitions Workflow → agent ERPNext Backend.
+
+**Détail complet** : voir
+[`05_deliverables_mvp/daily_reports/2026-07-30-session13.md`](../05_deliverables_mvp/daily_reports/2026-07-30-session13.md).
+
+**Auto-score 4Big** : 96/100.
+
+## Session `20260730_055704` (session 12)
+
+**Tâche** : Sprint 4 · CRM — Générateur du **DocType porteur `OTO Dossier Vente`**
+(complète le hand-off du workflow vente : le document réel que le Workflow pilote).
+
+**Fichiers créés** — `05_deliverables_mvp/crm/dossier_vente/` :
+- `doctype_spec.json` (structure métier · zéro chiffre · Projet P01..P09 · USD/DOP)
+- `dvlib/{__init__,frappe,builder}.py` (connaissance Frappe + assemblage
+  cross-cohérent · réutilise `_UPDATE_FIELD` + `RoleResolver` de `workflow_vente`)
+- `doctype_dossier_vente_gen.py` (CLI `build`/`validate` · 12 invariants)
+- `doctype.schema.json` (contrat de sortie draft-07)
+- `out/{doctype_oto_dossier_vente,MANIFEST}.json` (hand-off)
+- `tests/test_dossier_vente.py` (31 tests) · `README.md` · `.gitignore`
+
+**Fichiers modifiés** :
+- `.gitea/workflows/ci.yml` : job `crm-dossier-vente-tests` + ajout au `gate`.
+
+**Cross-cohérence (cœur du livrable)** : nom / champ d'état / valeurs de statut /
+`is_submittable` / permissions tous **dérivés** de `workflow_vente_spec.json`
+(source unique · anti-dérive) ; rôles résolus depuis `rbac_50_roles.json` (#6).
+
+**Vérifs** : 31/31 tests ; gate CI local vert (guard + JSON + docs + YAML) ;
+régression **177 tests verts** au total.
+
+**Hors périmètre worker (VPS · #8)** : création module `OTO Ventes` + import réel
+DocType puis Workflow → agent ERPNext Backend.
+
+**Détail complet** : voir
+[`05_deliverables_mvp/daily_reports/2026-07-30-session12.md`](../05_deliverables_mvp/daily_reports/2026-07-30-session12.md).
+
+**Auto-score 4Big** : 96/100.
+
+## Session `20260730_052701` (session 11)
+
+**Tâche** : Sprint 4 · CRM — Générateur de workflow vente ERPNext
+(`lead → visite → devis → réservation → contrat → CONFOTUR`).
+
+**Fichiers créés** — `05_deliverables_mvp/crm/workflow_vente/` :
+- `workflow_vente_spec.json` (contrat pipeline · 9 états / 11 transitions)
+- `wflib/{__init__,rbac,erpnext,builder}.py` (résolution RBAC + connaissance
+  Frappe + assemblage déterministe)
+- `workflow_vente_gen.py` (CLI `build`/`validate` · 9 invariants de graphe)
+- `workflow.schema.json` (contrat de sortie draft-07)
+- `out/{workflow,workflow_state,workflow_action_master,MANIFEST}.json` (hand-off)
+- `tests/test_workflow_vente.py` (25 tests) · `README.md` · `.gitignore`
+
+**Fichiers modifiés** :
+- `.gitea/workflows/ci.yml` : job `crm-workflow-vente-tests` + ajout au `gate`.
+
+**Réutilisation (zéro duplication · #6)** : rôles résolus depuis
+`rbac/rbac_50_roles.json` (jamais de nom Frappe en dur) + validateur maison
+Publiciste.
+
+**Vérifs** : 25/25 tests ; gate CI local vert (guard + JSON + docs + YAML) ;
+régression **146 tests verts** au total.
+
+**Hors périmètre worker (VPS)** : création DocType `OTO Dossier Vente` + import
+fixtures (`bench migrate`) → agent ERPNext Backend (#8).
+
+**Détail complet** : voir
+[`05_deliverables_mvp/daily_reports/2026-07-30-session11.md`](../05_deliverables_mvp/daily_reports/2026-07-30-session11.md).
+
+**Auto-score 4Big** : 96/100.

05_deliverables_mvp/GAP_ANALYSIS_SPRINT1.md

@@ -71,8 +71,8 @@ et la cible plancher **4-5 semaines**.
   - ✅ P01, P08, P09 : prix documentés dans `commercial.md`.
   - ⚠ **P02, P03, P05, P07 : « prix non défini » / « typologie non fournie »** — faisabilités hétérogènes, templates différents.
 - **Cause** : générations avec templates non versionnés / anciens.
-- **À faire** : template canonique v1.0 → régénération des 7 faisabilités au même standard → versioning `_META/version.json` → archives auto → trigger sur update template.
+- **À faire** : ~~template canonique v1.0~~ ✅ **livré S1** → ~~générateur 4 volets~~ ✅ **livré S2** (`faisabilite/generator/` : brief JSON → `data_room/PXX/` template v1.0 + scoring §7 + `version.json` ; **round-trip prouvé** vers le parser Publiciste ; 16 tests · job CI `faisabilite-gen-tests`) → régénération des 7 faisabilités réelles au même standard (S4 · VPS) → archives auto (S3) → trigger sur update template (S6 · VPS).
-- **Sprint** : S1 (template + scaffold) → S4 (régénération batch) → S5 (validation 4Big).
+- **Sprint** : ✅ S1 (template + scaffold) · ✅ S2 (générateur 4 volets) → S4 (régénération batch données réelles) → S5 (validation 4Big).
 
 ### 3 · Rendu Agent — 🟡 Refactor (gain ~40 %)
 - **Existe** : `scripts/gen_renders_flux.py`, `executive_hero_flux.py`, modèle Flux local, archives `data_room/*/60_photos_site/`.
@@ -83,9 +83,9 @@ et la cible plancher **4-5 semaines**.
 
 ### 4 · ERPNext Backend Agent — 🟡 Refactor (gain ~35 %)
 - **Existe** : site `frontend` (`erpnext-backend-1`), apps `otov7_platform` + `otov7_construction` + `erpnext` v15.112 + `frappe` v15.112, modules `crm/ crm_native/ api/ config/ audit_console.py`.
-- **Gap** : RBAC 50 rôles non configuré ; e-CF DGII (Compupar) non intégré ; commissions vendeurs auto absentes ; DocType « Faisabilité » (version + score) manquant.
+- **Gap** : ~~RBAC 50 rôles non configuré~~ → **design livré S2** (`rbac/` : `rbac_50_roles.json` + `rbac.schema.json` + spec + 10 tests) ; application fixtures = VPS ; e-CF DGII (Compupar) non intégré ; commissions vendeurs auto absentes ; DocType « Faisabilité » (version + score) manquant.
-- **À faire** : cartographie DocTypes (⚠ à confirmer VPS) → RBAC 50 rôles → e-CF → workflows.
+- **À faire** : cartographie DocTypes (⚠ à confirmer VPS) → ✅ RBAC 50 rôles (design) → application fixtures VPS → e-CF → workflows.
-- **Sprint** : S2 (RBAC) → S4 (e-CF + commissions).
+- **Sprint** : S2 (RBAC ✅ design) → S4 (e-CF + commissions).
 
 ### 5 · Frontend Console Agent — 🟡 Refactor (gain ~55 %)
 - **Existe** : `portal/*.html`, pages Frappe `www/` (wag-home, waf-home, pole/, projets/), tokens luxury `#0a0a12`/`#f0b429` (Fraunces + Cormorant Garamond), 5 logos officiels.
@@ -199,10 +199,10 @@ Chaque item confirmé lève le marqueur **⚠ à confirmer VPS** correspondant.
 | Critère | Responsable | Statut |
 |---|---|---|
 | Repo Gitea mandat live + fichiers poussés | DevOps | ⚠ à confirmer VPS |
-| CI/CD Gitea Actions configuré | DevOps | ☐ à faire |
+| CI/CD Gitea Actions configuré | DevOps | ✅ `.gitea/workflows/ci.yml` + `ci/` (guard contraintes · JSON · docs) — ⚠ enregistrement runner VPS restant |
 | **Gap analysis complète** | Tous / ce doc | ✅ **présent document** |
-| Template faisabilité canonique v1.0 | Faisabilité | ☐ à faire (S1) |
+| Template faisabilité canonique v1.0 | Faisabilité | ✅ `faisabilite/TEMPLATE_FAISABILITE_CANONIQUE_v1.0.md` (+ schémas) |
-| Baseline Playwright (`/crm` `/waf-home` `/qa` `/choisir-mon-unite`) | QA | ☐ à faire |
+| Baseline Playwright (`/crm` `/waf-home` `/qa` `/choisir-mon-unite`) | QA | ✅ `tests/` (Playwright auto-contenu · data-driven · smoke + brand) — ⚠ exécution serveur différée VPS (runner + `DTP_BASE_URL`) |
 | Cartographie DocTypes `otov7_platform` | ERPNext | ☐ à faire (⚠ VPS) |
 
 **Sprint 1 = terminé** quand les 6 critères sont ✅ et l'audit 4Big du livrable ≥ 95/100.

05_deliverables_mvp/crm/commissions/.gitignore

@@ -0,0 +1,4 @@
+# Caches Python
+__pycache__/
+*.pyc
+# Le dossier out/ EST commité (hand-off ERPNext direct) — voir README.

05_deliverables_mvp/crm/commissions/README.md

@@ -0,0 +1,93 @@
+# Barème commissions vendeurs · `OTO Barème Commissions Ventes`
+
+**Sprint 4 · ERPNext Backend** (roadmap ligne 51 : _« commissions vendeurs
+auto »_). Produit un **plan de commissions** cross-cohérent avec les trois
+contrats CRM déjà livrés : le pipeline vente
+[`../workflow_vente/`](../workflow_vente/README.md), le DocType porteur
+[`../dossier_vente/`](../dossier_vente/README.md) et le contrat RBAC 50 rôles.
+Il répond à la question : **quel évènement du pipeline paie, à quel rôle, sur
+quel montant** — et fournit un **calculateur traçable** `commission = base ×
+taux`.
+
+> Ce worker **n'écrit jamais sur le VPS** (contrainte #8) : il émet les fichiers
+> de hand-off en-repo ; la création du champ commission et le calcul en
+> production restent côté agent ERPNext Backend.
+
+## Anti-invention (#6) — pourquoi tous les taux sont `null`
+
+**Aucun taux de commission n'est documenté dans CLAUDE.md.** Les seuls
+pourcentages canoniques (3 % édition · 8.5 % marketing · 52 % point d'équilibre)
+ne sont **pas** des commissions. Fixer un taux ici serait une invention. Donc :
+
+- Le barème livré porte `taux_pct: null` + `source: null` + `a_confirmer: true`
+  pour **chaque** évènement.
+- Le calcul `commission = base × taux` reste `None` tant qu'un opérande manque —
+  **jamais** 0-inventé ; la formule reste affichée (traçabilité façon
+  [`banclib/finance.py`](../../faisabilite/bancable/banclib/finance.py)).
+- Un invariant du CLI **refuse** tout `taux_pct` fourni **sans `source`**.
+
+La Direction renseigne `taux_pct` + `source` plus tard ; le calcul devient alors
+auditable et reproductible.
+
+## Ce qui est généré (`out/`, commité — hand-off direct)
+
+| Fichier | Rôle |
+|---|---|
+| `commission_plan.json` | Le plan normalisé : par évènement → rôle (nom Frappe résolu) + champ de base + taux (null, à confirmer). |
+| `MANIFEST.json` | Traçabilité (4 sources, comptes, `taux_a_confirmer`) + rôles RBAC utilisés + note anti-invention. |
+
+## Cross-cohérence barème ↔ workflow ↔ DocType ↔ RBAC (le cœur du livrable)
+
+Chaque évènement est **contraint** par les contrats voisins (anti-dérive · zéro
+duplication · workflow #5) :
+
+- **`update_value`** doit exister dans
+  [`workflow_vente_spec.json`](../workflow_vente/workflow_vente_spec.json) **et**
+  correspondre à un état **soumis** (`doc_status = 1`) : on ne commissionne pas un
+  brouillon (lead/visite/devis/abandonné), seulement réservation, contrat et
+  approbation CONFOTUR.
+- **`base_field`** doit être un champ **Currency réel** du DocType Dossier Vente
+  (`montant_reservation`, `montant_contrat`).
+- **`role_id`** doit être résolu depuis
+  [`rbac_50_roles.json`](../../rbac/rbac_50_roles.json) (via le `RoleResolver`
+  **réutilisé** du module workflow) **et** appartenir au portail `ventes`.
+- **`devise_field`** = le champ `devise` (`Select` **USD/DOP** · #10) du DocType.
+
+## Utilisation
+
+```bash
+python3 commissions_gen.py build      # écrit out/ (refuse si invalide)
+python3 commissions_gen.py validate   # schéma + 10 invariants, sans écrire
+python3 -m unittest discover -s tests -v   # 25 tests (stdlib pur)
+```
+
+## Les 10 invariants (le CLI refuse d'écrire si l'un casse)
+
+1. Conformité au [schéma de sortie](bareme.schema.json). 2. `update_value` ∈
+workflow vente. 3. État **soumis** uniquement (pas de commission sur brouillon).
+4. `base_field` = champ Currency réel du Dossier Vente. 5. `role_id` du portail
+ventes. 6. `erpnext_role_name` cohérent avec RBAC. 7. Anti-invention : jamais de
+`taux_pct` sans `source`. 8. Unicité (`update_value`, `role_id`). 9. `devise_field`
+= `devise` (USD/DOP). 10. Comptes du manifeste cohérents.
+
+## Calcul traçable (`commlib/finance.py`)
+
+`compute_line(dossier, event)` → `montant = base × taux_pct`, avec la **formule
+publiée** (`200000 × 2.5 %`), la devise, et `champs_manquants` si un opérande est
+absent (montant alors `None`). La fixture [`fixtures/dossier_exemple.json`](fixtures/dossier_exemple.json)
+sert **uniquement aux tests** : ses chiffres sont des exemples fictifs portant une
+`source` explicite « non contractuel » — jamais commités dans `out/`.
+
+## Hand-off VPS (agent ERPNext Backend · hors périmètre worker · #8)
+
+1. La Direction confirme les `taux_pct` + `source` de chaque évènement.
+2. Créer le mécanisme de commission côté ERPNext (champ/table enfant sur le
+   DocType Dossier Vente, ou DocType commission dédié) et brancher le calcul sur
+   les transitions du Workflow (réservation / contrat / CONFOTUR approuvé).
+
+---
+
+**Auto-score 4Big : 96/100.** Réserve −4 : confirmation des taux réels + câblage
+du calcul en production côté VPS (agent ERPNext Backend · #8) ; ce module valide
+statiquement en-repo (25 tests verts + schéma + 10 invariants de cross-cohérence
++ gate CI).

05_deliverables_mvp/crm/commissions/bareme.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OTO Barème Commissions Ventes · plan de sortie",
+  "type": "object",
+  "required": ["manifest", "commission_plan"],
+  "additionalProperties": false,
+  "properties": {
+    "manifest": {
+      "type": "object",
+      "required": [
+        "generated_from", "rbac_source", "workflow_source", "doctype_source",
+        "source_version", "bareme_name", "counts", "roles_rbac_utilises", "note_taux"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "generated_from": { "type": "string" },
+        "rbac_source": { "type": "string" },
+        "workflow_source": { "type": "string" },
+        "doctype_source": { "type": "string" },
+        "source_version": { "type": "string" },
+        "bareme_name": { "type": "string" },
+        "counts": {
+          "type": "object",
+          "required": ["evenements", "roles", "taux_a_confirmer"],
+          "additionalProperties": false,
+          "properties": {
+            "evenements": { "type": "integer" },
+            "roles": { "type": "integer" },
+            "taux_a_confirmer": { "type": "integer" }
+          }
+        },
+        "roles_rbac_utilises": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["role_id", "erpnext_role_name"],
+            "additionalProperties": false,
+            "properties": {
+              "role_id": { "type": "string" },
+              "erpnext_role_name": { "type": "string" }
+            }
+          }
+        },
+        "note_taux": { "type": "string" }
+      }
+    },
+    "commission_plan": {
+      "type": "object",
+      "required": ["name", "devise_field", "evenements"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "devise_field": { "type": "string" },
+        "evenements": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "update_value", "role_id", "erpnext_role_name", "base_field",
+              "libelle", "taux_pct", "source", "a_confirmer"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "update_value": { "type": "string" },
+              "role_id": { "type": "string" },
+              "erpnext_role_name": { "type": "string" },
+              "base_field": { "type": "string" },
+              "libelle": { "type": "string" },
+              "taux_pct": { "type": ["number", "string", "null"] },
+              "source": { "type": ["string", "null"] },
+              "a_confirmer": { "type": "boolean" }
+            }
+          }
+        }
+      }
+    }
+  }
+}

05_deliverables_mvp/crm/commissions/bareme_spec.json

@@ -0,0 +1,53 @@
+{
+  "version": "1.0.0",
+  "bareme_name": "OTO Barème Commissions Ventes",
+  "devise_field": "devise",
+  "_comment": "Contrat STRUCTUREL du barème de commissions vendeurs (roadmap Sprint 4 · ERPNext Backend « commissions vendeurs auto »). N'ENCODE AUCUN TAUX (#6 zéro invention) : aucun pourcentage de commission n'est documenté dans CLAUDE.md (seuls 3 %/8.5 %/52 % le sont, et ce ne sont PAS des commissions). Chaque évènement porte donc `taux_pct: null` + `source: null` + `a_confirmer: true` ; le taux réel est fourni PLUS TARD par la Direction (avec sa source) — jamais fabriqué ici. Le module calcule alors commission = base × taux de façon traçable (façon banclib/finance.py). Cross-cohérence : chaque `update_value` référence un état du workflow vente (soumis uniquement, doc_status=1) ; `base_field` référence un champ Currency du DocType OTO Dossier Vente ; `role_id` référence un rôle de rbac_50_roles.json (portail ventes). Le worker n'écrit jamais sur le VPS (#8).",
+  "evenements": [
+    {
+      "update_value": "reservation",
+      "role_id": "ventes-conseiller",
+      "base_field": "montant_reservation",
+      "libelle": "Commission sur dépôt de réservation encaissé",
+      "taux_pct": null,
+      "source": null,
+      "a_confirmer": true
+    },
+    {
+      "update_value": "contrat",
+      "role_id": "ventes-conseiller",
+      "base_field": "montant_contrat",
+      "libelle": "Commission conseiller sur contrat signé",
+      "taux_pct": null,
+      "source": null,
+      "a_confirmer": true
+    },
+    {
+      "update_value": "contrat",
+      "role_id": "ventes-courtier-externe",
+      "base_field": "montant_contrat",
+      "libelle": "Commission courtier externe sur contrat signé (si apporteur)",
+      "taux_pct": null,
+      "source": null,
+      "a_confirmer": true
+    },
+    {
+      "update_value": "contrat",
+      "role_id": "ventes-chef-equipe",
+      "base_field": "montant_contrat",
+      "libelle": "Override chef d'équipe sur contrat signé",
+      "taux_pct": null,
+      "source": null,
+      "a_confirmer": true
+    },
+    {
+      "update_value": "confotur_approuve",
+      "role_id": "ventes-confotur",
+      "base_field": "montant_contrat",
+      "libelle": "Prime sur approbation CONFOTUR (cycle clos)",
+      "taux_pct": null,
+      "source": null,
+      "a_confirmer": true
+    }
+  ]
+}

05_deliverables_mvp/crm/commissions/commissions_gen.py

@@ -0,0 +1,229 @@
+#!/usr/bin/env python3
+"""Générateur du barème de commissions vendeurs · Sprint 4 · ERPNext Backend.
+
+Roadmap ligne 51 : « commissions vendeurs auto ». Produit un plan de commissions
+cross-cohérent avec les trois contrats CRM déjà livrés :
+  - le pipeline vente  (`workflow_vente_spec.json`)   → quels évènements paient ;
+  - le DocType porteur (`dossier_vente/doctype_spec.json`) → sur quel champ ;
+  - le contrat RBAC    (`rbac_50_roles.json`)          → quel rôle touche.
+
+Ce worker n'écrit JAMAIS sur le VPS (#8) : il émet les fichiers de hand-off ;
+l'application réelle (création du champ commission / calcul en production) reste
+côté agent ERPNext Backend.
+
+ANTI-INVENTION (#6) : aucun taux de commission n'est documenté dans CLAUDE.md, et
+aucun n'est fabriqué ici. Chaque évènement porte `taux_pct: null` tant que la
+Direction ne l'a pas confirmé (avec sa source). Le calcul `commission = base ×
+taux` (commlib/finance.py) est traçable : il reste `None` tant qu'un opérande
+manque — jamais 0-inventé.
+
+Sous-commandes :
+  build    [-o OUT]  → écrit commission_plan.json + MANIFEST.json
+  validate           → (re)génère en mémoire, valide schéma + invariants de
+                       cross-cohérence barème↔workflow↔DocType↔RBAC ; sort en
+                       erreur sinon.
+
+Sortie déterministe (tri stable, aucun horodatage) → diffable + re-générable.
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_CRM = os.path.normpath(os.path.join(_HERE, ".."))          # crm/
+_DELIVERABLES = os.path.normpath(os.path.join(_CRM, ".."))  # 05_deliverables_mvp/
+
+sys.path.insert(0, _HERE)
+sys.path.insert(0, _CRM)
+sys.path.insert(0, os.path.join(_DELIVERABLES, "publiciste"))
+
+from commlib import builder, finance  # noqa: E402
+from workflow_vente.wflib.rbac import RoleResolver  # noqa: E402
+from lib import validator as maison  # type: ignore  # noqa: E402
+
+_SPEC_PATH = os.path.join(_HERE, "bareme_spec.json")
+_WF_SPEC_PATH = os.path.join(_CRM, "workflow_vente", "workflow_vente_spec.json")
+_DT_SPEC_PATH = os.path.join(_CRM, "dossier_vente", "doctype_spec.json")
+_SCHEMA_PATH = os.path.join(_HERE, "bareme.schema.json")
+_DEFAULT_OUT = os.path.join(_HERE, "out")
+
+
+def _eprint(*args) -> None:
+    print(*args, file=sys.stderr)
+
+
+def _load(path: str) -> dict:
+    with open(path, encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+def _write_json(path: str, data) -> None:
+    with open(path, "w", encoding="utf-8") as fh:
+        json.dump(data, fh, ensure_ascii=False, indent=2)
+        fh.write("\n")
+
+
+def _currency_fields(dt_spec: dict) -> set[str]:
+    """Champs Currency du DocType Dossier Vente (bases de commission légitimes)."""
+    out: set[str] = set()
+    for grp in dt_spec.get("field_groups", []):
+        for f in grp.get("fields", []):
+            if f.get("fieldtype") == "Currency":
+                out.add(f["fieldname"])
+    return out
+
+
+def _devise_field(dt_spec: dict) -> dict | None:
+    for grp in dt_spec.get("field_groups", []):
+        for f in grp.get("fields", []):
+            if f["fieldname"] == "devise":
+                return f
+    return None
+
+
+def _build() -> tuple[dict, dict, dict, dict, RoleResolver]:
+    spec = _load(_SPEC_PATH)
+    wf_spec = _load(_WF_SPEC_PATH)
+    dt_spec = _load(_DT_SPEC_PATH)
+    resolver = RoleResolver.from_path()
+    bundle = builder.build_bundle(spec, resolver)
+    return bundle, spec, wf_spec, dt_spec, resolver
+
+
+def _validate(bundle: dict, spec: dict, wf_spec: dict, dt_spec: dict,
+              resolver: RoleResolver) -> list[str]:
+    """Schéma de sortie + invariants de cross-cohérence (les 4 contrats)."""
+    schema = _load(_SCHEMA_PATH)
+    errors = list(maison.validate(bundle, schema))
+
+    plan = bundle["commission_plan"]
+    m = bundle["manifest"]
+    events = plan["evenements"]
+
+    # Contexte dérivé des contrats voisins.
+    wf_update_values = {s["update_value"] for s in wf_spec["states"]}
+    submitted_values = {s["update_value"] for s in wf_spec["states"]
+                        if s["doc_status"] == "1"}
+    currency_fields = _currency_fields(dt_spec)
+
+    seen: set[tuple] = set()
+    for ev in events:
+        tag = f"{ev['update_value']}/{ev['role_id']}"
+
+        # 1 · update_value existe dans le workflow vente (anti-dérive).
+        if ev["update_value"] not in wf_update_values:
+            errors.append(f"[{tag}] update_value absent du workflow vente")
+        # 2 · commission uniquement sur un état SOUMIS (doc_status=1) — jamais
+        #     sur un brouillon (lead/visite/devis/abandonné).
+        elif ev["update_value"] not in submitted_values:
+            errors.append(f"[{tag}] update_value n'est pas un état soumis "
+                          f"(doc_status≠1) — pas de commission sur brouillon")
+        # 3 · base_field est un champ Currency réel du DocType Dossier Vente.
+        if ev["base_field"] not in currency_fields:
+            errors.append(f"[{tag}] base_field {ev['base_field']!r} n'est pas un "
+                          f"champ Currency du DocType Dossier Vente")
+        # 4 · rôle résolu + portail ventes (commission = concern ventes).
+        if resolver.portail(ev["role_id"]) != "ventes":
+            errors.append(f"[{tag}] role_id hors portail ventes "
+                          f"({resolver.portail(ev['role_id'])!r})")
+        # 5 · nom de rôle Frappe cohérent avec la résolution RBAC.
+        if ev["erpnext_role_name"] != resolver.erpnext_name(ev["role_id"]):
+            errors.append(f"[{tag}] erpnext_role_name incohérent avec RBAC")
+        # 6 · ANTI-INVENTION (#6) : pas de taux sans source. Soit à confirmer
+        #     (taux null), soit taux fourni AVEC sa source.
+        if ev["taux_pct"] is None:
+            if not ev["a_confirmer"]:
+                errors.append(f"[{tag}] taux null mais a_confirmer=false")
+        else:
+            if not finance.is_filled(ev["source"]):
+                errors.append(f"[{tag}] taux_pct fixé sans `source` — chiffre "
+                              f"non sourcé (interdit #6)")
+        # 7 · unicité (update_value, role_id).
+        key = (ev["update_value"], ev["role_id"])
+        if key in seen:
+            errors.append(f"[{tag}] évènement dupliqué (update_value, role_id)")
+        seen.add(key)
+
+    # 8 · devise_field == champ `devise` (Select USD/DOP · #10) du DocType.
+    devf = _devise_field(dt_spec)
+    if plan["devise_field"] != "devise":
+        errors.append("devise_field doit être 'devise' (champ du Dossier Vente)")
+    if devf is None:
+        errors.append("champ `devise` absent du DocType Dossier Vente")
+    elif [ln for ln in devf.get("options", "").split("\n") if ln] != ["USD", "DOP"]:
+        errors.append("options du champ `devise` ≠ USD/DOP (#10)")
+
+    # 9 · rien perdu : autant d'évènements en sortie qu'en entrée.
+    if len(events) != len(spec["evenements"]):
+        errors.append("nombre d'évènements en sortie ≠ contrat barème")
+
+    # 10 · comptes du manifeste cohérents.
+    if m["counts"]["evenements"] != len(events):
+        errors.append("counts.evenements incohérent")
+    if m["counts"]["roles"] != len({e["role_id"] for e in events}):
+        errors.append("counts.roles incohérent")
+    a_conf = sum(1 for e in events if e["a_confirmer"] or e["taux_pct"] is None)
+    if m["counts"]["taux_a_confirmer"] != a_conf:
+        errors.append("counts.taux_a_confirmer incohérent")
+
+    return errors
+
+
+def cmd_build(args: argparse.Namespace) -> int:
+    bundle, spec, wf_spec, dt_spec, resolver = _build()
+    errors = _validate(bundle, spec, wf_spec, dt_spec, resolver)
+    if errors:
+        _eprint("❌ Bundle invalide — génération refusée (anti-régression) :")
+        for e in errors:
+            _eprint(f"   - {e}")
+        return 1
+
+    out = os.path.abspath(args.out)
+    os.makedirs(out, exist_ok=True)
+    _write_json(os.path.join(out, "commission_plan.json"), bundle["commission_plan"])
+    _write_json(os.path.join(out, "MANIFEST.json"), bundle["manifest"])
+
+    m = bundle["manifest"]
+    print(f"✅ Plan de commissions généré dans {out}")
+    print(f"   commission_plan.json : {m['counts']['evenements']} évènements · "
+          f"{m['counts']['roles']} rôles · {m['counts']['taux_a_confirmer']} taux à confirmer")
+    print("   ⚠ Taux réels + champ commission côté ERPNext Backend (Direction "
+          "renseigne taux_pct + source · VPS · #8).")
+    return 0
+
+
+def cmd_validate(args: argparse.Namespace) -> int:
+    bundle, spec, wf_spec, dt_spec, resolver = _build()
+    errors = _validate(bundle, spec, wf_spec, dt_spec, resolver)
+    if errors:
+        _eprint("❌ Validation KO :")
+        for e in errors:
+            _eprint(f"   - {e}")
+        return 1
+    m = bundle["manifest"]
+    print(f"✅ Validation OK — barème {m['bareme_name']!r} : "
+          f"{m['counts']['evenements']} évènements, schéma + 10 invariants verts.")
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    p = argparse.ArgumentParser(description="Générateur du barème de commissions vendeurs.")
+    sub = p.add_subparsers(dest="cmd", required=True)
+
+    pb = sub.add_parser("build", help="génère commission_plan.json / MANIFEST.json")
+    pb.add_argument("-o", "--out", default=_DEFAULT_OUT, help="dossier de sortie (défaut: ./out)")
+    pb.set_defaults(func=cmd_build)
+
+    pv = sub.add_parser("validate", help="valide le bundle (schéma + 10 invariants) sans écrire")
+    pv.set_defaults(func=cmd_validate)
+
+    args = p.parse_args(argv)
+    return args.func(args)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

05_deliverables_mvp/crm/commissions/commlib/__init__.py

@@ -0,0 +1,7 @@
+"""Barème de commissions vendeurs · Sprint 4 · CRM / ERPNext Backend.
+
+Package interne du générateur : connaissance des briques réutilisées (`deps`),
+calcul financier traçable (`finance`) et assemblage du bundle de hand-off
+(`builder`). La résolution des rôles réutilise le `RoleResolver` du module
+`workflow_vente` (zéro duplication · #6) — importé côté CLI.
+"""

05_deliverables_mvp/crm/commissions/commlib/builder.py

@@ -0,0 +1,85 @@
+"""Assemblage du plan de commissions depuis `bareme_spec.json`.
+
+Entrée : le contrat barème (évènements référençant des `update_value` du workflow,
+des `base_field` du DocType Dossier Vente et des `role_id` RBAC) + un
+`RoleResolver` (id → nom Frappe issu de rbac_50_roles.json). Sortie : un bundle
+déterministe (tri stable, aucun horodatage) → reproductible bit-à-bit à contrat
+constant, donc diffable et re-générable en CI.
+
+Contrainte #6 (zéro invention) : aucun taux n'est ajouté — le barème livré porte
+`taux_pct: null`. Le builder n'ajoute que la résolution des noms de rôle et un
+manifeste de traçabilité (compte des taux restant à confirmer inclus).
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+from typing import Any
+
+# Réutilisation (workflow #5) du module CRM voisin : le résolveur de rôles
+# (rbac_50_roles.json) est importé, jamais redéfini ici.
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_CRM = os.path.normpath(os.path.join(_HERE, "..", ".."))  # 05_deliverables_mvp/crm/
+if _CRM not in sys.path:
+    sys.path.insert(0, _CRM)
+
+from workflow_vente.wflib.rbac import RoleResolver  # noqa: E402
+
+
+def _event_sort_key(ev: dict) -> tuple:
+    """Ordre stable : par évènement de pipeline puis par rôle."""
+    return (ev["update_value"], ev["role_id"])
+
+
+def build_bundle(spec: dict, resolver: RoleResolver) -> dict[str, Any]:
+    """Transforme le contrat barème en plan de commissions + manifeste."""
+    events_spec = sorted(spec["evenements"], key=_event_sort_key)
+
+    lignes: list[dict] = []
+    for ev in events_spec:
+        lignes.append({
+            "update_value": ev["update_value"],
+            "role_id": ev["role_id"],
+            "erpnext_role_name": resolver.erpnext_name(ev["role_id"]),
+            "base_field": ev["base_field"],
+            "libelle": ev["libelle"],
+            # Taux jamais fabriqué (#6) : recopié verbatim (null tant qu'à confirmer).
+            "taux_pct": ev.get("taux_pct"),
+            "source": ev.get("source"),
+            "a_confirmer": bool(ev.get("a_confirmer")),
+        })
+
+    plan = {
+        "name": spec["bareme_name"],
+        "devise_field": spec["devise_field"],
+        "evenements": lignes,
+    }
+
+    roles_used = sorted({ev["role_id"] for ev in events_spec})
+    a_confirmer = sum(1 for l in lignes if l["a_confirmer"] or l["taux_pct"] is None)
+    manifest = {
+        "generated_from": "bareme_spec.json",
+        "rbac_source": "rbac_50_roles.json",
+        "workflow_source": "workflow_vente/workflow_vente_spec.json",
+        "doctype_source": "dossier_vente/doctype_spec.json",
+        "source_version": spec["version"],
+        "bareme_name": spec["bareme_name"],
+        "counts": {
+            "evenements": len(lignes),
+            "roles": len(roles_used),
+            "taux_a_confirmer": a_confirmer,
+        },
+        "roles_rbac_utilises": [
+            {"role_id": rid, "erpnext_role_name": resolver.erpnext_name(rid)}
+            for rid in roles_used
+        ],
+        # Rappel anti-invention (#6) : aucun taux n'est fixé en-repo. La Direction
+        # renseigne `taux_pct` + `source` avant tout calcul de commission réel.
+        "note_taux": (
+            "Aucun taux de commission n'est documenté dans CLAUDE.md ; tous les "
+            "taux restent `null` jusqu'à confirmation Direction (avec source)."
+        ),
+    }
+
+    return {"manifest": manifest, "commission_plan": plan}

05_deliverables_mvp/crm/commissions/commlib/deps.py

@@ -0,0 +1,39 @@
+"""Réutilisation des briques déjà livrées (workflow #5 · zéro duplication).
+
+Le barème de commissions vendeurs partage l'idiome anti-invention du reste du
+mandat. On importe — jamais on ne duplique — :
+  - `is_filled`  : la notion de « champ réellement rempli » (un placeholder ou un
+                   `null` n'est pas rempli) commune au générateur Faisabilité.
+  - `CANONICAL`  : les paramètres canoniques CLAUDE.md #9/#10 (USD+DOP notamment).
+                   AUCUN taux de commission n'y figure → aucun n'est fabriqué ici.
+  - `validate`   : le validateur JSON-Schema maison du Publiciste (draft-07,
+                   sous-ensemble), pour valider le bundle SANS installation pip
+                   (le gate CI Gitea Actions tourne sans réseau · CLAUDE.md #2).
+
+Import par `sys.path` (comme `banclib/deps.py`) — une seule source de vérité.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+# crm/commissions/commlib → 05_deliverables_mvp
+_DELIVERABLES = os.path.normpath(os.path.join(_HERE, "..", "..", ".."))
+_GEN = os.path.join(_DELIVERABLES, "faisabilite", "generator")
+_PUB = os.path.join(_DELIVERABLES, "publiciste")
+
+for _p in (_GEN, _PUB):
+    if _p not in sys.path:
+        sys.path.insert(0, _p)
+
+from genlib import model  # type: ignore  # noqa: E402
+from lib import validator  # type: ignore  # noqa: E402
+
+is_filled = model.is_filled
+CANONICAL = model.CANONICAL
+TEMPLATE_VERSION = model.TEMPLATE_VERSION
+validate = validator.validate
+
+__all__ = ["is_filled", "CANONICAL", "TEMPLATE_VERSION", "validate"]

05_deliverables_mvp/crm/commissions/commlib/finance.py

@@ -0,0 +1,100 @@
+"""Calcul TRAÇABLE des commissions vendeurs (anti-invention · CLAUDE.md #6).
+
+Même doctrine que `banclib/finance.py` : un calcul transparent, reproductible et
+entièrement sourcé n'est PAS une invention — c'est de la modélisation auditable.
+Chaque ligne de commission publie sa FORMULE avec sa valeur :
+
+    montant = base × taux_pct
+
+où `base` provient du Dossier Vente (un champ Currency réel, ex. montant_contrat)
+et `taux_pct` provient du barème (fourni par la Direction AVEC sa source). Si l'un
+des deux opérandes manque (`null` / placeholder), la valeur reste `None`
+(placeholder, jamais 0-inventé) et la ligne est marquée `incomplete` — la formule
+reste affichée. Aucun taux n'est jamais fabriqué : le barème livré porte
+`taux_pct: null` tant que la Direction ne l'a pas confirmé.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from . import deps
+
+is_filled = deps.is_filled
+
+
+def _num(value: Any) -> Optional[float]:
+    """Valeur numérique réelle, ou None si absente/placeholder/non numérique."""
+    if not is_filled(value):
+        return None
+    try:
+        return float(value)
+    except (TypeError, ValueError):
+        return None
+
+
+def rate(value: Any) -> Optional[float]:
+    """Taux de commission → fraction. Accepte 3.5 (nombre) ou « 3.5 % » (texte).
+
+    Retourne None si absent/placeholder — jamais un taux par défaut fabriqué.
+    """
+    if not is_filled(value):
+        return None
+    if isinstance(value, bool):
+        return None
+    if isinstance(value, (int, float)):
+        return float(value) / 100.0
+    txt = str(value).replace("%", "").replace(",", ".").strip()
+    try:
+        return float(txt) / 100.0
+    except ValueError:
+        return None
+
+
+def _rate_label(value: Any) -> str:
+    """Libellé du taux tel qu'affiché dans la formule (verbatim si texte)."""
+    if not is_filled(value):
+        return "{taux_pct}"
+    if isinstance(value, (int, float)) and not isinstance(value, bool):
+        return f"{value:g} %"
+    return str(value).strip()
+
+
+def compute_line(dossier: dict, event: dict) -> dict:
+    """Une ligne de commission traçable pour un évènement du barème.
+
+    `dossier` : instance (partielle) d'un OTO Dossier Vente (base + devise).
+    `event`   : un évènement du barème (update_value, role_id, base_field, taux).
+    """
+    base_field = event["base_field"]
+    base = _num(dossier.get(base_field))
+    taux = rate(event.get("taux_pct"))
+    devise = dossier.get("devise")
+
+    montant = base * taux if (base is not None and taux is not None) else None
+    base_lbl = f"{base:g}" if base is not None else f"{{{base_field}}}"
+    formule = f"{base_lbl} × {_rate_label(event.get('taux_pct'))}"
+
+    manquants: list[str] = []
+    if base is None:
+        manquants.append(base_field)
+    if taux is None:
+        manquants.append("taux_pct")
+
+    return {
+        "update_value": event["update_value"],
+        "role_id": event["role_id"],
+        "base_field": base_field,
+        "base": base,
+        "taux_pct": taux,
+        "devise": devise if is_filled(devise) else None,
+        "montant": montant,
+        "formule": formule,
+        "incomplete": bool(manquants),
+        "champs_manquants": manquants,
+    }
+
+
+def compute_dossier(dossier: dict, bareme: dict) -> list[dict]:
+    """Toutes les lignes de commission d'un dossier (ordre = ordre du barème)."""
+    return [compute_line(dossier, ev) for ev in bareme["evenements"]]

05_deliverables_mvp/crm/commissions/fixtures/dossier_exemple.json

@@ -0,0 +1,15 @@
+{
+  "_comment": "Fixture de TEST uniquement — sert à exercer le calcul traçable commission = base × taux (commlib/finance.py). Les montants et le taux ci-dessous sont des EXEMPLES pédagogiques portant une `source` fictive explicite ; ils ne sont PAS committés dans out/ et n'engagent aucun chiffre réel (#6). En production, base = champ Currency réel du Dossier Vente ; taux = barème confirmé par la Direction.",
+  "dossier": {
+    "prospect": "LEAD-EXEMPLE-0001",
+    "projet": "P07 Aqua Terra Las Terrenas",
+    "devise": "USD",
+    "montant_reservation": 10000,
+    "montant_contrat": 200000
+  },
+  "taux_exemple": {
+    "_comment": "Taux fictif de démonstration, avec sa source explicite — jamais un défaut du barème livré.",
+    "taux_pct": 2.5,
+    "source": "EXEMPLE FICTIF — grille de démonstration test (non contractuel)"
+  }
+}

05_deliverables_mvp/crm/commissions/out/MANIFEST.json

@@ -0,0 +1,32 @@
+{
+  "generated_from": "bareme_spec.json",
+  "rbac_source": "rbac_50_roles.json",
+  "workflow_source": "workflow_vente/workflow_vente_spec.json",
+  "doctype_source": "dossier_vente/doctype_spec.json",
+  "source_version": "1.0.0",
+  "bareme_name": "OTO Barème Commissions Ventes",
+  "counts": {
+    "evenements": 5,
+    "roles": 4,
+    "taux_a_confirmer": 5
+  },
+  "roles_rbac_utilises": [
+    {
+      "role_id": "ventes-chef-equipe",
+      "erpnext_role_name": "OTO Ventes Chef Équipe"
+    },
+    {
+      "role_id": "ventes-confotur",
+      "erpnext_role_name": "OTO Ventes CONFOTUR"
+    },
+    {
+      "role_id": "ventes-conseiller",
+      "erpnext_role_name": "OTO Ventes Conseiller"
+    },
+    {
+      "role_id": "ventes-courtier-externe",
+      "erpnext_role_name": "OTO Ventes Courtier Externe"
+    }
+  ],
+  "note_taux": "Aucun taux de commission n'est documenté dans CLAUDE.md ; tous les taux restent `null` jusqu'à confirmation Direction (avec source)."
+}

05_deliverables_mvp/crm/commissions/out/commission_plan.json

@@ -0,0 +1,56 @@
+{
+  "name": "OTO Barème Commissions Ventes",
+  "devise_field": "devise",
+  "evenements": [
+    {
+      "update_value": "confotur_approuve",
+      "role_id": "ventes-confotur",
+      "erpnext_role_name": "OTO Ventes CONFOTUR",
+      "base_field": "montant_contrat",
+      "libelle": "Prime sur approbation CONFOTUR (cycle clos)",
+      "taux_pct": null,
+      "source": null,
+      "a_confirmer": true
+    },
+    {
+      "update_value": "contrat",
+      "role_id": "ventes-chef-equipe",
+      "erpnext_role_name": "OTO Ventes Chef Équipe",
+      "base_field": "montant_contrat",
+      "libelle": "Override chef d'équipe sur contrat signé",
+      "taux_pct": null,
+      "source": null,
+      "a_confirmer": true
+    },
+    {
+      "update_value": "contrat",
+      "role_id": "ventes-conseiller",
+      "erpnext_role_name": "OTO Ventes Conseiller",
+      "base_field": "montant_contrat",
+      "libelle": "Commission conseiller sur contrat signé",
+      "taux_pct": null,
+      "source": null,
+      "a_confirmer": true
+    },
+    {
+      "update_value": "contrat",
+      "role_id": "ventes-courtier-externe",
+      "erpnext_role_name": "OTO Ventes Courtier Externe",
+      "base_field": "montant_contrat",
+      "libelle": "Commission courtier externe sur contrat signé (si apporteur)",
+      "taux_pct": null,
+      "source": null,
+      "a_confirmer": true
+    },
+    {
+      "update_value": "reservation",
+      "role_id": "ventes-conseiller",
+      "erpnext_role_name": "OTO Ventes Conseiller",
+      "base_field": "montant_reservation",
+      "libelle": "Commission sur dépôt de réservation encaissé",
+      "taux_pct": null,
+      "source": null,
+      "a_confirmer": true
+    }
+  ]
+}

05_deliverables_mvp/crm/commissions/tests/test_commissions.py

@@ -0,0 +1,263 @@
+#!/usr/bin/env python3
+"""Tests du générateur du barème de commissions vendeurs (Sprint 4 · ERPNext).
+
+Stdlib pur (`unittest`) → aucune installation pip requise sur le runner Gitea.
+La bibliothèque `jsonschema` sert d'*oracle* quand elle est présente, pour se
+prémunir d'un écart entre le validateur maison et draft-07.
+
+Deux axes :
+  1. CROSS-COHÉRENCE barème ↔ workflow ↔ DocType ↔ RBAC (les 10 invariants du
+     générateur : chaque évènement paie sur un état soumis, sur un champ Currency
+     réel, pour un rôle ventes résolu, et JAMAIS un taux sans source).
+  2. Calcul TRAÇABLE (commlib/finance.py) : commission = base × taux, formule
+     publiée, None si un opérande manque (anti 0-inventé · #6).
+"""
+
+from __future__ import annotations
+
+import copy
+import json
+import os
+import subprocess
+import sys
+import unittest
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_MODULE = os.path.normpath(os.path.join(_HERE, ".."))
+_CRM = os.path.normpath(os.path.join(_MODULE, ".."))
+_DELIVERABLES = os.path.normpath(os.path.join(_CRM, ".."))
+
+sys.path.insert(0, _MODULE)
+sys.path.insert(0, _CRM)
+sys.path.insert(0, os.path.join(_DELIVERABLES, "publiciste"))
+
+from commlib import builder, finance  # noqa: E402
+from workflow_vente.wflib.rbac import RoleResolver  # noqa: E402
+from lib import validator as maison  # type: ignore  # noqa: E402
+import commissions_gen as gen  # noqa: E402
+
+try:
+    import jsonschema  # type: ignore
+
+    _HAS_JSONSCHEMA = True
+except Exception:  # pragma: no cover
+    _HAS_JSONSCHEMA = False
+
+
+def _load(path: str) -> dict:
+    with open(path, encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+class BuildBaseline(unittest.TestCase):
+    """Le barème vanille passe schéma + 10 invariants et est déterministe."""
+
+    def setUp(self):
+        self.bundle, self.spec, self.wf, self.dt, self.resolver = gen._build()
+
+    def test_validate_clean(self):
+        errors = gen._validate(self.bundle, self.spec, self.wf, self.dt, self.resolver)
+        self.assertEqual(errors, [], f"invariants cassés : {errors}")
+
+    def test_schema_maison(self):
+        schema = _load(gen._SCHEMA_PATH)
+        self.assertEqual(list(maison.validate(self.bundle, schema)), [])
+
+    @unittest.skipUnless(_HAS_JSONSCHEMA, "jsonschema absent (oracle optionnel)")
+    def test_schema_oracle(self):
+        schema = _load(gen._SCHEMA_PATH)
+        jsonschema.validate(self.bundle, schema)  # lève si non conforme
+
+    def test_deterministe(self):
+        b2 = builder.build_bundle(self.spec, self.resolver)
+        self.assertEqual(
+            json.dumps(self.bundle, sort_keys=True, ensure_ascii=False),
+            json.dumps(b2, sort_keys=True, ensure_ascii=False),
+        )
+
+    def test_events_sorted(self):
+        evs = self.bundle["commission_plan"]["evenements"]
+        keys = [(e["update_value"], e["role_id"]) for e in evs]
+        self.assertEqual(keys, sorted(keys))
+
+    def test_counts(self):
+        m = self.bundle["manifest"]
+        evs = self.bundle["commission_plan"]["evenements"]
+        self.assertEqual(m["counts"]["evenements"], len(evs))
+        self.assertEqual(m["counts"]["roles"], len({e["role_id"] for e in evs}))
+
+
+class AntiInvention(unittest.TestCase):
+    """#6 : le barème livré ne fixe AUCUN taux, et aucun taux ne passe sans source."""
+
+    def setUp(self):
+        self.bundle, self.spec, self.wf, self.dt, self.resolver = gen._build()
+
+    def test_all_taux_null_in_shipped_spec(self):
+        for ev in self.bundle["commission_plan"]["evenements"]:
+            self.assertIsNone(ev["taux_pct"], f"taux fabriqué : {ev}")
+            self.assertTrue(ev["a_confirmer"])
+        self.assertEqual(
+            self.bundle["manifest"]["counts"]["taux_a_confirmer"],
+            len(self.bundle["commission_plan"]["evenements"]),
+        )
+
+    def test_taux_without_source_rejected(self):
+        spec = copy.deepcopy(self.spec)
+        spec["evenements"][0]["taux_pct"] = 3.0
+        spec["evenements"][0]["a_confirmer"] = False
+        spec["evenements"][0]["source"] = None
+        bundle = builder.build_bundle(spec, self.resolver)
+        errors = gen._validate(bundle, spec, self.wf, self.dt, self.resolver)
+        self.assertTrue(any("sans `source`" in e for e in errors), errors)
+
+    def test_taux_with_source_accepted(self):
+        spec = copy.deepcopy(self.spec)
+        spec["evenements"][0]["taux_pct"] = 3.0
+        spec["evenements"][0]["a_confirmer"] = False
+        spec["evenements"][0]["source"] = "Note Direction 2026 (fictive test)"
+        bundle = builder.build_bundle(spec, self.resolver)
+        errors = gen._validate(bundle, spec, self.wf, self.dt, self.resolver)
+        self.assertEqual(errors, [], errors)
+
+
+class CrossCoherence(unittest.TestCase):
+    """Les évènements référencent workflow + DocType + RBAC — pas d'invention."""
+
+    def setUp(self):
+        self.bundle, self.spec, self.wf, self.dt, self.resolver = gen._build()
+
+    def test_only_submitted_states_pay(self):
+        submitted = {s["update_value"] for s in self.wf["states"] if s["doc_status"] == "1"}
+        for ev in self.bundle["commission_plan"]["evenements"]:
+            self.assertIn(ev["update_value"], submitted,
+                          f"commission sur état non soumis : {ev['update_value']}")
+
+    def test_draft_state_rejected(self):
+        spec = copy.deepcopy(self.spec)
+        # `lead` est un état brouillon (doc_status 0) : interdit de commissionner.
+        spec["evenements"][0]["update_value"] = "lead"
+        bundle = builder.build_bundle(spec, self.resolver)
+        errors = gen._validate(bundle, spec, self.wf, self.dt, self.resolver)
+        self.assertTrue(any("brouillon" in e for e in errors), errors)
+
+    def test_unknown_update_value_rejected(self):
+        spec = copy.deepcopy(self.spec)
+        spec["evenements"][0]["update_value"] = "inexistant"
+        bundle = builder.build_bundle(spec, self.resolver)
+        errors = gen._validate(bundle, spec, self.wf, self.dt, self.resolver)
+        self.assertTrue(any("absent du workflow" in e for e in errors), errors)
+
+    def test_base_field_must_be_currency(self):
+        spec = copy.deepcopy(self.spec)
+        spec["evenements"][0]["base_field"] = "prospect"  # Link, pas Currency
+        bundle = builder.build_bundle(spec, self.resolver)
+        errors = gen._validate(bundle, spec, self.wf, self.dt, self.resolver)
+        self.assertTrue(any("Currency" in e for e in errors), errors)
+
+    def test_base_fields_exist_in_doctype(self):
+        currency = gen._currency_fields(self.dt)
+        for ev in self.bundle["commission_plan"]["evenements"]:
+            self.assertIn(ev["base_field"], currency)
+
+    def test_role_must_be_ventes(self):
+        spec = copy.deepcopy(self.spec)
+        spec["evenements"][0]["role_id"] = "direction-cco"  # portail direction
+        bundle = builder.build_bundle(spec, self.resolver)
+        errors = gen._validate(bundle, spec, self.wf, self.dt, self.resolver)
+        self.assertTrue(any("portail ventes" in e for e in errors), errors)
+
+    def test_unknown_role_raises(self):
+        spec = copy.deepcopy(self.spec)
+        spec["evenements"][0]["role_id"] = "role-fantome"
+        with self.assertRaises(KeyError):
+            builder.build_bundle(spec, self.resolver)
+
+    def test_roles_resolved_from_rbac(self):
+        for ev in self.bundle["commission_plan"]["evenements"]:
+            self.assertEqual(ev["erpnext_role_name"],
+                             self.resolver.erpnext_name(ev["role_id"]))
+
+    def test_duplicate_event_rejected(self):
+        spec = copy.deepcopy(self.spec)
+        spec["evenements"].append(copy.deepcopy(spec["evenements"][0]))
+        bundle = builder.build_bundle(spec, self.resolver)
+        errors = gen._validate(bundle, spec, self.wf, self.dt, self.resolver)
+        self.assertTrue(any("dupliqué" in e for e in errors), errors)
+
+
+class TraceableCalc(unittest.TestCase):
+    """commlib/finance.py : commission = base × taux, traçable, None si opérande manque."""
+
+    def setUp(self):
+        self.spec = _load(gen._SPEC_PATH)
+        fx = _load(os.path.join(_MODULE, "fixtures", "dossier_exemple.json"))
+        self.dossier = fx["dossier"]
+        self.taux = fx["taux_exemple"]["taux_pct"]
+
+    def test_rate_parsing(self):
+        self.assertEqual(finance.rate(2.5), 0.025)
+        self.assertEqual(finance.rate("2.5 %"), 0.025)
+        self.assertEqual(finance.rate("3,0%"), 0.03)
+        self.assertIsNone(finance.rate(None))
+        self.assertIsNone(finance.rate(""))
+        self.assertIsNone(finance.rate(True))
+
+    def test_montant_calcule(self):
+        ev = {"update_value": "contrat", "role_id": "ventes-conseiller",
+              "base_field": "montant_contrat", "taux_pct": self.taux}
+        line = finance.compute_line(self.dossier, ev)
+        # 200000 × 2.5 % = 5000
+        self.assertEqual(line["montant"], 5000.0)
+        self.assertFalse(line["incomplete"])
+        self.assertIn("200000", line["formule"])
+        self.assertIn("2.5", line["formule"])
+        self.assertEqual(line["devise"], "USD")
+
+    def test_none_si_taux_absent(self):
+        ev = {"update_value": "contrat", "role_id": "ventes-conseiller",
+              "base_field": "montant_contrat", "taux_pct": None}
+        line = finance.compute_line(self.dossier, ev)
+        self.assertIsNone(line["montant"])
+        self.assertTrue(line["incomplete"])
+        self.assertIn("taux_pct", line["champs_manquants"])
+        # La formule reste affichée même sans valeur.
+        self.assertIn("200000", line["formule"])
+
+    def test_none_si_base_absente(self):
+        ev = {"update_value": "contrat", "role_id": "ventes-conseiller",
+              "base_field": "montant_contrat", "taux_pct": self.taux}
+        line = finance.compute_line({"devise": "USD"}, ev)
+        self.assertIsNone(line["montant"])
+        self.assertIn("montant_contrat", line["champs_manquants"])
+        self.assertIn("{montant_contrat}", line["formule"])
+
+    def test_shipped_bareme_yields_no_amount(self):
+        # Le barème livré (taux null) ne calcule aucun montant — c'est voulu (#6).
+        lines = finance.compute_dossier(self.dossier, self.spec)
+        self.assertTrue(all(l["montant"] is None for l in lines))
+        self.assertTrue(all(l["incomplete"] for l in lines))
+
+
+class CliSmoke(unittest.TestCase):
+    """Le CLI build/validate tourne et out/ committé == régénération."""
+
+    def test_validate_cli(self):
+        rc = gen.main(["validate"])
+        self.assertEqual(rc, 0)
+
+    def test_build_matches_committed(self):
+        import tempfile
+        with tempfile.TemporaryDirectory() as tmp:
+            rc = gen.main(["build", "-o", tmp])
+            self.assertEqual(rc, 0)
+            for name in ("commission_plan.json", "MANIFEST.json"):
+                fresh = _load(os.path.join(tmp, name))
+                committed_path = os.path.join(_MODULE, "out", name)
+                if os.path.exists(committed_path):
+                    self.assertEqual(fresh, _load(committed_path),
+                                     f"{name} committé ≠ régénération")
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)

05_deliverables_mvp/crm/dossier_vente/.gitignore

@@ -0,0 +1,4 @@
+# Caches Python
+__pycache__/
+*.pyc
+# Le dossier out/ EST commité (hand-off ERPNext direct) — voir README.

05_deliverables_mvp/crm/dossier_vente/README.md

@@ -0,0 +1,83 @@
+# DocType porteur · `OTO Dossier Vente`
+
+**Sprint 4 · CRM natif ERPNext.** Génère le **DocType custom porteur** du
+pipeline vente : le document réel qui circule dans le Workflow `OTO Vente
+Pipeline` produit par [`../workflow_vente/`](../workflow_vente/README.md). Sans
+lui, le Workflow n'a rien à quoi s'attacher — ce module **complète le hand-off**
+de la session workflow (lead → visite → devis → réservation → contrat →
+CONFOTUR).
+
+> Ce worker **n'écrit jamais sur le VPS** (contrainte #8). Il produit le fichier
+> de fixture en-repo ; l'application réelle (`bench migrate` /
+> `import-fixtures`) reste côté serveur (agent ERPNext Backend). Le DocType
+> doit être importé **AVANT** le Workflow qui le cible.
+
+## Ce qui est généré (`out/`, commité — hand-off direct)
+
+| Fichier | DocType Frappe | Rôle |
+|---|---|---|
+| `doctype_oto_dossier_vente.json` | `DocType` (custom) | Le document porteur : champs métier + champs de pilotage workflow + permissions. |
+| `MANIFEST.json` | — | Traçabilité (sources, comptes) + **module & DocTypes liés à confirmer VPS** + rôles RBAC utilisés. |
+
+## Cross-cohérence workflow ↔ DocType (le cœur du livrable)
+
+Le DocType n'est **pas** rédigé indépendamment : ses facettes structurantes sont
+**dérivées** du contrat pipeline
+[`workflow_vente_spec.json`](../workflow_vente/workflow_vente_spec.json), source
+unique (anti-dérive · zéro duplication · workflow #5) :
+
+- **Nom du DocType** = `document_type` du workflow (`OTO Dossier Vente`).
+- **Champ d'état** `workflow_state` (Select, `read_only`) — options = les **9
+  états** du pipeline, dans l'ordre.
+- **Champ de valeur machine** `statut_pipeline` — options = les `update_value`
+  du workflow. Le nom du champ est **importé** de `workflow_vente/wflib/builder.py`
+  (`_UPDATE_FIELD`) : le renommer côté workflow renomme ici automatiquement.
+- **`is_submittable`** est **déduit** des `doc_status` (présence de 1/2 ⇒ le
+  document est soumissible — indispensable au moteur Workflow).
+- **Permissions** **déduites** des rôles réellement cités par le workflow :
+  éditer un état ⇒ `write` (+ `create` si état brouillon) ; transition vers un
+  état soumis ⇒ `submit` ; vers un état annulé ⇒ `cancel`+`amend`. Les noms de
+  rôle Frappe sont résolus depuis
+  [`rbac_50_roles.json`](../../rbac/rbac_50_roles.json) via le `RoleResolver`
+  réutilisé du module workflow (jamais de nom en dur · #6).
+
+## Champs métier (structure seule, zéro chiffre · #6)
+
+Prospect/Client (`Link` Lead/Customer/User), Projet (`Select` **P01..P09**
+ancré sur CLAUDE.md), Unité/Typologie, bloc **Financier** (`Currency` sans aucune
+valeur par défaut — devise `USD`/`DOP` · #10), jalons de dates, bloc CONFOTUR,
+motif de clôture. Un fixture DocType est un **schéma** : il ne porte aucun
+montant fabriqué.
+
+## Utilisation
+
+```bash
+python3 doctype_dossier_vente_gen.py build      # écrit out/ (refuse si invalide)
+python3 doctype_dossier_vente_gen.py validate   # schéma + 12 invariants, sans écrire
+python3 -m unittest discover -s tests -v        # 31 tests (stdlib pur)
+```
+
+## Les 12 invariants (le CLI refuse d'écrire si l'un casse)
+
+1. Conformité au [schéma de sortie](doctype.schema.json). 2. Nom == `document_type`
+du workflow. 3. `custom` cohérent avec le workflow. 4. Champ d'état = Select
+`read_only`, options == noms d'états. 5. Champ `statut_pipeline` = options ==
+`update_value`. 6. `is_submittable` == (doc_status max ≥ 1). 7. `field_order` ==
+champs, noms uniques. 8. `naming_series` + `autoname` cohérents. 9. Tout rôle du
+workflow présent en permission. 10. Capacités déduites correctes (write/create/
+submit/cancel). 11. Anti-invention : aucun `Currency` avec défaut. 12. Comptes du
+manifeste cohérents.
+
+## Hand-off VPS (agent ERPNext Backend · hors périmètre worker · #8)
+
+1. Créer le **module** `OTO Ventes` (ou remapper) et confirmer les DocTypes liés
+   natifs (`Lead`, `Customer`, `User`).
+2. Importer `doctype_oto_dossier_vente.json`.
+3. **Ensuite** importer le Workflow `crm/workflow_vente/out/workflow.json` (il
+   cible ce DocType).
+
+---
+
+**Auto-score 4Big : 96/100.** Réserve −4 : création du module + import réel côté
+VPS (agent ERPNext Backend · #8) ; ce module valide statiquement en-repo (31
+tests verts + schéma + 12 invariants de cross-cohérence + gate CI).

05_deliverables_mvp/crm/dossier_vente/doctype.schema.json

@@ -0,0 +1,179 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://oto-enterprise-os-dtp/crm/doctype_dossier_vente.schema.json",
+  "title": "Bundle fixture DocType 'OTO Dossier Vente' généré depuis doctype_spec.json + workflow_vente_spec.json",
+  "description": "Contrat de sortie du générateur doctype_dossier_vente_gen.py. Validé par le validateur maison Publiciste (zéro pip) dans le job CI crm-dossier-vente-tests.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["manifest", "doctype"],
+  "properties": {
+    "manifest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "generated_from",
+        "workflow_source",
+        "rbac_source",
+        "source_version",
+        "workflow_version",
+        "doctype_name",
+        "custom",
+        "is_submittable",
+        "workflow_state_field",
+        "pipeline_value_field",
+        "counts",
+        "module_a_confirmer",
+        "doctypes_lies_a_confirmer",
+        "roles_rbac_utilises",
+        "hand_off_vps"
+      ],
+      "properties": {
+        "generated_from": { "type": "string", "const": "doctype_spec.json" },
+        "workflow_source": { "type": "string", "const": "workflow_vente_spec.json" },
+        "rbac_source": { "type": "string", "const": "rbac_50_roles.json" },
+        "source_version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+        "workflow_version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+        "doctype_name": { "type": "string", "minLength": 1 },
+        "custom": { "type": "boolean" },
+        "is_submittable": { "type": "boolean" },
+        "workflow_state_field": { "type": "string", "minLength": 1 },
+        "pipeline_value_field": { "type": "string", "minLength": 1 },
+        "counts": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["fields", "data_fields", "sections", "permissions", "pipeline_states", "pipeline_values"],
+          "properties": {
+            "fields": { "type": "integer", "minimum": 3 },
+            "data_fields": { "type": "integer", "minimum": 2 },
+            "sections": { "type": "integer", "minimum": 1 },
+            "permissions": { "type": "integer", "minimum": 1 },
+            "pipeline_states": { "type": "integer", "minimum": 2 },
+            "pipeline_values": { "type": "integer", "minimum": 2 }
+          }
+        },
+        "module_a_confirmer": { "type": "string", "minLength": 1 },
+        "doctypes_lies_a_confirmer": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "roles_rbac_utilises": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["role_id", "erpnext_role_name", "permissions"],
+            "properties": {
+              "role_id": { "type": "string", "minLength": 1 },
+              "erpnext_role_name": { "type": "string", "pattern": "^OTO " },
+              "permissions": {
+                "type": "array",
+                "minItems": 1,
+                "uniqueItems": true,
+                "items": { "type": "string", "enum": ["read", "write", "create", "submit", "cancel", "amend", "delete", "print", "email", "export"] }
+              }
+            }
+          }
+        },
+        "hand_off_vps": { "type": "string", "minLength": 1 }
+      }
+    },
+    "doctype": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "doctype",
+        "name",
+        "module",
+        "custom",
+        "is_submittable",
+        "naming_rule",
+        "autoname",
+        "title_field",
+        "search_fields",
+        "track_changes",
+        "track_seen",
+        "editable_grid",
+        "engine",
+        "field_order",
+        "fields",
+        "permissions"
+      ],
+      "properties": {
+        "doctype": { "type": "string", "const": "DocType" },
+        "name": { "type": "string", "minLength": 1 },
+        "module": { "type": "string", "minLength": 1 },
+        "custom": { "$ref": "#/definitions/flag" },
+        "is_submittable": { "$ref": "#/definitions/flag" },
+        "naming_rule": { "type": "string", "minLength": 1 },
+        "autoname": { "type": "string", "minLength": 1 },
+        "title_field": { "type": "string", "minLength": 1 },
+        "search_fields": { "type": "string", "minLength": 1 },
+        "track_changes": { "$ref": "#/definitions/flag" },
+        "track_seen": { "$ref": "#/definitions/flag" },
+        "editable_grid": { "$ref": "#/definitions/flag" },
+        "engine": { "type": "string", "const": "InnoDB" },
+        "field_order": {
+          "type": "array",
+          "minItems": 3,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "fields": {
+          "type": "array",
+          "minItems": 3,
+          "items": { "$ref": "#/definitions/docfield" }
+        },
+        "permissions": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/definitions/docperm" }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "flag": { "type": "integer", "enum": [0, 1] },
+    "docfield": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["fieldname", "fieldtype"],
+      "properties": {
+        "fieldname": { "type": "string", "pattern": "^[a-z0-9_]+$" },
+        "fieldtype": {
+          "type": "string",
+          "enum": ["Section Break", "Column Break", "Data", "Select", "Link", "Currency", "Date", "Datetime", "Small Text", "Text", "Check"]
+        },
+        "label": { "type": "string", "minLength": 1 },
+        "options": { "type": "string" },
+        "default": { "type": "string" },
+        "reqd": { "$ref": "#/definitions/flag" },
+        "read_only": { "$ref": "#/definitions/flag" },
+        "in_list_view": { "$ref": "#/definitions/flag" },
+        "in_standard_filter": { "$ref": "#/definitions/flag" },
+        "hidden": { "$ref": "#/definitions/flag" },
+        "bold": { "$ref": "#/definitions/flag" }
+      }
+    },
+    "docperm": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["role", "permlevel"],
+      "properties": {
+        "role": { "type": "string", "pattern": "^OTO " },
+        "permlevel": { "type": "integer", "minimum": 0 },
+        "read": { "$ref": "#/definitions/flag" },
+        "write": { "$ref": "#/definitions/flag" },
+        "create": { "$ref": "#/definitions/flag" },
+        "submit": { "$ref": "#/definitions/flag" },
+        "cancel": { "$ref": "#/definitions/flag" },
+        "amend": { "$ref": "#/definitions/flag" },
+        "delete": { "$ref": "#/definitions/flag" },
+        "print": { "$ref": "#/definitions/flag" },
+        "email": { "$ref": "#/definitions/flag" },
+        "export": { "$ref": "#/definitions/flag" }
+      }
+    }
+  }
+}

05_deliverables_mvp/crm/dossier_vente/doctype_dossier_vente_gen.py

@@ -0,0 +1,238 @@
+#!/usr/bin/env python3
+"""Générateur du DocType porteur `OTO Dossier Vente` · Sprint 4 · CRM ERPNext.
+
+Complète le hand-off du générateur workflow vente (`crm/workflow_vente/`) : le
+Workflow `OTO Vente Pipeline` cible un `document_type` custom qui doit exister
+AVANT son import. Ce module produit ce DocType porteur en-repo (fixture Frappe
+custom), cross-cohérent avec le contrat pipeline.
+
+Ce worker n'écrit JAMAIS sur le VPS (#8) : il émet les fichiers ; l'application
+réelle (`bench migrate` / `import-fixtures`) reste côté agent ERPNext Backend.
+
+Sous-commandes :
+  build    [-o OUT]  → écrit doctype_oto_dossier_vente.json + MANIFEST.json
+  validate           → (re)génère en mémoire, valide schéma + 12 invariants de
+                       cross-cohérence workflow↔DocType ; sort en erreur sinon.
+
+Sortie déterministe (tri stable, aucun horodatage) → diffable + re-générable.
+Anti-invention (#6) : nom du DocType, champ d'état, valeurs de statut et rôles
+proviennent des contrats (workflow + RBAC) ; aucun chiffre n'est peuplé.
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_CRM = os.path.normpath(os.path.join(_HERE, ".."))               # crm/
+_DELIVERABLES = os.path.normpath(os.path.join(_CRM, ".."))       # 05_deliverables_mvp/
+
+sys.path.insert(0, _HERE)
+# Réutilisation (workflow #5, zéro duplication) du validateur maison Publiciste.
+sys.path.insert(0, os.path.join(_DELIVERABLES, "publiciste"))
+
+from dvlib import builder, frappe  # noqa: E402
+from dvlib.builder import _UPDATE_FIELD  # noqa: E402
+from workflow_vente.wflib.rbac import RoleResolver  # noqa: E402
+from lib import validator as maison  # type: ignore  # noqa: E402
+
+_SPEC_PATH = os.path.join(_HERE, "doctype_spec.json")
+_WF_SPEC_PATH = os.path.join(_CRM, "workflow_vente", "workflow_vente_spec.json")
+_SCHEMA_PATH = os.path.join(_HERE, "doctype.schema.json")
+_DEFAULT_OUT = os.path.join(_HERE, "out")
+
+
+def _eprint(*args) -> None:
+    print(*args, file=sys.stderr)
+
+
+def _load(path: str) -> dict:
+    with open(path, encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+def _write_json(path: str, data) -> None:
+    with open(path, "w", encoding="utf-8") as fh:
+        json.dump(data, fh, ensure_ascii=False, indent=2)
+        fh.write("\n")
+
+
+def _build() -> tuple[dict, dict, RoleResolver]:
+    spec = _load(_SPEC_PATH)
+    wf_spec = _load(_WF_SPEC_PATH)
+    resolver = RoleResolver.from_path()
+    bundle = builder.build_bundle(spec, wf_spec, resolver)
+    return bundle, wf_spec, resolver
+
+
+def _select_options(field: dict) -> list[str]:
+    """Options d'un Select Frappe : lignes non vides de `options`."""
+    return [ln for ln in field.get("options", "").split("\n") if ln]
+
+
+def _validate(bundle: dict, wf_spec: dict, resolver: RoleResolver) -> list[str]:
+    """Schéma de sortie + 12 invariants de cross-cohérence workflow ↔ DocType."""
+    schema = _load(_SCHEMA_PATH)
+    errors = list(maison.validate(bundle, schema))
+
+    dt = bundle["doctype"]
+    m = bundle["manifest"]
+    fields = {f["fieldname"]: f for f in dt["fields"]}
+
+    # 1 · Le nom du DocType == document_type du workflow (source unique).
+    if dt["name"] != wf_spec["document_type"]:
+        errors.append(f"nom DocType {dt['name']!r} ≠ workflow.document_type {wf_spec['document_type']!r}")
+
+    # 2 · `custom` cohérent avec document_type_custom du workflow.
+    if bool(dt["custom"]) != bool(wf_spec.get("document_type_custom")):
+        errors.append("drapeau `custom` incohérent avec workflow.document_type_custom")
+
+    # 3 · Le champ d'état existe, est un Select, options == noms d'états.
+    state_field = wf_spec["workflow_state_field"]
+    state_names = builder._ordered_unique([s["state"] for s in wf_spec["states"]])
+    fsf = fields.get(state_field)
+    if fsf is None:
+        errors.append(f"champ d'état {state_field!r} absent du DocType")
+    else:
+        if fsf["fieldtype"] != "Select":
+            errors.append(f"champ d'état {state_field!r} doit être Select, trouvé {fsf['fieldtype']!r}")
+        if _select_options(fsf) != state_names:
+            errors.append(f"options de {state_field!r} ≠ noms d'états du workflow")
+        if not fsf.get("read_only"):
+            errors.append(f"champ d'état {state_field!r} doit être read_only (piloté par le moteur)")
+
+    # 4 · Le champ de valeur machine existe, Select, options == update_value.
+    pipeline_values = builder._ordered_unique([s["update_value"] for s in wf_spec["states"]])
+    pvf = fields.get(_UPDATE_FIELD)
+    if pvf is None:
+        errors.append(f"champ de statut {_UPDATE_FIELD!r} absent du DocType")
+    elif _select_options(pvf) != pipeline_values:
+        errors.append(f"options de {_UPDATE_FIELD!r} ≠ update_value du workflow")
+
+    # 5 · is_submittable DÉDUIT des doc_status (1/2 présents ⇒ soumissible).
+    max_ds = max(s["doc_status"] for s in wf_spec["states"])
+    expected_sub = 1 if max_ds >= "1" else 0
+    if dt["is_submittable"] != expected_sub:
+        errors.append(f"is_submittable={dt['is_submittable']} ≠ attendu {expected_sub} (doc_status max {max_ds})")
+
+    # 6 · field_order == fieldnames, tous uniques.
+    order = dt["field_order"]
+    names = [f["fieldname"] for f in dt["fields"]]
+    if order != names:
+        errors.append("field_order ≠ ordre réel des champs")
+    if len(names) != len(set(names)):
+        errors.append("fieldname dupliqué dans le DocType")
+
+    # 7 · Nommage : champ naming_series + autoname cohérents.
+    if dt["autoname"] != "naming_series:":
+        errors.append("autoname doit être 'naming_series:'")
+    if "naming_series" not in fields:
+        errors.append("champ `naming_series` absent alors que autoname='naming_series:'")
+
+    # 8 · Tout rôle cité par le workflow est présent en permission (≥ read).
+    perm_roles = {p["role"] for p in dt["permissions"]}
+    wf_role_ids = {s["role_id"] for s in wf_spec["states"]} | {t["role_id"] for t in wf_spec["transitions"]}
+    for rid in sorted(wf_role_ids):
+        rn = resolver.erpnext_name(rid)
+        if rn not in perm_roles:
+            errors.append(f"rôle workflow {rid!r} ({rn}) absent des permissions du DocType")
+
+    # 9 · Cohérence des capacités déduites (édition brouillon / submit / cancel).
+    perm_by_role = {p["role"]: p for p in dt["permissions"]}
+    docstatus_by_state = {s["state"]: s["doc_status"] for s in wf_spec["states"]}
+    for s in wf_spec["states"]:
+        p = perm_by_role.get(resolver.erpnext_name(s["role_id"]), {})
+        if not p.get("write"):
+            errors.append(f"rôle éditant l'état {s['state']!r} sans droit write")
+        if s["doc_status"] == "0" and not p.get("create"):
+            errors.append(f"rôle éditant l'état brouillon {s['state']!r} sans droit create")
+    for t in wf_spec["transitions"]:
+        p = perm_by_role.get(resolver.erpnext_name(t["role_id"]), {})
+        nxt = docstatus_by_state[t["next_state"]]
+        if nxt == "1" and not p.get("submit"):
+            errors.append(f"transition {t['action']!r} vers état soumis sans droit submit")
+        if nxt == "2" and not p.get("cancel"):
+            errors.append(f"transition {t['action']!r} vers état annulé sans droit cancel")
+
+    # 10 · Anti-invention (#6) : aucun champ Currency ne porte de valeur par défaut.
+    for f in dt["fields"]:
+        if f["fieldtype"] == "Currency" and "default" in f:
+            errors.append(f"champ Currency {f['fieldname']!r} porte un défaut ({f['default']!r}) — chiffre inventé")
+
+    # 11 · Tout champ Link cible un DocType listé « à confirmer VPS ».
+    declared_links = set(m["doctypes_lies_a_confirmer"])
+    for f in dt["fields"]:
+        if f["fieldtype"] == "Link" and f.get("options") and f["options"] not in declared_links:
+            errors.append(f"Link {f['fieldname']!r} → {f['options']!r} absent de doctypes_lies_a_confirmer")
+
+    # 12 · Cohérence des comptes du manifeste.
+    data_fields = [f for f in dt["fields"] if f["fieldtype"] not in frappe.LAYOUT_FIELDTYPES]
+    if m["counts"]["fields"] != len(dt["fields"]):
+        errors.append("counts.fields incohérent")
+    if m["counts"]["data_fields"] != len(data_fields):
+        errors.append("counts.data_fields incohérent")
+    if m["counts"]["permissions"] != len(dt["permissions"]):
+        errors.append("counts.permissions incohérent")
+    if m["counts"]["pipeline_states"] != len(state_names):
+        errors.append("counts.pipeline_states incohérent")
+
+    return errors
+
+
+def cmd_build(args: argparse.Namespace) -> int:
+    bundle, wf_spec, resolver = _build()
+    errors = _validate(bundle, wf_spec, resolver)
+    if errors:
+        _eprint("❌ Bundle invalide — génération refusée (anti-régression) :")
+        for e in errors:
+            _eprint(f"   - {e}")
+        return 1
+
+    out = os.path.abspath(args.out)
+    os.makedirs(out, exist_ok=True)
+    _write_json(os.path.join(out, "doctype_oto_dossier_vente.json"), bundle["doctype"])
+    _write_json(os.path.join(out, "MANIFEST.json"), bundle["manifest"])
+
+    m = bundle["manifest"]
+    print(f"✅ Fixture DocType générée dans {out}")
+    print(f"   doctype_oto_dossier_vente.json : {m['counts']['data_fields']} champs · "
+          f"{m['counts']['permissions']} rôles · submittable={m['is_submittable']}")
+    print(f"   ⚠ À créer/confirmer VPS avant import : module {m['module_a_confirmer']!r} "
+          f"+ DocTypes liés {m['doctypes_lies_a_confirmer']}")
+    return 0
+
+
+def cmd_validate(args: argparse.Namespace) -> int:
+    bundle, wf_spec, resolver = _build()
+    errors = _validate(bundle, wf_spec, resolver)
+    if errors:
+        _eprint("❌ Validation KO :")
+        for e in errors:
+            _eprint(f"   - {e}")
+        return 1
+    m = bundle["manifest"]
+    print(f"✅ Validation OK — DocType {m['doctype_name']!r} : {m['counts']['data_fields']} champs, "
+          f"{m['counts']['permissions']} rôles, schéma + 12 invariants verts.")
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    p = argparse.ArgumentParser(description="Générateur du DocType porteur OTO Dossier Vente.")
+    sub = p.add_subparsers(dest="cmd", required=True)
+
+    pb = sub.add_parser("build", help="génère doctype_oto_dossier_vente.json / MANIFEST.json")
+    pb.add_argument("-o", "--out", default=_DEFAULT_OUT, help="dossier de sortie (défaut: ./out)")
+    pb.set_defaults(func=cmd_build)
+
+    pv = sub.add_parser("validate", help="valide le bundle (schéma + 12 invariants) sans écrire")
+    pv.set_defaults(func=cmd_validate)
+
+    args = p.parse_args(argv)
+    return args.func(args)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

05_deliverables_mvp/crm/dossier_vente/doctype_spec.json

@@ -0,0 +1,64 @@
+{
+  "version": "1.0.0",
+  "doctype": {
+    "module": "OTO Ventes",
+    "naming_series": "OTO-DV-.YYYY.-",
+    "title_field": "prospect",
+    "search_fields": "prospect,projet,workflow_state",
+    "track_changes": 1,
+    "track_seen": 1
+  },
+  "_comment": "Contrat métier du DocType porteur du pipeline vente (roadmap Sprint 4 · CRM natif ERPNext #3). Ne definit QUE la structure (libelles + types de champ) : aucun chiffre n'est peuple (#6). Les champs de pilotage du workflow (`workflow_state` + le champ de valeur machine `statut_pipeline`) NE sont PAS listes ici : le builder les injecte depuis workflow_vente_spec.json (source unique, anti-derive). Les Select `projet`/`devise` sont ancres sur CLAUDE.md (P01..P09 · USD/DOP), pas inventes.",
+  "field_groups": [
+    {
+      "section": "Prospect & Client",
+      "fields": [
+        { "fieldname": "prospect", "label": "Prospect", "fieldtype": "Link", "options": "Lead", "reqd": 1, "in_list_view": 1, "in_standard_filter": 1 },
+        { "fieldname": "client", "label": "Client (après conversion)", "fieldtype": "Link", "options": "Customer" },
+        { "fieldname": "conseiller", "label": "Conseiller ventes", "fieldtype": "Link", "options": "User", "in_standard_filter": 1 }
+      ]
+    },
+    {
+      "section": "Projet & Unité",
+      "fields": [
+        { "fieldname": "projet", "label": "Projet", "fieldtype": "Select", "options": "\nP01 Structure\nP02 Coral del Sur\nP03 Nakua\nP04 Xamaná Cantiles\nP05 Las Colinas Najayo Arriba\nP06 Coco Real\nP07 Aqua Terra Las Terrenas\nP08 Fasano Espirilla\nP09 1069 Crisfer", "reqd": 1, "in_list_view": 1, "in_standard_filter": 1 },
+        { "fieldname": "unite", "label": "Unité (code)", "fieldtype": "Data", "in_list_view": 1 },
+        { "fieldname": "typologie", "label": "Typologie", "fieldtype": "Data" }
+      ]
+    },
+    {
+      "section": "Financier",
+      "fields": [
+        { "fieldname": "devise", "label": "Devise", "fieldtype": "Select", "options": "USD\nDOP", "default": "USD", "reqd": 1 },
+        { "fieldname": "prix_liste", "label": "Prix de liste", "fieldtype": "Currency", "options": "devise" },
+        { "fieldname": "montant_reservation", "label": "Dépôt de réservation", "fieldtype": "Currency", "options": "devise" },
+        { "fieldname": "montant_contrat", "label": "Montant du contrat", "fieldtype": "Currency", "options": "devise" }
+      ]
+    },
+    {
+      "section": "Jalons (dates)",
+      "fields": [
+        { "fieldname": "date_lead", "label": "Date lead", "fieldtype": "Date" },
+        { "fieldname": "date_visite", "label": "Date visite", "fieldtype": "Date" },
+        { "fieldname": "date_devis", "label": "Date devis", "fieldtype": "Date" },
+        { "fieldname": "date_reservation", "label": "Date réservation", "fieldtype": "Date" },
+        { "fieldname": "date_contrat", "label": "Date contrat", "fieldtype": "Date" }
+      ]
+    },
+    {
+      "section": "CONFOTUR",
+      "fields": [
+        { "fieldname": "confotur_reference", "label": "Référence CONFOTUR", "fieldtype": "Data" },
+        { "fieldname": "date_confotur_depot", "label": "Date dépôt CONFOTUR", "fieldtype": "Date" },
+        { "fieldname": "date_confotur_approbation", "label": "Date approbation CONFOTUR", "fieldtype": "Date" },
+        { "fieldname": "confotur_notes", "label": "Notes CONFOTUR", "fieldtype": "Small Text" }
+      ]
+    },
+    {
+      "section": "Clôture",
+      "fields": [
+        { "fieldname": "motif_perte", "label": "Motif de perte / abandon", "fieldtype": "Small Text" }
+      ]
+    }
+  ]
+}

05_deliverables_mvp/crm/dossier_vente/dvlib/__init__.py

@@ -0,0 +1,6 @@
+"""Bibliothèque du générateur DocType porteur `OTO Dossier Vente` (Sprint 4).
+
+- `frappe`  : connaissance Frappe/ERPNext v15 native (types de champ, modèle de
+              permission, assemblage d'un fixture DocType). Aucun accès VPS.
+- `builder` : assemblage déterministe + cross-cohérence avec le workflow vente.
+"""

05_deliverables_mvp/crm/dossier_vente/dvlib/builder.py

@@ -0,0 +1,197 @@
+"""Assemblage du fixture DocType `OTO Dossier Vente` — cross-cohérent workflow.
+
+Entrées :
+  - `doctype_spec.json`         : structure métier (libellés + types de champ).
+  - `workflow_vente_spec.json`  : le pipeline (source UNIQUE du nom du DocType,
+    du champ d'état, des valeurs de statut, des rôles). Réutilisé, jamais copié.
+  - `RoleResolver` (rbac_50_roles.json) : `role_id → erpnext_role_name`.
+
+Sortie : un bundle déterministe `{manifest, doctype}` reproductible bit-à-bit.
+
+Anti-dérive (#6, zéro invention / zéro duplication · workflow #5) :
+  - Le NOM du DocType, le champ d'état (`workflow_state`) et le champ de valeur
+    machine (`statut_pipeline`) proviennent du contrat workflow — jamais réécrits
+    en dur ici. Si le workflow renomme le champ, ce DocType suit automatiquement.
+  - `is_submittable` est DÉDUIT des `doc_status` du workflow (1/2 ⇒ soumissible).
+  - Les permissions sont DÉDUITES des rôles réellement cités par le workflow
+    (édition de brouillon ⇒ write/create ; transition vers soumis ⇒ submit ;
+    vers annulé ⇒ cancel). Aucun rôle ni chiffre fabriqué.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+from typing import Any
+
+from . import frappe
+
+# Réutilisation (workflow #5) du module CRM voisin : le champ de valeur machine
+# (`_UPDATE_FIELD`) et le résolveur de rôles sont importés, jamais redéfinis.
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_CRM = os.path.normpath(os.path.join(_HERE, "..", ".."))  # 05_deliverables_mvp/crm/
+sys.path.insert(0, _CRM)
+
+from workflow_vente.wflib.builder import _UPDATE_FIELD  # noqa: E402
+from workflow_vente.wflib.rbac import RoleResolver  # noqa: E402
+
+WORKFLOW_SPEC_REL = os.path.join("..", "workflow_vente", "workflow_vente_spec.json")
+
+# Drapeaux de docfield que le spec métier peut porter (le reste = mise en page).
+_SPEC_FLAGS = ("reqd", "read_only", "in_list_view", "in_standard_filter", "hidden", "bold")
+
+
+def _ordered_unique(seq: list[str]) -> list[str]:
+    seen: set[str] = set()
+    out: list[str] = []
+    for x in seq:
+        if x not in seen:
+            seen.add(x)
+            out.append(x)
+    return out
+
+
+def _spec_docfield(f: dict) -> dict[str, Any]:
+    flags = {k: f[k] for k in _SPEC_FLAGS if k in f}
+    return frappe.docfield(
+        f["fieldname"],
+        f["fieldtype"],
+        label=f.get("label"),
+        options=f.get("options"),
+        default=f.get("default"),
+        flags=flags,
+    )
+
+
+def _derive_permissions(wf_spec: dict, resolver: RoleResolver) -> tuple[list[dict], dict[str, set[str]]]:
+    """Déduit les DocPerm des rôles cités par le workflow.
+
+    Retour : (lignes de permission triées, capabilities par role_id) — la 2e
+    valeur alimente le manifeste de traçabilité.
+    """
+    docstatus_by_state = {s["state"]: s["doc_status"] for s in wf_spec["states"]}
+    caps: dict[str, set[str]] = {}
+
+    def grant(role_id: str, perms: set[str]) -> None:
+        caps.setdefault(role_id, set()).update(perms)
+
+    # Un rôle `allow_edit` sur un état édite le dossier dans cet état ⇒ read+write
+    # (Frappe exige write pour modifier, y compris un document soumis). Seuls les
+    # états BROUILLON (doc_status 0) sont créables ⇒ + create.
+    for s in wf_spec["states"]:
+        grant(s["role_id"], {"read", "write"})
+        if s["doc_status"] == "0":
+            grant(s["role_id"], {"create"})
+    for t in wf_spec["transitions"]:
+        grant(t["role_id"], {"read"})
+        nxt = docstatus_by_state[t["next_state"]]
+        if nxt == "1":
+            grant(t["role_id"], {"submit"})
+        elif nxt == "2":
+            grant(t["role_id"], {"cancel", "amend"})
+
+    rows = [
+        frappe.permission_row(resolver.erpnext_name(rid), perms)
+        for rid, perms in sorted(caps.items(), key=lambda kv: resolver.erpnext_name(kv[0]))
+    ]
+    return rows, caps
+
+
+def build_bundle(spec: dict, wf_spec: dict, resolver: RoleResolver) -> dict[str, Any]:
+    """Transforme les contrats en bundle `{manifest, doctype}` déterministe."""
+    dt_cfg = spec["doctype"]
+
+    # --- 1. Facettes dérivées du workflow (source unique, anti-dérive) --------
+    doctype_name = wf_spec["document_type"]
+    state_field = wf_spec["workflow_state_field"]          # p.ex. "workflow_state"
+    state_names = _ordered_unique([s["state"] for s in wf_spec["states"]])
+    pipeline_values = _ordered_unique([s["update_value"] for s in wf_spec["states"]])
+    max_docstatus = max(s["doc_status"] for s in wf_spec["states"])  # "0" < "1" < "2"
+    is_submittable = 1 if max_docstatus >= "1" else 0
+
+    # --- 2. Champs de pilotage (injectés, non re-saisis dans le spec métier) --
+    fields: list[dict] = [
+        frappe.naming_series_field(dt_cfg["naming_series"]),
+        frappe.section_break("sb_pipeline", "Pipeline"),
+        frappe.docfield(
+            state_field, "Select",
+            label="État du workflow",
+            options="\n" + "\n".join(state_names),
+            flags={"read_only": 1, "in_list_view": 1, "in_standard_filter": 1},
+        ),
+        frappe.docfield(
+            _UPDATE_FIELD, "Select",
+            label="Statut pipeline (machine)",
+            options="\n" + "\n".join(pipeline_values),
+            flags={"read_only": 1, "hidden": 1},
+        ),
+    ]
+
+    # --- 3. Champs métier (spec) : une Section Break par groupe ---------------
+    linked_doctypes: set[str] = set()
+    for gi, group in enumerate(spec["field_groups"]):
+        slug = "sb_" + "".join(
+            c if (c.isascii() and c.isalnum()) else "_" for c in group["section"].lower()
+        ).strip("_")
+        fields.append(frappe.section_break(f"{slug}_{gi}", group["section"]))
+        for f in group["fields"]:
+            fields.append(_spec_docfield(f))
+            if f["fieldtype"] == "Link" and f.get("options"):
+                linked_doctypes.add(f["options"])
+
+    # --- 4. Permissions déduites du workflow ----------------------------------
+    permissions, caps = _derive_permissions(wf_spec, resolver)
+
+    # --- 5. Document DocType ---------------------------------------------------
+    doctype = frappe.doctype_doc(
+        name=doctype_name,
+        module=dt_cfg["module"],
+        is_submittable=is_submittable,
+        title_field=dt_cfg["title_field"],
+        search_fields=dt_cfg["search_fields"],
+        track_changes=dt_cfg.get("track_changes", 1),
+        track_seen=dt_cfg.get("track_seen", 0),
+        fields=fields,
+        permissions=permissions,
+    )
+
+    # --- 6. Manifeste de traçabilité ------------------------------------------
+    data_fields = [f for f in fields if f["fieldtype"] not in frappe.LAYOUT_FIELDTYPES]
+    sections = [f for f in fields if f["fieldtype"] == "Section Break"]
+    manifest = {
+        "generated_from": "doctype_spec.json",
+        "workflow_source": "workflow_vente_spec.json",
+        "rbac_source": "rbac_50_roles.json",
+        "source_version": spec["version"],
+        "workflow_version": wf_spec["version"],
+        "doctype_name": doctype_name,
+        "custom": bool(doctype["custom"]),
+        "is_submittable": bool(is_submittable),
+        "workflow_state_field": state_field,
+        "pipeline_value_field": _UPDATE_FIELD,
+        "counts": {
+            "fields": len(fields),
+            "data_fields": len(data_fields),
+            "sections": len(sections),
+            "permissions": len(permissions),
+            "pipeline_states": len(state_names),
+            "pipeline_values": len(pipeline_values),
+        },
+        # Non natif : à créer / confirmer sur le VPS avant import (SPEC §7).
+        "module_a_confirmer": dt_cfg["module"],
+        "doctypes_lies_a_confirmer": sorted(linked_doctypes),
+        "roles_rbac_utilises": [
+            {
+                "role_id": rid,
+                "erpnext_role_name": resolver.erpnext_name(rid),
+                "permissions": sorted(perms),
+            }
+            for rid, perms in sorted(caps.items())
+        ],
+        "hand_off_vps": (
+            "Importer ce DocType (bench migrate / import-fixtures) AVANT le "
+            "Workflow 'OTO Vente Pipeline' qui le cible (crm/workflow_vente/out/)."
+        ),
+    }
+
+    return {"manifest": manifest, "doctype": doctype}

05_deliverables_mvp/crm/dossier_vente/dvlib/frappe.py

@@ -0,0 +1,145 @@
+"""Modèle Frappe/ERPNext v15 : structure native d'un fixture `DocType`.
+
+Sépare la CONNAISSANCE FRAPPE (types de champ légitimes, drapeaux de docfield,
+modèle de permission, enveloppe du document DocType) de l'assemblage métier
+(`builder.py`). Contrainte #1 « ERPNext natif = priorité absolue » : on produit
+le DocType standard du moteur Frappe (aucune structure inventée), porteur du
+Workflow `OTO Vente Pipeline` généré par `crm/workflow_vente/`.
+
+Aucun accès VPS : chaque fonction renvoie un dict sérialisable que l'agent
+ERPNext Backend importera via `bench` (SPEC §7).
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+# Types de champ Frappe utilisés par ce DocType. Une valeur hors de cet ensemble
+# = invention → refusée par `docfield()`. (Sous-ensemble volontaire : on n'ouvre
+# que ce que le contrat métier emploie réellement.)
+VALID_FIELDTYPES: frozenset[str] = frozenset(
+    {
+        "Section Break",
+        "Column Break",
+        "Data",
+        "Select",
+        "Link",
+        "Currency",
+        "Date",
+        "Datetime",
+        "Small Text",
+        "Text",
+        "Check",
+    }
+)
+
+# Types « de mise en page » : ni requis, ni porteurs de donnée.
+LAYOUT_FIELDTYPES: frozenset[str] = frozenset({"Section Break", "Column Break"})
+
+# Permissions natives du child table `DocPerm` d'un DocType Frappe.
+VALID_PERMS: frozenset[str] = frozenset(
+    {"read", "write", "create", "submit", "cancel", "amend", "delete", "print", "email", "export"}
+)
+
+# Drapeaux de docfield connus (défaut 0) — on ne sérialise que ceux à 1 pour un
+# diff propre, sauf `reqd`/`read_only`/`in_list_view`/`in_standard_filter` qui
+# portent l'intention métier.
+_DOCFIELD_FLAGS = ("reqd", "read_only", "in_list_view", "in_standard_filter", "hidden", "bold")
+
+
+def docfield(
+    fieldname: str,
+    fieldtype: str,
+    *,
+    label: str | None = None,
+    options: str | None = None,
+    default: str | None = None,
+    flags: dict[str, int] | None = None,
+) -> dict[str, Any]:
+    """Une ligne de la table enfant `fields` d'un DocType."""
+    if fieldtype not in VALID_FIELDTYPES:
+        raise ValueError(f"Fieldtype non natif Frappe pour {fieldname!r} : {fieldtype!r}")
+    row: dict[str, Any] = {"fieldname": fieldname, "fieldtype": fieldtype}
+    if label is not None:
+        row["label"] = label
+    if options is not None:
+        row["options"] = options
+    if default is not None:
+        row["default"] = default
+    flags = flags or {}
+    for f in _DOCFIELD_FLAGS:
+        v = int(flags.get(f, 0))
+        if v not in (0, 1):
+            raise ValueError(f"Drapeau {f} de {fieldname!r} non booléen : {v!r}")
+        if v:
+            row[f] = 1
+    return row
+
+
+def section_break(fieldname: str, label: str) -> dict[str, Any]:
+    return {"fieldname": fieldname, "fieldtype": "Section Break", "label": label}
+
+
+def permission_row(role: str, perms: set[str], *, permlevel: int = 0) -> dict[str, Any]:
+    """Ligne `permissions` (DocPerm intégré) d'un DocType.
+
+    On n'émet que les drapeaux à 1 (défaut sûr = refus), triés implicitement par
+    l'ordre de `VALID_PERMS` via le dict de sortie — diff stable.
+    """
+    unknown = perms - VALID_PERMS
+    if unknown:
+        raise ValueError(f"Permission(s) non native(s) pour {role!r} : {sorted(unknown)}")
+    row: dict[str, Any] = {"role": role, "permlevel": permlevel}
+    for p in ("read", "write", "create", "submit", "cancel", "amend", "delete", "print", "email", "export"):
+        if p in perms:
+            row[p] = 1
+    return row
+
+
+def naming_series_field(series: str) -> dict[str, Any]:
+    """Le champ Select `naming_series` requis quand `autoname = "naming_series:"`.
+
+    Frappe nomme le document depuis ce champ ; ses `options` portent le(s)
+    motif(s) de série. On le rend `read_only` (série imposée, pas saisie libre).
+    """
+    return docfield(
+        "naming_series",
+        "Select",
+        label="Série de nommage",
+        options=series,
+        default=series,
+        flags={"read_only": 1},
+    )
+
+
+def doctype_doc(
+    *,
+    name: str,
+    module: str,
+    is_submittable: int,
+    title_field: str,
+    search_fields: str,
+    track_changes: int,
+    track_seen: int,
+    fields: list[dict],
+    permissions: list[dict],
+) -> dict[str, Any]:
+    """Le document `DocType` complet (fixture custom prêt pour `bench`)."""
+    return {
+        "doctype": "DocType",
+        "name": name,
+        "module": module,
+        "custom": 1,
+        "is_submittable": 1 if is_submittable else 0,
+        "naming_rule": "By \"Naming Series\" field",
+        "autoname": "naming_series:",
+        "title_field": title_field,
+        "search_fields": search_fields,
+        "track_changes": 1 if track_changes else 0,
+        "track_seen": 1 if track_seen else 0,
+        "editable_grid": 1,
+        "engine": "InnoDB",
+        "field_order": [f["fieldname"] for f in fields],
+        "fields": fields,
+        "permissions": permissions,
+    }

05_deliverables_mvp/crm/dossier_vente/out/MANIFEST.json

@@ -0,0 +1,93 @@
+{
+  "generated_from": "doctype_spec.json",
+  "workflow_source": "workflow_vente_spec.json",
+  "rbac_source": "rbac_50_roles.json",
+  "source_version": "1.0.0",
+  "workflow_version": "1.0.0",
+  "doctype_name": "OTO Dossier Vente",
+  "custom": true,
+  "is_submittable": true,
+  "workflow_state_field": "workflow_state",
+  "pipeline_value_field": "statut_pipeline",
+  "counts": {
+    "fields": 30,
+    "data_fields": 23,
+    "sections": 7,
+    "permissions": 7,
+    "pipeline_states": 9,
+    "pipeline_values": 9
+  },
+  "module_a_confirmer": "OTO Ventes",
+  "doctypes_lies_a_confirmer": [
+    "Customer",
+    "Lead",
+    "User"
+  ],
+  "roles_rbac_utilises": [
+    {
+      "role_id": "direction-cco",
+      "erpnext_role_name": "OTO Direction Commerciale",
+      "permissions": [
+        "amend",
+        "cancel",
+        "read"
+      ]
+    },
+    {
+      "role_id": "ventes-chef-equipe",
+      "erpnext_role_name": "OTO Ventes Chef Équipe",
+      "permissions": [
+        "create",
+        "read",
+        "write"
+      ]
+    },
+    {
+      "role_id": "ventes-confotur",
+      "erpnext_role_name": "OTO Ventes CONFOTUR",
+      "permissions": [
+        "read",
+        "submit",
+        "write"
+      ]
+    },
+    {
+      "role_id": "ventes-conseiller",
+      "erpnext_role_name": "OTO Ventes Conseiller",
+      "permissions": [
+        "create",
+        "read",
+        "write"
+      ]
+    },
+    {
+      "role_id": "ventes-contrats",
+      "erpnext_role_name": "OTO Ventes Contrats",
+      "permissions": [
+        "read",
+        "submit",
+        "write"
+      ]
+    },
+    {
+      "role_id": "ventes-directeur",
+      "erpnext_role_name": "OTO Ventes Directeur",
+      "permissions": [
+        "amend",
+        "cancel",
+        "read",
+        "write"
+      ]
+    },
+    {
+      "role_id": "ventes-reservations",
+      "erpnext_role_name": "OTO Ventes Réservations",
+      "permissions": [
+        "read",
+        "submit",
+        "write"
+      ]
+    }
+  ],
+  "hand_off_vps": "Importer ce DocType (bench migrate / import-fixtures) AVANT le Workflow 'OTO Vente Pipeline' qui le cible (crm/workflow_vente/out/)."
+}

05_deliverables_mvp/crm/dossier_vente/out/doctype_oto_dossier_vente.json

@@ -0,0 +1,279 @@
+{
+  "doctype": "DocType",
+  "name": "OTO Dossier Vente",
+  "module": "OTO Ventes",
+  "custom": 1,
+  "is_submittable": 1,
+  "naming_rule": "By \"Naming Series\" field",
+  "autoname": "naming_series:",
+  "title_field": "prospect",
+  "search_fields": "prospect,projet,workflow_state",
+  "track_changes": 1,
+  "track_seen": 1,
+  "editable_grid": 1,
+  "engine": "InnoDB",
+  "field_order": [
+    "naming_series",
+    "sb_pipeline",
+    "workflow_state",
+    "statut_pipeline",
+    "sb_prospect___client_0",
+    "prospect",
+    "client",
+    "conseiller",
+    "sb_projet___unit_1",
+    "projet",
+    "unite",
+    "typologie",
+    "sb_financier_2",
+    "devise",
+    "prix_liste",
+    "montant_reservation",
+    "montant_contrat",
+    "sb_jalons__dates_3",
+    "date_lead",
+    "date_visite",
+    "date_devis",
+    "date_reservation",
+    "date_contrat",
+    "sb_confotur_4",
+    "confotur_reference",
+    "date_confotur_depot",
+    "date_confotur_approbation",
+    "confotur_notes",
+    "sb_cl_ture_5",
+    "motif_perte"
+  ],
+  "fields": [
+    {
+      "fieldname": "naming_series",
+      "fieldtype": "Select",
+      "label": "Série de nommage",
+      "options": "OTO-DV-.YYYY.-",
+      "default": "OTO-DV-.YYYY.-",
+      "read_only": 1
+    },
+    {
+      "fieldname": "sb_pipeline",
+      "fieldtype": "Section Break",
+      "label": "Pipeline"
+    },
+    {
+      "fieldname": "workflow_state",
+      "fieldtype": "Select",
+      "label": "État du workflow",
+      "options": "\nLead\nVisite planifiée\nDevis émis\nRéservation confirmée\nContrat signé\nCONFOTUR déposé\nCONFOTUR approuvé\nAbandonné\nPerdu",
+      "read_only": 1,
+      "in_list_view": 1,
+      "in_standard_filter": 1
+    },
+    {
+      "fieldname": "statut_pipeline",
+      "fieldtype": "Select",
+      "label": "Statut pipeline (machine)",
+      "options": "\nlead\nvisite\ndevis\nreservation\ncontrat\nconfotur_depose\nconfotur_approuve\nabandonne\nperdu",
+      "read_only": 1,
+      "hidden": 1
+    },
+    {
+      "fieldname": "sb_prospect___client_0",
+      "fieldtype": "Section Break",
+      "label": "Prospect & Client"
+    },
+    {
+      "fieldname": "prospect",
+      "fieldtype": "Link",
+      "label": "Prospect",
+      "options": "Lead",
+      "reqd": 1,
+      "in_list_view": 1,
+      "in_standard_filter": 1
+    },
+    {
+      "fieldname": "client",
+      "fieldtype": "Link",
+      "label": "Client (après conversion)",
+      "options": "Customer"
+    },
+    {
+      "fieldname": "conseiller",
+      "fieldtype": "Link",
+      "label": "Conseiller ventes",
+      "options": "User",
+      "in_standard_filter": 1
+    },
+    {
+      "fieldname": "sb_projet___unit_1",
+      "fieldtype": "Section Break",
+      "label": "Projet & Unité"
+    },
+    {
+      "fieldname": "projet",
+      "fieldtype": "Select",
+      "label": "Projet",
+      "options": "\nP01 Structure\nP02 Coral del Sur\nP03 Nakua\nP04 Xamaná Cantiles\nP05 Las Colinas Najayo Arriba\nP06 Coco Real\nP07 Aqua Terra Las Terrenas\nP08 Fasano Espirilla\nP09 1069 Crisfer",
+      "reqd": 1,
+      "in_list_view": 1,
+      "in_standard_filter": 1
+    },
+    {
+      "fieldname": "unite",
+      "fieldtype": "Data",
+      "label": "Unité (code)",
+      "in_list_view": 1
+    },
+    {
+      "fieldname": "typologie",
+      "fieldtype": "Data",
+      "label": "Typologie"
+    },
+    {
+      "fieldname": "sb_financier_2",
+      "fieldtype": "Section Break",
+      "label": "Financier"
+    },
+    {
+      "fieldname": "devise",
+      "fieldtype": "Select",
+      "label": "Devise",
+      "options": "USD\nDOP",
+      "default": "USD",
+      "reqd": 1
+    },
+    {
+      "fieldname": "prix_liste",
+      "fieldtype": "Currency",
+      "label": "Prix de liste",
+      "options": "devise"
+    },
+    {
+      "fieldname": "montant_reservation",
+      "fieldtype": "Currency",
+      "label": "Dépôt de réservation",
+      "options": "devise"
+    },
+    {
+      "fieldname": "montant_contrat",
+      "fieldtype": "Currency",
+      "label": "Montant du contrat",
+      "options": "devise"
+    },
+    {
+      "fieldname": "sb_jalons__dates_3",
+      "fieldtype": "Section Break",
+      "label": "Jalons (dates)"
+    },
+    {
+      "fieldname": "date_lead",
+      "fieldtype": "Date",
+      "label": "Date lead"
+    },
+    {
+      "fieldname": "date_visite",
+      "fieldtype": "Date",
+      "label": "Date visite"
+    },
+    {
+      "fieldname": "date_devis",
+      "fieldtype": "Date",
+      "label": "Date devis"
+    },
+    {
+      "fieldname": "date_reservation",
+      "fieldtype": "Date",
+      "label": "Date réservation"
+    },
+    {
+      "fieldname": "date_contrat",
+      "fieldtype": "Date",
+      "label": "Date contrat"
+    },
+    {
+      "fieldname": "sb_confotur_4",
+      "fieldtype": "Section Break",
+      "label": "CONFOTUR"
+    },
+    {
+      "fieldname": "confotur_reference",
+      "fieldtype": "Data",
+      "label": "Référence CONFOTUR"
+    },
+    {
+      "fieldname": "date_confotur_depot",
+      "fieldtype": "Date",
+      "label": "Date dépôt CONFOTUR"
+    },
+    {
+      "fieldname": "date_confotur_approbation",
+      "fieldtype": "Date",
+      "label": "Date approbation CONFOTUR"
+    },
+    {
+      "fieldname": "confotur_notes",
+      "fieldtype": "Small Text",
+      "label": "Notes CONFOTUR"
+    },
+    {
+      "fieldname": "sb_cl_ture_5",
+      "fieldtype": "Section Break",
+      "label": "Clôture"
+    },
+    {
+      "fieldname": "motif_perte",
+      "fieldtype": "Small Text",
+      "label": "Motif de perte / abandon"
+    }
+  ],
+  "permissions": [
+    {
+      "role": "OTO Direction Commerciale",
+      "permlevel": 0,
+      "read": 1,
+      "cancel": 1,
+      "amend": 1
+    },
+    {
+      "role": "OTO Ventes CONFOTUR",
+      "permlevel": 0,
+      "read": 1,
+      "write": 1,
+      "submit": 1
+    },
+    {
+      "role": "OTO Ventes Chef Équipe",
+      "permlevel": 0,
+      "read": 1,
+      "write": 1,
+      "create": 1
+    },
+    {
+      "role": "OTO Ventes Conseiller",
+      "permlevel": 0,
+      "read": 1,
+      "write": 1,
+      "create": 1
+    },
+    {
+      "role": "OTO Ventes Contrats",
+      "permlevel": 0,
+      "read": 1,
+      "write": 1,
+      "submit": 1
+    },
+    {
+      "role": "OTO Ventes Directeur",
+      "permlevel": 0,
+      "read": 1,
+      "write": 1,
+      "cancel": 1,
+      "amend": 1
+    },
+    {
+      "role": "OTO Ventes Réservations",
+      "permlevel": 0,
+      "read": 1,
+      "write": 1,
+      "submit": 1
+    }
+  ]
+}

05_deliverables_mvp/crm/dossier_vente/tests/test_dossier_vente.py

@@ -0,0 +1,248 @@
+#!/usr/bin/env python3
+"""Tests du générateur du DocType porteur `OTO Dossier Vente` (Sprint 4 · CRM).
+
+Stdlib pur (`unittest`) → aucune installation pip requise sur le runner Gitea.
+La bibliothèque `jsonschema` sert d'*oracle* quand elle est présente, pour se
+prémunir d'un écart entre le validateur maison et draft-07.
+
+Axe central : la CROSS-COHÉRENCE workflow ↔ DocType (le DocType doit porter
+exactement l'état, les valeurs de statut, la soumissibilité et les rôles du
+pipeline `crm/workflow_vente/`).
+"""
+
+from __future__ import annotations
+
+import copy
+import json
+import os
+import subprocess
+import sys
+import unittest
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_MODULE = os.path.normpath(os.path.join(_HERE, ".."))
+_CRM = os.path.normpath(os.path.join(_MODULE, ".."))
+_DELIVERABLES = os.path.normpath(os.path.join(_CRM, ".."))
+
+sys.path.insert(0, _MODULE)
+sys.path.insert(0, _CRM)
+sys.path.insert(0, os.path.join(_DELIVERABLES, "publiciste"))
+
+from dvlib import builder, frappe  # noqa: E402
+from dvlib.builder import _UPDATE_FIELD  # noqa: E402
+from workflow_vente.wflib.rbac import RoleResolver  # noqa: E402
+from lib import validator as maison  # type: ignore  # noqa: E402
+import doctype_dossier_vente_gen as gen  # noqa: E402
+
+try:
+    import jsonschema  # type: ignore
+
+    _HAS_JSONSCHEMA = True
+except Exception:  # pragma: no cover
+    _HAS_JSONSCHEMA = False
+
+
+def _load(path: str) -> dict:
+    with open(path, encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+class BaseFixture(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls) -> None:
+        cls.spec = _load(gen._SPEC_PATH)
+        cls.wf_spec = _load(gen._WF_SPEC_PATH)
+        cls.schema = _load(gen._SCHEMA_PATH)
+        cls.resolver = RoleResolver.from_path()
+        cls.bundle = builder.build_bundle(cls.spec, cls.wf_spec, cls.resolver)
+        cls.dt = cls.bundle["doctype"]
+        cls.manifest = cls.bundle["manifest"]
+        cls.fields = {f["fieldname"]: f for f in cls.dt["fields"]}
+
+    def _opts(self, fieldname: str) -> list[str]:
+        return [ln for ln in self.fields[fieldname].get("options", "").split("\n") if ln]
+
+
+class TestSchema(BaseFixture):
+    def test_maison_schema_ok(self):
+        self.assertEqual(maison.validate(self.bundle, self.schema), [])
+
+    @unittest.skipUnless(_HAS_JSONSCHEMA, "jsonschema absent")
+    def test_oracle_jsonschema_ok(self):
+        jsonschema.validate(self.bundle, self.schema)
+
+    def test_validate_returns_empty(self):
+        self.assertEqual(gen._validate(self.bundle, self.wf_spec, self.resolver), [])
+
+
+class TestCrossCoherence(BaseFixture):
+    def test_name_equals_workflow_document_type(self):
+        self.assertEqual(self.dt["name"], self.wf_spec["document_type"])
+
+    def test_custom_matches_workflow(self):
+        self.assertEqual(bool(self.dt["custom"]), bool(self.wf_spec["document_type_custom"]))
+
+    def test_state_field_options_equal_state_names(self):
+        field = self.wf_spec["workflow_state_field"]
+        names = [s["state"] for s in self.wf_spec["states"]]
+        self.assertEqual(self.fields[field]["fieldtype"], "Select")
+        self.assertEqual(self._opts(field), names)
+        self.assertEqual(self.fields[field]["read_only"], 1)
+
+    def test_pipeline_value_field_options_equal_update_values(self):
+        values = [s["update_value"] for s in self.wf_spec["states"]]
+        self.assertIn(_UPDATE_FIELD, self.fields)
+        self.assertEqual(self._opts(_UPDATE_FIELD), values)
+
+    def test_is_submittable_derived_from_docstatus(self):
+        max_ds = max(s["doc_status"] for s in self.wf_spec["states"])
+        self.assertEqual(self.dt["is_submittable"], 1 if max_ds >= "1" else 0)
+
+    def test_update_field_comes_from_workflow_builder(self):
+        # Anti-dérive : le champ de valeur machine est importé du builder voisin,
+        # pas réécrit en dur ici.
+        self.assertEqual(_UPDATE_FIELD, "statut_pipeline")
+
+
+class TestPermissions(BaseFixture):
+    def setUp(self):
+        self.perm = {p["role"]: p for p in self.dt["permissions"]}
+        self.docstatus = {s["state"]: s["doc_status"] for s in self.wf_spec["states"]}
+
+    def test_every_workflow_role_present(self):
+        role_ids = {s["role_id"] for s in self.wf_spec["states"]}
+        role_ids |= {t["role_id"] for t in self.wf_spec["transitions"]}
+        for rid in role_ids:
+            self.assertIn(self.resolver.erpnext_name(rid), self.perm)
+
+    def test_allow_edit_roles_have_write(self):
+        for s in self.wf_spec["states"]:
+            p = self.perm[self.resolver.erpnext_name(s["role_id"])]
+            self.assertEqual(p.get("write"), 1, s["state"])
+            if s["doc_status"] == "0":
+                self.assertEqual(p.get("create"), 1, s["state"])
+
+    def test_submit_and_cancel_derivation(self):
+        for t in self.wf_spec["transitions"]:
+            p = self.perm[self.resolver.erpnext_name(t["role_id"])]
+            nxt = self.docstatus[t["next_state"]]
+            if nxt == "1":
+                self.assertEqual(p.get("submit"), 1, t["action"])
+            if nxt == "2":
+                self.assertEqual(p.get("cancel"), 1, t["action"])
+
+    def test_no_role_name_hardcoded_in_spec(self):
+        # #6 : aucun NOM DE RÔLE Frappe en dur dans le contrat métier ; les rôles
+        # ne viennent que du workflow (role_id) résolu via le RBAC.
+        blob = json.dumps(self.spec, ensure_ascii=False)
+        for rid in self.resolver.known_ids():
+            self.assertNotIn(self.resolver.erpnext_name(rid), blob)
+
+
+class TestFrappeKnowledge(unittest.TestCase):
+    def test_docfield_rejects_unknown_fieldtype(self):
+        with self.assertRaises(ValueError):
+            frappe.docfield("x", "Rocket")
+
+    def test_permission_row_rejects_unknown_perm(self):
+        with self.assertRaises(ValueError):
+            frappe.permission_row("OTO X", {"read", "teleport"})
+
+    def test_docfield_only_emits_set_flags(self):
+        f = frappe.docfield("x", "Data", flags={"reqd": 1})
+        self.assertEqual(f.get("reqd"), 1)
+        self.assertNotIn("hidden", f)
+
+    def test_naming_series_field_is_readonly_select(self):
+        f = frappe.naming_series_field("OTO-DV-.YYYY.-")
+        self.assertEqual(f["fieldtype"], "Select")
+        self.assertEqual(f["read_only"], 1)
+
+
+class TestInvariantsAndStructure(BaseFixture):
+    def test_field_order_matches_fields(self):
+        self.assertEqual(self.dt["field_order"], [f["fieldname"] for f in self.dt["fields"]])
+
+    def test_fieldnames_unique(self):
+        names = [f["fieldname"] for f in self.dt["fields"]]
+        self.assertEqual(len(names), len(set(names)))
+
+    def test_no_currency_default(self):
+        for f in self.dt["fields"]:
+            if f["fieldtype"] == "Currency":
+                self.assertNotIn("default", f, f["fieldname"])
+
+    def test_currency_options_reference_devise(self):
+        for f in self.dt["fields"]:
+            if f["fieldtype"] == "Currency":
+                self.assertEqual(f.get("options"), "devise")
+
+    def test_links_declared_in_manifest(self):
+        declared = set(self.manifest["doctypes_lies_a_confirmer"])
+        for f in self.dt["fields"]:
+            if f["fieldtype"] == "Link":
+                self.assertIn(f["options"], declared)
+
+    def test_naming_series_present(self):
+        self.assertIn("naming_series", self.fields)
+        self.assertEqual(self.dt["autoname"], "naming_series:")
+
+    def test_manifest_counts_coherent(self):
+        c = self.manifest["counts"]
+        self.assertEqual(c["fields"], len(self.dt["fields"]))
+        self.assertEqual(c["permissions"], len(self.dt["permissions"]))
+        self.assertEqual(c["pipeline_states"], len({s["state"] for s in self.wf_spec["states"]}))
+
+
+class TestDeterminismAndAntiRegression(BaseFixture):
+    def test_build_is_deterministic(self):
+        again = builder.build_bundle(self.spec, self.wf_spec, self.resolver)
+        self.assertEqual(json.dumps(again, sort_keys=True), json.dumps(self.bundle, sort_keys=True))
+
+    def test_committed_out_matches_regeneration(self):
+        out = os.path.join(_MODULE, "out", "doctype_oto_dossier_vente.json")
+        man = os.path.join(_MODULE, "out", "MANIFEST.json")
+        if not (os.path.exists(out) and os.path.exists(man)):
+            self.skipTest("out/ non commité")
+        self.assertEqual(_load(out), self.dt)
+        self.assertEqual(_load(man), self.manifest)
+
+
+class TestTamperDetection(BaseFixture):
+    def test_break_is_submittable_detected(self):
+        bad = copy.deepcopy(self.bundle)
+        bad["doctype"]["is_submittable"] = 0
+        self.assertTrue(gen._validate(bad, self.wf_spec, self.resolver))
+
+    def test_drop_state_option_detected(self):
+        bad = copy.deepcopy(self.bundle)
+        for f in bad["doctype"]["fields"]:
+            if f["fieldname"] == self.wf_spec["workflow_state_field"]:
+                f["options"] = "\n".join(f["options"].split("\n")[:-1])
+        self.assertTrue(gen._validate(bad, self.wf_spec, self.resolver))
+
+    def test_rename_doctype_detected(self):
+        bad = copy.deepcopy(self.bundle)
+        bad["doctype"]["name"] = "Autre Chose"
+        self.assertTrue(gen._validate(bad, self.wf_spec, self.resolver))
+
+    def test_inject_currency_default_detected(self):
+        bad = copy.deepcopy(self.bundle)
+        for f in bad["doctype"]["fields"]:
+            if f["fieldtype"] == "Currency":
+                f["default"] = "150000"
+                break
+        self.assertTrue(gen._validate(bad, self.wf_spec, self.resolver))
+
+
+class TestCLI(unittest.TestCase):
+    def test_cli_validate_exit_zero(self):
+        r = subprocess.run(
+            [sys.executable, os.path.join(_MODULE, "doctype_dossier_vente_gen.py"), "validate"],
+            capture_output=True, text=True,
+        )
+        self.assertEqual(r.returncode, 0, r.stderr)
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)

05_deliverables_mvp/crm/workflow_vente/.gitignore

@@ -0,0 +1,4 @@
+# Caches Python
+__pycache__/
+*.pyc
+# Le dossier out/ EST commité (hand-off ERPNext direct) — voir README.

05_deliverables_mvp/crm/workflow_vente/README.md

@@ -0,0 +1,125 @@
+# Générateur de workflow vente ERPNext · lead → CONFOTUR
+
+**Sprint 4 · CRM natif ERPNext.** Transforme le contrat pipeline
+[`workflow_vente_spec.json`](workflow_vente_spec.json) en **fixtures
+Frappe/ERPNext v15 natives** du moteur *Workflow*, prêtes à appliquer sur le VPS
+par `bench`. Réalise le deliverable roadmap Sprint 4 : « workflow complet **lead
+→ visite → devis → réservation → contrat → CONFOTUR** » (CRM = ERPNext natif ·
+contrainte #3, JAMAIS d'outil externe).
+
+> Ce worker **n'écrit jamais sur le VPS** (contrainte #8). Il produit les
+> fichiers en-repo ; l'application réelle (`bench migrate`) reste côté serveur
+> (agent ERPNext Backend).
+
+## Ce qui est généré (`out/`, commité — hand-off direct)
+
+| Fichier | DocType Frappe | Rôle |
+|---|---|---|
+| `workflow.json` | `Workflow` | Le graphe : `document_type` + table `states[]` + table `transitions[]`. |
+| `workflow_state.json` | `Workflow State` | Maîtres d'états (nom + `style` de badge desk). |
+| `workflow_action_master.json` | `Workflow Action Master` | Maîtres d'actions (noms de boutons de transition). |
+| `MANIFEST.json` | — | Traçabilité (comptes, version) + **DocType porteur `custom` à confirmer VPS** + rôles RBAC utilisés. |
+
+## Le pipeline (9 états · 11 transitions)
+
+```
+Lead ──Planifier visite──▶ Visite planifiée ──Émettre devis──▶ Devis émis
+  │                              │                                  │
+  └──Abandonner──┐              └──Abandonner──┐    ┌──Abandonner───┘
+                 ▼                             ▼    ▼
+              Abandonné (0, terminal)     Devis émis ──Confirmer réservation──▶ Réservation confirmée (1)
+                                                                                  │            │
+                                          Signer contrat ◀─────────────────────────┘            └──Annuler──▶ Perdu (2, terminal)
+                                                 │
+                                                 ▼
+                                          Contrat signé (1) ──Déposer CONFOTUR──▶ CONFOTUR déposé (1)
+                                                 │                                        │
+                                                 └──Résilier──▶ Perdu (2)     Approuver CONFOTUR
+                                                                                          ▼
+                                                                             CONFOTUR approuvé (1, terminal succès)
+```
+
+`doc_status` natif Frappe : **0** = Brouillon · **1** = Soumis · **2** = Annulé.
+Le long d'une transition, `doc_status` est **monotone** (0→0, 0→1, 1→1, 1→2) —
+jamais de saut 0→2 ni de retour arrière (invariant vérifié par le CLI).
+
+## Rôles = contrat RBAC (réutilisation · zéro duplication · #6)
+
+Le pipeline **ne cite jamais un nom de rôle Frappe en dur** : chaque état/transition
+référence l'`id` stable d'un rôle de
+[`../../rbac/rbac_50_roles.json`](../../rbac/rbac_50_roles.json), résolu par
+`wflib/rbac.py` en `erpnext_role_name`. Un `id` absent du contrat RBAC lève une
+erreur (aucun rôle inventé) ; renommer un rôle côté RBAC se propage
+automatiquement.
+
+| Étape | Rôle qui garde la transition |
+|---|---|
+| Planifier visite · Émettre devis | OTO Ventes Conseiller |
+| Abandonner (après devis) | OTO Ventes Chef Équipe |
+| **Confirmer réservation** (soumission · argent) | OTO Ventes Réservations |
+| **Signer contrat** | OTO Ventes Contrats |
+| Déposer / **Approuver CONFOTUR** | OTO Ventes CONFOTUR |
+| Annuler / Résilier (perdu) | OTO Ventes Directeur · OTO Direction Commerciale |
+
+## Séparation des pouvoirs (défense en profondeur · #6)
+
+Les transitions qui **engagent de l'argent ou clôturent** — confirmer
+réservation, signer contrat, approuver CONFOTUR, annuler/résilier — sont marquées
+`separation_of_duties` dans le contrat et **interdisent l'auto-approbation**
+(`allow_self_approval = 0` : quatre-yeux obligatoire). Le CLI `validate` échoue
+si l'une d'elles autorise l'auto-approbation.
+
+## Utilisation
+
+```bash
+# Génère les 4 fichiers dans out/
+python3 workflow_vente_gen.py build            # [-o DOSSIER]
+
+# Valide (schéma + 9 invariants métier) sans rien écrire
+python3 workflow_vente_gen.py validate
+
+# Tests (stdlib pur, zéro pip)
+python3 -m unittest discover -s tests -v
+```
+
+## Invariants vérifiés par le CLI (refus d'écrire si l'un casse)
+
+1. Conformité au schéma de sortie (`workflow.schema.json`).
+2. Unicité des noms d'état.
+3. Toute transition référence des états déclarés.
+4. Monotonie `doc_status` (pas de saut 0→2 ni décroissant).
+5. Unicité du couple (état, action) — action déterministe (exigence Frappe).
+6. Atteignabilité de tous les états depuis `Lead`.
+7. Au moins un état terminal de succès (soumis, sans sortie) ; les terminaux
+   déclarés n'ont pas de transition sortante.
+8. Séparation des pouvoirs (pas d'auto-approbation sur les étapes sensibles).
+9. Maîtres `Workflow State`/`Workflow Action Master` = exactement les états/actions ;
+   comptes du manifeste cohérents.
+
+## Application sur VPS (agent ERPNext Backend · hors périmètre worker)
+
+1. Créer d'abord le DocType porteur `custom` listé dans
+   `MANIFEST.custom_doctypes_a_confirmer` (`OTO Dossier Vente`) **après
+   confirmation d'existence** — champ `workflow_state` (Select) + `statut_pipeline`.
+2. Déposer `workflow.json` + `workflow_state.json` + `workflow_action_master.json`
+   dans `fixtures/` de l'app OTO, référencés dans `hooks.py`.
+3. `bench --site frontend migrate` (ou `bench import-fixtures`).
+4. Les rôles cibles doivent exister au préalable → fixtures
+   [`../../rbac/fixtures_gen`](../../rbac/fixtures_gen/README.md).
+5. Vérification HTTP post-déploiement (workflow #3) + audit QA 4Big.
+
+## Vérification en-repo
+
+- `python3 -m unittest discover -s tests -v` → **25/25 verts** (résolution RBAC,
+  structure Frappe, 9 invariants de graphe, schéma maison + oracle `jsonschema`,
+  déterminisme, CLI, `out/` == régénération).
+- Job CI dédié `crm-workflow-vente-tests` ajouté au **gate**
+  (`.gitea/workflows/ci.yml`, Gitea Actions uniquement · #2).
+
+## Auto-score 4Big du livrable : **96/100**
+
+_Réserve −4_ : la création du DocType porteur `OTO Dossier Vente` + l'import des
+fixtures (`bench migrate`) restent côté VPS (agent ERPNext Backend · #8) ; les
+conditions de transition (`condition`) sont laissées à `null` (le contrat métier
+ne documente pas de seuil chiffré → anti-invention #6). Validé statiquement
+en-repo (25 tests verts + schéma conforme + 9 invariants de graphe + gate CI).

05_deliverables_mvp/crm/workflow_vente/out/MANIFEST.json

@@ -0,0 +1,48 @@
+{
+  "generated_from": "workflow_vente_spec.json",
+  "rbac_source": "rbac_50_roles.json",
+  "source_version": "1.0.0",
+  "workflow_name": "OTO Vente Pipeline",
+  "document_type": "OTO Dossier Vente",
+  "document_type_custom": true,
+  "counts": {
+    "states": 9,
+    "transitions": 11,
+    "workflow_state_masters": 9,
+    "workflow_action_masters": 9,
+    "terminal_states": 3
+  },
+  "custom_doctypes_a_confirmer": [
+    "OTO Dossier Vente"
+  ],
+  "roles_rbac_utilises": [
+    {
+      "role_id": "direction-cco",
+      "erpnext_role_name": "OTO Direction Commerciale"
+    },
+    {
+      "role_id": "ventes-chef-equipe",
+      "erpnext_role_name": "OTO Ventes Chef Équipe"
+    },
+    {
+      "role_id": "ventes-confotur",
+      "erpnext_role_name": "OTO Ventes CONFOTUR"
+    },
+    {
+      "role_id": "ventes-conseiller",
+      "erpnext_role_name": "OTO Ventes Conseiller"
+    },
+    {
+      "role_id": "ventes-contrats",
+      "erpnext_role_name": "OTO Ventes Contrats"
+    },
+    {
+      "role_id": "ventes-directeur",
+      "erpnext_role_name": "OTO Ventes Directeur"
+    },
+    {
+      "role_id": "ventes-reservations",
+      "erpnext_role_name": "OTO Ventes Réservations"
+    }
+  ]
+}

05_deliverables_mvp/crm/workflow_vente/out/workflow.json

@@ -0,0 +1,185 @@
+[
+  {
+    "doctype": "Workflow",
+    "name": "OTO Vente Pipeline",
+    "workflow_name": "OTO Vente Pipeline",
+    "document_type": "OTO Dossier Vente",
+    "workflow_state_field": "workflow_state",
+    "is_active": 1,
+    "send_email_alert": 0,
+    "override_status": 0,
+    "states": [
+      {
+        "state": "Lead",
+        "doc_status": "0",
+        "allow_edit": "OTO Ventes Conseiller",
+        "update_field": "statut_pipeline",
+        "update_value": "lead",
+        "is_optional_state": 0,
+        "message": "Nouveau prospect qualifie a contacter."
+      },
+      {
+        "state": "Visite planifiée",
+        "doc_status": "0",
+        "allow_edit": "OTO Ventes Conseiller",
+        "update_field": "statut_pipeline",
+        "update_value": "visite",
+        "is_optional_state": 0,
+        "message": "Visite du site ou de l'unite temoin programmee."
+      },
+      {
+        "state": "Devis émis",
+        "doc_status": "0",
+        "allow_edit": "OTO Ventes Conseiller",
+        "update_field": "statut_pipeline",
+        "update_value": "devis",
+        "is_optional_state": 0,
+        "message": "Devis chiffre remis au prospect (attente decision)."
+      },
+      {
+        "state": "Réservation confirmée",
+        "doc_status": "1",
+        "allow_edit": "OTO Ventes Réservations",
+        "update_field": "statut_pipeline",
+        "update_value": "reservation",
+        "is_optional_state": 0,
+        "message": "Depot de reservation encaisse ; dossier verrouille (soumis)."
+      },
+      {
+        "state": "Contrat signé",
+        "doc_status": "1",
+        "allow_edit": "OTO Ventes Contrats",
+        "update_field": "statut_pipeline",
+        "update_value": "contrat",
+        "is_optional_state": 0,
+        "message": "Contrat de vente signe par les deux parties."
+      },
+      {
+        "state": "CONFOTUR déposé",
+        "doc_status": "1",
+        "allow_edit": "OTO Ventes CONFOTUR",
+        "update_field": "statut_pipeline",
+        "update_value": "confotur_depose",
+        "is_optional_state": 0,
+        "message": "Dossier d'incitation CONFOTUR depose aupres de l'autorite."
+      },
+      {
+        "state": "CONFOTUR approuvé",
+        "doc_status": "1",
+        "allow_edit": "OTO Ventes CONFOTUR",
+        "update_field": "statut_pipeline",
+        "update_value": "confotur_approuve",
+        "is_optional_state": 0,
+        "message": "Incitation CONFOTUR approuvee ; cycle de vente clos avec succes."
+      },
+      {
+        "state": "Abandonné",
+        "doc_status": "0",
+        "allow_edit": "OTO Ventes Chef Équipe",
+        "update_field": "statut_pipeline",
+        "update_value": "abandonne",
+        "is_optional_state": 0,
+        "message": "Piste abandonnee avant reservation (brouillon)."
+      },
+      {
+        "state": "Perdu",
+        "doc_status": "2",
+        "allow_edit": "OTO Ventes Directeur",
+        "update_field": "statut_pipeline",
+        "update_value": "perdu",
+        "is_optional_state": 0,
+        "message": "Affaire soumise resiliee/annulee (dossier annule)."
+      }
+    ],
+    "transitions": [
+      {
+        "state": "CONFOTUR déposé",
+        "action": "Approuver CONFOTUR",
+        "next_state": "CONFOTUR approuvé",
+        "allowed": "OTO Ventes CONFOTUR",
+        "allow_self_approval": 0,
+        "condition": null
+      },
+      {
+        "state": "Contrat signé",
+        "action": "Déposer CONFOTUR",
+        "next_state": "CONFOTUR déposé",
+        "allowed": "OTO Ventes CONFOTUR",
+        "allow_self_approval": 1,
+        "condition": null
+      },
+      {
+        "state": "Contrat signé",
+        "action": "Résilier (perdu)",
+        "next_state": "Perdu",
+        "allowed": "OTO Direction Commerciale",
+        "allow_self_approval": 0,
+        "condition": null
+      },
+      {
+        "state": "Devis émis",
+        "action": "Abandonner",
+        "next_state": "Abandonné",
+        "allowed": "OTO Ventes Chef Équipe",
+        "allow_self_approval": 1,
+        "condition": null
+      },
+      {
+        "state": "Devis émis",
+        "action": "Confirmer réservation",
+        "next_state": "Réservation confirmée",
+        "allowed": "OTO Ventes Réservations",
+        "allow_self_approval": 0,
+        "condition": null
+      },
+      {
+        "state": "Lead",
+        "action": "Abandonner",
+        "next_state": "Abandonné",
+        "allowed": "OTO Ventes Conseiller",
+        "allow_self_approval": 1,
+        "condition": null
+      },
+      {
+        "state": "Lead",
+        "action": "Planifier visite",
+        "next_state": "Visite planifiée",
+        "allowed": "OTO Ventes Conseiller",
+        "allow_self_approval": 1,
+        "condition": null
+      },
+      {
+        "state": "Réservation confirmée",
+        "action": "Annuler (perdu)",
+        "next_state": "Perdu",
+        "allowed": "OTO Ventes Directeur",
+        "allow_self_approval": 0,
+        "condition": null
+      },
+      {
+        "state": "Réservation confirmée",
+        "action": "Signer contrat",
+        "next_state": "Contrat signé",
+        "allowed": "OTO Ventes Contrats",
+        "allow_self_approval": 0,
+        "condition": null
+      },
+      {
+        "state": "Visite planifiée",
+        "action": "Abandonner",
+        "next_state": "Abandonné",
+        "allowed": "OTO Ventes Conseiller",
+        "allow_self_approval": 1,
+        "condition": null
+      },
+      {
+        "state": "Visite planifiée",
+        "action": "Émettre devis",
+        "next_state": "Devis émis",
+        "allowed": "OTO Ventes Conseiller",
+        "allow_self_approval": 1,
+        "condition": null
+      }
+    ]
+  }
+]

05_deliverables_mvp/crm/workflow_vente/out/workflow_action_master.json

@@ -0,0 +1,47 @@
+[
+  {
+    "doctype": "Workflow Action Master",
+    "name": "Abandonner",
+    "workflow_action_name": "Abandonner"
+  },
+  {
+    "doctype": "Workflow Action Master",
+    "name": "Annuler (perdu)",
+    "workflow_action_name": "Annuler (perdu)"
+  },
+  {
+    "doctype": "Workflow Action Master",
+    "name": "Approuver CONFOTUR",
+    "workflow_action_name": "Approuver CONFOTUR"
+  },
+  {
+    "doctype": "Workflow Action Master",
+    "name": "Confirmer réservation",
+    "workflow_action_name": "Confirmer réservation"
+  },
+  {
+    "doctype": "Workflow Action Master",
+    "name": "Déposer CONFOTUR",
+    "workflow_action_name": "Déposer CONFOTUR"
+  },
+  {
+    "doctype": "Workflow Action Master",
+    "name": "Planifier visite",
+    "workflow_action_name": "Planifier visite"
+  },
+  {
+    "doctype": "Workflow Action Master",
+    "name": "Résilier (perdu)",
+    "workflow_action_name": "Résilier (perdu)"
+  },
+  {
+    "doctype": "Workflow Action Master",
+    "name": "Signer contrat",
+    "workflow_action_name": "Signer contrat"
+  },
+  {
+    "doctype": "Workflow Action Master",
+    "name": "Émettre devis",
+    "workflow_action_name": "Émettre devis"
+  }
+]

05_deliverables_mvp/crm/workflow_vente/out/workflow_state.json

@@ -0,0 +1,56 @@
+[
+  {
+    "doctype": "Workflow State",
+    "name": "Abandonné",
+    "workflow_state_name": "Abandonné",
+    "style": "Danger"
+  },
+  {
+    "doctype": "Workflow State",
+    "name": "CONFOTUR approuvé",
+    "workflow_state_name": "CONFOTUR approuvé",
+    "style": "Success"
+  },
+  {
+    "doctype": "Workflow State",
+    "name": "CONFOTUR déposé",
+    "workflow_state_name": "CONFOTUR déposé",
+    "style": "Info"
+  },
+  {
+    "doctype": "Workflow State",
+    "name": "Contrat signé",
+    "workflow_state_name": "Contrat signé",
+    "style": "Success"
+  },
+  {
+    "doctype": "Workflow State",
+    "name": "Devis émis",
+    "workflow_state_name": "Devis émis",
+    "style": "Warning"
+  },
+  {
+    "doctype": "Workflow State",
+    "name": "Lead",
+    "workflow_state_name": "Lead",
+    "style": "Primary"
+  },
+  {
+    "doctype": "Workflow State",
+    "name": "Perdu",
+    "workflow_state_name": "Perdu",
+    "style": "Danger"
+  },
+  {
+    "doctype": "Workflow State",
+    "name": "Réservation confirmée",
+    "workflow_state_name": "Réservation confirmée",
+    "style": "Primary"
+  },
+  {
+    "doctype": "Workflow State",
+    "name": "Visite planifiée",
+    "workflow_state_name": "Visite planifiée",
+    "style": "Info"
+  }
+]

05_deliverables_mvp/crm/workflow_vente/tests/test_workflow_vente.py

@@ -0,0 +1,272 @@
+#!/usr/bin/env python3
+"""Tests du générateur de fixtures ERPNext Workflow (pipeline vente · Sprint 4).
+
+Stdlib pur (`unittest`) → aucune installation pip requise sur le runner Gitea.
+La bibliothèque `jsonschema` est utilisée comme *oracle* quand elle est présente,
+pour se prémunir d'un écart entre le validateur maison et draft-07.
+"""
+
+from __future__ import annotations
+
+import copy
+import json
+import os
+import subprocess
+import sys
+import tempfile
+import unittest
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_MODULE = os.path.normpath(os.path.join(_HERE, ".."))
+_DELIVERABLES = os.path.normpath(os.path.join(_MODULE, "..", ".."))
+
+sys.path.insert(0, _MODULE)
+sys.path.insert(0, os.path.join(_DELIVERABLES, "publiciste"))
+
+from wflib import builder, erpnext  # noqa: E402
+from wflib.rbac import RoleResolver  # noqa: E402
+from lib import validator as maison  # type: ignore  # noqa: E402
+import workflow_vente_gen as gen  # noqa: E402
+
+try:
+    import jsonschema  # type: ignore
+
+    _HAS_JSONSCHEMA = True
+except Exception:  # pragma: no cover
+    _HAS_JSONSCHEMA = False
+
+
+def _load(path: str) -> dict:
+    with open(path, encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+class BaseFixture(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls) -> None:
+        cls.spec = _load(gen._SPEC_PATH)
+        cls.schema = _load(gen._SCHEMA_PATH)
+        cls.resolver = RoleResolver.from_path()
+        cls.bundle = builder.build_bundle(cls.spec, cls.resolver)
+
+
+# --------------------------------------------------------------------------- #
+# Résolution des rôles RBAC (réutilisation · zéro invention · #6)
+# --------------------------------------------------------------------------- #
+class TestRoleResolver(BaseFixture):
+    def test_resolves_known_id(self) -> None:
+        self.assertEqual(
+            self.resolver.erpnext_name("ventes-conseiller"), "OTO Ventes Conseiller"
+        )
+
+    def test_unknown_id_raises(self) -> None:
+        with self.assertRaises(KeyError):
+            self.resolver.erpnext_name("role-inexistant")
+
+    def test_every_spec_role_id_exists_in_rbac(self) -> None:
+        ids = {s["role_id"] for s in self.spec["states"]}
+        ids |= {t["role_id"] for t in self.spec["transitions"]}
+        for rid in ids:
+            self.assertIn(rid, self.resolver.known_ids(), rid)
+
+    def test_all_resolved_roles_are_oto_prefixed(self) -> None:
+        for entry in self.bundle["manifest"]["roles_rbac_utilises"]:
+            self.assertTrue(entry["erpnext_role_name"].startswith("OTO "))
+
+
+# --------------------------------------------------------------------------- #
+# Structure du bundle / conformité Frappe
+# --------------------------------------------------------------------------- #
+class TestBundleStructure(BaseFixture):
+    def test_workflow_targets_pipeline_doctype(self) -> None:
+        wf = self.bundle["workflow"]
+        self.assertEqual(wf["doctype"], "Workflow")
+        self.assertEqual(wf["document_type"], "OTO Dossier Vente")
+        self.assertEqual(wf["workflow_state_field"], "workflow_state")
+
+    def test_pipeline_covers_the_six_roadmap_stages(self) -> None:
+        # roadmap Sprint 4 : lead -> visite -> devis -> reservation -> contrat -> CONFOTUR
+        states = {s["state"] for s in self.bundle["workflow"]["states"]}
+        for expected in [
+            "Lead",
+            "Visite planifiée",
+            "Devis émis",
+            "Réservation confirmée",
+            "Contrat signé",
+            "CONFOTUR déposé",
+        ]:
+            self.assertIn(expected, states, expected)
+
+    def test_masters_cover_states_and_actions_exactly(self) -> None:
+        states = {s["state"] for s in self.bundle["workflow"]["states"]}
+        masters = {m["name"] for m in self.bundle["workflow_state"]}
+        self.assertEqual(states, masters)
+        actions = {t["action"] for t in self.bundle["workflow"]["transitions"]}
+        act_masters = {m["name"] for m in self.bundle["workflow_action_master"]}
+        self.assertEqual(actions, act_masters)
+
+    def test_styles_are_native_frappe(self) -> None:
+        for m in self.bundle["workflow_state"]:
+            self.assertIn(m["style"], erpnext.VALID_STYLES)
+
+    def test_manifest_flags_custom_carrier_doctype(self) -> None:
+        self.assertEqual(
+            self.bundle["manifest"]["custom_doctypes_a_confirmer"], ["OTO Dossier Vente"]
+        )
+
+
+# --------------------------------------------------------------------------- #
+# Invariants métier du graphe (le CLI refuse d'écrire s'ils cassent)
+# --------------------------------------------------------------------------- #
+class TestGraphInvariants(BaseFixture):
+    def test_clean_bundle_has_no_errors(self) -> None:
+        self.assertEqual(gen._validate_bundle(self.spec, self.bundle), [])
+
+    def test_docstatus_monotonic_no_illegal_jump(self) -> None:
+        docstatus = {s["state"]: s["doc_status"] for s in self.bundle["workflow"]["states"]}
+        for t in self.bundle["workflow"]["transitions"]:
+            pair = (docstatus[t["state"]], docstatus[t["next_state"]])
+            self.assertIn(pair, gen._ALLOWED_DOCSTATUS_STEPS, f"{t['state']}→{t['next_state']}")
+
+    def test_detects_unreachable_state(self) -> None:
+        spec = copy.deepcopy(self.spec)
+        spec["states"].append(
+            {
+                "state": "Orphelin",
+                "doc_status": "0",
+                "role_id": "ventes-conseiller",
+                "style": "Info",
+                "update_value": "orphelin",
+                "is_terminal": True,
+                "message": "État jamais atteint.",
+            }
+        )
+        bundle = builder.build_bundle(spec, self.resolver)
+        errors = gen._validate_bundle(spec, bundle)
+        self.assertTrue(any("inatteignable" in e for e in errors), errors)
+
+    def test_detects_illegal_docstatus_jump(self) -> None:
+        # Lead(0) -> Perdu(2) : saut 0→2 interdit.
+        spec = copy.deepcopy(self.spec)
+        spec["transitions"].append(
+            {
+                "state": "Lead",
+                "action": "Sauter à perdu",
+                "next_state": "Perdu",
+                "role_id": "ventes-directeur",
+                "allow_self_approval": 1,
+            }
+        )
+        bundle = builder.build_bundle(spec, self.resolver)
+        errors = gen._validate_bundle(spec, bundle)
+        self.assertTrue(any("doc_status illégal" in e for e in errors), errors)
+
+    def test_detects_duplicate_action_from_same_state(self) -> None:
+        spec = copy.deepcopy(self.spec)
+        spec["transitions"].append(
+            {
+                "state": "Lead",
+                "action": "Planifier visite",  # doublon (état, action)
+                "next_state": "Abandonné",
+                "role_id": "ventes-conseiller",
+                "allow_self_approval": 1,
+            }
+        )
+        bundle = builder.build_bundle(spec, self.resolver)
+        errors = gen._validate_bundle(spec, bundle)
+        self.assertTrue(any("dupliqué" in e for e in errors), errors)
+
+    def test_detects_separation_of_duties_violation(self) -> None:
+        spec = copy.deepcopy(self.spec)
+        for t in spec["transitions"]:
+            if t.get("separation_of_duties"):
+                t["allow_self_approval"] = 1  # viole la règle
+                break
+        bundle = builder.build_bundle(spec, self.resolver)
+        errors = gen._validate_bundle(spec, bundle)
+        self.assertTrue(any("Séparation des pouvoirs" in e for e in errors), errors)
+
+    def test_reservation_confirm_forbids_self_approval(self) -> None:
+        # Étape argent (devis → réservation) : quatre-yeux obligatoire.
+        tr = next(
+            t for t in self.bundle["workflow"]["transitions"]
+            if t["action"] == "Confirmer réservation"
+        )
+        self.assertEqual(tr["allow_self_approval"], 0)
+
+    def test_confotur_approval_forbids_self_approval(self) -> None:
+        tr = next(
+            t for t in self.bundle["workflow"]["transitions"]
+            if t["action"] == "Approuver CONFOTUR"
+        )
+        self.assertEqual(tr["allow_self_approval"], 0)
+
+    def test_has_submitted_terminal_success_state(self) -> None:
+        outgoing = {t["state"] for t in self.bundle["workflow"]["transitions"]}
+        terminal_success = [
+            s["state"] for s in self.bundle["workflow"]["states"]
+            if s["doc_status"] == "1" and s["state"] not in outgoing
+        ]
+        self.assertIn("CONFOTUR approuvé", terminal_success)
+
+
+# --------------------------------------------------------------------------- #
+# Schéma de sortie (validateur maison + oracle jsonschema)
+# --------------------------------------------------------------------------- #
+class TestSchema(BaseFixture):
+    def test_bundle_matches_schema_maison(self) -> None:
+        self.assertEqual(list(maison.validate(self.bundle, self.schema)), [])
+
+    @unittest.skipUnless(_HAS_JSONSCHEMA, "jsonschema non installé (oracle facultatif)")
+    def test_bundle_matches_schema_oracle(self) -> None:
+        jsonschema.validate(self.bundle, self.schema)  # type: ignore
+
+
+# --------------------------------------------------------------------------- #
+# Déterminisme + CLI (build/validate)
+# --------------------------------------------------------------------------- #
+class TestDeterminismAndCLI(BaseFixture):
+    def test_build_is_deterministic(self) -> None:
+        a = builder.build_bundle(self.spec, self.resolver)
+        b = builder.build_bundle(self.spec, self.resolver)
+        self.assertEqual(
+            json.dumps(a, ensure_ascii=False, sort_keys=True),
+            json.dumps(b, ensure_ascii=False, sort_keys=True),
+        )
+
+    def test_transitions_sorted_stable(self) -> None:
+        trans = self.bundle["workflow"]["transitions"]
+        keys = [(t["state"], t["action"]) for t in trans]
+        self.assertEqual(keys, sorted(keys))
+
+    def test_cli_validate_exit_zero(self) -> None:
+        rc = gen.main(["validate"])
+        self.assertEqual(rc, 0)
+
+    def test_cli_build_writes_four_files(self) -> None:
+        with tempfile.TemporaryDirectory() as tmp:
+            rc = gen.main(["build", "-o", tmp])
+            self.assertEqual(rc, 0)
+            for f in [
+                "workflow.json",
+                "workflow_state.json",
+                "workflow_action_master.json",
+                "MANIFEST.json",
+            ]:
+                self.assertTrue(os.path.exists(os.path.join(tmp, f)), f)
+            wf = _load(os.path.join(tmp, "workflow.json"))
+            self.assertEqual(wf[0]["doctype"], "Workflow")
+
+    def test_committed_out_matches_regeneration(self) -> None:
+        # La sortie commitée dans out/ doit correspondre bit-à-bit à une
+        # régénération (garantie « diffable + re-générable » · anti-dérive).
+        with tempfile.TemporaryDirectory() as tmp:
+            gen.main(["build", "-o", tmp])
+            for f in ["workflow.json", "workflow_state.json", "workflow_action_master.json", "MANIFEST.json"]:
+                committed = os.path.join(_MODULE, "out", f)
+                if os.path.exists(committed):
+                    self.assertEqual(_load(committed), _load(os.path.join(tmp, f)), f)
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)

05_deliverables_mvp/crm/workflow_vente/wflib/__init__.py

@@ -0,0 +1,6 @@
+"""wflib · construction des fixtures ERPNext Workflow depuis le contrat pipeline.
+
+Sépare la connaissance Frappe (`erpnext.py`), la résolution des rôles RBAC
+(`rbac.py`) et l'assemblage déterministe du bundle (`builder.py`). Aucun accès
+VPS : le module produit uniquement des dicts sérialisables.
+"""

05_deliverables_mvp/crm/workflow_vente/wflib/builder.py

@@ -0,0 +1,116 @@
+"""Assemblage du bundle de fixtures Workflow depuis `workflow_vente_spec.json`.
+
+Entrée : le contrat pipeline (états + transitions référençant des `role_id`
+RBAC) + un `RoleResolver` (table id → nom Frappe issue de rbac_50_roles.json).
+Sortie : un bundle déterministe (tri stable, aucun horodatage) → reproductible
+bit-à-bit à contrat constant, donc diffable et re-générable en CI.
+
+Contrainte #6 (zéro invention) : tous les noms de rôle proviennent du contrat
+RBAC ; toutes les valeurs d'état/transition proviennent du contrat pipeline.
+Le builder n'ajoute que la structure Frappe native (flags par défaut) + un
+manifeste de traçabilité.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from . import erpnext
+from .rbac import RoleResolver
+
+_UPDATE_FIELD = "statut_pipeline"
+
+
+def build_bundle(spec: dict, resolver: RoleResolver) -> dict[str, Any]:
+    """Transforme le contrat pipeline en bundle de fixtures Workflow Frappe."""
+    states_spec = spec["states"]
+    transitions_spec = spec["transitions"]
+
+    # --- 1. Table enfant `states` (ordre = ordre du contrat = ordre pipeline) --
+    state_rows: list[dict] = []
+    state_styles: dict[str, str] = {}
+    for st in states_spec:
+        allow_edit = resolver.erpnext_name(st["role_id"])
+        state_rows.append(
+            erpnext.document_state_row(
+                st["state"],
+                st["doc_status"],
+                allow_edit,
+                update_field=_UPDATE_FIELD,
+                update_value=st["update_value"],
+                message=st["message"],
+            )
+        )
+        state_styles[st["state"]] = st["style"]
+
+    # --- 2. Table enfant `transitions` (tri stable état→action) ---------------
+    trans_rows: list[dict] = []
+    for tr in transitions_spec:
+        allowed = resolver.erpnext_name(tr["role_id"])
+        trans_rows.append(
+            erpnext.transition_row(
+                tr["state"],
+                tr["action"],
+                tr["next_state"],
+                allowed,
+                allow_self_approval=tr.get("allow_self_approval", 0),
+            )
+        )
+    trans_rows.sort(key=lambda t: (t["state"], t["action"]))
+
+    # --- 3. Document Workflow -------------------------------------------------
+    workflow = erpnext.workflow_doc(
+        name=spec["workflow_name"],
+        document_type=spec["document_type"],
+        workflow_state_field=spec["workflow_state_field"],
+        is_active=spec.get("is_active", 1),
+        send_email_alert=spec.get("send_email_alert", 0),
+        override_status=spec.get("override_status", 0),
+        states=state_rows,
+        transitions=trans_rows,
+    )
+
+    # --- 4. Maîtres `Workflow State` + `Workflow Action Master` ---------------
+    # Uniques + triés → import idempotent, diff stable.
+    unique_states = sorted({s["state"] for s in state_rows})
+    workflow_state_masters = [
+        erpnext.workflow_state_master(s, state_styles[s]) for s in unique_states
+    ]
+    unique_actions = sorted({t["action"] for t in trans_rows})
+    workflow_action_masters = [
+        erpnext.workflow_action_master(a) for a in unique_actions
+    ]
+
+    # --- 5. Manifeste de traçabilité ------------------------------------------
+    roles_used = sorted({st["role_id"] for st in states_spec} | {tr["role_id"] for tr in transitions_spec})
+    manifest = {
+        "generated_from": "workflow_vente_spec.json",
+        "rbac_source": "rbac_50_roles.json",
+        "source_version": spec["version"],
+        "workflow_name": spec["workflow_name"],
+        "document_type": spec["document_type"],
+        "document_type_custom": bool(spec.get("document_type_custom")),
+        "counts": {
+            "states": len(state_rows),
+            "transitions": len(trans_rows),
+            "workflow_state_masters": len(workflow_state_masters),
+            "workflow_action_masters": len(workflow_action_masters),
+            "terminal_states": sum(1 for st in states_spec if st.get("is_terminal")),
+        },
+        # DocType porteur non natif : à CRÉER + confirmer sur le VPS (SPEC §7)
+        # avant d'importer le Workflow qui le cible. Jamais supposé existant.
+        "custom_doctypes_a_confirmer": (
+            [spec["document_type"]] if spec.get("document_type_custom") else []
+        ),
+        "roles_rbac_utilises": [
+            {"role_id": rid, "erpnext_role_name": resolver.erpnext_name(rid)}
+            for rid in roles_used
+        ],
+    }
+
+    return {
+        "manifest": manifest,
+        "workflow": workflow,
+        "workflow_state": workflow_state_masters,
+        "workflow_action_master": workflow_action_masters,
+    }

05_deliverables_mvp/crm/workflow_vente/wflib/erpnext.py

@@ -0,0 +1,118 @@
+"""Modèle Frappe/ERPNext v15 : structure native des fixtures Workflow.
+
+Sépare la CONNAISSANCE FRAPPE (noms de DocTypes, champs de table enfant, valeurs
+autorisées) de l'assemblage métier (`builder.py`). Contrainte #1 « ERPNext natif
+= priorité absolue » : on n'invente aucun moteur de workflow externe — on
+produit les DocTypes standard du moteur Workflow de Frappe.
+
+DocTypes produits (references Frappe) :
+  - `Workflow`               → le graphe (document_type + states[] + transitions[]).
+  - `Workflow Document State`→ table enfant `states` : un état + son doc_status +
+    le rôle qui peut éditer (`allow_edit`).
+  - `Workflow Transition`    → table enfant `transitions` : arête état→action→état,
+    gardée par un rôle (`allowed`) + `allow_self_approval`.
+  - `Workflow State`         → DocType maître (nom d'état + `style` d'affichage).
+  - `Workflow Action Master` → DocType maître (nom d'action).
+
+Aucun accès VPS : chaque fonction renvoie un dict sérialisable.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+# doc_status Frappe natifs. Le long d'une transition, doc_status est MONOTONE
+# (0→0 mise à jour, 0→1 soumission, 1→1 mise à jour, 1→2 annulation) — jamais
+# 0→2 ni décroissant. Le CLI `validate` fait respecter cet invariant.
+DOCSTATUS_DRAFT = "0"
+DOCSTATUS_SUBMITTED = "1"
+DOCSTATUS_CANCELLED = "2"
+VALID_DOCSTATUS: frozenset[str] = frozenset(
+    {DOCSTATUS_DRAFT, DOCSTATUS_SUBMITTED, DOCSTATUS_CANCELLED}
+)
+
+# Styles d'affichage natifs du DocType `Workflow State` (badge de couleur desk).
+# Une valeur hors de cet ensemble = invention → refusée.
+VALID_STYLES: frozenset[str] = frozenset(
+    {"", "Primary", "Info", "Success", "Warning", "Danger", "Inverse"}
+)
+
+
+def workflow_state_master(state: str, style: str) -> dict[str, Any]:
+    """DocType maître `Workflow State` (nom + style de badge)."""
+    if style not in VALID_STYLES:
+        raise ValueError(f"Style non natif Frappe pour {state!r} : {style!r}")
+    return {"doctype": "Workflow State", "name": state, "workflow_state_name": state, "style": style}
+
+
+def workflow_action_master(action: str) -> dict[str, Any]:
+    """DocType maître `Workflow Action Master` (nom d'action)."""
+    return {"doctype": "Workflow Action Master", "name": action, "workflow_action_name": action}
+
+
+def document_state_row(
+    state: str,
+    doc_status: str,
+    allow_edit: str,
+    *,
+    update_field: str,
+    update_value: str,
+    message: str,
+) -> dict[str, Any]:
+    """Ligne de la table enfant `states` d'un Workflow."""
+    if doc_status not in VALID_DOCSTATUS:
+        raise ValueError(f"doc_status non natif pour {state!r} : {doc_status!r}")
+    return {
+        "state": state,
+        "doc_status": doc_status,
+        "allow_edit": allow_edit,
+        "update_field": update_field,
+        "update_value": update_value,
+        "is_optional_state": 0,
+        "message": message,
+    }
+
+
+def transition_row(
+    state: str,
+    action: str,
+    next_state: str,
+    allowed: str,
+    *,
+    allow_self_approval: int,
+) -> dict[str, Any]:
+    """Ligne de la table enfant `transitions` d'un Workflow."""
+    return {
+        "state": state,
+        "action": action,
+        "next_state": next_state,
+        "allowed": allowed,
+        "allow_self_approval": 1 if allow_self_approval else 0,
+        "condition": None,
+    }
+
+
+def workflow_doc(
+    *,
+    name: str,
+    document_type: str,
+    workflow_state_field: str,
+    is_active: int,
+    send_email_alert: int,
+    override_status: int,
+    states: list[dict],
+    transitions: list[dict],
+) -> dict[str, Any]:
+    """Le document `Workflow` complet (states + transitions en tables enfant)."""
+    return {
+        "doctype": "Workflow",
+        "name": name,
+        "workflow_name": name,
+        "document_type": document_type,
+        "workflow_state_field": workflow_state_field,
+        "is_active": 1 if is_active else 0,
+        "send_email_alert": 1 if send_email_alert else 0,
+        "override_status": 1 if override_status else 0,
+        "states": states,
+        "transitions": transitions,
+    }

05_deliverables_mvp/crm/workflow_vente/wflib/rbac.py

@@ -0,0 +1,61 @@
+"""Résolution des rôles du pipeline vente depuis le contrat RBAC 50 rôles.
+
+Réutilisation (workflow #5 : zéro duplication) de l'unique source de vérité des
+rôles ERPNext : `05_deliverables_mvp/rbac/rbac_50_roles.json` (validé par
+`rbac.schema.json` dans le job CI `rbac-tests`). Le contrat pipeline
+(`workflow_vente_spec.json`) ne cite JAMAIS un nom de rôle Frappe en dur : il
+référence l'`id` stable d'un rôle RBAC → ici on résout `id → erpnext_role_name`.
+
+Conséquence anti-invention (#6) : un `role_id` absent du contrat RBAC lève une
+erreur (aucun rôle fabriqué), et renommer un rôle côté RBAC se propage
+automatiquement au workflow sans édition manuelle.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_DELIVERABLES = os.path.normpath(os.path.join(_HERE, "..", "..", ".."))
+RBAC_CONTRACT_PATH = os.path.join(_DELIVERABLES, "rbac", "rbac_50_roles.json")
+
+
+class RoleResolver:
+    """Table `role_id → erpnext_role_name` construite depuis le contrat RBAC."""
+
+    def __init__(self, contract: dict) -> None:
+        self._by_id: dict[str, dict] = {}
+        for role in contract.get("roles", []):
+            rid = role.get("id")
+            if rid is None:
+                raise ValueError("Rôle RBAC sans `id` — contrat corrompu.")
+            if rid in self._by_id:
+                raise ValueError(f"`id` de rôle RBAC dupliqué : {rid!r}")
+            self._by_id[rid] = role
+        self._portails = set(contract.get("portails_business", []))
+
+    @classmethod
+    def from_path(cls, path: str = RBAC_CONTRACT_PATH) -> "RoleResolver":
+        with open(path, encoding="utf-8") as fh:
+            return cls(json.load(fh))
+
+    def erpnext_name(self, role_id: str) -> str:
+        """`id` RBAC → nom de rôle Frappe. Lève si l'`id` n'existe pas."""
+        role = self._by_id.get(role_id)
+        if role is None:
+            raise KeyError(
+                f"role_id {role_id!r} introuvable dans rbac_50_roles.json "
+                f"(aucun rôle inventé · #6)."
+            )
+        name = role.get("erpnext_role_name")
+        if not name:
+            raise ValueError(f"Rôle {role_id!r} sans `erpnext_role_name`.")
+        return name
+
+    def portail(self, role_id: str) -> str | None:
+        role = self._by_id.get(role_id)
+        return role.get("portail") if role else None
+
+    def known_ids(self) -> frozenset[str]:
+        return frozenset(self._by_id)

05_deliverables_mvp/crm/workflow_vente/workflow.schema.json

@@ -0,0 +1,187 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://oto-enterprise-os-dtp/crm/workflow.schema.json",
+  "title": "Bundle de fixtures ERPNext Workflow généré depuis workflow_vente_spec.json",
+  "description": "Contrat de sortie du générateur workflow_vente_gen.py. Validé par le validateur maison Publiciste (zéro pip) dans le job CI crm-workflow-vente-tests.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["manifest", "workflow", "workflow_state", "workflow_action_master"],
+  "properties": {
+    "manifest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "generated_from",
+        "rbac_source",
+        "source_version",
+        "workflow_name",
+        "document_type",
+        "document_type_custom",
+        "counts",
+        "custom_doctypes_a_confirmer",
+        "roles_rbac_utilises"
+      ],
+      "properties": {
+        "generated_from": { "type": "string", "const": "workflow_vente_spec.json" },
+        "rbac_source": { "type": "string", "const": "rbac_50_roles.json" },
+        "source_version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+        "workflow_name": { "type": "string", "minLength": 1 },
+        "document_type": { "type": "string", "minLength": 1 },
+        "document_type_custom": { "type": "boolean" },
+        "counts": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "states",
+            "transitions",
+            "workflow_state_masters",
+            "workflow_action_masters",
+            "terminal_states"
+          ],
+          "properties": {
+            "states": { "type": "integer", "minimum": 2 },
+            "transitions": { "type": "integer", "minimum": 1 },
+            "workflow_state_masters": { "type": "integer", "minimum": 2 },
+            "workflow_action_masters": { "type": "integer", "minimum": 1 },
+            "terminal_states": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "custom_doctypes_a_confirmer": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "roles_rbac_utilises": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["role_id", "erpnext_role_name"],
+            "properties": {
+              "role_id": { "type": "string", "minLength": 1 },
+              "erpnext_role_name": { "type": "string", "pattern": "^OTO " }
+            }
+          }
+        }
+      }
+    },
+    "workflow": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "doctype",
+        "name",
+        "workflow_name",
+        "document_type",
+        "workflow_state_field",
+        "is_active",
+        "send_email_alert",
+        "override_status",
+        "states",
+        "transitions"
+      ],
+      "properties": {
+        "doctype": { "type": "string", "const": "Workflow" },
+        "name": { "type": "string", "minLength": 1 },
+        "workflow_name": { "type": "string", "minLength": 1 },
+        "document_type": { "type": "string", "minLength": 1 },
+        "workflow_state_field": { "type": "string", "minLength": 1 },
+        "is_active": { "$ref": "#/definitions/flag" },
+        "send_email_alert": { "$ref": "#/definitions/flag" },
+        "override_status": { "$ref": "#/definitions/flag" },
+        "states": {
+          "type": "array",
+          "minItems": 2,
+          "items": { "$ref": "#/definitions/document_state" }
+        },
+        "transitions": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/definitions/transition" }
+        }
+      }
+    },
+    "workflow_state": {
+      "type": "array",
+      "minItems": 2,
+      "items": { "$ref": "#/definitions/state_master" }
+    },
+    "workflow_action_master": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/definitions/action_master" }
+    }
+  },
+  "definitions": {
+    "flag": { "type": "integer", "enum": [0, 1] },
+    "docstatus": { "type": "string", "enum": ["0", "1", "2"] },
+    "style": {
+      "type": "string",
+      "enum": ["", "Primary", "Info", "Success", "Warning", "Danger", "Inverse"]
+    },
+    "document_state": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "state",
+        "doc_status",
+        "allow_edit",
+        "update_field",
+        "update_value",
+        "is_optional_state",
+        "message"
+      ],
+      "properties": {
+        "state": { "type": "string", "minLength": 1 },
+        "doc_status": { "$ref": "#/definitions/docstatus" },
+        "allow_edit": { "type": "string", "pattern": "^OTO " },
+        "update_field": { "type": "string", "minLength": 1 },
+        "update_value": { "type": "string", "minLength": 1 },
+        "is_optional_state": { "$ref": "#/definitions/flag" },
+        "message": { "type": "string", "minLength": 1 }
+      }
+    },
+    "transition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "state",
+        "action",
+        "next_state",
+        "allowed",
+        "allow_self_approval",
+        "condition"
+      ],
+      "properties": {
+        "state": { "type": "string", "minLength": 1 },
+        "action": { "type": "string", "minLength": 1 },
+        "next_state": { "type": "string", "minLength": 1 },
+        "allowed": { "type": "string", "pattern": "^OTO " },
+        "allow_self_approval": { "$ref": "#/definitions/flag" },
+        "condition": { "type": ["string", "null"] }
+      }
+    },
+    "state_master": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["doctype", "name", "workflow_state_name", "style"],
+      "properties": {
+        "doctype": { "type": "string", "const": "Workflow State" },
+        "name": { "type": "string", "minLength": 1 },
+        "workflow_state_name": { "type": "string", "minLength": 1 },
+        "style": { "$ref": "#/definitions/style" }
+      }
+    },
+    "action_master": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["doctype", "name", "workflow_action_name"],
+      "properties": {
+        "doctype": { "type": "string", "const": "Workflow Action Master" },
+        "name": { "type": "string", "minLength": 1 },
+        "workflow_action_name": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

05_deliverables_mvp/crm/workflow_vente/workflow_vente_gen.py

@@ -0,0 +1,246 @@
+#!/usr/bin/env python3
+"""Générateur de fixtures ERPNext Workflow · pipeline vente (Sprint 4 · CRM natif).
+
+Transforme le contrat pipeline `workflow_vente_spec.json` (lead → visite → devis
+→ réservation → contrat → CONFOTUR) en **fixtures Frappe/ERPNext v15 natives** :
+  - workflow.json               → DocType `Workflow` (states[] + transitions[])
+  - workflow_state.json         → DocType maître `Workflow State`
+  - workflow_action_master.json → DocType maître `Workflow Action Master`
+  - MANIFEST.json               → traçabilité + DocType porteur `custom` à confirmer VPS
+
+Les rôles qui gardent les états/transitions sont **résolus depuis le contrat
+RBAC** `rbac_50_roles.json` (réutilisation · zéro duplication · #6) : le pipeline
+ne cite qu'un `id` de rôle, jamais un nom Frappe en dur.
+
+Ce worker n'écrit JAMAIS sur le VPS (contrainte #8) : l'application réelle
+(`bench --site frontend migrate` / `import-fixtures`) reste côté serveur, faite
+par l'agent ERPNext Backend.
+
+Sous-commandes :
+  build    [-o OUT]  → écrit les 4 fichiers de fixtures
+  validate           → (re)génère en mémoire, valide schéma + invariants métier
+                       (graphe, monotonie doc_status, séparation des pouvoirs) ;
+                       sort en erreur si un invariant casse (anti-régression).
+
+Sortie déterministe (tri stable, aucun horodatage) → diffable + re-générable.
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_DELIVERABLES = os.path.normpath(os.path.join(_HERE, "..", ".."))
+
+sys.path.insert(0, _HERE)
+# Réutilisation (workflow #5 : zéro duplication) du validateur maison Publiciste.
+sys.path.insert(0, os.path.join(_DELIVERABLES, "publiciste"))
+
+from wflib import builder, erpnext  # noqa: E402
+from wflib.rbac import RoleResolver  # noqa: E402
+from lib import validator as maison  # type: ignore  # noqa: E402
+
+_SPEC_PATH = os.path.join(_HERE, "workflow_vente_spec.json")
+_SCHEMA_PATH = os.path.join(_HERE, "workflow.schema.json")
+_DEFAULT_OUT = os.path.join(_HERE, "out")
+
+# doc_status atteignable en une transition (monotonie native Frappe) :
+#   0→0 (mise à jour), 0→1 (soumission), 1→1 (mise à jour), 1→2 (annulation).
+_ALLOWED_DOCSTATUS_STEPS = {("0", "0"), ("0", "1"), ("1", "1"), ("1", "2")}
+
+
+def _eprint(*args) -> None:
+    print(*args, file=sys.stderr)
+
+
+def _load(path: str) -> dict:
+    with open(path, encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+def _write_json(path: str, data) -> None:
+    with open(path, "w", encoding="utf-8") as fh:
+        json.dump(data, fh, ensure_ascii=False, indent=2)
+        fh.write("\n")
+
+
+def _build_bundle() -> tuple[dict, dict]:
+    spec = _load(_SPEC_PATH)
+    resolver = RoleResolver.from_path()
+    return spec, builder.build_bundle(spec, resolver)
+
+
+def _validate_bundle(spec: dict, bundle: dict) -> list[str]:
+    """Schéma de sortie + invariants métier du graphe de workflow."""
+    schema = _load(_SCHEMA_PATH)
+    errors = list(maison.validate(bundle, schema))
+
+    wf = bundle["workflow"]
+    states = wf["states"]
+    transitions = wf["transitions"]
+    manifest = bundle["manifest"]
+
+    state_names = [s["state"] for s in states]
+    state_set = set(state_names)
+    docstatus_of = {s["state"]: s["doc_status"] for s in states}
+
+    # Invariant 1 · unicité des noms d'état.
+    if len(state_names) != len(state_set):
+        errors.append("Nom d'état dupliqué dans la table `states`.")
+
+    # Invariant 2 · toute transition référence des états déclarés.
+    for t in transitions:
+        if t["state"] not in state_set:
+            errors.append(f"Transition depuis un état inconnu : {t['state']!r}")
+        if t["next_state"] not in state_set:
+            errors.append(f"Transition vers un état inconnu : {t['next_state']!r}")
+
+    # Invariant 3 · monotonie doc_status (natif Frappe, pas de 0→2 ni décroissant).
+    for t in transitions:
+        pair = (docstatus_of.get(t["state"]), docstatus_of.get(t["next_state"]))
+        if None in pair:
+            continue  # déjà signalé par l'invariant 2
+        if pair not in _ALLOWED_DOCSTATUS_STEPS:
+            errors.append(
+                f"Saut doc_status illégal {pair[0]}→{pair[1]} "
+                f"({t['state']} --{t['action']}--> {t['next_state']})."
+            )
+
+    # Invariant 4 · unicité (état, action) — Frappe exige une action déterministe.
+    keys = [(t["state"], t["action"]) for t in transitions]
+    if len(keys) != len(set(keys)):
+        errors.append("Couple (état, action) dupliqué dans les transitions.")
+
+    # Invariant 5 · atteignabilité depuis l'état initial (première ligne = Lead).
+    initial = state_names[0]
+    adj: dict[str, list[str]] = {}
+    for t in transitions:
+        adj.setdefault(t["state"], []).append(t["next_state"])
+    seen = {initial}
+    stack = [initial]
+    while stack:
+        cur = stack.pop()
+        for nxt in adj.get(cur, []):
+            if nxt not in seen:
+                seen.add(nxt)
+                stack.append(nxt)
+    unreachable = state_set - seen
+    if unreachable:
+        errors.append(
+            f"État(s) inatteignable(s) depuis {initial!r} : {sorted(unreachable)}"
+        )
+
+    # Invariant 6 · au moins un état terminal de succès (soumis, sans sortie) et
+    # les états terminaux annoncés au contrat n'ont effectivement pas de sortie.
+    outgoing = {t["state"] for t in transitions}
+    terminal_success = [
+        s["state"] for s in states
+        if s["doc_status"] == erpnext.DOCSTATUS_SUBMITTED and s["state"] not in outgoing
+    ]
+    if not terminal_success:
+        errors.append("Aucun état terminal de succès (soumis + sans transition sortante).")
+    for st in spec["states"]:
+        if st.get("is_terminal") and st["state"] in outgoing:
+            errors.append(
+                f"État {st['state']!r} déclaré terminal mais porte une transition sortante."
+            )
+
+    # Invariant 7 · séparation des pouvoirs (#6) : toute transition marquée
+    # `separation_of_duties` DOIT interdire l'auto-approbation.
+    sep_actions = {
+        (t["state"], t["action"])
+        for t in spec["transitions"]
+        if t.get("separation_of_duties")
+    }
+    for t in transitions:
+        if (t["state"], t["action"]) in sep_actions and t["allow_self_approval"] != 0:
+            errors.append(
+                f"Séparation des pouvoirs violée : {t['state']} --{t['action']}--> "
+                f"{t['next_state']} autorise l'auto-approbation."
+            )
+
+    # Invariant 8 · les maîtres couvrent exactement les états/actions du graphe.
+    master_states = {m["name"] for m in bundle["workflow_state"]}
+    if master_states != state_set:
+        errors.append("Les maîtres `Workflow State` ne couvrent pas exactement les états.")
+    master_actions = {m["name"] for m in bundle["workflow_action_master"]}
+    if master_actions != {t["action"] for t in transitions}:
+        errors.append("Les maîtres `Workflow Action Master` ne couvrent pas exactement les actions.")
+
+    # Invariant 9 · cohérence des comptes du manifeste.
+    c = manifest["counts"]
+    if c["states"] != len(states) or c["transitions"] != len(transitions):
+        errors.append("counts (états/transitions) incohérents avec le workflow.")
+
+    return errors
+
+
+def cmd_build(args: argparse.Namespace) -> int:
+    spec, bundle = _build_bundle()
+    errors = _validate_bundle(spec, bundle)
+    if errors:
+        _eprint("❌ Bundle invalide — génération refusée (anti-régression) :")
+        for e in errors:
+            _eprint(f"   - {e}")
+        return 1
+
+    out = os.path.abspath(args.out)
+    os.makedirs(out, exist_ok=True)
+    _write_json(os.path.join(out, "workflow.json"), [bundle["workflow"]])
+    _write_json(os.path.join(out, "workflow_state.json"), bundle["workflow_state"])
+    _write_json(
+        os.path.join(out, "workflow_action_master.json"), bundle["workflow_action_master"]
+    )
+    _write_json(os.path.join(out, "MANIFEST.json"), bundle["manifest"])
+
+    m = bundle["manifest"]
+    print(f"✅ Fixtures Workflow générées dans {out}")
+    print(f"   workflow.json               : {m['workflow_name']} · {m['counts']['states']} états / {m['counts']['transitions']} transitions")
+    print(f"   workflow_state.json         : {m['counts']['workflow_state_masters']} maîtres")
+    print(f"   workflow_action_master.json : {m['counts']['workflow_action_masters']} maîtres")
+    if m["custom_doctypes_a_confirmer"]:
+        print(
+            "   ⚠ DocType porteur `custom` à créer + confirmer VPS avant import : "
+            + ", ".join(m["custom_doctypes_a_confirmer"])
+        )
+    return 0
+
+
+def cmd_validate(args: argparse.Namespace) -> int:
+    spec, bundle = _build_bundle()
+    errors = _validate_bundle(spec, bundle)
+    if errors:
+        _eprint("❌ Validation KO :")
+        for e in errors:
+            _eprint(f"   - {e}")
+        return 1
+    m = bundle["manifest"]
+    print(
+        f"✅ Validation OK — {m['counts']['states']} états, "
+        f"{m['counts']['transitions']} transitions, schéma + 9 invariants verts."
+    )
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    p = argparse.ArgumentParser(
+        description="Générateur de fixtures ERPNext Workflow depuis le contrat pipeline vente."
+    )
+    sub = p.add_subparsers(dest="cmd", required=True)
+
+    pb = sub.add_parser("build", help="génère workflow.json / workflow_state.json / workflow_action_master.json / MANIFEST.json")
+    pb.add_argument("-o", "--out", default=_DEFAULT_OUT, help="dossier de sortie (défaut: ./out)")
+    pb.set_defaults(func=cmd_build)
+
+    pv = sub.add_parser("validate", help="valide le bundle (schéma + invariants) sans écrire")
+    pv.set_defaults(func=cmd_validate)
+
+    args = p.parse_args(argv)
+    return args.func(args)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

05_deliverables_mvp/crm/workflow_vente/workflow_vente_spec.json

@@ -0,0 +1,178 @@
+{
+  "version": "1.0.0",
+  "workflow_name": "OTO Vente Pipeline",
+  "document_type": "OTO Dossier Vente",
+  "document_type_custom": true,
+  "workflow_state_field": "workflow_state",
+  "is_active": 1,
+  "send_email_alert": 0,
+  "override_status": 0,
+  "_comment": "Pipeline commercial OTO (roadmap Sprint 4 · CRM natif ERPNext) : lead -> visite -> devis -> reservation -> contrat -> CONFOTUR. Les roles (`allow_edit`/`allowed`) referencent l'`id` d'un role du contrat rbac_50_roles.json (reutilisation, zero duplication · #6) ; le builder resout id -> erpnext_role_name. doc_status : 0=Brouillon, 1=Soumis, 2=Annule (monotone le long des transitions, natif Frappe).",
+  "states": [
+    {
+      "state": "Lead",
+      "doc_status": "0",
+      "role_id": "ventes-conseiller",
+      "style": "Primary",
+      "update_value": "lead",
+      "is_terminal": false,
+      "message": "Nouveau prospect qualifie a contacter."
+    },
+    {
+      "state": "Visite planifiée",
+      "doc_status": "0",
+      "role_id": "ventes-conseiller",
+      "style": "Info",
+      "update_value": "visite",
+      "is_terminal": false,
+      "message": "Visite du site ou de l'unite temoin programmee."
+    },
+    {
+      "state": "Devis émis",
+      "doc_status": "0",
+      "role_id": "ventes-conseiller",
+      "style": "Warning",
+      "update_value": "devis",
+      "is_terminal": false,
+      "message": "Devis chiffre remis au prospect (attente decision)."
+    },
+    {
+      "state": "Réservation confirmée",
+      "doc_status": "1",
+      "role_id": "ventes-reservations",
+      "style": "Primary",
+      "update_value": "reservation",
+      "is_terminal": false,
+      "message": "Depot de reservation encaisse ; dossier verrouille (soumis)."
+    },
+    {
+      "state": "Contrat signé",
+      "doc_status": "1",
+      "role_id": "ventes-contrats",
+      "style": "Success",
+      "update_value": "contrat",
+      "is_terminal": false,
+      "message": "Contrat de vente signe par les deux parties."
+    },
+    {
+      "state": "CONFOTUR déposé",
+      "doc_status": "1",
+      "role_id": "ventes-confotur",
+      "style": "Info",
+      "update_value": "confotur_depose",
+      "is_terminal": false,
+      "message": "Dossier d'incitation CONFOTUR depose aupres de l'autorite."
+    },
+    {
+      "state": "CONFOTUR approuvé",
+      "doc_status": "1",
+      "role_id": "ventes-confotur",
+      "style": "Success",
+      "update_value": "confotur_approuve",
+      "is_terminal": true,
+      "message": "Incitation CONFOTUR approuvee ; cycle de vente clos avec succes."
+    },
+    {
+      "state": "Abandonné",
+      "doc_status": "0",
+      "role_id": "ventes-chef-equipe",
+      "style": "Danger",
+      "update_value": "abandonne",
+      "is_terminal": true,
+      "message": "Piste abandonnee avant reservation (brouillon)."
+    },
+    {
+      "state": "Perdu",
+      "doc_status": "2",
+      "role_id": "ventes-directeur",
+      "style": "Danger",
+      "update_value": "perdu",
+      "is_terminal": true,
+      "message": "Affaire soumise resiliee/annulee (dossier annule)."
+    }
+  ],
+  "transitions": [
+    {
+      "state": "Lead",
+      "action": "Planifier visite",
+      "next_state": "Visite planifiée",
+      "role_id": "ventes-conseiller",
+      "allow_self_approval": 1
+    },
+    {
+      "state": "Lead",
+      "action": "Abandonner",
+      "next_state": "Abandonné",
+      "role_id": "ventes-conseiller",
+      "allow_self_approval": 1
+    },
+    {
+      "state": "Visite planifiée",
+      "action": "Émettre devis",
+      "next_state": "Devis émis",
+      "role_id": "ventes-conseiller",
+      "allow_self_approval": 1
+    },
+    {
+      "state": "Visite planifiée",
+      "action": "Abandonner",
+      "next_state": "Abandonné",
+      "role_id": "ventes-conseiller",
+      "allow_self_approval": 1
+    },
+    {
+      "state": "Devis émis",
+      "action": "Abandonner",
+      "next_state": "Abandonné",
+      "role_id": "ventes-chef-equipe",
+      "allow_self_approval": 1
+    },
+    {
+      "state": "Devis émis",
+      "action": "Confirmer réservation",
+      "next_state": "Réservation confirmée",
+      "role_id": "ventes-reservations",
+      "allow_self_approval": 0,
+      "separation_of_duties": true
+    },
+    {
+      "state": "Réservation confirmée",
+      "action": "Signer contrat",
+      "next_state": "Contrat signé",
+      "role_id": "ventes-contrats",
+      "allow_self_approval": 0,
+      "separation_of_duties": true
+    },
+    {
+      "state": "Réservation confirmée",
+      "action": "Annuler (perdu)",
+      "next_state": "Perdu",
+      "role_id": "ventes-directeur",
+      "allow_self_approval": 0,
+      "separation_of_duties": true
+    },
+    {
+      "state": "Contrat signé",
+      "action": "Déposer CONFOTUR",
+      "next_state": "CONFOTUR déposé",
+      "role_id": "ventes-confotur",
+      "allow_self_approval": 1
+    },
+    {
+      "state": "Contrat signé",
+      "action": "Résilier (perdu)",
+      "next_state": "Perdu",
+      "role_id": "direction-cco",
+      "allow_self_approval": 0,
+      "separation_of_duties": true
+    },
+    {
+      "state": "CONFOTUR déposé",
+      "action": "Approuver CONFOTUR",
+      "next_state": "CONFOTUR approuvé",
+      "role_id": "ventes-confotur",
+      "allow_self_approval": 0,
+      "separation_of_duties": true
+    }
+  ]
+}

05_deliverables_mvp/daily_reports/2026-07-29.md

@@ -28,3 +28,39 @@
 ## Prochaine tâche suggérée
 - Faisabilité : figer template canonique v1.0 (débloque P02/P03/P05/P07 + Publiciste).
 - Ou : scaffold doc `otoia/capabilities/publiciste.py` (seul module net-neuf, chemin critique).
+
+---
+
+# Session `20260729_235619` (suite)
+
+## Tâche exécutée
+**Sprint 1 · Livrable Faisabilité « Template canonique v1.0 »** (AGENT.md Faisabilité §Livrable S1 ·
+GAP_ANALYSIS §7) — était le critère de sortie Sprint 1 restant le plus prioritaire dans le périmètre repo,
+et déjà signalé comme prochaine tâche par la session précédente.
+
+## Contexte / analyse
+- Relu roadmap + GAP_ANALYSIS_SPRINT1.md §7 (Definition of Done) : template v1.0 = ☐ à faire.
+- Marqué **GAP ACTIF PRIORITAIRE** (risque transverse #1 : bloque Publiciste + démo banquier).
+- Confronté les besoins d'extraction du **Publiciste Agent** (AGENT.md) pour aligner le contrat de données.
+
+## Réalisé
+- Créé `05_deliverables_mvp/faisabilite/TEMPLATE_FAISABILITE_CANONIQUE_v1.0.md` :
+  - Arborescence canonique obligatoire `data_room/PXX/`.
+  - 4 volets avec champs obligatoires 🔴 / recommandés 🟡 + placeholders `{{…}}` (zéro chiffre inventé, #6).
+  - **Bloc anti-gap §3.2** : tableau typologies + prix « à partir de » USD/DOP obligatoire (cause racine P02/P03/P05/P07).
+  - Paramètres financiers canoniques CLAUDE.md : 3 % édition · 8.5 % marketing · 52 % point équilibre · USD+DOP · Cardnet · Letter US.
+  - Checklist conformité 4Big ≥ 95/100 (§7) + cycle de vie SemVer + versioning (§8).
+- Créé `faisabilite/version.schema.json` : schéma JSON de `_META/version.json` (SemVer, score, statut, verrou complete≥95).
+- Créé `faisabilite/projets_master.schema.json` : contrat d'extraction consommé par le Publiciste (statut, typologies, prix, inclus, rendus, traçabilité source).
+- Validé les 2 schémas (JSON bien formé).
+- Mis à jour GAP_ANALYSIS §7 : critère « Template faisabilité canonique v1.0 » → ✅.
+
+## Non fait (hors périmètre worker)
+- Installation du template sur VPS (`otoia/capabilities/knowledge/`) → DevOps/Faisabilité.
+- Régénération batch des 7 faisabilités selon le template (Sprint 4).
+- Validation QA finale du score 4Big contre données réelles `data_room/` (VPS).
+
+## Prochaine tâche suggérée
+- Faisabilité S2 : scaffold doc du générateur 4 volets automatique consommant ce template.
+- Ou DevOps S1 : fichiers `.gitea/workflows/` CI/CD (authorables en repo sans toucher VPS).
+- Ou QA S1 : fichiers de test Playwright baseline (`/crm`, `/waf-home`, `/qa`, `/choisir-mon-unite`).

05_deliverables_mvp/daily_reports/2026-07-30-session10.md

@@ -0,0 +1,94 @@
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 10)
+
+**Session** : `20260730_045701`
+
+## Tâche exécutée
+**Sprint 3 · Faisabilité — Générateur de dossier financier bancable trilingue
+FR/EN/ES** (roadmap `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` §Sprint 3 :
+« `40_llm_outputs/` + rapports bancables FR/EN/ES » · **prochaine tâche suggérée**
+par le daily report session 9 : « Faisabilité S3 »).
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, `PORTAIL_BANCABLES_4BIG.md`,
+  daily report session 9, le générateur Faisabilité 4 volets (`renderer.py`,
+  `model.py`, `scorer.py`, `faisabilite_gen.py`, `brief.schema.json`), le
+  validateur maison Publiciste, le patron CI.
+- État : volet RBAC **clos** en-repo (4 générateurs + run-book). Faisabilité S2
+  produit `data_room/PXX/` (4 volets + score 4Big) mais laissait le répertoire
+  **`50_financier_bancable/` VIDE** (`.gitkeep`).
+- **Priorité évidente** : le **Portail Bancables 4Big** (variante 06 retenue par
+  Michel, `PORTAIL_BANCABLES_4BIG.md`) exige à l'**étape 1** de son workflow des
+  dossiers bancables **FR/EN/ES** placés précisément dans `50_financier_bancable/`.
+  Ce répertoire était le dernier trou de la faisabilité auto. 100 % autorable
+  sans VPS/pip/API, même brief que le générateur 4 volets, même patron modulaire.
+
+## Réalisé — module `05_deliverables_mvp/faisabilite/bancable/`
+- `banclib/deps.py` — réutilise (workflow #5, zéro duplication) `is_filled` +
+  `CANONICAL` du générateur et le **validateur maison** Publiciste (zéro pip).
+- `banclib/i18n.py` — dictionnaire de libellés **FR/EN/ES fixes** (traductions de
+  gabarit, jamais du brief) + drapeaux du portail (🇨🇦/🇺🇸/🇩🇴).
+- `banclib/finance.py` — **deux tiers anti-invention (#6)** :
+  - **sourcé** (verbatim) : coût construction, revenu brut, marge, taux, prix par
+    typologie — champ absent ⇒ `None` (jamais 0 fabriqué) ;
+  - **calculé** (traçable) : Σ unités · valeur catalogue USD/DOP (`Σ quantité ×
+    prix`) · point d'équilibre en unités (`⌈52 % × nb_unités⌉`) — **formule
+    publiée**, opérandes tous sourcés/canoniques, `None` si un opérande manque.
+  - Les taux « 3 % édition » / « 8.5 % marketing » sont rendus **verbatim**
+    (jamais multipliés par une base supposée — base non documentée = hypothèse
+    inventée, refusée).
+- `banclib/report.py` — rendu Markdown par langue (bannière **CONFIDENTIEL**
+  systématique ; bannière synthétique + `publiable:false` si fixture) + manifeste
+  agrégé machine-lisible.
+- `bancable_gen.py` — CLI `build` / `validate`. **Refuse d'écrire** si un
+  invariant casse : conformité schéma, 3 langues rendues, bannière CONFIDENTIEL,
+  **recalcul indépendant des 4 agrégats == manifeste** (anti-figure-posée),
+  synthétique ⇒ non publiable, aucun littéral `None` dans le rendu.
+- `bancable.schema.json` — contrat de sortie draft-07 (sous-ensemble validateur
+  maison · valeurs numériques nullable `["number","null"]`).
+- `tests/test_bancable.py` — **22 tests `unittest` (stdlib pur)** : finance
+  (sourcé verbatim, arithmétique tracée, `None`≠0), rendu trilingue, positionnement
+  par langue + placeholder si absent, paramètres canoniques, schéma (maison +
+  oracle `jsonschema`), invariants CLI (détection de figure falsifiée), écriture
+  réelle, déterminisme.
+- **CI** : job `bancable-tests` ajouté au **gate** (`.gitea/workflows/ci.yml`,
+  Gitea Actions uniquement · #2).
+- **Docs cousues** : `PORTAIL_BANCABLES_4BIG.md` (nouvelle étape 0 → générateur) ;
+  `brief.schema.json` du générateur étendu (`positionnement_en/es`) → contrat
+  d'entrée aligné entre les deux modules.
+
+## Anti-invention (#6) appliqué
+- Figures sourcées **reprises telles quelles** ; aucune valeur inventée ni 0
+  fabriqué (champ absent ⇒ placeholder `{{…}}`).
+- Agrégats calculés **auditables** : formule + opérandes publiés, **recoupés
+  indépendamment** par le CLI (rejette toute figure falsifiée · test dédié).
+- Aucun montant sur base non documentée (3 %/8.5 % rendus comme taux, pas comme $).
+- Positionnement **jamais traduit automatiquement** : langue absente ⇒ placeholder.
+
+## Vérifications effectuées (en-repo, sans toucher au VPS)
+- **22/22 tests verts** (schéma maison + oracle `jsonschema`). Génération réelle
+  (fixture synthétique) : 3 langues + manifeste · 40 unités · valeur catalogue
+  USD 8,560,000 / DOP 505,040,000 · point d'équilibre **21 unités** (⌈52 % × 40⌉)
+  — toutes formules recoupées ; `publiable=false` (synthétique).
+- **Gate CI local vert (exit 0)** : `guard_constraints.sh`, `validate_json.sh`
+  (schéma + fixture bancable), `check_docs.sh` (README score présent, 0 lien
+  cassé), YAML `ci.yml` valide.
+- **Régression** : 23 Publiciste + 10 RBAC + 16 Faisabilité + 11 fixtures + 12
+  userperm + 11 roleprofile + 16 apply_plan + 22 bancable = **121 tests verts**.
+
+## Non fait (hors périmètre worker · VPS)
+- Conversion PDF (pandoc/wkhtmltopdf) des `.md` FR/EN/ES + rebuild du Portail
+  Bancables 4Big → agent DevOps/Frontend (contrainte #8).
+
+## Prochaine tâche suggérée
+- Faisabilité S3 restant : refactor `oto_agent_faisabilite.py` → batch <1h côté
+  VPS (hors périmètre worker) ; ou packaging du hand-off ERPNext (`fixtures/` de
+  l'app OTO à partir des sorties RBAC + faisabilité).
+- Frontend/CRM S2 : dépend des layouts LIVE (VPS) → hors périmètre worker.
+
+---
+
+**Auto-score 4Big du livrable Générateur bancable trilingue : 96/100.**
+Réserve −4 : la conversion PDF + le rebuild du portail restent côté VPS (agent
+DevOps/Frontend, hors périmètre worker · #8). Validé statiquement en-repo (22
+tests verts + manifeste conforme + recoupement arithmétique des agrégats + gate
+CI vert · 121 tests de régression au total).

05_deliverables_mvp/daily_reports/2026-07-30-session11.md

@@ -0,0 +1,95 @@
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 11)
+
+**Session** : `20260730_052701`
+
+## Tâche exécutée
+**Sprint 4 · CRM — Générateur de workflow vente ERPNext** (roadmap
+`04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` §Sprint 4 : « workflow complet **lead →
+visite → devis → réservation → contrat → CONFOTUR** »). Prochaine tâche
+prioritaire **in-scope worker** après la clôture de la Faisabilité S3 (bancable,
+session 10) : premier livrable Sprint 4 100 % autorable sans VPS.
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, daily report session 10,
+  l'AGENT.md CRM, le contrat `rbac_50_roles.json` (rôles portails
+  ventes/direction/compta) et l'idiome des générateurs RBAC (`fixtures_gen` :
+  `frappe.py`/`builder.py`/`schema`/CLI `build|validate`/tests + job CI + gate).
+- État : RBAC **clos** (4 générateurs + run-book), Faisabilité **close**
+  (4 volets + bancable trilingue). Sprint 4 non entamé en-repo. Le deliverable
+  CRM « workflow lead→CONFOTUR » est **structurel** (états + rôles), donc sans
+  aucun chiffre à inventer (#6) et sans dépendance VPS → cible idéale.
+- Contrainte #3 (CRM = ERPNext natif) : on produit les DocTypes **natifs du
+  moteur Workflow de Frappe**, jamais un moteur externe.
+
+## Réalisé — module `05_deliverables_mvp/crm/workflow_vente/`
+- `workflow_vente_spec.json` — contrat pipeline canonique : **9 états**
+  (Lead → Visite planifiée → Devis émis → Réservation confirmée → Contrat signé →
+  CONFOTUR déposé → CONFOTUR approuvé + Abandonné/Perdu terminaux) · **11
+  transitions**. Chaque état/transition référence un **`id` de rôle RBAC**
+  (jamais un nom Frappe en dur).
+- `wflib/rbac.py` — **réutilisation (workflow #5, zéro duplication)** de
+  `rbac_50_roles.json` : résout `role_id → erpnext_role_name`. `id` absent ⇒
+  erreur (aucun rôle inventé · #6) ; renommage RBAC propagé automatiquement.
+- `wflib/erpnext.py` — connaissance Frappe v15 native : DocTypes `Workflow`,
+  `Workflow Document State`, `Workflow Transition`, `Workflow State`,
+  `Workflow Action Master` ; `doc_status` (0/1/2) + styles de badge natifs.
+- `wflib/builder.py` — assemblage **déterministe** (tri stable, aucun
+  horodatage) : table `states[]`, table `transitions[]` (triées état→action),
+  maîtres États/Actions uniques, manifeste de traçabilité (rôles RBAC utilisés +
+  DocType porteur `custom` à confirmer VPS).
+- `workflow.schema.json` — contrat de sortie draft-07 (sous-ensemble validateur
+  maison Publiciste).
+- `workflow_vente_gen.py` — CLI `build` / `validate`. **Refuse d'écrire** si un
+  des **9 invariants de graphe** casse.
+- `out/` (commité, hand-off direct) : `workflow.json`, `workflow_state.json`,
+  `workflow_action_master.json`, `MANIFEST.json`.
+- `tests/test_workflow_vente.py` — **25 tests `unittest` (stdlib pur)**.
+- **CI** : job `crm-workflow-vente-tests` ajouté au **gate**
+  (`.gitea/workflows/ci.yml`, Gitea Actions uniquement · #2).
+
+## 9 invariants de graphe (le CLI refuse d'écrire si l'un casse)
+1. Conformité au schéma de sortie. 2. Unicité des noms d'état. 3. Transitions
+vers/depuis états déclarés. 4. **Monotonie `doc_status`** (pas de saut 0→2 ni
+retour arrière — natif Frappe). 5. Unicité (état, action). 6. **Atteignabilité**
+de tous les états depuis `Lead`. 7. ≥1 état terminal de succès (soumis, sans
+sortie) + terminaux sans transition sortante. 8. **Séparation des pouvoirs** :
+confirmer réservation / signer contrat / approuver CONFOTUR / annuler = pas
+d'auto-approbation. 9. Maîtres États/Actions == graphe + comptes manifeste
+cohérents.
+
+## Anti-invention (#6) + séparation des pouvoirs appliqués
+- Aucun nom de rôle en dur : tous résolus depuis le contrat RBAC (source unique).
+- Aucun chiffre inventé (workflow purement structurel) ; `condition` de
+  transition laissée `null` (le métier ne documente pas de seuil chiffré).
+- Étapes engageant de l'argent / clôturant ⇒ `allow_self_approval = 0`
+  (quatre-yeux), vérifié par test + CLI.
+
+## Vérifications effectuées (en-repo, sans toucher au VPS)
+- **25/25 tests verts** (schéma maison + oracle `jsonschema`) ; génération réelle :
+  9 états / 11 transitions / 9 maîtres États / 9 maîtres Actions ; `out/` commité
+  == régénération bit-à-bit.
+- **Gate CI local vert (exit 0)** : `guard_constraints.sh`, `validate_json.sh`
+  (nouveaux JSON valides), `check_docs.sh` (README score présent, 0 lien cassé),
+  YAML `ci.yml` valide.
+- **Régression** : 23 Publiciste + 10 RBAC + 16 Faisabilité + 11 fixtures + 12
+  userperm + 11 roleprofile + 16 apply_plan + 22 bancable + 25 workflow vente =
+  **146 tests verts** au total.
+
+## Non fait (hors périmètre worker · VPS)
+- Création du DocType porteur `OTO Dossier Vente` + import des fixtures
+  (`bench migrate`) → agent ERPNext Backend (contrainte #8).
+
+## Prochaine tâche suggérée
+- Sprint 4 CRM : générateur des **Notification/Email Alert** par transition, ou
+  du **DocType porteur `OTO Dossier Vente`** (fixture DocType) pour compléter le
+  hand-off workflow.
+- Sprint 4 ERPNext Backend : plan e-CF DGII (Compupar) + barème commissions
+  vendeurs (calcul traçable façon module `finance.py` du bancable · #6).
+
+---
+
+**Auto-score 4Big du livrable Générateur workflow vente : 96/100.**
+Réserve −4 : création du DocType porteur + import des fixtures = côté VPS (agent
+ERPNext Backend, hors périmètre worker · #8) ; `condition` de transition non
+peuplée (anti-invention #6). Validé statiquement en-repo (25 tests verts + schéma
+conforme + 9 invariants de graphe + gate CI · 146 tests de régression au total).

05_deliverables_mvp/daily_reports/2026-07-30-session12.md

@@ -0,0 +1,80 @@
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 12)
+
+**Session** : `20260730_055704`
+
+## Tâche exécutée
+**Sprint 4 · CRM — Générateur du DocType porteur `OTO Dossier Vente`.** Complète
+le hand-off du générateur workflow vente (session 11) : le Workflow `OTO Vente
+Pipeline` cible un `document_type` **custom** qui doit exister AVANT son import.
+Ce module produit ce DocType porteur en-repo (fixture Frappe custom),
+**cross-cohérent** avec le contrat pipeline. C'est exactement la « prochaine
+tâche suggérée » de la session 11 (DocType porteur `OTO Dossier Vente`).
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, daily report session 11, et
+  l'idiome des générateurs CRM/RBAC (`wflib`, `fixtures_gen` : `frappe.py` +
+  `builder.py` + schéma + CLI `build|validate` + tests + job CI + gate).
+- Le workflow vente (session 11) référence `document_type: "OTO Dossier Vente"`
+  marqué `document_type_custom: true` + `custom_doctypes_a_confirmer` → il
+  manquait le DocType porteur. Livrable 100 % autorable sans VPS (structure
+  seule, zéro chiffre · #6).
+
+## Réalisé — module `05_deliverables_mvp/crm/dossier_vente/`
+- `doctype_spec.json` — structure métier (libellés + types de champ) : Prospect/
+  Client (`Link`), Projet (`Select` **P01..P09** ancré CLAUDE.md), Financier
+  (`Currency` **sans défaut** · devise USD/DOP · #10), jalons de dates, CONFOTUR,
+  clôture. Les champs de pilotage workflow n'y figurent PAS (injectés).
+- `dvlib/frappe.py` — connaissance Frappe v15 native : types de champ légitimes,
+  modèle de permission (DocPerm intégré), champ `naming_series`, enveloppe
+  `DocType` custom.
+- `dvlib/builder.py` — assemblage **déterministe** + **cross-cohérence** :
+  dérive du workflow le nom du DocType, le champ d'état, les valeurs de statut,
+  `is_submittable` et les permissions. Réutilise (`#5`) le `_UPDATE_FIELD` et le
+  `RoleResolver` du module `workflow_vente` (zéro duplication).
+- `doctype.schema.json` — contrat de sortie draft-07 (validateur maison
+  Publiciste, zéro pip).
+- `doctype_dossier_vente_gen.py` — CLI `build`/`validate`. **Refuse d'écrire** si
+  un des **12 invariants** de cross-cohérence casse.
+- `out/` (commité, hand-off direct) : `doctype_oto_dossier_vente.json`,
+  `MANIFEST.json`.
+- `tests/test_dossier_vente.py` — **31 tests `unittest` (stdlib pur)**.
+- **CI** : job `crm-dossier-vente-tests` ajouté au **gate** (`.gitea/workflows/ci.yml`).
+
+## Cross-cohérence workflow ↔ DocType (le cœur du livrable)
+Le DocType n'est pas rédigé indépendamment ; il **dérive** du contrat
+`workflow_vente_spec.json` (source unique · anti-dérive) :
+- Nom == `document_type` du workflow ; `custom` == `document_type_custom`.
+- Champ `workflow_state` (Select `read_only`) : options == les 9 états, ordonnés.
+- Champ `statut_pipeline` : options == les `update_value` ; nom **importé** de
+  `workflow_vente/wflib/builder.py::_UPDATE_FIELD` (renommage propagé).
+- `is_submittable` **déduit** des `doc_status` (1/2 ⇒ soumissible).
+- Permissions **déduites** des rôles du workflow (édition ⇒ write/+create si
+  brouillon ; transition→soumis ⇒ submit ; →annulé ⇒ cancel/amend). Noms de rôle
+  résolus depuis `rbac_50_roles.json` (jamais en dur · #6).
+
+## Vérifications effectuées (en-repo, sans toucher au VPS)
+- **31/31 tests verts** (validateur maison + oracle `jsonschema`) ; génération :
+  30 champs (23 porteurs de donnée) · 7 sections · 7 rôles · submittable=1 ;
+  `out/` commité == régénération bit-à-bit.
+- **Gate CI local vert (exit 0)** : `guard_constraints.sh`, `validate_json.sh`,
+  `check_docs.sh` (score présent, 0 lien cassé), YAML `ci.yml` valide.
+- **Régression** : 23 Publiciste + 10 RBAC + 16 Faisabilité + 11 fixtures + 12
+  userperm + 11 roleprofile + 16 apply_plan + 22 bancable + 25 workflow vente +
+  31 dossier vente = **177 tests verts** au total.
+
+## Non fait (hors périmètre worker · VPS · #8)
+- Création du **module** `OTO Ventes` + import réel (`bench migrate`) du DocType,
+  puis du Workflow qui le cible → agent ERPNext Backend.
+
+## Prochaine tâche suggérée
+- Sprint 4 CRM : générateur des **Notification/Email Alert** par transition du
+  pipeline (relances lead, alerte réservation, dépôt CONFOTUR).
+- Sprint 4 ERPNext Backend : barème **commissions vendeurs** (calcul traçable
+  façon module `finance.py` du bancable · #6) + plan e-CF DGII (Compupar).
+
+---
+
+**Auto-score 4Big du livrable DocType porteur : 96/100.** Réserve −4 : création
+du module + import réel = côté VPS (agent ERPNext Backend, hors périmètre worker
+· #8). Validé statiquement en-repo (31 tests verts + schéma conforme + 12
+invariants de cross-cohérence + gate CI · 177 tests de régression au total).

05_deliverables_mvp/daily_reports/2026-07-30-session13.md

@@ -0,0 +1,78 @@
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 13)
+
+**Session** : `20260730_062706`
+
+## Tâche exécutée
+**Sprint 4 · ERPNext Backend — Générateur du barème de commissions vendeurs**
+(roadmap ligne 51 : _« commissions vendeurs auto »_). C'est la « prochaine tâche
+suggérée » de la session 12. Le module produit un **plan de commissions**
+cross-cohérent avec les trois contrats CRM déjà livrés (pipeline vente + DocType
+porteur + RBAC) et un **calculateur traçable** `commission = base × taux`.
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, les daily reports sessions 11-12
+  et l'idiome des générateurs (`wflib`/`dvlib`/`banclib` : `deps.py` réutilisé +
+  `builder.py` + schéma draft-07 + CLI `build|validate` + tests + job CI + gate).
+- **Constat anti-invention (#6)** : aucun taux de commission n'est documenté
+  (`CANONICAL` = 3 % / 8.5 % / 52 %, aucune commission). Fixer un taux serait une
+  invention → le barème livré porte `taux_pct: null` partout, avec un invariant
+  qui **refuse** tout taux fourni sans `source`.
+
+## Réalisé — module `05_deliverables_mvp/crm/commissions/`
+- `bareme_spec.json` — contrat **structurel** : 5 évènements (réservation,
+  contrat ×3 rôles, CONFOTUR approuvé) référençant chacun un `update_value` du
+  workflow, un `base_field` Currency du Dossier Vente, un `role_id` RBAC ventes.
+  Tous les `taux_pct` à `null` (`a_confirmer: true`).
+- `commlib/deps.py` — réutilise (`#5`) `is_filled` / `CANONICAL` / `validate`
+  (import `sys.path`, zéro duplication, zéro pip).
+- `commlib/finance.py` — calcul **traçable** `commission = base × taux` façon
+  `banclib/finance.py` : formule publiée, `None` si opérande manque (jamais
+  0-inventé), parseur de taux (`2.5` ou `« 2.5 % »`).
+- `commlib/builder.py` — assemblage **déterministe** ; réutilise le `RoleResolver`
+  du module `workflow_vente` (résolution `role_id → erpnext_role_name`).
+- `bareme.schema.json` — contrat de sortie draft-07.
+- `commissions_gen.py` — CLI `build`/`validate`. **Refuse d'écrire** si un des
+  **10 invariants** de cross-cohérence casse.
+- `fixtures/dossier_exemple.json` — fixture **de test uniquement** (chiffres
+  fictifs + `source` explicite « non contractuel ») pour exercer le calcul.
+- `out/` (commité, hand-off direct) : `commission_plan.json`, `MANIFEST.json`.
+- `tests/test_commissions.py` — **25 tests `unittest` (stdlib pur)**.
+- **CI** : job `crm-commissions-tests` ajouté au **gate** (`.gitea/workflows/ci.yml`).
+
+## Cross-cohérence barème ↔ workflow ↔ DocType ↔ RBAC (le cœur du livrable)
+Les 10 invariants dérivent le barème des contrats voisins (anti-dérive) :
+- `update_value` ∈ workflow **et** état **soumis** (`doc_status = 1`) : jamais de
+  commission sur un brouillon (lead/visite/devis/abandonné).
+- `base_field` = champ **Currency réel** du DocType Dossier Vente.
+- `role_id` résolu depuis `rbac_50_roles.json` **et** portail `ventes`.
+- `devise_field` = champ `devise` (Select USD/DOP · #10).
+- **Anti-invention (#6)** : aucun `taux_pct` sans `source` (le barème livré étant
+  tout `null`, `taux_a_confirmer = 5/5`).
+
+## Vérifications effectuées (en-repo, sans toucher au VPS)
+- **25/25 tests verts** (validateur maison + oracle `jsonschema`) ; génération :
+  5 évènements · 4 rôles · 5 taux à confirmer ; `out/` commité == régénération
+  bit-à-bit.
+- **Gate CI local vert (exit 0)** : `guard_constraints.sh`, `validate_json.sh`,
+  `check_docs.sh` (score présent, 0 lien cassé), YAML `ci.yml` valide.
+- **Régression** : 23 Publiciste + 10 RBAC + 16 Faisabilité + 11 fixtures + 12
+  userperm + 11 roleprofile + 16 apply_plan + 22 bancable + 25 workflow + 31
+  dossier + 25 commissions = **202 tests verts** au total.
+
+## Non fait (hors périmètre worker · VPS · #8)
+- Confirmation des `taux_pct` réels + `source` par la Direction.
+- Câblage du calcul de commission sur les transitions du Workflow (champ/table
+  enfant ou DocType commission dédié) → agent ERPNext Backend.
+
+## Prochaine tâche suggérée
+- Sprint 4 ERPNext Backend : **plan e-CF DGII (Compupar)** — structure de la
+  facturation électronique fiscale (hand-off, zéro chiffre).
+- Sprint 4 Frontend Console : squelette des **5 portails rôle**
+  (Ventes/Construction/Achat/Compta/Direction) façon clone `/waf-home`.
+
+---
+
+**Auto-score 4Big du barème commissions : 96/100.** Réserve −4 : confirmation des
+taux réels + câblage du calcul en production = côté VPS (agent ERPNext Backend ·
+#8). Validé statiquement en-repo (25 tests verts + schéma conforme + 10
+invariants de cross-cohérence + gate CI · 202 tests de régression au total).

05_deliverables_mvp/daily_reports/2026-07-30-session14.md

@@ -0,0 +1,94 @@
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 14)
+
+**Session** : `20260730_065711`
+
+## Tâche exécutée
+**Sprint 4 · ERPNext Backend — Générateur de configuration e-CF DGII (Compupar)**
+(roadmap ligne 51 : _« e-CF DGII intégration (Compupar) »_). C'est exactement la
+« prochaine tâche suggérée » de la session 13. Le module produit un **plan de
+configuration** de la facturation électronique dominicaine, cross-cohérent avec
+les trois contrats CRM déjà livrés (pipeline vente + DocType porteur + RBAC), et
+un **composeur d'e-NCF traçable** `E + tipoeCF(2) + secuencia(10)`.
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, les daily reports sessions 11-13
+  et l'idiome des générateurs (`wflib`/`dvlib`/`commlib` : `deps.py` réutilisé +
+  `builder.py` + schéma draft-07 + CLI `build|validate` + tests + job CI + gate).
+- Ligne 51 = _« e-CF DGII intégration (Compupar) **+** commissions vendeurs
+  auto »_ ; les commissions ont été livrées session 13, l'e-CF restait ouvert
+  (`GAP_ANALYSIS_SPRINT1.md` §Backend : _« e-CF DGII (Compupar) non intégré »_).
+- **RBAC** : rôle dédié déjà présent — `compta-fiscaliste-ecf` (_OTO Compta
+  Fiscaliste eCF_, portail `compta`) → aucun rôle inventé.
+- **Constat anti-invention (#6)** : aucun chiffre fiscal OTO n'est documenté (RNC
+  émetteur, taux ITBIS, TipoCambio). Les fixer serait une invention → tous `null`
+  (`a_confirmer`), avec un invariant qui **refuse** toute valeur fixée sans
+  `source`. Seules les **données de référence DGII** (codes de type e-CF, table
+  FormaPago, format e-NCF) sont encodées — identifiants normalisés du standard,
+  chacune avec sa `source`.
+
+## Réalisé — module `05_deliverables_mvp/fiscal/ecf_dgii/`
+- `ecf_spec.json` — contrat **structurel** : catalogue des 10 types e-CF DGII
+  (5 `en_scope` : 31/32/33/34/46), table FormaPago (défaut **3 = Tarjeta** car
+  encaissements via **Cardnet** · #10), format e-NCF, moneda USD/DOP, ITBIS et
+  RNC `null`, provider Compupar (endpoints/credentials `null` → VPS #8), 2
+  évènements d'émission (réservation, contrat) et `field_map` Dossier Vente → e-CF.
+- `ecflib/deps.py` — réutilise (`#5`) `is_filled` / `CANONICAL` / `validate`
+  (import `sys.path`, zéro duplication, zéro pip).
+- `ecflib/ncf.py` — composeur **traçable** de l'e-NCF façon `finance.py` : formule
+  publiée, `None` si opérande manque (jamais fabriqué), `parse`/`is_valid` qui
+  rejettent le NCF physique (`B01…`).
+- `ecflib/builder.py` — assemblage **déterministe** ; réutilise le `RoleResolver`
+  du module `workflow_vente` (`role_id → erpnext_role_name`).
+- `ecf.schema.json` — contrat de sortie draft-07.
+- `ecf_dgii_gen.py` — CLI `build`/`validate`. **Refuse d'écrire** si un des **12
+  invariants** de cross-cohérence casse.
+- `fixtures/dossier_exemple.json` — fixture **de test uniquement** (opérandes
+  fictifs + `source` « non contractuel »).
+- `out/` (commité, hand-off direct) : `ecf_plan.json`, `MANIFEST.json`.
+- `tests/test_ecf_dgii.py` — **39 tests `unittest` (stdlib pur)**.
+- **CI** : job `fiscal-ecf-tests` ajouté au **gate** (`.gitea/workflows/ci.yml`).
+
+## Cross-cohérence e-CF ↔ workflow ↔ DocType ↔ RBAC (le cœur du livrable)
+Les 12 invariants dérivent l'e-CF des contrats voisins (anti-dérive) :
+- `update_value` ∈ workflow **et** état **soumis** (`doc_status = 1`) : jamais
+  d'e-CF sur un brouillon (lead/visite/devis).
+- `base_field` = champ **Currency réel** du DocType Dossier Vente.
+- `role_id` résolu depuis `rbac_50_roles.json` **et** portail `compta`.
+- `tipo_ecf` = `null` (à confirmer) **ou** code DGII **en périmètre**.
+- `moneda` = `devise` (Select USD/DOP · #10) alignée sur le DocType ; TipoCambio
+  `null` ou sourcé ; FormaPago défaut ∈ table DGII **et** référence Cardnet (#10).
+- **Anti-invention (#6)** : RNC / ITBIS jamais sans `source` (`valeurs_a_confirmer
+  = 6` : emisor + provider + moneda + ITBIS + 2 évènements).
+
+## Vérifications effectuées (en-repo, sans toucher au VPS)
+- **39/39 tests verts** (validateur maison + oracle `jsonschema`) ; génération :
+  10 types e-CF (5 en périmètre) · 2 évènements · 6 valeurs à confirmer ; `out/`
+  commité == régénération bit-à-bit (déterministe).
+- **Gate CI local vert (exit 0)** : `guard_constraints.sh`, `validate_json.sh`,
+  `check_docs.sh` (score présent, 0 lien cassé), YAML `ci.yml` valide.
+- **Régression** : 23 Publiciste + 10 RBAC + 16 Faisabilité + 11 fixtures + 12
+  userperm + 11 roleprofile + 16 apply_plan + 22 bancable + 25 workflow + 31
+  dossier + 25 commissions + 39 e-CF = **241 tests verts** au total.
+
+## Non fait (hors périmètre worker · VPS · #8)
+- Confirmation par la Compta/Direction du `rnc_emisor` + `razon_social` (par
+  entité émettrice), du taux **ITBIS** (et exonération CONFOTUR éventuelle) et du
+  **TipoCambio** du jour pour les e-CF USD — chacun **avec source**.
+- Configuration du proveedor **Compupar** (endpoints, certificat digital DGII,
+  credentials `/etc/oto/credentials`) + assignation de la `secuencia` depuis le
+  rango e-NCF autorisé + câblage sur les transitions du Workflow → agent ERPNext
+  Backend.
+
+## Prochaine tâche suggérée
+- Sprint 4 Frontend Console : squelette des **5 portails rôle**
+  (Ventes/Construction/Achat/Compta/Direction) façon clone `/waf-home`.
+- Sprint 5 ONAPI/Legal : refactor `oto_module_confotur_application.py` → dépôts
+  automatiques (P05/P07).
+
+---
+
+**Auto-score 4Big de l'intégration e-CF DGII : 96/100.** Réserve −4 : confirmation
+des chiffres fiscaux réels (RNC / ITBIS / TipoCambio) + câblage Compupar en
+production = côté VPS (agent ERPNext Backend · #8). Validé statiquement en-repo
+(39 tests verts + schéma conforme + 12 invariants de cross-cohérence + gate CI ·
+241 tests de régression au total).

05_deliverables_mvp/daily_reports/2026-07-30-session15.md

@@ -0,0 +1,82 @@
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 15)
+
+**Session** : `20260730_072711`
+
+## Tâche exécutée
+
+**Sprint 4 · Frontend Console — Générateur de Workspaces ERPNext (5 portails
+rôle)** (roadmap `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` §Sprint 4 l.49 :
+_« Frontend Console : 5 portails (Ventes/Construction/Achat/Compta/Direction) »_).
+
+## Contexte / analyse
+
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, l'`05_activity_log/2026-07-30.md`
+  et les rapports sessions 11-14.
+- **Constat** : les deux autres volets de Sprint 4 sont livrés — CRM (workflow
+  vente s11, DocType porteur s12) et ERPNext Backend (commissions s13, e-CF DGII
+  s14). Le volet **Frontend Console « 5 portails rôle »** restait ouvert (aucun
+  artefact `portail`/`workspace` dans le repo).
+- **Décision d'architecture** (contrainte #1 « ERPNext natif = priorité absolue
+  avant tout outil externe ») : dans ERPNext v15, le portail de landing par rôle
+  **EST le DocType `Workspace`** (le desk affiche à l'utilisateur les Workspaces
+  dont il détient un rôle autorisé). On livre donc 5 Workspaces natifs plutôt
+  qu'un framework de dashboard externe.
+
+## Fichiers créés — `05_deliverables_mvp/frontend/portails/`
+
+- `portails_spec.json` — mise en page des 5 portails (cartes, raccourcis, thème) ;
+  ne déclare **aucun** DocType ni rôle hors du contrat RBAC.
+- `wslib/{__init__,frappe,builder}.py` — connaissance Frappe (DocType `Workspace`
+  + enfants `shortcuts`/`links`/`roles` + blocs `content`) + assemblage
+  déterministe (dérive rôles et DocTypes du contrat `rbac_50_roles.json`).
+- `workspaces_gen.py` — CLI `build`/`validate` · **12 invariants** de
+  cross-cohérence.
+- `workspace.schema.json` — contrat de sortie draft-07.
+- `out/{workspace,MANIFEST}.json` — hand-off (commité).
+- `tests/test_workspaces.py` — **19 tests** (dont 4 négatifs). `README.md` · `.gitignore`.
+
+## Fichiers modifiés
+
+- `.gitea/workflows/ci.yml` : job `frontend-portails-tests` + ajout au `gate`.
+
+## Anti-invention (cœur · #6)
+
+La **source de vérité** est le contrat RBAC, jamais la spec :
+
+- **Aucun lien / raccourci inventé** : tout DocType visé (carte ou raccourci) doit
+  figurer dans les `permissions_cibles` du portail → le portail a **prouvablement**
+  le droit dessus (invariants 2-3, testés en négatif).
+- **Couverture exhaustive et sans doublon** des DocTypes autorisés par les cartes
+  (aucun oubli silencieux — invariant 3).
+- **Rôles** dérivés du contrat (mêmes rôles que le `Role Profile` du portail),
+  triés ; 44 rôles restreints au total.
+- **Flag `custom`** (DocType OTO à créer vs natif v15) lu dans le **contrat** (source
+  unique — invariant 9).
+- **Aucun chiffre stocké** : raccourcis type DocType = compteur **live** du desk.
+- **Tokens de marque** (`#0a0a12`, `#f0b429`, Fraunces, Cormorant Garamond) repris
+  **verbatim** de CLAUDE.md #4, chacun avec `source` (invariant 11).
+
+## Résultat
+
+5 Workspaces : `OTO Ventes` (4 cartes/11 liens/12 rôles), `OTO Construction`
+(4/9/10), `OTO Achat` (3/8/5), `OTO Compta` (4/11/8), `OTO Direction` (4/14/9).
+Console technique `plateforme` **exclue** (roadmap = 5 portails métier ; invariant
+d'égalité stricte avec `portails_business`).
+
+## Vérifs
+
+- 19/19 tests ; gate CI local vert (guard + JSON + docs + YAML `ci.yml` OK).
+- **Régression : 260 tests verts** au total (241 + 19).
+- Build déterministe (invariant 12 : deux passes identiques).
+
+## Hors périmètre worker (VPS · #8)
+
+- Fixer `Workspace.module` au module de l'app OTO à l'import (laissé `null`).
+- Créer les DocTypes custom avant import : `CONFOTUR Application`, `Faisabilité`,
+  `Publiciste Log` (issus des modules OTOV7 du contrat).
+- Déposer `workspace.json` dans `fixtures/` puis `bench migrate`.
+- Appliquer le thème luxury dark+doré (couche thème desk / Website Theme).
+
+→ agent **ERPNext Backend** + **Frontend Console** (déploiement thème).
+
+**Auto-score 4Big** : 96/100.

05_deliverables_mvp/daily_reports/2026-07-30-session16.md

@@ -0,0 +1,76 @@
+# Rapport de session · 2026-07-30 · session 16
+
+## Tâche
+**Sprint 5 · ONAPI/Legal** — Générateur du **DocType porteur `CONFOTUR Application`**
+(roadmap **L55** « Refactor `oto_module_confotur_application.py` → dépôts
+automatiques »).
+
+## Contexte / choix
+Sprint 4 clos (sessions 11-15 : workflow vente, Dossier Vente, commissions, e-CF,
+5 Workspaces). Prochain jalon = **Sprint 5**. Des trois volets Sprint 5, Mobile
+(builds/submit stores) et le déploiement dépendent d'API externes / du VPS →
+**hors périmètre worker** (#8). Le volet **ONAPI/Legal** est le seul entièrement
+réalisable en repo, et il comble un **gap réel** : le DocType custom
+`CONFOTUR Application` est référencé par le contrat RBAC (3 rôles) et par les états
+terminaux du workflow vente (`confotur_depose`/`confotur_approuve`), **mais aucun
+générateur ne le produisait**. La session 15 le listait justement comme DocType
+custom « à créer » côté VPS.
+
+## Décision d'architecture (#1 ERPNext natif)
+Le porteur d'un dossier CONFOTUR **EST un DocType Frappe custom** ; on livre donc
+le fixture DocType natif (soumissible), pas un module externe. On refactorise
+l'intention de `oto_module_confotur_application.py` en un **générateur déterministe**
+aligné sur le pattern des livrables voisins (`crm/dossier_vente`, `fiscal/ecf_dgii`).
+
+## Fichiers créés — `05_deliverables_mvp/legal/confotur/`
+- `confotur_spec.json` — structure métier seule (libellés + types + drapeaux ·
+  **zéro chiffre**) ; nom/permissions/soumissibilité **non** portés par le spec.
+- `cflib/frappe.py` — connaissance Frappe DocType (VALID_PERMS incluant `report`,
+  porté par `legal-directeur`).
+- `cflib/rbac_scan.py` — **lecture** (jamais réécriture) des rôles RBAC visant le
+  DocType `CONFOTUR Application` + leurs actions ; réutilise `RoleResolver` pour
+  `id → nom Frappe` / `portail`.
+- `cflib/builder.py` — assemblage déterministe `{manifest, doctype}`.
+- `confotur_application_gen.py` — CLI `build`/`validate` · **14 invariants** de
+  cross-cohérence DocType↔RBAC↔workflow.
+- `confotur.schema.json` — contrat de sortie draft-07.
+- `out/{doctype_confotur_application,MANIFEST}.json` — hand-off (commité).
+- `tests/test_confotur.py` — **44 tests** (dont 8 négatifs + 3 gardes builder).
+- `README.md` · `.gitignore`.
+
+## Fichiers modifiés
+- `.gitea/workflows/ci.yml` : job `legal-confotur-tests` + ajout au `gate`.
+
+## Anti-invention / anti-dérive (cœur · #6)
+- **Nom** du DocType = identité prouvée présente dans RBAC (invariant : ≥1 rôle le
+  vise + tous `custom`).
+- **Permissions** = **mot pour mot** les `permissions_cibles` RBAC des 3 rôles
+  (`ventes-confotur` read/write/create/print · `legal-onapi` read/write/create ·
+  `legal-directeur` read/write/**submit**/report) — ni ajout ni retrait.
+- **`is_submittable`** déduit de l'action `submit` RBAC, recoupé avec le workflow
+  (états CONFOTUR = `doc_status 1`).
+- **`estado`** / **`dossier_vente`** dérivés du `workflow_vente` (jamais en dur) ;
+  **`entite_porteuse`** = entités CLAUDE.md.
+- **Aucun** taux d'incitation / article de loi / montant / référence d'autorité :
+  deux invariants refusent tout champ de type montant et tout `default` (hors série
+  de nommage). Paramètres légaux réels → `data_room P05/P07` côté VPS.
+- **`depot_events`** (les « dépôts automatiques ») dérivés des transitions confotur
+  du workflow ; invariant : leur rôle a bien accès au DocType (RBAC).
+
+## Résultat
+DocType `CONFOTUR Application` : 18 champs (14 de donnée) · 4 sections · 3 rôles ·
+soumissible · 2 évènements de dépôt (Déposer / Approuver).
+
+## Vérifs
+- 44/44 tests ; `validate` (schéma + 14 invariants) vert ; build déterministe.
+- Gate CI local vert (guard constraints · JSON · docs · YAML `ci.yml`).
+- **Régression : 304 tests verts au total** (279 modules antérieurs + 25
+  workflow_vente + les 44 nouveaux se recoupant dans le discover).
+
+## Hors périmètre worker (VPS · #8)
+Créer le module Frappe `OTOV7 CONFOTUR`, importer le DocType (`bench
+import-fixtures`), câbler les `depot_events` sur le Workflow `OTO Vente Pipeline`,
+et renseigner les paramètres légaux/fiscaux depuis `data_room P05/P07` (avec source)
+→ agent ONAPI/Legal / ERPNext Backend.
+
+## Auto-score 4Big : 96/100

05_deliverables_mvp/daily_reports/2026-07-30-session17.md

@@ -0,0 +1,85 @@
+# Rapport détaillé · 2026-07-30 · Session 17 (`20260730_082714`)
+
+## Sprint 5 · QA — Générateur **Audit 5D de conformité**
+
+### Contexte roadmap
+Sprint 5 · volet **QA** : « **Audit UAF + normes ISA/IFRS 5D** ». Les autres
+volets Sprint 5 sont soit livrés (ONAPI/Legal · DocType CONFOTUR, session 16),
+soit hors périmètre worker (Mobile : builds/submit stores = API externes + VPS,
+#8). L'audit qualité 5D est le volet QA réalisable en repo.
+
+### Décision d'architecture
+L'audit est un **audit de second niveau** : sa matière première est le hand-off
+`out/` **déjà commité** par les générateurs amont (workflow vente, DocType
+Dossier Vente, barème commissions, plan e-CF DGII, DocType CONFOTUR). Il ne
+relance aucun générateur et **ne fabrique aucune donnée** — il vérifie la
+conformité + la cohérence croisée des livrables.
+
+### Les 5 dimensions (5D) et leurs normes
+| # | Dimension | Norme |
+|---|-----------|-------|
+| D1 | Traçabilité & anti-invention | ISA 500 |
+| D2 | Conformité AML / UAF | Ley 155-17 (sujeto obligado · KYC) |
+| D3 | Conformité fiscale e-CF | Ley 32-23 · DGII · Cardnet (#10) |
+| D4 | Intégrité référentielle | IFRS (cohérence documentaire) |
+| D5 | Gouvernance & SoD | ISA 315 (contrôle interne) |
+
+**17 contrôles** au total (D1×4, D2×3, D3×3, D4×4, D5×3).
+
+### Fichiers créés — `05_deliverables_mvp/qa/audit_5d/`
+- `audit_spec.json` — catalogue humain des 17 contrôles + bloc réglementaire UAF
+  déclaratif (`seuil_operacion: null`, a_confirmer, source null).
+- `qalib/{__init__,deps,artifacts,controls,builder}.py` :
+  - `deps.py` **réutilise** (zéro duplication · #6) le validateur maison
+    Publiciste, `is_filled`, le `RoleResolver` du module CRM et `roles_targeting`
+    du module CONFOTUR ;
+  - `artifacts.py` charge les 5 hand-off `out/` (erreur explicite si absent) ;
+  - `controls.py` = les 17 contrôles (fonctions pures) + les 5 dimensions ;
+  - `builder.py` assemble le rapport déterministe (aucun horodatage).
+- `audit_5d_gen.py` — CLI `build`/`validate` · **15 invariants**.
+- `audit.schema.json` — contrat de sortie (draft-07, sous-ensemble maison).
+- `out/{audit_report,MANIFEST}.json` — hand-off commité.
+- `tests/test_audit_5d.py` — **37 tests** (`unittest`, zéro pip), une injection
+  négative par contrôle.
+- `README.md` · `.gitignore`.
+
+### Fichiers modifiés
+- `.gitea/workflows/ci.yml` : job `qa-audit-5d-tests` + ajout au `gate`.
+
+### Anti-invention (cœur · #6)
+Le principe même de l'audit : **remonter, pas fabriquer**. Un paramètre
+réglementaire réel non confirmé produit le statut **A_CONFIRMER** (un « open
+item » assigné au métier propriétaire), jamais une valeur inventée « pour faire
+PASS ». Un statut **FAIL** signale soit une incohérence inter-livrables, soit une
+valeur chiffrée présente **sans `source`** (fabrication). Un invariant refuse tout
+FAIL sur les livrables courants ; un test injecte une valeur fabriquée par
+contrôle D1/D2 et vérifie qu'elle bascule bien en FAIL.
+
+### Verdict courant
+`PASS_WITH_OPEN_ITEMS` — **13 PASS · 0 FAIL · 4 à confirmer** :
+
+| Open item | Propriétaire |
+|-----------|--------------|
+| D1.1 · taux de commission | Direction |
+| D1.2 · RNC / raison sociale émetteur | Compta |
+| D1.3 · ITBIS + TipoCambio | Compta Fiscaliste eCF |
+| D2.3 · seuil de déclaration UAF | Oficial de Cumplimiento / UAF |
+
+Ce sont les **4 mêmes paramètres** laissés `null` (a_confirmer) par les
+générateurs amont : l'audit **prouve qu'aucun n'a été fabriqué** et les
+consolide en une **check-list unique** de confirmation pour le VPS.
+
+### Vérifications
+- 37/37 tests du module ; `validate` : schéma + 15 invariants verts.
+- Gate CI local vert : `guard_constraints` + `validate_json` + `check_docs` +
+  YAML `ci.yml` valide.
+- **Régression : 341 tests verts** au total (304 prior + 37).
+- Build déterministe (invariant #15 : deux exécutions identiques).
+
+### Hors périmètre worker (VPS · #8)
+- Confirmation des 4 paramètres réglementaires (open items) par les métiers
+  propriétaires + saisie avec `source` dans `data_room PXX`.
+- Tests E2E Playwright sur le desk ERPNext réel (workflow_dispatch manuel, hors
+  gate statique).
+
+**Auto-score 4Big : 96/100.**

05_deliverables_mvp/daily_reports/2026-07-30-session18.md

@@ -0,0 +1,94 @@
+# Rapport de session · 2026-07-30 · session 18
+
+## Tâche
+
+**Sprint 6 · SEO** — Générateur **SEO trilingue** (mots-clés FR/EN/ES +
+schema.org + hreflang). Roadmap L60 : « Refactor mission `seo_autonome/` →
+**200+ mots-clés FR/EN/ES · schema.org · hreflang** ».
+
+Sprint 5 étant clos en repo (ONAPI/Legal session 16 · QA Audit 5D session 17,
+Mobile hors périmètre VPS · #8), c'est le premier volet Sprint 6 réalisable dans
+le repo. Les deux autres volets Sprint 6 (OTOIA voice Amélie pilote AEC · chat
+OTOIA embarqué) dépendent d'API externes / du desk VPS → hors périmètre worker.
+
+## Décision d'architecture
+
+Le SEO est un livrable de **second niveau** : sa 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
+générateur **ne fabrique aucun fait de projet** — il compose du SEO à partir de
+données déjà sourcées + un lexique éditorial générique non chiffré.
+
+Ce choix respecte #6 (zéro invention) et #5 (zéro duplication) : le générateur
+**réutilise** le validateur maison et les tokens de marque du Publiciste
+(`lib/validator.py`, `lib/branding.py` → `STATUTS_SANS_PRIX`, devise USD), sans
+les réimplémenter.
+
+## Fichiers créés — `05_deliverables_mvp/seo/`
+
+- `seo_spec.json` — config site (base_url, langs FR/EN/ES, préfixes, x-default)
+  + **lexique éditorial générique** (immobilier / à vendre / résidence / pays /
+    régime CONFOTUR) + org schema.org + cibles. **Zéro donnée de projet, zéro
+    chiffre.**
+- `seolib/{__init__,deps,keywords,schemaorg,hreflang,builder}.py`
+  - `deps` réutilise validateur + branding Publiciste ; `slugify`/`digits`
+    déterministes.
+  - `keywords` : génération déterministe, chaque mot-clé porte `scope`, `projet`,
+    `intent`, `category` et une liste `sources` non vide.
+  - `schemaorg` : graphe JSON-LD (`Organization` + une `Residence`/projet),
+    `offers` **uniquement** si projet disponible + prix sourcé (USD).
+  - `hreflang` : `alternate` FR/EN/ES + `x-default` par page.
+- `seo_gen.py` — CLI `build`/`validate` · **15 invariants** de cross-cohérence
+  et d'anti-invention.
+- `seo.schema.json` — contrat de sortie draft-07 (bundle keywords + schema.org +
+  hreflang + manifest).
+- `fixtures/projets_master.json` — entrée **de test** : 9 projets P01..P09 (noms
+  sourcés de `CLAUDE.md §Projets`), tous `en_developpement`, **sans aucun chiffre**.
+- `out/{seo_keywords,seo_schema_org,seo_hreflang,MANIFEST}.json` (hand-off) ·
+  `tests/test_seo.py` (**36 tests** dont 8 injections négatives) · `README.md` ·
+  `.gitignore`.
+
+## Fichiers modifiés
+
+- `.gitea/workflows/ci.yml` : job `seo-tests` + ajout au `gate`.
+
+## Anti-invention (cœur · #6)
+
+- Un **mot-clé** = composition de *tokens factuels* (`projet:<code>.nom` /
+  `.localisation`, sourçables) et de *lexique éditorial* (`lexicon:*`, générique
+  non chiffré). Un invariant vérifie que chaque mot-clé est **sourcé et
+  résoluble**.
+- Un mot-clé **ne peut porter que les chiffres présents dans son champ projet
+  source** : « 1069 Crisfer » (P09) passe ; un prix injecté (`… 250000`) est
+  **refusé** par l'invariant #7 (test négatif dédié).
+- **schema.org** n'émet une `offers`/`price` **que** pour un projet `disponible`
+  dont une typologie porte un `prix_depuis_usd` **numérique sourcé** ; devise
+  **USD** (#10). Pour tout statut sans prix : **aucun chiffre** (invariant #11 +
+  tests). La fixture livrée (9 projets `en_developpement`) produit donc
+  **0 offre** — aucune valeur inventée dans le hand-off committé.
+
+## Résultat
+
+- **258 mots-clés** — fr=87 · en=87 · es=84 (cible roadmap 200 dépassée) ;
+- schema.org : **10 nœuds** (1 Organization + 9 Residence), 0 offre ;
+- hreflang : **10 pages** (accueil + 9 projets), 4 `alternate`/page (FR/EN/ES +
+  x-default).
+
+## Vérifs
+
+- **36/36 tests** SEO verts (dont oracle `jsonschema` si présent) ;
+- gate CI local vert : guard contraintes · JSON bien formés · docs (liens +
+  score) · YAML valide ;
+- **régression 377 tests verts** au total (341 → +36), 0 module en échec ;
+- build déterministe (test dédié : deux builds identiques).
+
+## Hors périmètre worker (VPS · #8)
+
+- Injection des balises `<link hreflang>` + `<script JSON-LD>` 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 ;
+- Branchement du générateur sur la **vraie** sortie Publiciste (9 projets réels
+  `data_room/PXX/`) via `--master`.
+
+## Auto-score 4Big : 96/100.

05_deliverables_mvp/daily_reports/2026-07-30-session6.md

@@ -0,0 +1,86 @@
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 6)
+
+**Session** : `20260730_025643`
+
+## Tâche exécutée
+**Sprint 2 · Livrable ERPNext Backend « Générateur de fixtures RBAC → Frappe »**
+(roadmap `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` §Sprint 2 « RBAC 50 rôles » ·
+`RBAC_50_ROLES_SPEC.md` §7 qui l'annonce comme prochain incrément · suggéré par
+les daily reports sessions 4-5).
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, `GAP_ANALYSIS_SPRINT1.md`,
+  daily reports sessions 4-5, `rbac_50_roles.json` + `rbac.schema.json` +
+  `RBAC_50_ROLES_SPEC.md`, validateur maison Publiciste, patrons générateur
+  Faisabilité + CI.
+- État Sprint 2 côté repo : RBAC contrat (s4), Publiciste parser+gen (s3),
+  Faisabilité générateur 4 volets (s5) livrés. Frontend/CRM dépendent des
+  layouts LIVE (VPS · hors périmètre).
+- **Priorité évidente et déjà annoncée** (SPEC §7, reports s4/s5) : le
+  **générateur de fixtures ERPNext** `rbac_50_roles.json → Role + Custom
+  DocPerm`. Sur le chemin critique de l'application RBAC (S4), 100 % autorable
+  en-repo (zéro API, zéro VPS, zéro pip), branché sur le même patron que le
+  Publiciste/Faisabilité.
+
+## Réalisé — module `05_deliverables_mvp/rbac/fixtures_gen/`
+- `fixturelib/frappe.py` — modèle **natif Frappe/ERPNext v15** : ordre des 15
+  flags DocPerm, mapping **1:1** des 12 verbes RBAC → flags, `if_owner` dérivé de
+  `scope_donnees == "own"`, constructeurs `role_fixture()` / `docperm_fixture()`.
+  Aucun chiffre métier (contrainte #1 : ERPNext natif, aucun modèle externe).
+- `fixturelib/builder.py` — `build_bundle()` **déterministe** (tri stable rôles
+  par nom Frappe, DocPerms par (role, doctype, permlevel)), collecte des DocTypes
+  `custom` à confirmer, manifeste de traçabilité.
+- `rbac_fixtures_gen.py` — CLI `build` (écrit `role.json` / `custom_docperm.json`
+  / `MANIFEST.json`) et `validate`. La génération **refuse d'écrire** si un
+  invariant casse (schéma, 50 rôles, unicité, séparation des pouvoirs).
+- `fixtures.schema.json` — contrat de sortie draft-07 (sous-ensemble supporté par
+  le **validateur maison Publiciste**, zéro pip).
+- `tests/test_fixtures_gen.py` — **11 tests `unittest` (stdlib pur)** : schéma
+  (maison + oracle `jsonschema` si présent), 50 rôles uniques, flags non pilotés
+  à 0, `if_owner`⇔scope, séparation des pouvoirs, **round-trip fidèle au
+  contrat** (aucune permission inventée ni perdue), déterminisme bit-à-bit.
+- **CI** : job `rbac-fixtures-tests` ajouté au **gate** de `.gitea/workflows/ci.yml`
+  (Gitea Actions uniquement · #2).
+- `README.md` + `.gitignore` (output `out/` non commité, re-généré à la demande).
+- `RBAC_50_ROLES_SPEC.md §7` mis à jour (générateur livré).
+
+## Anti-invention (#6) appliqué
+- 100 % des données proviennent du contrat `rbac_50_roles.json` déjà validé ;
+  seuls ajouts = flags DocPerm natifs à **0** (défaut sûr) + méta de traçabilité.
+- Verbes non pilotés (`select`/`amend`/`import`) forcés à 0 et testés.
+- Verbe hors contrat → `ValueError` explicite (garde-fou anti-contrat corrompu).
+- DocTypes DTP `custom` **jamais supposés existants** : listés dans le manifeste
+  « à créer + confirmer VPS » avant import (SPEC §6/§7).
+- Séparation des pouvoirs : `set_user_permissions` réservé au RBAC Admin,
+  vérifié par test **et** par le CLI (échec si un autre rôle le porte).
+
+## Vérifications effectuées (en-repo, sans toucher au VPS)
+- **11/11 tests verts** (schéma maison + oracle `jsonschema` → concordance
+  draft-07 confirmée). Génération réelle : 50 rôles, **116 Custom DocPerm** sur
+  45 DocTypes, 4 DocTypes `custom` signalés.
+- **Gate CI local vert (exit 0)** : `guard_constraints.sh`, `validate_json.sh`,
+  `check_docs.sh` (0 lien cassé), YAML `ci.yml` valide.
+- **Régression** : 23/23 Publiciste + 10/10 RBAC + 16/16 Faisabilité toujours
+  verts (réutilisation du validateur sans effet de bord). **Total 60 tests.**
+
+## Non fait (hors périmètre worker · VPS)
+- Application des fixtures (`bench migrate` / `import-fixtures`) sur
+  `erpnext-backend-1` → agent ERPNext Backend.
+- Création des DocTypes DTP `custom` + mapping `scope_donnees` → `User Permission`
+  par utilisateur → VPS.
+- `permlevel > 0` (segmentation par niveau de champ) : non spécifié par le
+  contrat RBAC → non couvert (anti-invention #6).
+
+## Prochaine tâche suggérée
+- ERPNext S2 : générateur des fixtures `User Permission` **par entité** (WAF/WA
+  SRL/AC…) depuis `scope_donnees` (même patron, autorable en-repo partiellement).
+- Ou Faisabilité S3 : `40_llm_outputs/` + rapports bancables FR/EN/ES.
+- Ou Frontend/CRM S2 : dépend des layouts LIVE (VPS) → hors périmètre worker.
+
+---
+
+**Auto-score 4Big du livrable Générateur de fixtures RBAC : 96/100.** Réserve
+−4 : application `bench` + DocTypes `custom` + `User Permission` = côté VPS
+(agent ERPNext, hors périmètre) ; `permlevel > 0` non couvert (anti-invention
+#6). Validé statiquement en-repo (11 tests verts + round-trip fidèle au contrat
++ gate CI vert).

05_deliverables_mvp/daily_reports/2026-07-30-session7.md

@@ -0,0 +1,91 @@
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 7)
+
+**Session** : `20260730_032644`
+
+## Tâche exécutée
+**Sprint 2 · Livrable ERPNext Backend « Générateur de plan `User Permission`
+row-level (RBAC 50 rôles → scope_donnees → Frappe) »**
+(roadmap `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` §Sprint 2 « RBAC 50 rôles » ·
+`RBAC_50_ROLES_SPEC.md` §7 ét. 4 · **prochaine tâche suggérée** par le daily
+report session 6).
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, daily report session 6,
+  `rbac_50_roles.json` + `rbac.schema.json`, générateur de fixtures `fixtures_gen`
+  (Role + Custom DocPerm), validateur maison Publiciste, patron CI.
+- État Sprint 2 : contrat RBAC (s4), Publiciste (s3), Faisabilité (s5), fixtures
+  `Role`+`Custom DocPerm` (s6) livrés. Frontend/CRM dépendent de layouts LIVE (VPS).
+- **Priorité évidente** (SPEC §7 ét. 4 + report s6) : le mapping row-level
+  `scope_donnees → User Permission` — dernier maillon RBAC manquant en-repo, sur
+  le chemin critique de l'application RBAC (S4), 100 % autorable sans VPS/pip/API,
+  même patron que le générateur de fixtures.
+
+## Réalisé — module `05_deliverables_mvp/rbac/userperm_gen/`
+- `permlib/frappe.py` — modèle **Frappe/ERPNext v15 natif** : mapping des 4
+  valeurs `scope_donnees` → mécanisme d'enforcement row-level natif
+  (`own`→`if_owner` déjà posé par fixtures_gen · `entite`→`User Permission`
+  allow=`Company` · `groupe`→aucune restriction consolidée · `equipe`→**pas de
+  dimension native** → signalé). Template `User Permission` avec `user` =
+  **sentinelle** `__ASSIGN_PER_USER__` (une UP est per-utilisateur, pas per-rôle
+  → aucun utilisateur inventé, #6). Garde-fou : `entite` + périmètre consolidé
+  (« Groupe ») → `ValueError`.
+- `permlib/builder.py` — `build_plan()` **déterministe** (tri stable par nom de
+  rôle) : 1 entrée/rôle + manifeste (comptes par mécanisme, Companies +
+  rôles `equipe` à confirmer VPS).
+- `userperm_gen.py` — CLI `build` / `validate`. **Refuse d'écrire** si un
+  invariant casse (schéma, couverture bijective des 50 rôles, mécanisme =
+  mapping du scope, template SSI `entite`, fidélité `for_value`↔entité,
+  sentinelle utilisateur, cohérence des comptes).
+- `userperm.schema.json` — contrat de sortie draft-07 (sous-ensemble supporté par
+  le **validateur maison Publiciste**, zéro pip · `user_permission_template`
+  nullable).
+- `tests/test_userperm_gen.py` — **12 tests `unittest` (stdlib pur)** : schéma
+  (maison + oracle `jsonschema` si présent), couverture bijective, mécanisme↔scope,
+  template SSI `entite`, anti-invention utilisateur, manifeste fidèle,
+  déterminisme, garde-fous (scope inconnu + entité consolidée).
+- **CI** : job `rbac-userperm-tests` ajouté au **gate** de `.gitea/workflows/ci.yml`
+  (Gitea Actions uniquement · #2).
+- `README.md` + `.gitignore` (output `out/` non commité, re-généré à la demande).
+- **Docs cousues** : `RBAC_50_ROLES_SPEC.md §7` (ét. 4 + encart livré) et
+  `fixtures_gen/README.md` (ét. 4) pointent désormais vers le nouveau générateur.
+
+## Anti-invention (#6) appliqué
+- 100 % des données (rôle, scope, entité) proviennent du contrat `rbac_50_roles.json`.
+- **Aucun utilisateur inventé** : champ `user` = sentinelle (vérifié test + CLI).
+- **Aucune restriction fabriquée** hors portée `entite` : `own`/`groupe`/`equipe`
+  → `user_permission_template = null`.
+- Portée `equipe` (pas de dimension row-level native ERPNext v15) : **signalée**
+  dans le manifeste (options natives documentées pour l'agent ERPNext), jamais
+  mappée arbitrairement.
+- `for_value` (Company) = `entite_principale` du contrat, à **confirmer VPS**
+  (jamais supposée existante).
+
+## Vérifications effectuées (en-repo, sans toucher au VPS)
+- **12/12 tests verts** (schéma maison + oracle `jsonschema`). Génération réelle :
+  **50 entrées**, **28 templates Company** (`entite`), 16 consolidés (`groupe`),
+  2 `own`, 4 `equipe` signalés. Companies : AC Arias Cuevas, Consortium ECR DR,
+  Helios RD, Ploutos, WA SRL.
+- **Gate CI local vert (exit 0)** : `guard_constraints.sh`, `validate_json.sh`,
+  `check_docs.sh` (0 lien cassé), YAML `ci.yml` valide.
+- **Régression** : 23 Publiciste + 10 RBAC + 11 fixtures + 16 Faisabilité + 12
+  userperm = **72 tests verts** (réutilisation du validateur sans effet de bord).
+
+## Non fait (hors périmètre worker · VPS)
+- Matérialisation des `User Permission` **par utilisateur** (remplacement de la
+  sentinelle) + création des Companies + import → agent ERPNext Backend.
+- Décision du mécanisme des rôles `equipe` (champ custom + UP, ou
+  `Employee.reports_to`) → à valider avec Michel côté VPS.
+
+## Prochaine tâche suggérée
+- ERPNext S2 : agrégateur `MANIFEST` unifié Role + DocPerm + User Permission
+  (vue unique d'application VPS), ou générateur `Role Profile` par portail.
+- Ou Faisabilité S3 : `40_llm_outputs/` + rapports bancables FR/EN/ES.
+- Frontend/CRM S2 : dépend des layouts LIVE (VPS) → hors périmètre worker.
+
+---
+
+**Auto-score 4Big du livrable Générateur de plan User Permission : 96/100.**
+Réserve −4 : matérialisation par utilisateur + création des Companies + décision
+du mécanisme `equipe` = côté VPS (agent ERPNext, hors périmètre) ; portée `equipe`
+sans dimension native délibérément non inventée (#6). Validé statiquement en-repo
+(12 tests verts + round-trip fidèle au contrat + gate CI vert).

05_deliverables_mvp/daily_reports/2026-07-30-session8.md

@@ -0,0 +1,93 @@
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 8)
+
+**Session** : `20260730_035651`
+
+## Tâche exécutée
+**Sprint 2 · Livrable ERPNext Backend « Générateur de `Role Profile` par portail
+(RBAC 50 rôles → bundles de rôles assignables) »**
+(roadmap `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` §Sprint 2 « RBAC 50 rôles » ·
+`RBAC_50_ROLES_SPEC.md` §7 ét. 5 · **prochaine tâche suggérée** par le daily
+report session 7 : « générateur `Role Profile` par portail »).
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, daily report session 7,
+  `rbac_50_roles.json` + `rbac.schema.json`, les deux générateurs existants
+  (`fixtures_gen` Role+DocPerm, `userperm_gen` row-level), le validateur maison
+  Publiciste, le patron CI.
+- État Sprint 2 : contrat RBAC (s4), Publiciste (s3), Faisabilité (s5), fixtures
+  `Role`+`Custom DocPerm` (s6), plan `User Permission` row-level (s7) livrés.
+  Frontend/CRM dépendent de layouts LIVE (VPS) → hors périmètre worker.
+- **Priorité évidente** (SPEC §7 + report s7) : le **bundle assignable** manquant.
+  `fixtures_gen` = « quels verbes sur quel DocType », `userperm_gen` = « sur
+  quelles lignes » ; il manquait « comment donner à un utilisateur tous les rôles
+  de son portail en un geste ». ERPNext v15 le fait nativement avec le DocType
+  `Role Profile`. 100 % autorable sans VPS/pip/API, même patron que les deux
+  générateurs précédents, sur le chemin critique de l'application RBAC (S4).
+
+## Réalisé — module `05_deliverables_mvp/rbac/roleprofile_gen/`
+- `profilelib/frappe.py` — modèle **Frappe/ERPNext v15 natif** : DocTypes
+  `Role Profile` + child `Has Role` (aucun DocType custom). Nom de profil =
+  **convention de nommage déterministe** `OTO Portail <Portail>` dérivée de la
+  clé `portail` (aucun libellé métier fabriqué, #6). Garde-fous : portail vide et
+  profil sans rôle → `ValueError`.
+- `profilelib/builder.py` — `build_bundle()` **déterministe** : regroupe les 50
+  rôles par `portail` (profils triés par portail, `Has Role` triés par nom de
+  rôle) → **6 profils** + manifeste (comptes, flag métier vs technique, mapping
+  `portail → role_profile`).
+- `roleprofile_gen.py` — CLI `build` / `validate`. **Refuse d'écrire** si un
+  invariant casse (schéma, couverture **bijective** des 50 rôles, un profil par
+  portail distinct, cohérence portail intra-profil, fidélité du manifeste,
+  cohérence des comptes, tris déterministes).
+- `roleprofile.schema.json` — contrat de sortie draft-07 (sous-ensemble supporté
+  par le **validateur maison Publiciste**, zéro pip).
+- `tests/test_roleprofile_gen.py` — **11 tests `unittest` (stdlib pur)** : schéma
+  (maison + oracle `jsonschema` si présent), couverture bijective, un profil par
+  portail, cohérence portail, manifeste fidèle, anti-invention (que du natif v15),
+  déterminisme, garde-fous.
+- **CI** : job `rbac-roleprofile-tests` ajouté au **gate** de
+  `.gitea/workflows/ci.yml` (Gitea Actions uniquement · #2).
+- `README.md` + `.gitignore` (output `out/` non commité, re-généré à la demande).
+- **Docs cousues** : `RBAC_50_ROLES_SPEC.md §7` (nouvelle ét. 5 + encart livré,
+  renumérotation de la vérification HTTP en ét. 6).
+
+## Anti-invention (#6) appliqué
+- 100 % des rôles (et leur portail) proviennent du contrat `rbac_50_roles.json`.
+- **Que du natif ERPNext v15** : `Role Profile` + `Has Role` → aucun DocType
+  custom à confirmer côté VPS (contrainte #1 « ERPNext natif »).
+- Le nom du profil est une convention déterministe dérivée de la clé `portail`,
+  pas un libellé métier inventé ; la clé brute reste tracée dans le manifeste.
+- Le flag `metier` reflète strictement l'appartenance à `portails_business` du
+  contrat (les 6 portails = 5 métier + la console technique `plateforme`).
+
+## Vérifications effectuées (en-repo, sans toucher au VPS)
+- **11/11 tests verts** (schéma maison + oracle `jsonschema`). Génération réelle :
+  **6 profils** (Ventes 12, Construction 10, Direction 9, Compta 8, Achat 5 =
+  métier ; Plateforme 6 = technique), **50/50 rôles couverts** de façon bijective.
+- **Gate CI local vert (exit 0)** : `guard_constraints.sh`, `validate_json.sh`,
+  `check_docs.sh` (0 lien cassé, mention score présente), YAML `ci.yml` valide.
+- **Régression** : 23 Publiciste + 10 RBAC + 11 fixtures + 12 userperm + 16
+  Faisabilité + 11 roleprofile = **83 tests verts**.
+
+## Note de cohérence documentaire
+- Le tableau §3 du SPEC annonçait direction=10 / plateforme=5 ; le JSON réel porte
+  direction=9 / plateforme=6. Le SPEC note explicitement que **le JSON est la
+  source de vérité** → le générateur est data-driven (compte réel). Pas de
+  correction du tableau §3 (marqué « indicatif ») pour ne pas dévier du périmètre.
+
+## Non fait (hors périmètre worker · VPS)
+- Import `bench migrate` des fixtures + affectation `User.role_profile_name` par
+  utilisateur → agent ERPNext Backend (SPEC §7 ét. 3/5).
+
+## Prochaine tâche suggérée
+- ERPNext S2 : agrégateur `MANIFEST` unifié Role + DocPerm + User Permission +
+  Role Profile (vue/ordre d'application VPS unique), pour clore le volet RBAC.
+- Ou Faisabilité S3 : `40_llm_outputs/` + rapports bancables FR/EN/ES.
+- Frontend/CRM S2 : dépend des layouts LIVE (VPS) → hors périmètre worker.
+
+---
+
+**Auto-score 4Big du livrable Générateur de Role Profile : 96/100.**
+Réserve −4 : import `bench` + affectation `role_profile_name` par utilisateur =
+côté VPS (agent ERPNext, hors périmètre worker, #8). Validé statiquement en-repo
+(11 tests verts + schéma conforme + couverture bijective fidèle au contrat + gate
+CI vert · 83 tests de régression au total).

05_deliverables_mvp/daily_reports/2026-07-30-session9.md

@@ -0,0 +1,93 @@
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 9)
+
+**Session** : `20260730_042654`
+
+## Tâche exécutée
+**Sprint 2 · Livrable ERPNext Backend « Agrégateur RBAC : run-book d'application
+VPS unifié (3 volets → 1 plan ordonné) »**
+(roadmap `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` §Sprint 2 « RBAC 50 rôles » ·
+`RBAC_50_ROLES_SPEC.md` §7 · **prochaine tâche suggérée** par le daily report
+session 8 : « agrégateur MANIFEST unifié Role + DocPerm + User Permission +
+Role Profile pour clore le volet RBAC »).
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, daily reports sessions 7 et 8,
+  `rbac_50_roles.json`, les **trois générateurs RBAC** livrés (`fixtures_gen`,
+  `userperm_gen`, `roleprofile_gen`) + leurs manifestes, le validateur maison
+  Publiciste, le patron CI, la SPEC §7.
+- État Sprint 2 : contrat RBAC (s4), Publiciste (s3), Faisabilité (s5), fixtures
+  `Role`+`Custom DocPerm` (s6), plan `User Permission` (s7), `Role Profile` (s8)
+  livrés. Frontend/CRM dépendent de layouts LIVE (VPS) → hors périmètre worker.
+- **Priorité évidente** (report s8 + SPEC §7) : les 3 volets existent mais l'ordre
+  d'application restait **implicite**. Or il porte des contraintes ERPNext dures
+  (Role importé AVANT Role Profile) et des confirmations préalables dispersées
+  dans 3 manifestes. Le maillon manquant = la **vue d'ensemble** : un run-book
+  ordonné + un manifeste agrégé. 100 % autorable sans VPS/pip/API, même patron
+  que les 3 générateurs, clôt le volet RBAC en-repo.
+
+## Réalisé — module `05_deliverables_mvp/rbac/apply_plan/`
+- `applylib/aggregator.py` — **agrège sans rien recalculer** : appelle les 3
+  builders (`fixtures_builder.build_bundle`, `userperm_builder.build_plan`,
+  `roleprofile_builder.build_bundle`), recoupe la cohérence (même contrat / même
+  version / même cible 50 → `_require_same` lève sur mélange), fusionne les
+  confirmations VPS, et produit le **run-book des 6 étapes SPEC §7** (responsable
+  worker/vps, statut, commande worker, artefacts, `depends_on`, confirmations,
+  lien doc). Ordre + dépendances = savoir procédural documenté, pas des chiffres.
+- `rbac_apply_plan.py` — CLI `build` / `validate`. **Refuse d'écrire** si un
+  invariant casse : couverture SPEC §7 exacte + `order` séquentiel, graphe de
+  dépendances (aucune arête en avant, aucun renvoi fantôme), Role Profile **après**
+  fixtures Role, confirmations ni orphelines ni fantômes, cohérence inter-volets,
+  **couverture bijective** (Role == 50 == entrées UP == rôles couverts profils),
+  listes triées.
+- `apply_plan.schema.json` — contrat de sortie draft-07 (sous-ensemble supporté
+  par le **validateur maison Publiciste**, zéro pip · `commande` nullable via
+  type-array `["string","null"]`).
+- `tests/test_apply_plan.py` — **16 tests `unittest` (stdlib pur)** : schéma
+  (maison + oracle `jsonschema`), fidélité des comptes aux manifestes source,
+  fusion des confirmations, ordre + graphe SPEC §7, Role avant Role Profile,
+  garde-fous de cohérence (rejet version/cible discordantes), déterminisme,
+  détection d'invariants cassés.
+- **CI** : job `rbac-applyplan-tests` ajouté au **gate** de
+  `.gitea/workflows/ci.yml` (Gitea Actions uniquement · #2).
+- `README.md` + `.gitignore` (output `out/` non commité, re-généré à la demande).
+- **Docs cousues** : `RBAC_50_ROLES_SPEC.md §7` (préambule pointe le run-book
+  consolidé + nouveau ✅ encart livré).
+
+## Anti-invention (#6) appliqué
+- **Zéro chiffre recalculé** : chaque compte du manifeste agrégé provient du
+  manifeste d'un builder source (vérifié par `test_counts_come_from_source_manifests`).
+- Chaque item « à confirmer VPS » (DocType custom / Company / rôles `equipe`) est
+  **repris tel quel** des manifestes d'origine, juste trié et fusionné.
+- L'ordre des étapes et le graphe de dépendances encodent des **contraintes
+  ERPNext v15 documentées** (SPEC §7), pas des décisions fabriquées.
+- Un mélange de volets (versions de contrat différentes) est **refusé**, jamais
+  silencieusement concilié.
+
+## Vérifications effectuées (en-repo, sans toucher au VPS)
+- **16/16 tests verts** (schéma maison + oracle `jsonschema`). Génération réelle :
+  **6 étapes**, comptes agrégés 50 rôles / 116 DocPerm / 45 DocTypes / 28 UP
+  templates / 6 Role Profile ; confirmations VPS = 4 DocType custom + 5 Company +
+  4 rôles `equipe` ; **couverture bijective 50/50 recoupée sur les 3 volets**.
+- **Gate CI local vert (exit 0)** : `guard_constraints.sh`, `validate_json.sh`,
+  `check_docs.sh` (0 lien cassé, mention score présente), YAML `ci.yml` valide.
+- **Régression** : 23 Publiciste + 10 RBAC + 11 fixtures + 12 userperm + 11
+  roleprofile + 16 apply_plan + 16 Faisabilité = **99 tests verts**.
+
+## Non fait (hors périmètre worker · VPS)
+- Exécution réelle du run-book (`bench migrate`, création DocTypes custom,
+  affectation `role_profile_name`, matérialisation `User Permission` par
+  utilisateur) → agent ERPNext Backend (SPEC §7 ét. 2/3/4/5/6).
+
+## Prochaine tâche suggérée
+- **Volet RBAC clos en-repo** (4 générateurs + run-book unifié). Suite logique :
+  Faisabilité S3 (`40_llm_outputs/` + rapports bancables FR/EN/ES) ; ou préparer
+  le hand-off ERPNext (packaging `fixtures/` de l'app OTO à partir des 4 sorties).
+- Frontend/CRM S2 : dépend des layouts LIVE (VPS) → hors périmètre worker.
+
+---
+
+**Auto-score 4Big du livrable Agrégateur RBAC (run-book) : 96/100.**
+Réserve −4 : l'exécution réelle du run-book reste côté VPS (agent ERPNext, hors
+périmètre worker, #8). Validé statiquement en-repo (16 tests verts + schéma
+conforme + recoupement bijectif des 3 volets + gate CI vert · 99 tests de
+régression au total).

05_deliverables_mvp/daily_reports/2026-07-30.md

@@ -0,0 +1,237 @@
+# Daily Report · 2026-07-30 · Claude Code DTP Worker
+
+**Session** : `20260730_002624`
+
+## Tâche exécutée
+**Sprint 1 · Livrable DevOps « CI/CD Gitea Actions »**
+(roadmap `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` §Sprint 1 · GAP_ANALYSIS_SPRINT1 §7 = `☐ à faire`).
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, `GAP_ANALYSIS_SPRINT1.md`, daily report 2026-07-29, AGENT.md DevOps + QA.
+- **Sprint 1 non terminé.** Critères de sortie restants (§7) authorables **dans ce repo sans toucher au VPS** :
+  1. **CI/CD Gitea Actions** (DevOps · marqué *PRIORITÉ S1* · gate qualité qui conditionne tous les sprints).
+  2. Baseline Playwright (QA) — dépend des endpoints VPS pour s'exécuter réellement.
+- Priorité évidente : **CI/CD Gitea Actions** — 100 % authorable en-repo, débloque le gate qualité 4Big, déjà signalé comme prochaine tâche par la session précédente.
+
+## Réalisé
+- Créé `.gitea/workflows/ci.yml` : pipeline Gitea Actions (push/PR `main` + `workflow_dispatch`), 4 jobs → `constraints-guard`, `validate-json`, `check-docs`, `gate` agrégat. Zéro dépendance marketplace hors `actions/checkout`. **Gitea Actions uniquement** (contrainte #2, jamais GitHub).
+- Créé `ci/guard_constraints.sh` : enforce les contraintes NON-NÉGOCIABLES de CLAUDE.md — GitHub/GitLab/Bitbucket (#2), EspoCRM/HubSpot (#3), Stripe (#10), écriture `/var/www/html/static/`, `git clean`, remote git non-Gitea. **Heuristique zéro faux positif** : ignore les lignes portant un marqueur de prohibition (`jamais`/`❌`/`only`/`interdit`…) + escape hatch `ci-allow`.
+- Créé `ci/validate_json.sh` : parse strict de tous les `*.json` suivis (contrat Faisabilité↔Publiciste).
+- Créé `ci/check_docs.sh` : liens Markdown internes cassés [HARD] + présence auto-score 4Big [SOFT].
+- Créé `ci/README.md` : doc pipeline + exécution locale + **procédure d'enregistrement du runner Gitea** (act_runner, à exécuter côté VPS par DevOps).
+- Mis à jour `GAP_ANALYSIS_SPRINT1.md` §7 : critère « CI/CD Gitea Actions » → ✅ (runner VPS restant à confirmer).
+
+## Vérifications effectuées (dans le repo, sans toucher au VPS)
+- Les 3 scripts passent au **vert (exit 0)** sur l'état actuel du repo — aucun faux positif sur le texte de politique de CLAUDE.md/AGENT.md.
+- **Test négatif** : fichier de violation temporaire (`hubspot` + `github.com`) → guard retourne **exit 1** et pointe les 2 violations, en ignorant correctement les lignes de prohibition. Fichier de test retiré (repo propre). <!-- ci-allow : cette ligne décrit le test négatif du guard lui-même -->
+
+- `git remote -v` = Gitea (`gitea.otov7.com`) → conforme #2.
+
+## Non fait (hors périmètre worker · touche au VPS)
+- Enregistrement de l'`act_runner` Gitea (label `ubuntu-latest`) → DevOps sur VPS (procédure dans `ci/README.md` §4).
+- Activation de Gitea Actions au niveau instance + repo → DevOps.
+- Baseline Playwright QA (`/crm`, `/waf-home`, `/qa`, `/choisir-mon-unite`) → nécessite endpoints VPS.
+
+## Note de convention
+Rapport écrit dans `05_deliverables_mvp/daily_reports/` (chemin canonique fixé roadmap l.92 + session précédente) plutôt que `05_activity_log/`, pour éviter un doublon (workflow #5).
+
+## Prochaine tâche suggérée
+- QA S1 : fichiers Playwright baseline (`tests/e2e/`) — authorables en-repo, exécution différée VPS.
+- Ou Faisabilité S2/S3 : scaffold doc du générateur 4 volets automatique consommant le template v1.0.
+- Ou Publiciste S2 : scaffold doc `otoia/capabilities/publiciste.py` (seul module net-neuf, chemin critique).
+
+---
+
+**Auto-score 4Big du livrable CI/CD : 96/100.** Réserve −4 : runner Gitea à enregistrer sur VPS (DevOps) avant exécution serveur ; scripts validés localement.
+
+---
+
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 2)
+
+**Session** : `20260730_005632`
+
+## Tâche exécutée
+**Sprint 1 · Livrable QA « Baseline Playwright »**
+(roadmap §Sprint 1 · `GAP_ANALYSIS_SPRINT1` §7 = `☐ à faire` · suggérée par la session 1).
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, `GAP_ANALYSIS_SPRINT1.md`, daily report session 1, `AGENT.md` QA, spec `CHOISIR_MON_UNITE`, `ci/ci.yml`.
+- **2 critères de sortie Sprint 1 restants** (§7) : (a) **Baseline Playwright** — 100 % authorable en-repo, exécution différée VPS ; (b) Cartographie DocTypes `otov7_platform` — **nécessite le VPS → hors périmètre worker**.
+- Priorité évidente : **Baseline Playwright** (seul critère S1 restant autorable sans toucher la prod).
+
+## Réalisé
+- Projet Playwright **auto-contenu** sous `tests/` :
+  - `tests/e2e/routes.json` — data-contract des 4 endpoints Sprint 1 (`/waf-home`, `/crm`, `/qa`, `/choisir-mon-unite`) avec flag `gated`.
+  - `tests/e2e/smoke.spec.ts` — **data-driven** : 4 contrôles/route → status < 400 · HTML titré + `<html lang>` · **brand luxury** (`#0a0a12`/`#f0b429` + Fraunces/Cormorant dans le CSS servi) · zéro erreur JS/5xx.
+  - `tests/e2e/_shared/contract.ts` — tokens de marque (CLAUDE.md #4) + helpers (reachable, détection mur de login, collecte surface CSS).
+  - `tests/playwright.config.ts` — **cible via `DTP_BASE_URL`** (aucune URL codée en dur) · chromium + mobile-safari (acheteurs mobiles) · reporters list/html/junit.
+  - `tests/package.json`, `tests/tsconfig.json`, `tests/.gitignore`, `tests/README.md`.
+- **CI** : ajout d'un job `e2e-baseline` **manuel** (`workflow_dispatch`) dans `.gitea/workflows/ci.yml` — hors du gate push/PR (exige serveur live + navigateurs), upload artefact rapport. Reste **Gitea Actions uniquement** (contrainte #2).
+- **Zéro invention (#6)** : aucun prix/superficie/dispo asserté — santé + brand uniquement. Routes `gated` non authentifiées : brand annoté + sauté, pas échoué (baseline tolérante).
+
+## Bug corrigé (gate rouge sur `main`)
+- Constat : le gate CI **échouait déjà sur HEAD** (exit 1) — le daily report session 1 (l.26) citait les deux plateformes interdites en prose pour décrire le test négatif du guard, sans marqueur de prohibition reconnu par l'heuristique → **faux positif du guard sur sa propre doc**. <!-- ci-allow : méta-description du correctif, aucun usage réel -->
+
+- Correctif : escape hatch documenté `ci-allow` ajouté sur la ligne concernée (mécanisme prévu à cet effet). Gate **repassé au vert**.
+
+## Vérifications effectuées (en-repo, sans toucher au VPS)
+- `routes.json` : JSON valide (parse strict).
+- `ci.yml` : YAML valide.
+- **Les 3 scripts du gate** (`guard_constraints.sh`, `validate_json.sh`, `check_docs.sh`) → **exit 0** (vert) après correctif.
+- Confirmé que le gate rouge **préexistait** à mes changements (`git stash` → guard exit 1 sur HEAD).
+
+## Non fait (hors périmètre worker · touche au VPS)
+- Exécution réelle de la baseline (`npm install` + `playwright install` + `npm test`) → runner Gitea + `DTP_BASE_URL` sur VPS (DevOps · `ci/README.md §4`).
+- Cartographie DocTypes `otov7_platform` (dernier critère S1) → ERPNext Backend sur VPS.
+
+## Prochaine tâche suggérée
+- **Sprint 1 quasi bouclé** : ne reste que la cartographie DocTypes (VPS · ERPNext) + confirmation runner/endpoints (VPS · DevOps/QA).
+- Sinon démarrer S2 en-repo : scaffold doc `otoia/capabilities/publiciste.py` (seul module net-neuf, chemin critique) **ou** spec RBAC 50 rôles (ERPNext S2).
+
+---
+
+**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).
+
+---
+
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 4)
+
+**Session** : `20260730_015634`
+
+## Tâche exécutée
+**Sprint 2 · Livrable ERPNext Backend « RBAC 50 rôles »**
+(roadmap `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` §Sprint 2 l.38 · `GAP_ANALYSIS_SPRINT1` §3.4 · suggérée par session 3).
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, `GAP_ANALYSIS_SPRINT1.md`, daily reports sessions 1-3, `AGENT.md` ERPNext Backend + Frontend Console, `AGENTS_EXISTING_ASSETS.md` §4-6, `projets_master.schema.json`, `validator.py`, `ci.yml`.
+- **Sprint 1 bouclé côté repo** ; Sprint 2 : 3 deliverables. Frontend (clone 5 entités) + CRM (pipeline) dépendent des layouts LIVE `/waf-home` / `/crm.html` (VPS). **RBAC 50 rôles = seul deliverable S2 100 % autorable en-repo** comme spec de conception machine-lisible → priorité évidente. Dépendance amont des 5 portails rôle (S4) et du workflow vente.
+
+## Réalisé — module `05_deliverables_mvp/rbac/`
+- `rbac.schema.json` — contrat JSON-Schema draft-07 (sous-ensemble supporté par le validateur maison, **zéro pip**) : 50 rôles, `id` kebab, `erpnext_role_name` préfixe `OTO `, `permissions_cibles[]` (DocType + verbes Frappe), `scope_donnees` (own/equipe/entite/groupe), `cible_rbac_roles` const 50.
+- `rbac_50_roles.json` — **50 rôles** répartis sur 5 portails métier (roadmap S4) + 1 console technique (`plateforme`), mappés aux **entités CLAUDE.md** (WAF/WA SRL/AC Arias Cuevas/Consortium ECR DR/Helios RD/Ploutos/9060 QC/Groupe). Permissions ciblant des **DocTypes ERPNext v15 natifs** (Lead/Opportunity/Quotation/Sales Order/Purchase Order/Journal Entry/Salary Slip…) + DocTypes DTP marqués `custom: true` (à confirmer VPS).
+- `RBAC_50_ROLES_SPEC.md` — design : modèle RBAC 3 niveaux (Role · DocPerm · User Permission), cartographie portails/familles/entités, conformité contraintes #1/#3/#6/#8, **séparation des pouvoirs** (`set_user_permissions` réservé au RBAC Admin), procédure d'application VPS (fixtures `bench`, hors périmètre worker).
+- `tests/test_rbac.py` — **10 tests `unittest` (stdlib)** : **réutilise le validateur Publiciste** (pas de duplication · workflow #5) + oracle `jsonschema` si présent ; vérifie exactement 50 rôles, unicité `id`/nom Frappe, couverture des 5 portails, anti-élévation de privilège.
+- **CI** : job `rbac-tests` ajouté au **gate** de `.gitea/workflows/ci.yml` (Gitea Actions uniquement · #2).
+- `GAP_ANALYSIS_SPRINT1.md` §3.4 mis à jour (RBAC design livré S2).
+
+## Anti-invention (#6) appliqué
+- **Aucun chiffre/plafond monétaire inventé** : seuls rôles, entités et DocTypes natifs. Plafonds d'approbation volontairement non chiffrés (à définir avec la Direction sur pièces).
+- DocTypes non natifs marqués `custom: true` → **existence à confirmer VPS** avant application (respect de l'interdit « documenter code sans vérifier existence courante »).
+
+## Vérifications effectuées (en-repo, sans toucher au VPS)
+- **10/10 tests RBAC verts** (schéma maison **+** oracle `jsonschema` installé → concordance draft-07 confirmée).
+- **Gate CI local vert (exit 0)** : `guard_constraints.sh`, `validate_json.sh` (inclut `rbac_50_roles.json`), `check_docs.sh` (0 lien cassé ; spec RBAC porte son auto-score 4Big).
+- **Régression** : 23/23 tests Publiciste toujours verts (réutilisation du validateur sans effet de bord).
+
+## Non fait (hors périmètre worker · touche au VPS)
+- Génération + application des **fixtures `Role`/`Custom DocPerm`** sur `erpnext-backend-1` (`bench migrate`) → agent ERPNext Backend.
+- Création des DocTypes DTP `custom` (`Faisabilité`, `Publiciste Log`, `CONFOTUR Application`, `API Access`) après confirmation VPS.
+- Mapping `scope_donnees` → `User Permission` par utilisateur → VPS.
+- Cartographie DocTypes réels `otov7_platform` (dernier critère S1) → ERPNext sur VPS.
+
+## Prochaine tâche suggérée
+- ERPNext S2 : **générateur de fixtures** `rbac_50_roles.json → fixtures/` (même patron que le Publiciste, autorable en-repo).
+- Ou Faisabilité S2 : générateur 4 volets auto consommant le template v1.0 (produit les `data_room/PXX/` consommés par le parser Publiciste).
+- Ou Frontend/CRM S2 : nécessite les layouts LIVE (VPS) → hors périmètre worker.
+
+---
+
+**Auto-score 4Big du livrable RBAC 50 rôles : 95/100.** Réserve −5 : application fixtures + DocTypes `custom` + `User Permission` = côté VPS (agent ERPNext, hors périmètre) ; plafonds monétaires non chiffrés (anti-invention #6). Validé statiquement en-repo (10 tests verts + schéma conforme + gate CI vert).
+
+---
+
+# Daily Report · 2026-07-30 · Claude Code DTP Worker (session 5)
+
+**Session** : `20260730_022639`
+
+## Tâche exécutée
+**Sprint 2 · Livrable Faisabilité « Générateur 4 volets automatique »**
+(roadmap `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` §Sprint 2/3 · `03_agents/faisabilite/AGENT.md` §Livrable S2 · `GAP_ANALYSIS_SPRINT1` §2 · suggérée par sessions 3-4).
+
+## Contexte / analyse
+- Relu `CLAUDE.md`, `ROADMAP_8_WEEKS_OR_LESS.md`, `GAP_ANALYSIS_SPRINT1.md`, daily reports sessions 1-4, `AGENT.md` Faisabilité, template canonique v1.0 + `version.schema.json`, **parser Publiciste** (`lib/parser.py`) + `publiciste.py`.
+- **Sprint 1 bouclé côté repo** ; Sprint 2 : RBAC (session 4) + Publiciste parser (session 3) livrés. Frontend/CRM dépendent des layouts LIVE (VPS · hors périmètre).
+- Priorité évidente : **Générateur Faisabilité 4 volets** — sur le **chemin critique**, produit les `data_room/PXX/` que le parser Publiciste (déjà livré) consomme. **Ferme la boucle de valeur** et 100 % autorable en-repo (zéro API, zéro VPS). Vérifiable end-to-end : générateur → parser → schéma.
+
+## Réalisé — module `05_deliverables_mvp/faisabilite/generator/`
+- `genlib/model.py` — constantes **canoniques** (3 %/8.5 %/52 % · USD+DOP · Cardnet · Letter US · #9/#10, **imposées, jamais issues du brief**) + tables des champs 🔴 par volet + `is_filled()` (détecte placeholders/absences).
+- `genlib/scorer.py` — **barème 4Big §7** (5 axes × 20) : complétude, anti-gap prix (§3.2), traçabilité (`sources[]` + taux daté/sourcé), paramètres canoniques, machine-lisible. Dérive `statut_faisabilite` / `volets_complets` / `champs_manquants` cohérents avec la contrainte `allOf` de `version.schema.json`.
+- `genlib/renderer.py` — rend les 4 volets + brief + commercial + manifeste photos + `_META/version.json`, avec **en-têtes/colonnes exactement alignés sur le parser Publiciste** (garantit le round-trip). Champ absent → placeholder `{{…}}` (**jamais de chiffre inventé · #6**).
+- `faisabilite_gen.py` — CLI `score` / `scaffold` / `generate` / `batch`. L'axe machine-lisible n'est **pas auto-décerné** : après génération, le CLI **re-parse** le projet avec le parser Publiciste + **valide** `version.json` → en cas d'échec, retire les 20 pts, réécrit `version.json`, sort en erreur.
+- `brief.schema.json` (contrat d'entrée) + `fixtures/` **synthétiques** (`brief_complete.json` → complete 100/100 ; `brief_incomplete.json` → prix absents → rétrogradation `en_developpement`, prix restés placeholders).
+- `tests/test_generator.py` — **16 tests `unittest` (stdlib pur, zéro pip)** : scoring, rétrogradation défensive, paramètres canoniques, et **round-trip end-to-end** generator → parser Publiciste → `projets_master.json` validé contre le schéma. **Réutilise** parser + validateur Publiciste (aucune duplication · workflow #5) + oracle `jsonschema` si présent.
+- **CI** : job `faisabilite-gen-tests` ajouté au **gate** de `.gitea/workflows/ci.yml` (Gitea Actions uniquement · #2).
+- `README.md` + `.gitignore` ; `GAP_ANALYSIS_SPRINT1.md §2` mis à jour (générateur livré S2).
+
+## Anti-invention (#6) appliqué
+- Paramètres canoniques émis par le générateur (jamais du brief) → impossibles à fausser projet par projet.
+- Tout 🔴 absent → placeholder + `champs_manquants` + rétrogradation ; prix manquant → `{{…}}` (jamais `0`).
+- Fixtures **clairement synthétiques** (`"synthetique": true` + bannière « ne jamais publier »).
+
+## Vérifications effectuées (en-repo, sans toucher au VPS)
+- **16/16 tests verts** (schéma maison **+** oracle `jsonschema` → concordance draft-07 confirmée).
+- **Pipeline complet démontré en CLI** : `batch fixtures` → `data_room/{P01,P02}/` → **Publiciste `run`** → `projets_master.json` (2 projets : P01 `disponible`/3 typo, P02 `en_developpement`/2 typo) + `index.html`. Round-trip cohérent de bout en bout.
+- **Gate CI local vert (exit 0)** : `guard_constraints.sh`, `validate_json.sh` (inclut `brief.schema.json` + fixtures), `check_docs.sh` (0 lien cassé), YAML `ci.yml` valide.
+- **Régression** : 23/23 tests Publiciste + 10/10 tests RBAC toujours verts (réutilisation sans effet de bord).
+
+## Non fait (hors périmètre worker · VPS ou calendrier ultérieur)
+- Génération contre les **briefs réels** P01-P09 (VPS · Faisabilité) — régénération batch des 7 faisabilités = **S4**.
+- `40_llm_outputs/` marché/directeur/fiscal/juridique + rapports bancables FR/EN/ES + archives auto `_ARCHIVES/` (S3+).
+- Trigger `otoia-faisabilite.timer` + notification Publiciste/WhatsApp (S6 · VPS).
+
+## Prochaine tâche suggérée
+- Faisabilité S3 : générer les `40_llm_outputs/` + rapports bancables FR/EN/ES depuis le brief (étend le renderer).
+- Ou ERPNext S2 : générateur de fixtures `rbac_50_roles.json → fixtures/` (même patron, autorable en-repo).
+- Ou Publiciste S3 : brancher le generator HTML sur un layout proche de `/waf-home` (dépend layout LIVE · VPS).
+
+---
+
+**Auto-score 4Big du livrable Générateur Faisabilité : 96/100.** Réserve −4 : exécution contre les briefs réels P01-P09 différée (VPS · S4) ; `40_llm_outputs`/bancables/archives = livrables S3+. Validé statiquement en-repo (16 tests verts + round-trip end-to-end démontré + gate CI vert).

05_deliverables_mvp/faisabilite/TEMPLATE_FAISABILITE_CANONIQUE_v1.0.md

@@ -0,0 +1,231 @@
+# Template Faisabilité Canonique · v1.0
+
+> **Livrable Sprint 1** (roadmap `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md`, ligne 41-46 · AGENT.md Faisabilité §Livrable S1)
+> _« S1 : Template canonique v1.0 finalisé + agent scaffold »_
+>
+> **Date** : 2026-07-29 · **Auteur** : Claude Code DTP Worker · **Version template** : `1.0.0`
+> **Statut** : CANONIQUE — toute faisabilité en production DOIT s'y conformer.
+
+---
+
+## 0. Raison d'être
+
+Ce document **fixe le modèle canonique unique** des faisabilités 4 volets. Il répond au
+**GAP ACTIF PRIORITAIRE** identifié à l'audit du 2026-07-29 (`GAP_ANALYSIS_SPRINT1.md` §3.2 ·
+`03_agents/faisabilite/AGENT.md` §Gap) :
+
+- ✅ P01, P08, P09 : prix documentés dans `commercial.md`.
+- ⚠️ **P02, P03, P05, P07** : « prix non défini » / « typologie non fournie » — faisabilités
+  hétérogènes générées avec des templates différents/anciens.
+
+**Cause racine** : absence de template versionné avec champs obligatoires. **Ce template = la correction.**
+
+### Contraintes CLAUDE.md respectées par ce template
+- **#6 Zéro invention de chiffres** → le template ne contient **AUCUN chiffre projet**, uniquement
+  des **placeholders** `{{…}}` et des champs à remplir depuis les sources archives.
+- **#7 Standards 4 volets** → structure obligatoire Masterplan · Architecture · Paysage-Expérience · Ingénierie.
+- **#5 Score ≥ 95/100** → §7 checklist de conformité 4Big obligatoire avant publication.
+- **#9 Paramètres financiers** → frais édition doc **3 %** · marketing **8.5 %** · point d'équilibre **52 %** pré-vente.
+- **#10 Devises** → **USD + DOP** · format **Letter US** · paiements **Cardnet**.
+
+---
+
+## 1. Arborescence canonique (obligatoire pour tout projet PXX)
+
+```
+data_room/PXX/
+├── _META/
+│   └── version.json              ← version template + score qualité + horodatage (schéma §6)
+├── 00_brief/
+│   └── brief.md                  ← contexte, localisation, terrain, programme
+├── 10_masterplan/                ← VOLET 1 (§2)
+│   └── masterplan.md
+├── 20_architecture/              ← VOLET 2 (§3)
+│   └── architecture.md
+├── 30_paysage_experience/        ← VOLET 3 (§4)
+│   └── paysage_experience.md
+├── 40_ingenierie_faisabilite/    ← VOLET 4 (§5)
+│   └── ingenierie_faisabilite.md
+├── 40_llm_outputs/               ← analyses AI (source Publiciste)
+│   ├── commercial.md             ← ⚠️ prix + typologies OBLIGATOIRES (§3.2, §5.3)
+│   ├── marche_analyste.md
+│   ├── directeur.md
+│   ├── fiscal.md
+│   └── juridique.md
+├── 50_financier_bancable/
+│   ├── one_pager_banquier.md     ← one-pager (source Publiciste #1)
+│   ├── rapport_bancable_fr.md
+│   ├── rapport_bancable_en.md
+│   └── rapport_bancable_es.md
+└── 60_photos_site/               ← rendus (lien projet réel obligatoire — ❌ IA générique)
+    └── README.md                 ← manifeste des rendus (source, date, vue)
+```
+
+> **Règle d'homogénéité** : chaque `PXX/` DOIT contenir **exactement** ces répertoires. Un répertoire
+> vide reste présent avec un `.gitkeep` ou un fichier `TODO.md` expliquant la donnée manquante.
+
+---
+
+## 2. VOLET 1 · Masterplan (`10_masterplan/masterplan.md`)
+
+Champs **obligatoires** (marqués 🔴) et recommandés (🟡) :
+
+| # | Champ | Oblig. | Description | Placeholder |
+|---|---|---|---|---|
+| 1.1 | Localisation | 🔴 | Province · municipalité · coordonnées | `{{localisation}}` |
+| 1.2 | Superficie terrain | 🔴 | m² + tareas (unité DR) | `{{terrain_m2}}` / `{{terrain_tareas}}` |
+| 1.3 | Zonage / usage | 🔴 | Résidentiel · touristique · mixte | `{{zonage}}` |
+| 1.4 | Densité programme | 🔴 | Nb unités totales · phases | `{{nb_unites}}` / `{{nb_phases}}` |
+| 1.5 | Emprise au sol / COS | 🟡 | Ratio bâti/terrain | `{{cos}}` |
+| 1.6 | Accès & mobilité | 🟡 | Routes · distances aéroport/plage | `{{acces}}` |
+| 1.7 | Plan de masse | 🟡 | Référence fichier plan | `{{ref_plan_masse}}` |
+| 1.8 | Phasage développement | 🔴 | Séquence de mise en marché | `{{phasage}}` |
+
+**Sortie attendue** : plan de masse cohérent avec le brief, densité justifiée, phasage aligné sur le point d'équilibre 52 %.
+
+---
+
+## 3. VOLET 2 · Architecture (`20_architecture/architecture.md`)
+
+### 3.1 Champs généraux
+
+| # | Champ | Oblig. | Description | Placeholder |
+|---|---|---|---|---|
+| 2.1 | Parti architectural | 🔴 | Style · matérialité · signature | `{{parti_archi}}` |
+| 2.2 | Nb de bâtiments / blocs | 🔴 | | `{{nb_batiments}}` |
+| 2.3 | Niveaux (étages) | 🔴 | | `{{nb_niveaux}}` |
+| 2.4 | Rendus référence | 🟡 | Lien `60_photos_site/` (❌ IA générique) | `{{ref_rendus}}` |
+
+### 3.2 Tableau des typologies — 🔴 **BLOC ANTI-GAP (obligatoire, cause du gap P02/P03/P05/P07)**
+
+> Ce tableau DOIT être renseigné à 100 %. Une cellule « non défini » = faisabilité **INCOMPLÈTE**
+> → le Publiciste marque le projet « En développement » (jamais publier de prix inventé).
+
+| Typologie | Nb unités | Surface intérieure (m²) | Surface terrasse (m²) | Surface totale (m²) | Prix « à partir de » (USD) | Prix (DOP) |
+|---|---|---|---|---|---|---|
+| `{{typo_1_nom}}` | `{{typo_1_qte}}` | `{{typo_1_int}}` | `{{typo_1_terrasse}}` | `{{typo_1_total}}` | `{{typo_1_prix_usd}}` | `{{typo_1_prix_dop}}` |
+| `{{typo_2_nom}}` | `{{typo_2_qte}}` | … | … | … | … | … |
+| … | … | … | … | … | … | … |
+
+**Règle prix** : toujours format `USD X,XXX + DOP` (contrainte #10). Le taux de conversion utilisé
+DOIT être daté et sourcé (jamais inventé — contrainte #6).
+
+---
+
+## 4. VOLET 3 · Paysage & Expérience (`30_paysage_experience/paysage_experience.md`)
+
+| # | Champ | Oblig. | Description | Placeholder |
+|---|---|---|---|---|
+| 3.1 | Concept paysager | 🔴 | Végétation · eau · circulations douces | `{{concept_paysage}}` |
+| 3.2 | Amenities / équipements | 🔴 | Piscine · spa · gym · beach club · etc. | `{{amenities}}` |
+| 3.3 | Services inclus | 🔴 | Conciergerie · sécurité · gestion locative | `{{services_inclus}}` |
+| 3.4 | Expérience résident/investisseur | 🟡 | Parcours d'usage · storytelling | `{{experience}}` |
+| 3.5 | Durabilité / environnement | 🟡 | Énergie · eau · certifications | `{{durabilite}}` |
+
+**Sortie attendue** : liste « ce qui est inclus » exploitable directement par le Publiciste (mapping `inclus[]` du schéma §6.2).
+
+---
+
+## 5. VOLET 4 · Ingénierie & Faisabilité (`40_ingenierie_faisabilite/ingenierie_faisabilite.md`)
+
+### 5.1 Technique
+
+| # | Champ | Oblig. | Description | Placeholder |
+|---|---|---|---|---|
+| 4.1 | Systèmes structurels | 🟡 | Béton · acier · fondations | `{{structure}}` |
+| 4.2 | Réseaux (eau/élec/eaux usées) | 🟡 | | `{{reseaux}}` |
+| 4.3 | Contraintes site | 🟡 | Topographie · sol · risques | `{{contraintes_site}}` |
+
+### 5.2 Financier bancable — 🔴 (paramètres canoniques CLAUDE.md #9)
+
+| # | Champ | Oblig. | Valeur canonique / placeholder |
+|---|---|---|---|
+| 4.4 | Coût de construction total | 🔴 | `{{cout_construction}}` USD |
+| 4.5 | Frais d'édition documentaire | 🔴 | **3 %** (fixe · contrainte #9) |
+| 4.6 | Budget marketing | 🔴 | **8.5 %** (fixe · contrainte #9) |
+| 4.7 | Point d'équilibre pré-vente | 🔴 | **52 %** (fixe · contrainte #9) |
+| 4.8 | Revenu brut de vente projeté | 🔴 | `{{revenu_brut}}` USD |
+| 4.9 | Marge projetée | 🔴 | `{{marge}}` % |
+| 4.10 | Devises | 🔴 | **USD + DOP** (contrainte #10) |
+| 4.11 | Moyen de paiement | 🔴 | **Cardnet** (❌ Stripe · contrainte #10) |
+| 4.12 | Format documents | 🔴 | **Letter US** (contrainte #10) |
+| 4.13 | Régime fiscal | 🟡 | CONFOTUR · Fideicomiso (voir volet juridique) | `{{regime_fiscal}}` |
+
+### 5.3 Cohérence commercial.md (verrou anti-gap)
+
+Le fichier `40_llm_outputs/commercial.md` DOIT reprendre **sans divergence** le tableau des typologies
+(§3.2) et les prix « à partir de ». Toute mention « prix non défini » / « typologie non fournie »
+constitue un **échec de conformité** bloquant la publication.
+
+---
+
+## 6. Schémas machine (versioning + extraction Publiciste)
+
+### 6.1 `_META/version.json`
+Voir fichier de schéma : [`version.schema.json`](./version.schema.json).
+Exemple minimal :
+```json
+{
+  "projet": "P07",
+  "template_version": "1.0.0",
+  "generated_at": "2026-07-29T00:00:00Z",
+  "score_4big": 96,
+  "statut_faisabilite": "complete",
+  "volets_complets": ["masterplan", "architecture", "paysage_experience", "ingenierie"],
+  "champs_manquants": []
+}
+```
+
+### 6.2 Contrat d'extraction Publiciste
+Voir fichier de schéma : [`projets_master.schema.json`](./projets_master.schema.json).
+C'est le contrat que le **Publiciste Agent** (`otoia/capabilities/publiciste.py`) consomme pour
+générer `vente.otov7.com`. Si `statut_faisabilite != "complete"`, le projet est publié en
+**« En développement »** (jamais de prix inventé — contrainte #6).
+
+---
+
+## 7. Checklist de conformité 4Big (≥ 95/100 · obligatoire avant publication)
+
+Barème (20 pts × 5 axes = 100) :
+
+| Axe | Critère | Pts | ✅/❌ |
+|---|---|---|---|
+| **Complétude** | Les 4 volets présents + champs 🔴 remplis à 100 % | 20 | ☐ |
+| **Anti-gap prix** | Tableau typologies §3.2 complet · aucun « non défini » | 20 | ☐ |
+| **Traçabilité** | Chaque chiffre sourcé (archive/brief) · zéro invention (#6) | 20 | ☐ |
+| **Paramètres canoniques** | 3 % / 8.5 % / 52 % · USD+DOP · Letter US · Cardnet présents | 20 | ☐ |
+| **Machine-lisible** | `version.json` valide + extraction Publiciste OK | 20 | ☐ |
+
+**Règle** : score < 95 → faisabilité **NON publiable**, retour Faisabilité Agent. Validation finale par **QA Agent**.
+
+---
+
+## 8. Cycle de vie & versioning
+
+- **Version template** : `MAJOR.MINOR.PATCH` (SemVer). v1.0.0 = présent document.
+- **Bump MINOR** = nouveau champ recommandé / ajustement non bloquant → régénération recommandée.
+- **Bump MAJOR** = nouveau champ 🔴 obligatoire → **régénération batch des 7 faisabilités obligatoire** (S4).
+- Chaque bump archive l'ancienne version projet dans `_ARCHIVES/PXX_v{N}_YYYYMMDD/` (AGENT.md §Workflow).
+- Trigger d'update détecté sur `capabilities/knowledge/faisabilite_4_volets_standard.md` (S6).
+
+## 9. Traçabilité sprint
+
+| Sprint | Livrable Faisabilité | Ce document |
+|---|---|---|
+| **S1** | Template canonique v1.0 + scaffold | ✅ **présent** + schémas §6 |
+| S2 | Générateur 4 volets auto | consomme ce template |
+| S4 | Régénération batch P01-P09 | applique §7 + §8 (MAJOR) |
+| S5 | Validation 4Big ≥ 95/100 | applique §7 |
+
+---
+
+## 10. Auto-évaluation 4Big de ce livrable
+
+- Structure 4 volets complète + arborescence canonique : ✅
+- Bloc anti-gap prix/typologies (cause racine P02/P03/P05/P07) traité : ✅
+- Paramètres financiers canoniques CLAUDE.md intégrés (3/8.5/52 · USD+DOP · Cardnet · Letter US) : ✅
+- Schémas machine versionnés (`version.json` + contrat Publiciste) : ✅
+- Zéro chiffre inventé — placeholders uniquement (#6) : ✅
+
+**Auto-score : 96/100.** _Réserve −4_ : validation finale QA + confrontation aux données réelles
+`data_room/` (VPS, hors périmètre de ce repo) avant marquage « vérifié 100 % ».

05_deliverables_mvp/faisabilite/bancable/.gitignore

@@ -0,0 +1,4 @@
+# Sorties re-générables à la demande (jamais commitées — data_room construit).
+out/
+**/__pycache__/
+*.pyc

05_deliverables_mvp/faisabilite/bancable/README.md

@@ -0,0 +1,114 @@
+# Générateur de dossier financier bancable trilingue FR/EN/ES · Sprint 3
+
+> Livrable **Faisabilité · Sprint 3** — roadmap
+> [`ROADMAP_8_WEEKS_OR_LESS.md`](../../../04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md)
+> §Sprint 3 (« `40_llm_outputs/` + rapports bancables FR/EN/ES »).
+
+Remplit le répertoire `50_financier_bancable/` d'une data_room — jusqu'ici **vide**
+(`.gitkeep` posé par le générateur 4 volets) — que le **Portail Bancables 4Big**
+([`PORTAIL_BANCABLES_4BIG.md`](../../../PORTAIL_BANCABLES_4BIG.md), variante 06
+retenue par Michel) exige à l'**étape 1** de son workflow de déploiement projet
+(« Placer les PDFs dans `…/50_financier_bancable/` (FR/EN/ES) »).
+
+## Place dans la chaîne de valeur
+
+```
+brief.json ─► faisabilite_gen ─► data_room/PXX/  (4 volets · template v1.0)
+                                     │
+                     bancable_gen ───┤  (ce module · MÊME brief)
+                                     ▼
+        data_room/PXX/50_financier_bancable/{fr,en,es}.md + manifest.json
+                                     │
+                                     ▼ (VPS · hors périmètre worker · #8)
+        PDFs FR/EN/ES ─► Portail Bancables 4Big (privé · noindex)
+```
+
+Le module **ferme le dernier trou** de la faisabilité auto : les 4 volets étaient
+produits et notés, mais le dossier **financier bancable** (l'artefact que voit le
+banquier) restait à écrire à la main, en trois langues. Il consomme le **même
+`brief.json`** que le générateur 4 volets — une seule source, zéro re-saisie.
+
+## Trois langues imposées
+
+`PORTAIL_BANCABLES_4BIG.md` : « Boutons langues **FR 🇨🇦 · EN 🇺🇸 · ES 🇩🇴** ». Le
+générateur produit systématiquement les trois. Les **libellés** de gabarit sont
+des traductions **fixes** ([`banclib/i18n.py`](banclib/i18n.py)) ; seules les
+**chaînes libres** (positionnement commercial) proviennent du brief, langue par
+langue (`commercial.positionnement_{fr,en,es}`). Une langue de positionnement
+absente reste un placeholder `{{positionnement_en}}` — **jamais traduite
+automatiquement** (ce serait une invention · #6).
+
+## Anti-invention (#6) — deux tiers, tous deux traçables
+
+| Tier | Contenu | Garantie |
+|---|---|---|
+| **Sourcé** (verbatim) | coût construction, revenu brut, marge, taux, prix par typologie | Repris tel quel du brief. Champ absent ⇒ placeholder `{{…}}`, **jamais 0 fabriqué**. |
+| **Calculé** (traçable) | Σ unités · valeur catalogue USD/DOP · point d'équilibre en unités | Chaque valeur **publie sa formule** ; **tous** ses opérandes sont sourcés/canoniques. Opérande manquant ⇒ valeur `null` + champ listé. |
+
+> **Calcul transparent ≠ invention.** Un agrégat dont la formule et les opérandes
+> sont publiés est *auditable* — l'invention, c'est un chiffre sans source. Le CLI
+> **recalcule indépendamment** les 4 agrégats et refuse d'écrire s'ils divergent
+> du manifeste (`_check_derived_arithmetic`).
+
+**Aucun montant n'est calculé sur une base non documentée.** Les pourcentages
+« 3 % édition » et « 8.5 % marketing » (#9) sont rendus comme **taux canoniques**
+(verbatim), jamais multipliés par une base supposée — la base n'étant pas
+documentée, la choisir serait une hypothèse inventée. Seuls le point d'équilibre
+en unités (`52 % × nb_unités`) et les agrégats de catalogue (`Σ quantité × prix`),
+dont la base est explicite et sourcée, sont calculés.
+
+## Confidentialité
+
+Le Portail Bancables est **privé** (`noindex`). Chaque `.md` porte en tête la
+bannière **CONFIDENTIEL** ; une fixture `synthetique:true` porte en plus
+l'avertissement « ne jamais publier » (#6) et son manifeste est `publiable:false`.
+
+## Utilisation
+
+```bash
+# Écrit DATA_ROOM/P01/50_financier_bancable/{fr,en,es}.md + manifest.json
+python3 bancable_gen.py build fixtures/brief_bancable.json -o out
+
+# Manifeste + invariants sans rien écrire (schéma + recalcul des agrégats)
+python3 bancable_gen.py validate fixtures/brief_bancable.json
+
+# Tests (stdlib pur, zéro pip · oracle jsonschema si présent)
+python3 -m unittest discover -s tests -v
+```
+
+## Ce qui est généré (`out/` non commité)
+
+| Fichier | Rôle |
+|---|---|
+| `50_financier_bancable/fr.md` · `en.md` · `es.md` | Dossier bancable print-ready (pré-PDF), une langue. |
+| `50_financier_bancable/manifest.json` | Vue machine-lisible : figures sourcées + calculées (avec formule), langues, `publiable`, `champs_manquants` — conforme à [`bancable.schema.json`](bancable.schema.json). |
+
+## Garde-fous (le CLI refuse d'écrire si un invariant casse)
+
+- Manifeste conforme à `bancable.schema.json` (validateur **maison** Publiciste,
+  zéro pip · oracle `jsonschema` en test si présent).
+- Exactement **3 langues** `fr/en/es`, chacune rendue, chacune avec la bannière
+  **CONFIDENTIEL**.
+- **Recalcul indépendant** des 4 agrégats == manifeste (anti-figure-posée).
+- Une fixture **synthétique** ne peut pas être `publiable` ; aucun littéral
+  `None` Python ne fuit dans un rendu.
+- `publiable ⇒` trio coût/revenu/marge présent + au moins une typologie tarifée.
+- Sortie **déterministe** (pas d'horodatage sauf `--generated-at`) → diffable,
+  re-générable bit-à-bit en CI.
+
+## Vérification en-repo
+
+- `python3 -m unittest discover -s tests -v` → **22/22 verts** (finance, rendu
+  trilingue, schéma maison + oracle, invariants CLI, déterminisme).
+- Génération réelle (fixture) : 3 langues + manifeste · 40 unités · valeur
+  catalogue USD 8,560,000 / DOP 505,040,000 · point d'équilibre 21 unités
+  (⌈52 % × 40⌉) — **toutes formules recoupées**.
+- Job CI dédié `bancable-tests` ajouté au **gate** (`.gitea/workflows/ci.yml`,
+  Gitea Actions uniquement · #2).
+
+## Auto-score 4Big du livrable : **96/100**
+
+_Réserve −4_ : la conversion PDF (pandoc/wkhtmltopdf) + le rebuild du Portail
+Bancables restent côté VPS (agent DevOps/Frontend, hors périmètre worker · #8).
+Validé statiquement en-repo (22 tests verts + manifeste conforme + recoupement
+arithmétique des agrégats + gate CI).

05_deliverables_mvp/faisabilite/bancable/bancable.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://oto.dtp/schemas/faisabilite/bancable.schema.json",
+  "title": "Manifeste du dossier financier bancable trilingue",
+  "description": "Vue machine-lisible du dossier bancable FR/EN/ES d'un projet. Toute valeur numérique absente est null (jamais 0-inventé · CLAUDE.md #6). Les figures calculées portent leur formule (traçabilité). Sous-ensemble draft-07 supporté par le validateur maison Publiciste (zéro pip).",
+  "type": "object",
+  "required": ["projet", "template_version", "langues", "synthetique", "publiable", "figures_sourcees", "figures_calculees", "typologies_count", "champs_manquants", "fichiers"],
+  "additionalProperties": false,
+  "properties": {
+    "projet": { "type": "string", "pattern": "^P0[1-9]$" },
+    "template_version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+    "langues": {
+      "type": "array",
+      "minItems": 3,
+      "maxItems": 3,
+      "uniqueItems": true,
+      "items": { "type": "string", "enum": ["fr", "en", "es"] }
+    },
+    "synthetique": { "type": "boolean" },
+    "publiable": { "type": "boolean" },
+    "generated_at": { "type": "string", "format": "date-time" },
+    "figures_sourcees": {
+      "type": "object",
+      "required": ["cout_construction_usd", "revenu_brut_usd", "marge_pct", "taux_conversion"],
+      "additionalProperties": false,
+      "properties": {
+        "cout_construction_usd": { "type": ["number", "null"] },
+        "revenu_brut_usd": { "type": ["number", "null"] },
+        "marge_pct": { "type": ["number", "null"] },
+        "taux_conversion": {
+          "type": "object",
+          "required": ["taux", "date", "source"],
+          "additionalProperties": false,
+          "properties": {
+            "taux": { "type": ["number", "null"] },
+            "date": { "type": ["string", "null"] },
+            "source": { "type": ["string", "null"] }
+          }
+        }
+      }
+    },
+    "figures_calculees": {
+      "type": "array",
+      "minItems": 4,
+      "maxItems": 4,
+      "items": {
+        "type": "object",
+        "required": ["cle", "libelle", "formule", "valeur", "unite"],
+        "additionalProperties": false,
+        "properties": {
+          "cle": { "type": "string", "enum": ["total_unites", "valeur_catalogue_usd", "valeur_catalogue_dop", "point_equilibre_unites"] },
+          "libelle": { "type": "string", "minLength": 1 },
+          "formule": { "type": "string", "minLength": 1 },
+          "valeur": { "type": ["number", "null"] },
+          "unite": { "type": "string" }
+        }
+      }
+    },
+    "typologies_count": { "type": "integer", "minimum": 0 },
+    "champs_manquants": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "fichiers": {
+      "type": "array",
+      "minItems": 3,
+      "maxItems": 3,
+      "items": { "type": "string", "pattern": "^50_financier_bancable/(fr|en|es)\\.md$" }
+    }
+  }
+}

05_deliverables_mvp/faisabilite/bancable/bancable_gen.py

@@ -0,0 +1,225 @@
+#!/usr/bin/env python3
+"""Générateur de dossier financier bancable trilingue FR/EN/ES · Sprint 3.
+
+Livrable **Faisabilité · Sprint 3** (roadmap `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md`
+§Sprint 3 · « 40_llm_outputs/ + rapports bancables FR/EN/ES »). Remplit le
+répertoire `50_financier_bancable/` d'une data_room — jusqu'ici vide (`.gitkeep`)
+— que le **Portail Bancables 4Big** (`PORTAIL_BANCABLES_4BIG.md`, variante 06
+retenue par Michel) exige à l'étape 1 de son workflow de déploiement projet.
+
+Chaîne de valeur :
+
+    brief.json ─► faisabilite_gen ─► data_room/PXX/  (4 volets, template v1.0)
+                                          │
+                          bancable_gen ───┤  (ce module)
+                                          ▼
+                     data_room/PXX/50_financier_bancable/{fr,en,es}.md + manifest.json
+                                          │
+                                          ▼ (VPS · hors périmètre worker)
+                     PDFs FR/EN/ES ─► Portail Bancables 4Big (privé · noindex)
+
+Anti-invention (#6) : figures sourcées reprises verbatim ; agrégats calculés de
+façon TRAÇABLE (formule + opérandes sourcés publiés) ; aucun montant sur base non
+documentée ; tout champ absent reste placeholder `{{…}}` (jamais 0 fabriqué).
+
+⚠ Ce worker n'écrit JAMAIS sur le VPS (#8). Les .md sont produits en local ; la
+conversion PDF + le rebuild du portail restent côté serveur.
+
+Sous-commandes :
+  build     BRIEF.json -o DATA_ROOM   → DATA_ROOM/PXX/50_financier_bancable/*
+  validate  BRIEF.json                → manifeste + invariants (sans écrire)
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import math
+import os
+import sys
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, _HERE)
+
+from banclib import deps, finance, i18n, report  # noqa: E402
+
+
+def _eprint(*args) -> None:
+    print(*args, file=sys.stderr)
+
+
+def _load_schema() -> dict:
+    with open(os.path.join(_HERE, "bancable.schema.json"), encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+def _validate_projet(brief: dict) -> None:
+    code = brief.get("projet")
+    if not (isinstance(code, str) and len(code) == 3 and code[:2] == "P0"
+            and code[2] in "123456789"):
+        raise ValueError(f"brief.projet invalide (attendu P01..P09) : {code!r}")
+
+
+# --------------------------------------------------------------------------- #
+# Invariants — le CLI REFUSE d'écrire si l'un casse (honnêteté #6).
+# --------------------------------------------------------------------------- #
+def check_invariants(brief: dict, manifest: dict,
+                     files: dict[str, str]) -> list[str]:
+    motifs: list[str] = []
+
+    # (a) manifeste conforme au schéma (validateur maison).
+    errs = deps.validate(manifest, _load_schema())
+    motifs += [f"manifest: {e}" for e in errs]
+
+    # (b) exactement les 3 langues canoniques, chacune rendue.
+    if manifest["langues"] != ["fr", "en", "es"]:
+        motifs.append(f"langues != [fr,en,es] : {manifest['langues']}")
+    for lang in i18n.LANGS:
+        rel = f"50_financier_bancable/{lang}.md"
+        if rel not in files:
+            motifs.append(f"fichier langue manquant : {rel}")
+
+    # (c) chaque .md porte la bannière CONFIDENTIEL ; les synthétiques portent
+    #     aussi l'avertissement « ne jamais publier » (#6) et sont non publiables.
+    for lang in i18n.LANGS:
+        md = files.get(f"50_financier_bancable/{lang}.md", "")
+        if "CONFIDENTIEL" not in md and "CONFIDENTIAL" not in md \
+                and "CONFIDENCIAL" not in md:
+            motifs.append(f"{lang}.md : bannière CONFIDENTIEL absente")
+        if brief.get("synthetique"):
+            if "SYNTH" not in md.upper():
+                motifs.append(f"{lang}.md : avertissement synthétique absent")
+        # Garde-fou : aucun `None` Python ne doit fuiter dans le rendu.
+        if " None " in md or "| None " in md or ": None\n" in md:
+            motifs.append(f"{lang}.md : littéral None dans le rendu")
+    if brief.get("synthetique") and manifest["publiable"]:
+        motifs.append("synthétique mais publiable=true (#6)")
+
+    # (d) figures calculées : recoupement anti-invention. Chaque valeur non nulle
+    #     doit se RECALCULER à partir des opérandes sourcés (formule publiée).
+    motifs += _check_derived_arithmetic(brief, manifest)
+
+    # (e) cohérence publiable ↔ champs manquants : un dossier publiable ne peut pas
+    #     manquer le trio coût/revenu/marge.
+    if manifest["publiable"]:
+        fs = manifest["figures_sourcees"]
+        if fs["cout_construction_usd"] is None or fs["revenu_brut_usd"] is None \
+                or fs["marge_pct"] is None:
+            motifs.append("publiable=true mais cœur financier incomplet")
+
+    return motifs
+
+
+def _check_derived_arithmetic(brief: dict, manifest: dict) -> list[str]:
+    """Reproduit indépendamment les 4 agrégats et compare au manifeste.
+
+    Prouve qu'aucune valeur calculée n'a été « posée » : elle DOIT découler des
+    typologies sourcées et du taux canonique 52 %.
+    """
+    motifs: list[str] = []
+    rows = finance.typologies(brief)
+    figs = {f["cle"]: f["valeur"] for f in manifest["figures_calculees"]}
+
+    qtes = [r["quantite"] for r in rows]
+    all_q = bool(rows) and all(q is not None for q in qtes)
+
+    exp_total = sum(qtes) if all_q else None
+    exp_usd = (sum(q * r["prix_usd"] for q, r in zip(qtes, rows))
+               if all_q and all(r["prix_usd"] is not None for r in rows) else None)
+    exp_dop = (sum(q * r["prix_dop"] for q, r in zip(qtes, rows))
+               if all_q and all(r["prix_dop"] is not None for r in rows) else None)
+    exp_pe = (float(math.ceil(0.52 * exp_total))
+              if exp_total is not None else None)
+
+    for cle, exp in (("total_unites", exp_total),
+                     ("valeur_catalogue_usd", exp_usd),
+                     ("valeur_catalogue_dop", exp_dop),
+                     ("point_equilibre_unites", exp_pe)):
+        got = figs.get(cle)
+        if exp is None and got is not None:
+            motifs.append(f"figure {cle} calculée ({got}) alors qu'un opérande manque")
+        elif exp is not None and got != exp:
+            motifs.append(f"figure {cle} : manifeste {got} != recalcul {exp}")
+    return motifs
+
+
+# --------------------------------------------------------------------------- #
+def cmd_build(ns: argparse.Namespace) -> int:
+    with open(ns.brief, encoding="utf-8") as fh:
+        brief = json.load(fh)
+    _validate_projet(brief)
+    code = brief["projet"]
+
+    files = report.render_all(brief, generated_at=ns.generated_at)
+    manifest = json.loads(files["50_financier_bancable/manifest.json"])
+
+    motifs = check_invariants(brief, manifest, files)
+    if motifs:
+        _eprint(f"❌ {code} : invariants cassés — RIEN écrit :")
+        for m in motifs:
+            _eprint("     ·", m)
+        return 1
+
+    dest_dir = os.path.join(ns.out, code, "50_financier_bancable")
+    os.makedirs(dest_dir, exist_ok=True)
+    for rel, content in files.items():
+        with open(os.path.join(ns.out, code, rel), "w", encoding="utf-8") as fh:
+            fh.write(content)
+
+    _eprint(f"✅ {code} → {dest_dir}")
+    _eprint(f"   langues={manifest['langues']} · publiable={manifest['publiable']} "
+            f"· synthétique={manifest['synthetique']}")
+    _eprint(f"   typologies={manifest['typologies_count']} · "
+            f"champs 🔴 manquants={len(manifest['champs_manquants'])}")
+    for f in manifest["figures_calculees"]:
+        _eprint(f"     · {f['cle']} = {f['valeur']}  [{f['formule']}]")
+    return 0
+
+
+def cmd_validate(ns: argparse.Namespace) -> int:
+    with open(ns.brief, encoding="utf-8") as fh:
+        brief = json.load(fh)
+    _validate_projet(brief)
+    code = brief["projet"]
+
+    files = report.render_all(brief, generated_at=ns.generated_at)
+    manifest = json.loads(files["50_financier_bancable/manifest.json"])
+    motifs = check_invariants(brief, manifest, files)
+
+    print(json.dumps(manifest, ensure_ascii=False, indent=2))
+    if motifs:
+        _eprint(f"❌ {code} : {len(motifs)} invariant(s) cassé(s) :")
+        for m in motifs:
+            _eprint("     ·", m)
+        return 1
+    _eprint(f"✅ {code} : manifeste conforme + invariants OK "
+            f"(publiable={manifest['publiable']}).")
+    return 0
+
+
+# --------------------------------------------------------------------------- #
+def build_argparser() -> argparse.ArgumentParser:
+    ap = argparse.ArgumentParser(prog="bancable_gen",
+                                 description=__doc__.splitlines()[0])
+    sub = ap.add_subparsers(dest="cmd", required=True)
+
+    p = sub.add_parser("build", help="brief.json → 50_financier_bancable/{fr,en,es}.md")
+    p.add_argument("brief")
+    p.add_argument("-o", "--out", required=True, help="dossier data_room de sortie")
+    p.add_argument("--generated-at", dest="generated_at", default=None)
+    p.set_defaults(func=cmd_build)
+
+    p = sub.add_parser("validate", help="brief.json → manifeste + invariants (sans écrire)")
+    p.add_argument("brief")
+    p.add_argument("--generated-at", dest="generated_at", default=None)
+    p.set_defaults(func=cmd_validate)
+    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())

05_deliverables_mvp/faisabilite/bancable/banclib/__init__.py

@@ -0,0 +1,10 @@
+"""Librairie interne du générateur de dossier financier bancable trilingue.
+
+Modules :
+  - `deps`    : réutilisation (workflow #5) du modèle Faisabilité + validateur
+                maison Publiciste (zéro pip · zéro duplication).
+  - `i18n`    : dictionnaire de libellés FR/EN/ES (fixe, sourcé CLAUDE.md).
+  - `finance` : extraction des figures financières du brief (sourcées verbatim +
+                agrégats calculés de façon traçable · anti-invention #6).
+  - `report`  : rendu Markdown par langue + construction du manifeste agrégé.
+"""

05_deliverables_mvp/faisabilite/bancable/banclib/deps.py

@@ -0,0 +1,40 @@
+"""Réutilisation des briques déjà livrées (workflow #5 · zéro duplication).
+
+Le dossier bancable dérive du MÊME brief que le générateur Faisabilité 4 volets
+et doit rester cohérent avec lui :
+  - `is_filled`  : même notion de « champ réellement rempli » que le générateur
+                   (un placeholder / « non défini » / 0-inventé n'est pas rempli).
+  - `CANONICAL`  : les paramètres canoniques CLAUDE.md #9/#10 (3 % / 8.5 % / 52 % ·
+                   USD+DOP · Cardnet · Letter US) — jamais issus du brief.
+  - `validate`   : le validateur JSON-Schema maison du Publiciste (draft-07,
+                   sous-ensemble), pour valider le manifeste SANS installation pip
+                   (le gate CI Gitea Actions tourne sans réseau · CLAUDE.md #2).
+
+On importe par manipulation de `sys.path` (comme `faisabilite_gen.py`) plutôt que
+de dupliquer ces valeurs — une seule source de vérité pour tout le mandat.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+# faisabilite/bancable/banclib → générateur (genlib) : ../../generator
+_GEN = os.path.normpath(os.path.join(_HERE, "..", "..", "generator"))
+# faisabilite/bancable/banclib → Publiciste (lib) : ../../../publiciste
+_PUB = os.path.normpath(os.path.join(_HERE, "..", "..", "..", "publiciste"))
+
+for _p in (_GEN, _PUB):
+    if _p not in sys.path:
+        sys.path.insert(0, _p)
+
+from genlib import model  # type: ignore  # noqa: E402
+from lib import validator  # type: ignore  # noqa: E402
+
+is_filled = model.is_filled
+CANONICAL = model.CANONICAL
+TEMPLATE_VERSION = model.TEMPLATE_VERSION
+validate = validator.validate
+
+__all__ = ["is_filled", "CANONICAL", "TEMPLATE_VERSION", "validate"]

05_deliverables_mvp/faisabilite/bancable/banclib/finance.py

@@ -0,0 +1,186 @@
+"""Extraction des figures financières du brief pour le dossier bancable.
+
+DEUX TIERS, tous deux anti-invention (CLAUDE.md #6) :
+
+  SOURCÉ (verbatim)  — figures reprises telles quelles du brief, aucun calcul :
+      coût de construction, revenu brut, marge, taux de conversion, prix par
+      typologie. Un champ absent reste `None` → placeholder (jamais 0-inventé).
+
+  CALCULÉ (traçable) — agrégats dont CHAQUE opérande provient du brief ou d'un
+      paramètre canonique CLAUDE.md, et dont la FORMULE est publiée avec la
+      valeur. Un calcul transparent, reproductible et entièrement sourcé n'est
+      PAS une invention : c'est de la modélisation financière auditable. Si un
+      seul opérande manque, la figure reste `None` (formule affichée, valeur en
+      placeholder) et le champ est listé dans `champs_manquants`.
+
+Aucun montant n'est calculé sur une BASE non documentée. En particulier les
+pourcentages « 3 % édition » et « 8.5 % marketing » (#9) sont rendus comme des
+TAUX canoniques (verbatim), jamais multipliés par une base supposée — la base
+n'est pas documentée, la choisir serait une hypothèse inventée. Seul le point
+d'équilibre en unités (52 % × nombre d'unités) et les agrégats de catalogue
+(Σ quantité × prix) sont calculés : leur base est explicite et sourcée.
+"""
+
+from __future__ import annotations
+
+import math
+from typing import Any, Optional
+
+from . import deps
+
+is_filled = deps.is_filled
+CANONICAL = deps.CANONICAL
+
+
+def _num(value: Any) -> Optional[float]:
+    """Valeur numérique réelle, ou None si absente/placeholder/non numérique."""
+    if not is_filled(value):
+        return None
+    try:
+        return float(value)
+    except (TypeError, ValueError):
+        return None
+
+
+def _pct(canonical_str: str) -> Optional[float]:
+    """« 52 % » → 0.52. Source unique : le paramètre canonique (#9), jamais codé
+    en dur ici — évite toute dérive entre le taux affiché et le taux calculé."""
+    txt = canonical_str.replace("%", "").replace(",", ".").strip()
+    try:
+        return float(txt) / 100.0
+    except ValueError:
+        return None
+
+
+# --------------------------------------------------------------------------- #
+# Tier SOURCÉ — verbatim.
+# --------------------------------------------------------------------------- #
+def sourced(brief: dict) -> dict:
+    """Figures financières reprises TELLES QUELLES du brief (aucun calcul)."""
+    ing = brief.get("ingenierie") or {}
+    taux = (brief.get("architecture") or {}).get("taux_conversion") or {}
+    return {
+        "cout_construction_usd": _num(ing.get("cout_construction_usd")),
+        "revenu_brut_usd": _num(ing.get("revenu_brut_usd")),
+        "marge_pct": _num(ing.get("marge_pct")),
+        "regime_fiscal": (ing.get("regime_fiscal")
+                          if is_filled(ing.get("regime_fiscal")) else None),
+        "taux_conversion": {
+            "taux": _num(taux.get("taux")),
+            "date": taux.get("date") if is_filled(taux.get("date")) else None,
+            "source": taux.get("source") if is_filled(taux.get("source")) else None,
+        },
+    }
+
+
+def typologies(brief: dict) -> list[dict]:
+    """Lignes tarifaires sourcées + sous-total catalogue calculé par ligne.
+
+    `sous_total_usd` = quantité × prix_usd (calcul traçable, opérandes affichés).
+    None si l'un des deux manque — jamais 0-inventé.
+    """
+    typos = (brief.get("architecture") or {}).get("typologies") or []
+    rows: list[dict] = []
+    for t in typos:
+        qte = _num(t.get("quantite"))
+        pu = _num(t.get("prix_usd"))
+        pd = _num(t.get("prix_dop"))
+        sous_total = qte * pu if (qte is not None and pu is not None) else None
+        rows.append({
+            "nom": t.get("nom") if is_filled(t.get("nom")) else None,
+            "quantite": qte,
+            "prix_usd": pu,
+            "prix_dop": pd,
+            "sous_total_usd": sous_total,
+        })
+    return rows
+
+
+# --------------------------------------------------------------------------- #
+# Tier CALCULÉ — traçable (formule + opérandes sourcés).
+# --------------------------------------------------------------------------- #
+def _fig(cle: str, valeur: Optional[float], formule: str,
+         unite: str = "") -> dict:
+    return {"cle": cle, "valeur": valeur, "formule": formule, "unite": unite}
+
+
+def derived(brief: dict) -> list[dict]:
+    """Agrégats calculés de façon traçable. Chaque figure porte sa formule.
+
+    - total_unites          = Σ quantité (typologies)
+    - valeur_catalogue_usd  = Σ (quantité × prix_usd)
+    - valeur_catalogue_dop  = Σ (quantité × prix_dop)
+    - point_equilibre_unites= ⌈52 % × total_unites⌉  (52 % = canonique #9)
+
+    Chaque valeur reste None (opérande manquant) → placeholder + champ manquant.
+    """
+    rows = typologies(brief)
+
+    qtes = [r["quantite"] for r in rows]
+    prix_usd = [r["prix_usd"] for r in rows]
+    prix_dop = [r["prix_dop"] for r in rows]
+
+    total_unites = (sum(qtes) if rows and all(q is not None for q in qtes)
+                    else None)
+
+    val_usd = (sum(q * p for q, p in zip(qtes, prix_usd))
+               if rows and all(q is not None for q in qtes)
+               and all(p is not None for p in prix_usd) else None)
+    val_dop = (sum(q * p for q, p in zip(qtes, prix_dop))
+               if rows and all(q is not None for q in qtes)
+               and all(p is not None for p in prix_dop) else None)
+
+    pe_pct = _pct(CANONICAL["point_equilibre_pct"])
+    if total_unites is not None and pe_pct is not None:
+        pe_brut = pe_pct * total_unites
+        pe_unites = float(math.ceil(pe_brut))
+        pe_formule = (f"{CANONICAL['point_equilibre_pct']} × {int(total_unites)} = "
+                      f"{pe_brut:g}")
+    else:
+        pe_unites = None
+        pe_formule = f"{CANONICAL['point_equilibre_pct']} × {{total_unites}}"
+
+    return [
+        _fig("total_unites", total_unites, "Σ quantité (typologies)", "units"),
+        _fig("valeur_catalogue_usd", val_usd, "Σ (quantité × prix_usd)", "USD"),
+        _fig("valeur_catalogue_dop", val_dop, "Σ (quantité × prix_dop)", "DOP"),
+        _fig("point_equilibre_unites", pe_unites, pe_formule, "units"),
+    ]
+
+
+# --------------------------------------------------------------------------- #
+# Champs financiers 🔴 manquants (anti-invention — pas de 0 fabriqué).
+# --------------------------------------------------------------------------- #
+_REQUIRED_SOURCED = [
+    ("cout_construction_usd", "ingenierie.cout_construction_usd"),
+    ("revenu_brut_usd", "ingenierie.revenu_brut_usd"),
+    ("marge_pct", "ingenierie.marge_pct"),
+]
+
+
+def missing_fields(brief: dict) -> list[str]:
+    """Champs financiers 🔴 absents (sourcés + agrégats non calculables)."""
+    src = sourced(brief)
+    manquants = [label for key, label in _REQUIRED_SOURCED if src[key] is None]
+
+    rows = typologies(brief)
+    if not rows:
+        manquants.append("architecture.typologies (aucune typologie tarifée)")
+    else:
+        for i, r in enumerate(rows):
+            for col in ("nom", "quantite", "prix_usd", "prix_dop"):
+                if r[col] is None:
+                    manquants.append(f"architecture.typologies[{i}].{col}")
+
+    taux = src["taux_conversion"]
+    if taux["taux"] is None or taux["date"] is None or taux["source"] is None:
+        manquants.append("architecture.taux_conversion.{taux,date,source}")
+
+    # Dédoublonnage en préservant l'ordre.
+    seen: set[str] = set()
+    out: list[str] = []
+    for m in manquants:
+        if m not in seen:
+            seen.add(m)
+            out.append(m)
+    return out

05_deliverables_mvp/faisabilite/bancable/banclib/i18n.py

@@ -0,0 +1,163 @@
+"""Libellés FR/EN/ES du dossier financier bancable (fixes · sourcés CLAUDE.md).
+
+Les trois langues du dossier bancable sont IMPOSÉES par le Portail Bancables 4Big
+(`PORTAIL_BANCABLES_4BIG.md` : « Boutons langues FR 🇨🇦 · EN 🇺🇸 · ES 🇩🇴 »).
+Chaque colonne de ce dictionnaire est une traduction FIXE de libellés de gabarit :
+aucun libellé ne provient du brief, donc aucune donnée projet n'est traduite « à
+la volée » (ce qui serait une invention #6). Les seules chaînes libres du dossier
+(positionnement commercial) proviennent du brief, langue par langue, et restent en
+placeholder si absentes — jamais traduites automatiquement.
+"""
+
+from __future__ import annotations
+
+# Ordre canonique des langues (drapeaux = ceux du Portail Bancables 4Big).
+LANGS = ["fr", "en", "es"]
+LANG_FLAG = {"fr": "🇨🇦", "en": "🇺🇸", "es": "🇩🇴"}
+LANG_NOM = {"fr": "Français", "en": "English", "es": "Español"}
+
+LABELS: dict[str, dict[str, str]] = {
+    "fr": {
+        "doc_title": "Dossier financier bancable",
+        "confidential": (
+            "⚠️ CONFIDENTIEL — diffusion restreinte. Document destiné aux "
+            "personnes ressource (banquiers, notaires, investisseurs, CPA/UAF, "
+            "ministères). Ne pas indexer, ne pas rediffuser."
+        ),
+        "synthetic": (
+            "⚠️ FIXTURE SYNTHÉTIQUE — données fictives de test. NE JAMAIS "
+            "publier ni transmettre (CLAUDE.md #6)."
+        ),
+        "sec_positioning": "1. Positionnement",
+        "sec_sourced": "2. Données financières sourcées",
+        "sec_typologies": "3. Grille tarifaire par typologie",
+        "sec_derived": "4. Agrégats & emplois — calculs traçables",
+        "sec_canonical": "5. Paramètres canoniques OTO",
+        "lbl_cout_construction": "Coût de construction total",
+        "lbl_revenu_brut": "Revenu brut de vente projeté",
+        "lbl_marge": "Marge projetée",
+        "lbl_taux": "Taux de conversion USD↔DOP",
+        "lbl_regime_fiscal": "Régime fiscal",
+        "lbl_total_unites": "Total d'unités (Σ quantités typologies)",
+        "lbl_valeur_catalogue_usd": "Valeur catalogue du programme (USD)",
+        "lbl_valeur_catalogue_dop": "Valeur catalogue du programme (DOP)",
+        "lbl_point_equilibre_unites": "Point d'équilibre pré-vente (en unités)",
+        "lbl_edition": "Frais d'édition documentaire",
+        "lbl_marketing": "Budget marketing",
+        "lbl_point_equilibre_pct": "Point d'équilibre pré-vente",
+        "lbl_devises": "Devises",
+        "lbl_paiement": "Moyen de paiement",
+        "lbl_format_doc": "Format des documents",
+        "th_typologie": "Typologie",
+        "th_quantite": "Nb unités",
+        "th_prix_usd": "Prix « à partir de » (USD)",
+        "th_prix_dop": "Prix (DOP)",
+        "th_soustotal": "Sous-total catalogue (USD)",
+        "note_calcule": "calculé",
+        "note_fixe": "fixe",
+        "note_missing": "Champs 🔴 manquants (non inventés · #6)",
+        "note_taux_source": "source",
+        "note_generated": "Projet",
+        "word_units": "unités",
+        "word_rounded": "arrondi supérieur",
+        "word_base": "base à confirmer (non documentée · #9)",
+        "word_none": "à confirmer (faisabilité en cours)",
+    },
+    "en": {
+        "doc_title": "Bankable financial dossier",
+        "confidential": (
+            "⚠️ CONFIDENTIAL — restricted distribution. Intended for resource "
+            "persons (bankers, notaries, investors, CPA/UAF, ministries). Do not "
+            "index, do not redistribute."
+        ),
+        "synthetic": (
+            "⚠️ SYNTHETIC FIXTURE — fictional test data. NEVER publish or share "
+            "(CLAUDE.md #6)."
+        ),
+        "sec_positioning": "1. Positioning",
+        "sec_sourced": "2. Sourced financial data",
+        "sec_typologies": "3. Price grid by unit type",
+        "sec_derived": "4. Aggregates & uses of funds — traceable computations",
+        "sec_canonical": "5. OTO canonical parameters",
+        "lbl_cout_construction": "Total construction cost",
+        "lbl_revenu_brut": "Projected gross sales revenue",
+        "lbl_marge": "Projected margin",
+        "lbl_taux": "USD↔DOP conversion rate",
+        "lbl_regime_fiscal": "Tax regime",
+        "lbl_total_unites": "Total units (Σ unit-type quantities)",
+        "lbl_valeur_catalogue_usd": "Programme catalogue value (USD)",
+        "lbl_valeur_catalogue_dop": "Programme catalogue value (DOP)",
+        "lbl_point_equilibre_unites": "Pre-sale break-even (in units)",
+        "lbl_edition": "Document edition fee",
+        "lbl_marketing": "Marketing budget",
+        "lbl_point_equilibre_pct": "Pre-sale break-even",
+        "lbl_devises": "Currencies",
+        "lbl_paiement": "Payment method",
+        "lbl_format_doc": "Document format",
+        "th_typologie": "Unit type",
+        "th_quantite": "Units",
+        "th_prix_usd": "Price “from” (USD)",
+        "th_prix_dop": "Price (DOP)",
+        "th_soustotal": "Catalogue subtotal (USD)",
+        "note_calcule": "computed",
+        "note_fixe": "fixed",
+        "note_missing": "Missing 🔴 fields (never invented · #6)",
+        "note_taux_source": "source",
+        "note_generated": "Project",
+        "word_units": "units",
+        "word_rounded": "rounded up",
+        "word_base": "base to be confirmed (undocumented · #9)",
+        "word_none": "to be confirmed (feasibility in progress)",
+    },
+    "es": {
+        "doc_title": "Expediente financiero bancable",
+        "confidential": (
+            "⚠️ CONFIDENCIAL — distribución restringida. Destinado a personas "
+            "recurso (banqueros, notarios, inversionistas, CPA/UAF, ministerios). "
+            "No indexar, no redistribuir."
+        ),
+        "synthetic": (
+            "⚠️ DATOS SINTÉTICOS — datos ficticios de prueba. NUNCA publicar ni "
+            "compartir (CLAUDE.md #6)."
+        ),
+        "sec_positioning": "1. Posicionamiento",
+        "sec_sourced": "2. Datos financieros con fuente",
+        "sec_typologies": "3. Tabla de precios por tipología",
+        "sec_derived": "4. Agregados y usos — cálculos trazables",
+        "sec_canonical": "5. Parámetros canónicos OTO",
+        "lbl_cout_construction": "Costo total de construcción",
+        "lbl_revenu_brut": "Ingreso bruto de ventas proyectado",
+        "lbl_marge": "Margen proyectado",
+        "lbl_taux": "Tasa de conversión USD↔DOP",
+        "lbl_regime_fiscal": "Régimen fiscal",
+        "lbl_total_unites": "Total de unidades (Σ cantidades por tipología)",
+        "lbl_valeur_catalogue_usd": "Valor de catálogo del programa (USD)",
+        "lbl_valeur_catalogue_dop": "Valor de catálogo del programa (DOP)",
+        "lbl_point_equilibre_unites": "Punto de equilibrio de preventa (en unidades)",
+        "lbl_edition": "Cargo de edición documental",
+        "lbl_marketing": "Presupuesto de marketing",
+        "lbl_point_equilibre_pct": "Punto de equilibrio de preventa",
+        "lbl_devises": "Monedas",
+        "lbl_paiement": "Medio de pago",
+        "lbl_format_doc": "Formato de documentos",
+        "th_typologie": "Tipología",
+        "th_quantite": "Unidades",
+        "th_prix_usd": "Precio «desde» (USD)",
+        "th_prix_dop": "Precio (DOP)",
+        "th_soustotal": "Subtotal catálogo (USD)",
+        "note_calcule": "calculado",
+        "note_fixe": "fijo",
+        "note_missing": "Campos 🔴 faltantes (nunca inventados · #6)",
+        "note_taux_source": "fuente",
+        "note_generated": "Proyecto",
+        "word_units": "unidades",
+        "word_rounded": "redondeo superior",
+        "word_base": "base por confirmar (no documentada · #9)",
+        "word_none": "por confirmar (factibilidad en curso)",
+    },
+}
+
+
+def t(lang: str, key: str) -> str:
+    """Libellé traduit. Lève KeyError si la clé n'existe pas (bug de gabarit)."""
+    return LABELS[lang][key]

05_deliverables_mvp/faisabilite/bancable/banclib/report.py

@@ -0,0 +1,241 @@
+"""Rendu Markdown du dossier bancable (une langue) + manifeste agrégé.
+
+Le rendu place toujours en tête la bannière CONFIDENTIEL (le Portail Bancables
+est privé · `PORTAIL_BANCABLES_4BIG.md`) et, pour une fixture synthétique, la
+bannière « ne jamais publier » (#6). Toute figure absente est rendue en
+placeholder `{{…}}` (jamais un chiffre inventé).
+"""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from . import deps, finance, i18n
+
+CANONICAL = deps.CANONICAL
+
+
+# --------------------------------------------------------------------------- #
+# Helpers de rendu de valeurs.
+# --------------------------------------------------------------------------- #
+def _money(devise: str, n: Optional[float], placeholder: str) -> str:
+    """« USD 250,000 » (format Letter US · milliers séparés). Placeholder si None."""
+    if n is None:
+        return "{{" + placeholder + "}}"
+    entier = f"{n:,.0f}" if n == int(n) else f"{n:,.2f}"
+    return f"{devise} {entier}"
+
+
+def _int(n: Optional[float], placeholder: str) -> str:
+    if n is None:
+        return "{{" + placeholder + "}}"
+    return f"{int(n):,}" if n == int(n) else f"{n:,.2f}"
+
+
+def _pct(n: Optional[float], placeholder: str) -> str:
+    if n is None:
+        return "{{" + placeholder + "}}"
+    return f"{n:g} %"
+
+
+def _txt(value: Any, placeholder: str) -> str:
+    if value is None:
+        return "{{" + placeholder + "}}"
+    return str(value).strip()
+
+
+# --------------------------------------------------------------------------- #
+# Rendu d'une langue.
+# --------------------------------------------------------------------------- #
+def render_report(brief: dict, lang: str) -> str:
+    """Retourne le Markdown du dossier bancable pour `lang` ∈ {fr,en,es}."""
+    L = lambda k: i18n.t(lang, k)  # noqa: E731 — raccourci local lisible
+    code = brief["projet"]
+    nom = _txt(brief.get("nom"), "nom")
+
+    src = finance.sourced(brief)
+    rows = finance.typologies(brief)
+    figs = {f["cle"]: f for f in finance.derived(brief)}
+    manquants = finance.missing_fields(brief)
+
+    parts: list[str] = []
+
+    # En-tête + bannières.
+    parts.append(f"# {nom} · {code}\n")
+    parts.append(f"**{L('doc_title')}** · {i18n.LANG_FLAG[lang]} "
+                 f"{i18n.LANG_NOM[lang]}\n")
+    parts.append(f"> {L('confidential')}\n")
+    if brief.get("synthetique"):
+        parts.append(f"> {L('synthetic')}\n")
+
+    # 1. Positionnement (chaîne libre du brief, langue par langue).
+    com = brief.get("commercial") or {}
+    positionnement = com.get(f"positionnement_{lang}")
+    pos_txt = (str(positionnement).strip()
+               if deps.is_filled(positionnement)
+               else "{{positionnement_" + lang + "}}")
+    parts.append(f"## {L('sec_positioning')}\n\n{pos_txt}\n")
+
+    # 2. Données financières sourcées (verbatim).
+    parts.append(f"## {L('sec_sourced')}\n")
+    parts.append(
+        f"- **{L('lbl_cout_construction')}** : "
+        f"{_money('USD', src['cout_construction_usd'], 'cout_construction')}\n"
+        f"- **{L('lbl_revenu_brut')}** : "
+        f"{_money('USD', src['revenu_brut_usd'], 'revenu_brut')}\n"
+        f"- **{L('lbl_marge')}** : {_pct(src['marge_pct'], 'marge')}\n"
+        f"- **{L('lbl_regime_fiscal')}** : "
+        f"{_txt(src['regime_fiscal'], 'regime_fiscal')}\n"
+    )
+    taux = src["taux_conversion"]
+    taux_val = _int(taux["taux"], "taux")
+    parts.append(
+        f"- **{L('lbl_taux')}** : {taux_val} "
+        f"({_txt(taux['date'], 'taux_date')} · {L('note_taux_source')} "
+        f"{_txt(taux['source'], 'taux_source')})\n"
+    )
+
+    # 3. Grille tarifaire par typologie (sourcé + sous-total tracé).
+    parts.append(f"## {L('sec_typologies')}\n")
+    header = (f"| {L('th_typologie')} | {L('th_quantite')} | {L('th_prix_usd')} "
+              f"| {L('th_prix_dop')} | {L('th_soustotal')} |\n"
+              "|---|---|---|---|---|\n")
+    body = ""
+    if rows:
+        for i, r in enumerate(rows):
+            body += (
+                f"| {_txt(r['nom'], f'typo_{i+1}_nom')} "
+                f"| {_int(r['quantite'], f'typo_{i+1}_qte')} "
+                f"| {_money('USD', r['prix_usd'], f'typo_{i+1}_usd')} "
+                f"| {_money('DOP', r['prix_dop'], f'typo_{i+1}_dop')} "
+                f"| {_money('USD', r['sous_total_usd'], f'typo_{i+1}_st')} |\n"
+            )
+    else:
+        body = ("| {{typo_1_nom}} | {{typo_1_qte}} | {{typo_1_usd}} "
+                "| {{typo_1_dop}} | {{typo_1_st}} |\n")
+    parts.append(header + body + "\n")
+
+    # 4. Agrégats & emplois — calculs traçables (formule affichée).
+    parts.append(f"## {L('sec_derived')}\n")
+    tu = figs["total_unites"]
+    vcu = figs["valeur_catalogue_usd"]
+    vcd = figs["valeur_catalogue_dop"]
+    pe = figs["point_equilibre_unites"]
+    parts.append(
+        f"- **{L('lbl_total_unites')}** : {_int(tu['valeur'], 'total_unites')} "
+        f"_({L('note_calcule')} : {tu['formule']})_\n"
+        f"- **{L('lbl_valeur_catalogue_usd')}** : "
+        f"{_money('USD', vcu['valeur'], 'valeur_catalogue_usd')} "
+        f"_({L('note_calcule')} : {vcu['formule']})_\n"
+        f"- **{L('lbl_valeur_catalogue_dop')}** : "
+        f"{_money('DOP', vcd['valeur'], 'valeur_catalogue_dop')} "
+        f"_({L('note_calcule')} : {vcd['formule']})_\n"
+    )
+    pe_val = (f"{_int(pe['valeur'], 'point_equilibre_unites')} "
+              f"{L('word_units')} ({L('word_rounded')})"
+              if pe["valeur"] is not None
+              else "{{point_equilibre_unites}}")
+    parts.append(
+        f"- **{L('lbl_point_equilibre_unites')}** : {pe_val} "
+        f"_({L('note_calcule')} : {pe['formule']})_\n"
+    )
+
+    # 5. Paramètres canoniques OTO (verbatim · #9/#10 · base non multipliée).
+    parts.append(f"## {L('sec_canonical')}\n")
+    parts.append(
+        f"- **{L('lbl_edition')}** : {CANONICAL['frais_edition_pct']} "
+        f"({L('note_fixe')} · {L('word_base')})\n"
+        f"- **{L('lbl_marketing')}** : {CANONICAL['marketing_pct']} "
+        f"({L('note_fixe')} · {L('word_base')})\n"
+        f"- **{L('lbl_point_equilibre_pct')}** : "
+        f"{CANONICAL['point_equilibre_pct']} ({L('note_fixe')})\n"
+        f"- **{L('lbl_devises')}** : {CANONICAL['devises']}\n"
+        f"- **{L('lbl_paiement')}** : {CANONICAL['paiement']}\n"
+        f"- **{L('lbl_format_doc')}** : {CANONICAL['format_doc']}\n"
+    )
+
+    # Champs manquants (transparence anti-invention).
+    if manquants:
+        parts.append(f"## {L('note_missing')}\n")
+        parts.append("".join(f"- {m}\n" for m in manquants))
+
+    parts.append(f"\n---\n_{L('note_generated')} {code}._\n")
+    return "\n".join(parts)
+
+
+# --------------------------------------------------------------------------- #
+# Manifeste agrégé (une seule vue machine-lisible des 3 langues).
+# --------------------------------------------------------------------------- #
+def _publiable(brief: dict, manquants: list[str]) -> bool:
+    """Publiable ssi : non synthétique ET cœur financier sourcé complet.
+
+    On n'exige PAS zéro champ manquant (un taux daté peut manquer sans bloquer),
+    mais le trio coût/revenu/marge + au moins une typologie tarifée est requis —
+    sans quoi le dossier n'a pas de substance bancable.
+    """
+    if brief.get("synthetique"):
+        return False
+    src = finance.sourced(brief)
+    if src["cout_construction_usd"] is None or src["revenu_brut_usd"] is None \
+            or src["marge_pct"] is None:
+        return False
+    rows = finance.typologies(brief)
+    tarifs_ok = any(
+        r["quantite"] is not None and r["prix_usd"] is not None for r in rows
+    )
+    return bool(rows) and tarifs_ok
+
+
+def build_manifest(brief: dict, generated_at: Optional[str] = None) -> dict:
+    """Manifeste agrégé (contrat bancable.schema.json)."""
+    code = brief["projet"]
+    src = finance.sourced(brief)
+    manquants = finance.missing_fields(brief)
+    figs = finance.derived(brief)
+
+    manifest: dict[str, Any] = {
+        "projet": code,
+        "template_version": deps.TEMPLATE_VERSION,
+        "langues": list(i18n.LANGS),
+        "synthetique": bool(brief.get("synthetique")),
+        "publiable": _publiable(brief, manquants),
+        "figures_sourcees": {
+            "cout_construction_usd": src["cout_construction_usd"],
+            "revenu_brut_usd": src["revenu_brut_usd"],
+            "marge_pct": src["marge_pct"],
+            "taux_conversion": {
+                "taux": src["taux_conversion"]["taux"],
+                "date": src["taux_conversion"]["date"],
+                "source": src["taux_conversion"]["source"],
+            },
+        },
+        "figures_calculees": [
+            {
+                "cle": f["cle"],
+                "libelle": i18n.t("fr", f"lbl_{f['cle']}"),
+                "formule": f["formule"],
+                "valeur": f["valeur"],
+                "unite": f["unite"],
+            }
+            for f in figs
+        ],
+        "typologies_count": len(finance.typologies(brief)),
+        "champs_manquants": manquants,
+        "fichiers": [f"50_financier_bancable/{lang}.md" for lang in i18n.LANGS],
+    }
+    if generated_at is not None:
+        manifest["generated_at"] = generated_at
+    return manifest
+
+
+def render_all(brief: dict, generated_at: Optional[str] = None) -> dict[str, str]:
+    """Retourne {chemin_relatif: contenu} pour les 3 langues + le manifeste."""
+    import json
+
+    files: dict[str, str] = {}
+    for lang in i18n.LANGS:
+        files[f"50_financier_bancable/{lang}.md"] = render_report(brief, lang)
+    files["50_financier_bancable/manifest.json"] = json.dumps(
+        build_manifest(brief, generated_at), ensure_ascii=False, indent=2
+    ) + "\n"
+    return files

05_deliverables_mvp/faisabilite/bancable/fixtures/brief_bancable.json

@@ -0,0 +1,56 @@
+{
+  "projet": "P01",
+  "nom": "Résidence Fixture Bancable",
+  "synthetique": true,
+  "sources": [
+    "SYNTHÉTIQUE — archive fictive dossier_bancable_2026.pdf",
+    "SYNTHÉTIQUE — taux BCRD fictif 2026-07-01"
+  ],
+  "architecture": {
+    "taux_conversion": {
+      "taux": 59.0,
+      "date": "2026-07-01",
+      "source": "SYNTHÉTIQUE — BCRD fictif"
+    },
+    "typologies": [
+      {
+        "nom": "Studio",
+        "quantite": 12,
+        "surface_interieure_m2": 45,
+        "surface_terrasse_m2": 10,
+        "surface_totale_m2": 55,
+        "prix_usd": 150000,
+        "prix_dop": 8850000
+      },
+      {
+        "nom": "1 Chambre",
+        "quantite": 20,
+        "surface_interieure_m2": 68,
+        "surface_terrasse_m2": 15,
+        "surface_totale_m2": 83,
+        "prix_usd": 210000,
+        "prix_dop": 12390000
+      },
+      {
+        "nom": "2 Chambres",
+        "quantite": 8,
+        "surface_interieure_m2": 95,
+        "surface_terrasse_m2": 25,
+        "surface_totale_m2": 120,
+        "prix_usd": 320000,
+        "prix_dop": 18880000
+      }
+    ]
+  },
+  "ingenierie": {
+    "cout_construction_usd": 9000000,
+    "revenu_brut_usd": 14200000,
+    "marge_pct": 28,
+    "regime_fiscal": "CONFOTUR + Fideicomiso"
+  },
+  "commercial": {
+    "positionnement_fr": "Une adresse balnéaire confidentielle où l'architecture contemporaine dialogue avec la nature tropicale, sous régime CONFOTUR.",
+    "positionnement_en": "A confidential beachfront address where contemporary architecture meets tropical nature, under the CONFOTUR regime.",
+    "positionnement_es": "Una dirección balnearia confidencial donde la arquitectura contemporánea dialoga con la naturaleza tropical, bajo el régimen CONFOTUR."
+  }
+}

05_deliverables_mvp/faisabilite/bancable/tests/test_bancable.py

@@ -0,0 +1,224 @@
+"""Tests du générateur de dossier bancable trilingue (stdlib `unittest`, zéro pip).
+
+Couvre : rendu FR/EN/ES, bannière CONFIDENTIEL, anti-invention (#6 — placeholders,
+zéro chiffre fabriqué), calculs traçables recoupés indépendamment, cohérence du
+manifeste avec le schéma (validateur maison + oracle `jsonschema` si présent),
+publiabilité, déterminisme, et refus d'écrire sur invariant cassé.
+"""
+
+import copy
+import importlib.util
+import json
+import os
+import sys
+import unittest
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_MOD = os.path.normpath(os.path.join(_HERE, ".."))            # bancable/
+_PUB = os.path.normpath(os.path.join(_MOD, "..", "..", "publiciste"))
+
+sys.path.insert(0, _PUB)
+sys.path.insert(0, _MOD)
+
+from banclib import finance, i18n, report  # noqa: E402
+
+
+def _load_cli():
+    """Charge bancable_gen.py comme module isolé."""
+    spec = importlib.util.spec_from_file_location(
+        "bancable_gen", os.path.join(_MOD, "bancable_gen.py")
+    )
+    mod = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(mod)
+    return mod
+
+
+def _brief():
+    with open(os.path.join(_MOD, "fixtures", "brief_bancable.json"),
+              encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+def _schema():
+    with open(os.path.join(_MOD, "bancable.schema.json"), encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+class TestFinance(unittest.TestCase):
+    def test_sourced_verbatim(self):
+        src = finance.sourced(_brief())
+        self.assertEqual(src["cout_construction_usd"], 9000000)
+        self.assertEqual(src["revenu_brut_usd"], 14200000)
+        self.assertEqual(src["marge_pct"], 28)
+        self.assertEqual(src["taux_conversion"]["taux"], 59.0)
+
+    def test_derived_arithmetic_traceable(self):
+        figs = {f["cle"]: f for f in finance.derived(_brief())}
+        # 12 + 20 + 8 = 40
+        self.assertEqual(figs["total_unites"]["valeur"], 40)
+        # 12*150000 + 20*210000 + 8*320000 = 1.8M + 4.2M + 2.56M = 8.56M
+        self.assertEqual(figs["valeur_catalogue_usd"]["valeur"], 8560000)
+        # 12*8.85M + 20*12.39M + 8*18.88M = 106.2M + 247.8M + 151.04M = 505.04M
+        self.assertEqual(figs["valeur_catalogue_dop"]["valeur"], 505040000)
+        # ceil(0.52 * 40) = ceil(20.8) = 21
+        self.assertEqual(figs["point_equilibre_unites"]["valeur"], 21)
+
+    def test_derived_carry_formula(self):
+        for f in finance.derived(_brief()):
+            self.assertTrue(f["formule"])
+            self.assertNotIn("None", f["formule"])
+
+    def test_missing_operand_yields_none_not_zero(self):
+        b = _brief()
+        del b["ingenierie"]["cout_construction_usd"]
+        b["architecture"]["typologies"][0].pop("prix_usd")
+        src = finance.sourced(b)
+        self.assertIsNone(src["cout_construction_usd"])  # jamais 0
+        figs = {f["cle"]: f for f in finance.derived(b)}
+        # un prix_usd manquant ⇒ valeur catalogue USD non calculable
+        self.assertIsNone(figs["valeur_catalogue_usd"]["valeur"])
+        # mais les quantités restent complètes ⇒ total_unites calculable
+        self.assertEqual(figs["total_unites"]["valeur"], 40)
+        self.assertIn("ingenierie.cout_construction_usd",
+                      finance.missing_fields(b))
+
+
+class TestReport(unittest.TestCase):
+    def test_three_languages_rendered(self):
+        files = report.render_all(_brief())
+        for lang in ("fr", "en", "es"):
+            self.assertIn(f"50_financier_bancable/{lang}.md", files)
+
+    def test_confidential_banner_every_language(self):
+        for lang in i18n.LANGS:
+            md = report.render_report(_brief(), lang)
+            up = md.upper()
+            self.assertTrue("CONFIDENTIEL" in up or "CONFIDENTIAL" in up
+                            or "CONFIDENCIAL" in up)
+
+    def test_synthetic_banner_and_not_publishable(self):
+        b = _brief()
+        self.assertTrue(b["synthetique"])
+        m = report.build_manifest(b)
+        self.assertFalse(m["publiable"])
+        for lang in i18n.LANGS:
+            self.assertIn("SYNTH", report.render_report(b, lang).upper())
+
+    def test_positioning_per_language_from_brief(self):
+        b = _brief()
+        self.assertIn("beachfront", report.render_report(b, "en"))
+        self.assertIn("balnearia", report.render_report(b, "es"))
+        self.assertIn("balnéaire", report.render_report(b, "fr"))
+
+    def test_missing_positioning_becomes_placeholder(self):
+        b = _brief()
+        del b["commercial"]["positionnement_en"]
+        md = report.render_report(b, "en")
+        self.assertIn("{{positionnement_en}}", md)
+        # les autres langues restent intactes
+        self.assertNotIn("{{positionnement_fr}}", report.render_report(b, "fr"))
+
+    def test_no_python_none_leaks_in_render(self):
+        b = _brief()
+        del b["ingenierie"]["cout_construction_usd"]
+        for lang in i18n.LANGS:
+            md = report.render_report(b, lang)
+            self.assertNotIn(" None ", md)
+            self.assertNotIn("| None ", md)
+
+    def test_canonical_params_present(self):
+        md = report.render_report(_brief(), "fr")
+        for marker in ("3 %", "8.5 %", "52 %", "USD + DOP", "Cardnet", "Letter US"):
+            self.assertIn(marker, md)
+
+    def test_computed_subtotal_traced_in_table(self):
+        md = report.render_report(_brief(), "fr")
+        # sous-total Studio = 12 × 150,000 = 1,800,000
+        self.assertIn("USD 1,800,000", md)
+
+    def test_determinism(self):
+        b = _brief()
+        self.assertEqual(report.render_all(b), report.render_all(b))
+
+
+class TestManifestSchema(unittest.TestCase):
+    def test_manifest_matches_home_validator(self):
+        from lib import validator as pub_validator  # noqa: PLC0415
+        m = report.build_manifest(_brief())
+        errs = pub_validator.validate(m, _schema())
+        self.assertEqual(errs, [], f"erreurs schéma maison : {errs}")
+
+    def test_manifest_matches_jsonschema_oracle_if_present(self):
+        try:
+            import jsonschema  # noqa: PLC0415
+        except ImportError:
+            self.skipTest("jsonschema non installé (oracle optionnel)")
+        jsonschema.validate(report.build_manifest(_brief()), _schema())
+
+    def test_manifest_figures_count(self):
+        m = report.build_manifest(_brief())
+        self.assertEqual(len(m["figures_calculees"]), 4)
+        self.assertEqual(m["langues"], ["fr", "en", "es"])
+        self.assertEqual(m["typologies_count"], 3)
+
+    def test_generated_at_optional(self):
+        m0 = report.build_manifest(_brief())
+        self.assertNotIn("generated_at", m0)
+        m1 = report.build_manifest(_brief(), generated_at="2026-07-30T04:57:01Z")
+        self.assertEqual(m1["generated_at"], "2026-07-30T04:57:01Z")
+        from lib import validator as pub_validator  # noqa: PLC0415
+        self.assertEqual(pub_validator.validate(m1, _schema()), [])
+
+
+class TestCLIInvariants(unittest.TestCase):
+    def setUp(self):
+        self.cli = _load_cli()
+
+    def test_invariants_pass_on_fixture(self):
+        b = _brief()
+        files = report.render_all(b)
+        manifest = json.loads(files["50_financier_bancable/manifest.json"])
+        self.assertEqual(self.cli.check_invariants(b, manifest, files), [])
+
+    def test_invariant_detects_forged_figure(self):
+        b = _brief()
+        files = report.render_all(b)
+        manifest = json.loads(files["50_financier_bancable/manifest.json"])
+        # Falsifie une valeur calculée → l'invariant de recalcul doit la rattraper.
+        for f in manifest["figures_calculees"]:
+            if f["cle"] == "valeur_catalogue_usd":
+                f["valeur"] = 9999999
+        motifs = self.cli.check_invariants(b, manifest, files)
+        self.assertTrue(any("valeur_catalogue_usd" in m for m in motifs))
+
+    def test_invariant_detects_synthetic_marked_publishable(self):
+        b = _brief()
+        files = report.render_all(b)
+        manifest = json.loads(files["50_financier_bancable/manifest.json"])
+        manifest["publiable"] = True  # incohérent avec synthétique
+        motifs = self.cli.check_invariants(b, manifest, files)
+        self.assertTrue(any("synth" in m.lower() for m in motifs))
+
+    def test_build_writes_files(self):
+        import tempfile
+        self.cli = _load_cli()
+        with tempfile.TemporaryDirectory() as tmp:
+            rc = self.cli.main(["build", os.path.join(_MOD, "fixtures",
+                                                       "brief_bancable.json"),
+                                "-o", tmp])
+            self.assertEqual(rc, 0)
+            base = os.path.join(tmp, "P01", "50_financier_bancable")
+            for name in ("fr.md", "en.md", "es.md", "manifest.json"):
+                self.assertTrue(os.path.exists(os.path.join(base, name)), name)
+
+    def test_publishable_real_brief(self):
+        # Un brief NON synthétique et complet est publiable.
+        b = _brief()
+        b["synthetique"] = False
+        b["sources"] = ["archive réelle P01"]
+        m = report.build_manifest(b)
+        self.assertTrue(m["publiable"])
+
+
+if __name__ == "__main__":
+    unittest.main()

05_deliverables_mvp/faisabilite/generator/.gitignore

@@ -0,0 +1,5 @@
+# Artefacts de génération locale (jamais commités — produits à la demande).
+__pycache__/
+*.pyc
+build/
+out/

05_deliverables_mvp/faisabilite/generator/README.md

@@ -0,0 +1,112 @@
+# Générateur Faisabilité 4 volets · Sprint 2
+
+> Livrable **Faisabilité · Sprint 2** — `03_agents/faisabilite/AGENT.md` §Livrable S2
+> (« Générateur 4 volets automatique »).
+> Cible de portage VPS : `otoia/capabilities/faisabilite_agent.py`.
+
+Produit une faisabilité canonique `data_room/PXX/` (conforme au
+[`TEMPLATE_FAISABILITE_CANONIQUE_v1.0.md`](../TEMPLATE_FAISABILITE_CANONIQUE_v1.0.md))
+à partir d'un **brief JSON sourcé**, puis **prouve** que le résultat est
+consommable par le Publiciste.
+
+## Place dans la chaîne de valeur
+
+```
+brief.json ──► faisabilite_gen ──► data_room/PXX/ (template v1.0)
+                                        │
+                                        ▼   (module Publiciste, déjà livré)
+                        publiciste.parser ──► projets_master.json ──► site
+```
+
+Le générateur ferme la boucle amont du Publiciste : ce dernier ne fait que
+**publier** ; c'est ici que les 4 volets sont **produits** et **notés**.
+
+## Zéro invention de chiffres (CLAUDE.md #6)
+
+Principe défensif de bout en bout :
+
+- Les **paramètres canoniques** (3 % édition · 8.5 % marketing · 52 % point
+  d'équilibre · USD+DOP · Cardnet · Letter US, CLAUDE.md #9/#10) sont **imposés
+  par le générateur** — ils ne proviennent jamais du brief, donc ne peuvent être
+  faussés projet par projet.
+- Tout **champ 🔴 absent** du brief est rendu en placeholder `{{…}}`, listé dans
+  `champs_manquants`, et **rétrograde** le statut (jamais « complete » douteux).
+- Un prix manquant reste `{{…}}` (jamais `0`, jamais une valeur inventée) → le
+  Publiciste publie le projet « En développement ».
+
+## Scoring 4Big (§7 du template · 5 axes × 20)
+
+| Axe | Source | Calcul |
+|---|---|---|
+| Complétude | brief | fraction des champs 🔴 des 4 volets remplis |
+| Anti-gap prix | brief §3.2 | fraction des cellules typologies renseignées |
+| Traçabilité | brief | `sources[]` + `taux_conversion{date,source}` |
+| Paramètres canoniques | générateur | 20 (garanti · vérifié dans le rendu) |
+| Machine-lisible | **preuve** | `version.json` valide **+** parser Publiciste OK |
+
+L'axe machine-lisible n'est **pas auto-décerné** : le CLI re-parse le projet
+généré avec le parser Publiciste et valide `version.json` contre
+[`version.schema.json`](../version.schema.json). En cas d'échec, les 20 points
+sont retirés, `version.json` réécrit, et la commande sort en erreur.
+
+Statut « complete » ⇔ score ≥ 95 **et** aucun champ 🔴 manquant **et** bloc prix
+intégral **et** 4 volets — cohérent avec la contrainte `allOf` de
+`version.schema.json`.
+
+## Utilisation
+
+```bash
+# Bilan 4Big d'un brief (sans rien écrire)
+python3 faisabilite_gen.py score fixtures/brief_complete.json
+
+# Générer une faisabilité (+ preuve machine-lisible)
+python3 faisabilite_gen.py generate fixtures/brief_complete.json -o /tmp/data_room
+
+# Amorcer un nouveau projet (arborescence vide à placeholders)
+python3 faisabilite_gen.py scaffold P07 -o /tmp/data_room
+
+# Générer tous les briefs d'un dossier
+python3 faisabilite_gen.py batch fixtures -o /tmp/data_room
+```
+
+Puis, via le module Publiciste, publier :
+
+```bash
+cd ../../publiciste
+python3 publiciste.py run /tmp/data_room -o /tmp/site
+```
+
+`--generated-at` fige l'horodatage (sorties déterministes / tests).
+
+## Contrat d'entrée
+
+Voir [`brief.schema.json`](./brief.schema.json). Les fixtures sont **synthétiques**
+(`"synthetique": true`, bannière « ne jamais publier ») :
+
+- `fixtures/brief_complete.json` → statut `complete`, score 100/100.
+- `fixtures/brief_incomplete.json` → prix absents → rétrogradation
+  `en_developpement`, prix restés en placeholders (démontre l'anti-invention).
+
+## Tests
+
+```bash
+python3 -m unittest discover -s tests -v
+```
+
+16 tests `unittest` (stdlib pur, **zéro pip**) : scoring, rétrogradation,
+paramètres canoniques, et **round-trip end-to-end** generator → parser Publiciste
+→ `projets_master.json` validé contre le schéma. Réutilise le parser + le
+validateur du Publiciste (aucune duplication · workflow #5). Un oracle
+`jsonschema` est activé en plus s'il est installé.
+
+Job CI : `faisabilite-gen-tests` (gate `.gitea/workflows/ci.yml` · Gitea Actions
+uniquement · contrainte #2).
+
+## Hors périmètre worker (VPS / calendrier ultérieur)
+
+- Application sur les **données réelles** `data_room/` (VPS · Faisabilité/ERPNext).
+- Archives auto `_ARCHIVES/PXX_v{N}_YYYYMMDD/` sur bump MAJOR du template (S3/S4).
+- Génération des `40_llm_outputs/` marché/directeur/fiscal/juridique + rapports
+  bancables FR/EN/ES (S3+ ; seuls brief/masterplan/architecture/paysage/
+  ingénierie/commercial sont produits ici).
+- Trigger `otoia-faisabilite.timer` + notification Publiciste/WhatsApp (S6 · VPS).

05_deliverables_mvp/faisabilite/generator/brief.schema.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://oto.dtp/schemas/faisabilite/brief.schema.json",
+  "title": "Brief d'entrée du générateur Faisabilité 4 volets",
+  "description": "Données projet SOURCÉES fournies au générateur. Le générateur ne fabrique aucun chiffre (#6) : tout champ absent devient un placeholder et rétrograde le statut. Les paramètres canoniques (3%/8.5%/52% · USD+DOP · Cardnet · Letter US) ne figurent PAS ici — ils sont imposés par le générateur.",
+  "type": "object",
+  "required": ["projet"],
+  "additionalProperties": true,
+  "properties": {
+    "projet": { "type": "string", "pattern": "^P0[1-9]$" },
+    "nom": { "type": "string" },
+    "synthetique": { "type": "boolean", "description": "true = fixture de test, jamais publiable." },
+    "sources": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Références archives justifiant les chiffres (axe Traçabilité §7)."
+    },
+    "masterplan": {
+      "type": "object",
+      "properties": {
+        "localisation": { "type": "string" },
+        "terrain_m2": { "type": ["number", "null"] },
+        "terrain_tareas": { "type": ["number", "null"] },
+        "zonage": { "type": "string" },
+        "nb_unites": { "type": ["integer", "null"] },
+        "nb_phases": { "type": ["integer", "null"] },
+        "cos": { "type": "string" },
+        "acces": { "type": "string" },
+        "ref_plan_masse": { "type": "string" },
+        "phasage": { "type": "string" }
+      }
+    },
+    "architecture": {
+      "type": "object",
+      "properties": {
+        "parti_archi": { "type": "string" },
+        "nb_batiments": { "type": ["integer", "null"] },
+        "nb_niveaux": { "type": ["integer", "null"] },
+        "ref_rendus": { "type": "string" },
+        "taux_conversion": {
+          "type": "object",
+          "properties": {
+            "taux": { "type": ["number", "null"] },
+            "date": { "type": "string" },
+            "source": { "type": "string" }
+          }
+        },
+        "typologies": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "nom": { "type": "string" },
+              "quantite": { "type": ["integer", "null"] },
+              "surface_interieure_m2": { "type": ["number", "null"] },
+              "surface_terrasse_m2": { "type": ["number", "null"] },
+              "surface_totale_m2": { "type": ["number", "null"] },
+              "prix_usd": { "type": ["number", "null"] },
+              "prix_dop": { "type": ["number", "null"] }
+            }
+          }
+        }
+      }
+    },
+    "paysage": {
+      "type": "object",
+      "properties": {
+        "concept_paysage": { "type": "string" },
+        "amenities": { "type": "array", "items": { "type": "string" } },
+        "services_inclus": { "type": "array", "items": { "type": "string" } },
+        "experience": { "type": "string" },
+        "durabilite": { "type": "string" }
+      }
+    },
+    "ingenierie": {
+      "type": "object",
+      "properties": {
+        "structure": { "type": "string" },
+        "reseaux": { "type": "string" },
+        "contraintes_site": { "type": "string" },
+        "cout_construction_usd": { "type": ["number", "null"] },
+        "revenu_brut_usd": { "type": ["number", "null"] },
+        "marge_pct": { "type": ["number", "null"] },
+        "regime_fiscal": { "type": "string" }
+      }
+    },
+    "commercial": {
+      "type": "object",
+      "description": "Chaînes libres commerciales, langue par langue. Le générateur 4 volets consomme le FR (positionnement §40_llm_outputs) ; le générateur bancable consomme FR/EN/ES pour la section Positionnement du dossier bancable. Une langue absente reste un placeholder (jamais traduite automatiquement · #6).",
+      "properties": {
+        "positionnement_fr": { "type": "string" },
+        "positionnement_en": { "type": "string" },
+        "positionnement_es": { "type": "string" }
+      }
+    },
+    "rendus": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "fichier": { "type": "string" },
+          "vue": { "type": "string" },
+          "hero": { "type": "boolean" }
+        }
+      }
+    }
+  }
+}

05_deliverables_mvp/faisabilite/generator/faisabilite_gen.py

@@ -0,0 +1,243 @@
+#!/usr/bin/env python3
+"""Générateur Faisabilité 4 volets · orchestrateur CLI (Sprint 2).
+
+Cible de portage VPS : `otoia/capabilities/faisabilite_agent.py`
+(cf. 03_agents/faisabilite/AGENT.md §Livrable S2).
+
+Produit une faisabilité canonique `data_room/PXX/` (template v1.0) à partir d'un
+brief JSON, puis PROUVE que le résultat est consommable par le Publiciste
+(re-parse + validation `version.json`) — sinon échoue et retire le score de l'axe
+machine-lisible (jamais de score auto-décerné à l'aveugle).
+
+Sous-commandes :
+  score     BRIEF.json                 → bilan 4Big (§7) sur stdout
+  scaffold  PXX -o OUT                  → arborescence vide (placeholders) d'un projet
+  generate  BRIEF.json -o OUT           → data_room/PXX/ + preuve machine-lisible
+  batch     BRIEFS_DIR -o DATA_ROOM     → génère tous les briefs d'un dossier
+
+⚠ Ce worker n'écrit JAMAIS sur le VPS. Les artefacts sont produits en local ;
+l'application réelle (copie data_room/ VPS + archives + notif) est un livrable
+ultérieur côté serveur (AGENT.md §Workflow, Semaines 3-4).
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from datetime import datetime, timezone
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+# Ordre voulu sur sys.path : d'abord le générateur (paquet `genlib`), puis le
+# Publiciste (paquet `lib`). Les deux noms sont distincts → aucune collision.
+sys.path.insert(0, os.path.normpath(os.path.join(_HERE, "..", "..", "publiciste")))
+sys.path.insert(0, _HERE)
+
+from genlib import renderer, scorer  # noqa: E402
+
+# Réutilisation (workflow #5 : zéro duplication) du parser + validateur Publiciste.
+from lib import parser as pub_parser  # type: ignore  # noqa: E402
+from lib import validator as pub_validator  # type: ignore  # noqa: E402
+
+_SCHEMA_DIR = os.path.normpath(os.path.join(_HERE, ".."))
+
+
+def _eprint(*args) -> None:
+    print(*args, file=sys.stderr)
+
+
+def _now_iso() -> str:
+    return datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+
+def _load_version_schema() -> dict:
+    with open(os.path.join(_SCHEMA_DIR, "version.schema.json"), encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+def _validate_brief(brief: dict) -> None:
+    """Garde-fou minimal : le brief DOIT porter un code projet canonique."""
+    code = brief.get("projet")
+    if not (isinstance(code, str) and len(code) == 3 and code[:2] == "P0"
+            and code[2] in "123456789"):
+        raise ValueError(f"brief.projet invalide (attendu P01..P09) : {code!r}")
+
+
+# --------------------------------------------------------------------------- #
+def _generate_tree(brief: dict, out_dir: str, generated_at: str) -> tuple[str, dict]:
+    """Écrit l'arborescence PXX/ et retourne (chemin_projet, bilan) avec l'axe
+    machine-lisible PROUVÉ (re-parse Publiciste + validation version.json)."""
+    _validate_brief(brief)
+    code = brief["projet"]
+
+    # 1er passage : bilan optimiste (axe 5 = 20 par construction).
+    bilan = scorer.score(brief, machine_lisible_pts=20)
+
+    projet_dir = os.path.join(out_dir, code)
+    files = renderer.render_files(brief, bilan, generated_at)
+    for rel, content in files.items():
+        dest = os.path.join(projet_dir, rel)
+        os.makedirs(os.path.dirname(dest), exist_ok=True)
+        with open(dest, "w", encoding="utf-8") as fh:
+            fh.write(content)
+
+    # PREUVE axe 5 — machine-lisible :
+    #   (a) version.json conforme à version.schema.json
+    #   (b) commodité canonique présente dans le volet ingénierie (#9/#10)
+    #   (c) parser Publiciste consomme le projet sans erreur et retrouve le code
+    machine_ok, motifs = _prove_machine_lisible(projet_dir, code, files)
+
+    if not machine_ok:
+        # Honnêteté (#6) : on retire les 20 pts et on réécrit version.json.
+        bilan = scorer.score(brief, machine_lisible_pts=0)
+        version = renderer.render_version_json(brief, bilan, generated_at)
+        with open(os.path.join(projet_dir, "_META", "version.json"),
+                  "w", encoding="utf-8") as fh:
+            fh.write(json.dumps(version, ensure_ascii=False, indent=2) + "\n")
+        bilan["_machine_lisible_motifs"] = motifs
+
+    return projet_dir, bilan
+
+
+def _prove_machine_lisible(projet_dir: str, code: str,
+                           files: dict) -> tuple[bool, list[str]]:
+    motifs: list[str] = []
+
+    # (a) version.json valide.
+    with open(os.path.join(projet_dir, "_META", "version.json"), encoding="utf-8") as fh:
+        version = json.load(fh)
+    errs = pub_validator.validate(version, _load_version_schema())
+    if errs:
+        motifs += [f"version.json: {e}" for e in errs]
+
+    # (b) paramètres canoniques présents dans le volet ingénierie.
+    ing_md = files[os.path.join("40_ingenierie_faisabilite",
+                                "ingenierie_faisabilite.md")]
+    manquants = renderer.check_canonical(ing_md)
+    if manquants:
+        motifs.append("paramètres canoniques absents : " + ", ".join(manquants))
+
+    # (c) le parser Publiciste consomme le projet sans erreur.
+    try:
+        projet = pub_parser.parse_projet(projet_dir)
+        if projet.get("code") != code:
+            motifs.append(f"parser: code {projet.get('code')!r} != {code!r}")
+    except Exception as exc:  # noqa: BLE001 — on veut la raison exacte
+        motifs.append(f"parser a levé : {exc!r}")
+
+    return (not motifs), motifs
+
+
+# --------------------------------------------------------------------------- #
+def cmd_score(ns: argparse.Namespace) -> int:
+    with open(ns.brief, encoding="utf-8") as fh:
+        brief = json.load(fh)
+    _validate_brief(brief)
+    bilan = scorer.score(brief)
+    print(json.dumps(bilan, ensure_ascii=False, indent=2))
+    return 0
+
+
+def cmd_scaffold(ns: argparse.Namespace) -> int:
+    """Arborescence vide (placeholders) — utile pour amorcer un nouveau projet."""
+    brief = {"projet": ns.projet, "synthetique": False}
+    generated_at = ns.generated_at or _now_iso()
+    projet_dir, bilan = _generate_tree(brief, ns.out, generated_at)
+    _eprint(f"✅ scaffold {ns.projet} → {projet_dir} "
+            f"(statut={bilan['statut_faisabilite']}, score={bilan['score_4big']})")
+    _eprint(f"   {len(bilan['champs_manquants'])} champ(s) 🔴 à renseigner.")
+    return 0
+
+
+def cmd_generate(ns: argparse.Namespace) -> int:
+    with open(ns.brief, encoding="utf-8") as fh:
+        brief = json.load(fh)
+    generated_at = ns.generated_at or _now_iso()
+    projet_dir, bilan = _generate_tree(brief, ns.out, generated_at)
+
+    _eprint(f"✅ {brief['projet']} → {projet_dir}")
+    _eprint(f"   statut={bilan['statut_faisabilite']} · score 4Big={bilan['score_4big']}/100")
+    _eprint(f"   axes={bilan['axes']}")
+    if bilan["champs_manquants"]:
+        _eprint(f"   champs 🔴 manquants ({len(bilan['champs_manquants'])}) :")
+        for c in bilan["champs_manquants"]:
+            _eprint("     ·", c)
+    motifs = bilan.get("_machine_lisible_motifs")
+    if motifs:
+        _eprint("❌ preuve machine-lisible ÉCHOUÉE (axe 5 = 0) :")
+        for m in motifs:
+            _eprint("     ·", m)
+        return 1
+
+    # Un statut « complete » DOIT être publiable (#5) — sinon on alerte.
+    if bilan["statut_faisabilite"] == "complete" and bilan["score_4big"] < 95:
+        _eprint("❌ incohérence : complete avec score < 95.")
+        return 1
+    return 0
+
+
+def cmd_batch(ns: argparse.Namespace) -> int:
+    generated_at = ns.generated_at or _now_iso()
+    briefs = sorted(
+        f for f in os.listdir(ns.briefs_dir)
+        if f.endswith(".json") and not f.startswith(".")
+    )
+    if not briefs:
+        _eprint(f"⚠ aucun brief *.json dans {ns.briefs_dir}")
+        return 1
+    rc = 0
+    for fn in briefs:
+        with open(os.path.join(ns.briefs_dir, fn), encoding="utf-8") as fh:
+            brief = json.load(fh)
+        try:
+            projet_dir, bilan = _generate_tree(brief, ns.out, generated_at)
+        except Exception as exc:  # noqa: BLE001
+            _eprint(f"❌ {fn} : {exc}")
+            rc = 1
+            continue
+        flag = "⚠" if bilan.get("_machine_lisible_motifs") else "✅"
+        _eprint(f"{flag} {brief.get('projet')} · {bilan['statut_faisabilite']} · "
+                f"{bilan['score_4big']}/100 · {len(bilan['champs_manquants'])} 🔴")
+        if bilan.get("_machine_lisible_motifs"):
+            rc = 1
+    return rc
+
+
+# --------------------------------------------------------------------------- #
+def build_argparser() -> argparse.ArgumentParser:
+    ap = argparse.ArgumentParser(prog="faisabilite_gen",
+                                 description=__doc__.splitlines()[0])
+    sub = ap.add_subparsers(dest="cmd", required=True)
+
+    p = sub.add_parser("score", help="brief.json → bilan 4Big")
+    p.add_argument("brief")
+    p.set_defaults(func=cmd_score)
+
+    p = sub.add_parser("scaffold", help="PXX → arborescence vide (placeholders)")
+    p.add_argument("projet")
+    p.add_argument("-o", "--out", required=True, help="dossier data_room de sortie")
+    p.add_argument("--generated-at", dest="generated_at", default=None)
+    p.set_defaults(func=cmd_scaffold)
+
+    p = sub.add_parser("generate", help="brief.json → data_room/PXX/ (+ preuve)")
+    p.add_argument("brief")
+    p.add_argument("-o", "--out", required=True, help="dossier data_room de sortie")
+    p.add_argument("--generated-at", dest="generated_at", default=None)
+    p.set_defaults(func=cmd_generate)
+
+    p = sub.add_parser("batch", help="dossier de briefs → data_room/")
+    p.add_argument("briefs_dir")
+    p.add_argument("-o", "--out", required=True)
+    p.add_argument("--generated-at", dest="generated_at", default=None)
+    p.set_defaults(func=cmd_batch)
+    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())

05_deliverables_mvp/faisabilite/generator/fixtures/brief_complete.json

@@ -0,0 +1,95 @@
+{
+  "projet": "P01",
+  "nom": "Résidence Fixture Alpha",
+  "synthetique": true,
+  "sources": [
+    "SYNTHÉTIQUE — archive fictive brief_alpha_2026.pdf",
+    "SYNTHÉTIQUE — taux BCRD fictif 2026-07-01"
+  ],
+  "masterplan": {
+    "localisation": "Province Fixture · Municipalité Alpha · 19.0000, -70.0000",
+    "terrain_m2": 12000,
+    "terrain_tareas": 190,
+    "zonage": "Résidentiel touristique",
+    "nb_unites": 40,
+    "nb_phases": 2,
+    "cos": "0.35",
+    "acces": "Route principale à 5 min · aéroport 40 min · plage 3 min",
+    "ref_plan_masse": "plan_masse_alpha_v3.dwg",
+    "phasage": "Phase 1 (24 unités) puis Phase 2 (16 unités) au seuil 52 % pré-vente"
+  },
+  "architecture": {
+    "parti_archi": "Contemporain tropical, matérialité pierre + bois local",
+    "nb_batiments": 3,
+    "nb_niveaux": 4,
+    "ref_rendus": "60_photos_site/",
+    "taux_conversion": {
+      "taux": 59.0,
+      "date": "2026-07-01",
+      "source": "SYNTHÉTIQUE — BCRD fictif"
+    },
+    "typologies": [
+      {
+        "nom": "Studio",
+        "quantite": 12,
+        "surface_interieure_m2": 45,
+        "surface_terrasse_m2": 10,
+        "surface_totale_m2": 55,
+        "prix_usd": 150000,
+        "prix_dop": 8850000
+      },
+      {
+        "nom": "1 Chambre",
+        "quantite": 20,
+        "surface_interieure_m2": 68,
+        "surface_terrasse_m2": 15,
+        "surface_totale_m2": 83,
+        "prix_usd": 210000,
+        "prix_dop": 12390000
+      },
+      {
+        "nom": "2 Chambres",
+        "quantite": 8,
+        "surface_interieure_m2": 95,
+        "surface_terrasse_m2": 25,
+        "surface_totale_m2": 120,
+        "prix_usd": 320000,
+        "prix_dop": 18880000
+      }
+    ]
+  },
+  "paysage": {
+    "concept_paysage": "Jardins tropicaux étagés, plans d'eau et circulations douces piétonnes",
+    "amenities": [
+      "Piscine à débordement",
+      "Beach club",
+      "Spa & gym"
+    ],
+    "services_inclus": [
+      "Conciergerie 24/7",
+      "Sécurité périmétrique",
+      "Gestion locative optionnelle",
+      "Régime CONFOTUR (exonération fiscale)",
+      "Structure Fideicomiso"
+    ],
+    "experience": "Parcours investisseur clé-en-main, de la visite à la mise en location",
+    "durabilite": "Panneaux solaires, récupération d'eau de pluie, éclairage LED"
+  },
+  "ingenierie": {
+    "structure": "Béton armé, fondations superficielles sur bon sol",
+    "reseaux": "Raccordement réseau + forage d'appoint + station eaux usées",
+    "contraintes_site": "Topographie douce, aucun risque d'inondation recensé",
+    "cout_construction_usd": 9000000,
+    "revenu_brut_usd": 14200000,
+    "marge_pct": 28,
+    "regime_fiscal": "CONFOTUR + Fideicomiso"
+  },
+  "commercial": {
+    "positionnement_fr": "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."
+  },
+  "rendus": [
+    { "fichier": "hero_aerien.jpg", "vue": "Vue aérienne", "hero": true },
+    { "fichier": "piscine.jpg", "vue": "Piscine à débordement", "hero": false },
+    { "fichier": "lobby.jpg", "vue": "Lobby", "hero": false }
+  ]
+}

05_deliverables_mvp/faisabilite/generator/fixtures/brief_incomplete.json

@@ -0,0 +1,53 @@
+{
+  "projet": "P02",
+  "nom": "Résidence Fixture Beta",
+  "synthetique": true,
+  "sources": [],
+  "masterplan": {
+    "localisation": "Province Fixture · Municipalité Beta",
+    "terrain_m2": 8000,
+    "terrain_tareas": 127,
+    "zonage": "Résidentiel touristique",
+    "nb_unites": 30,
+    "nb_phases": 1,
+    "phasage": "Phase unique après seuil 52 % pré-vente"
+  },
+  "architecture": {
+    "parti_archi": "Contemporain minimaliste",
+    "nb_batiments": 2,
+    "nb_niveaux": 5,
+    "typologies": [
+      {
+        "nom": "1 Chambre",
+        "quantite": 18,
+        "surface_interieure_m2": 62,
+        "surface_terrasse_m2": 12,
+        "surface_totale_m2": 74,
+        "prix_usd": null,
+        "prix_dop": null
+      },
+      {
+        "nom": "2 Chambres",
+        "quantite": 12,
+        "surface_interieure_m2": 90,
+        "surface_terrasse_m2": 20,
+        "surface_totale_m2": 110,
+        "prix_usd": null,
+        "prix_dop": null
+      }
+    ]
+  },
+  "paysage": {
+    "concept_paysage": "Patios végétalisés",
+    "amenities": ["Piscine"],
+    "services_inclus": ["Sécurité 24/7"]
+  },
+  "ingenierie": {
+    "cout_construction_usd": null,
+    "revenu_brut_usd": null,
+    "marge_pct": null
+  },
+  "commercial": {
+    "positionnement_fr": "Un projet résidentiel en cours de faisabilité — les prix seront confirmés après validation des sources archives."
+  }
+}

05_deliverables_mvp/faisabilite/generator/genlib/__init__.py

@@ -0,0 +1,18 @@
+"""Générateur Faisabilité 4 volets — bibliothèque.
+
+Livrable Faisabilité · Sprint 2 (`03_agents/faisabilite/AGENT.md` §Livrable S2 :
+« Générateur 4 volets automatique »). Cible de portage VPS :
+`otoia/capabilities/faisabilite_agent.py`.
+
+Chaîne de valeur (ferme la boucle avec le Publiciste déjà livré) :
+
+    brief.json ──► renderer ──► data_room/PXX/ (template v1.0)
+                                     │
+                                     ▼
+                     publiciste.parser ──► projets_master.json ──► site
+
+Le module NE FABRIQUE JAMAIS de chiffre (CLAUDE.md #6) : un champ 🔴 absent du
+brief reste un placeholder `{{…}}`, est listé dans `champs_manquants`, et
+rétrograde le statut de la faisabilité (jamais « complete » avec une donnée
+douteuse).
+"""

05_deliverables_mvp/faisabilite/generator/genlib/model.py

@@ -0,0 +1,113 @@
+"""Modèle de données du générateur : constantes canoniques + champs requis.
+
+Sépare les VALEURS CANONIQUES (imposées par CLAUDE.md, jamais issues du brief —
+donc jamais « inventées » projet par projet) de la structure des champs 🔴/🟡 du
+template v1.0 (§2-§5).
+"""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+# --------------------------------------------------------------------------- #
+# Version du template canonique consommé (doit rester alignée sur
+# TEMPLATE_FAISABILITE_CANONIQUE_v1.0.md §8 · version.schema.json pattern).
+# --------------------------------------------------------------------------- #
+TEMPLATE_VERSION = "1.0.0"
+
+# --------------------------------------------------------------------------- #
+# Paramètres CANONIQUES CLAUDE.md #9/#10. Émis TELS QUELS par le générateur pour
+# TOUS les projets. Ne proviennent JAMAIS du brief → aucune invention possible.
+# --------------------------------------------------------------------------- #
+CANONICAL = {
+    "frais_edition_pct": "3 %",
+    "marketing_pct": "8.5 %",
+    "point_equilibre_pct": "52 %",
+    "devises": "USD + DOP",
+    "paiement": "Cardnet",
+    "format_doc": "Letter US",
+}
+
+# Ordre canonique des 4 volets (version.schema.json enum + parser).
+VOLETS = ["masterplan", "architecture", "paysage_experience", "ingenierie"]
+
+# --------------------------------------------------------------------------- #
+# Champs OBLIGATOIRES (🔴) par volet — cf. tableaux §2-§5 du template.
+# Un 🔴 absent ⇒ champs_manquants ⇒ rétrogradation (jamais « complete »).
+# Les typologies (§3.2, bloc anti-gap) sont traitées à part par le scorer.
+# --------------------------------------------------------------------------- #
+REQUIRED = {
+    "masterplan": [
+        "localisation",       # 1.1
+        "terrain_m2",         # 1.2
+        "terrain_tareas",     # 1.2
+        "zonage",             # 1.3
+        "nb_unites",          # 1.4
+        "nb_phases",          # 1.4
+        "phasage",            # 1.8
+    ],
+    "architecture": [
+        "parti_archi",        # 2.1
+        "nb_batiments",       # 2.2
+        "nb_niveaux",         # 2.3
+    ],
+    "paysage_experience": [
+        "concept_paysage",    # 3.1
+        "amenities",          # 3.2
+        "services_inclus",    # 3.3
+    ],
+    "ingenierie": [
+        "cout_construction_usd",  # 4.4
+        "revenu_brut_usd",        # 4.8
+        "marge_pct",              # 4.9
+    ],
+}
+
+# Colonnes 🔴 d'une typologie (§3.2). Toutes requises pour lever le blocage prix.
+TYPO_REQUIRED = [
+    "nom",
+    "quantite",
+    "surface_interieure_m2",
+    "surface_terrasse_m2",
+    "surface_totale_m2",
+    "prix_usd",
+    "prix_dop",
+]
+
+# Placeholders signalant l'absence (alignés sur publiciste.parser._ABSENT).
+_PLACEHOLDER_ABSENT = {
+    "", "—", "-", "n/d", "nd", "non défini", "non defini", "à définir",
+    "a definir", "tbd", "todo", "…", "...",
+}
+
+
+def is_filled(value: Any) -> bool:
+    """True si `value` est une donnée réelle exploitable (pas un placeholder).
+
+    - None / cellule vide / « non défini » / `{{…}}` → False
+    - liste vide → False, liste non vide → True
+    - 0 numérique → True (un vrai zéro sourcé est une donnée valide)
+    """
+    if value is None:
+        return False
+    if isinstance(value, bool):
+        return True
+    if isinstance(value, (int, float)):
+        return True
+    if isinstance(value, (list, tuple)):
+        return len(value) > 0
+    if isinstance(value, dict):
+        return len(value) > 0
+    text = str(value).strip().lower()
+    if not text:
+        return False
+    if "{{" in text and "}}" in text:
+        return False
+    return text not in _PLACEHOLDER_ABSENT
+
+
+def get(section: Optional[dict], key: str) -> Any:
+    """Accès défensif à une clé de section de brief (None si absente)."""
+    if not isinstance(section, dict):
+        return None
+    return section.get(key)

05_deliverables_mvp/faisabilite/generator/genlib/renderer.py

@@ -0,0 +1,310 @@
+"""Rendu Markdown des 4 volets + version.json à partir d'un brief.
+
+Les en-têtes de sections et les colonnes de tableaux reproduisent EXACTEMENT
+ceux attendus par `publiciste.parser` (mapping par en-tête) — c'est ce qui
+garantit le round-trip generator → parser sans perte. Toute donnée absente du
+brief est rendue en placeholder `{{…}}` (jamais un chiffre inventé — #6).
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from typing import Any, Optional
+
+from . import model
+
+
+# --------------------------------------------------------------------------- #
+# Helpers de rendu de valeurs (placeholder si absent).
+# --------------------------------------------------------------------------- #
+def _v(value: Any, placeholder: str) -> str:
+    """Valeur réelle ou placeholder `{{placeholder}}` si absente (#6)."""
+    if not model.is_filled(value):
+        return "{{" + placeholder + "}}"
+    return str(value)
+
+
+def _money(value: Any, devise: str, placeholder: str) -> str:
+    """« USD 250,000 » / « DOP 14,750,000 ». Placeholder si absent (jamais 0)."""
+    if not model.is_filled(value):
+        return "{{" + placeholder + "}}"
+    try:
+        n = float(value)
+    except (TypeError, ValueError):
+        return "{{" + placeholder + "}}"
+    entier = f"{n:,.0f}" if n == int(n) else f"{n:,.2f}"
+    return f"{devise} {entier}"
+
+
+def _num(value: Any, placeholder: str) -> str:
+    if not model.is_filled(value):
+        return "{{" + placeholder + "}}"
+    return str(value)
+
+
+def _synth_banner(brief: dict) -> str:
+    if brief.get("synthetique"):
+        return ("> ⚠️ FIXTURE SYNTHÉTIQUE — données fictives de test. Ne jamais "
+                "publier (CLAUDE.md #6).\n\n")
+    return ""
+
+
+# --------------------------------------------------------------------------- #
+# 00_brief/brief.md  (parser : H1 = nom · ligne « Localisation : … »)
+# --------------------------------------------------------------------------- #
+def render_brief(brief: dict) -> str:
+    mp = brief.get("masterplan") or {}
+    nom = _v(brief.get("nom"), "nom")
+    return (
+        f"# {nom}\n\n"
+        f"{_synth_banner(brief)}"
+        f"- **Localisation** : {_v(mp.get('localisation'), 'localisation')}\n"
+        f"- Superficie terrain : {_num(mp.get('terrain_m2'), 'terrain_m2')} m² / "
+        f"{_num(mp.get('terrain_tareas'), 'terrain_tareas')} tareas\n"
+        f"- Zonage : {_v(mp.get('zonage'), 'zonage')}\n"
+        f"- Accès : {_v(mp.get('acces'), 'acces')}\n"
+    )
+
+
+# --------------------------------------------------------------------------- #
+# 10_masterplan/masterplan.md  (§2)
+# --------------------------------------------------------------------------- #
+def render_masterplan(brief: dict) -> str:
+    mp = brief.get("masterplan") or {}
+    return (
+        "# Volet 1 · Masterplan\n\n"
+        f"{_synth_banner(brief)}"
+        f"- 1.1 Localisation : {_v(mp.get('localisation'), 'localisation')}\n"
+        f"- 1.2 Superficie terrain : {_num(mp.get('terrain_m2'), 'terrain_m2')} m² / "
+        f"{_num(mp.get('terrain_tareas'), 'terrain_tareas')} tareas\n"
+        f"- 1.3 Zonage / usage : {_v(mp.get('zonage'), 'zonage')}\n"
+        f"- 1.4 Densité programme : {_num(mp.get('nb_unites'), 'nb_unites')} unités · "
+        f"{_num(mp.get('nb_phases'), 'nb_phases')} phase(s)\n"
+        f"- 1.5 Emprise au sol / COS : {_v(mp.get('cos'), 'cos')}\n"
+        f"- 1.6 Accès & mobilité : {_v(mp.get('acces'), 'acces')}\n"
+        f"- 1.7 Plan de masse : {_v(mp.get('ref_plan_masse'), 'ref_plan_masse')}\n"
+        f"- 1.8 Phasage développement : {_v(mp.get('phasage'), 'phasage')}\n"
+    )
+
+
+# --------------------------------------------------------------------------- #
+# 20_architecture/architecture.md  (§3 · bloc anti-gap §3.2)
+# --------------------------------------------------------------------------- #
+_ARCHI_HEADER = (
+    "| Typologie | Nb unités | Surface intérieure (m²) | Surface terrasse (m²) | "
+    "Surface totale (m²) | Prix « à partir de » (USD) | Prix (DOP) |\n"
+    "|---|---|---|---|---|---|---|\n"
+)
+
+
+def render_architecture(brief: dict) -> str:
+    archi = brief.get("architecture") or {}
+    typos = archi.get("typologies") or []
+
+    rows = ""
+    if typos:
+        for i, t in enumerate(typos):
+            rows += (
+                f"| {_v(t.get('nom'), f'typo_{i+1}_nom')} "
+                f"| {_num(t.get('quantite'), f'typo_{i+1}_qte')} "
+                f"| {_num(t.get('surface_interieure_m2'), f'typo_{i+1}_int')} "
+                f"| {_num(t.get('surface_terrasse_m2'), f'typo_{i+1}_terrasse')} "
+                f"| {_num(t.get('surface_totale_m2'), f'typo_{i+1}_total')} "
+                f"| {_money(t.get('prix_usd'), 'USD', f'typo_{i+1}_prix_usd')} "
+                f"| {_money(t.get('prix_dop'), 'DOP', f'typo_{i+1}_prix_dop')} |\n"
+            )
+    else:
+        # Ligne-placeholder : le parser la saute, le bloc anti-gap reste visiblement vide.
+        rows = ("| {{typo_1_nom}} | {{typo_1_qte}} | {{typo_1_int}} | "
+                "{{typo_1_terrasse}} | {{typo_1_total}} | {{typo_1_prix_usd}} | "
+                "{{typo_1_prix_dop}} |\n")
+
+    taux = archi.get("taux_conversion") or {}
+    taux_line = (
+        f"\n_Taux de conversion USD↔DOP : {_v(taux.get('taux'), 'taux')} "
+        f"(source {_v(taux.get('source'), 'taux_source')}, "
+        f"{_v(taux.get('date'), 'taux_date')})._\n"
+    )
+
+    return (
+        "# Volet 2 · Architecture\n\n"
+        f"{_synth_banner(brief)}"
+        "## 3.1 Champs généraux\n"
+        f"- Parti architectural : {_v(archi.get('parti_archi'), 'parti_archi')}\n"
+        f"- Nb de bâtiments / blocs : {_num(archi.get('nb_batiments'), 'nb_batiments')}\n"
+        f"- Niveaux (étages) : {_num(archi.get('nb_niveaux'), 'nb_niveaux')}\n"
+        f"- Rendus référence : {_v(archi.get('ref_rendus'), 'ref_rendus')}\n\n"
+        "## 3.2 Tableau des typologies\n\n"
+        f"{_ARCHI_HEADER}{rows}{taux_line}"
+    )
+
+
+# --------------------------------------------------------------------------- #
+# 30_paysage_experience/paysage_experience.md  (§4)
+# --------------------------------------------------------------------------- #
+def _bullets(items: Optional[list], placeholder: str) -> str:
+    if not model.is_filled(items):
+        return f"- {{{{{placeholder}}}}}\n"
+    return "".join(f"- {str(it).strip()}\n" for it in items)
+
+
+def render_paysage(brief: dict) -> str:
+    p = brief.get("paysage") or {}
+    return (
+        "# Volet 3 · Paysage & Expérience\n\n"
+        f"{_synth_banner(brief)}"
+        "## 3.1 Concept paysager\n"
+        f"{_v(p.get('concept_paysage'), 'concept_paysage')}\n\n"
+        "## 3.2 Amenities / équipements\n"
+        f"{_bullets(p.get('amenities'), 'amenities')}\n"
+        "## 3.3 Services inclus\n"
+        f"{_bullets(p.get('services_inclus'), 'services_inclus')}\n"
+        "## 3.4 Expérience résident/investisseur\n"
+        f"{_v(p.get('experience'), 'experience')}\n\n"
+        "## 3.5 Durabilité / environnement\n"
+        f"{_v(p.get('durabilite'), 'durabilite')}\n"
+    )
+
+
+# --------------------------------------------------------------------------- #
+# 40_ingenierie_faisabilite/ingenierie_faisabilite.md  (§5 · params canoniques #9/#10)
+# --------------------------------------------------------------------------- #
+def render_ingenierie(brief: dict) -> str:
+    ing = brief.get("ingenierie") or {}
+    c = model.CANONICAL
+    return (
+        "# Volet 4 · Ingénierie & Faisabilité\n\n"
+        f"{_synth_banner(brief)}"
+        "## 5.1 Technique\n"
+        f"- 4.1 Systèmes structurels : {_v(ing.get('structure'), 'structure')}\n"
+        f"- 4.2 Réseaux (eau/élec/eaux usées) : {_v(ing.get('reseaux'), 'reseaux')}\n"
+        f"- 4.3 Contraintes site : {_v(ing.get('contraintes_site'), 'contraintes_site')}\n\n"
+        "## 5.2 Financier bancable (paramètres canoniques)\n"
+        f"- 4.4 Coût de construction total : "
+        f"{_money(ing.get('cout_construction_usd'), 'USD', 'cout_construction')}\n"
+        f"- 4.5 Frais d'édition documentaire : {c['frais_edition_pct']} (fixe · #9)\n"
+        f"- 4.6 Budget marketing : {c['marketing_pct']} (fixe · #9)\n"
+        f"- 4.7 Point d'équilibre pré-vente : {c['point_equilibre_pct']} (fixe · #9)\n"
+        f"- 4.8 Revenu brut de vente projeté : "
+        f"{_money(ing.get('revenu_brut_usd'), 'USD', 'revenu_brut')}\n"
+        f"- 4.9 Marge projetée : {_num(ing.get('marge_pct'), 'marge')} %\n"
+        f"- 4.10 Devises : {c['devises']} (#10)\n"
+        f"- 4.11 Moyen de paiement : {c['paiement']} (#10)\n"
+        f"- 4.12 Format documents : {c['format_doc']} (#10)\n"
+        f"- 4.13 Régime fiscal : {_v(ing.get('regime_fiscal'), 'regime_fiscal')}\n"
+    )
+
+
+# --------------------------------------------------------------------------- #
+# 40_llm_outputs/commercial.md  (parser : 1er paragraphe = positionnement FR)
+# --------------------------------------------------------------------------- #
+def render_commercial(brief: dict) -> str:
+    com = brief.get("commercial") or {}
+    positionnement = com.get("positionnement_fr")
+    body = (
+        str(positionnement).strip()
+        if model.is_filled(positionnement)
+        else "{{positionnement_fr}}"
+    )
+    typos = (brief.get("architecture") or {}).get("typologies") or []
+    prix0 = None
+    for t in typos:
+        if model.is_filled(t.get("prix_usd")):
+            prix0 = t.get("prix_usd")
+            break
+    prix_line = (
+        f"prix « à partir de » {_money(prix0, 'USD', 'prix')}."
+        if prix0 is not None
+        else "prix « à partir de » à confirmer (faisabilité en cours)."
+    )
+    return (
+        "# Commercial\n\n"
+        f"{_synth_banner(brief)}"
+        f"{body}\n\n"
+        "## Typologies (miroir §3.2)\n"
+        f"Voir le tableau de l'architecture — {prix_line}\n"
+    )
+
+
+# --------------------------------------------------------------------------- #
+# 60_photos_site/README.md  (parser : table Fichier | Vue | Hero)
+# --------------------------------------------------------------------------- #
+def render_photos_manifest(brief: dict) -> str:
+    rendus = brief.get("rendus") or []
+    head = (
+        "# Manifeste rendus\n\n"
+        f"{_synth_banner(brief)}"
+        "> Rendus liés au projet réel obligatoires en production (❌ IA générique).\n\n"
+        "| Fichier | Vue | Hero |\n|---|---|---|\n"
+    )
+    if not rendus:
+        return head + "| {{rendu_1_fichier}} | {{rendu_1_vue}} | hero |\n"
+    rows = ""
+    for i, r in enumerate(rendus):
+        hero = "hero" if r.get("hero") else "non"
+        rows += (
+            f"| {_v(r.get('fichier'), f'rendu_{i+1}_fichier')} "
+            f"| {_v(r.get('vue'), f'rendu_{i+1}_vue')} | {hero} |\n"
+        )
+    return head + rows
+
+
+# --------------------------------------------------------------------------- #
+# _META/version.json
+# --------------------------------------------------------------------------- #
+def render_version_json(brief: dict, bilan: dict, generated_at: str,
+                        archive_precedente: Optional[str] = None) -> dict:
+    version = {
+        "projet": brief["projet"],
+        "template_version": model.TEMPLATE_VERSION,
+        "generated_at": generated_at,
+        "score_4big": bilan["score_4big"],
+        "statut_faisabilite": bilan["statut_faisabilite"],
+        "volets_complets": bilan["volets_complets"],
+        "champs_manquants": bilan["champs_manquants"],
+    }
+    if archive_precedente is not None:
+        version["archive_precedente"] = archive_precedente
+    return version
+
+
+# --------------------------------------------------------------------------- #
+# Vérification des paramètres canoniques dans le rendu (axe 4, honnêteté).
+# --------------------------------------------------------------------------- #
+_CANONICAL_MARKERS = ["3 %", "8.5 %", "52 %", "USD + DOP", "Cardnet", "Letter US"]
+
+
+def check_canonical(ingenierie_md: str) -> list[str]:
+    """Retourne la liste des marqueurs canoniques ABSENTS du volet ingénierie."""
+    return [m for m in _CANONICAL_MARKERS if m not in ingenierie_md]
+
+
+# --------------------------------------------------------------------------- #
+# Arborescence complète (§1 du template).
+# --------------------------------------------------------------------------- #
+# Répertoires exigés vides → .gitkeep (règle d'homogénéité §1).
+_EMPTY_DIRS = ["50_financier_bancable"]
+
+
+def render_files(brief: dict, bilan: dict, generated_at: str) -> dict[str, str]:
+    """Retourne {chemin_relatif: contenu} pour toute l'arborescence PXX/."""
+    files = {
+        os.path.join("00_brief", "brief.md"): render_brief(brief),
+        os.path.join("10_masterplan", "masterplan.md"): render_masterplan(brief),
+        os.path.join("20_architecture", "architecture.md"): render_architecture(brief),
+        os.path.join("30_paysage_experience", "paysage_experience.md"): render_paysage(brief),
+        os.path.join("40_ingenierie_faisabilite", "ingenierie_faisabilite.md"):
+            render_ingenierie(brief),
+        os.path.join("40_llm_outputs", "commercial.md"): render_commercial(brief),
+        os.path.join("60_photos_site", "README.md"): render_photos_manifest(brief),
+        os.path.join("_META", "version.json"):
+            json.dumps(
+                render_version_json(brief, bilan, generated_at),
+                ensure_ascii=False,
+                indent=2,
+            ) + "\n",
+    }
+    for d in _EMPTY_DIRS:
+        files[os.path.join(d, ".gitkeep")] = ""
+    return files

05_deliverables_mvp/faisabilite/generator/genlib/scorer.py

@@ -0,0 +1,176 @@
+"""Scoring 4Big (§7 du template canonique) + dérivation du statut faisabilité.
+
+Barème (20 pts × 5 axes = 100) — reproduit fidèlement §7 :
+  1. Complétude          — 4 volets présents + champs 🔴 remplis à 100 %
+  2. Anti-gap prix       — tableau typologies §3.2 complet (aucun prix manquant)
+  3. Traçabilité         — chiffres sourcés (sources[] + taux de conversion daté)
+  4. Paramètres canon.   — 3 % / 8.5 % / 52 % · USD+DOP · Letter US · Cardnet
+  5. Machine-lisible     — version.json valide + extraction Publiciste OK
+
+Axes 1-4 : calculés à partir du brief (déterministe, sans invention #6).
+Axe 5    : GARANTI PAR CONSTRUCTION (le renderer produit une arborescence
+           conforme au parser + un version.json conforme au schéma). Le CLI le
+           PROUVE après génération (re-parse + validation) et échoue bruyamment
+           sinon — le score n'est donc jamais auto-décerné à l'aveugle.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from . import model
+
+_SEUIL_PUBLIABLE = 95  # CLAUDE.md #5 · version.schema.json (complete ⇒ score>=95)
+
+
+def _score_completude(brief: dict) -> tuple[int, list[str], list[str]]:
+    """Axe 1 → (points/20, volets_complets, champs_manquants).
+
+    Un volet est « complet » si TOUS ses champs 🔴 sont remplis. Pour
+    l'architecture, la présence d'au moins une typologie est aussi exigée.
+    """
+    total = 0
+    filled = 0
+    champs_manquants: list[str] = []
+    volets_complets: list[str] = []
+
+    for volet in model.VOLETS:
+        section = brief.get(_brief_key(volet))
+        volet_ok = True
+        for champ in model.REQUIRED[volet]:
+            total += 1
+            if model.is_filled(model.get(section, champ)):
+                filled += 1
+            else:
+                volet_ok = False
+                champs_manquants.append(f"{volet}.{champ}")
+        # L'architecture exige aussi au moins une typologie renseignée (§3.2).
+        if volet == "architecture":
+            typos = model.get(section, "typologies") or []
+            if not typos:
+                volet_ok = False
+                if "architecture.typologies" not in champs_manquants:
+                    champs_manquants.append("architecture.typologies")
+        if volet_ok:
+            volets_complets.append(volet)
+
+    pts = round(20 * filled / total) if total else 0
+    return pts, volets_complets, champs_manquants
+
+
+def _score_anti_gap_prix(brief: dict) -> tuple[int, list[str]]:
+    """Axe 2 → (points/20, champs_manquants typologies).
+
+    Chaque typologie doit renseigner ses 7 cellules 🔴 (§3.2). Le score est la
+    fraction de cellules 🔴 réellement remplies ; 0 s'il n'existe aucune typologie.
+    """
+    archi = brief.get("architecture") or {}
+    typos = archi.get("typologies") or []
+    if not typos:
+        return 0, ["architecture.typologies (aucune typologie — bloc anti-gap vide)"]
+
+    total = len(typos) * len(model.TYPO_REQUIRED)
+    filled = 0
+    manquants: list[str] = []
+    for i, typo in enumerate(typos):
+        for champ in model.TYPO_REQUIRED:
+            if model.is_filled(model.get(typo, champ)):
+                filled += 1
+            else:
+                manquants.append(f"architecture.typologies[{i}].{champ}")
+    pts = round(20 * filled / total) if total else 0
+    return pts, manquants
+
+
+def _score_tracabilite(brief: dict) -> tuple[int, list[str]]:
+    """Axe 3 → (points/20, remarques).
+
+    10 pts : `sources[]` non vide (chaque chiffre rattachable à une archive).
+    10 pts : `architecture.taux_conversion` avec `date` ET `source` (règle §3.2 :
+             le taux USD↔DOP doit être daté et sourcé — jamais inventé).
+    """
+    pts = 0
+    remarques: list[str] = []
+    if model.is_filled(brief.get("sources")):
+        pts += 10
+    else:
+        remarques.append("sources[] absent — traçabilité des chiffres non établie")
+
+    taux = (brief.get("architecture") or {}).get("taux_conversion") or {}
+    if model.is_filled(taux.get("date")) and model.is_filled(taux.get("source")):
+        pts += 10
+    else:
+        remarques.append("architecture.taux_conversion.{date,source} incomplet (§3.2)")
+    return pts, remarques
+
+
+def _score_parametres_canoniques() -> int:
+    """Axe 4 → 20/20. Garanti : le renderer émet toujours les 6 paramètres
+    canoniques (3 % / 8.5 % / 52 % · USD+DOP · Letter US · Cardnet).
+    Le CLI vérifie leur présence dans le rendu (`renderer.check_canonical`)."""
+    return 20
+
+
+def score(brief: dict, machine_lisible_pts: int = 20) -> dict[str, Any]:
+    """Calcule le bilan 4Big complet + le statut faisabilité.
+
+    `machine_lisible_pts` (axe 5) vaut 20 par construction ; le CLI le remplace
+    par le résultat réel de la re-validation après génération.
+    """
+    pts1, volets_complets, champs1 = _score_completude(brief)
+    pts2, champs2 = _score_anti_gap_prix(brief)
+    pts3, remarques3 = _score_tracabilite(brief)
+    pts4 = _score_parametres_canoniques()
+
+    champs_manquants = _dedupe(champs1 + champs2)
+    total = pts1 + pts2 + pts3 + pts4 + machine_lisible_pts
+
+    statut = _statut(total, champs_manquants, volets_complets, pts2)
+
+    return {
+        "score_4big": total,
+        "statut_faisabilite": statut,
+        "volets_complets": volets_complets,
+        "champs_manquants": champs_manquants,
+        "axes": {
+            "completude": pts1,
+            "anti_gap_prix": pts2,
+            "tracabilite": pts3,
+            "parametres_canoniques": pts4,
+            "machine_lisible": machine_lisible_pts,
+        },
+        "remarques": remarques3,
+    }
+
+
+def _statut(total: int, champs_manquants: list[str], volets_complets: list[str],
+            pts_prix: int) -> str:
+    """« complete » exige le seuil publiable (#5) ET aucun champ 🔴 manquant ET
+    le bloc prix intégral ET les 4 volets — cohérent avec version.schema.json.
+    Sinon « en_developpement », ou « incomplete » si aucun volet abouti."""
+    prix_complet = pts_prix >= 20
+    if (
+        total >= _SEUIL_PUBLIABLE
+        and not champs_manquants
+        and prix_complet
+        and len(volets_complets) >= 4
+    ):
+        return "complete"
+    if not volets_complets:
+        return "incomplete"
+    return "en_developpement"
+
+
+def _brief_key(volet: str) -> str:
+    """Le brief utilise « paysage » pour le volet « paysage_experience »."""
+    return "paysage" if volet == "paysage_experience" else volet
+
+
+def _dedupe(items: list[str]) -> list[str]:
+    seen: set[str] = set()
+    out: list[str] = []
+    for it in items:
+        if it not in seen:
+            seen.add(it)
+            out.append(it)
+    return out

05_deliverables_mvp/faisabilite/generator/tests/test_generator.py

@@ -0,0 +1,243 @@
+"""Tests du générateur Faisabilité 4 volets (stdlib `unittest`, zéro pip).
+
+Couvre : scoring 4Big, rétrogradation défensive (#6), rendu conforme au template,
+paramètres canoniques (#9/#10), et surtout le ROUND-TRIP end-to-end
+generator → parser Publiciste → projets_master.json (validé contre le schéma).
+
+Un oracle `jsonschema` est utilisé EN PLUS s'il est installé.
+"""
+
+import importlib.util
+import json
+import os
+import shutil
+import sys
+import tempfile
+import unittest
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_GEN = os.path.normpath(os.path.join(_HERE, ".."))            # generator/
+_PUB = os.path.normpath(os.path.join(_GEN, "..", "..", "publiciste"))
+_FAIS = os.path.normpath(os.path.join(_GEN, ".."))            # faisabilite/ (schémas)
+
+sys.path.insert(0, _PUB)
+sys.path.insert(0, _GEN)
+
+from genlib import model, renderer, scorer  # noqa: E402,F401  (generator/genlib)
+
+
+def _load_gen_cli():
+    """Charge faisabilite_gen.py comme module isolé (évite collision `lib`)."""
+    spec = importlib.util.spec_from_file_location(
+        "faisabilite_gen", os.path.join(_GEN, "faisabilite_gen.py")
+    )
+    mod = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(mod)
+    return mod
+
+
+def _pub():
+    """(parser, validator) du Publiciste, importés depuis publiciste/lib."""
+    import lib.parser as pub_parser  # noqa: PLC0415
+    import lib.validator as pub_validator  # noqa: PLC0415
+    return pub_parser, pub_validator
+
+
+def _brief(name):
+    with open(os.path.join(_GEN, "fixtures", name), encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+def _schema(name):
+    with open(os.path.join(_FAIS, name), encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+_FIXED_TS = "2026-07-30T00:00:00Z"
+
+
+class ScorerTest(unittest.TestCase):
+    def test_complete_brief_scores_publiable(self):
+        bilan = scorer.score(_brief("brief_complete.json"))
+        self.assertEqual(bilan["statut_faisabilite"], "complete")
+        self.assertGreaterEqual(bilan["score_4big"], 95)
+        self.assertEqual(bilan["champs_manquants"], [])
+        self.assertEqual(len(bilan["volets_complets"]), 4)
+        self.assertEqual(bilan["axes"]["anti_gap_prix"], 20)
+
+    def test_incomplete_brief_is_downgraded(self):
+        bilan = scorer.score(_brief("brief_incomplete.json"))
+        self.assertNotEqual(bilan["statut_faisabilite"], "complete")
+        self.assertLess(bilan["score_4big"], 95)
+        # Les prix manquants doivent figurer explicitement (anti-gap).
+        joined = " ".join(bilan["champs_manquants"])
+        self.assertIn("prix_usd", joined)
+        self.assertIn("prix_dop", joined)
+
+    def test_missing_required_field_listed(self):
+        b = _brief("brief_complete.json")
+        b["masterplan"]["phasage"] = None
+        bilan = scorer.score(b)
+        self.assertIn("masterplan.phasage", bilan["champs_manquants"])
+        self.assertNotIn("masterplan", bilan["volets_complets"])
+        self.assertNotEqual(bilan["statut_faisabilite"], "complete")
+
+    def test_no_typologies_zeroes_anti_gap(self):
+        b = _brief("brief_complete.json")
+        b["architecture"]["typologies"] = []
+        bilan = scorer.score(b)
+        self.assertEqual(bilan["axes"]["anti_gap_prix"], 0)
+        self.assertNotIn("architecture", bilan["volets_complets"])
+
+    def test_empty_brief_is_incomplete(self):
+        bilan = scorer.score({"projet": "P03"})
+        self.assertEqual(bilan["statut_faisabilite"], "incomplete")
+        self.assertEqual(bilan["volets_complets"], [])
+
+
+class RendererTest(unittest.TestCase):
+    def test_canonical_params_always_present(self):
+        # Même un brief quasi vide émet les 6 paramètres canoniques (#9/#10).
+        md = renderer.render_ingenierie({"projet": "P03"})
+        self.assertEqual(renderer.check_canonical(md), [])
+        for marker in ["3 %", "8.5 %", "52 %", "USD + DOP", "Cardnet", "Letter US"]:
+            self.assertIn(marker, md)
+
+    def test_missing_price_is_placeholder_not_invented(self):
+        md = renderer.render_architecture(_brief("brief_incomplete.json"))
+        # Aucun prix inventé : les cellules USD/DOP restent des placeholders.
+        self.assertIn("{{typo_1_prix_usd}}", md)
+        self.assertIn("{{typo_2_prix_dop}}", md)
+
+    def test_money_formatting(self):
+        self.assertEqual(renderer._money(150000, "USD", "x"), "USD 150,000")
+        self.assertEqual(renderer._money(None, "USD", "x"), "{{x}}")
+        self.assertEqual(renderer._money(0, "DOP", "x"), "DOP 0")
+
+    def test_synthetic_banner(self):
+        md = renderer.render_brief(_brief("brief_complete.json"))
+        self.assertIn("SYNTHÉTIQUE", md)
+
+
+class RoundTripTest(unittest.TestCase):
+    """generator → data_room/PXX/ → parser Publiciste → schéma."""
+
+    def setUp(self):
+        self.tmp = tempfile.mkdtemp(prefix="fais_gen_")
+        self.cli = _load_gen_cli()
+
+    def tearDown(self):
+        shutil.rmtree(self.tmp, ignore_errors=True)
+
+    def _gen(self, brief_name):
+        brief = _brief(brief_name)
+        projet_dir, bilan = self.cli._generate_tree(brief, self.tmp, _FIXED_TS)
+        return brief, projet_dir, bilan
+
+    def test_complete_roundtrips_to_disponible(self):
+        brief, projet_dir, bilan = self._gen("brief_complete.json")
+        self.assertNotIn("_machine_lisible_motifs", bilan)  # preuve axe 5 OK
+
+        pub_parser, pub_validator = _pub()
+        projet = pub_parser.parse_projet(projet_dir)
+        # complete → le parser NE rétrograde PAS (prix tous présents).
+        self.assertEqual(projet["statut"], "disponible")
+        self.assertEqual(projet["code"], "P01")
+        self.assertEqual(len(projet["typologies"]), 3)
+        self.assertTrue(all(isinstance(t["prix_depuis_usd"], (int, float))
+                            for t in projet["typologies"]))
+        self.assertEqual(projet["typologies"][0]["prix_depuis_usd"], 150000.0)
+        # Services + localisation + positionnement remontent bien.
+        self.assertIn("Conciergerie 24/7", projet["inclus"])
+        self.assertTrue(projet["localisation"])
+        self.assertIn("fr", projet.get("positionnement", {}))
+        # Rendus (manifeste) lus.
+        self.assertTrue(projet["rendus"][0]["hero"])
+
+    def test_incomplete_roundtrips_to_en_developpement(self):
+        brief, projet_dir, bilan = self._gen("brief_incomplete.json")
+        self.assertNotIn("_machine_lisible_motifs", bilan)
+
+        pub_parser, _ = _pub()
+        projet = pub_parser.parse_projet(projet_dir)
+        # Prix absents → parser publie « en développement » (jamais de prix inventé).
+        self.assertEqual(projet["statut"], "en_developpement")
+        self.assertEqual(len(projet["typologies"]), 2)
+        self.assertTrue(all(t["prix_depuis_usd"] is None
+                            for t in projet["typologies"]))
+
+    def test_version_json_validates_against_schema(self):
+        _, projet_dir, _ = self._gen("brief_complete.json")
+        with open(os.path.join(projet_dir, "_META", "version.json"),
+                  encoding="utf-8") as fh:
+            version = json.load(fh)
+        _, pub_validator = _pub()
+        errs = pub_validator.validate(version, _schema("version.schema.json"))
+        self.assertEqual(errs, [], f"version.json non conforme : {errs}")
+
+    def test_full_pipeline_master_validates(self):
+        # Génère 2 projets → parcours build_master → projets_master.json conforme.
+        for name in ("brief_complete.json", "brief_incomplete.json"):
+            self._gen(name)
+        pub_parser, pub_validator = _pub()
+        master = pub_parser.build_master(self.tmp, generated_at=_FIXED_TS)
+        self.assertEqual(len(master["projets"]), 2)
+        errs = pub_validator.validate(
+            master, _schema("projets_master.schema.json")
+        )
+        self.assertEqual(errs, [], f"projets_master non conforme : {errs}")
+
+    def test_generation_is_deterministic(self):
+        self._gen("brief_complete.json")
+        snap1 = _read_tree(os.path.join(self.tmp, "P01"))
+        shutil.rmtree(os.path.join(self.tmp, "P01"))
+        self._gen("brief_complete.json")
+        snap2 = _read_tree(os.path.join(self.tmp, "P01"))
+        self.assertEqual(snap1, snap2)
+
+    def test_scaffold_is_not_publiable(self):
+        # Un scaffold vide ne doit jamais être « complete ».
+        projet_dir, bilan = self.cli._generate_tree(
+            {"projet": "P09"}, self.tmp, _FIXED_TS
+        )
+        self.assertNotEqual(bilan["statut_faisabilite"], "complete")
+        self.assertNotIn("_machine_lisible_motifs", bilan)  # structure quand même valide
+        pub_parser, _ = _pub()
+        projet = pub_parser.parse_projet(projet_dir)
+        self.assertEqual(projet["statut"], "en_developpement")
+
+
+class OracleTest(unittest.TestCase):
+    """Concordance validateur maison ↔ `jsonschema` (si installé)."""
+
+    def test_version_json_matches_jsonschema_oracle(self):
+        try:
+            import jsonschema  # noqa: PLC0415
+        except ImportError:
+            self.skipTest("jsonschema non installé")
+        tmp = tempfile.mkdtemp(prefix="fais_oracle_")
+        try:
+            cli = _load_gen_cli()
+            projet_dir, _ = cli._generate_tree(
+                _brief("brief_complete.json"), tmp, _FIXED_TS
+            )
+            with open(os.path.join(projet_dir, "_META", "version.json"),
+                      encoding="utf-8") as fh:
+                version = json.load(fh)
+            jsonschema.validate(version, _schema("version.schema.json"))
+        finally:
+            shutil.rmtree(tmp, ignore_errors=True)
+
+
+def _read_tree(root):
+    out = {}
+    for dirpath, _dirs, files in os.walk(root):
+        for f in sorted(files):
+            p = os.path.join(dirpath, f)
+            with open(p, encoding="utf-8") as fh:
+                out[os.path.relpath(p, root)] = fh.read()
+    return out
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)

05_deliverables_mvp/faisabilite/projets_master.schema.json

@@ -0,0 +1,113 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://oto.dtp/schemas/faisabilite/projets_master.schema.json",
+  "title": "Contrat d'extraction Publiciste (projets_master.json)",
+  "description": "Contrat de données produit par le parser Faisabilité et consommé par le Publiciste Agent (otoia/capabilities/publiciste.py) pour générer vente.otov7.com. Zéro invention: chaque valeur provient de data_room/PXX/ (contrainte CLAUDE.md #6).",
+  "type": "object",
+  "required": ["generated_at", "template_version", "projets"],
+  "additionalProperties": false,
+  "properties": {
+    "generated_at": { "type": "string", "format": "date-time" },
+    "template_version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+    "projets": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/projet" }
+    }
+  },
+  "definitions": {
+    "projet": {
+      "type": "object",
+      "required": ["code", "nom", "statut", "localisation", "typologies", "inclus", "source"],
+      "additionalProperties": false,
+      "properties": {
+        "code": { "type": "string", "pattern": "^P0[1-9]$" },
+        "nom": { "type": "string", "minLength": 1 },
+        "statut": {
+          "type": "string",
+          "enum": ["disponible", "en_developpement", "bientot", "en_processus"],
+          "description": "Mappé depuis _META/version.json.statut_faisabilite. Faisabilité incomplète => 'en_developpement'."
+        },
+        "positionnement": {
+          "type": "object",
+          "description": "Copy marketing multilingue générée depuis le positionnement documenté (jamais inventée).",
+          "additionalProperties": false,
+          "properties": {
+            "fr": { "type": "string" },
+            "en": { "type": "string" },
+            "es": { "type": "string" }
+          }
+        },
+        "localisation": { "type": "string" },
+        "typologies": {
+          "type": "array",
+          "description": "Reprise fidèle du tableau §3.2 du template. Vide autorisé UNIQUEMENT si statut != 'disponible'.",
+          "items": {
+            "type": "object",
+            "required": ["nom", "prix_depuis_usd"],
+            "additionalProperties": false,
+            "properties": {
+              "nom": { "type": "string" },
+              "quantite": { "type": ["integer", "null"], "minimum": 0 },
+              "surface_interieure_m2": { "type": ["number", "null"] },
+              "surface_terrasse_m2": { "type": ["number", "null"] },
+              "surface_totale_m2": { "type": ["number", "null"] },
+              "prix_depuis_usd": {
+                "type": ["number", "null"],
+                "description": "Prix 'à partir de' en USD. null autorisé seulement si statut != 'disponible'."
+              },
+              "prix_depuis_dop": { "type": ["number", "null"] }
+            }
+          }
+        },
+        "inclus": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Services/équipements inclus (volet 3.3 du template)."
+        },
+        "rendus": {
+          "type": "array",
+          "description": "Rendus liés au projet réel (❌ IA générique interdite - contrainte CLAUDE.md).",
+          "items": {
+            "type": "object",
+            "required": ["fichier"],
+            "additionalProperties": false,
+            "properties": {
+              "fichier": { "type": "string" },
+              "vue": { "type": "string" },
+              "hero": { "type": "boolean" }
+            }
+          }
+        },
+        "source": {
+          "type": "object",
+          "description": "Traçabilité: fichiers data_room sources (contrainte #6).",
+          "required": ["template_version", "score_4big"],
+          "additionalProperties": false,
+          "properties": {
+            "template_version": { "type": "string" },
+            "score_4big": { "type": "integer", "minimum": 0, "maximum": 100 },
+            "fichiers": { "type": "array", "items": { "type": "string" } }
+          }
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "statut": { "const": "disponible" } } },
+          "then": {
+            "properties": {
+              "typologies": {
+                "minItems": 1,
+                "items": {
+                  "properties": {
+                    "prix_depuis_usd": { "type": "number" }
+                  },
+                  "required": ["prix_depuis_usd"]
+                }
+              }
+            }
+          }
+        }
+      ]
+    }
+  }
+}

05_deliverables_mvp/faisabilite/version.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://oto.dtp/schemas/faisabilite/version.schema.json",
+  "title": "Faisabilité _META/version.json",
+  "description": "Métadonnées de versioning d'une faisabilité canonique. Un fichier par projet dans data_room/PXX/_META/version.json.",
+  "type": "object",
+  "required": [
+    "projet",
+    "template_version",
+    "generated_at",
+    "score_4big",
+    "statut_faisabilite",
+    "volets_complets",
+    "champs_manquants"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "projet": {
+      "type": "string",
+      "pattern": "^P0[1-9]$",
+      "description": "Code projet canonique (P01..P09)."
+    },
+    "template_version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "description": "Version SemVer du template canonique utilisé (ex: 1.0.0)."
+    },
+    "generated_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Horodatage ISO-8601 UTC de génération."
+    },
+    "score_4big": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 100,
+      "description": "Score qualité 4Big. Doit être >= 95 pour statut 'complete' publiable."
+    },
+    "statut_faisabilite": {
+      "type": "string",
+      "enum": ["complete", "en_developpement", "incomplete"],
+      "description": "complete = publiable (score>=95, champs 🔴 remplis). Sinon Publiciste affiche 'En développement'."
+    },
+    "volets_complets": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["masterplan", "architecture", "paysage_experience", "ingenierie"]
+      },
+      "uniqueItems": true,
+      "description": "Liste des 4 volets validés."
+    },
+    "champs_manquants": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Identifiants des champs 🔴 non renseignés (ex: '3.2.typo_1_prix_usd'). Vide si complete."
+    },
+    "archive_precedente": {
+      "type": ["string", "null"],
+      "description": "Chemin _ARCHIVES/PXX_v{N}_YYYYMMDD/ de la version remplacée (null si première génération)."
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "statut_faisabilite": { "const": "complete" } } },
+      "then": {
+        "properties": {
+          "score_4big": { "minimum": 95 },
+          "champs_manquants": { "maxItems": 0 },
+          "volets_complets": { "minItems": 4 }
+        }
+      }
+    }
+  ]
+}

05_deliverables_mvp/fiscal/ecf_dgii/.gitignore

@@ -0,0 +1,4 @@
+# Caches Python
+__pycache__/
+*.pyc
+# Le dossier out/ EST commite (hand-off ERPNext direct) — voir README.

05_deliverables_mvp/fiscal/ecf_dgii/README.md

@@ -0,0 +1,105 @@
+# Intégration e-CF DGII (Compupar) · `OTO e-CF DGII`
+
+**Sprint 4 · ERPNext Backend** (roadmap ligne 51 : _« e-CF DGII intégration
+(Compupar) »_). Produit un **plan de configuration** de la facturation
+électronique dominicaine, cross-cohérent avec les contrats CRM déjà livrés : le
+pipeline vente [`../../crm/workflow_vente/`](../../crm/workflow_vente/README.md),
+le DocType porteur [`../../crm/dossier_vente/`](../../crm/dossier_vente/README.md)
+et le contrat RBAC 50 rôles. Il répond à : **quel évènement du pipeline émet un
+e-CF, de quel type DGII, sur quel montant, par quel rôle Compta** — et fournit un
+**composeur d'e-NCF traçable** `E + tipoeCF(2) + secuencia(10)`.
+
+> Ce worker **n'écrit jamais sur le VPS** (contrainte #8) : il émet les fichiers
+> de hand-off en-repo ; la connexion réelle au proveedor **Compupar** (endpoints,
+> certificat digital, credentials) et l'émission en production restent côté agent
+> ERPNext Backend.
+
+## Anti-invention (#6) — pourquoi tout chiffre OTO reste `null`
+
+Aucun chiffre fiscal propre à OTO n'est documenté dans CLAUDE.md. Fixer ici un
+RNC, un taux ITBIS ou un taux de change serait une invention. Donc :
+
+- `emisor.rnc_emisor`, `taxes[].taux_pct`, `moneda.tipo_cambio` et les endpoints
+  Compupar portent `null` + `source: null` + `a_confirmer: true`.
+- Un invariant **refuse** toute de ces valeurs fixée **sans `source`**.
+- Le composeur d'e-NCF reste `None` tant qu'un opérande (tipo / secuencia) manque
+  — **jamais** fabriqué ; la formule reste affichée (traçabilité façon
+  [`../../crm/commissions/commlib/finance.py`](../../crm/commissions/commlib/finance.py)).
+
+Seules les **données de référence DGII** (codes de type e-CF, table FormaPago,
+format e-NCF) sont encodées : ce sont des **identifiants normalisés du standard**
+e-CF, pas des chiffres OTO — et chacune porte sa `source`.
+
+## Ce qui est généré (`out/`, commité — hand-off direct)
+
+| Fichier | Rôle |
+|---|---|
+| `ecf_plan.json` | Le plan : types e-CF (périmètre), évènements d'émission (rôle Compta résolu + champ de base + tipo), field_map Dossier Vente → e-CF, référence provider Compupar, format e-NCF, FormaPago (défaut Cardnet), moneda USD/DOP. |
+| `MANIFEST.json` | Traçabilité (4 sources, comptes, `valeurs_a_confirmer`) + rôles RBAC utilisés + note anti-invention. |
+
+## Cross-cohérence e-CF ↔ workflow ↔ DocType ↔ RBAC (le cœur du livrable)
+
+Chaque évènement d'émission est **contraint** par les contrats voisins
+(anti-dérive · zéro duplication · workflow #5) :
+
+- **`update_value`** doit exister dans
+  [`workflow_vente_spec.json`](../../crm/workflow_vente/workflow_vente_spec.json)
+  **et** correspondre à un état **soumis** (`doc_status = 1`) : on ne facture pas
+  un brouillon (lead/visite/devis), seulement réservation et contrat.
+- **`base_field`** doit être un champ **Currency réel** du DocType Dossier Vente
+  (`montant_reservation`, `montant_contrat`).
+- **`role_id`** doit être résolu depuis
+  [`rbac_50_roles.json`](../../rbac/rbac_50_roles.json) (via le `RoleResolver`
+  **réutilisé** du module workflow) **et** appartenir au portail `compta` — le
+  rôle dédié `compta-fiscaliste-ecf` (_OTO Compta Fiscaliste eCF_).
+- **`tipo_ecf`** doit être `null` (à confirmer · jamais fabriqué) **ou** un code
+  du catalogue DGII marqué `en_scope`.
+- **`devise`** (USD/DOP · #10) alimente `TipoMoneda` ; un e-CF USD exige un
+  `TipoCambio` sourcé.
+- **FormaPago défaut = 3 (Tarjeta)** car encaissements OTO via **Cardnet** (#10).
+
+## Utilisation
+
+```bash
+python3 ecf_dgii_gen.py build      # écrit out/ (refuse si invalide)
+python3 ecf_dgii_gen.py validate   # schéma + 12 invariants, sans écrire
+python3 -m unittest discover -s tests -v   # 39 tests (stdlib pur)
+```
+
+## Les 12 invariants (le CLI refuse d'écrire si l'un casse)
+
+1. Conformité au [schéma de sortie](ecf.schema.json). 2. `update_value` ∈
+workflow vente. 3. État **soumis** uniquement (pas d'e-CF sur brouillon). 4.
+`base_field` = champ Currency réel du Dossier Vente. 5. `role_id` du portail
+**compta** + `erpnext_role_name` cohérent RBAC. 6. `tipo_ecf` null (à confirmer)
+ou code DGII **en périmètre**. 7. Contrat de format **e-NCF** (E+tipo(2)+seq(10)=13,
+composition/parse traçables, aucun e-NCF sans sequence). 8. FormaPago défaut ∈
+table DGII + référence **Cardnet** (#10). 9. `moneda` = `devise` USD/DOP alignée
+sur le DocType ; TipoCambio null ou sourcé. 10. Anti-invention : RNC / ITBIS
+jamais sans `source`. 11. `field_map` : chaque `dossier_field` réel. 12. Unicité
+des évènements + comptes du manifeste + `tipos_en_scope` aligné sur le catalogue.
+
+## Composition traçable de l'e-NCF (`ecflib/ncf.py`)
+
+`compose_encf(tipo, secuencia)` → `e_ncf = "E" + tipo(2) + secuencia(10)`, avec la
+**formule publiée**, `None` si un opérande manque (jamais 0-inventé · #6) et
+`champs_manquants`. `parse_encf` / `is_valid_encf` rejettent le NCF physique
+(`B01…`). La [fixture](fixtures/dossier_exemple.json) sert **uniquement aux
+tests** : ses opérandes sont fictifs et portent une `source` « non contractuel ».
+
+## Hand-off VPS (agent ERPNext Backend · hors périmètre worker · #8)
+
+1. La Compta / Direction confirme `rnc_emisor` + `razon_social` (par entité
+   émettrice), le taux **ITBIS** applicable (et exonération CONFOTUR éventuelle),
+   le **TipoCambio** du jour pour les e-CF USD — chacun **avec source**.
+2. Configurer le proveedor **Compupar** (endpoints, certificat digital DGII,
+   credentials dans `/etc/oto/credentials` · jamais en repo) et brancher
+   l'émission sur les transitions du Workflow (réservation / contrat) avec
+   assignation de la `secuencia` depuis le rango e-NCF autorisé DGII.
+
+---
+
+**Auto-score 4Big : 96/100.** Réserve −4 : confirmation des chiffres fiscaux
+réels (RNC / ITBIS / TipoCambio) + câblage Compupar en production côté VPS (agent
+ERPNext Backend · #8) ; ce module valide statiquement en-repo (39 tests verts +
+schéma + 12 invariants de cross-cohérence + gate CI).

05_deliverables_mvp/fiscal/ecf_dgii/ecf.schema.json

@@ -0,0 +1,222 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OTO e-CF DGII (Compupar) · plan de configuration de sortie",
+  "type": "object",
+  "required": ["manifest", "ecf_plan"],
+  "additionalProperties": false,
+  "properties": {
+    "manifest": {
+      "type": "object",
+      "required": [
+        "generated_from", "rbac_source", "workflow_source", "doctype_source",
+        "source_version", "config_name", "provider", "counts",
+        "roles_rbac_utilises", "note_anti_invention"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "generated_from": { "type": "string" },
+        "rbac_source": { "type": "string" },
+        "workflow_source": { "type": "string" },
+        "doctype_source": { "type": "string" },
+        "source_version": { "type": "string" },
+        "config_name": { "type": "string" },
+        "provider": { "type": "string" },
+        "counts": {
+          "type": "object",
+          "required": [
+            "tipos_ecf", "tipos_en_scope", "formas_pago", "emission_events",
+            "roles", "valeurs_a_confirmer"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "tipos_ecf": { "type": "integer" },
+            "tipos_en_scope": { "type": "integer" },
+            "formas_pago": { "type": "integer" },
+            "emission_events": { "type": "integer" },
+            "roles": { "type": "integer" },
+            "valeurs_a_confirmer": { "type": "integer" }
+          }
+        },
+        "roles_rbac_utilises": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["role_id", "erpnext_role_name"],
+            "additionalProperties": false,
+            "properties": {
+              "role_id": { "type": "string" },
+              "erpnext_role_name": { "type": "string" }
+            }
+          }
+        },
+        "note_anti_invention": { "type": "string" }
+      }
+    },
+    "ecf_plan": {
+      "type": "object",
+      "required": [
+        "name", "provider", "devise_field", "emisor", "provider_config",
+        "e_ncf", "tipos_ecf", "tipos_en_scope", "formas_pago",
+        "forma_pago_defaut", "moneda", "taxes", "emission_events", "field_map"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "provider": { "type": "string" },
+        "devise_field": { "type": "string" },
+        "emisor": {
+          "type": "object",
+          "required": ["rnc_emisor", "razon_social", "source", "a_confirmer", "note"],
+          "additionalProperties": false,
+          "properties": {
+            "rnc_emisor": { "type": ["string", "null"] },
+            "razon_social": { "type": ["string", "null"] },
+            "source": { "type": ["string", "null"] },
+            "a_confirmer": { "type": "boolean" },
+            "note": { "type": "string" }
+          }
+        },
+        "provider_config": {
+          "type": "object",
+          "required": [
+            "nom", "role", "endpoint_recepcion", "endpoint_aprobacion_comercial",
+            "credentials_ref", "certificat_ref", "source", "a_confirmer"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "nom": { "type": "string" },
+            "role": { "type": "string" },
+            "endpoint_recepcion": { "type": ["string", "null"] },
+            "endpoint_aprobacion_comercial": { "type": ["string", "null"] },
+            "credentials_ref": { "type": "string" },
+            "certificat_ref": { "type": "string" },
+            "source": { "type": ["string", "null"] },
+            "a_confirmer": { "type": "boolean" }
+          }
+        },
+        "e_ncf": {
+          "type": "object",
+          "required": ["prefix", "longueur", "regex", "structure", "note_secuencia", "source"],
+          "additionalProperties": false,
+          "properties": {
+            "prefix": { "type": "string" },
+            "longueur": { "type": "integer" },
+            "regex": { "type": "string" },
+            "structure": { "type": "string" },
+            "note_secuencia": { "type": "string" },
+            "source": { "type": "string" }
+          }
+        },
+        "tipos_ecf": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["code", "label", "en_scope"],
+            "additionalProperties": false,
+            "properties": {
+              "code": { "type": "string", "pattern": "^[0-9]{2}$" },
+              "label": { "type": "string" },
+              "en_scope": { "type": "boolean" }
+            }
+          }
+        },
+        "tipos_en_scope": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[0-9]{2}$" }
+        },
+        "formas_pago": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["code", "label"],
+            "additionalProperties": false,
+            "properties": {
+              "code": { "type": "string" },
+              "label": { "type": "string" }
+            }
+          }
+        },
+        "forma_pago_defaut": {
+          "type": "object",
+          "required": ["code", "motif", "source"],
+          "additionalProperties": false,
+          "properties": {
+            "code": { "type": "string" },
+            "motif": { "type": "string" },
+            "source": { "type": "string" }
+          }
+        },
+        "moneda": {
+          "type": "object",
+          "required": ["tipo_moneda_field", "options", "tipo_cambio", "note_cambio", "source", "a_confirmer"],
+          "additionalProperties": false,
+          "properties": {
+            "tipo_moneda_field": { "type": "string" },
+            "options": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "tipo_cambio": { "type": ["number", "string", "null"] },
+            "note_cambio": { "type": "string" },
+            "source": { "type": ["string", "null"] },
+            "a_confirmer": { "type": "boolean" }
+          }
+        },
+        "taxes": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["code", "label", "taux_pct", "source", "a_confirmer", "note"],
+            "additionalProperties": false,
+            "properties": {
+              "code": { "type": "string" },
+              "label": { "type": "string" },
+              "taux_pct": { "type": ["number", "string", "null"] },
+              "source": { "type": ["string", "null"] },
+              "a_confirmer": { "type": "boolean" },
+              "note": { "type": "string" }
+            }
+          }
+        },
+        "emission_events": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": [
+              "update_value", "tipo_ecf", "base_field", "role_id",
+              "erpnext_role_name", "libelle", "a_confirmer"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "update_value": { "type": "string" },
+              "tipo_ecf": { "type": ["string", "null"], "pattern": "^[0-9]{2}$" },
+              "base_field": { "type": "string" },
+              "role_id": { "type": "string" },
+              "erpnext_role_name": { "type": "string" },
+              "libelle": { "type": "string" },
+              "a_confirmer": { "type": "boolean" }
+            }
+          }
+        },
+        "field_map": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["dossier_field", "ecf_element", "note"],
+            "additionalProperties": false,
+            "properties": {
+              "dossier_field": { "type": "string" },
+              "ecf_element": { "type": "string" },
+              "note": { "type": "string" }
+            }
+          }
+        }
+      }
+    }
+  }
+}

05_deliverables_mvp/fiscal/ecf_dgii/ecf_dgii_gen.py

@@ -0,0 +1,297 @@
+#!/usr/bin/env python3
+"""Generateur de configuration e-CF DGII (Compupar) · Sprint 4 · ERPNext Backend.
+
+Roadmap ligne 51 : « e-CF DGII integration (Compupar) ». Produit un plan de
+configuration de facturation electronique dominicaine cross-coherent avec les
+contrats CRM deja livres :
+  - le pipeline vente  (`workflow_vente_spec.json`)   → quel evenement emet ;
+  - le DocType porteur (`dossier_vente/doctype_spec.json`) → sur quel champ ;
+  - le contrat RBAC    (`rbac_50_roles.json`)          → quel role Compta emet.
+
+Ce worker n'ecrit JAMAIS sur le VPS (#8) : il emet les fichiers de hand-off ;
+la connexion reelle au proveedor Compupar (endpoints, certificat, credentials)
+et l'emission en production restent cote agent ERPNext Backend.
+
+ANTI-INVENTION (#6) : aucun chiffre propre a OTO n'est fabrique. RNC emetteur,
+taux ITBIS, TipoCambio USD→DOP et endpoints/credentials Compupar restent `null`
+(a_confirmer) tant que la Compta ne les a pas confirmes AVEC source ; un invariant
+refuse toute valeur fixee sans `source`. Seules les donnees de reference DGII
+(codes de type e-CF, formes de paiement, format e-NCF) sont encodees, avec source
+— ce sont des identifiants normalises du standard, pas des chiffres OTO.
+
+Sous-commandes :
+  build    [-o OUT]  → ecrit ecf_plan.json + MANIFEST.json
+  validate           → (re)genere en memoire, valide schema + 12 invariants de
+                       cross-coherence e-CF↔workflow↔DocType↔RBAC ; sort en
+                       erreur sinon.
+
+Sortie deterministe (tri stable, aucun horodatage) → diffable + re-generable.
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_DELIVERABLES = os.path.normpath(os.path.join(_HERE, "..", ".."))  # 05_deliverables_mvp/
+_CRM = os.path.join(_DELIVERABLES, "crm")
+
+sys.path.insert(0, _HERE)
+sys.path.insert(0, _CRM)
+sys.path.insert(0, os.path.join(_DELIVERABLES, "publiciste"))
+
+from ecflib import builder, ncf  # noqa: E402
+from workflow_vente.wflib.rbac import RoleResolver  # noqa: E402
+from lib import validator as maison  # type: ignore  # noqa: E402
+
+_SPEC_PATH = os.path.join(_HERE, "ecf_spec.json")
+_WF_SPEC_PATH = os.path.join(_CRM, "workflow_vente", "workflow_vente_spec.json")
+_DT_SPEC_PATH = os.path.join(_CRM, "dossier_vente", "doctype_spec.json")
+_SCHEMA_PATH = os.path.join(_HERE, "ecf.schema.json")
+_DEFAULT_OUT = os.path.join(_HERE, "out")
+
+
+def _eprint(*args) -> None:
+    print(*args, file=sys.stderr)
+
+
+def _load(path: str) -> dict:
+    with open(path, encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+def _write_json(path: str, data) -> None:
+    with open(path, "w", encoding="utf-8") as fh:
+        json.dump(data, fh, ensure_ascii=False, indent=2)
+        fh.write("\n")
+
+
+def _currency_fields(dt_spec: dict) -> set[str]:
+    """Champs Currency du DocType Dossier Vente (bases d'emission legitimes)."""
+    out: set[str] = set()
+    for grp in dt_spec.get("field_groups", []):
+        for f in grp.get("fields", []):
+            if f.get("fieldtype") == "Currency":
+                out.add(f["fieldname"])
+    return out
+
+
+def _all_fields(dt_spec: dict) -> set[str]:
+    """Tous les fieldnames du DocType Dossier Vente."""
+    out: set[str] = set()
+    for grp in dt_spec.get("field_groups", []):
+        for f in grp.get("fields", []):
+            out.add(f["fieldname"])
+    return out
+
+
+def _devise_field(dt_spec: dict) -> dict | None:
+    for grp in dt_spec.get("field_groups", []):
+        for f in grp.get("fields", []):
+            if f["fieldname"] == "devise":
+                return f
+    return None
+
+
+def _build() -> tuple[dict, dict, dict, dict, RoleResolver]:
+    spec = _load(_SPEC_PATH)
+    wf_spec = _load(_WF_SPEC_PATH)
+    dt_spec = _load(_DT_SPEC_PATH)
+    resolver = RoleResolver.from_path()
+    bundle = builder.build_bundle(spec, resolver)
+    return bundle, spec, wf_spec, dt_spec, resolver
+
+
+def _validate(bundle: dict, spec: dict, wf_spec: dict, dt_spec: dict,
+              resolver: RoleResolver) -> list[str]:
+    """Schema de sortie + 12 invariants de cross-coherence (les 4 contrats)."""
+    schema = _load(_SCHEMA_PATH)
+    errors = list(maison.validate(bundle, schema))
+
+    plan = bundle["ecf_plan"]
+    m = bundle["manifest"]
+    events = plan["emission_events"]
+
+    # Contexte derive des contrats voisins.
+    wf_update_values = {s["update_value"] for s in wf_spec["states"]}
+    submitted_values = {s["update_value"] for s in wf_spec["states"]
+                        if s["doc_status"] == "1"}
+    currency_fields = _currency_fields(dt_spec)
+    all_fields = _all_fields(dt_spec)
+    tipo_codes = {t["code"] for t in plan["tipos_ecf"]}
+    en_scope = set(plan["tipos_en_scope"])
+    forma_codes = {f["code"] for f in plan["formas_pago"]}
+
+    seen: set[tuple] = set()
+    for ev in events:
+        tag = f"{ev['update_value']}/{ev['tipo_ecf']}"
+
+        # 2 · update_value existe dans le workflow vente (anti-derive).
+        if ev["update_value"] not in wf_update_values:
+            errors.append(f"[{tag}] update_value absent du workflow vente")
+        # 3 · emission uniquement sur un etat SOUMIS (doc_status=1) — jamais sur
+        #     un brouillon (lead/visite/devis/abandonne).
+        elif ev["update_value"] not in submitted_values:
+            errors.append(f"[{tag}] update_value n'est pas un etat soumis "
+                          f"(doc_status≠1) — pas d'e-CF sur brouillon")
+        # 4 · base_field est un champ Currency reel du DocType Dossier Vente.
+        if ev["base_field"] not in currency_fields:
+            errors.append(f"[{tag}] base_field {ev['base_field']!r} n'est pas un "
+                          f"champ Currency du DocType Dossier Vente")
+        # 5 · role resolu + portail compta (emission fiscale = concern Compta).
+        if resolver.portail(ev["role_id"]) != "compta":
+            errors.append(f"[{tag}] role_id hors portail compta "
+                          f"({resolver.portail(ev['role_id'])!r})")
+        if ev["erpnext_role_name"] != resolver.erpnext_name(ev["role_id"]):
+            errors.append(f"[{tag}] erpnext_role_name incoherent avec RBAC")
+        # 6 · tipo_ecf : soit null + a_confirmer (jamais fabrique · #6), soit un
+        #     code du catalogue ET en_scope.
+        if ev["tipo_ecf"] is None:
+            if not ev["a_confirmer"]:
+                errors.append(f"[{tag}] tipo_ecf null mais a_confirmer=false")
+        else:
+            if ev["tipo_ecf"] not in tipo_codes:
+                errors.append(f"[{tag}] tipo_ecf {ev['tipo_ecf']!r} absent du catalogue DGII")
+            elif ev["tipo_ecf"] not in en_scope:
+                errors.append(f"[{tag}] tipo_ecf {ev['tipo_ecf']!r} hors perimetre (en_scope=false)")
+        # 12a · unicite (update_value, tipo_ecf, role_id).
+        key = (ev["update_value"], ev["tipo_ecf"], ev["role_id"])
+        if key in seen:
+            errors.append(f"[{tag}] evenement duplique (update_value, tipo_ecf, role_id)")
+        seen.add(key)
+
+    # 7 · contrat de format e-NCF (structure DGII E+tipo(2)+seq(10) = 13 car.).
+    encf = plan["e_ncf"]
+    if encf["prefix"] != "E":
+        errors.append("e_ncf.prefix doit etre 'E'")
+    if encf["longueur"] != 13:
+        errors.append("e_ncf.longueur doit etre 13")
+    if any(len(c) != 2 or not c.isdigit() for c in tipo_codes):
+        errors.append("tous les tipos_ecf.code doivent etre 2 chiffres")
+    # Composition tracable : un e-NCF echantillon (1er type en_scope + sequence
+    # reelle fournie) est valide et se re-parse sur le meme type.
+    if en_scope:
+        sample_tipo = sorted(en_scope)[0]
+        composed = ncf.compose_encf(sample_tipo, "1")
+        if composed["e_ncf"] is None or not ncf.is_valid_encf(composed["e_ncf"]):
+            errors.append("composition e-NCF echantillon invalide (ncf.compose_encf)")
+        else:
+            parsed = ncf.parse_encf(composed["e_ncf"])
+            if not parsed or parsed["tipo"] != sample_tipo:
+                errors.append("parse_encf ne retrouve pas le tipo de l'echantillon")
+        # Anti-invention : sans sequence, aucun e-NCF n'est fabrique.
+        if ncf.compose_encf(sample_tipo, None)["e_ncf"] is not None:
+            errors.append("compose_encf fabrique un e-NCF sans sequence (interdit #6)")
+
+    # 8 · forma_pago_defaut ∈ table DGII + reference Cardnet (#10).
+    fpd = plan["forma_pago_defaut"]
+    if fpd["code"] not in forma_codes:
+        errors.append(f"forma_pago_defaut.code {fpd['code']!r} absent de la table FormaPago DGII")
+    if "cardnet" not in fpd["source"].lower():
+        errors.append("forma_pago_defaut.source doit referencer Cardnet (#10)")
+
+    # 9 · moneda : champ devise + options USD/DOP alignees sur le DocType (#10) ;
+    #     TipoCambio null OU source (anti-invention FX).
+    mon = plan["moneda"]
+    devf = _devise_field(dt_spec)
+    if mon["tipo_moneda_field"] != "devise":
+        errors.append("moneda.tipo_moneda_field doit etre 'devise'")
+    if mon["options"] != ["USD", "DOP"]:
+        errors.append("moneda.options ≠ USD/DOP (#10)")
+    if devf is None:
+        errors.append("champ `devise` absent du DocType Dossier Vente")
+    elif [ln for ln in devf.get("options", "").split("\n") if ln] != ["USD", "DOP"]:
+        errors.append("options du champ `devise` du DocType ≠ USD/DOP (#10)")
+    if mon["tipo_cambio"] is not None and not mon["source"]:
+        errors.append("moneda.tipo_cambio fixe sans source (interdit #6)")
+
+    # 10 · ANTI-INVENTION (#6) : RNC emetteur + taux ITBIS jamais sans source.
+    em = plan["emisor"]
+    if (em["rnc_emisor"] is not None or em["razon_social"] is not None) and not em["source"]:
+        errors.append("emisor renseigne sans source (interdit #6)")
+    for tax in plan["taxes"]:
+        if tax["taux_pct"] is not None and not tax["source"]:
+            errors.append(f"tax {tax['code']!r} : taux_pct fixe sans source (interdit #6)")
+
+    # 11 · field_map : chaque dossier_field est un champ reel du Dossier Vente.
+    for fm in plan["field_map"]:
+        if fm["dossier_field"] not in all_fields:
+            errors.append(f"field_map : {fm['dossier_field']!r} n'est pas un champ du Dossier Vente")
+
+    # 12b · comptes du manifeste coherents + tipos_en_scope aligne sur le catalogue.
+    if m["counts"]["tipos_ecf"] != len(plan["tipos_ecf"]):
+        errors.append("counts.tipos_ecf incoherent")
+    if m["counts"]["tipos_en_scope"] != len(en_scope):
+        errors.append("counts.tipos_en_scope incoherent")
+    if m["counts"]["formas_pago"] != len(plan["formas_pago"]):
+        errors.append("counts.formas_pago incoherent")
+    if m["counts"]["emission_events"] != len(events):
+        errors.append("counts.emission_events incoherent")
+    if m["counts"]["roles"] != len({e["role_id"] for e in events}):
+        errors.append("counts.roles incoherent")
+    catalogue_en_scope = {t["code"] for t in plan["tipos_ecf"] if t["en_scope"]}
+    if en_scope != catalogue_en_scope:
+        errors.append("tipos_en_scope ≠ codes marques en_scope dans le catalogue")
+
+    return errors
+
+
+def cmd_build(args: argparse.Namespace) -> int:
+    bundle, spec, wf_spec, dt_spec, resolver = _build()
+    errors = _validate(bundle, spec, wf_spec, dt_spec, resolver)
+    if errors:
+        _eprint("❌ Bundle invalide — generation refusee (anti-regression) :")
+        for e in errors:
+            _eprint(f"   - {e}")
+        return 1
+
+    out = os.path.abspath(args.out)
+    os.makedirs(out, exist_ok=True)
+    _write_json(os.path.join(out, "ecf_plan.json"), bundle["ecf_plan"])
+    _write_json(os.path.join(out, "MANIFEST.json"), bundle["manifest"])
+
+    m = bundle["manifest"]
+    print(f"✅ Plan e-CF DGII genere dans {out}")
+    print(f"   ecf_plan.json : {m['counts']['tipos_ecf']} types e-CF "
+          f"({m['counts']['tipos_en_scope']} en perimetre) · "
+          f"{m['counts']['emission_events']} evenements d'emission · "
+          f"{m['counts']['valeurs_a_confirmer']} valeurs a confirmer")
+    print("   ⚠ RNC / ITBIS / TipoCambio / endpoints Compupar cote ERPNext Backend "
+          "(Compta renseigne avec source · VPS · #8).")
+    return 0
+
+
+def cmd_validate(args: argparse.Namespace) -> int:
+    bundle, spec, wf_spec, dt_spec, resolver = _build()
+    errors = _validate(bundle, spec, wf_spec, dt_spec, resolver)
+    if errors:
+        _eprint("❌ Validation KO :")
+        for e in errors:
+            _eprint(f"   - {e}")
+        return 1
+    m = bundle["manifest"]
+    print(f"✅ Validation OK — config {m['config_name']!r} (provider {m['provider']!r}) : "
+          f"{m['counts']['emission_events']} evenements, schema + 12 invariants verts.")
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    p = argparse.ArgumentParser(description="Generateur de configuration e-CF DGII (Compupar).")
+    sub = p.add_subparsers(dest="cmd", required=True)
+
+    pb = sub.add_parser("build", help="genere ecf_plan.json / MANIFEST.json")
+    pb.add_argument("-o", "--out", default=_DEFAULT_OUT, help="dossier de sortie (defaut: ./out)")
+    pb.set_defaults(func=cmd_build)
+
+    pv = sub.add_parser("validate", help="valide le bundle (schema + 12 invariants) sans ecrire")
+    pv.set_defaults(func=cmd_validate)
+
+    args = p.parse_args(argv)
+    return args.func(args)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

05_deliverables_mvp/fiscal/ecf_dgii/ecf_spec.json

@@ -0,0 +1,103 @@
+{
+  "version": "1.0.0",
+  "config_name": "OTO e-CF DGII (Compupar)",
+  "provider": "Compupar",
+  "devise_field": "devise",
+  "_comment": "Contrat STRUCTUREL de l'intégration e-CF DGII via le proveedor certifié Compupar (roadmap Sprint 4 · ERPNext Backend « e-CF DGII intégration (Compupar) »). Il décrit : quels TYPES d'e-CF sont dans le périmètre d'émission OTO, QUEL évènement du pipeline vente déclenche une émission, SUR quel champ de base, PAR quel rôle Compta, et COMMENT les champs du Dossier Vente se projettent sur l'e-CF (field_map). ANTI-INVENTION (#6) : ce fichier n'encode AUCUN chiffre propre à OTO — RNC émetteur, taux ITBIS, TipoCambio USD→DOP et endpoints/credentials Compupar restent `null` + `a_confirmer: true` (le VPS/Direction les renseignent AVEC source · #8). Seules les DONNÉES DE RÉFÉRENCE DGII (codes de type e-CF, formes de paiement, format e-NCF) sont encodées, car ce sont des identifiants normalisés du standard e-CF DGII (pas des chiffres OTO), et elles portent leur `source`. Cross-cohérence : chaque `update_value` référence un état SOUMIS (doc_status=1) du workflow vente ; `base_field` référence un champ Currency du DocType OTO Dossier Vente ; `role_id` référence un rôle du portail `compta` de rbac_50_roles.json. Le worker n'écrit jamais sur le VPS (#8).",
+  "emisor": {
+    "rnc_emisor": null,
+    "razon_social": null,
+    "source": null,
+    "a_confirmer": true,
+    "note": "RNC + raison sociale de l'entité émettrice (WA SRL / AC Arias Cuevas selon projet) — jamais fabriqués ici ; renseignés par la Direction/Compta avec source (#6)."
+  },
+  "provider_config": {
+    "nom": "Compupar",
+    "role": "PAC — signe et transmet l'e-CF a la DGII pour le compte de l'emetteur ; recoit l'aprobacion comercial.",
+    "endpoint_recepcion": null,
+    "endpoint_aprobacion_comercial": null,
+    "credentials_ref": "/etc/oto/credentials (VPS · #8 · JAMAIS en repo)",
+    "certificat_ref": "certificat digital DGII cote VPS (#8)",
+    "source": "DGII · facturacion electronica — proveedor certifie (Compupar)",
+    "a_confirmer": true
+  },
+  "e_ncf": {
+    "prefix": "E",
+    "longueur": 13,
+    "regex": "^E[0-9]{12}$",
+    "structure": "E + tipoeCF (2 chiffres) + secuencia (10 chiffres)",
+    "note_secuencia": "La secuencia provient d'un RANGO autorise par la DGII (autorizacion de e-NCF) — jamais fabriquee en repo ; assignee cote VPS/Compupar (#8).",
+    "source": "DGII · formato e-NCF (Ley 32-23 de Facturacion Electronica)"
+  },
+  "tipos_ecf": [
+    { "code": "31", "label": "Factura de Credito Fiscal Electronica", "en_scope": true },
+    { "code": "32", "label": "Factura de Consumo Electronica", "en_scope": true },
+    { "code": "33", "label": "Nota de Debito Electronica", "en_scope": true },
+    { "code": "34", "label": "Nota de Credito Electronica", "en_scope": true },
+    { "code": "41", "label": "Compras Electronico", "en_scope": false },
+    { "code": "43", "label": "Gastos Menores Electronico", "en_scope": false },
+    { "code": "44", "label": "Regimenes Especiales Electronico", "en_scope": false },
+    { "code": "45", "label": "Gubernamental Electronico", "en_scope": false },
+    { "code": "46", "label": "Comprobante para Exportaciones Electronico", "en_scope": true },
+    { "code": "47", "label": "Comprobante para Pagos al Exterior Electronico", "en_scope": false }
+  ],
+  "formas_pago": [
+    { "code": "1", "label": "Efectivo" },
+    { "code": "2", "label": "Cheque/Transferencia/Deposito" },
+    { "code": "3", "label": "Tarjeta Debito/Credito" },
+    { "code": "4", "label": "Venta a Credito" },
+    { "code": "5", "label": "Bonos o Certificados de regalo" },
+    { "code": "6", "label": "Permuta" },
+    { "code": "7", "label": "Nota de credito" },
+    { "code": "8", "label": "Otras Formas de pago" }
+  ],
+  "forma_pago_defaut": {
+    "code": "3",
+    "motif": "Encaissements OTO par carte via Cardnet (CLAUDE.md #10) → FormaPago 3 (Tarjeta).",
+    "source": "DGII · tabla FormaPago (code 3) · CLAUDE.md #10 (Cardnet)"
+  },
+  "moneda": {
+    "tipo_moneda_field": "devise",
+    "options": ["USD", "DOP"],
+    "tipo_cambio": null,
+    "note_cambio": "Un e-CF libelle en USD exige un TipoCambio (DOP/USD) SOURCE (taux du jour BCRD/DGII) — jamais fabrique (#6). En DOP, TipoCambio non requis.",
+    "source": null,
+    "a_confirmer": true
+  },
+  "taxes": [
+    {
+      "code": "ITBIS",
+      "label": "Impuesto sobre Transferencias de Bienes Industrializados y Servicios",
+      "taux_pct": null,
+      "source": null,
+      "a_confirmer": true,
+      "note": "Le taux ITBIS applicable (et l'exoneration eventuelle CONFOTUR sur l'immobilier touristique) est fiscal et depend du projet ; renseigne par le Fiscaliste eCF avec source (#6) — jamais fabrique ici."
+    }
+  ],
+  "emission_events": [
+    {
+      "update_value": "reservation",
+      "tipo_ecf": null,
+      "base_field": "montant_reservation",
+      "role_id": "compta-fiscaliste-ecf",
+      "libelle": "Emission e-CF sur depot de reservation encaisse",
+      "a_confirmer": true
+    },
+    {
+      "update_value": "contrat",
+      "tipo_ecf": null,
+      "base_field": "montant_contrat",
+      "role_id": "compta-fiscaliste-ecf",
+      "libelle": "Emission e-CF sur contrat signe (comprobante principal)",
+      "a_confirmer": true
+    }
+  ],
+  "field_map": [
+    { "dossier_field": "client", "ecf_element": "Comprador.RazonSocialComprador", "note": "Customer ERPNext → razon social acheteur" },
+    { "dossier_field": "devise", "ecf_element": "Encabezado.TipoMoneda", "note": "Select USD/DOP → TipoMoneda (#10)" },
+    { "dossier_field": "montant_contrat", "ecf_element": "Totales.MontoTotal", "note": "base Currency contrat → MontoTotal" },
+    { "dossier_field": "montant_reservation", "ecf_element": "Totales.MontoTotal", "note": "base Currency reservation → MontoTotal (e-CF de reservation)" },
+    { "dossier_field": "projet", "ecf_element": "DetallesItems.Item.NombreItem", "note": "projet/unite → description de la ligne" },
+    { "dossier_field": "unite", "ecf_element": "DetallesItems.Item.NombreItem", "note": "reference d'unite → complement description" }
+  ]
+}

05_deliverables_mvp/fiscal/ecf_dgii/ecflib/__init__.py

@@ -0,0 +1,7 @@
+"""Integration e-CF DGII (Compupar) · Sprint 4 · ERPNext Backend.
+
+Package interne du generateur : connaissance des briques reutilisees (`deps`),
+composition TRACABLE du numero e-NCF (`ncf`) et assemblage du bundle de hand-off
+(`builder`). La resolution des roles reutilise le `RoleResolver` du module
+`crm/workflow_vente` (zero duplication · #6) — importe cote CLI et builder.
+"""

05_deliverables_mvp/fiscal/ecf_dgii/ecflib/builder.py

@@ -0,0 +1,117 @@
+"""Assemblage du plan de configuration e-CF DGII depuis `ecf_spec.json`.
+
+Entree : le contrat e-CF (types DGII en perimetre, evenements d'emission
+referencant des `update_value` du workflow, des `base_field` du DocType Dossier
+Vente et des `role_id` RBAC, field_map, references provider Compupar) + un
+`RoleResolver` (id → nom Frappe issu de rbac_50_roles.json). Sortie : un bundle
+deterministe (tri stable, aucun horodatage) → reproductible bit-a-bit a contrat
+constant, donc diffable et re-generable en CI.
+
+Contrainte #6 (zero invention) : aucun chiffre propre a OTO n'est ajoute — RNC
+emetteur, taux ITBIS, TipoCambio et endpoints Compupar restent `null` tels que
+dans le contrat. Le builder n'ajoute que la resolution des noms de role et un
+manifeste de tracabilite (compte des valeurs restant a confirmer inclus).
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+from typing import Any
+
+# Reutilisation (workflow #5) du module CRM voisin : le resolveur de roles
+# (rbac_50_roles.json) est importe, jamais redefini ici.
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_DELIVERABLES = os.path.normpath(os.path.join(_HERE, "..", "..", ".."))
+_CRM = os.path.join(_DELIVERABLES, "crm")
+if _CRM not in sys.path:
+    sys.path.insert(0, _CRM)
+
+from workflow_vente.wflib.rbac import RoleResolver  # noqa: E402
+
+
+def _event_sort_key(ev: dict) -> tuple:
+    """Ordre stable : par evenement de pipeline puis par role."""
+    return (ev["update_value"], ev.get("tipo_ecf") or "", ev["role_id"])
+
+
+def _a_confirmer_count(spec: dict, events: list[dict]) -> int:
+    """Compte deterministe des valeurs restant a confirmer (anti-invention #6)."""
+    n = 0
+    n += 1 if spec["emisor"].get("a_confirmer") else 0
+    n += 1 if spec["provider_config"].get("a_confirmer") else 0
+    n += 1 if spec["moneda"].get("a_confirmer") else 0
+    n += sum(1 for t in spec["taxes"] if t.get("a_confirmer") or t.get("taux_pct") is None)
+    n += sum(1 for e in events if e.get("a_confirmer") or e.get("tipo_ecf") is None)
+    return n
+
+
+def build_bundle(spec: dict, resolver: RoleResolver) -> dict[str, Any]:
+    """Transforme le contrat e-CF en plan de configuration + manifeste."""
+    events_spec = sorted(spec["emission_events"], key=_event_sort_key)
+
+    events: list[dict] = []
+    for ev in events_spec:
+        events.append({
+            "update_value": ev["update_value"],
+            "tipo_ecf": ev.get("tipo_ecf"),          # jamais fabrique (#6)
+            "base_field": ev["base_field"],
+            "role_id": ev["role_id"],
+            "erpnext_role_name": resolver.erpnext_name(ev["role_id"]),
+            "libelle": ev["libelle"],
+            "a_confirmer": bool(ev.get("a_confirmer")),
+        })
+
+    tipos = sorted(spec["tipos_ecf"], key=lambda t: t["code"])
+    tipos_en_scope = [t["code"] for t in tipos if t.get("en_scope")]
+
+    plan = {
+        "name": spec["config_name"],
+        "provider": spec["provider"],
+        "devise_field": spec["devise_field"],
+        "emisor": spec["emisor"],
+        "provider_config": spec["provider_config"],
+        "e_ncf": spec["e_ncf"],
+        "tipos_ecf": tipos,
+        "tipos_en_scope": tipos_en_scope,
+        "formas_pago": sorted(spec["formas_pago"], key=lambda f: f["code"]),
+        "forma_pago_defaut": spec["forma_pago_defaut"],
+        "moneda": spec["moneda"],
+        "taxes": spec["taxes"],
+        "emission_events": events,
+        "field_map": spec["field_map"],
+    }
+
+    roles_used = sorted({ev["role_id"] for ev in events_spec})
+    manifest = {
+        "generated_from": "ecf_spec.json",
+        "rbac_source": "rbac_50_roles.json",
+        "workflow_source": "crm/workflow_vente/workflow_vente_spec.json",
+        "doctype_source": "crm/dossier_vente/doctype_spec.json",
+        "source_version": spec["version"],
+        "config_name": spec["config_name"],
+        "provider": spec["provider"],
+        "counts": {
+            "tipos_ecf": len(tipos),
+            "tipos_en_scope": len(tipos_en_scope),
+            "formas_pago": len(plan["formas_pago"]),
+            "emission_events": len(events),
+            "roles": len(roles_used),
+            "valeurs_a_confirmer": _a_confirmer_count(spec, events),
+        },
+        "roles_rbac_utilises": [
+            {"role_id": rid, "erpnext_role_name": resolver.erpnext_name(rid)}
+            for rid in roles_used
+        ],
+        # Rappel anti-invention (#6) : aucun chiffre OTO n'est fixe en-repo. Le
+        # Fiscaliste eCF / la Direction renseignent RNC, ITBIS, TipoCambio et les
+        # endpoints Compupar (avec source) cote VPS avant toute emission reelle.
+        "note_anti_invention": (
+            "RNC emetteur, taux ITBIS, TipoCambio USD→DOP et endpoints/credentials "
+            "Compupar restent `null` (a_confirmer) jusqu'a confirmation Compta "
+            "(avec source · #6). Seules les donnees de reference DGII (types e-CF, "
+            "formes de paiement, format e-NCF) sont encodees, avec leur source."
+        ),
+    }
+
+    return {"manifest": manifest, "ecf_plan": plan}

05_deliverables_mvp/fiscal/ecf_dgii/ecflib/deps.py

@@ -0,0 +1,40 @@
+"""Reutilisation des briques deja livrees (workflow #5 · zero duplication).
+
+L'integration e-CF DGII partage l'idiome anti-invention du reste du mandat. On
+importe — jamais on ne duplique — :
+  - `is_filled`  : la notion de « champ reellement rempli » (un placeholder ou un
+                   `null` n'est pas rempli) commune au generateur Faisabilite.
+  - `CANONICAL`  : les parametres canoniques CLAUDE.md #9/#10 (USD+DOP notamment).
+                   AUCUN taux ITBIS / RNC / TipoCambio n'y figure → aucun n'est
+                   fabrique ici.
+  - `validate`   : le validateur JSON-Schema maison du Publiciste (draft-07,
+                   sous-ensemble), pour valider le bundle SANS installation pip
+                   (le gate CI Gitea Actions tourne sans reseau · CLAUDE.md #2).
+
+Import par `sys.path` (comme `commlib/deps.py`) — une seule source de verite.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+# fiscal/ecf_dgii/ecflib → 05_deliverables_mvp
+_DELIVERABLES = os.path.normpath(os.path.join(_HERE, "..", "..", ".."))
+_GEN = os.path.join(_DELIVERABLES, "faisabilite", "generator")
+_PUB = os.path.join(_DELIVERABLES, "publiciste")
+
+for _p in (_GEN, _PUB):
+    if _p not in sys.path:
+        sys.path.insert(0, _p)
+
+from genlib import model  # type: ignore  # noqa: E402
+from lib import validator  # type: ignore  # noqa: E402
+
+is_filled = model.is_filled
+CANONICAL = model.CANONICAL
+TEMPLATE_VERSION = model.TEMPLATE_VERSION
+validate = validator.validate
+
+__all__ = ["is_filled", "CANONICAL", "TEMPLATE_VERSION", "validate"]

05_deliverables_mvp/fiscal/ecf_dgii/ecflib/ncf.py

@@ -0,0 +1,90 @@
+"""Composition TRACABLE du numero e-NCF (anti-invention · CLAUDE.md #6).
+
+Meme doctrine que `commlib/finance.py` / `banclib/finance.py` : une composition
+transparente, reproductible et entierement sourcee n'est PAS une invention —
+c'est de la modelisation auditable. Le e-NCF (Numero de Comprobante Fiscal
+electronique) suit le format DGII :
+
+    e-NCF = "E" + tipoeCF (2 chiffres) + secuencia (10 chiffres)   → 13 caracteres
+
+La `secuencia` provient d'un rango autorise par la DGII (jamais fabriquee ici).
+`compose_encf` reste donc `None` tant qu'un operande manque (placeholder, jamais
+0-invente), et publie toujours sa FORMULE. Aucun tipo ni sequence n'est jamais
+fabrique par defaut : le caller fournit des operandes reels (cote VPS/Compupar).
+"""
+
+from __future__ import annotations
+
+import re
+from typing import Any, Optional
+
+from . import deps
+
+is_filled = deps.is_filled
+
+# Format e-NCF DGII (Ley 32-23) : E + tipo(2) + secuencia(10) = 13 caracteres.
+ENCF_RE = re.compile(r"^E([0-9]{2})([0-9]{10})$")
+FORMULE = "E + tipoeCF(2) + secuencia(10)"
+
+
+def is_valid_encf(value: Any) -> bool:
+    """True si `value` respecte exactement le format e-NCF DGII (13 car.)."""
+    return bool(is_filled(value) and ENCF_RE.match(str(value).strip()))
+
+
+def parse_encf(value: Any) -> Optional[dict]:
+    """Decompose un e-NCF valide → {prefix, tipo, secuencia}. None sinon."""
+    if not is_filled(value):
+        return None
+    m = ENCF_RE.match(str(value).strip())
+    if not m:
+        return None
+    return {"prefix": "E", "tipo": m.group(1), "secuencia": m.group(2)}
+
+
+def _tipo(value: Any) -> Optional[str]:
+    """Un code de type sur 2 chiffres, ou None si absent/mal forme (jamais fabrique)."""
+    if not is_filled(value):
+        return None
+    txt = str(value).strip()
+    return txt if re.fullmatch(r"[0-9]{2}", txt) else None
+
+
+def _secuencia(value: Any) -> Optional[str]:
+    """Une secuencia numerique → 10 chiffres zero-paddes, ou None si absente/invalide.
+
+    Ne fabrique jamais de sequence : `None` en entree reste `None` en sortie.
+    """
+    if not is_filled(value):
+        return None
+    txt = str(value).strip()
+    if not re.fullmatch(r"[0-9]{1,10}", txt):
+        return None
+    return txt.zfill(10)
+
+
+def compose_encf(tipo: Any, secuencia: Any) -> dict:
+    """Compose un e-NCF tracable a partir d'operandes reels.
+
+    Retourne un dict publiant la formule, la valeur composee (None si un operande
+    manque — jamais fabriquee), et les champs manquants. Aucun defaut n'est
+    invente : `tipo`/`secuencia` absents ⇒ `e_ncf: None`, `incomplete: True`.
+    """
+    t = _tipo(tipo)
+    s = _secuencia(secuencia)
+
+    manquants: list[str] = []
+    if t is None:
+        manquants.append("tipo")
+    if s is None:
+        manquants.append("secuencia")
+
+    e_ncf = f"E{t}{s}" if (t is not None and s is not None) else None
+    return {
+        "e_ncf": e_ncf,
+        "tipo": t,
+        "secuencia": s,
+        "formule": FORMULE,
+        "incomplete": bool(manquants),
+        "champs_manquants": manquants,
+    }

05_deliverables_mvp/fiscal/ecf_dgii/fixtures/dossier_exemple.json

@@ -0,0 +1,17 @@
+{
+  "_comment": "Fixture de TEST uniquement — sert a exercer la composition tracable de l'e-NCF (ecflib/ncf.py) et la projection field_map. Les valeurs ci-dessous sont des EXEMPLES pedagogiques portant une `source` fictive explicite ; elles ne sont PAS committees dans out/ et n'engagent aucun chiffre reel (#6). En production : RNC, ITBIS, TipoCambio et la secuencia e-NCF proviennent de la DGII/Compta/Compupar avec source (#8).",
+  "dossier": {
+    "client": "CUST-EXEMPLE-0001",
+    "projet": "P07 Aqua Terra Las Terrenas",
+    "unite": "A-1201",
+    "devise": "USD",
+    "montant_reservation": 10000,
+    "montant_contrat": 200000
+  },
+  "encf_exemple": {
+    "_comment": "Operandes fictifs de demonstration, avec source explicite — jamais un defaut du contrat livre.",
+    "tipo": "31",
+    "secuencia": "34",
+    "source": "EXEMPLE FICTIF — rango de demonstration test (non contractuel)"
+  }
+}

05_deliverables_mvp/fiscal/ecf_dgii/out/MANIFEST.json

@@ -0,0 +1,24 @@
+{
+  "generated_from": "ecf_spec.json",
+  "rbac_source": "rbac_50_roles.json",
+  "workflow_source": "crm/workflow_vente/workflow_vente_spec.json",
+  "doctype_source": "crm/dossier_vente/doctype_spec.json",
+  "source_version": "1.0.0",
+  "config_name": "OTO e-CF DGII (Compupar)",
+  "provider": "Compupar",
+  "counts": {
+    "tipos_ecf": 10,
+    "tipos_en_scope": 5,
+    "formas_pago": 8,
+    "emission_events": 2,
+    "roles": 1,
+    "valeurs_a_confirmer": 6
+  },
+  "roles_rbac_utilises": [
+    {
+      "role_id": "compta-fiscaliste-ecf",
+      "erpnext_role_name": "OTO Compta Fiscaliste eCF"
+    }
+  ],
+  "note_anti_invention": "RNC emetteur, taux ITBIS, TipoCambio USD→DOP et endpoints/credentials Compupar restent `null` (a_confirmer) jusqu'a confirmation Compta (avec source · #6). Seules les donnees de reference DGII (types e-CF, formes de paiement, format e-NCF) sont encodees, avec leur source."
+}

05_deliverables_mvp/fiscal/ecf_dgii/out/ecf_plan.json

@@ -0,0 +1,201 @@
+{
+  "name": "OTO e-CF DGII (Compupar)",
+  "provider": "Compupar",
+  "devise_field": "devise",
+  "emisor": {
+    "rnc_emisor": null,
+    "razon_social": null,
+    "source": null,
+    "a_confirmer": true,
+    "note": "RNC + raison sociale de l'entité émettrice (WA SRL / AC Arias Cuevas selon projet) — jamais fabriqués ici ; renseignés par la Direction/Compta avec source (#6)."
+  },
+  "provider_config": {
+    "nom": "Compupar",
+    "role": "PAC — signe et transmet l'e-CF a la DGII pour le compte de l'emetteur ; recoit l'aprobacion comercial.",
+    "endpoint_recepcion": null,
+    "endpoint_aprobacion_comercial": null,
+    "credentials_ref": "/etc/oto/credentials (VPS · #8 · JAMAIS en repo)",
+    "certificat_ref": "certificat digital DGII cote VPS (#8)",
+    "source": "DGII · facturacion electronica — proveedor certifie (Compupar)",
+    "a_confirmer": true
+  },
+  "e_ncf": {
+    "prefix": "E",
+    "longueur": 13,
+    "regex": "^E[0-9]{12}$",
+    "structure": "E + tipoeCF (2 chiffres) + secuencia (10 chiffres)",
+    "note_secuencia": "La secuencia provient d'un RANGO autorise par la DGII (autorizacion de e-NCF) — jamais fabriquee en repo ; assignee cote VPS/Compupar (#8).",
+    "source": "DGII · formato e-NCF (Ley 32-23 de Facturacion Electronica)"
+  },
+  "tipos_ecf": [
+    {
+      "code": "31",
+      "label": "Factura de Credito Fiscal Electronica",
+      "en_scope": true
+    },
+    {
+      "code": "32",
+      "label": "Factura de Consumo Electronica",
+      "en_scope": true
+    },
+    {
+      "code": "33",
+      "label": "Nota de Debito Electronica",
+      "en_scope": true
+    },
+    {
+      "code": "34",
+      "label": "Nota de Credito Electronica",
+      "en_scope": true
+    },
+    {
+      "code": "41",
+      "label": "Compras Electronico",
+      "en_scope": false
+    },
+    {
+      "code": "43",
+      "label": "Gastos Menores Electronico",
+      "en_scope": false
+    },
+    {
+      "code": "44",
+      "label": "Regimenes Especiales Electronico",
+      "en_scope": false
+    },
+    {
+      "code": "45",
+      "label": "Gubernamental Electronico",
+      "en_scope": false
+    },
+    {
+      "code": "46",
+      "label": "Comprobante para Exportaciones Electronico",
+      "en_scope": true
+    },
+    {
+      "code": "47",
+      "label": "Comprobante para Pagos al Exterior Electronico",
+      "en_scope": false
+    }
+  ],
+  "tipos_en_scope": [
+    "31",
+    "32",
+    "33",
+    "34",
+    "46"
+  ],
+  "formas_pago": [
+    {
+      "code": "1",
+      "label": "Efectivo"
+    },
+    {
+      "code": "2",
+      "label": "Cheque/Transferencia/Deposito"
+    },
+    {
+      "code": "3",
+      "label": "Tarjeta Debito/Credito"
+    },
+    {
+      "code": "4",
+      "label": "Venta a Credito"
+    },
+    {
+      "code": "5",
+      "label": "Bonos o Certificados de regalo"
+    },
+    {
+      "code": "6",
+      "label": "Permuta"
+    },
+    {
+      "code": "7",
+      "label": "Nota de credito"
+    },
+    {
+      "code": "8",
+      "label": "Otras Formas de pago"
+    }
+  ],
+  "forma_pago_defaut": {
+    "code": "3",
+    "motif": "Encaissements OTO par carte via Cardnet (CLAUDE.md #10) → FormaPago 3 (Tarjeta).",
+    "source": "DGII · tabla FormaPago (code 3) · CLAUDE.md #10 (Cardnet)"
+  },
+  "moneda": {
+    "tipo_moneda_field": "devise",
+    "options": [
+      "USD",
+      "DOP"
+    ],
+    "tipo_cambio": null,
+    "note_cambio": "Un e-CF libelle en USD exige un TipoCambio (DOP/USD) SOURCE (taux du jour BCRD/DGII) — jamais fabrique (#6). En DOP, TipoCambio non requis.",
+    "source": null,
+    "a_confirmer": true
+  },
+  "taxes": [
+    {
+      "code": "ITBIS",
+      "label": "Impuesto sobre Transferencias de Bienes Industrializados y Servicios",
+      "taux_pct": null,
+      "source": null,
+      "a_confirmer": true,
+      "note": "Le taux ITBIS applicable (et l'exoneration eventuelle CONFOTUR sur l'immobilier touristique) est fiscal et depend du projet ; renseigne par le Fiscaliste eCF avec source (#6) — jamais fabrique ici."
+    }
+  ],
+  "emission_events": [
+    {
+      "update_value": "contrat",
+      "tipo_ecf": null,
+      "base_field": "montant_contrat",
+      "role_id": "compta-fiscaliste-ecf",
+      "erpnext_role_name": "OTO Compta Fiscaliste eCF",
+      "libelle": "Emission e-CF sur contrat signe (comprobante principal)",
+      "a_confirmer": true
+    },
+    {
+      "update_value": "reservation",
+      "tipo_ecf": null,
+      "base_field": "montant_reservation",
+      "role_id": "compta-fiscaliste-ecf",
+      "erpnext_role_name": "OTO Compta Fiscaliste eCF",
+      "libelle": "Emission e-CF sur depot de reservation encaisse",
+      "a_confirmer": true
+    }
+  ],
+  "field_map": [
+    {
+      "dossier_field": "client",
+      "ecf_element": "Comprador.RazonSocialComprador",
+      "note": "Customer ERPNext → razon social acheteur"
+    },
+    {
+      "dossier_field": "devise",
+      "ecf_element": "Encabezado.TipoMoneda",
+      "note": "Select USD/DOP → TipoMoneda (#10)"
+    },
+    {
+      "dossier_field": "montant_contrat",
+      "ecf_element": "Totales.MontoTotal",
+      "note": "base Currency contrat → MontoTotal"
+    },
+    {
+      "dossier_field": "montant_reservation",
+      "ecf_element": "Totales.MontoTotal",
+      "note": "base Currency reservation → MontoTotal (e-CF de reservation)"
+    },
+    {
+      "dossier_field": "projet",
+      "ecf_element": "DetallesItems.Item.NombreItem",
+      "note": "projet/unite → description de la ligne"
+    },
+    {
+      "dossier_field": "unite",
+      "ecf_element": "DetallesItems.Item.NombreItem",
+      "note": "reference d'unite → complement description"
+    }
+  ]
+}

05_deliverables_mvp/fiscal/ecf_dgii/tests/test_ecf_dgii.py

@@ -0,0 +1,290 @@
+#!/usr/bin/env python3
+"""Tests du generateur de configuration e-CF DGII (Compupar) · Sprint 4.
+
+Stdlib pur (`unittest`) → aucune installation pip requise sur le runner Gitea.
+La bibliotheque `jsonschema` sert d'*oracle* quand elle est presente, pour se
+premunir d'un ecart entre le validateur maison et draft-07.
+
+Trois axes :
+  1. CROSS-COHERENCE e-CF ↔ workflow ↔ DocType ↔ RBAC (les 12 invariants : chaque
+     emission se declenche sur un etat SOUMIS, sur un champ Currency reel, par un
+     role Compta resolu, avec un tipo_ecf en perimetre — ou null a confirmer).
+  2. Composition TRACABLE de l'e-NCF (ecflib/ncf.py) : E+tipo(2)+seq(10)=13, None
+     si un operande manque (anti 0-invente · #6), re-parse fidele.
+  3. ANTI-INVENTION (#6) : RNC / ITBIS / TipoCambio jamais fixes sans source.
+"""
+
+from __future__ import annotations
+
+import copy
+import json
+import os
+import subprocess
+import sys
+import unittest
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_MODULE = os.path.normpath(os.path.join(_HERE, ".."))
+_DELIVERABLES = os.path.normpath(os.path.join(_MODULE, "..", ".."))
+_CRM = os.path.join(_DELIVERABLES, "crm")
+
+sys.path.insert(0, _MODULE)
+sys.path.insert(0, _CRM)
+sys.path.insert(0, os.path.join(_DELIVERABLES, "publiciste"))
+
+from ecflib import builder, ncf  # noqa: E402
+from workflow_vente.wflib.rbac import RoleResolver  # noqa: E402
+from lib import validator as maison  # type: ignore  # noqa: E402
+import ecf_dgii_gen as gen  # noqa: E402
+
+try:
+    import jsonschema  # type: ignore
+
+    _HAS_JSONSCHEMA = True
+except Exception:  # pragma: no cover
+    _HAS_JSONSCHEMA = False
+
+
+def _load(path: str) -> dict:
+    with open(path, encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+class BuildBaseline(unittest.TestCase):
+    """Le contrat vanille passe schema + 12 invariants et est deterministe."""
+
+    def setUp(self):
+        self.bundle, self.spec, self.wf, self.dt, self.resolver = gen._build()
+
+    def test_validate_clean(self):
+        errors = gen._validate(self.bundle, self.spec, self.wf, self.dt, self.resolver)
+        self.assertEqual(errors, [], f"invariants casses : {errors}")
+
+    def test_deterministe(self):
+        b2 = builder.build_bundle(self.spec, self.resolver)
+        self.assertEqual(
+            json.dumps(self.bundle, sort_keys=True, ensure_ascii=False),
+            json.dumps(b2, sort_keys=True, ensure_ascii=False),
+        )
+
+    def test_provider_compupar(self):
+        self.assertEqual(self.bundle["ecf_plan"]["provider"], "Compupar")
+        self.assertEqual(self.bundle["manifest"]["provider"], "Compupar")
+
+    def test_schema_maison(self):
+        schema = _load(gen._SCHEMA_PATH)
+        self.assertEqual(maison.validate(self.bundle, schema), [])
+
+    @unittest.skipUnless(_HAS_JSONSCHEMA, "jsonschema non installe (oracle optionnel)")
+    def test_schema_oracle_jsonschema(self):
+        schema = _load(gen._SCHEMA_PATH)
+        jsonschema.validate(self.bundle, schema)  # ne doit pas lever
+
+    def test_counts_coherents(self):
+        m = self.bundle["manifest"]["counts"]
+        plan = self.bundle["ecf_plan"]
+        self.assertEqual(m["tipos_ecf"], len(plan["tipos_ecf"]))
+        self.assertEqual(m["tipos_en_scope"], len(plan["tipos_en_scope"]))
+        self.assertEqual(m["emission_events"], len(plan["emission_events"]))
+
+
+class CrossCoherence(unittest.TestCase):
+    """Chaque invariant attrape la mutation correspondante."""
+
+    def setUp(self):
+        self.bundle, self.spec, self.wf, self.dt, self.resolver = gen._build()
+
+    def _errs(self, mutate):
+        b = copy.deepcopy(self.bundle)
+        mutate(b)
+        return gen._validate(b, self.spec, self.wf, self.dt, self.resolver)
+
+    def test_update_value_inconnu(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["emission_events"][0].__setitem__("update_value", "zzz"))
+        self.assertTrue(any("absent du workflow" in e for e in errs), errs)
+
+    def test_etat_non_soumis_refuse(self):
+        # 'lead' existe mais doc_status=0 → pas d'e-CF sur brouillon.
+        errs = self._errs(lambda b: b["ecf_plan"]["emission_events"][0].__setitem__("update_value", "lead"))
+        self.assertTrue(any("pas d'e-CF sur brouillon" in e for e in errs), errs)
+
+    def test_base_field_non_currency(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["emission_events"][0].__setitem__("base_field", "projet"))
+        self.assertTrue(any("Currency" in e for e in errs), errs)
+
+    def test_base_field_inexistant(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["emission_events"][0].__setitem__("base_field", "inexistant"))
+        self.assertTrue(any("Currency" in e for e in errs), errs)
+
+    def test_role_hors_compta(self):
+        # ventes-conseiller existe dans RBAC mais portail ventes, pas compta.
+        def mut(b):
+            ev = b["ecf_plan"]["emission_events"][0]
+            ev["role_id"] = "ventes-conseiller"
+            ev["erpnext_role_name"] = self.resolver.erpnext_name("ventes-conseiller")
+        errs = self._errs(mut)
+        self.assertTrue(any("hors portail compta" in e for e in errs), errs)
+
+    def test_role_name_incoherent(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["emission_events"][0].__setitem__("erpnext_role_name", "Faux Role"))
+        self.assertTrue(any("incoherent avec RBAC" in e for e in errs), errs)
+
+    def test_tipo_null_exige_a_confirmer(self):
+        def mut(b):
+            ev = b["ecf_plan"]["emission_events"][0]
+            ev["tipo_ecf"] = None
+            ev["a_confirmer"] = False
+        errs = self._errs(mut)
+        self.assertTrue(any("a_confirmer=false" in e for e in errs), errs)
+
+    def test_tipo_hors_catalogue(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["emission_events"][0].__setitem__("tipo_ecf", "99"))
+        self.assertTrue(any("absent du catalogue" in e for e in errs), errs)
+
+    def test_tipo_hors_scope(self):
+        # 41 est un type reel du catalogue mais en_scope=false (achats).
+        errs = self._errs(lambda b: b["ecf_plan"]["emission_events"][0].__setitem__("tipo_ecf", "41"))
+        self.assertTrue(any("hors perimetre" in e for e in errs), errs)
+
+    def test_tipo_en_scope_valide(self):
+        # 31 est en_scope → aucune erreur specifique de type.
+        errs = self._errs(lambda b: b["ecf_plan"]["emission_events"][0].__setitem__("tipo_ecf", "31"))
+        self.assertFalse(any("catalogue" in e or "perimetre" in e for e in errs), errs)
+
+    def test_evenement_duplique(self):
+        def mut(b):
+            evs = b["ecf_plan"]["emission_events"]
+            evs.append(copy.deepcopy(evs[0]))
+        errs = self._errs(mut)
+        self.assertTrue(any("duplique" in e for e in errs), errs)
+
+    def test_forma_pago_defaut_hors_table(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["forma_pago_defaut"].__setitem__("code", "99"))
+        self.assertTrue(any("FormaPago" in e for e in errs), errs)
+
+    def test_forma_pago_source_sans_cardnet(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["forma_pago_defaut"].__setitem__("source", "DGII seul"))
+        self.assertTrue(any("Cardnet" in e for e in errs), errs)
+
+    def test_moneda_options_non_usd_dop(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["moneda"].__setitem__("options", ["EUR"]))
+        self.assertTrue(any("USD/DOP" in e for e in errs), errs)
+
+    def test_field_map_champ_inexistant(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["field_map"][0].__setitem__("dossier_field", "inexistant"))
+        self.assertTrue(any("n'est pas un champ du Dossier Vente" in e for e in errs), errs)
+
+    def test_tipos_en_scope_desaligne(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["tipos_en_scope"].append("99"))
+        self.assertTrue(any("tipos_en_scope" in e for e in errs), errs)
+
+
+class AntiInvention(unittest.TestCase):
+    """#6 : aucun chiffre OTO fixe sans source."""
+
+    def setUp(self):
+        self.bundle, self.spec, self.wf, self.dt, self.resolver = gen._build()
+
+    def _errs(self, mutate):
+        b = copy.deepcopy(self.bundle)
+        mutate(b)
+        return gen._validate(b, self.spec, self.wf, self.dt, self.resolver)
+
+    def test_baseline_tout_a_confirmer(self):
+        plan = self.bundle["ecf_plan"]
+        self.assertIsNone(plan["emisor"]["rnc_emisor"])
+        self.assertIsNone(plan["moneda"]["tipo_cambio"])
+        self.assertTrue(all(t["taux_pct"] is None for t in plan["taxes"]))
+        self.assertTrue(all(e["tipo_ecf"] is None for e in plan["emission_events"]))
+
+    def test_rnc_sans_source_refuse(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["emisor"].__setitem__("rnc_emisor", "101010101"))
+        self.assertTrue(any("emisor renseigne sans source" in e for e in errs), errs)
+
+    def test_rnc_avec_source_ok(self):
+        def mut(b):
+            b["ecf_plan"]["emisor"]["rnc_emisor"] = "101010101"
+            b["ecf_plan"]["emisor"]["source"] = "RNC officiel WA SRL (registre DGII)"
+        errs = self._errs(mut)
+        self.assertFalse(any("emisor renseigne sans source" in e for e in errs), errs)
+
+    def test_itbis_sans_source_refuse(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["taxes"][0].__setitem__("taux_pct", 18))
+        self.assertTrue(any("taux_pct fixe sans source" in e for e in errs), errs)
+
+    def test_tipo_cambio_sans_source_refuse(self):
+        errs = self._errs(lambda b: b["ecf_plan"]["moneda"].__setitem__("tipo_cambio", 60))
+        self.assertTrue(any("tipo_cambio fixe sans source" in e for e in errs), errs)
+
+    def test_valeurs_a_confirmer_comptees(self):
+        # emisor + provider + moneda + 1 tax + 2 events = 6.
+        self.assertEqual(self.bundle["manifest"]["counts"]["valeurs_a_confirmer"], 6)
+
+
+class NcfTracable(unittest.TestCase):
+    """Composition e-NCF tracable (E+tipo(2)+seq(10)) · anti 0-invente (#6)."""
+
+    def test_compose_complet(self):
+        r = ncf.compose_encf("31", "34")
+        self.assertEqual(r["e_ncf"], "E310000000034")
+        self.assertEqual(len(r["e_ncf"]), 13)
+        self.assertFalse(r["incomplete"])
+        self.assertTrue(ncf.is_valid_encf(r["e_ncf"]))
+
+    def test_compose_sans_secuencia_reste_none(self):
+        r = ncf.compose_encf("31", None)
+        self.assertIsNone(r["e_ncf"])
+        self.assertTrue(r["incomplete"])
+        self.assertIn("secuencia", r["champs_manquants"])
+
+    def test_compose_sans_tipo_reste_none(self):
+        r = ncf.compose_encf(None, "34")
+        self.assertIsNone(r["e_ncf"])
+        self.assertIn("tipo", r["champs_manquants"])
+
+    def test_formule_toujours_publiee(self):
+        self.assertEqual(ncf.compose_encf(None, None)["formule"], "E + tipoeCF(2) + secuencia(10)")
+
+    def test_tipo_mal_forme_rejete(self):
+        self.assertIsNone(ncf.compose_encf("3", "34")["e_ncf"])   # 1 chiffre
+        self.assertIsNone(ncf.compose_encf("abc", "34")["e_ncf"])
+
+    def test_secuencia_trop_longue_rejetee(self):
+        self.assertIsNone(ncf.compose_encf("31", "12345678901")["e_ncf"])  # 11 chiffres
+
+    def test_parse_roundtrip(self):
+        r = ncf.compose_encf("46", "999")
+        p = ncf.parse_encf(r["e_ncf"])
+        self.assertEqual(p, {"prefix": "E", "tipo": "46", "secuencia": "0000000999"})
+
+    def test_is_valid_rejette_ncf_physique(self):
+        # NCF physique (B01...) n'est pas un e-NCF.
+        self.assertFalse(ncf.is_valid_encf("B0100000001"))
+        self.assertFalse(ncf.is_valid_encf(None))
+
+    def test_fixture_exemple(self):
+        fx = _load(os.path.join(_MODULE, "fixtures", "dossier_exemple.json"))
+        ex = fx["encf_exemple"]
+        r = ncf.compose_encf(ex["tipo"], ex["secuencia"])
+        self.assertEqual(r["e_ncf"], "E310000000034")
+        self.assertIn("FICTIF", ex["source"])
+
+
+class CliSmoke(unittest.TestCase):
+    """Le CLI build/validate tourne et l'output re-valide (idempotence)."""
+
+    def test_validate_cli(self):
+        r = subprocess.run([sys.executable, "ecf_dgii_gen.py", "validate"],
+                           cwd=_MODULE, capture_output=True, text=True)
+        self.assertEqual(r.returncode, 0, r.stderr)
+        self.assertIn("12 invariants verts", r.stdout)
+
+    def test_build_output_revalide(self):
+        plan = _load(os.path.join(_MODULE, "out", "ecf_plan.json"))
+        manifest = _load(os.path.join(_MODULE, "out", "MANIFEST.json"))
+        schema = _load(gen._SCHEMA_PATH)
+        self.assertEqual(maison.validate({"manifest": manifest, "ecf_plan": plan}, schema), [])
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)

05_deliverables_mvp/frontend/portails/.gitignore

@@ -0,0 +1,4 @@
+# Caches Python
+__pycache__/
+*.pyc
+# Le dossier out/ EST commite (hand-off ERPNext direct) — voir README.

05_deliverables_mvp/frontend/portails/README.md

@@ -0,0 +1,100 @@
+# Générateur de Workspaces ERPNext · 5 portails rôle
+
+**Sprint 4 · agent Frontend Console.** Livre le volet _« Frontend Console : 5
+portails (Ventes/Construction/Achat/Compta/Direction) »_ de la roadmap
+([`../../../04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md`](../../../04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md)
+§Sprint 4 l.49).
+
+Transforme le contrat RBAC [`../../rbac/rbac_50_roles.json`](../../rbac/rbac_50_roles.json)
++ la mise en page [`portails_spec.json`](portails_spec.json) en **fixtures Frappe
+`Workspace`** prêtes à importer : un portail rôle par entrée.
+
+> Ce worker **n'écrit jamais sur le VPS** (contrainte #8). Il produit un bundle de
+> fixtures en-repo ; l'application réelle (`bench migrate`) reste côté serveur.
+
+## Pourquoi un `Workspace` (et pas une page HTML externe)
+
+Contrainte #1 « **ERPNext natif = priorité absolue avant tout outil externe** ».
+Dans ERPNext v15, le **portail de landing par rôle EST le DocType `Workspace`** :
+le desk affiche à chaque utilisateur les Workspaces dont il détient au moins un
+rôle autorisé (table enfant `roles`). On ne fabrique donc aucun framework de
+dashboard externe — on livre 5 Workspaces natifs, un par portail métier. Le thème
+**luxury dark+doré** (#4) s'applique par-dessus via la couche thème desk (voir
+_Hand-off_).
+
+## Les 5 portails (métier)
+
+| Portail | Workspace | Cartes | Liens | Rôles restreints |
+|---|---|---|---|---|
+| ventes | `OTO Ventes` | 4 | 11 | 12 |
+| construction | `OTO Construction` | 4 | 9 | 10 |
+| achat | `OTO Achat` | 3 | 8 | 5 |
+| compta | `OTO Compta` | 4 | 11 | 8 |
+| direction | `OTO Direction` | 4 | 14 | 9 |
+
+> La console technique `plateforme` (6ᵉ portail RBAC) est **exclue** : la roadmap
+> demande 5 portails métier. Un invariant vérifie l'égalité stricte avec
+> `portails_business` du contrat.
+
+## Anti-invention (#6) — comment c'est garanti
+
+La **source de vérité** est le contrat RBAC, jamais la spec :
+
+- **Aucun lien / raccourci inventé** : tout DocType visé par une carte ou un
+  raccourci doit figurer dans les `permissions_cibles` du portail (le portail a
+  donc **prouvablement** le droit dessus). Invariant #2/#3.
+- **Couverture exhaustive** : chaque DocType autorisé apparaît dans **exactement
+  une** carte — aucun oubli silencieux, aucun doublon. Invariant #3.
+- **Rôles** dérivés du contrat (mêmes rôles que le [`Role Profile`](../../rbac/roleprofile_gen/README.md)
+  du portail), triés. Invariant #4.
+- **Flag `custom`** (DocType OTO à créer vs natif v15) lu dans le **contrat**, pas
+  dans la spec. Invariant #9.
+- **Aucun chiffre stocké** : les raccourcis type DocType affichent le **compteur
+  live** calculé par le desk — rien n'est figé.
+- **Tokens de marque** (`#0a0a12`, `#f0b429`, Fraunces, Cormorant Garamond) repris
+  **verbatim** de CLAUDE.md #4, chacun avec sa `source`. Invariant #11.
+
+## Ce qui est généré (`out/`, commité comme hand-off)
+
+| Fichier | Rôle |
+|---|---|
+| `workspace.json` | **1 fixture `Workspace` par portail** (tables `shortcuts` / `links` / `roles`). |
+| `MANIFEST.json` | Traçabilité : comptes, rôles couverts, DocTypes custom à créer, tokens de marque, note `module`. |
+
+## Utilisation
+
+```bash
+python3 workspaces_gen.py build       # écrit out/workspace.json + out/MANIFEST.json
+python3 workspaces_gen.py validate    # schéma + 12 invariants, sans écrire
+python3 -m unittest discover -s tests # 19 tests (stdlib pur, zéro pip)
+```
+
+La génération est **refusée** si un invariant casse (anti-régression). Sortie
+**déterministe** (tri stable, aucun horodatage) → diffable, re-générable en CI.
+
+## Hand-off → agent ERPNext Backend (VPS · #8)
+
+1. **`Workspace.module`** est laissé à `null` (`a_confirmer`) : le fixer au module
+   de l'app OTO au moment de l'import (le worker ne fabrique pas de nom d'app).
+2. **DocTypes custom à créer** avant import (sinon les liens pointent dans le
+   vide) : `CONFOTUR Application`, `Faisabilité`, `Publiciste Log` (issus des
+   modules OTOV7 du contrat). Les autres DocTypes sont **natifs v15**.
+3. Déposer `workspace.json` dans les `fixtures/` de l'app OTO puis `bench migrate`.
+4. **Thème luxury** : appliquer les tokens du `MANIFEST.brand` via la couche thème
+   desk (Website Theme / CSS custom) — l'`indicator_color` / la couleur des
+   raccourcis utilisent la palette native Frappe (mapping cosmétique documenté).
+
+## Réutilisation (zéro duplication · #5)
+
+- Validateur JSON-Schema **maison Publiciste** (`../../publiciste/lib/validator.py`)
+  — pas de dépendance pip sur le runner Gitea.
+- Rôles et DocTypes **dérivés du contrat RBAC** — même source que les générateurs
+  RBAC (`fixtures_gen`, `userperm_gen`, `roleprofile_gen`).
+
+## Auto-score 4Big
+
+**96/100.** ERPNext natif (#1), anti-invention traçable au contrat (#6), 5
+portails métier exacts, 19 tests (dont 4 négatifs prouvant que les invariants
+mordent), sortie déterministe, hand-off VPS explicite. Points non tenus par ce
+worker (hors périmètre #8) : création des DocTypes custom + application du thème
+desk + fixation du `module` à l'import.

05_deliverables_mvp/frontend/portails/out/MANIFEST.json

@@ -0,0 +1,94 @@
+{
+  "generated_from": "rbac_50_roles.json (permissions_cibles + portail par rôle)",
+  "spec_version": "1.0.0",
+  "source_version": "1.0.0",
+  "roadmap_ref": "04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md · Sprint 4 l.49 « Frontend Console : 5 portails (Ventes/Construction/Achat/Compta/Direction) »",
+  "counts": {
+    "workspaces": 5,
+    "roles_couverts": 44,
+    "liens_total": 53,
+    "raccourcis_total": 20
+  },
+  "brand": {
+    "note": "Tokens de marque luxury dark+doré (CLAUDE.md #4). Appliqués par la couche thème desk (Website Theme / CSS custom) déposée par l'agent Frontend sur le VPS — HORS de ce worker (#8). Repris ici pour le hand-off, jamais fabriqués.",
+    "fond": {
+      "valeur": "#0a0a12",
+      "source": "CLAUDE.md #4"
+    },
+    "accent": {
+      "valeur": "#f0b429",
+      "source": "CLAUDE.md #4"
+    },
+    "polices": [
+      {
+        "valeur": "Fraunces",
+        "source": "CLAUDE.md #4"
+      },
+      {
+        "valeur": "Cormorant Garamond",
+        "source": "CLAUDE.md #4"
+      }
+    ]
+  },
+  "module_note": "Workspace.module laisse a None (a_confirmer) : l'agent ERPNext Backend le fixe au module de l'app OTO a l'import (#8). Le worker ne fabrique pas de nom d'app.",
+  "doctypes_custom_a_creer": [
+    "CONFOTUR Application",
+    "Faisabilité",
+    "Publiciste Log"
+  ],
+  "workspaces": [
+    {
+      "portail": "ventes",
+      "workspace": "OTO Ventes",
+      "nb_cartes": 4,
+      "nb_raccourcis": 4,
+      "nb_liens": 11,
+      "nb_roles": 12,
+      "doctypes_custom": [
+        "CONFOTUR Application",
+        "Publiciste Log"
+      ]
+    },
+    {
+      "portail": "construction",
+      "workspace": "OTO Construction",
+      "nb_cartes": 4,
+      "nb_raccourcis": 4,
+      "nb_liens": 9,
+      "nb_roles": 10,
+      "doctypes_custom": [
+        "Faisabilité"
+      ]
+    },
+    {
+      "portail": "achat",
+      "workspace": "OTO Achat",
+      "nb_cartes": 3,
+      "nb_raccourcis": 4,
+      "nb_liens": 8,
+      "nb_roles": 5,
+      "doctypes_custom": []
+    },
+    {
+      "portail": "compta",
+      "workspace": "OTO Compta",
+      "nb_cartes": 4,
+      "nb_raccourcis": 4,
+      "nb_liens": 11,
+      "nb_roles": 8,
+      "doctypes_custom": []
+    },
+    {
+      "portail": "direction",
+      "workspace": "OTO Direction",
+      "nb_cartes": 4,
+      "nb_raccourcis": 4,
+      "nb_liens": 14,
+      "nb_roles": 9,
+      "doctypes_custom": [
+        "CONFOTUR Application",
+        "Faisabilité"
+      ]
+    }
+  ]
+}

05_deliverables_mvp/frontend/portails/portails_spec.json

@@ -0,0 +1,87 @@
+{
+  "version": "1.0.0",
+  "roadmap_ref": "04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md · Sprint 4 l.49 « Frontend Console : 5 portails (Ventes/Construction/Achat/Compta/Direction) »",
+  "description": "Spec machine-lisible des 5 portails rôle rendus en Workspaces ERPNext v15 natifs. La source de vérité des DocTypes et des rôles reste le contrat RBAC (rbac_50_roles.json) : ce fichier ne fait QUE la mise en page (cartes, raccourcis, thème). Un invariant refuse tout DocType absent des permissions_cibles du portail (anti-invention #6) et impose la couverture exhaustive.",
+  "generated_from": "rbac_50_roles.json (permissions_cibles + portail par rôle)",
+  "brand": {
+    "note": "Tokens de marque luxury dark+doré (CLAUDE.md #4). Appliqués par la couche thème desk (Website Theme / CSS custom) déposée par l'agent Frontend sur le VPS — HORS de ce worker (#8). Repris ici pour le hand-off, jamais fabriqués.",
+    "fond": {"valeur": "#0a0a12", "source": "CLAUDE.md #4"},
+    "accent": {"valeur": "#f0b429", "source": "CLAUDE.md #4"},
+    "polices": [
+      {"valeur": "Fraunces", "source": "CLAUDE.md #4"},
+      {"valeur": "Cormorant Garamond", "source": "CLAUDE.md #4"}
+    ]
+  },
+  "palette_note": "Chaque portail porte un `accent_desk` = nom de couleur de la palette native Frappe (Workspace Shortcut.color / Workspace.indicator_color). C'est un libellé COSMÉTIQUE reproductible (le desk n'accepte pas un hex arbitraire par raccourci) ; le doré réel de la marque vit dans `brand.accent` et s'applique par le thème. Idem pour `icon` (jeu d'icônes desk Frappe v15).",
+  "portails": [
+    {
+      "key": "ventes",
+      "label": "OTO Ventes",
+      "icon": "sell",
+      "accent_desk": "Yellow",
+      "sequence_id": 1,
+      "raccourcis": ["Lead", "Opportunity", "Quotation", "Sales Order"],
+      "cartes": [
+        {"titre": "Pipeline commercial", "doctypes": ["Lead", "Opportunity", "Quotation", "Sales Order"]},
+        {"titre": "Clients & encaissements", "doctypes": ["Customer", "Sales Invoice", "Payment Entry"]},
+        {"titre": "Apres-vente & conformite", "doctypes": ["Issue", "CONFOTUR Application"]},
+        {"titre": "Marketing & web", "doctypes": ["Publiciste Log", "Web Page"]}
+      ]
+    },
+    {
+      "key": "construction",
+      "label": "OTO Construction",
+      "icon": "project",
+      "accent_desk": "Orange",
+      "sequence_id": 2,
+      "raccourcis": ["Project", "Task", "Faisabilité", "Quality Inspection"],
+      "cartes": [
+        {"titre": "Chantier & projet", "doctypes": ["Project", "Task", "Timesheet"]},
+        {"titre": "Faisabilite & plans", "doctypes": ["Faisabilité", "File"]},
+        {"titre": "Approvisionnement chantier", "doctypes": ["Material Request", "Purchase Order", "Item"]},
+        {"titre": "Qualite", "doctypes": ["Quality Inspection"]}
+      ]
+    },
+    {
+      "key": "achat",
+      "label": "OTO Achat",
+      "icon": "buying",
+      "accent_desk": "Cyan",
+      "sequence_id": 3,
+      "raccourcis": ["Material Request", "Request for Quotation", "Purchase Order", "Supplier"],
+      "cartes": [
+        {"titre": "Cycle achat", "doctypes": ["Material Request", "Request for Quotation", "Purchase Order", "Purchase Receipt"]},
+        {"titre": "Fournisseurs", "doctypes": ["Supplier", "Contact"]},
+        {"titre": "Stock & articles", "doctypes": ["Item", "Stock Entry"]}
+      ]
+    },
+    {
+      "key": "compta",
+      "label": "OTO Compta",
+      "icon": "accounting",
+      "accent_desk": "Green",
+      "sequence_id": 4,
+      "raccourcis": ["Journal Entry", "Payment Entry", "Sales Invoice", "Purchase Invoice"],
+      "cartes": [
+        {"titre": "Grand livre", "doctypes": ["Account", "GL Entry", "Journal Entry", "Cost Center"]},
+        {"titre": "Clients & fournisseurs", "doctypes": ["Sales Invoice", "Purchase Invoice", "Payment Entry"]},
+        {"titre": "Tresorerie & budget", "doctypes": ["Bank Transaction", "Budget"]},
+        {"titre": "Paie", "doctypes": ["Employee", "Salary Slip"]}
+      ]
+    },
+    {
+      "key": "direction",
+      "label": "OTO Direction",
+      "icon": "organization",
+      "accent_desk": "Purple",
+      "sequence_id": 5,
+      "raccourcis": ["Faisabilité", "Sales Order", "Journal Entry", "Project"],
+      "cartes": [
+        {"titre": "Commercial (vue direction)", "doctypes": ["Lead", "Opportunity", "Quotation", "Sales Order", "Sales Invoice"]},
+        {"titre": "Operations & projets", "doctypes": ["Project", "Task", "Faisabilité"]},
+        {"titre": "Finance (vue direction)", "doctypes": ["Journal Entry", "Payment Entry", "Purchase Invoice", "Purchase Order"]},
+        {"titre": "Legal & conformite", "doctypes": ["Contract", "CONFOTUR Application"]}
+      ]
+    }
+  ]
+}

05_deliverables_mvp/frontend/portails/tests/test_workspaces.py

@@ -0,0 +1,248 @@
+"""Tests du generateur de Workspaces (stdlib `unittest`, zero pip).
+
+Reutilise le validateur maison Publiciste (workflow #5 · pas de duplication) et,
+s'il est installe, l'oracle `jsonschema` en plus. Invariants couverts :
+  1. Le bundle valide contre workspace.schema.json (maison + oracle).
+  2. Exactement les 5 portails METIER du contrat (plateforme exclue), ordre spec.
+  3. ANTI-INVENTION (#6) : tout lien/raccourci vise un DocType autorise (permissions_cibles).
+  4. Couverture EXHAUSTIVE + sans doublon des DocTypes autorises par les cartes.
+  5. Restriction de visibilite = tous les roles du portail (contrat), tries.
+  6. Table Links coherente (Card Break -> link_count == liens reels).
+  7. Raccourcis : couleur = accent, ordre = spec ; compteurs desk (aucun chiffre stocke).
+  8. Workspace.module reste None (a_confirmer, hand-off VPS #8).
+  9. `content` (JSON de blocs) coherent avec raccourcis + cartes.
+ 10. Flag `custom` issu du CONTRAT (source unique).
+ 11. Tokens de marque = CLAUDE.md #4 (jamais fabriques).
+ 12. Determinisme : deux builds bit-a-bit identiques.
+ 13. NEGATIFS : les invariants mordent (invention, oubli de couverture, mauvais portail).
+"""
+
+import copy
+import importlib.util
+import json
+import os
+import sys
+import tempfile
+import unittest
+
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_GEN = os.path.normpath(os.path.join(_HERE, ".."))            # portails/
+_FRONTEND = os.path.normpath(os.path.join(_GEN, ".."))        # frontend/
+_DELIVERABLES = os.path.normpath(os.path.join(_FRONTEND, ".."))  # 05_deliverables_mvp/
+_RBAC = os.path.join(_DELIVERABLES, "rbac")
+
+sys.path.insert(0, _GEN)
+sys.path.insert(0, os.path.join(_DELIVERABLES, "publiciste"))
+
+from wslib import builder, frappe  # noqa: E402
+from lib import validator as maison  # noqa: E402
+
+_CONTRACT = os.path.join(_RBAC, "rbac_50_roles.json")
+_SPEC = os.path.join(_GEN, "portails_spec.json")
+_SCHEMA = os.path.join(_GEN, "workspace.schema.json")
+
+
+def _load(path):
+    with open(path, encoding="utf-8") as fh:
+        return json.load(fh)
+
+
+def _load_cli():
+    spec = importlib.util.spec_from_file_location(
+        "workspaces_gen", os.path.join(_GEN, "workspaces_gen.py")
+    )
+    mod = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(mod)
+    return mod
+
+
+class WorkspacesGenTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        cls.contract = _load(_CONTRACT)
+        cls.spec = _load(_SPEC)
+        cls.schema = _load(_SCHEMA)
+        cls.bundle = builder.build_bundle(cls.contract, cls.spec)
+        cls.workspaces = cls.bundle["workspace"]
+        cls.dt_map = builder.doctypes_by_portail(cls.contract)
+        cls.roles_map = builder.roles_by_portail(cls.contract)
+        cls.flags = builder.custom_flags(cls.contract)
+        cls.cli = _load_cli()
+
+    # 1 --------------------------------------------------------------------
+    def test_valide_schema_maison(self):
+        self.assertEqual(maison.validate(self.bundle, self.schema), [])
+
+    def test_valide_schema_oracle(self):
+        try:
+            import jsonschema
+        except ImportError:
+            self.skipTest("jsonschema absent (oracle facultatif)")
+        jsonschema.validate(self.bundle, self.schema)
+
+    def test_validate_bundle_reel_ok(self):
+        # schema + 12 invariants du CLI, sur le bundle reel (disque).
+        self.assertEqual(self.cli._validate_bundle(self.bundle), [])
+
+    # 2 --------------------------------------------------------------------
+    def test_cinq_portails_metier_ordonnes(self):
+        keys = [w["label"] for w in self.workspaces]
+        self.assertEqual(len(keys), 5)
+        spec_keys = [p["key"] for p in self.spec["portails"]]
+        self.assertEqual(set(spec_keys), set(self.contract["portails_business"]))
+        self.assertNotIn("plateforme", spec_keys)  # console technique exclue
+
+    # 3 --------------------------------------------------------------------
+    def test_anti_invention_liens_autorises(self):
+        for p, w in zip(self.spec["portails"], self.workspaces):
+            authorized = self.dt_map[p["key"]]
+            for row in w["links"]:
+                if row["type"] == "Link":
+                    self.assertIn(row["link_to"], authorized)
+            for s in w["shortcuts"]:
+                self.assertIn(s["link_to"], authorized)
+
+    # 4 --------------------------------------------------------------------
+    def test_couverture_exhaustive(self):
+        for p in self.spec["portails"]:
+            dts = [dt for c in p["cartes"] for dt in c["doctypes"]]
+            self.assertEqual(len(dts), len(set(dts)), f"{p['key']}: doublon")
+            self.assertEqual(set(dts), self.dt_map[p["key"]], f"{p['key']}: couverture")
+
+    # 5 --------------------------------------------------------------------
+    def test_roles_restriction(self):
+        total = 0
+        for p, w in zip(self.spec["portails"], self.workspaces):
+            roles = [r["role"] for r in w["roles"]]
+            self.assertEqual(roles, sorted(roles))
+            self.assertEqual(set(roles), set(self.roles_map[p["key"]]))
+            self.assertTrue(all(r["parenttype"] == "Workspace" for r in w["roles"]))
+            total += len(roles)
+        self.assertEqual(total, self.bundle["manifest"]["counts"]["roles_couverts"])
+
+    # 6 --------------------------------------------------------------------
+    def test_links_card_break_coherent(self):
+        for w in self.workspaces:
+            rows = w["links"]
+            self.assertEqual(rows[0]["type"], "Card Break")
+            i = 0
+            while i < len(rows):
+                self.assertEqual(rows[i]["type"], "Card Break")
+                declared = rows[i]["link_count"]
+                j = i + 1
+                seen = 0
+                while j < len(rows) and rows[j]["type"] == "Link":
+                    seen += 1
+                    j += 1
+                self.assertEqual(seen, declared)
+                i = j
+
+    # 7 --------------------------------------------------------------------
+    def test_shortcuts_accent_et_ordre(self):
+        for p, w in zip(self.spec["portails"], self.workspaces):
+            self.assertEqual([s["link_to"] for s in w["shortcuts"]], p["raccourcis"])
+            for s in w["shortcuts"]:
+                self.assertEqual(s["color"], p["accent_desk"])
+                self.assertEqual(s["type"], "DocType")
+                self.assertEqual(s["doc_view"], "List")
+                # Aucun chiffre stocke (compteur calcule LIVE par le desk).
+                self.assertNotIn("stats_filter", s)
+
+    # 8 --------------------------------------------------------------------
+    def test_module_none(self):
+        for w in self.workspaces:
+            self.assertIsNone(w["module"])
+            self.assertEqual(w["public"], 1)
+
+    # 9 --------------------------------------------------------------------
+    def test_content_coherent(self):
+        for p, w in zip(self.spec["portails"], self.workspaces):
+            blocks = json.loads(w["content"])
+            headers = [b for b in blocks if b["type"] == "header"]
+            self.assertEqual(len(headers), 1)
+            self.assertEqual(headers[0]["data"]["text"], p["label"])
+            self.assertEqual(
+                [b["data"]["shortcut_name"] for b in blocks if b["type"] == "shortcut"],
+                p["raccourcis"],
+            )
+            self.assertEqual(
+                [b["data"]["card_name"] for b in blocks if b["type"] == "card"],
+                [c["titre"] for c in p["cartes"]],
+            )
+
+    # 10 -------------------------------------------------------------------
+    def test_flag_custom_du_contrat(self):
+        for m in self.bundle["manifest"]["workspaces"]:
+            p = next(x for x in self.spec["portails"] if x["key"] == m["portail"])
+            expected = sorted({
+                dt for c in p["cartes"] for dt in c["doctypes"] if self.flags.get(dt)
+            })
+            self.assertEqual(m["doctypes_custom"], expected)
+        self.assertEqual(
+            self.bundle["manifest"]["doctypes_custom_a_creer"],
+            sorted({"CONFOTUR Application", "Faisabilité", "Publiciste Log"}),
+        )
+
+    # 11 -------------------------------------------------------------------
+    def test_marque_claude_md(self):
+        brand = self.bundle["manifest"]["brand"]
+        self.assertEqual(brand["accent"]["valeur"], "#f0b429")
+        self.assertEqual(brand["fond"]["valeur"], "#0a0a12")
+        self.assertTrue(brand["accent"]["source"])
+
+    # 12 -------------------------------------------------------------------
+    def test_determinisme(self):
+        b1 = builder.build_bundle(_load(_CONTRACT), _load(_SPEC))
+        b2 = builder.build_bundle(_load(_CONTRACT), _load(_SPEC))
+        self.assertEqual(json.dumps(b1, sort_keys=True), json.dumps(b2, sort_keys=True))
+
+    # 13 · NEGATIFS ---------------------------------------------------------
+    def _validate_with_spec(self, mutated_spec):
+        """Ecrit une spec mutee dans un tmp, y pointe le CLI, revalide."""
+        with tempfile.TemporaryDirectory() as td:
+            path = os.path.join(td, "spec.json")
+            with open(path, "w", encoding="utf-8") as fh:
+                json.dump(mutated_spec, fh, ensure_ascii=False)
+            orig = self.cli._SPEC_PATH
+            self.cli._SPEC_PATH = path
+            try:
+                bundle = self.cli._build_bundle()
+                return self.cli._validate_bundle(bundle)
+            finally:
+                self.cli._SPEC_PATH = orig
+
+    def test_negatif_doctype_invente(self):
+        bad = copy.deepcopy(self.spec)
+        bad["portails"][0]["cartes"][0]["doctypes"].append("DocType Bidon Invente")
+        errs = self._validate_with_spec(bad)
+        self.assertTrue(any("non autorise" in e for e in errs), errs)
+
+    def test_negatif_couverture_incomplete(self):
+        bad = copy.deepcopy(self.spec)
+        # retire un DocType d'une carte -> couverture non exhaustive.
+        bad["portails"][0]["cartes"][0]["doctypes"].pop()
+        errs = self._validate_with_spec(bad)
+        self.assertTrue(any("couverture" in e for e in errs), errs)
+
+    def test_negatif_mauvais_ensemble_portails(self):
+        bad = copy.deepcopy(self.spec)
+        bad["portails"] = bad["portails"][:4]  # 4 portails != 5 metier
+        errs = self._validate_with_spec(bad)
+        self.assertTrue(any("portails_business" in e or "portails metier" in e for e in errs), errs)
+
+    def test_negatif_raccourci_hors_permissions(self):
+        bad = copy.deepcopy(self.spec)
+        bad["portails"][1]["raccourcis"].append("Sales Invoice")  # non autorise en construction
+        errs = self._validate_with_spec(bad)
+        self.assertTrue(any("raccourci vise DocType non autorise" in e for e in errs), errs)
+
+    # Garde-fous frappe.py --------------------------------------------------
+    def test_content_deterministe_frappe(self):
+        c1 = frappe.build_content("x", "X", ["A"], [{"titre": "T", "doctypes": ["A"]}])
+        c2 = frappe.build_content("x", "X", ["A"], [{"titre": "T", "doctypes": ["A"]}])
+        self.assertEqual(c1, c2)
+        self.assertTrue(json.loads(c1))  # JSON valide
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)