docs/audit_tech_02052026.md

🛠️ Audit Dette Technique - 02 Mai 2026

🎯 Objectifs de la session

Modernisation de l'architecture CRM, unification des services d'IA dans un SDK partagé, et stabilisation du WhatsApp Worker pour le déploiement sur Railway.

---

✅ Erreurs & Problèmes résolus

1. Unification de l'IA (@repo/ai-sdk)

• Problème : Logique d'IA dupliquée entre apps/api et apps/whatsapp-worker. Dépendance excessive du worker envers les endpoints de l'API.
• Action : Création du package @repo/ai-sdk.
• Résultat : Toute la logique (OpenAI, Gemini, Transcription, Prompting) est centralisée. L'injection de dépendances (prisma, redis, secrets) permet au worker de fonctionner de manière autonome.

2. Correction du Seed Prisma (Crash Railway)

• Problème : Le build échouait car les scripts de seed créaient des Track sans organizationId, violant les contraintes multi-tenant.
• Action : Mise à jour de packages/database/src/seed.ts pour récupérer/créer une organisation par défaut et l'injecter dans chaque Track.
• Résultat : Build et Seed fonctionnels sur Railway.

3. Harmonisation HTTP du Worker

• Problème : Utilisation éparse de fetch sans gestion d'erreur robuste, sans timeouts et sans logs uniformes.
• Action : Création de apiClient et createWhatsAppClient via Axios.
• Résultat : Remplacement de tous les fetch dans les handlers (InboundHandler, MediaHandler). Meilleure résilience et traçabilité.

4. Stabilisation du Build (TypeScript)

• Problème : 88+ erreurs de compilation lors du build du SDK d'IA et du worker.
  • Absence de fichiers de déclaration (.d.ts).
  • Shadowing de variables (mimeType dans MediaHandler).
  • Paramètres inutilisés (noUnusedParameters).
• Action :
  • Configuration composite: true et ajout de @types/node dans le SDK.
  • Refactorisation complète du MediaHandler pour clarifier les portées de variables.
  • Nettoyage des signatures de fonctions dans ai-pedagogy.ts.
• Résultat : Le build passe désormais à 100% (pnpm turbo run build success).

---

⏳ Ce qu'il reste à régler (Dette Résiduelle)

1. Nettoyage des fichiers redondants

• Certains fichiers dans apps/api/src/services/ai/ ont été supprimés, mais une vérification finale est nécessaire pour s'assurer qu'aucun résidu de l'ancienne implémentation ne persiste dans l'arborescence.

2. Migration du Stockage (Storage SDK)

• Le SDK d'IA dépend encore de certains endpoints API pour le stockage (ex: store-audio). Pour une autonomie totale, une abstraction @repo/storage-sdk devrait être envisagée.

---

🚀 État Actuel : LE PROBLÈME BLOQUANT

Statut : RÉSOLU. Le problème bloquant était une erreur de compilation TypeScript dans le MediaHandler du worker concernant l'accès à la propriété mimeType. Malgré un cast any, le compilateur restait bloqué sur une version mise en cache ou mal interprétée.

• Solution finale : Réécriture complète de la fonction handle du MediaHandler avec une extraction explicite des données et un build forcé sans cache.

L'architecture est maintenant prête pour un déploiement de production serein.