feat: 4 UX/backend fixes — anti-ghost image, time-travel replay, UX message order, contextual AI remediation

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

@@ -331,7 +331,15 @@ class AIService {
             - 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.
-            - **CRITÈRE DE VALIDATION (isQualified)** : Dès que l'utilisateur fournit une réponse sérieuse liée à son projet (même courte), mets 'isQualified: true'. Ne sois pas trop sévère. S'il y a un doute, valide et enrichis dans ton feedback.
+            ⚠️ COHÉRENCE THÉMATIQUE OBLIGATOIRE (ANTI-HORS-SUJET) :
+            Avant de valider, vérifie que la réponse de l'étudiant est liée à la question du Jour ${dayNumber} : "${expectedExercise?.substring(0, 200)}".
+            Si la réponse est TOTALEMENT hors-sujet (ex: salutation, spam, ou thème sans rapport), alors:
+            - Mets OBLIGATOIREMENT isQualified: false.
+            - Explique-lui POLIMENT et PRÉCISÉMENT (en 2-3 phrases max dans la section validation) ce qu'il doit corriger pour réussir cet exercice.
+            - Exemple: Si l'exercice demande "Décris ton client principal" et l'étudiant répond "Bonjour bonne journée", c'est hors-sujet → isQualified: false et tu dis "Pour valider cette étape, je dois savoir QUI achète ton produit : son profil, son âge, ses habitudes. Réponds à l'exercice pour continuer."
+            - Ne sois sévère QUE sur le hors-sujet flagrant. Une réponse courte mais pertinente reste validée (isQualified: true).
+            
+            **CRITÈRE DE VALIDATION (isQualified)** : Dès que l'utilisateur fournit une réponse sérieuse liée à son projet (même courte), mets 'isQualified: true'. Ne sois pas trop sévère. S'il y a un doute, valide et enrichis dans ton feedback.
             
             INVITATION DEEP-DIVE OBLIGATOIRE :
             ${hasQuestion ? `L'utilisateur ayant posé une question, tu DOIS systématiquement proposer l'option d'approfondissement pour explorer des alternatives stratégiques.` : ''}

apps/api/src/services/whatsapp.ts

@@ -197,19 +197,23 @@ export class WhatsAppService {
             const action = dayActionMatch[2];
 
             if (action === 'REPLAY') {
+                const replayDay = parseFloat(dayActionMatch[1]);  // Use the day from the button (DAY11_REPLAY → 11)
                 const enrollment = await prisma.enrollment.findFirst({
                     where: { userId: user.id, status: 'ACTIVE' }
                 });
                 if (enrollment) {
+                    // ✅ UX Fix 3: Confirmation FIRST, content delayed — so message order is guaranteed
+                    await scheduleMessage(user.id, user.language === 'WOLOF'
+                        ? `🔁 Dinanu la yëgël lexon Bés ${Math.floor(replayDay)} ci kanam...`
+                        : `🔁 Je te renvoie la Leçon ${Math.floor(replayDay)} dans quelques secondes...`
+                    );
+                    // skipProgressUpdate: true → sendLessonDay won't touch currentDay or exerciseStatus
                     await whatsappQueue.add('send-content', {
                         userId: user.id,
                         trackId: enrollment.trackId,
-                        dayNumber: enrollment.currentDay
-                    });
-                    await scheduleMessage(user.id, user.language === 'WOLOF'
-                        ? "🔁 Dinanu la yëgël waxtu bi ci kanam..."
-                        : "🔁 Je te renvoie la leçon dans quelques secondes..."
-                    );
+                        dayNumber: replayDay,
+                        skipProgressUpdate: true
+                    }, { delay: 2000 });
                 }
                 return;
             } else if (action === 'EXERCISE') {

apps/whatsapp-worker/src/index.ts

@@ -789,7 +789,9 @@ const worker = new Worker('whatsapp-queue', async (job: Job) => {
             });
 
             if (trackDay) {
-                await sendLessonDay(userId, trackId, dayNumber);
+                await sendLessonDay(userId, trackId, dayNumber, {
+                    skipProgressUpdate: job.data.skipProgressUpdate === true
+                });
 
                 // Update basic enrollment tracking for compatibility
                 await prisma.enrollment.updateMany({

apps/whatsapp-worker/src/pedagogy.ts

@@ -22,7 +22,12 @@ function generateProgressBar(current: number, total: number): string {
     return `[${bar}] ${percentage}%`;
 }
 
-export async function sendLessonDay(userId: string, trackId: string, dayNumber: number) {
+export async function sendLessonDay(
+    userId: string,
+    trackId: string,
+    dayNumber: number,
+    options?: { skipProgressUpdate?: boolean }
+) {
     console.log(`[PEDAGOGY] Preparing Lesson Day ${dayNumber} for User ${userId}`);
 
     const user = await prisma.user.findUnique({
@@ -344,28 +349,32 @@ export async function sendLessonDay(userId: string, trackId: string, dayNumber:
         );
     }
 
-    // 🌟 4. Update User Progress to PENDING 🌟
-    await prisma.userProgress.upsert({
-        where: { userId_trackId: { userId, trackId } },
-        update: {
-            exerciseStatus: 'PENDING',
-            lastInteraction: new Date()
-        },
-        create: {
-            userId,
-            trackId,
-            exerciseStatus: 'PENDING'
-        }
-    });
+    // 🌟 4 & 5. Update User Progress and Enrollment.currentDay 🌟
+    // ⚠️ Skipped when skipProgressUpdate=true (REPLAY of a historical lesson)
+    if (!options?.skipProgressUpdate) {
+        await prisma.userProgress.upsert({
+            where: { userId_trackId: { userId, trackId } },
+            update: {
+                exerciseStatus: 'PENDING',
+                lastInteraction: new Date()
+            },
+            create: {
+                userId,
+                trackId,
+                exerciseStatus: 'PENDING'
+            }
+        });
 
-    // 🌟 5. Correctly update Enrollment.currentDay 🌟
-    await prisma.enrollment.updateMany({
-        where: { userId, trackId, status: 'ACTIVE' },
-        data: {
-            currentDay: dayNumber,
-            lastActivityAt: new Date()
-        }
-    });
+        await prisma.enrollment.updateMany({
+            where: { userId, trackId, status: 'ACTIVE' },
+            data: {
+                currentDay: dayNumber,
+                lastActivityAt: new Date()
+            }
+        });
 
-    console.log(`[PEDAGOGY] Lesson Day ${dayNumber} sent. UserProgress set to PENDING.`);
+        console.log(`[PEDAGOGY] Lesson Day ${dayNumber} sent. UserProgress set to PENDING.`);
+    } else {
+        console.log(`[PEDAGOGY] Lesson Day ${dayNumber} replayed (read-only). currentDay unchanged.`);
+    }
 }

apps/whatsapp-worker/src/services/whatsapp-logic.ts

@@ -277,8 +277,19 @@ export class WhatsAppLogic {
             console.log(`[FLOW-SYNC] User ${user.id} at Day ${activeEnrollment.currentDay}, status: ${userProgress?.exerciseStatus}`);
 
             const fiveMinutesAgo = new Date(Date.now() - 5 * 60 * 1000);
+            const tenMinutesAgo = new Date(Date.now() - 10 * 60 * 1000);
             const isRecentlyCompleted = userProgress?.exerciseStatus === 'COMPLETED' && userProgress.updatedAt > fiveMinutesAgo;
-            const shouldForceRevalidation = !!imageUrl || isRecentlyCompleted;
+
+            // 🚨 Anti-Fantôme: Only revalidate with an image if the exercise is actively awaiting input
+            // OR the image arrives shortly after completion (immediate retry). Orphan images (delayed
+            // retries from Meta) arriving > 10 min after COMPLETED must NOT reset progression.
+            const isImageForActiveExercise = !!imageUrl && (
+                userProgress?.exerciseStatus === 'PENDING' ||
+                userProgress?.exerciseStatus === 'PENDING_DEEPDIVE' ||
+                userProgress?.exerciseStatus === 'PENDING_REMEDIATION' ||
+                (userProgress?.exerciseStatus === 'COMPLETED' && userProgress.updatedAt > tenMinutesAgo)
+            );
+            const shouldForceRevalidation = isImageForActiveExercise || isRecentlyCompleted;
 
             if (shouldForceRevalidation && userProgress?.exerciseStatus === 'COMPLETED') {
                 console.log(`[FLOW-SYNC] 🔄 Re-validation triggered for User ${user.id} (Reason: ${imageUrl ? 'New Image' : 'Recent Correction'})`);