fix: Resolve Production Crash & Add UX Guidance for Completed Exercises

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

@@ -307,7 +307,30 @@ export class WhatsAppLogic {
                         isDeepDive: isDeepDiveAction, iterationCount: currentIterationCount, imageUrl: imageUrl
                     }, { attempts: 3, backoff: { type: 'exponential', delay: 2000 } });
                     return;
+                } else {
+                    console.log(`[LOGIC] ⚠️ Fall-through: User ${user.id} in enrollment but no matching pendingProgress (Status likely not PENDING).`);
                 }
+            } else {
+                // Enrollment active but no trackDay found for currentDay?
+                console.warn(`[LOGIC] ⚠️ Active Enrollment for User ${user.id} but TrackDay ${activeEnrollment.currentDay} not found.`);
+            }
+        } else {
+             console.log(`[LOGIC] ℹ️ User ${user.id} has no active enrollment. Fall-through.`);
+        }
+
+        // 🌟 UX Guidance Fall-through 🌟
+        // If we reach here, it means we found a user with an active enrollment but no pending exercise (likely COMPLETED).
+        if (activeEnrollment) {
+            const userProgress = await prisma.userProgress.findUnique({
+                where: { userId_trackId: { userId: user.id, trackId: activeEnrollment.trackId } }
+            });
+
+            if (userProgress?.exerciseStatus === 'COMPLETED') {
+                console.log(`[LOGIC] 💡 User ${user.id} is COMPLETED. Sending navigation reminder.`);
+                const reminder = user.language === 'WOLOF'
+                    ? "Mat nga bés bi ba pare ! ✨\nBindal *2* wala *SUITE* ngir dem ci bés bi ci kanam.\n(Bindal *REPLAY* ngir dégtu mbind mi)."
+                    : "Tu as déjà validé cette étape ! ✨\nEnvoie *2* ou *SUITE* pour passer à la suite.\n(Envoie *REPLAY* pour réécouter la leçon).";
+                await scheduleMessage(user.id, reminder);
             }
         }
     }

packages/database/prisma/schema.prisma

@@ -8,70 +8,63 @@ datasource db {
 }
 
 model User {
-  id        String   @id @default(uuid())
-  phone     String   @unique
-  name      String?
-  role      Role     @default(STUDENT)
-  language  Language @default(FR)
-  city      String?
-  activity  String?  // Business activity/sector
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-  
-  currentStreak Int @default(0)
-  longestStreak Int @default(0)
-  lastActivityAt DateTime?
-  
-  enrollments Enrollment[]
-  responses   Response[]
-  messages    Message[]
-  payments    Payment[]
-  progress    UserProgress[]
+  id              String           @id @default(uuid())
+  phone           String           @unique
+  name            String?
+  role            Role             @default(STUDENT)
+  language        Language         @default(FR)
+  city            String?
+  activity        String?
+  createdAt       DateTime         @default(now())
+  updatedAt       DateTime         @updatedAt
+  currentStreak   Int              @default(0)
+  longestStreak   Int              @default(0)
+  lastActivityAt  DateTime?
   businessProfile BusinessProfile?
+  enrollments     Enrollment[]
+  messages        Message[]
+  payments        Payment[]
+  responses       Response[]
+  progress        UserProgress[]
 }
 
 model BusinessProfile {
-  id                String   @id @default(uuid())
-  userId            String   @unique
-  activityLabel     String?  // e.g. "Jus de Bissap"
-  activityPhrase    String?  // Optimized elevator pitch
-  activityType      String?  // e.g. "Production", "Service"
-  locationCity      String?
-  mainCustomer      String?
-  mainProblem       String?
-  offerSimple       String?
-  promise           String?
-  marketData        Json?    // Stored Google Search results for TAM/SAM/SOM & Competition
-  competitorList    Json?    // List of rivals found or declared
-  financialProjections Json? // 3-year growth data
-  teamMembers       Json?    // Array of { name, role, bio, photoUrl }
-  fundingAsk        String?  // Amount and purpose
-  lastUpdatedFromDay Int     @default(0)
-  createdAt         DateTime @default(now())
-  updatedAt         DateTime @updatedAt
-
-  user              User     @relation(fields: [userId], references: [id])
+  id                   String   @id @default(uuid())
+  userId               String   @unique
+  activityLabel        String?
+  activityPhrase       String?
+  activityType         String?
+  locationCity         String?
+  mainCustomer         String?
+  mainProblem          String?
+  offerSimple          String?
+  promise              String?
+  marketData           Json?
+  competitorList       Json?
+  financialProjections Json?
+  fundingAsk           String?
+  lastUpdatedFromDay   Int      @default(0)
+  createdAt            DateTime @default(now())
+  updatedAt            DateTime @updatedAt
+  teamMembers          Json?
+  user                 User     @relation(fields: [userId], references: [id])
 }
 
 model Track {
-  id              String   @id @default(uuid())
-  title           String
-  description     String?
-  duration        Int      // Duration in days
-  language        Language @default(FR)
-  
-  // Payment Integration Fields
-  isPremium       Boolean  @default(false)
-  priceAmount     Int?     // Price in smallest currency unit (e.g., cents/XOF)
-  stripePriceId   String?  // Stripe Price ID
-  
-  createdAt       DateTime @default(now())
-  updatedAt       DateTime @updatedAt
-
-  days            TrackDay[]
-  enrollments     Enrollment[]
-  payments        Payment[]
-  progress        UserProgress[]
+  id            String         @id @default(uuid())
+  title         String
+  description   String?
+  duration      Int
+  language      Language       @default(FR)
+  isPremium     Boolean        @default(false)
+  priceAmount   Int?
+  stripePriceId String?
+  createdAt     DateTime       @default(now())
+  updatedAt     DateTime       @updatedAt
+  enrollments   Enrollment[]
+  payments      Payment[]
+  days          TrackDay[]
+  progress      UserProgress[]
 }
 
 model TrackDay {
@@ -89,84 +82,103 @@ model TrackDay {
   validationKeyword String?
   buttonsJson       Json?
   exerciseCriteria  Json?
-  badges            Json?    // Array of strings: ["B_MODULE_1_OK"]
+  badges            Json?
   unlockCondition   String?
   createdAt         DateTime     @default(now())
   updatedAt         DateTime     @updatedAt
-
   track             Track        @relation(fields: [trackId], references: [id])
 }
 
 model UserProgress {
-  id              String         @id @default(uuid())
-  userId          String
-  trackId         String
-  score           Int            @default(0)
-  lastInteraction DateTime       @default(now())
-  exerciseStatus  ExerciseStatus @default(PENDING)
-  badges          Json?          // Array of strings: ["CLARTE", "CONFIANCE"]
-  behavioralScoring Json?         // { discipline_financiere: 0, organisation: 0, ... }
-  confidenceScore Float?          // STT Whisper avg_logprob mapped to 0-100%
+  id                 String         @id @default(uuid())
+  userId             String
+  trackId            String
+  score              Int            @default(0)
+  lastInteraction    DateTime       @default(now())
+  exerciseStatus     ExerciseStatus @default(PENDING)
+  badges             Json?
+  behavioralScoring  Json?
+  confidenceScore    Float?
   adminTranscription String?
   overrideAudioUrl   String?
   reviewedBy         String?
-  iterationCount     Int            @default(0) // Tracks Deep Dive loops
-  aiSource           String?        // Provider used (GEMINI, OPENAI)
-  
-  // Removed Enriched Data for Pitch Deck (Moved to BusinessProfile - Sprint 38)
-  createdAt       DateTime       @default(now())
-  updatedAt       DateTime       @updatedAt
-
-  user            User           @relation(fields: [userId], references: [id])
-  track           Track          @relation(fields: [trackId], references: [id])
+  createdAt          DateTime       @default(now())
+  updatedAt          DateTime       @updatedAt
+  iterationCount     Int            @default(0)
+  aiSource           String?
+  track              Track          @relation(fields: [trackId], references: [id])
+  user               User           @relation(fields: [userId], references: [id])
 
   @@unique([userId, trackId])
 }
 
 model Enrollment {
-  id          String           @id @default(uuid())
-  userId      String
-  trackId     String
-  status      EnrollmentStatus @default(ACTIVE)
-  currentDay  Float              @default(1)
-  startedAt   DateTime         @default(now())
-  completedAt DateTime?
-  lastActivityAt DateTime      @default(now())
-  
-  user        User             @relation(fields: [userId], references: [id])
-  track       Track            @relation(fields: [trackId], references: [id])
-  responses   Response[]
+  id             String           @id @default(uuid())
+  userId         String
+  trackId        String
+  status         EnrollmentStatus @default(ACTIVE)
+  currentDay     Float            @default(1)
+  startedAt      DateTime         @default(now())
+  completedAt    DateTime?
+  lastActivityAt DateTime         @default(now())
+  track          Track            @relation(fields: [trackId], references: [id])
+  user           User             @relation(fields: [userId], references: [id])
+  responses      Response[]
 }
 
 model Response {
-  id           String   @id @default(uuid())
+  id           String     @id @default(uuid())
   enrollmentId String
   userId       String
   dayNumber    Int
-  content      String?  // Text response
-  mediaUrl     String?  // Voice/Image response
-  createdAt    DateTime @default(now())
-  aiSource     String?  // Provider used (GEMINI, OPENAI)
-  
+  content      String?
+  mediaUrl     String?
+  createdAt    DateTime   @default(now())
+  aiSource     String?
   enrollment   Enrollment @relation(fields: [enrollmentId], references: [id], onDelete: Cascade)
   user         User       @relation(fields: [userId], references: [id])
 }
 
 model Message {
-  id        String   @id @default(uuid())
+  id        String    @id @default(uuid())
   userId    String
-  direction Direction // INBOUND, OUTBOUND
-  channel   String   @default("WHATSAPP")
+  direction Direction
+  channel   String    @default("WHATSAPP")
   content   String?
   mediaUrl  String?
-  payload   Json?    // Raw payload from provider
-  createdAt DateTime @default(now())
-
-  user      User     @relation(fields: [userId], references: [id])
+  payload   Json?
+  createdAt DateTime  @default(now())
+  user      User      @relation(fields: [userId], references: [id])
 
   @@index([userId, createdAt])
 }
 
+model Payment {
+  id              String        @id @default(uuid())
+  userId          String
+  trackId         String
+  amount          Int
+  currency        String        @default("XOF")
+  status          PaymentStatus @default(PENDING)
+  stripeSessionId String?       @unique
+  createdAt       DateTime      @default(now())
+  updatedAt       DateTime      @updatedAt
+  track           Track         @relation(fields: [trackId], references: [id])
+  user            User          @relation(fields: [userId], references: [id])
+}
+
+model TrainingData {
+  id               String         @id @default(uuid())
+  audioUrl         String
+  transcription    String
+  manualCorrection String?
+  rawWER           Float?
+  normalizedWER    Float?
+  status           TrainingStatus @default(PENDING)
+  createdAt        DateTime       @default(now())
+  updatedAt        DateTime       @updatedAt
+}
+
 enum Role {
   STUDENT
   ADMIN
@@ -195,21 +207,6 @@ enum Direction {
   OUTBOUND
 }
 
-model Payment {
-  id              String        @id @default(uuid())
-  userId          String
-  trackId         String
-  amount          Int
-  currency        String        @default("XOF")
-  status          PaymentStatus @default(PENDING)
-  stripeSessionId String?       @unique
-  createdAt       DateTime      @default(now())
-  updatedAt       DateTime      @updatedAt
-
-  user            User          @relation(fields: [userId], references: [id])
-  track           Track         @relation(fields: [trackId], references: [id])
-}
-
 enum PaymentStatus {
   PENDING
   COMPLETED
@@ -227,20 +224,8 @@ enum ExerciseStatus {
   PENDING
   PENDING_REMEDIATION
   PENDING_REVIEW
-  PENDING_DEEPDIVE
   COMPLETED
-}
-
-model TrainingData {
-  id               String   @id @default(uuid())
-  audioUrl         String
-  transcription    String   @db.Text
-  manualCorrection String?  @db.Text
-  rawWER           Float?
-  normalizedWER    Float?
-  status           TrainingStatus @default(PENDING)
-  createdAt        DateTime @default(now())
-  updatedAt        DateTime @updatedAt
+  PENDING_DEEPDIVE
 }
 
 enum TrainingStatus {

tasks/lessons.md

@@ -12,6 +12,7 @@ Ce fichier archive les échecs et solutions liées à la **stabilité technique*
 - **[AI] OpenAI Zod Schemas** : Pour les Structured Outputs, OpenAI exige que TOUS les champs d'un schéma soient obligatoires OU explicitement `.nullable().optional()`. Les `.optional()` seuls sur les sous-objets provoquent une erreur.
 - **[QUEUES] Payload Sync** : S'assurer que les noms de champs dans `whatsappQueue.add` (producteur) matchent exactement le destructuring dans le worker (consommateur). Préférer `currentDay` partout pour la consistance.
 - **[DB] Enrollment ID** : Toujours passer l'ID d'inscription (`enrollmentId`) au job de feedback pour permettre la persistance des réponses sans crash Prisma.
+- **[UX] Guidance Post-Validation** : Si un utilisateur envoie un message alors qu'il est en statut `COMPLETED`, le système ne doit pas rester muet. Il doit lui renvoyer un message de navigation (ex: "Tape SUITE pour continuer").
 
 ## 🛡️ 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.