tasks/technical_backlog.md

📊 Backlog Technique (Historique de la Plomberie)

Ce fichier liste chronologiquement les correctifs techniques apportés au moteur de messagerie et de progression, afin de séparer la maintenance de l'infrastructure de l'intelligence métier.

🛠️ Historique des Correctifs

[24/03/2026] | 🛡️ Architecture Async-First & Idempotence

• Problème : Timeouts de la Gateway Hugging Face (> 30s) causant des retries infinis et des doublons de messages.
• Fix : Détachement immédiat du webhook (200 OK) et délégation du traitement lourd au whatsapp-worker via BullMQ.
• Protection : Verrous Redis (lock:inbound) de 300s pour garantir l'unicité du traitement.

[24/03/2026] | 🧬 Inversion de Logique (Atomicité DB)

• Problème : Race condition. L'utilisateur recevait le WhatsApp mais son progrès restait PENDING en raison d'un crash post-envoi.
• Fix : Séquençage strict : Prisma.update -> Prisma.create(Response) -> sendWhatsApp.

[23/03/2026] | 🎨 Pitch Card Generation (Visual WOW)

• Fix : Création automatique d'une carte de visite visuelle sur le Jour 1 dès que l'activité est extraite. Utilisation de Canvas/Sharp pour le rendu.

[23/03/2026] | 🔍 Fuzzy Matching (Correction des fautes)

• Fix : Normalisation Levenshtein pour les intents critiques.

[22/03/2026] | ⚙️ Moteur de Scoring Comportemental

• Fix : Implémentation du système BehavioralScoring sur 4 axes (Finance, Organisation, Client, Risque) avec des labels d'évolution (Informel -> Avancé).