docs/audit_production.md

Audit Complet — État de la Codebase

Date : 2026-02-22 — Commit base : c286b2d

---

1. Architecture globale

apps/
  api/            → Fastify REST API (Railway — port 3001)
  whatsapp-worker/ → BullMQ Worker (Railway — même container)
  admin/          → Dashboard React (Vite + Tailwind)
  web/            → Landing page + portail étudiant (Vite + Tailwind)

packages/
  database/       → Prisma schema (PostgreSQL) + migrations
  shared-types/   → Types TypeScript partagés
  tsconfig/       → Config TS commune
  ui/             → (vide)

---

2. Ce qui fonctionne ✅

Composant	État
Webhook WhatsApp (GET verify + POST events)	✅ Implémenté
Onboarding : INSCRIPTION → langue → secteur	✅
Menus interactifs LIST (boutons natifs)	✅ Titre ≤ 24 chars corrigé
Download audio Meta Graph API (Railway)	✅
Transcription Whisper via /v1/ai/transcribe	✅
Feedback AI generateFeedback() + 429 fallback	✅
Timeout IA 10s (Promise.race)	✅
TTS leçon → audio R2	✅
Personnalisation leçon par secteur	✅
SUITE / DAY_CONTINUE → jour suivant	✅ Regex fixé
REPLAY → réécoute leçon	✅
EXERCISE → invite réponse	✅
Dock génération OnePager PDF + PitchDeck PPTX	✅
Paiements Stripe (checkout + webhook)	✅ Implémenté
Admin dashboard (stats + enrollments + CSV export)	✅
Dockerfile combiné API + Worker (Railway)	✅
Scheduler cron leçons quotidiennes	✅ (basique)
Stockage audio R2 via /v1/ai/store-audio	✅ Ajouté

---

3. Problèmes identifiés ❌

3.1 Critiques (bloquants en prod)

#	Fichier	Problème	Solution
C1	Railway vars	WHATSAPP_APP_SECRET non défini → HMAC skip (warning)	Ajouter la variable
C2	Railway vars	DISABLE_WHATSAPP_SEND=true encore présent → aucun envoi	Supprimer la variable
C3	Base de données	Aucun contenu (Track/TrackDay) en production → enrollement impossible	Seed ou admin content manager
C4	api/src/services/stripe.ts	STRIPE_SECRET_KEY et STRIPE_WEBHOOK_SECRET non vérifiés au démarrage	Ajouter à Railway vars
C5	Meta webhook	URL pas encore validée si container 502	Corriger après Railway restart

3.2 Importants (fonctionnalités incomplètes)

#	Composant	Problème
I1	apps/admin	Pas de gestion de contenu (Tracks/TrackDays) — impossible de créer des leçons via l'interface
I2	apps/admin	env.user?.whatsappId utilisé mais le modèle User a phone (pas whatsappId) → colonne vide dans le tableau
I3	apps/web	Portail étudiant /login est factice — handleLogin fait un fake alert avec setTimeout, n'appelle aucune API
I4	apps/web	Pas de page de succès paiement Stripe (/payment/success)
I5	whatsapp-worker/src/scheduler.ts	Cron envoie les leçons mais sans logique de vérification du jour courant — risque d'envoyer à des utilisateurs déjà complétés
I6	apps/api/routes/admin.ts	Pas de route pour créer/modifier des Tracks ou TrackDays API-side
I7	packages/ui	Package vide — prévu pour composants partagés mais non utilisé

3.3 Mineurs (dette technique)

#	Problème
M1	Enrollment et UserProgress sont deux tables qui trackent le même currentDay et exerciseStatus — duplication de données
M2	admin/src/App.tsx ligne 108 : import lucide-react collé avec une déclaration d'interface (mauvais formatage)
M3	Message modèle Prisma non utilisé nulle part dans le code (payload jamais stocké)
M4	web/src n'a pas de VITE_API_URL configuré par défaut → fallback localhost:3001 en prod
M5	Pas de gestion du cas où un utilisateur envoie INSCRIPTION alors qu'il est déjà inscrit à une formation active

---

4. Variables d'environnement — état complet

Railway (whatsapp-worker service)

Variable	Statut	Action
WHATSAPP_VERIFY_TOKEN	✅	OK
WHATSAPP_ACCESS_TOKEN	✅	OK
WHATSAPP_PHONE_NUMBER_ID	✅	OK
WHATSAPP_APP_SECRET	⚠️ Non défini	Ajouter (Meta App → Basic Settings → App Secret)
ADMIN_API_KEY	✅ (confirmé)	OK
DATABASE_URL	✅	OK
REDIS_URL	✅	OK
OPENAI_API_KEY	✅	OK
API_URL	✅	OK (doit pointer vers URL Railway publique)
DISABLE_WHATSAPP_SEND	❌ Présent	Supprimer
STRIPE_SECRET_KEY	❓ Non confirmé	Ajouter si Stripe actif
STRIPE_WEBHOOK_SECRET	❓ Non confirmé	Ajouter si Stripe actif
NODE_ENV	✅	OK
R2_* variables	✅	OK

HuggingFace (api service — inbound webhook désactivé)

Variable	Statut
DISABLE_WHATSAPP_SEND	✅ true (correct)
OPENAI_API_KEY	✅
DATABASE_URL	✅
Autres	Même que Railway

---

5. Déploiements

Service	Plateforme	URL	État
API + Worker (webhook + BullMQ)	Railway	whatsapp-worker-production-0bc0.up.railway.app	🟡 En restart
Landing + Portail	HF / Netlify ?	À confirmer	❓
Admin Dashboard	HF / Netlify ?	À confirmer	❓