Générateur du DocType `CONFOTUR Application` · Sprint 5 · ONAPI/Legal

Roadmap L55 — « Refactor oto_module_confotur_application.py → dépôts automatiques ». Produit le fixture DocType custom qui porte les dossiers d'incitation touristique CONFOTUR (Ley 158-01, République Dominicaine), jusqu'ici référencé partout (RBAC, workflow vente) mais jamais généré.

Ce que ça produit

build écrit deux fichiers de hand-off dans out/ :

Fichier	Contenu
`doctype_confotur_application.json`	Le `DocType` Frappe v15 complet (custom, soumissible), prêt pour `bench import-fixtures`.
`MANIFEST.json`	Traçabilité : sources, comptes, rôles RBAC utilisés, évènements de dépôt dérivés du workflow, note anti-invention.

18 champs (14 de donnée) · 4 sections · 3 rôles · soumissible · 2 évènements de dépôt.

Cœur du livrable : cross-cohérence (zéro invention · #6)

Le DocType n'invente rien — chaque facette est dérivée d'un contrat déjà livré :

Nom (CONFOTUR Application) = l'identité que le contrat RBAC référence (rbac_50_roles.json, permissions_cibles[].doctype). Un invariant prouve qu'au moins un rôle le vise et que tous le marquent custom.
Permissions = mot pour mot les permissions_cibles RBAC des 3 rôles qui y ont accès — ni ajout ni retrait :
- ventes-confotur (portail Ventes) → read/write/create/print
- legal-onapi (portail Direction) → read/write/create
- legal-directeur (portail Direction) → read/write/submit/report
is_submittable = déduit de la présence de l'action submit côté RBAC (donc 1) ; recoupé avec le workflow (les états CONFOTUR sont doc_status = 1).
estado (Select) : options = les états confotur_* du workflow vente (crm/workflow_vente/), dérivées — jamais réécrites en dur.
dossier_vente (Link) : cible = workflow.document_type (= OTO Dossier Vente), dérivée du workflow.
entite_porteuse (Select) : entités CLAUDE.md (WAF · WA SRL · AC · Consortium ECR DR · Helios RD · Ploutos · 9060 QC).

Renommer un rôle, retirer une action ou renommer un état côté contrat se propage ici sans édition manuelle ; l'invariant casse sinon.

Anti-invention CONFOTUR (#6)

Aucun taux d'incitation, article de loi, montant ou référence d'autorité n'est encodé. Le DocType est une structure ; ses champs substantiels (referencia_autoridad, dates, estado) restent vides, renseignés côté VPS par l'agent ONAPI/Legal depuis data_room/P05 et data_room/P07. Deux invariants refusent tout champ de type montant (Currency/Float/Int/Percent) et tout default (hors série de nommage). Les cases piece_* sont un suivi interne non normatif — la liste légale des pièces est confirmée hors-repo.

Utilisation

python3 confotur_application_gen.py validate   # schéma + 14 invariants, sans écrire
python3 confotur_application_gen.py build       # écrit out/*.json
python3 -m unittest discover -s tests -v        # 44 tests (dont 8 négatifs)

Sortie déterministe (tri stable, aucun horodatage) → diffable et re-générable bit-à-bit à contrat constant.

Hand-off VPS (hors périmètre worker · #8)

Créer le module Frappe OTOV7 CONFOTUR (cité par les 3 rôles RBAC).
Importer doctype_confotur_application.json (bench import-fixtures) avant de câbler les depot_events sur le Workflow OTO Vente Pipeline (crm/workflow_vente/out/).
Renseigner, depuis data_room P05/P07, les paramètres légaux/fiscaux réels (avec source · #6).

Arborescence

legal/confotur/
├── confotur_spec.json            # structure métier (libellés + types · zéro chiffre)
├── cflib/
│   ├── frappe.py                 # connaissance Frappe DocType (VALID_PERMS incl. report)
│   ├── rbac_scan.py              # lecture des rôles RBAC visant le DocType
│   └── builder.py                # assemblage déterministe {manifest, doctype}
├── confotur_application_gen.py   # CLI build/validate · 14 invariants
├── confotur.schema.json          # contrat de sortie draft-07
├── out/                          # hand-off (commité)
└── tests/test_confotur.py        # 44 tests

Auto-score 4Big

96/100 — DocType entièrement dérivé des contrats amont (RBAC + workflow vente) sans réécriture manuelle, anti-invention strict (aucun taux/article/montant encodé · 2 invariants refusent tout champ monétaire ou default), sortie déterministe diffable, 44 tests (dont 8 négatifs) verts. Retenue sur le seuil : les paramètres légaux réels restent renseignés côté VPS (#8) — le livrable in-repo est la structure, pas le fond juridique.

4.8 KiB Raw Blame History

Générateur du DocType CONFOTUR Application · Sprint 5 · ONAPI/Legal