╔══════════════════════════════════════════════════════════════════════════════╗
║                                                                              ║
║                    🦊 FIREFOX EST OBLIGATOIRE 🦊                             ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝


┌──────────────────────────────────────────────────────────────────────────────┐
│  ⚠️  IMPORTANT                                                               │
└──────────────────────────────────────────────────────────────────────────────┘

   Ce système fonctionne UNIQUEMENT avec Mozilla Firefox.

   ❌ Microsoft Edge → NE FONCTIONNE PAS
   ❌ Google Chrome → NE FONCTIONNE PAS
   ❌ Internet Explorer → NE FONCTIONNE PAS
   ✅ Mozilla Firefox → REQUIS


┌──────────────────────────────────────────────────────────────────────────────┐
│  🔍 VÉRIFIER SI FIREFOX EST INSTALLÉ                                         │
└──────────────────────────────────────────────────────────────────────────────┘

   Méthode 1: Menu Démarrer
   ─────────────────────────
   1. Cliquer sur le bouton Démarrer (Windows)
   2. Taper "Firefox"
   3. Si l'icône Firefox apparaît → C'est bon ✅
   4. Sinon → Installer (voir ci-dessous)

   Méthode 2: Via le Diagnostic
   ─────────────────────────────
   1. Double-cliquer sur DIAGNOSTIC.bat
   2. Regarder [CHECK 8/9] Firefox availability
   3. Si [OK] → Firefox trouvé ✅
   4. Si [ERROR] → Installer (voir ci-dessous)


┌──────────────────────────────────────────────────────────────────────────────┐
│  📥 OPTION 1: INSTALLATION STANDARD (Droits Admin Requis)                    │
└──────────────────────────────────────────────────────────────────────────────┘

   1. Aller sur: https://www.mozilla.org/firefox/
   2. Cliquer sur "Télécharger Firefox"
   3. Exécuter l'installateur
   4. Accepter l'installation (nécessite droits admin)
   5. Firefox sera installé dans C:\Program Files\Mozilla Firefox\

   ✅ Avantages:
      - Installation système
      - Mises à jour automatiques
      - Intégration Windows complète

   ❌ Inconvénients:
      - Nécessite droits administrateur
      - Peut être bloqué par IT


┌──────────────────────────────────────────────────────────────────────────────┐
│  🎒 OPTION 2: FIREFOX PORTABLE (Recommandé pour Déploiement)                 │
└──────────────────────────────────────────────────────────────────────────────┘

   1. Télécharger depuis:
      https://portableapps.com/apps/internet/firefox_portable

   2. Choisir la langue: French / Français

   3. Télécharger le fichier .paf.exe (~100 MB)

   4. Exécuter le fichier téléchargé
      → Choisir où extraire (ex: Desktop/FirefoxPortable/)

   5. Une fois extrait, lancer:
      FirefoxPortable\FirefoxPortable.exe

   6. Firefox s'ouvre → Vous pouvez l'utiliser !

   ✅ Avantages:
      - PAS besoin de droits admin
      - Portable (clé USB OK)
      - Pas d'installation système
      - Fonctionne partout

   ❌ Inconvénients:
      - Pas de mises à jour auto (manuel)
      - Prend ~200 MB d'espace


┌──────────────────────────────────────────────────────────────────────────────┐
│  🚀 OPTION 3: INCLURE FIREFOX PORTABLE DANS LE PACKAGE                       │
└──────────────────────────────────────────────────────────────────────────────┘

   Pour un déploiement ultra-sécurisé:

   1. Télécharger Firefox Portable (Option 2)

   2. Copier le dossier FirefoxPortable/ dans Class_generator/

   3. Structure finale:
      Class_generator/
      ├── FirefoxPortable/
      │   └── FirefoxPortable.exe
      ├── nodejs-portable/
      ├── START_PORTABLE_SAFE.bat
      └── ...

   4. Modifier START_PORTABLE_SAFE.bat ligne ~192:
      :: Chemin vers Firefox portable local
      if exist "%~dp0FirefoxPortable\FirefoxPortable.exe" (
          start "" "%~dp0FirefoxPortable\FirefoxPortable.exe" http://localhost:8080
          set FIREFOX_FOUND=1
      ) else if exist "C:\Program Files\Mozilla Firefox\firefox.exe" (
          ...

   ✅ Avantages:
      - ZÉRO dépendance externe
      - Fonctionne PARTOUT
      - Package complet autonome

   ❌ Inconvénients:
      - Package devient ~400 MB (vs 200 MB)
      - Transfert plus long


┌──────────────────────────────────────────────────────────────────────────────┐
│  🛠️ DÉPANNAGE                                                                │
└──────────────────────────────────────────────────────────────────────────────┘

   Problème: "Firefox is installed but script doesn't find it"
   ───────────────────────────────────────────────────────────
   Solution:
   1. Le script cherche dans:
      - C:\Program Files\Mozilla Firefox\firefox.exe
      - C:\Program Files (x86)\Mozilla Firefox\firefox.exe
      - PATH système (where firefox)

   2. Si Firefox est ailleurs:
      - Lancer manuellement Firefox
      - Aller sur http://localhost:8080
      - Ça fonctionnera quand même

   3. Ou utiliser Firefox Portable (Option 2)


   Problème: "IT policy blocks Firefox installation"
   ──────────────────────────────────────────────────
   Solution:
   1. Utiliser Firefox Portable (Option 2) → Pas d'installation
   2. Ou demander exception IT avec justification éducative
   3. Ou inclure Firefox Portable dans le package (Option 3)


   Problème: "Firefox opens but page doesn't load"
   ────────────────────────────────────────────────
   Solution:
   1. Vérifier que le serveur tourne (fenêtre console ouverte)
   2. Vérifier l'URL: http://localhost:8080 (pas https)
   3. Vérifier logs\server.log pour erreurs
   4. Consulter DEPLOYMENT_GUIDE.md


┌──────────────────────────────────────────────────────────────────────────────┐
│  ✅ VALIDATION                                                               │
└──────────────────────────────────────────────────────────────────────────────┘

   Avant le déploiement, vérifier:

   □ Firefox installé (standard ou portable)
   □ DIAGNOSTIC.bat trouve Firefox ([CHECK 8/9] OK)
   □ START_PORTABLE_SAFE.bat ouvre Firefox automatiquement
   □ Ou vous savez comment lancer Firefox manuellement

   Si tous cochés → Vous êtes prêt ! ✅


┌──────────────────────────────────────────────────────────────────────────────┐
│  📊 RECOMMANDATION PAR SCÉNARIO                                              │
└──────────────────────────────────────────────────────────────────────────────┘

   Scénario 1: Machine perso / Droits admin
   ─────────────────────────────────────────
   → Installer Firefox standard (Option 1)


   Scénario 2: Machine entreprise / Pas de droits admin
   ─────────────────────────────────────────────────────
   → Firefox Portable (Option 2)


   Scénario 3: Déploiement en milieu totalement inconnu
   ─────────────────────────────────────────────────────
   → Package avec Firefox Portable inclus (Option 3)
   → Garantie de fonctionnement à 100%


   Scénario 4: Firefox déjà installé sur la machine cible
   ───────────────────────────────────────────────────────
   → Rien à faire ! ✅
   → Les scripts le trouveront automatiquement


═══════════════════════════════════════════════════════════════════════════════

                        Questions Fréquentes

═══════════════════════════════════════════════════════════════════════════════

Q: Pourquoi Firefox uniquement ?
A: Votre système utilise des technologies spécifiques qui fonctionnent
   uniquement dans Firefox dans l'environnement cible. Edge et Chrome
   ont des restrictions qui empêchent le bon fonctionnement.

Q: Firefox Portable est-il sûr ?
A: Oui ! C'est la version officielle de Firefox, emballée pour être portable.
   Source officielle: portableapps.com (projet open-source reconnu)

Q: Puis-je utiliser une version ancienne de Firefox ?
A: Firefox 60+ recommandé. Les versions très anciennes peuvent ne pas marcher.
   Préférer toujours la dernière version.

Q: Ça prend combien de place ?
A: - Firefox standard: ~200 MB installé
   - Firefox Portable: ~200 MB
   - Package complet (Class_generator + Firefox Portable): ~400 MB

Q: Et si Firefox est bloqué par l'IT ?
A: Options:
   1. Firefox Portable (pas d'installation, peut passer sous le radar)
   2. Demander exception IT (justification éducative)
   3. Utiliser une autre machine

═══════════════════════════════════════════════════════════════════════════════
                           Version 1.0 - 2025-10-18
═══════════════════════════════════════════════════════════════════════════════