Suite IA financière multi-agents avec RAG optimisé, orchestration intelligente et support multilingue

AI CFO Suite Phoenix est une solution de classe entreprise pour l'analyse financière automatisée, combinant :

• 🧠 6 agents IA spécialisés (Comptabilité, Fiscalité, Prévisions, Conformité, Audit, Rapports)
• 🌍 Support multilingue (Français, Anglais)
• 🌎 Multi-juridictions (Canada, Québec, Ontario, France, USA)
• 🤖 10+ modèles LLM via OpenRouter (GPT-4, Claude 3, Gemini, Mixtral, Llama 3)
• 📚 RAG haute performance (fichiers jusqu'à 600 MB)
• 🎯 MetaOrchestrator pour routing intelligent
• 🔒 Sécurité renforcée (chiffrement, JWT)
• 📈 Monitoring temps réel

• 🇫🇷 Français (par défaut)
• 🇬🇧 Anglais
• Interface utilisateur complète
• Prompts agents adaptés
• Sélecteur de langue intégré

• ✅ Fichiers jusqu'à 600 MB
• ✅ Traitement parallèle (8 threads + 4 processus)
• ✅ Chunking adaptatif (512-2048 tokens)
• ✅ Vectorisation par lots (100 chunks/batch)
• ✅ Réassemblage intelligent avec contexte
• ✅ Performance 10x supérieure

• Routing intelligent basé sur l'intent
• Sélection d'agent selon performance, juridiction, disponibilité
• Fallback automatique si échec
• Collaboration multi-agents pour requêtes complexes
• Validation de cohérence entre réponses

• Docker & Docker Compose
• Clé API OpenRouter (obtenir ici)

# 1. Cloner le repository
git clone https://github.com/zakibelm/ai-cfo-suite-phoenix.git
cd ai-cfo-suite-phoenix

# 2. Configurer l'environnement
cd backend
cp .env.example .env

# Éditer .env et ajouter votre clé OpenRouter
nano .env
# OPENROUTER_API_KEY=sk-or-v1-...

# 3. Lancer les services
cd ..
docker-compose up -d

# 4. Initialiser les agents par défaut
curl -X POST http://localhost:8000/api/v1/agents/init-defaults

# 5. Accéder à l'application
# Frontend: http://localhost:3000
# API Docs: http://localhost:8000/docs

import requests

response = requests.post(
    "http://localhost:8000/api/v1/meta/query",
    json={
        "query": "Quelles sont mes obligations fiscales au Québec pour 2025?",
        "jurisdiction": "CA-QC",
        "language": "fr",
        "model": "gpt-4-turbo"
    }
)

result = response.json()
print(f"Agent: {result['meta']['selected_agent']}")
print(f"Réponse: {result['response']}")

files = {"file": open("rapport_annuel.pdf", "rb")}
data = {
    "document_id": "rapport_2024",
    "country": "CA",
    "province": "QC",
    "async_processing": True  # Recommandé pour gros fichiers
}

response = requests.post(
    "http://localhost:8000/api/v1/optimized-ingestion/upload-large",
    files=files,
    data=data
)

print(response.json())

response = requests.post(
    "http://localhost:8000/api/v1/meta/collaborate",
    json={
        "query": "Analyse complète: comptabilité, fiscalité, prévisions",
        "agent_ids": ["AccountantAgent", "TaxAgent", "ForecastAgent"],
        "language": "fr",
        "model": "gpt-4-turbo"
    }
)

result = response.json()
print(result["response"])  # Synthèse complète

┌─────────────────────────────────────────────────────────┐
│                    Frontend (React)                      │
│  - Interface multilingue (FR/EN)                         │
│  - Sélecteur de modèles LLM                             │
│  - Dashboard monitoring                                  │
└─────────────────────────────────────────────────────────┘
                           ↓
┌─────────────────────────────────────────────────────────┐
│                  Backend (FastAPI)                       │
│  ┌─────────────────────────────────────────────────┐   │
│  │         MetaOrchestrator                         │   │
│  │  - Analyse d'intent                              │   │
│  │  - Routing intelligent                           │   │
│  │  - Fallback automatique                          │   │
│  └─────────────────────────────────────────────────┘   │
│                           ↓                              │
│  ┌─────────────────────────────────────────────────┐   │
│  │           Agents IA Spécialisés                  │   │
│  │  • TaxAgent         • ForecastAgent              │   │
│  │  • AccountantAgent  • ComplianceAgent            │   │
│  │  • AuditAgent       • ReporterAgent              │   │
│  └─────────────────────────────────────────────────┘   │
│                           ↓                              │
│  ┌─────────────────────────────────────────────────┐   │
│  │         Services                                 │   │
│  │  • OpenRouter (LLM multi-modèles)                │   │
│  │  • OptimizedRAG (600 MB, parallèle)              │   │
│  │  • i18n (FR/EN)                                  │   │
│  │  • Monitoring                                    │   │
│  │  • Security (Chiffrement, JWT)                   │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘
                           ↓
┌─────────────────────────────────────────────────────────┐
│              Infrastructure (Docker)                     │
│  • PostgreSQL (base de données)                          │
│  • Qdrant (vector store)                                 │
│  • Redis (cache)                                         │
│  • MinIO (object storage)                                │
└─────────────────────────────────────────────────────────┘

• FastAPI - Framework web moderne
• LlamaIndex - RAG et indexation
• CrewAI - Orchestration d'agents
• Qdrant - Base de données vectorielle
• PostgreSQL - Base de données relationnelle
• Redis - Cache et sessions
• MinIO - Stockage d'objets
• OpenRouter - Accès multi-modèles LLM

• React 18 - Framework UI
• TypeScript - Typage statique
• Vite - Build tool
• Tailwind CSS - Styling
• GSAP - Animations

• Docker - Conteneurisation
• Docker Compose - Orchestration
• Nginx - Reverse proxy

• Sans optimisation : Linéaire (crash à 600 MB)
• Avec optimisation : Constante (~600 MB max)
• Gain : 16x moins de mémoire

• ✅ Chiffrement Fernet pour secrets SSH
• ✅ JWT Authentication (structure prête)
• ✅ Hashing bcrypt pour mots de passe
• ✅ Validation Pydantic des entrées
• ✅ CORS configuré
• ✅ Secrets en variables d'environnement

# Backend
cd backend
pytest

# Avec couverture
pytest --cov=. --cov-report=html

# Tests spécifiques
pytest tests/test_openrouter.py
pytest tests/test_meta_orchestrator.py
pytest tests/test_optimized_rag.py

35+ tests automatisés couvrant :

• Agents
• Services
• API endpoints
• RAG
• i18n

Dashboard temps réel accessible à /monitoring :

• ✅ État de santé du système
• ✅ Métriques par agent (requêtes, erreurs, temps)
• ✅ Connexions SSH (latence, succès)
• ✅ Circuit breakers
• ✅ Auto-refresh configurable

• Support UK, DE, NL, BE
• Traduction dynamique de documents
• Export PDF/DOCX/XLSX
• Templates de rapports

• JWT Authentication complète
• RBAC (rôles et permissions)
• Multi-tenancy
• Audit trail complet
• Prometheus + Grafana

• Fine-tuning par juridiction
• Agent Marketplace
• Mobile app (iOS/Android)
• Intégration ERP
• Blockchain audit trail

Les contributions sont les bienvenues ! Consultez CONTRIBUTING.md pour les guidelines.

Ce projet est sous licence MIT. Voir LICENSE pour plus de détails.

Développé avec expertise par l'équipe Phoenix.

• Documentation : docs/
• Issues : GitHub Issues
• Discussions : GitHub Discussions

• OpenRouter - Accès multi-modèles LLM
• LlamaIndex - Framework RAG
• CrewAI - Orchestration d'agents
• FastAPI - Framework web
• React - Framework UI