# Aethas38 - Multi-IA Orchestrateur (Minecraft-Tech Edition) Plateforme SaaS d'IA modulaire : Orchestrateur local, routeur intelligent, sécurisé et facturable[cite: 13]. **Architecture réseau :** Déploiement via Docker derrière Nginx Proxy Manager (NPM) sur `https://ia.votre-domaine.com`[cite: 13]. Timeout proxy ajusté à 300s pour le calcul lourd[cite: 13]. ## 📜 Licence & Droits d'Utilisation (EULA) Ce projet est distribué sous une licence "Source Available" propriétaire (EULA) rédigée par Xavier Fernandez (Aethas38)[cite: 13]. * **Modifications & Partage :** Les utilisateurs sont autorisés à modifier et améliorer le code, à condition de partager ces améliorations avec la communauté[cite: 13]. * **Restrictions strictes :** Il est **strictement interdit** de modifier ou supprimer les crédits de l'auteur originel, de retirer le module de dons dédié au créateur, ou de désactiver la télémétrie de sécurité[cite: 13]. L'installation requiert l'acceptation explicite de ces termes[cite: 13]. * **Donations obligatoires :** Le système intègre nativement deux modules de dons[cite: 13]. L'un est modifiable par l'hébergeur du projet[cite: 13]. L'autre (marqué "Soutenir le créateur de ce projet") est inaltérable et relié directement au créateur originel[cite: 13]. ## ⚠️ Pré-requis Matériels (Important) Pour fonctionner de manière optimale, l'Orchestrateur Local nécessite au minimum **une carte graphique avec 4 Go de VRAM dédiée** (ex: GTX 1650)[cite: 13]. Il est possible de configurer l'application pour utiliser le CPU, mais les performances seront considérablement réduites[cite: 13]. **L'auteur décline toute responsabilité en cas de surcharge matérielle liée à une utilisation CPU intensive[cite: 13].** ## 📋 To-Do List (Roadmap) ### Phase 1 & 2 : Infrastructure & Backend de Base ✅ - [x] Installation Docker, Nginx (NPM), Pare-feu, Gitea/GitHub[cite: 13] - [x] Serveur Local Ollama (Abliterated 3B) + FastHTML[cite: 13] - [x] Routeur Multi-IA (OpenRouter, Gemini, Local) avec système de cascade et directives d'aiguillage strictes[cite: 13] - [x] Continuité de service : IA de secours automatique et Timeout à 300s[cite: 13]. ### Phase 3 : Refonte UI & Expérience Utilisateur ✅ - [x] Thème "Minecraft-Tech" (Inspiré serveurs/redstone) compatible Mobile (Responsive / Contraste OLED élevé)[cite: 13] - [x] Historique (Sidebar) avec Renommage, Épinglage, Suppression et Navigation isolée par session[cite: 13] - [x] Zone de saisie intelligente (Drag & Drop, Collage multi-fichiers)[cite: 13] - [x] Export modulaire et propre (PDF, DOC, TXT, JSON, ZIP)[cite: 13] - [x] Boutons de partage direct (WhatsApp, Email) et Déconnexion[cite: 13]. - [x] Indicateur d'avancement dynamique (Loader Néon) pendant le traitement des IA[cite: 13]. - [x] Transparence du Routage : Affichage visuel (Badges) du parcours multi-IA (Succès, Échecs, Erreurs 404/503) pour chaque requête[cite: 13]. ### Phase 4 : Gestion des Utilisateurs & Sécurité Légale - [ ] Mettre en place une bibliothèque logicielle autonome sur le serveur (création PDF, DOCX, etc.)[cite: 13]. - [x] Routage automatique (Gratuit vs Payant) sélectionné par l'utilisateur avec solution de repli[cite: 13]. - [x] Système de cryptage de grade militaire (Fernet) et de Hashing (Bcrypt) mis en place[cite: 13]. - [x] Sécurité Légère : Fail2Ban, protection Bruteforce et DDoS[cite: 13]. **Blocage total des accès VPN**[cite: 13]. Ping silencieux[cite: 13]. - [x] Conformité légale (LCEN/RGPD) : Création de dossiers utilisateurs isolés[cite: 13]. Journalisation stricte des IP et de l'activité conservée 365 jours[cite: 13]. Purge automatique des comptes inactifs > 1 an[cite: 13]. - [ ] Multilinguisme : Adaptation automatique de la langue du site via la géolocalisation de l'IP[cite: 13]. - [ ] Cadre Légal (SaaS) : Rédaction ASAP des CGV (crédits non-remboursables, facturation de tokens, gestion des litiges) et CGU (interdiction de contenus illicites, logs IP conservés 1 an, politiques de confidentialité Google/OpenRouter). - [ ] Notifications SMTP : Intégration de `debug_mailer.py` via un service transactionnel (Brevo/SendGrid) pour l'envoi automatisé des CGU/CGV, confirmations d'inscription, alertes de quotas RAG et reçus. - [ ] Audit de Sécurité Global : Isolation stricte des historiques utilisateurs dans des fichiers JSON distincts, sécurisation `.gitignore` des clés (API/SMTP), vérification de l'étanchéité web des volumes `/DATA/AppData/`, et tests anti-injection de prompts sur le Superviseur IA. ### Phase 5 : Sécurité Financière & Facturation Exacte 💰 - [x] Pré-calcul local du nombre de tokens (via `tiktoken`) pour estimer le coût avant envoi[cite: 13]. - [x] Catalogue tarifaire dynamique (mise à jour auto) supprimant les coûts écrits en dur[cite: 13]. - [x] Affichage du Pop-Up OBLIGATOIRE de validation du coût pour TOUS les utilisateurs[cite: 13]. - [x] Télémétrie Admin : Suivi en temps réel de la consommation (Jour/Mois) et du solde restant sur l'API distante[cite: 13]. - [x] Module de conversion des devises en temps réel (API Frankfurter) pour un affichage transparent. - [x] **Utilisateurs Privilégiés (Zéro Marge) :** Application de tarifs coûtants pour les rôles Super Admin (Xavier), Admin (Céline) et Famille (Audric, Renan, Anaëlle). Marge appliquée pour VIP (7.5%) et Standard (15%). - [x] Export comptable Excel (TCD) par utilisateur via Pandas/Openpyxl (Optimisé pour les déclarations URSSAF)[cite: 13]. - [ ] Subventions & Accompagnement : Lancement des dossiers de financement d'infrastructure auprès de la CCI Nord Isère (Pass Création), BPI France (Bourse French Tech jusqu'à 30k€), et demande d'ACRE à l'URSSAF. ### Phase 6 : Nouvelles Capacités IA (Spécialisations & Modèles) 🤖 *L'infrastructure bascule sur un catalogue dynamique mis à jour toutes les 2h pour pallier les décommissionnements[cite: 13].* *Filtrage actif des modèles OpenRouter restreints (ex: Politiques de confidentialité strictes ignorées)[cite: 13].* | Domaine de tâche | Modèle / Moteur | Fournisseur / Hébergement | Rôle principal | | :--- | :--- | :--- | :--- | | **Orchestration & Tri** | Llama 3.2 3B Instruct Abliterated | Local (GTX 1650 4Go) | Analyse l'intention, juge de sécurité sans censure et route vers la bonne IA[cite: 13] | | **Bureautique & Code** | Catalogue Dynamique (ex: Sonnet 3.5) | OpenRouter | Programmation KubeJS, scripts, mathématiques[cite: 13] | | **Images HD / Fichiers** | Gemini / Vision | Google API | Analyse d'images/vidéos et documents joints[cite: 13] | ### Phase 7 & 8 : Maintenance & Déploiement - [x] Script de surveillance de l'espace disque du serveur avec sonde en direct et remontée d'alerte UI. - [x] Sauvegarde automatique asynchrone : Compression du site toutes les 6 heures et export vers GDrive via `rclone` et CRON. - [x] Hébergement Gitea Docker[cite: 13]. Injection des clés via `env_file`[cite: 13]. Volumes persistants configurés[cite: 13]. - [x] Persistance absolue et sécurité : Fichiers d'historique, logs, facturation et dossiers RAG isolés sur volume RAID mdadm externe[cite: 13]. - [x] Synchronisation temporelle : Conteneurs Docker synchronisés sur l'horloge système du serveur Debian hôte (NTP via montage en lecture seule)[cite: 13]. - [ ] Protection Intellectuelle : Création d'un fichier LICENSE strict (BSL/EULA) à la racine du dépôt pour bloquer l'usage commercial non autorisé. - [ ] Déploiement du Wiki : Mise en place sur Gitea/MkDocs d'une documentation segmentée (Déploiement Administrateur, Architecture Technique, et Guide Utilisateur). ### Phase 9 : Modération Automatisée & Conformité Pénale 🚨 - [x] Système hiérarchique : `Super Admin`, `Admin`, `VIP` (Famille) et `Standard`[cite: 13]. Quotas de ressources (60% CPU/RAM) applicables selon le rang[cite: 13]. - [x] Modération préventive "Anti-Zèle" : Filtrage par IA Locale tolérant la fiction et les jeux vidéo[cite: 13]. - [x] Système d'Avertissements (Strikes) automatisé et preuve d'audit manuscrite[cite: 13]. ### Phase 10 : Base de Connaissances Vectorielle (RAG FAISS) 📚 - [x] Initialisation de l'arborescence dynamique (`RAG/`) sur le stockage RAID[cite: 13]. - [x] Moteur Vectoriel Local : Remplacement de la lecture brute par une base **FAISS** haute performance[cite: 13]. - [x] Embeddings IA : Vectorisation mathématique via modèle local (Ollama / `nomic-embed-text`) pour une recherche sémantique ultra-rapide[cite: 13]. - [x] Ingestion Multi-Formats : Support étendu aux PDF institutionnels et aux fichiers de code/configuration (`.js`, `.yml`, `.json`, `.md`, `.txt`) pour la documentation de mods (ex: KubeJS)[cite: 13]. - [x] Superviseur IA (Arrière-plan) : Évaluation silencieuse de la pertinence technique des réponses avant indexation via Threading (zéro latence pour l'utilisateur)[cite: 13]. - [x] Forçage Manuel (UI) : Ajout d'un bouton HTMX "💾 Mémoriser" pour forcer l'apprentissage vectoriel à la volée[cite: 13]. - [x] Interface UI : Ajout d'une vue Administrateur pour téléverser de nouveaux documents RAG directement depuis le navigateur[cite: 13]. - [ ] Isolation des Quotas RAG : Segmentation des dossiers et index FAISS par utilisateur avec sonde de blocage d'upload fixée à 1 Go (Les rôles `Super Admin`, `Admin` et `Famille` sont exemptés de cette restriction). - [ ] Extension de Stockage RAG (5€/mois) : Automatisation d'un CRON mensuel vérifiant les paiements Stripe/PayPal. En cas d'impayé, purge LIFO (Last In, First Out : suppression physique des fichiers les plus récents) pour repasser sous les 1 Go, suivie du nettoyage des vecteurs orphelins via ré-indexation complète. - [ ] Instauration d'une page de configuration permettant de renseigner un serveur mail, les clés API et tout le nécessaire à l'utilisation. Dans le crowdfunding il a été annoncé qu'une IA local n'était pas obligatoire, il faudra donc prévoir de supprimer l'obligation d'IA local pour la partie des donnateurs et toute la gestion financiére excepté l'utilisation du montant restant sur les fournisseurs. Il faut donc créer une branche donnateur qui corresponde à la mienne mais sans la partie inutile.