╔══════════════════════════════════════════════════════════════════════════════╗
║                    📚 CARTE DE LA DOCUMENTATION - AutoFatom                  ║
╚══════════════════════════════════════════════════════════════════════════════╝

                            🎯 POINT D'ENTRÉE
                                    │
                          ┌─────────┴─────────┐
                          │   START_HERE.md   │
                          │  (Ce fichier!)    │
                          └─────────┬─────────┘
                                    │
                          ┌─────────▼─────────┐
                          │     INDEX.md      │ ⭐ GUIDE PRINCIPAL
                          │ (Navigation vers  │
                          │  tous les docs)   │
                          └─────────┬─────────┘
                                    │
                    ┌───────────────┼───────────────┐
                    │               │               │
          ┌─────────▼──────┐ ┌─────▼──────┐ ┌─────▼──────────┐
          │   README.md    │ │  QUICK_    │ │    CONFIG_     │
          │                │ │ REFERENCE  │ │   EXAMPLES.md  │
          │ • Vue ensemble │ │            │ │                │
          │ • Installation │ │ • Commandes│ │ • Exemples env │
          │ • Config base  │ │ • Référence│ │ • CRON         │
          │ • Utilisation  │ │ • Rapide   │ │ • Messages     │
          └────────────────┘ └────────────┘ └────────────────┘
                    │               │               │
                    └───────────────┼───────────────┘
                                    │
                    ┌───────────────┼───────────────┐
                    │               │               │
          ┌─────────▼──────┐ ┌─────▼──────────┐ ┌─▼──────────────┐
          │  TECHNICAL.md  │ │ TROUBLESHOOTING│ │  CHANGELOG.md  │
          │                │ │      .md       │ │                │
          │ • Architecture │ │                │ │ • Version 1.0  │
          │ • Modules      │ │ • 10 problèmes │ │ • Historique   │
          │ • Upload image │ │ • Solutions    │ │ • Leçons       │
          │ • Sélecteurs   │ │ • Diagnostic   │ │ • Maintenance  │
          └────────────────┘ └────────────────┘ └────────────────┘


╔══════════════════════════════════════════════════════════════════════════════╗
║                        📖 GUIDE D'UTILISATION RAPIDE                         ║
╚══════════════════════════════════════════════════════════════════════════════╝

┌──────────────────┬──────────────────────────┬────────────────────────────────┐
│   SITUATION      │    DOCUMENT À LIRE       │         CE QU'IL CONTIENT      │
├──────────────────┼──────────────────────────┼────────────────────────────────┤
│ Première fois    │ START_HERE.md            │ Orientation générale           │
│                  │ → INDEX.md               │ Guide vers ressources          │
│                  │ → README.md              │ Installation et config         │
├──────────────────┼──────────────────────────┼────────────────────────────────┤
│ J'ai un problème │ QUICK_REFERENCE.md       │ Dépannage express              │
│                  │ → TROUBLESHOOTING.md     │ Solutions détaillées           │
├──────────────────┼──────────────────────────┼────────────────────────────────┤
│ Configuration    │ CONFIG_EXAMPLES.md       │ Exemples de .env               │
│                  │ → QUICK_REFERENCE.md     │ CRON, messages, chemins        │
├──────────────────┼──────────────────────────┼────────────────────────────────┤
│ Comprendre code  │ TECHNICAL.md             │ Architecture complète          │
│                  │ → CHANGELOG.md           │ Pourquoi c'est fait ainsi      │
├──────────────────┼──────────────────────────┼────────────────────────────────┤
│ Info rapide      │ QUICK_REFERENCE.md       │ Commandes, syntaxe             │
├──────────────────┼──────────────────────────┼────────────────────────────────┤
│ Revenir plus     │ INDEX.md                 │ Rappel complet contexte        │
│ tard (perdu)     │ → START_HERE.md          │ Réorientation                  │
└──────────────────┴──────────────────────────┴────────────────────────────────┘


╔══════════════════════════════════════════════════════════════════════════════╗
║                         🎯 PARCOURS RECOMMANDÉS                              ║
╚══════════════════════════════════════════════════════════════════════════════╝

┌─ DÉBUTANT (30 minutes) ──────────────────────────────────────────────────────┐
│                                                                              │
│  1. START_HERE.md         (5 min)  - Orientation                            │
│  2. INDEX.md              (5 min)  - Navigation                             │
│  3. README.md             (10 min) - Installation + config                  │
│  4. CONFIG_EXAMPLES.md    (5 min)  - Fichier .env                           │
│  5. npm install + test    (5 min)  - Vérification                           │
│                                                                              │
│  ➜ Vous êtes prêt à lancer: npm start                                       │
└──────────────────────────────────────────────────────────────────────────────┘

┌─ UTILISATEUR (1-2 heures) ───────────────────────────────────────────────────┐
│                                                                              │
│  1. README.md complet     (20 min) - Tout comprendre                        │
│  2. QUICK_REFERENCE.md    (10 min) - Mémo à garder                          │
│  3. CONFIG_EXAMPLES.md    (30 min) - Toutes les configs                     │
│  4. TROUBLESHOOTING.md    (20 min) - Anticiper problèmes                    │
│                                                                              │
│  ➜ Vous maîtrisez l'utilisation                                             │
└──────────────────────────────────────────────────────────────────────────────┘

┌─ DÉVELOPPEUR (3-4 heures) ───────────────────────────────────────────────────┐
│                                                                              │
│  1. TECHNICAL.md          (90 min) - Architecture complète                  │
│  2. CHANGELOG.md          (45 min) - Historique et leçons                   │
│  3. Code source           (60 min) - Lire src/                              │
│  4. Expérimentation       (30 min) - Modifier et tester                     │
│                                                                              │
│  ➜ Vous pouvez modifier et améliorer le projet                              │
└──────────────────────────────────────────────────────────────────────────────┘


╔══════════════════════════════════════════════════════════════════════════════╗
║                    🔑 POINTS CLÉS À RETENIR (CRITIQUE)                       ║
╚══════════════════════════════════════════════════════════════════════════════╝

┌─ #1 UPLOAD D'IMAGES ─────────────────────────────────────────────────────────┐
│                                                                              │
│  ✅ BONNE MÉTHODE (fonctionne):                                             │
│     const promise = page.waitForEvent('filechooser');                       │
│     await button.click();                                                   │
│     const chooser = await promise;                                          │
│     await chooser.setFiles(path);                                           │
│                                                                              │
│  ❌ MAUVAISE (ouvre dialog):                                                │
│     await input.setInputFiles(path);                                        │
│                                                                              │
│  📖 Détails: TECHNICAL.md section 4.4                                       │
└──────────────────────────────────────────────────────────────────────────────┘

┌─ #2 SÉLECTEURS FACEBOOK ─────────────────────────────────────────────────────┐
│                                                                              │
│  ✅ UTILISEZ ARIA (stable):                                                 │
│     'div[role="button"][aria-label="Post"]'                                 │
│     'div[aria-label="Photo/video"]'                                         │
│                                                                              │
│  ❌ ÉVITEZ CSS (change):                                                    │
│     'div.x1n2onr6.x1ja2u2z'                                                 │
│                                                                              │
│  📖 Détails: TECHNICAL.md section "Sélecteurs Facebook"                     │
└──────────────────────────────────────────────────────────────────────────────┘

┌─ #3 CONFIGURATION API ───────────────────────────────────────────────────────┐
│                                                                              │
│  .env:                                                                       │
│    ADSPOWER_API_KEY=9a1b3800cf6d5d11a1897fe99b9f48b6                       │
│                     └─ PAS de guillemets, PAS de "Bearer"                   │
│                                                                              │
│  Le code ajoute automatiquement "Bearer " dans les headers                  │
│                                                                              │
│  📖 Détails: TROUBLESHOOTING.md problème #2                                 │
└──────────────────────────────────────────────────────────────────────────────┘


╔══════════════════════════════════════════════════════════════════════════════╗
║                      📊 STATISTIQUES DE LA DOCUMENTATION                     ║
╚══════════════════════════════════════════════════════════════════════════════╝

┌──────────────────────────┬────────┬──────────┬─────────┬──────────────────┐
│       DOCUMENT           │ PAGES  │ SECTIONS │  MOTS   │     NIVEAU       │
├──────────────────────────┼────────┼──────────┼─────────┼──────────────────┤
│ START_HERE.md            │   3    │    11    │  ~1800  │ ⭐ Orientation   │
│ INDEX.md                 │   8    │    15    │  ~2500  │ ⭐ Navigation    │
│ README.md                │   4    │    10    │  ~1500  │ 🟢 Débutant      │
│ QUICK_REFERENCE.md       │   3    │     8    │  ~1000  │ 🟢 Tous niveaux  │
│ CONFIG_EXAMPLES.md       │   6    │    12    │  ~2000  │ 🟢 Débutant      │
│ TECHNICAL.md             │  15    │    20    │  ~5000  │ 🔴 Avancé        │
│ TROUBLESHOOTING.md       │  10    │    13    │  ~3000  │ 🟡 Intermédiaire │
│ CHANGELOG.md             │   8    │    15    │  ~3500  │ 🟢 Tous niveaux  │
├──────────────────────────┼────────┼──────────┼─────────┼──────────────────┤
│ TOTAL                    │  57    │   104    │ ~20300  │                  │
└──────────────────────────┴────────┴──────────┴─────────┴──────────────────┘

Couverture: 100% du projet documenté ✅
Langues: Français uniquement 🇫🇷
Dernière màj: 6 janvier 2026


╔══════════════════════════════════════════════════════════════════════════════╗
║                        ✅ VÉRIFICATION AVANT LANCEMENT                       ║
╚══════════════════════════════════════════════════════════════════════════════╝

Avant npm start, vérifiez:

  ☐ Node.js >= 18 installé          (node --version)
  ☐ AdsPower lancé                  (curl http://local.adspower.net:50325/status)
  ☐ Profils disponibles             (npm test)
  ☐ Fichier .env créé               (cat .env)
  ☐ Clé API correcte                (pas de guillemets)
  ☐ Image dans Downloads            (ls ~/Downloads/votre-image.jpg)
  ☐ Dépendances installées          (npm install)

Si tout est ✅ → npm start


╔══════════════════════════════════════════════════════════════════════════════╗
║                           🆘 AIDE ET SUPPORT                                 ║
╚══════════════════════════════════════════════════════════════════════════════╝

Problème ?  1. QUICK_REFERENCE.md → Dépannage rapide
            2. TROUBLESHOOTING.md → Solutions détaillées
            3. INDEX.md → Recherche par symptôme

Question ?  1. INDEX.md → Recherche rapide
            2. Document approprié → Section spécifique

Perdu ?     1. START_HERE.md → Réorientation
            2. INDEX.md → Guide complet


╔══════════════════════════════════════════════════════════════════════════════╗
║                    🎉 TOUT EST PRÊT - BON DÉVELOPPEMENT !                    ║
╚══════════════════════════════════════════════════════════════════════════════╝

Version: 1.0.0
Status: ✅ Projet 100% fonctionnel
Documentation: ✅ Complète et à jour
Date: 6 janvier 2026
