| # 📊 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é). | |