Files
Claude Code DTP Worker 7117394651 [DTP-Worker] Sprint 4 · Générateur configuration e-CF DGII (Compupar) (ERPNext Backend · roadmap L51)
Facturation électronique dominicaine cross-cohérente workflow↔DocType↔RBAC :
émission sur état soumis, base Currency réelle, rôle compta-fiscaliste-ecf.
Anti-invention (#6) : RNC/ITBIS/TipoCambio/endpoints Compupar null (a_confirmer,
jamais sans source) ; seules les données de référence DGII encodées avec source.
Composeur e-NCF traçable (E+tipo(2)+seq(10)). 39 tests · 12 invariants · gate CI
(job fiscal-ecf-tests) · 241 tests de régression verts.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-30 07:08:55 +00:00

118 lines
4.9 KiB
Python

"""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}