docs/implementation_plan_debt_resolution_08052026.md

# Plan d'Implémentation : Résolution de la Dette Technique

Ce plan détaille les étapes pour résoudre les problèmes identifiés dans l'audit du 08/05/2026.

## Phase 1 : Sécurité & Isolation (Priorité Immédiate)

### 1.1 Hardening de l'Isolation Multi-Tenant
- **Tâche** : Mettre à jour `packages/database/src/extension.ts` pour inclure l'opération `upsert` dans les filtres automatiques.
- **Vérification** : Test unitaire simulant un `upsert` avec un ID d'un autre tenant.

### 1.2 Découpage du Middleware d'Authentification
- **Tâche** : Extraire la logique de `index.ts` vers des middlewares dédiés :
  - `validateApiKey.ts`
  - `verifyJwt.ts`
  - `enforceOrgIsolation.ts`
- **Vérification** : Les routes protégées doivent toujours retourner 401/403 sans les bons headers.

---

## Phase 2 : Optimisation Backend & IA

### 2.1 Mise en cache des Prompts
- **Tâche** : Modifier `PromptLoader` pour utiliser un cache mémoire (`Map`) afin d'éviter les lectures disque répétitives.
- **Tâche** : Déplacer les prompts codés en dur de `AIService.ts` vers `packages/prompts/src/templates`.

### 2.2 Refactorisation des Contrôleurs Admin
- **Tâche** : Extraire la logique métier de `admin.ts` vers des services dédiés (ex: `ExcelService`, `AnalyticsService`).
- **Objectif** : Réduire la taille des fichiers de routes à moins de 10KB.

---

## Phase 3 : Refactorisation Frontend (App Web)

### 3.1 Dé-monolithisation de `apps/web`
- **Tâche** : Créer une structure de dossiers standard dans `apps/web/src` :
  - `components/` (Navbar, Hero, Features, StudentPortal, etc.)
  - `hooks/` (useStudentData)
  - `lib/` (api.ts - mutualisé avec l'admin si possible)
- **Tâche** : Migrer les appels `fetch()` vers le client `api.ts`.

---

## Phase 4 : Qualité & Automatisation

### 4.1 Unification du Package Management
- **Tâche** : Supprimer `package-lock.json`. Configurer `pnpm-workspace.yaml` pour garantir l'usage exclusif de pnpm.
- **Tâche** : Ajouter un script `preinstall` pour bloquer npm/yarn.

### 4.2 Socle de Tests
- **Tâche** : Installer `vitest` dans le package `api`.
- **Tâche** : Écrire des tests d'intégration pour les flux critiques (Login, Inbound Message, Org Creation).

## 📅 Estimation de l'effort

| Phase | Durée Estimée | Complexité |
| :--- | :--- | :--- |
| Phase 1 (Sécurité) | 1 jour | 🟡 Moyenne |
| Phase 2 (Backend/IA) | 2 jours | 🟡 Moyenne |
| Phase 3 (Frontend) | 3 jours | 🔴 Élevée |
| Phase 4 (Qualité) | 2 jours | 🟢 Faible |

**Total estimé : 8 jours de développement.**