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].
<!-- MAJ 23/08/2026 : URL de production masquée pour raisons de cybersécurité (Information Disclosure) -->
**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.