TaxActes/docs/planning/PLAN-AGENTS-V1-RAG.md

Plan d'Équipe d'Agents — TaxActe v1 + RAG

Stratégie B : MVP + RAG intégré en 12 semaines Décision : 2026-05-15

---

🎯 Objectif Révisé

Livrer une v1 production-ready avec RAG permettant :

• ✅ Calculs standard (formulaires + IA basique)
• ✅ Calculs complexes guidés par contexte réglementaire (RAG)
• ✅ Pré-taxe automatique pour aide à la taxation notariale
• ✅ Citations légales (Art. X, Art. Y, sources BOFiP)
• ✅ Sécurité auditée, tests E2E, CI/CD, monitoring
• ✅ 2 études pilotes validées avec RAG

Délai : 12 semaines (buffer 14 semaines au pire)

---

📅 Planning Révisé

Phase 0 : Audit (Semaine 1) ✅ TERMINÉE

Livrables complétés :

• ✅ AUDIT-COMPLET.md
• ✅ SECURITY-AUDIT.md
• ✅ TECH-DEBT.md
• ✅ TEST-GAP-ANALYSIS.md
• ✅ RISKS.md

Verdict : Production-ready à 65%, GO Phase 1

---

Phase 1 : Sécurisation (Semaines 2-3) — RÉVISÉ

Objectif : Corriger les 3 vulnérabilités critiques + démarrer préparation RAG

Agent Sécurité (7-8 jours)

• Rate limiting sur login (5 tentatives/15min) — 4-6h
• CSRF protection (sameSite:strict + validation origin) — 3-4h
• Security headers (CSP, HSTS, X-Frame-Options, next.config.ts) — 2-3h
• Validation Zod sur toutes les routes /api/calcul/* — 1-2 jours
• npm audit + correction vulnérabilités — 4h
• Tests sécurité (injection, brute force) — 1 jour

Agent Documentation (5-6 jours) — RÉVISÉ : Focus RAG

• PRIORITÉ : Préparation documents RAG — 4-5 jours
  • Inventorier les documents disponibles — 0.5 jour
  • Convertir Code commerce en Markdown — 1 jour
  • Convertir CGI (Art. 669, 777, 779, 790) en Markdown — 1 jour
  • Convertir BOFiP Droits enregistrement — 1 jour
  • Structurer guides de taxation CSN (chunking préliminaire) — 1.5-2 jours
  • Créer metadata (domaine, article, date effet) — intégré
• RGPD minimal — 1 jour (au lieu de 2-3)
  • Politique de confidentialité (template CNIL) — 4-6h
  • Mention légale footer — 1h
  • Bouton "Supprimer mon compte" — 2-3h dev
  • CGU détaillées → Reporté S11 (optionnel)
  • Validation juriste → Optionnelle (0€)
  • Registre traitements → Pas obligatoire
  • DPO → Pas obligatoire

Agent DevOps (2 jours)

• Installer Sentry (frontend + backend) — 1 jour
• Logs structurés (winston/pino) — 0.5 jour
• Healthcheck endpoint /api/health — 0.5 jour

Checkpoint 2 (fin S3) :

• ✅ 3 vulnérabilités critiques corrigées (rate limiting, CSRF, headers)
• ✅ RGPD minimal : politique confidentialité + mention légale + suppression compte
• ✅ Sentry opérationnel
• ✅ Documents RAG inventoriés et convertis (50%+)

Décision : GO Phase 2

Gain vs estimation initiale : -2 jours (RGPD 1j au lieu de 3j)

---

Phase 2 : Infrastructure + Préparation RAG (Semaines 3-5)

Objectif : CI/CD + Backup + Finaliser documents RAG

Agent DevOps (5 jours)

• GitHub Actions : CI (tests auto sur PR) — 1 jour
• GitHub Actions : CD (déploiement auto sur merge main) — 1 jour
• Backup BDD automatique (daily + test restore) — 1 jour
• PgBouncer configuration validée — 0.5 jour
• Docker compose pour dev local — 0.5 jour
• Activer pgvector sur PostgreSQL — 2h — NOUVEAU

Agent Documentation (5-6 jours) — NOUVEAU

• Finaliser documents RAG — 3-4 jours
  • Chunking des guides de taxation (800 tokens, overlap 100)
  • Extraction metadata (domaine, article, page)
  • Validation cohérence (barèmes non coupés)
  • Création fichiers source (scripts/documents/)
• Validation juridique RGPD (avec juriste) — 2 jours

Agent Architecture (2 jours)

• Optimisation requêtes SQL (indexes) — 1 jour
• Refactoring duplication vente-ancien/vente-ancien-pret — 1 jour

Checkpoint 3 (fin S5) :

• ✅ CI/CD opérationnel
• ✅ Backup auto + restore testé
• ✅ pgvector activé sur PostgreSQL
• ✅ Documents RAG finalisés (100%) — CRITIQUE
• ✅ RGPD validé par juriste

Décision : GO Phase 3 (avec RAG)

---

Phase 3 : Tests E2E + Implémentation RAG (Semaines 5-7) — MODIFIÉ

Objectif : Tests critiques + RAG fonctionnel

Agent Tests (10 jours — sur S5-S7)

Tests E2E (Playwright) — 5-6 jours :

• Setup Playwright + premier test — 1 jour
• E2E : Register → Login → Dashboard — 1 jour
• E2E : Calcul vente + export PDF — 1 jour
• E2E : Chat IA → calcul → export — 1 jour
• E2E : Admin (gestion utilisateurs) — 0.5 jour
• E2E : Erreurs (session expirée, calcul invalide) — 0.5 jour

Tests unitaires critiques — 3 jours :

• Tests auth.ts (JWT, sessions, cookies) — 1 jour
• Tests middleware.ts (protection routes) — 0.5 jour
• Tests bareme.ts (barèmes officiels) — 1 jour
• Tests vente-ancien-pret.ts (calcul combiné) — 0.5 jour

Tests intégration API — 2 jours :

• Tests API auth (login, register, logout, session) — 1 jour
• Tests API calculs (7 modules) — 1 jour

Agent Architecture (5 jours) — NOUVEAU RAG

• Créer module RAG — 3 jours
  • src/lib/rag/embeddings.ts (Scaleway AI ou OpenAI)
  • src/lib/rag/search.ts (recherche vectorielle pgvector)
  • src/lib/rag/ingest.ts (pipeline chunking + embedding)
  • src/lib/rag/prompt-builder.ts (construction prompt augmenté)
  • Schéma Prisma DocumentChunk + index vectoriel
• Étendre /api/ai/chat avec RAG — 1 jour
  • Recherche chunks pertinents avant LLM
  • Injection contexte dans prompt
  • Affichage sources citées dans réponse
• Script d'ingestion — 1 jour
  • scripts/ingest-documents.ts (CLI)
  • Ingestion des documents préparés (S2-S5)
  • Tests ingestion (10K chunks)

Agent Features (2 jours)

• UI : Affichage sources citées (badges avec Art. X) — 1 jour
• UI : Badge "Calcul assisté par IA" pour Mode B — 0.5 jour
• API : Routes RAG (search, ingest, documents) — 0.5 jour

Checkpoint 4 (fin S7) :

• ✅ 12 tests E2E critiques passent
• ✅ Tests unitaires auth + bareme passent
• ✅ RAG fonctionnel (pgvector + pipeline + recherche) — CRITIQUE
• ✅ 10K chunks ingérés dans PostgreSQL
• ✅ Chat IA avec contexte réglementaire opérationnel

Décision : GO Phase 4

---

Phase 4 : Features MVP + Tests RAG (Semaines 7-8)

Objectif : Compléter features essentielles + valider RAG

Agent Features (8 jours)

• Email Resend intégration — 2 jours
  • Configuration Resend
  • Template email estimation
  • Email invitation utilisateur
• Invitations utilisateurs — 1.5 jours
  • Flow invitation (lien sécurisé + expiration)
  • Onboarding nouvel utilisateur
• Reset password flow — 1 jour
• Gestion dossiers avancée — 1.5 jours
  • Modification dossier existant
  • Export multi-dossiers (CSV)
  • Archivage (soft delete)
• UX polish — 2 jours
  • Messages d'erreur explicites
  • États de chargement (spinners)
  • Validation formulaires temps réel
  • Responsive mobile

Agent Tests (5 jours) — NOUVEAU RAG

• Tests RAG — 3 jours
  • Tests précision recherche (top 5 chunks pertinents)
  • Tests latence (< 5s total pour réponse)
  • Tests cas complexes (donation-partage, succession démembrée)
  • Tests citations (sources correctes)
  • Tests Mode A (guardrail) vs Mode B (assisté)
• Tests intégration dossiers — 1 jour
• Tests isolation multi-office (sécurité) — 1 jour

Checkpoint 5 (fin S8) :

• ✅ Email envoyé en production
• ✅ Invitations fonctionnelles
• ✅ RAG validé sur 10+ cas complexes
• ✅ Tests RAG passent (précision + latence)

Décision : GO Phase 5

---

Phase 5 : Documentation (Semaine 9)

Objectif : Documentation utilisateur + API

Agent Documentation (5 jours)

• Guide utilisateur — 2 jours
  • Section : Calculs standard (formulaires)
  • Section : Assistant IA (chat)
  • Section : Actes complexes avec RAG — NOUVEAU
  • Section : Pré-taxe automatique (usage interne) — NOUVEAU
  • Screenshots annotés
• FAQ — 1 jour
  • 20 questions top (dont 5 sur le RAG)
  • Réponses validées
• Tutoriel vidéo — 1 jour
  • Vidéo onboarding (3 min)
  • Vidéo démo RAG (cas donation-partage) — NOUVEAU
• API documentation (OpenAPI) — 1 jour

Agent Features (2 jours)

• Tooltips in-app (aide contextuelle) — 1 jour
• Tour guidé onboarding (intro.js) — 1 jour

Checkpoint 6 (fin S9) :

• ✅ Guide utilisateur complet avec RAG
• ✅ FAQ + vidéos tutoriels
• ✅ API docs (OpenAPI spec)

Décision : GO Phase 6

---

Phase 6.5 : CGU & Disclaimer (Avant Pilotes S11) — 1 jour optionnel

Objectif : Protection juridique avant pilotes

Agent Documentation (1 jour)

• CGU simplifiées (template gratuit) — 4-6h
• Disclaimer juridique calculs (modal + PDF) — 1h
• Validation juriste CGU — Optionnelle (500-1000€ si souhaité)

Note : Reporté depuis Phase 1 (pas bloquant MVP)

---

Phase 6 : Optimisation + Tests de Charge (Semaine 10)

Objectif : Performance + scalabilité

Agent Architecture (3 jours)

• Cache résultats calculs (optionnel Redis) — 1 jour
• Compression assets (gzip/brotli) — 0.5 jour
• Lazy loading modules IA — 1 jour
• Lighthouse score > 90 — 0.5 jour

Agent Tests (2 jours)

• Tests de charge RAG — 1 jour — NOUVEAU
  • 10 requêtes RAG simultanées (latence < 5s)
  • 100 recherches vectorielles/min (pgvector)
• Tests de charge calculs — 1 jour
  • 50 calculs/s pendant 5 min
  • Latence < 200ms p95

Agent DevOps (2 jours)

• Alertes : erreurs > 10/h — 0.5 jour
• Alertes : uptime < 99% — 0.5 jour
• Alertes : latence > 500ms p95 — 0.5 jour
• Budget alerts (coûts cloud) — 0.5 jour

Checkpoint 7 (fin S10) :

• ✅ Performance optimisée (Lighthouse > 90)
• ✅ Tests de charge RAG passent
• ✅ Monitoring alertes configurées

Décision : GO Phase 7

---

Phase 7 : Launch Readiness (Semaines 11-12)

Objectif : 2 études pilotes + validation finale

Semaine 11 : Pilote 1

Agent Chef de Projet :

• Onboarding étude pilote 1 — 1 jour
• Formation (avec démonstration RAG) — 0.5 jour
• Collecte feedback quotidienne — toute la semaine
• Tests cas complexes réels (avec RAG) — NOUVEAU

Agent Features :

• Hotfixes si nécessaire — selon feedback

Agent Tests :

• Validation conformité calculs (vs Notafrais) — continu

Semaine 12 : Pilote 2 + Validation

Agent Chef de Projet :

• Onboarding étude pilote 2 — 1 jour
• Collecte feedback (avec focus RAG) — toute la semaine
• Validation expert notarial (calculs + RAG) — 1 jour
• Go-live checklist — 1 jour

Agent DevOps :

• Backup avant déploiement — automatique
• Plan de rollback testé — 0.5 jour
• Monitoring actif — continu

Agent Documentation :

• Support : email/chat configuré — 0.5 jour
• SLA défini — 0.5 jour

Checkpoint FINAL (fin S12) :

• ✅ 2 études pilotes satisfaites (feedback > 8/10)
• ✅ Validation RAG sur 5+ cas complexes réels — CRITIQUE
• ✅ Expert notarial : sign-off obtenu
• ✅ 0 bug critique
• ✅ Go-live checklist 100%

Décision : LANCEMENT v1 🚀

---

🤖 Agents et Responsabilités

Agent Chef de Projet

• Coordination globale
• Validation checkpoints (GO/NO-GO)
• Gestion pilotes
• Communication client

Agent Sécurité

• Phase 1 : Sécurisation (rate limiting, CSRF, headers, Zod)
• Tests sécurité

Agent Architecture

• Phase 2 : Optimisation SQL, refactoring
• Phase 3 : Implémentation RAG (module complet) — NOUVEAU
• Phase 6 : Performance

Agent Tests

• Phase 3 : Tests E2E + unitaires + intégration
• Phase 4 : Tests RAG (précision, latence, cas complexes) — NOUVEAU
• Phase 6 : Tests de charge (calculs + RAG)

Agent DevOps

• Phase 1 : Sentry + logs
• Phase 2 : CI/CD + backup + pgvector
• Phase 6 : Alertes
• Phase 7 : Monitoring production

Agent Features

• Phase 3 : UI RAG (sources citées, badges)
• Phase 4 : Email, invitations, UX polish
• Phase 5 : Tooltips, tour guidé
• Phase 7 : Hotfixes pilotes

Agent Documentation

• Phase 1-2 : Préparation documents RAG — NOUVEAU
• Phase 1 : RGPD (politique, CGU, disclaimer)
• Phase 5 : Guide utilisateur (avec section RAG)
• Phase 5 : FAQ + vidéos tutoriels

---

📊 Métriques de Succès

Qualité du Code

• ✅ Tests : coverage > 80%
• ✅ Tests E2E : 12+ passants
• ✅ Linting : 0 erreurs ESLint
• ✅ Security : 0 vulnérabilités critiques
• ✅ Tests RAG : 10+ cas complexes validés — NOUVEAU

Performance

• ✅ Temps de calcul : < 200ms (p95)
• ✅ Latence RAG : < 5s (recherche + LLM) — NOUVEAU
• ✅ Time to interactive : < 3s
• ✅ Lighthouse score : > 90
• ✅ Uptime : > 99%

Conformité Métier

• ✅ Calculs : ±0.50€ vs Notafrais
• ✅ Barèmes : Code de commerce 2026 à jour
• ✅ RAG : Citations correctes (Art. X, Art. Y) — NOUVEAU
• ✅ Validation expert notarial : sign-off obtenu

UX

• ✅ Onboarding : < 5 min pour 1er calcul
• ✅ Responsive : fonctionne sur mobile
• ✅ Accessibilité : WCAG 2.1 niveau AA
• ✅ Aide RAG : cas complexes < 10 min — NOUVEAU

---

🚨 Risques Spécifiques RAG

Risque	Probabilité	Impact	Mitigation
Documents RAG non prêts à S4-S5	Faible	Critique	✅ Démarrage S2, validation S3
Chunks mal découpés (barèmes coupés)	Moyenne	Moyen	Chunking par section/article
Hallucination malgré le contexte	Faible	Moyen	Guardrail (fonction pure) quand disponible
Latence RAG > 5s	Moyenne	Moyen	Cache embeddings questions fréquentes
Précision recherche < 80%	Faible	Moyen	Re-ranking + ajustement nb chunks
Coût LLM (prompts longs)	Faible	Faible	Limiter à 5 chunks max (~4000 tokens)

---

🎯 Critères GO/NO-GO par Checkpoint

Checkpoint 2 (S3) — Sécurisation

• ✅ 4 vulnérabilités critiques corrigées
• ✅ Sentry opérationnel
• ✅ Documents RAG 50%+ convertis — CRITIQUE

Checkpoint 3 (S5) — Infrastructure

• ✅ CI/CD opérationnel
• ✅ Documents RAG 100% finalisés — CRITIQUE BLOQUANT
• ✅ pgvector activé

Checkpoint 4 (S7) — Tests + RAG

• ✅ 12 tests E2E passent
• ✅ RAG fonctionnel (10K chunks ingérés) — CRITIQUE BLOQUANT

Checkpoint 5 (S8) — Features

• ✅ Email + invitations OK
• ✅ RAG validé sur 10+ cas complexes — CRITIQUE

Checkpoint FINAL (S12) — Launch

• ✅ 2 études pilotes satisfaites
• ✅ Validation RAG sur cas réels — CRITIQUE
• ✅ Expert notarial : sign-off

---

⏱️ Buffer et Plan B

Buffer : 2 semaines

Si retard > 1 semaine sur un checkpoint :

• Analyser la cause
• Si bloqué sur RAG (documents, précision) : PIVOT vers Stratégie A
  • Reporter RAG en v1.1 (3 semaines post-MVP)
  • Finir MVP classique en 10 semaines

Stratégie de Repli

En cas de retard critique sur le RAG :

1. S8 : Décision pivot si RAG non fonctionnel
2. Reporter RAG en v1.1
3. Livrer MVP classique (sans RAG) en S10
4. RAG en S11-S13

---

📅 Calendrier

2026-05-15 (S1)  : Audit ✅
2026-05-19 (S2)  : Début Phase 1 (Sécurisation + Prépa RAG)
2026-05-26 (S3)  : Checkpoint 2 → GO Phase 2
2026-06-02 (S4)  : Infrastructure + Finalisation docs RAG
2026-06-09 (S5)  : Checkpoint 3 → GO Phase 3 (RAG DOIT ÊTRE PRÊT)
2026-06-16 (S6)  : Tests E2E + Implémentation RAG
2026-06-23 (S7)  : Checkpoint 4 → GO Phase 4
2026-06-30 (S8)  : Features + Tests RAG → Checkpoint 5
2026-07-07 (S9)  : Documentation
2026-07-14 (S10) : Optimisation + Tests charge
2026-07-21 (S11) : Pilote 1
2026-07-28 (S12) : Pilote 2 + Validation finale
2026-08-04       : 🚀 LANCEMENT v1 + RAG

Buffer : jusqu'au 2026-08-18 (+2 semaines)

---

Prochaine étape : Assigner les tâches Phase 1 (S2) aux agents ! 🚀