aethas-free/README.md

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 ✅

• Installation Docker, Nginx (NPM), Pare-feu, Gitea/GitHub[cite: 13]
• Serveur Local Ollama (Abliterated 3B) + FastHTML[cite: 13]
• Routeur Multi-IA (OpenRouter, Gemini, Local) avec système de cascade et directives d'aiguillage strictes[cite: 13]
• Continuité de service : IA de secours automatique et Timeout à 300s[cite: 13].

Phase 3 : Refonte UI & Expérience Utilisateur ✅

• Thème "Minecraft-Tech" (Inspiré serveurs/redstone) compatible Mobile (Responsive / Contraste OLED élevé)[cite: 13]
• Historique (Sidebar) avec Renommage, Épinglage, Suppression et Navigation isolée par session[cite: 13]
• Zone de saisie intelligente (Drag & Drop, Collage multi-fichiers)[cite: 13]
• Export modulaire et propre (PDF, DOC, TXT, JSON, ZIP)[cite: 13]
• Boutons de partage direct (WhatsApp, Email) et Déconnexion[cite: 13].
• Indicateur d'avancement dynamique (Loader Néon) pendant le traitement des IA[cite: 13].
• 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].
• Routage automatique (Gratuit vs Payant) sélectionné par l'utilisateur avec solution de repli[cite: 13].
• Système de cryptage de grade militaire (Fernet) et de Hashing (Bcrypt) mis en place[cite: 13].
• Sécurité Légère : Fail2Ban, protection Bruteforce et DDoS[cite: 13]. Blocage total des accès VPN[cite: 13]. Ping silencieux[cite: 13].
• 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 💰

• Pré-calcul local du nombre de tokens (via tiktoken) pour estimer le coût avant envoi[cite: 13].
• Catalogue tarifaire dynamique (mise à jour auto) supprimant les coûts écrits en dur[cite: 13].
• Affichage du Pop-Up OBLIGATOIRE de validation du coût pour TOUS les utilisateurs[cite: 13].
• 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].
• Module de conversion des devises en temps réel (API Frankfurter) pour un affichage transparent.
• 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%).
• 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

• Script de surveillance de l'espace disque du serveur avec sonde en direct et remontée d'alerte UI.
• Sauvegarde automatique asynchrone : Compression du site toutes les 6 heures et export vers GDrive via rclone et CRON.
• Hébergement Gitea Docker[cite: 13]. Injection des clés via env_file[cite: 13]. Volumes persistants configurés[cite: 13].
• Persistance absolue et sécurité : Fichiers d'historique, logs, facturation et dossiers RAG isolés sur volume RAID mdadm externe[cite: 13].
• 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 🚨

• 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].
• Modération préventive "Anti-Zèle" : Filtrage par IA Locale tolérant la fiction et les jeux vidéo[cite: 13].
• Système d'Avertissements (Strikes) automatisé et preuve d'audit manuscrite[cite: 13].

Phase 10 : Base de Connaissances Vectorielle (RAG FAISS) 📚

• Initialisation de l'arborescence dynamique (RAG/) sur le stockage RAID[cite: 13].
• Moteur Vectoriel Local : Remplacement de la lecture brute par une base FAISS haute performance[cite: 13].
• Embeddings IA : Vectorisation mathématique via modèle local (Ollama / nomic-embed-text) pour une recherche sémantique ultra-rapide[cite: 13].
• 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].
• 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].
• Forçage Manuel (UI) : Ajout d'un bouton HTMX "💾 Mémoriser" pour forcer l'apprentissage vectoriel à la volée[cite: 13].
• 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.