Feuille de route d'implémentation
English version: ../en/roadmap.md
Douze phases livrent les 8 briques (A identité et gouvernance, B gestion des LLM, C agents et exécution, D outils et intégrations, E données, RAG et mémoire, F multimodal, G qualité, observabilité et audit, H FinOps, infrastructure et exploitation). Pages des briques : docs/fr/bricks/.
| Phase | Priorité | Périmètre | Briques |
|---|---|---|---|
| 1 | critique | Contrats, architecture, identité, tenants, politiques | A-01..A-14, G-11, H-06, H-07, H-10, H-16 |
| 2 | critique | LiteLLM, vLLM, fournisseurs, registre de modèles, quotas | B-01..B-07, B-09..B-11, B-14, H-01, H-02, H-03 |
| 3 | critique | Runtime d'agents, SDK Python, tool gateway, MCP | C-01..C-04, C-06..C-08, C-11..C-14, D-01..D-04, D-14 |
| 4 | critique | DLP, chiffrement, tokenisation, ACL RAG | E-01..E-04, E-06..E-08, E-11..E-13 |
| 5 | critique | OpenTelemetry, Opik, audit, ClickHouse | G-01..G-08, G-11, G-12, G-14 |
| 6 | haute | Quality gates, Promptfoo, Ragas, red teaming | B-12, G-09, G-10, G-13, H-15 |
| 7 | haute | Skills, plugins, connecteurs, canaux | D-05..D-13, H-12, H-13 |
| 8 | haute | Contexte, mémoire, sous-agents, exécution durable | B-08, C-05, C-09, C-10, C-15, E-09, E-10 |
| 9 | haute | Vision, images, documents, STT, TTS, voix temps réel | F-01, F-02, F-05..F-12, E-05 |
| 10 | haute | Vidéo, génération multimodale, ordonnancement GPU | F-03, F-04, B-13, H-04, H-05 |
| 11 | critique avant production | HA, PRA, tests de charge, sécurité, conformité | H-06..H-16, A-13, A-14, G-11, G-12 |
| 12 | continue | FinOps avancée, optimisation, amélioration de la qualité | H-01..H-04, B-09..B-11, G-04, G-07, G-09 |
Règle : les exigences de la phase 11 s'appliquent dès la phase 1
La phase 11 est la porte de production, pas le moment où commencent la sécurité et la résilience. Dès la phase 1, chaque livrable respecte déjà :
- l'isolation des tenants (RLS), des rôles et scopes au moindre privilège, des secrets uniquement dans OpenBao, aucun secret dans les journaux ;
- l'audit chaîné de chaque mutation et décision de politique ;
- des services sans état avec sondes, PDB, limites de ressources et au moins 2 réplicas dans le chart Helm ;
- des migrations et API idempotentes (Idempotency-Key), une organisation des données prête pour la sauvegarde ;
- des images construites en CI, analysées (Trivy), avec SBOM (Syft), signées (Cosign), tirées de Harbor par empreinte ;
- l'instrumentation OpenTelemetry et des Usage Events pour tout ce qui coûte ;
- des erreurs et textes d'interface bilingues (en/fr), sans tiret cadratin ni demi-cadratin.
La phase 11 prouve ensuite ces propriétés à l'échelle (charge, chaos, exercice de PRA, test d'intrusion, preuves de conformité).
Phase 1 : Contrats, architecture, identité, tenants, politiques (critique)
Livrables. 15 contrats JSON Schema v1, API Control Plane v1, OIDC Keycloak, clés API, identités SPIFFE, tenants/projets/environnements avec RLS PostgreSQL, moteur de politiques (OPA/OpenFGA avec repli intégré), approbations, audit chaîné, secrets dans OpenBao, squelette du chart Helm.
Briques. A-01..A-14, G-11, H-06, H-07, H-10, H-16
Critères de sortie. Chaque contrat validé en CI ; lecture inter-tenant impossible (test RLS) ; chaque mutation auditée et GET /v1/audit/verify valide ; décisions de politique enregistrées avec id de décision.
Phase 2 : LiteLLM, vLLM, fournisseurs, registre de modèles, quotas (critique)
Livrables. Registre des fournisseurs (16+), registre des modèles et statuts, Capability Resolver, Model Router avec fallbacks, génération de la configuration LiteLLM, déploiements vLLM, endpoints du gateway, estimation, service de quotas avec réservations Redis, cartes tarifaires et Usage Events.
Briques. B-01..B-07, B-09..B-11, B-14, H-01, H-02, H-03
Critères de sortie. Tous les appels de modèles passent par les endpoints du gateway (/v1/gateway/chat/completions et suivants) ; la coupure d'un fournisseur prend effet en moins de 30 s ; des appels parallèles ne dépassent jamais un quota ; chaque appel produit un Usage Event avec coût estimé et mesuré.
Phase 3 : Runtime d'agents, SDK Python, tool gateway, MCP (critique)
Livrables. Registre d'agents et runs (Execution Contract), étapes, checkpoints, heartbeats, exécutions sandbox, Tool Gateway avec scopes/politique/DLP/approbation, gateway MCP, première version du SDK Python et de la CLI.
Briques. C-01..C-04, C-06..C-08, C-11..C-14, D-01..D-04, D-14
Critères de sortie. Un agent de référence s'exécute de bout en bout depuis le SDK avec outils et MCP, peut être suspendu et arrêté, et chaque appel d'outil est contrôlé par politique et audité.
Phase 4 : DLP, chiffrement, tokenisation, ACL RAG (critique)
Livrables. Classification, DLP texte (Presidio + détecteurs français), tokenisation et détokenisation sous politique, chiffrement d'enveloppe avec OpenBao, bases de connaissances avec recherche respectant les ACL (Qdrant), rétention et effacement, lignage.
Briques. E-01..E-04, E-06..E-08, E-11..E-13
Critères de sortie. Aucune PII n'atteint un fournisseur externe si la politique l'interdit ; un utilisateur ne récupère jamais un fragment qu'il ne peut pas lire à la source ; demande d'effacement exécutée et prouvée.
Phase 5 : OpenTelemetry, Opik, audit, ClickHouse (critique)
Livrables. Traçage OTel et pipeline du collecteur, traçage IA Opik, analytique ClickHouse, Prometheus, OpenSearch (journaux), Jaeger, Alertmanager, export d'audit WORM, corrélation d'audit, Wazuh et transfert SIEM.
Briques. G-01..G-08, G-11, G-12, G-14
Critères de sortie. Une trace par requête sur les chemins synchrones et asynchrones ; export d'audit stocké avec Object Lock ; tableaux de bord coût, latence et erreurs par tenant ; alertes routées avec runbooks.
Phase 6 : Quality gates, Promptfoo, Ragas, red teaming (haute)
Livrables. Suites et runs d'évaluation (Ragas, Promptfoo), runs de red team (garak), orchestrateur qualité avec gates bloquantes en CI et avant promotion en prod.
Briques. B-12, G-09, G-10, G-13, H-15
Critères de sortie. Aucune version d'agent ou de prompt n'atteint la prod sans preuves récentes d'évaluation et de red team ; les dérogations exigent une approbation.
Phase 7 : Skills, plugins, connecteurs, canaux (haute)
Livrables. Skills signées et Skill Loader, cycle de vie des plugins, connecteurs avec Credential Broker et webhooks, canaux (web, Teams, Slack, téléphonie).
Briques. D-05..D-13, H-12, H-13
Critères de sortie. Skills non signées refusées ; identifiants de connecteurs jamais lisibles ; messages entrants des canaux transformés en runs avec identité.
Phase 8 : Contexte, mémoire, sous-agents, exécution durable (haute)
Livrables. Budgets et compression du Context Manager, contrat de mémoire, sous-agents avec limites de profondeur, messages A2A, runs durables (checkpoints PostgreSQL, AgentLoop.resume) et planifications exécutées par python -m eai.worker, avec un adaptateur Temporal optionnel.
Briques. B-08, C-05, C-09, C-10, C-15, E-09, E-10
Critères de sortie. Les runs longs survivent au redémarrage d'un worker grâce aux checkpoints ; context_overflow n'atteint jamais un fournisseur ; limites des sous-agents appliquées.
Phase 9 : Vision, images, documents, STT, TTS, voix temps réel (haute)
Livrables. Service média, vision, génération et édition d'images, STT (faster-whisper), diarisation (pyannote), TTS (Piper), VAD (Silero), voix temps réel (LiveKit), streaming audio, DLP multimodale.
Briques. F-01, F-02, F-05..F-12, E-05
Critères de sortie. Latence p95 de la voix temps réel sous 800 ms ; tous les médias analysés, classifiés et contrôlés par DLP ; Usage Events pour images, secondes audio, caractères et sessions.
Phase 10 : Vidéo, génération multimodale, ordonnancement GPU (haute)
Livrables. Traitement vidéo (FFmpeg/PyAV), workers GPU de génération vidéo, pools GPU avec KEDA, comptabilité GPU basée sur DCGM et politiques d'allocation.
Briques. F-03, F-04, B-13, H-04, H-05
Critères de sortie. Les pools GPU descendent à zéro quand ils sont inactifs ; chaque seconde GPU locale est imputée à un tenant ; les jobs vidéo reprennent après préemption.
Phase 11 : HA, PRA, tests de charge, sécurité, conformité (critique avant production)
Livrables. Haute disponibilité de chaque composant avec état, sauvegarde et PRA (Velero, PITR) avec exercices, tests de charge et d'endurance, test d'intrusion, analyse des images, SBOM, signature, politiques d'admission, GitOps, IaC, preuves de conformité (correspondance AI Act, RGPD, ISO 27001).
Briques. H-06..H-16, A-13, A-14, G-11, G-12
Critères de sortie. RPO et RTO tenus lors d'un exercice ; test de charge au débit cible avec SLO au vert ; aucune vulnérabilité critique ; uniquement des images signées ; dossier de preuves exporté.
Phase 12 : FinOps avancée, optimisation, amélioration de la qualité (continue)
Livrables. Rapprochement avec les factures, alertes d'écart, refacturation, routage vers des modèles moins chers sous contrainte de qualité, optimisation du cache de prompts, revues de tendances qualité.
Briques. H-01..H-04, B-09..B-11, G-04, G-07, G-09
Critères de sortie. Écart mesuré / facturé sous le seuil chaque mois ; coût par tâche réussie en baisse à qualité constante.
Déjà implémenté dans ce dépôt
État vérifié dans l'arborescence de travail le 2026-10-29 (vue servie par GET /v1/roadmap et GET /v1/catalog/bricks). Les exigences de la phase 11 s'appliquent dès la phase 1 : chaque élément ci-dessous est déjà livré avec RLS, audit chaîné, i18n en/fr, sondes et limites de ressources dans le chart.
| Phase | Implémenté |
|---|---|
| 1 | contracts/v1 (15 contrats + common), contracts/validate.py et contracts/tests ; domaines system, contracts, identity, tenancy, authz, policies, approvals, secrets, governance, risk, incidents ; migrations sql/postgres/V001 à V011 ; écrans portail admin/*, security/*, audit/* ; deploy/keycloak, deploy/policies (OPA avec tests, OpenFGA, Kyverno), deploy/openbao, deploy/spire, deploy/cert-manager, chart Helm |
| 2 | Domaines llm (providers, modèles, routes, résolveur, contexte, gateway, vLLM, LiteLLM) et finops (prix, usage, quotas, GPU, rapprochement, alertes) ; migrations V020 à V035 ; écrans llm/*, finops/* ; deploy/litellm, valeurs vllm et litellm du chart |
| 3 | Domaines agents, tools, mcp ; runtime Navin du SDK Python (enterprise_ai.loop.AgentLoop, enterprise_ai.runtime.AgentRunner, enterprise_ai.subagents.SubagentManager, enterprise_ai.loop.plan.RunPlan, enterprise_ai.runtime.bus.MessageBus) et CLI enterprise-ai ; worker python -m eai.worker ; migrations V040 à V042 ; écrans agents/*, capabilities/tools, capabilities/mcp ; sandbox (classes gVisor et Kata) |
| 4 | Domaines privacy (classification, DLP, tokenisation, chiffrement), knowledge, retention, lineage ; migrations V060 à V063 ; écrans data/* ; adaptateurs Presidio, Qdrant, OpenBao transit |
| 5 | Domaines observability et audit (export, vérification, corrélations) ; sql/clickhouse ; deploy/observability (OTel Collector, Prometheus, OpenSearch, Jaeger, Opik, Alertmanager), deploy/wazuh ; migration V065 |
| 6 | Domaine evaluation (suites, runs, gates, red team) avec adaptateurs Ragas, Promptfoo, garak ; deploy/ci ; écrans quality/* |
| 7 | Domaines skills, plugins, connectors, channels ; écrans capabilities/* |
| 8 | Domaines memory, prompts, sessions, A2A, planifications et triggers (tick et outbox dans eai.worker) ; migration V062 |
| 9 et 10 | Domaines multimodal et realtime (vision, image, vidéo, STT, diarisation, TTS, LiveKit) ; migration V064 ; écrans multimodal/* ; deploy/keda, deploy/docker/worker.Dockerfile |
| 11 | deploy/velero, deploy/terraform, deploy/argocd, deploy/gitops, deploy/cilium, deploy/loadtest (k6), values-prod.yaml, docs/operations (HA/PRA, durcissement, runbooks, préparation phase 11) |
| 12 | Grilles tarifaires de référence (V035), rapprochement et alertes d'écart |
SDK : Python (sdks/python), TypeScript (sdks/typescript/packages/sdk et realtime), Java (sdks/java, module Spring inclus), Go (sdks/go, paquets realtime, worker, gatewaymw, usage) ; ils couvrent les chemins de docs/api/control-plane-v1.md.
Reste à faire avant la production
- Tests d'intégration contre de vrais déploiements de Keycloak, OpenBao, OpenFGA, Qdrant, NATS, Temporal, LiveKit, LiteLLM et vLLM (aujourd'hui les tests utilisent un PostgreSQL réel et les replis en processus des adaptateurs).
- Exécution des tests de charge de
deploy/loadtestau débit cible, avec SLO mesurés. - Test d'intrusion externe.
- Vérification des grilles tarifaires de référence (
V035__finops_seed_reference_prices.sql) contre les listes de prix officielles des fournisseurs. - Exercice de PRA (restauration Velero et PITR PostgreSQL) avec RPO et RTO mesurés.
Pages des briques F, G, H
Voir docs/fr/bricks/F-*.md, G-*.md, H-*.md. Les règles de coût (estimé, mesuré, facturé) sont détaillées dans H-02 registre des coûts et H-03 moteur de tarification.