fix(arch): HF inbound-only + seedDatabase export + DISABLE_WORKER + DISABLE_WHATSAPP_SEND

apps/api/src/services/whatsapp.ts

@@ -36,71 +36,20 @@ export class WhatsAppService {
         }
 
         if (normalizedText === 'SEED') {
-            await scheduleMessage(user.id, "🔄 Lancement du seeding en cours...");
+            // Reply immediately so the webhook doesn't time out
+            console.log(`[SEED] Triggered by user ${user.id}`);
             try {
-                // Run seed logic directly in-process (no child_process, no path issues)
-                const existingFR = await prisma.track.findFirst({ where: { title: "Comprendre Son Business (FR)" } });
-                if (existingFR) {
-                    await scheduleMessage(user.id, "ℹ️ Les données existent déjà en base. Aucun seeding nécessaire !");
-                    return;
-                }
-
-                // Seed FR track
-                await prisma.track.create({
-                    data: {
-                        title: "Comprendre Son Business (FR)",
-                        description: "Apprenez à définir, tester et vendre votre projet en 12 leçons.",
-                        duration: 12,
-                        language: "FR",
-                        days: {
-                            create: [
-                                { dayNumber: 1, exerciseType: "AUDIO", lessonText: "Aujourd'hui, on commence simple. Beaucoup de personnes disent : je fais le commerce. Mais ça ne veut rien dire. Dis-moi clairement : Tu aides QUI, à faire QUOI, et comment tu gagnes de l'argent. Exemple : Je vends du jus bissap aux étudiants devant l'université. Maintenant, c'est à toi. Dis ta phrase en 15 secondes.", exercisePrompt: "Envoie-moi un court message vocal (ou texte) avec ta phrase d'activité :" },
-                                { dayNumber: 2, exerciseType: "AUDIO", lessonText: "Le client n'achète pas ton produit. Il achète un résultat. Il n'achète pas du savon. Il achète la propreté. Va demander à 2 clients : Pourquoi tu achètes ça ? Écoute bien leurs mots.", exercisePrompt: "Envoie un audio résumant les 2 réponses de tes clients." },
-                                { dayNumber: 3, exerciseType: "BUTTON", lessonText: "Si tu vends à tout le monde, tu ne vends à personne. Choisis un seul client principal. Qui est le plus intéressé par ton produit ?", exercisePrompt: "Sélectionne ton client principal ci-dessous :", buttonsJson: [{ id: "jeunes", title: "Jeunes" }, { id: "femmes", title: "Femmes" }, { id: "commercants", title: "Commerçants" }] },
-                                { dayNumber: 4, exerciseType: "TEXT", lessonText: "Ton client a un problème. Quel est son plus grand problème ? Parle à 3 personnes aujourd'hui. Pose cette question. Écoute sans expliquer ton produit.", exercisePrompt: "Quel est le problème N°1 que tes clients t'ont partagé ?" },
-                                { dayNumber: 5, exerciseType: "BUTTON", lessonText: "À quel moment ton client a ce problème ?", exercisePrompt: "Choisis le moment d'apparition du problème :", buttonsJson: [{ id: "matin_midi", title: "Matin ou Midi" }, { id: "soir", title: "Le Soir" }, { id: "tout_le_temps", title: "Tout le temps" }] },
-                                { dayNumber: 6, exerciseType: "TEXT", lessonText: "Avant toi, il faisait comment ?", exercisePrompt: "Donne-moi 2 solutions que ton client utilisait avant de te connaître :" },
-                                { dayNumber: 7, exerciseType: "TEXT", lessonText: "Explique ta solution en mots simples. Pas compliqué.", exercisePrompt: "Décris-moi ton offre très simplement en une phrase :" },
-                                { dayNumber: 8, exerciseType: "BUTTON", lessonText: "Tu ne peux pas promettre tout. Choisis une seule force.", exercisePrompt: "Quelle est ta promesse principale ?", buttonsJson: [{ id: "rapide", title: "Rapide" }, { id: "moins_cher", title: "Moins cher" }, { id: "fiable_proche", title: "Fiable / Proche" }] },
-                                { dayNumber: 9, exerciseType: "TEXT", lessonText: "Parle à 5 personnes. Dis ta phrase. Combien disent OUI ?", exercisePrompt: "Combien t'ont dit OUI ? (Envoie juste un chiffre)" },
-                                { dayNumber: 10, exerciseType: "TEXT", lessonText: "Ton prix doit couvrir tes coûts. Note 2 dépenses importantes.", exercisePrompt: "Quelles sont tes 2 plus grosses dépenses pour ce projet ?" },
-                                { dayNumber: 11, exerciseType: "BUTTON", lessonText: "Pourquoi toi et pas un autre ?", exercisePrompt: "Quel est ton vrai avantage concurrentiel ?", buttonsJson: [{ id: "qualite", title: "Qualité" }, { id: "rapidite", title: "Rapidité" }, { id: "confiance", title: "Confiance" }] },
-                                { dayNumber: 12, exerciseType: "AUDIO", lessonText: "Maintenant tu es prêt. Dis en 30 secondes : Je suis... J'aide... Parce que... Je vends... À...", exercisePrompt: "C'est l'heure du test ! Envoie-moi un audio avec ton Mini Pitch de 30 secondes :" },
-                            ]
-                        }
-                    }
-                });
-
-                // Seed WOLOF track
-                await prisma.track.create({
-                    data: {
-                        title: "Comprendre Son Business (WOLOF)",
-                        description: "Apprenez à définir, tester et vendre votre projet en 12 leçons.",
-                        duration: 12,
-                        language: "WOLOF",
-                        days: {
-                            create: [
-                                { dayNumber: 1, exerciseType: "AUDIO", lessonText: "Tey, danuy tàmbalee ak lu yomb. Nit ñu bari dañuy wax : dama def commerce. Waaye loolu amul solo. Wax ma leer : Yaay jàppalé KAN, mu def LAN, te naka nga amee xaalis. Misaal : Damaa jaay jus bissap ci taalibe yu université. Léegi sa waxtu la. Wax sa activité ci 15 seconde.", exercisePrompt: "Yónnee ma ab kàddu (audio) walla message bu gatt ngir wax sa mbir :" },
-                                { dayNumber: 2, exerciseType: "AUDIO", lessonText: "Kiliifa bi du jënd sa produit rek. Mu jënd ab résultat. Du jënd savon rek. Mu jënd set. Dem laaj 2 kiliifa : Lu tax nga jënd lii ? Déggal bu baax li ñuy wax.", exercisePrompt: "Yónnee ma audio ngir tënk ñaari tontu ya." },
-                                { dayNumber: 3, exerciseType: "BUTTON", lessonText: "Su nga jaay ci ñépp, doo jaay ci kenn. Tànnal benn kiliifa bu mag. Kan moo gën a soxla sa produit ?", exercisePrompt: "Tànnal sa kiliifa bu mag ci suuf :", buttonsJson: [{ id: "ndaw_nyi", title: "Ndaw ñi / Jeunes" }, { id: "jigeen_nyi", title: "Jigeen ñi / Femmes" }, { id: "jaaykat_yi", title: "Jaaykat yi / Comms" }] },
-                                { dayNumber: 4, exerciseType: "TEXT", lessonText: "Sa kiliifa am na jafe jafe. Lan mooy jafe jafe bu gën a rëy ? Dem waxtaan ak 3 nit. Laaj leen. Bul def publicité.", exercisePrompt: "Lan mooy jafe jafe bu gën a mag bi sa kiliifa yi am ?" },
-                                { dayNumber: 5, exerciseType: "BUTTON", lessonText: "Kañ la jafe jafe bi di ñëw ?", exercisePrompt: "Tànnal jamono ji jafe jafe bi di faral di am :", buttonsJson: [{ id: "suba_bëccëg", title: "Suba walla Bëccëg" }, { id: "ngoon", title: "Ngoon / Guddi" }, { id: "saa_su_ne", title: "Saa su nekk" }] },
-                                { dayNumber: 6, exerciseType: "TEXT", lessonText: "Balaa yaw, naka la daan def ?", exercisePrompt: "Wax ma ñaari pexe yi kiliifa bi daan jëfandikoo balaa xam sa produit :" },
-                                { dayNumber: 7, exerciseType: "TEXT", lessonText: "Wax sa solution ci wax yu yomb.", exercisePrompt: "Tënkal sa solution ci benn phrase bu yomb :" },
-                                { dayNumber: 8, exerciseType: "BUTTON", lessonText: "Bul promettre lépp. Tànnal benn doole.", exercisePrompt: "Lan mooy sa dige bu mag ?", buttonsJson: [{ id: "gaaw", title: "Dafa gaaw" }, { id: "yomb", title: "Dafa yomb / Prix" }, { id: "woor", title: "Dafa woor" }] },
-                                { dayNumber: 9, exerciseType: "TEXT", lessonText: "Dem waxtaan ak 5 nit. Ñaata ñu wax WAAN ?", exercisePrompt: "Ñaata nit ñoo wax WAAN ? (Bind ma chiffre bi rek)" },
-                                { dayNumber: 10, exerciseType: "TEXT", lessonText: "Sa priix war na japp sa dépense. Bind ñaari dépense.", exercisePrompt: "Bind ma ñaari dépense yu gën a rëy ci sa mbir :" },
-                                { dayNumber: 11, exerciseType: "BUTTON", lessonText: "Lu tax yaw te du keneen ?", exercisePrompt: "Lan nga gën a mën ci ñeneen ñi ?", buttonsJson: [{ id: "baax", title: "Dafa baax" }, { id: "gaaw", title: "Dafa gaaw" }, { id: "koolute", title: "Kooluté / Confiance" }] },
-                                { dayNumber: 12, exerciseType: "AUDIO", lessonText: "Léegi nga hazır. Wax ci 30 seconde : Man ma... Damaa jàppalé... Ndax... Damaa jaay... Ci...", exercisePrompt: "Yónnee ma sa Pitch bu gatt ci 30 seconde :" },
-                            ]
-                        }
-                    }
-                });
-
-                await scheduleMessage(user.id, "✅ Seeding terminé ! Les 2 modules (FR + WOLOF) sont en base. Envoie INSCRIPTION pour commencer.");
+                const { seedDatabase } = await import('@repo/database');
+                const result = await seedDatabase(prisma);
+                console.log('[SEED] Result:', result.message);
+                await scheduleMessage(user.id, result.seeded
+                    ? "✅ Seeding terminé ! Les 2 modules (FR + WOLOF) sont en base.\nEnvoie INSCRIPTION pour commencer."
+                    : "ℹ️ Les données existent déjà. Envoie INSCRIPTION pour commencer."
+                );
             } catch (err: any) {
-                console.error('Seed Error:', err);
-                await scheduleMessage(user.id, `❌ Erreur de seed : ${err.message}`);
+                console.error('[SEED] Error:', err.message);
+                // Don't crash — scheduleMessage a user-friendly error
+                await scheduleMessage(user.id, `❌ Erreur seed : ${err.message?.substring(0, 200)}`);
             }
             return;
         }

apps/whatsapp-worker/src/whatsapp-cloud.ts

@@ -32,6 +32,12 @@ function getHeaders(): Record<string, string> {
  * @param text - Message body (supports basic WhatsApp markdown: *bold*, _italic_)
  */
 export async function sendTextMessage(to: string, text: string): Promise<void> {
+    // Safety guard: HF is inbound-only. Only Railway worker should call this.
+    if (process.env.DISABLE_WHATSAPP_SEND === 'true') {
+        console.warn(`[WhatsApp] DISABLE_WHATSAPP_SEND=true — Skipping send to ${to}. Message: "${text.substring(0, 60)}..."`);
+        return;
+    }
+
     const body = {
         messaging_product: 'whatsapp',
         recipient_type: 'individual',

packages/database/index.ts

@@ -1 +1,2 @@
 export * from '@prisma/client';
+export { seedDatabase } from './src/seed';

packages/database/package.json

@@ -3,6 +3,10 @@
     "version": "0.0.0",
     "main": "./index.ts",
     "types": "./index.ts",
+    "exports": {
+        ".": "./index.ts",
+        "./seed": "./src/seed.ts"
+    },
     "scripts": {
         "db:push": "prisma db push",
         "db:studio": "prisma studio",

packages/database/src/seed.ts

@@ -0,0 +1,69 @@
+import { PrismaClient } from '@prisma/client';
+
+/**
+ * Seeds the database with the Module 1 curriculum (FR + WOLOF).
+ * Safe to call multiple times — checks for existing data before inserting.
+ */
+export async function seedDatabase(prisma: PrismaClient): Promise<{ seeded: boolean; message: string }> {
+    const existingFR = await prisma.track.findFirst({
+        where: { title: "Comprendre Son Business (FR)" }
+    });
+
+    if (existingFR) {
+        return { seeded: false, message: "Data already exists. No seeding needed." };
+    }
+
+    // ── MODULE 1 – FR ──────────────────────────────────────────────────────────
+    await prisma.track.create({
+        data: {
+            title: "Comprendre Son Business (FR)",
+            description: "Apprenez à définir, tester et vendre votre projet en 12 leçons.",
+            duration: 12,
+            language: "FR",
+            days: {
+                create: [
+                    { dayNumber: 1, exerciseType: "AUDIO", lessonText: "Aujourd'hui, on commence simple. Beaucoup de personnes disent : je fais le commerce. Mais ça ne veut rien dire. Dis-moi clairement : Tu aides QUI, à faire QUOI, et comment tu gagnes de l'argent. Exemple : Je vends du jus bissap aux étudiants devant l'université. Maintenant, c'est à toi. Dis ta phrase en 15 secondes.", exercisePrompt: "Envoie-moi un court message vocal (ou texte) avec ta phrase d'activité :" },
+                    { dayNumber: 2, exerciseType: "AUDIO", lessonText: "Le client n'achète pas ton produit. Il achète un résultat. Il n'achète pas du savon. Il achète la propreté. Va demander à 2 clients : Pourquoi tu achètes ça ? Écoute bien leurs mots.", exercisePrompt: "Envoie un audio résumant les 2 réponses de tes clients." },
+                    { dayNumber: 3, exerciseType: "BUTTON", lessonText: "Si tu vends à tout le monde, tu ne vends à personne. Choisis un seul client principal. Qui est le plus intéressé par ton produit ?", exercisePrompt: "Sélectionne ton client principal ci-dessous :", buttonsJson: [{ id: "jeunes", title: "Jeunes" }, { id: "femmes", title: "Femmes" }, { id: "commercants", title: "Commerçants" }] },
+                    { dayNumber: 4, exerciseType: "TEXT", lessonText: "Ton client a un problème. Quel est son plus grand problème ? Parle à 3 personnes aujourd'hui. Pose cette question. Écoute sans expliquer ton produit.", exercisePrompt: "Quel est le problème N°1 que tes clients t'ont partagé ?" },
+                    { dayNumber: 5, exerciseType: "BUTTON", lessonText: "À quel moment ton client a ce problème ?", exercisePrompt: "Choisis le moment d'apparition du problème :", buttonsJson: [{ id: "matin_midi", title: "Matin ou Midi" }, { id: "soir", title: "Le Soir" }, { id: "tout_le_temps", title: "Tout le temps" }] },
+                    { dayNumber: 6, exerciseType: "TEXT", lessonText: "Avant toi, il faisait comment ?", exercisePrompt: "Donne-moi 2 solutions que ton client utilisait avant de te connaître :" },
+                    { dayNumber: 7, exerciseType: "TEXT", lessonText: "Explique ta solution en mots simples. Pas compliqué.", exercisePrompt: "Décris-moi ton offre très simplement en une phrase :" },
+                    { dayNumber: 8, exerciseType: "BUTTON", lessonText: "Tu ne peux pas promettre tout. Choisis une seule force.", exercisePrompt: "Quelle est ta promesse principale ?", buttonsJson: [{ id: "rapide", title: "Rapide" }, { id: "moins_cher", title: "Moins cher" }, { id: "fiable_proche", title: "Fiable / Proche" }] },
+                    { dayNumber: 9, exerciseType: "TEXT", lessonText: "Parle à 5 personnes. Dis ta phrase. Combien disent OUI ?", exercisePrompt: "Combien t'ont dit OUI ? (Envoie juste un chiffre)" },
+                    { dayNumber: 10, exerciseType: "TEXT", lessonText: "Ton prix doit couvrir tes coûts. Note 2 dépenses importantes.", exercisePrompt: "Quelles sont tes 2 plus grosses dépenses pour ce projet ?" },
+                    { dayNumber: 11, exerciseType: "BUTTON", lessonText: "Pourquoi toi et pas un autre ?", exercisePrompt: "Quel est ton vrai avantage concurrentiel ?", buttonsJson: [{ id: "qualite", title: "Qualité" }, { id: "rapidite", title: "Rapidité" }, { id: "confiance", title: "Confiance" }] },
+                    { dayNumber: 12, exerciseType: "AUDIO", lessonText: "Maintenant tu es prêt. Dis en 30 secondes : Je suis... J'aide... Parce que... Je vends... À...", exercisePrompt: "C'est l'heure du test ! Envoie-moi un audio avec ton Mini Pitch de 30 secondes :" },
+                ]
+            }
+        }
+    });
+
+    // ── MODULE 1 – WOLOF ───────────────────────────────────────────────────────
+    await prisma.track.create({
+        data: {
+            title: "Comprendre Son Business (WOLOF)",
+            description: "Apprenez à définir, tester et vendre votre projet en 12 leçons.",
+            duration: 12,
+            language: "WOLOF",
+            days: {
+                create: [
+                    { dayNumber: 1, exerciseType: "AUDIO", lessonText: "Tey, danuy tàmbalee ak lu yomb. Nit ñu bari dañuy wax : dama def commerce. Waaye loolu amul solo. Wax ma leer : Yaay jàppalé KAN, mu def LAN, te naka nga amee xaalis. Misaal : Damaa jaay jus bissap ci taalibe yu université. Léegi sa waxtu la. Wax sa activité ci 15 seconde.", exercisePrompt: "Yónnee ma ab kàddu (audio) walla message bu gatt ngir wax sa mbir :" },
+                    { dayNumber: 2, exerciseType: "AUDIO", lessonText: "Kiliifa bi du jënd sa produit rek. Mu jënd ab résultat. Du jënd savon rek. Mu jënd set. Dem laaj 2 kiliifa : Lu tax nga jënd lii ? Déggal bu baax li ñuy wax.", exercisePrompt: "Yónnee ma audio ngir tënk ñaari tontu ya." },
+                    { dayNumber: 3, exerciseType: "BUTTON", lessonText: "Su nga jaay ci ñépp, doo jaay ci kenn. Tànnal benn kiliifa bu mag. Kan moo gën a soxla sa produit ?", exercisePrompt: "Tànnal sa kiliifa bu mag ci suuf :", buttonsJson: [{ id: "ndaw_nyi", title: "Ndaw ñi / Jeunes" }, { id: "jigeen_nyi", title: "Jigeen ñi / Femmes" }, { id: "jaaykat_yi", title: "Jaaykat yi / Comms" }] },
+                    { dayNumber: 4, exerciseType: "TEXT", lessonText: "Sa kiliifa am na jafe jafe. Lan mooy jafe jafe bu gën a rëy ? Dem waxtaan ak 3 nit. Laaj leen. Bul def publicité.", exercisePrompt: "Lan mooy jafe jafe bu gën a mag bi sa kiliifa yi am ?" },
+                    { dayNumber: 5, exerciseType: "BUTTON", lessonText: "Kañ la jafe jafe bi di ñëw ?", exercisePrompt: "Tànnal jamono ji jafe jafe bi di faral di am :", buttonsJson: [{ id: "suba_bëccëg", title: "Suba walla Bëccëg" }, { id: "ngoon", title: "Ngoon / Guddi" }, { id: "saa_su_ne", title: "Saa su nekk" }] },
+                    { dayNumber: 6, exerciseType: "TEXT", lessonText: "Balaa yaw, naka la daan def ?", exercisePrompt: "Wax ma ñaari pexe yi kiliifa bi daan jëfandikoo balaa xam sa produit :" },
+                    { dayNumber: 7, exerciseType: "TEXT", lessonText: "Wax sa solution ci wax yu yomb.", exercisePrompt: "Tënkal sa solution ci benn phrase bu yomb :" },
+                    { dayNumber: 8, exerciseType: "BUTTON", lessonText: "Bul promettre lépp. Tànnal benn doole.", exercisePrompt: "Lan mooy sa dige bu mag ?", buttonsJson: [{ id: "gaaw", title: "Dafa gaaw" }, { id: "yomb", title: "Dafa yomb / Prix" }, { id: "woor", title: "Dafa woor" }] },
+                    { dayNumber: 9, exerciseType: "TEXT", lessonText: "Dem waxtaan ak 5 nit. Ñaata ñu wax WAAN ?", exercisePrompt: "Ñaata nit ñoo wax WAAN ? (Bind ma chiffre bi rek)" },
+                    { dayNumber: 10, exerciseType: "TEXT", lessonText: "Sa priix war na japp sa dépense. Bind ñaari dépense.", exercisePrompt: "Bind ma ñaari dépense yu gën a rëy ci sa mbir :" },
+                    { dayNumber: 11, exerciseType: "BUTTON", lessonText: "Lu tax yaw te du keneen ?", exercisePrompt: "Lan nga gën a mën ci ñeneen ñi ?", buttonsJson: [{ id: "baax", title: "Dafa baax" }, { id: "gaaw", title: "Dafa gaaw" }, { id: "koolute", title: "Kooluté / Confiance" }] },
+                    { dayNumber: 12, exerciseType: "AUDIO", lessonText: "Léegi nga hazır. Wax ci 30 seconde : Man ma... Damaa jàppalé... Ndax... Damaa jaay... Ci...", exercisePrompt: "Yónnee ma sa Pitch bu gatt ci 30 seconde :" },
+                ]
+            }
+        }
+    });
+
+    return { seeded: true, message: "✅ Module 1 FR + WOLOF seeded successfully (24 lessons)." };
+}

scripts/start-backend.sh

@@ -4,14 +4,19 @@ set -ex
 echo "Running database migrations..."
 pnpm --filter @repo/database db:push
 
-echo "Starting WhatsApp Worker..."
-# The TypeScript build might output to dist/src/index.js or dist/index.js depending on rootDir
-if [ -f "apps/whatsapp-worker/dist/src/index.js" ]; then
-    node apps/whatsapp-worker/dist/src/index.js &
-elif [ -f "apps/whatsapp-worker/dist/index.js" ]; then
-    node apps/whatsapp-worker/dist/index.js &
+# On Hugging Face (DISABLE_WORKER=true), only run the API.
+# The WhatsApp worker runs exclusively on Railway and calls graph.facebook.com from there.
+if [ "${DISABLE_WORKER}" != "true" ]; then
+    echo "Starting WhatsApp Worker..."
+    if [ -f "apps/whatsapp-worker/dist/src/index.js" ]; then
+        node apps/whatsapp-worker/dist/src/index.js &
+    elif [ -f "apps/whatsapp-worker/dist/index.js" ]; then
+        node apps/whatsapp-worker/dist/index.js &
+    else
+        echo "WARNING: WhatsApp Worker build output missing — worker not started."
+    fi
 else
-    echo "ERROR: WhatsApp Worker build output missing (dist/index.js or dist/src/index.js)"
+    echo "DISABLE_WORKER=true — Skipping worker startup (HF inbound-only mode)."
 fi
 
 echo "Starting API..."
@@ -20,6 +25,6 @@ if [ -f "apps/api/dist/src/index.js" ]; then
 elif [ -f "apps/api/dist/index.js" ]; then
     exec node apps/api/dist/index.js
 else
-    echo "ERROR: API build output missing (dist/index.js or dist/src/index.js)!"
+    echo "ERROR: API build output missing!"
     exit 1
 fi