feat(ai): refactor coach feedback to 3-pillar format with mandatory browsing (Sprint 39)

apps/api/src/routes/ai.ts

@@ -223,13 +223,13 @@ export async function aiRoutes(fastify: FastifyInstance) {
             );
 
             // 🌟 Standard Feedback UX: 3 lines 🌟
-            // 1. Encouragement/Validation (PRAISE)
-            // 2. Diagnostic (REPHRASE)
-            // 3. Action / Help (ACTION)
+            // 1. Encouragement/Validation (VALIDATION)
+            // 2. Diagnostic (ENRICHED VERSION)
+            // 3. Action / Help (ACTIONABLE ADVICE)
             const formattedFeedback = `✨ *Coach XAMLÉ* :\n\n` +
-                `🌟 ${feedback.praise}\n` +
-                `📝 ${feedback.rephrase}\n` +
-                `💡 ${feedback.action}`;
+                `🌟 ${feedback.validation}\n\n` +
+                `🚀 ${feedback.enrichedVersion}\n\n` +
+                `💡 ${feedback.actionableAdvice}`;
 
             return {
                 success: true,

apps/api/src/services/ai/__fixtures__/mock-data.ts

@@ -86,9 +86,9 @@ export const MOCK_DECK_COUTURE = {
 
 export const MOCK_FEEDBACK = {
     isQualified: true,
-    praise: "Excellent travail ! Ta vision est claire et ambitieuse.",
-    rephrase: "Tu proposes donc une solution innovante pour le marché local.",
-    action: "Continue ainsi pour l'étape suivante !",
+    validation: "Excellent travail ! Ta vision est claire et ambitieuse (🌟 Validation).",
+    enrichedVersion: "Tu proposes donc une solution innovante pour le marché local qui répond aux 15% de déficit observé par l'ANSD (🚀 Enrichissement).",
+    actionableAdvice: "Continue ainsi pour l'étape suivante, et focalise-toi sur ta supply chain B2B (💡 Conseil).",
     confidence: 95,
     notes: "Réponse solide.",
     missingElements: []

apps/api/src/services/ai/index.ts

@@ -138,19 +138,18 @@ class AIService {
 
         let searchContext = '';
         let searchResults: any[] | undefined = undefined;
-        if (dayNumber === 2 || dayNumber === 5 || dayNumber === 10) {
-            console.log(`[AI_SERVICE] 🔍 Triggering Market Search for Day ${dayNumber}...`);
-            const query = `${activityLabel} ${region} Sénégal marché concurrence`;
-            try {
-                const results = await searchService.search(query);
-                if (results && results.length > 0) {
-                    searchResults = results;
-                    searchContext = `\n🌐 DONNÉES DE MARCHÉ RÉELLES (Google Search) :\n${results.map(r => `- ${r.title}: ${r.snippet}`).join('\n')}\n`;
-                    console.log(`[AI_SERVICE] ✅ Search enrichment added (${results.length} results).`);
-                }
-            } catch (err) {
-                console.error('[AI_SERVICE] Search enrichment failed:', err);
+        // 🚀 Brique 1: Activation du Browsing (Obligatoire)
+        console.log(`[AI_SERVICE] 🔍 Triggering Market Search for Day ${dayNumber} (Always ON)...`);
+        const query = `${activityLabel} ${region} Sénégal marché chiffres statistiques data`;
+        try {
+            const results = await searchService.search(query);
+            if (results && results.length > 0) {
+                searchResults = results;
+                searchContext = `\n🌐 DONNÉES DE MARCHÉ RÉELLES (Google Search) :\n${results.map(r => `- ${r.title}: ${r.snippet}`).join('\n')}\n`;
+                console.log(`[AI_SERVICE] ✅ Search enrichment added (${results.length} results).`);
             }
+        } catch (err) {
+            console.error('[AI_SERVICE] Search enrichment failed:', err);
         }
 
         const criteriaContext = exerciseCriteria
@@ -174,22 +173,22 @@ class AIService {
         RÉPONSE DE L'ÉTUDIANT :
         "${userInput}"
 
-        MISSIONS STRATÉGIQUES "PREMIUM V4" :
-        1. Évaluation : Est-ce valide selon les critères ?
-        2. Extraction Métriques : Concurrence (J10), Projections (J11), The Ask (J12).
-        3. Feedback "Mini-Cours" : Rédige une Reformulation stratégique, un Praise enthousiaste et une Action (prochaine étape).
+        MISSIONS STRATÉGIQUES "SENIOR BUSINESS COACH" (CORRECTION RADICALE) :
+        Tu es un consultant pragmatique, pas un professeur pointilleux. Rédige un feedback d'au minimum 15 lignes de haute densité.
         
-        RÈGLE DE DENSITÉ RÉDACTIONNELLE :
-        - Le feedback ne doit pas être un simple 'bien'. Chaque réponse doit expliquer le POURQUOI stratégique (impact sur le business).
+        LES 3 PILIERS OBLIGATOIRES DU FEEDBACK :
+        1. 🌟 Validation (Pilier 1) : Félicite et valide l'idée de l'utilisateur avec l'enthousiasme d'un investisseur.
+        2. 🚀 Version Enrichie (Pilier 2) : Réécris sa phrase de manière exécutive en y intégrant OBLIGATOIREMENT des données chiffrées réelles trouvées dans ta recherche (ex: taille du marché ANSD, nombre de boutiques) et des termes stratégiques (supply chain, B2B, rétention). 
+        3. 💡 Conseil Actionnable (Pilier 3) : Donne un conseil de terrain hyper concret basé là aussi sur la recherche web (ex: "Conseil : Le créneau 6h-8h est critique dans les boutiques de Dakar...").
+
+        ⚠️ INTERDICTION ABSOLUE (Anti-Remediation Loop) :
+        - Tu NE DOIS PLUS JAMAIS demander à l'utilisateur de s'expliquer davantage (ex: "Quel est l'âge exact ?", "Combien gagnes-tu ?").
+        - S'il manque un détail mais que l'idée est claire, c'est TOI qui apportes le savoir (donne les tranches d'âges classiques du secteur, donne les revenus moyens du pays).
+        - Tu es là pour ENRICHIR sa vision, pas pour lui faire passer un interrogatoire. Ne pose AUCUNE question bloquante à la fin.
         
-        PROTOCOLE DATA STEWARD (Rigueur) :
-        - Cascade de Recherche : Régional > National > UEMOA. Interdiction du Niveau 1 (Quartier).
-        - TRANSPARENCE : Cite toujours la source (ex: ANSD).
-        - HONNÊTETÉ : Si aucune donnée fiable n'est trouvée, propose l'estimation de l'utilisateur.
-        
-        TON INSTITUTIONNEL (Browsing) :
-        Utilise les données de marché pour impressionner l'élève : 
-        "Félicitations ! Ton approche est validée par les chiffres : selon [Source], le marché de [Secteur] est évalué à [Valeur]. J'ai intégré cette preuve de marché dans ta Slide 5."
+        PROTOCOLE DATA STEWARD (Intégrité Géographique) :
+        - Si l'utilisateur est à ${region}, donne lui les vrais chiffres de ${region}. S'ils n'existent pas, back-up sur les chiffres du Sénégal.
+        - TRANSPARENCE : Cite toujours la source formelle (ex: Agence Nationale de la Statistique et de la Démographie, Banque Mondiale, Direction du commerce, etc.).
         
         DÉTANCHÉITÉ LINGUISTIQUE : 100% ${userLanguage === 'WOLOF' ? 'WOLOF (ñ, ë, é)' : 'Français institutionnel'}. Zéro mélange.
         `;

apps/api/src/services/ai/types.ts

@@ -50,9 +50,9 @@ export type PitchDeckData = z.infer<typeof PitchDeckSchema>;
 
 // Schema for AI Feedback (Coach)
 export const FeedbackSchema = z.object({
-    rephrase: z.string().describe("Synthesized version of the student's answer"),
-    praise: z.string().describe("Positive reinforcement"),
-    action: z.string().describe("Next pedagogical step or correction"),
+    validation: z.string().describe("Félicitations et validation claire de la réponse de l'utilisateur (Pilier 1)"),
+    enrichedVersion: z.string().describe("Réécriture de la phrase y intégrant des données chiffrées réelles et stratégiques issues de la recherche (Pilier 2)"),
+    actionableAdvice: z.string().describe("Conseil terrain concret, actionnable et documenté pour cette étape (Pilier 3)"),
     isQualified: z.boolean().describe("Whether the answer meets the lesson's criteria"),
     missingElements: z.array(z.string()).describe("List of IDs from criteria that were not met"),
     confidence: z.number().min(0).max(100).describe("AI confidence in the evaluation"),

apps/whatsapp-worker/src/index.ts

@@ -89,8 +89,8 @@ const worker = new Worker('whatsapp-queue', async (job: Job) => {
 
                 if (feedbackRes.ok) {
                     feedbackData = await feedbackRes.json();
-                    if (feedbackData.rephrase && feedbackData.praise && feedbackData.action) {
-                        feedbackMsg = `${feedbackData.praise}\n\n${feedbackData.rephrase}\n\n💡 *Action :* ${feedbackData.action}`;
+                    if (feedbackData.validation && feedbackData.enrichedVersion && feedbackData.actionableAdvice) {
+                        feedbackMsg = `🌟 ${feedbackData.validation}\n\n🚀 ${feedbackData.enrichedVersion}\n\n💡 Conseil de Terrain :\n${feedbackData.actionableAdvice}`;
                     } else if (feedbackData.text) {
                         feedbackMsg = feedbackData.text;
                     } else {