docs: Comprehensive Historical Knowledge Enrichment (Final Audit)

.claude/primer.md

@@ -10,13 +10,21 @@
 - **Commission Prestataire** : 2% sur le montant encaissé.
 - **Validation** : Le coaching AI (XAMLÉ) assure la qualité des prestataires avant mise en relation.
 
-## 🏗️ Flux de Données (Data Flow)
-1. **Meta Webhook** -> **API Fastify** -> Réponse 200 immédiate.
-2. **Queue BullMQ** -> **Worker** -> **whatsapp-logic.ts**.
-3. **IA (Gemini/OpenAI)** -> **Prisma DB** -> **WhatsApp Cloud API**.
+## 🏗️ Flux de Données & Infrastructure
+- **Monorepo** : Turbo-repo géré par `pnpm`.
+  - `apps/api` : Gateway Fastify (Webhook).
+  - `apps/whatsapp-worker` : Logique métier, Multimodal, Scoring.
+  - `packages/database` : Prisma schema + Modular seed system.
+- **Flux** : Meta Webhook -> API Fastify -> Réponse 200 immédiate.
+- **Queue** : BullMQ (Redis) -> Worker -> `whatsapp-logic.ts`.
 
-## 🛠️ Stack Technologique
+## 🛠️ Stack Technologique & Moteurs
 - **Back** : Node.js (TypeScript), Fastify, BullMQ, Redis.
-- **Persistance** : Prisma ORM (Azure Neon PostgreSQL).
-- **IA** : Gemini 2.0 Flash (Coaching), Gemini 1.5 Pro (Docs), OpenAI Whisper (STT).
-- **Storage** : Cloudflare R2 (Audio/Images persistants).
+- **IA** : Gemini 2.0 Flash (Coaching), Gemini 1.5 Pro (Documents), OpenAI Whisper (STT).
+- **Moteur de Scoring** : Système de scoring comportemental sur 4 dimensions :
+  - `discipline_financiere`, `organisation`, `relation_client`, `risque_management`.
+- **Niveaux d'Évolution** :
+  - < 40 : *Informel instable*
+  - 40-60 : *Structuration début*
+  - 60-80 : *Business organisé*
+  - > 80 : *Entrepreneur avancé*

tasks/lessons.md

@@ -5,8 +5,9 @@ Ce fichier archive les échecs et solutions liées à la **stabilité technique*
 - **[ARCHI] Détachement Gateway** : Ne JAMAIS laisser une gateway (Hugging Face / Meta) attendre > 20s. Répondre `200 OK` immédiatement et déléguer au worker.
 - **[DB] Séquençage des Opérations** : Ne JAMAIS envoyer de message WhatsApp avant d'avoir persisté la progression dans Prisma. La DB est la seule source de vérité.
 - **[CACHING] Verrous d'Idempotence** : Utiliser des locks Redis avec un TTL minimal de 300s (5 min) pour protéger les appels LLM longs et éviter les retries en boucle.
-- **[MEDIA] Vision Base64** : Gemini échoue par URL ; toujours convertir les photos d'utilisateurs en Base64 avant l'envoi au LLM.
-- **[NON-BLOQUANT] Processus FFMPEG** : Les conversions audio doivent tourner dans des sous-processus pour ne pas saturer l'event loop du worker.
+- **[MEDIA] Vision Base64** : Gemini échoue par URL ; toujours convertir les photos d'utilisateurs en Base64.
+- **[STT] Whisper Auto-Validation** : Si l'indice de confiance est <= 80%, intercepter le flux et basculer en `PENDING_REVIEW` pour validation humaine sans crash.
+- **[NON-BLOQUANT] Processus FFMPEG** : Les conversions audio doivent tourner dans des sous-processus.
 
 ## 🛡️ Règle d'Or de l'Intégrité
 **Les correctifs techniques ne doivent JAMAIS impacter la logique de personnalisation du prompt `generatePersonalizedLesson` ou des feedbacks.** Toute simplification technique qui réduit la spécificité de l'IA est un échec.

tasks/technical_backlog.md

@@ -13,10 +13,11 @@ Ce fichier liste chronologiquement les correctifs techniques apportés au moteur
 - **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`.
 
-### [24/03/2026] | 📸 Vision Multimodale (Base64 Stable)
-- **Problème** : Gemini échouait à lire les médias via URL externes (permissions/timeouts).
-- **Fix** : Téléchargement local, conversion en **Base64** et injection directe dans le payload `inlineData` de Gemini.
+### [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)
-- **Problème** : Les commandes critiques (INSCRIPTION, SUITE) échouaient à cause de fautes de frappe ("insription").
-- **Fix** : Intégration d'une logique de normalisation et de distance de Levenshtein pour les intents de navigation.
+- **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é).