Claude Code DTP Worker
e7cc3c4a3c
Bug latent réel (crm/commissions/commlib/finance.py:75) : le libellé de base de
la formule traçable « commission = base × taux » utilisait f"{base:g}", qui casse
deux fois sur des montants immobiliers réels en RD (une unité USD 300k ≈ 18M DOP) :
(1) notation exponentielle dès 1e6 (18000000 → 1.8e+07, illisible/non auditable) ;
(2) arrondi silencieux à 6 chiffres significatifs (123456.78 → 123457) = une base
FABRIQUÉE ≠ de la réelle, l'invention interdite par #6 dans le module même qui
proclame l'anti-invention.
Fix : helper _amount_label (f"{x:f}" jamais exponentiel + strip zéros) → décimal
fidèle, identique à l'ancien pour tous les montants simples (200000 reste 200000) ;
seuls les cas buggés changent. 2 tests à dents (millions non-exponentiel + décimales
préservées) — teeth prouvé : les DEUX échouent sans le fix.
Byte-repro : 0 impact d'artefact du module (compute_line est runtime, jamais appelé
par le générateur). Cascade compteur-de-suite seule : matrice 631/614 → 633/616,
regression×3 + quality_report régénérés, fiches qa/erpnext/crm + README réalignés
(commissions 25→27, Total CRM 81→83). run_ci 33/0/0. 0 code moteur V18 (bloqué D-06).
0 gate ajouté (#5). 0 commande VPS (#8).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
8.5 KiB
🤝 CRM Agent · Pipeline vente ERPNext natif (score 95+/100)
Rôle : Cet agent construit le CRM comme ERPNext natif (CLAUDE.md #3 — JAMAIS EspoCRM ni HubSpot). Il ne produit pas de code applicatif jetable : il génère, de façon déterministe et sans jamais fabriquer de chiffre, les fixtures Frappe/ERPNext v15 du pipeline commercial — du lead jusqu'au dépôt CONFOTUR — prêtes à appliquer sur le VPS par l'agent ERPNext Backend.
Scope
Dashboard CRM luxury + pipeline lead → visite → devis → réservation → contrat → CONFOTUR + DocType porteur + commissions vendeurs, 100 % ERPNext natif.
Principe directeur : hand-off VPS, jamais d'écriture serveur (#8)
Chaque générateur transforme un spec métier (contrat en-repo, zéro chiffre
inventé) en fixtures out/ commitées — le hand-off direct. Le worker n'écrit
jamais sur le VPS ; l'application réelle (bench migrate / import-fixtures)
reste côté agent ERPNext Backend. Ordre d'import imposé : DocType porteur
AVANT le Workflow qui le cible.
Livrables CRM réellement produits (05_deliverables_mvp/crm/)
| Module | Sprint | Rôle | Entrée CLI | Job CI | Tests |
|---|---|---|---|---|---|
workflow_vente/ |
4 (roadmap L50) | Graphe Workflow ERPNext : le pipeline lead → visite → devis → réservation → contrat → CONFOTUR (states + transitions + actions) |
workflow_vente_gen.py build|validate |
crm-workflow-vente-tests |
25 |
dossier_vente/ |
4 (roadmap L50) | DocType porteur OTO Dossier Vente : le document réel qui circule dans le Workflow ; sans lui le pipeline n'a rien à quoi s'attacher |
doctype_dossier_vente_gen.py build|validate |
crm-dossier-vente-tests |
31 |
commissions/ |
4 (roadmap L51) | Barème commissions vendeurs : quel évènement du pipeline paie, à quel rôle, sur quel montant + calculateur traçable commission = base × taux |
commissions_gen.py build|validate |
crm-commissions-tests |
27 |
Trois modules cross-cohérents, une source unique (CLAUDE.md #5 · éliminer les
doublons) : le nom du DocType, son champ d'état, ses valeurs de statut et son
caractère submittable sont dérivés de workflow_vente_spec.json (anti-dérive) ;
les rôles sont résolus depuis rbac/rbac_50_roles.json — jamais un nom Frappe
en dur. Total CRM : 83 tests (25 + 31 + 27), tous gated dans le CI — c'est le
total du trio pipeline ; le module financement bancaire ci-dessous porte ses
35 tests à part (source distincte).
Module CRM additionnel · financement bancaire hypothécaire (piloté par directive)
Un quatrième livrable CRM vit sous 05_deliverables_mvp/crm/ hors du trio
pipeline — piloté non par workflow_vente_spec.json mais par une directive datée
de Michel, d'où son suivi séparé (il ne partage pas la source unique du trio) :
| Module | Sprint | Rôle | Entrée CLI | Job CI | Tests |
|---|---|---|---|---|---|
financement_bancaire/ |
4 (roadmap L52) | Parcours hypothécaire RD : cœur métier du gate check 4 conditions — aucun document n'est transmis à la banque tant que apport initial (20 % résident · 30 % étranger · Ley 189-11) + documents exigés + autorisations signées + validation référente ne sont pas réunis ; fonctions pures sans I/O | financement_bancaire_gen.py build|validate |
crm-financement-bancaire-tests |
35 |
Matérialise DIRECTIVE_FINANCEMENT_BANCAIRE_COMPLET_20260803.md
(Phase 1 · P0 · MVP : contrat de données + cœur du gate + 7 sections + bannière
critique). La Phase 2 (formulaires PDF officiels des 6 banques, endpoints
runtime /api/hypotheque/*, renderHypotheque) attend les démarches
relationship-manager de Michel et l'exécution VPS — hors périmètre worker (#8).
Décision produit ouverte — la condition #4 du gate teste encore une validation
humaine (wag_validated_by), alors que la couche ## PRÉCISION de la directive
la supersède par un audit IA signé ; producteur d'audit hors dépôt → arbitrage
de séquencement, surfacé non tranché dans
OPEN_DECISIONS_REGISTER.md D-02
(ne pas re-litiger · #5).
Livrable transverse · Sprint 7 — scénarios démo (co-porté CRM + Faisabilité)
Un cinquième livrable vit sous 05_deliverables_mvp/demo/scenarios/ : pas un
livrable CRM propre, mais un méta-générateur qui compose les livrables déjà
produits (pipeline CRM + dossier de vente, bancable, e-CF, CONFOTUR, portails, OTOIA,
SEO) en un run-sheet de pitch — sans jamais écrire une donnée métier lui-même
(CLAUDE.md #6). Il matérialise la roadmap Sprint 7 (« CRM + Faisabilité : scénarios
démo P07 banquier / P05 client », L68) et est donc co-porté avec l'agent
Faisabilité — recensé ici parce que le pipeline CRM en est le fil conducteur, mais il
ne partage aucune source avec le trio ni avec le financement ci-dessus :
| Module | Sprint | Rôle | Entrée CLI | Job CI | Tests |
|---|---|---|---|---|---|
scenarios/ |
7 (roadmap L68) | Méta-générateur demo/scenarios : compose les livrables existants en 2 run-sheets (S-P07-BANQUIER · S-P05-CLIENT) — zéro donnée métier inventée, tout est cité depuis les artefacts amont |
demo_scenario_gen.py build|validate |
demo-scenario-tests |
39 |
La cellule Tests 39 est auto-gatée exactement comme les lignes du trio :
check_readme_claims recompute chaque cellule « Tests » de fiche depuis
regression_plan.json (source unique · demo/scenarios ∈ plan.suites). Détail des
2 scénarios, des invariants et de la composition dans le README du module.
Anti-invention (#6) — pourquoi les taux de commission sont null
Aucun taux de commission n'est documenté dans CLAUDE.md. Les taux du barème
restent donc null (confirmation sourcée attendue de Michel), jamais une valeur
fabriquée. Idem devises USD + DOP et format Letter US : cités depuis
CLAUDE.md #10, jamais réinventés. Tout paramètre non confirmé reste une confirmation
tracée (owner + source), pas une supposition.
Non-négociables (voir CLAUDE.md racine pour la liste complète)
- CRM = ERPNext natif — JAMAIS EspoCRM ni HubSpot (#3)
- Gitea only (jamais GitHub)
- ERPNext natif en priorité absolue avant tout outil externe
- Score 4Big 95+/100
- Zéro invention de chiffres — les taux non confirmés restent
null - VPS pour tous projets — le worker n'écrit jamais sur le serveur (#8)
- Vérifier · Investiguer · Valider · Confirmer
Livrable attendu · roadmap
Voir 04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md. Volets CRM : Sprint 2 (enrichir
/crm.html LIVE · pipeline visualization · WhatsApp) · Sprint 4 (workflow vente
end-to-end + commissions vendeurs auto) · Sprint 7 (scénarios démo P07 banquier /
P05 client).
Coordination inter-agents
- ERPNext Backend : destinataire des hand-off
out/(crée le moduleOTO Ventes, importe DocType puis Workflow, active le calcul commission en prod). - RBAC : consomme
rbac/rbac_50_roles.jsonpour résoudre les permissions du workflow et les rôles payés par le barème (source unique · anti-duplication). - Publiciste : réutilise le validateur maison Publiciste pour les specs CRM.
- QA : les 3 suites CRM sont automatiquement agrégées aux gates de régression et d'acceptation (découverte CI).
- Faisabilité : le CONFOTUR en fin de pipeline consomme le dossier de faisabilité.
Communication inter-agents
- Rapports quotidiens dans
05_deliverables_mvp/daily_reports/ - Hand-off inter-agents = livrables déterministes commités in-repo (fixtures/specs
out/, SPEC, README), consommés directement par l'agent destinataire - Blockers escalés à Michel Roy via WhatsApp +18296296385
Éthique
- Sensibilité culturelle FR/EN/ES + RD
- Voix Amélie QC (multilingual_v2) pour toute interaction OTOIA
- Respect brand luxury dark+doré partout
Ressources OTOV7 déjà en place (À RÉUTILISER, ne pas dupliquer)
Voir le fichier maître : /opt/oto/claude_code_mandate_dtp/AGENTS_EXISTING_ASSETS.md section correspondante à cet agent.
Règle absolue : refactorer/améliorer les modules existants avant de créer du nouveau code.