Claude Code DTP Worker
ccda618ea4
- 03_agents/crm/AGENT.md : stub 29 lignes → doc réelle ~90 lignes - Table 3 livrables CRM (workflow_vente/dossier_vente/commissions) : sprint · CLI build|validate · job CI · nb tests (25/31/25 = 81, tous sourcés) - #3 mis en avant (CRM = ERPNext natif · JAMAIS EspoCRM/HubSpot) - Anti-invention #6 : taux commission null ; USD+DOP/Letter US cités #10 - Vérifs : guard vert · check_docs vert (liens OK) · 0 réf roadmap morte Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
80 lines
4.8 KiB
Markdown
80 lines
4.8 KiB
Markdown
# 🤝 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 L51) | 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 L51) | **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` | 25 |
|
||
|
||
**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 : **81 tests** (25 + 31 + 25), tous gated dans le CI.
|
||
|
||
## 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 module `OTO
|
||
Ventes`, importe DocType puis Workflow, active le calcul commission en prod).
|
||
- **RBAC** : consomme `rbac/rbac_50_roles.json` pour 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/`
|
||
- Handoffs formalisés dans `05_deliverables_mvp/handoffs/`
|
||
- 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.
|