docs: ajout TECH_DEBT.md

docs/TECH_DEBT.md

@@ -0,0 +1,139 @@
+# TECH_DEBT.md — Expria / Coach TCF Canada
+
+> **Document de référence — Version 1.0**
+> Ce document recense les décisions techniques prises par pragmatisme
+> qui devront être revisitées, les stubs temporaires, et les fonctionnalités
+> reportées. À mettre à jour après chaque session de développement.
+>
+> Format : chaque entrée a un identifiant (TD-XX), une priorité, et un statut.
+> Priorités : 🔴 Critique (bloque la production) / 🟡 Important / 🟢 Mineur
+
+---
+
+## 1. Stubs temporaires — à compléter
+
+### TD-01 — src/lib/supabase.ts (backend)
+**Priorité :** 🔴 Critique
+**Statut :** Ouvert
+**Description :** Client Supabase créé comme stub. Fonctionne en développement avec les variables d'environnement mais n'a pas de gestion d'erreur robuste si `SUPABASE_URL` ou `SUPABASE_SERVICE_ROLE_KEY` sont absentes.
+**À faire :** Ajouter une validation au démarrage — si les variables manquent, le serveur refuse de démarrer avec un message clair.
+**Session concernée :** Initialisation backend
+
+---
+
+### TD-02 — src/lib/planController.ts (backend)
+**Priorité :** 🟡 Important
+**Statut :** Ouvert
+**Description :** Stub créé pour permettre les tests de `updateUserPlan`. La vraie implémentation (mise à jour Supabase + gestion Stripe) n'est pas encore codée.
+**À faire :** Implémenter lors de la session Stripe (POST /stripe/webhook).
+**Session concernée :** Tests automatisés
+
+---
+
+### TD-03 — src/lib/stripe.ts (backend)
+**Priorité :** 🟡 Important
+**Statut :** Ouvert
+**Description :** Stub créé pour permettre les tests de `verifyStripeWebhook` et `calculateProrata`. La vraie implémentation Stripe n'est pas encore codée.
+**À faire :** Implémenter lors de la session Stripe.
+**Session concernée :** Tests automatisés
+
+---
+
+## 2. Décisions pragmatiques — à revisiter
+
+### TD-04 — Déploiement manuel (frontend + backend)
+**Priorité :** 🟢 Mineur
+**Statut :** Ouvert — accepté jusqu'aux premiers revenus
+**Description :** Cloudflare Pages et Render ne supportent pas l'auto-deploy depuis Codeberg. Le déploiement est manuel (CLI + dashboard).
+**À faire :** Migrer vers VPS Hetzner + Coolify pour restaurer l'auto-deploy. Voir ARCHITECTURE.md §9 Phase 2.
+**Condition de résolution :** Quand Expria génère ses premiers revenus réguliers.
+
+---
+
+### TD-05 — Comptes de test avec emails @gmail.com
+**Priorité :** 🟢 Mineur
+**Statut :** Ouvert
+**Description :** Les comptes de test utilisent `@gmail.com` au lieu de `@expria.local` prévu dans TEST_ENVIRONMENT.md. Raison : Supabase bloque la création d'utilisateurs avec des domaines non standards via l'API admin, et le dashboard est inaccessible depuis la Russie.
+**Emails actuels :**
+- `test.free@gmail.com`
+- `test.standard@gmail.com`
+- `test.premium@gmail.com`
+- `test.quota@gmail.com`
+**À faire :** Mettre à jour TEST_ENVIRONMENT.md pour refléter les vrais emails. Vérifier que la validation `@expria.local` dans le middleware n'est pas implémentée (elle ne l'est pas).
+
+---
+
+### TD-06 — Pas de migration SQL versionnée pour les tables initiales
+**Priorité :** 🟡 Important
+**Statut :** Ouvert
+**Description :** Les tables `profiles` et `productions` ont été créées directement via SQL Editor, sans fichier de migration dans `supabase/migrations/`. Viole la Règle F de DEVELOPMENT_PRINCIPLES.md.
+**À faire :** Créer les fichiers de migration correspondants :
+- `supabase/migrations/001_create_profiles.sql`
+- `supabase/migrations/002_create_productions.sql`
+- `supabase/migrations/003_create_test_accounts.sql`
+**Impact :** Si la base doit être recréée (nouveau projet Supabase), les migrations permettent de tout reconstruire en une commande.
+
+---
+
+### TD-07 — Ancien projet Supabase partagé
+**Priorité :** 🟡 Important
+**Statut :** Ouvert — accepté temporairement
+**Description :** Le nouveau projet Expria V2 utilise la même base Supabase que l'ancien projet (en maintenance). Les anciennes tables ont été remplacées mais d'autres tables de l'ancien projet subsistent (`sujets`, `eo_t2_results`, `payment_transactions`, etc.).
+**À faire :** Nettoyer les tables inutilisées quand V2 est stable en production.
+**Tables à évaluer :** `anon_rate_limits`, `contact_submissions`, `eo_t2_results`, `events`, `payment_transactions`, `sujets`, `waitlist`
+**Condition de résolution :** Après 30 jours de production stable de V2.
+
+---
+
+## 3. Fonctionnalités reportées
+
+### TD-08 — Phonologie T2 EO à 0
+**Priorité :** 🟡 Important
+**Statut :** Ouvert
+**Description :** L'évaluation de la phonologie pour la T2 EO live est temporairement à 0 (non évaluée). L'évaluation se fait sur 4 critères au lieu de 5.
+**Raison :** La T2 live utilise un transcript texte — évaluer la phonologie nécessite l'audio brut, ce qui dépasse la limite de taille des requêtes.
+**À faire :** Implémenter l'évaluation phonologique via un endpoint séparé qui traite l'audio en chunks.
+**Session concernée :** T2 live (WebSocket)
+
+---
+
+### TD-09 — ScriptProcessorNode déprécié (T2 live)
+**Priorité :** 🟢 Mineur
+**Statut :** Reporté à après le lancement
+**Description :** Le traitement audio côté client utilise `ScriptProcessorNode` qui est déprécié. Doit être remplacé par `AudioWorklet`.
+**Impact :** Fonctionne mais génère des warnings dans la console. Peut poser problème sur certains navigateurs futurs.
+**À faire :** Migrer vers AudioWorklet après le lancement MVP.
+
+---
+
+### TD-10 — Analyse des patterns (Premium) non implémentée
+**Priorité :** 🟡 Important
+**Statut :** Planifié
+**Description :** La feature d'analyse des patterns sur les 5 dernières productions (Premium) n'est pas encore implémentée côté backend.
+**À faire :** Implémenter après les corrections EE/EO et Stripe.
+
+---
+
+### TD-11 — Indice de préparation non implémenté
+**Priorité :** 🟢 Mineur
+**Statut :** Planifié
+**Description :** Le calcul de l'indice de préparation (0-100) basé sur progression + régularité n'est pas encore implémenté.
+**À faire :** Implémenter en même temps que l'analyse des patterns (TD-10).
+
+---
+
+## 4. Tests à automatiser
+
+### TD-12 — Tests manuels du Golden Dataset non automatisés
+**Priorité :** 🟢 Mineur
+**Statut :** Accepté — par conception
+**Description :** Les 41 tests du Golden Dataset sont manuels. Certains pourraient être automatisés (tests d'intégration HTTP avec Supertest).
+**À faire :** Ajouter des tests d'intégration pour les routes critiques après le lancement MVP.
+
+---
+
+## 5. Historique des résolutions
+
+| ID | Description | Résolu le | Comment |
+|---|---|---|---|
+| — | — | — | — |