═══════════════════════════════════════════════════════════════
  CLASS GENERATOR - PORTABLE EDITION SETUP
═══════════════════════════════════════════════════════════════

📋 PRÉREQUIS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Clé USB ou disque externe (minimum 150 MB libre)
• Windows 10 (pas besoin de droits admin!)
• PAS besoin d'internet pour utiliser (seulement pour setup initial)

🔧 INSTALLATION (À FAIRE UNE SEULE FOIS SUR TON PC)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. TÉLÉCHARGER NODE.JS PORTABLE
   ────────────────────────────────────────────────────────────

   Option A - Automatique (recommandé):
   • Double-cliquer sur: DOWNLOAD_NODEJS.bat
   • Attendre le téléchargement automatique
   • ✅ Terminé!

   Option B - Manuel:
   • Aller sur: https://nodejs.org/en/download/
   • Télécharger: "Windows Binary (.zip)" - version LTS
   • Extraire le fichier ZIP
   • Renommer le dossier en "nodejs-portable"
   • Copier le dossier "nodejs-portable" dans ce dossier

2. VÉRIFIER LA STRUCTURE
   ────────────────────────────────────────────────────────────
   Ton dossier doit ressembler à ça:

   Class_generator/
   ├── nodejs-portable/          ← Le dossier Node.js
   │   ├── node.exe             ← Important!
   │   ├── npm
   │   └── node_modules/
   ├── src/
   ├── content/
   ├── START_PORTABLE.bat       ← Lance ça!
   ├── server.js
   └── package.json

3. PREMIER LANCEMENT
   ────────────────────────────────────────────────────────────
   • Double-cliquer sur: START_PORTABLE.bat
   • La première fois, ça va installer dotenv (~10 secondes)
   • Ensuite le serveur démarre!

🚀 UTILISATION EN COURS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Brancher ta clé USB
2. Double-cliquer sur START_PORTABLE.bat
3. Ouvrir le navigateur: http://localhost:8080
4. Utiliser l'application!

⚠️ LIMITATIONS SANS INTERNET
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Sans connexion internet, ces features ne marcheront PAS:
• ❌ AI exercises (OpenAI/DeepSeek API)
• ❌ LLM scoring
• ❌ Translation API
• ❌ Online content loading

Ce qui MARCHE hors-ligne:
• ✅ Interface principale
• ✅ Navigation
• ✅ Contenu local (fichiers JSON dans content/)
• ✅ Jeux sans AI
• ✅ Flashcards locaux
• ✅ Sauvegarde locale (dossier saves/)

📦 TAILLE TOTALE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Projet actuel:        42 MB
Node.js portable:    ~50 MB
node_modules:          1 MB
─────────────────────────────
TOTAL:              ~95 MB

💡 DÉPANNAGE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Problème: "Node.js portable not found!"
→ Solution: Vérifier que le dossier "nodejs-portable" existe
            et contient node.exe

Problème: "Port 8080 already in use"
→ Solution: Ouvrir le Gestionnaire des tâches
            Arrêter tous les processus "node.exe"
            Relancer START_PORTABLE.bat

Problème: Page blanche dans le navigateur
→ Solution: Vérifier que l'URL est bien http://localhost:8080
            (pas https!)

Problème: AI ne fonctionne pas
→ Solution: Normal sans internet! Utiliser les jeux locaux

═══════════════════════════════════════════════════════════════
Créé le 2025-10-18 | Class Generator 2.0 Portable Edition
═══════════════════════════════════════════════════════════════