# 📖 Documentation — Index et ordre de lecture

## 🚀 ORDRE DE LECTURE RECOMMANDÉ

### 🟢 Débutant (25 minutes)
```
1. SETUP_INITIAL.md                         (5 min) ← COMMENCER ICI!
2. doc/01_DEMARRAGE_RAPIDE.md               (5 min)
3. doc/02_ARCHITECTURE_VUE_ENSEMBLE.md      (15 min)
4. docker compose up -d + test SSH
```

### 🟡 Intermédiaire (1-2 heures)
```
1. SETUP_INITIAL.md
2. doc/01_DEMARRAGE_RAPIDE.md
3. doc/03_ARCHITECTURE_DIAGRAMMES.md        (10 min)
4. doc/05_DETAILS_TECHNIQUES_COMPLETS.md    (30 min)
5. Parcourir gateway/ et dest/ Dockerfiles
6. Tester et modifier configs
```

### 🔴 Avancé (2-3 heures)
```
1. Lire: SETUP_INITIAL.md (bien comprendre les clés)
2. Lire: doc/02_ARCHITECTURE_VUE_ENSEMBLE.md
3. Lire: doc/05_DETAILS_TECHNIQUES_COMPLETS.md (en détail)
4. Lire: doc/06_DEBUG_ET_SOLUTIONS.md (pièges)
5. Lire: tous les fichiers config (Dockerfile, sshd_config, yaml)
6. Déboguer, modifier, étendre
```

---

## 📚 FICHIERS DE DOCUMENTATION

### 🔑 SETUP (À LIRE EN PREMIER)
- **[SETUP_INITIAL.md](SETUP_INITIAL.md)** (4.4 KB) ⭐⭐⭐
  Clés SSH, init-keys.ps1, known_hosts, redémarrage
  **→ À LIRE AVANT TOUTE CHOSE**

### 📍 Fichiers de démarrage
- **[01_DEMARRAGE_RAPIDE.md](01_DEMARRAGE_RAPIDE.md)** (2 KB)
  Concept en 5 min + quick start
  
- **[00_COMMENCER_ICI.md](00_COMMENCER_ICI.md)** (2.5 KB)
  Point d'entrée rapide

### 🏗️ Compréhension architecturale
- **[02_ARCHITECTURE_VUE_ENSEMBLE.md](02_ARCHITECTURE_VUE_ENSEMBLE.md)** (10 KB)
  Vue globale, flux complet, 9 fichiers expliqués
  
- **[03_ARCHITECTURE_DIAGRAMMES.md](03_ARCHITECTURE_DIAGRAMMES.md)** (10 KB)
  Diagrammes visuels, checklist, cas d'usage

- **[04_CONCEPT_EXPLIQUE_SIMPLEMENT.md](04_CONCEPT_EXPLIQUE_SIMPLEMENT.md)** (6 KB)
  ELI5: analogies et termes simples

### 🔧 Détails techniques
- **[05_DETAILS_TECHNIQUES_COMPLETS.md](05_DETAILS_TECHNIQUES_COMPLETS.md)** (17 KB)
  Chaque fichier ligne par ligne, niveau par niveau

### 🐛 Debugging
- **[06_DEBUG_ET_SOLUTIONS.md](06_DEBUG_ET_SOLUTIONS.md)** (4.7 KB)
  Problèmes rencontrés, solutions appliquées

### 📖 Références
- **[07_REFERENCE_TOUS_FICHIERS.md](07_REFERENCE_TOUS_FICHIERS.md)** (9.8 KB)
  Détail de chaque fichier, responsabilités
  
- **[08_INVENTAIRE_ET_STATS.md](08_INVENTAIRE_ET_STATS.md)** (8.6 KB)
  Statistiques, structure, complexité
  
- **[09_CARTE_MENTALE.md](09_CARTE_MENTALE.md)** (8.6 KB)
  Arborescence conceptuelle et relations

### 🗺️ Navigation
- **[10_CHEMINS_DE_LECTURE.md](10_CHEMINS_DE_LECTURE.md)** (6.9 KB)
  Chemin personnalisé selon votre profil
  
- **[12_TABLE_MATIERES.md](12_TABLE_MATIERES.md)** (3 KB)
  Table des matières complète

### ✅ Synthèse
- **[11_RESUME_FINAL.md](11_RESUME_FINAL.md)** (7 KB)
  Bilan: ce qui a été créé, statistiques

---

## 🎯 Cherchez une réponse?

| Question | Fichier |
|----------|---------|
| J'ai besoin de générer les clés SSH | **SETUP_INITIAL.md** ⭐ |
| Je reçois une erreur de host key | **SETUP_INITIAL.md** → "Redémarrer/Reconstruire" |
| Comment ça marche? | `02_ARCHITECTURE_VUE_ENSEMBLE.md` |
| Je veux un diagramme | `03_ARCHITECTURE_DIAGRAMMES.md` |
| C'est trop compliqué | `04_CONCEPT_EXPLIQUE_SIMPLEMENT.md` |
| Expliquez chaque ligne | `05_DETAILS_TECHNIQUES_COMPLETS.md` |
| J'ai un bug | `06_DEBUG_ET_SOLUTIONS.md` |
| Quel fichier fait quoi? | `07_REFERENCE_TOUS_FICHIERS.md` |
| Statistiques et structure | `08_INVENTAIRE_ET_STATS.md` |
| Arborescence conceptuelle | `09_CARTE_MENTALE.md` |
| Chemin de lecture perso | `10_CHEMINS_DE_LECTURE.md` |
| Résumé final | `11_RESUME_FINAL.md` |

---

## 📊 Statistiques documentation

```
Total:           15 fichiers
Taille:          126 KB
Couverture:      100% des concepts
Temps lecture:   2-20 min selon profil
```

---

## ✅ Checklist avant de démarrer

```
☐ Lire SETUP_INITIAL.md (5 min)
☐ Lancer .\init-keys.ps1
☐ Vérifier: keys/lab_rsa existe
☐ Vérifier: keys/gateway_rsa existe
☐ docker compose up -d
☐ ssh-keygen -f ~/.ssh/known_hosts -R "[localhost]:2222" (if needed)
☐ Tester: ssh -p 2222 testuser@localhost 'hostname'
☐ Résultat: dest1 ou dest2 ✓
```

---

**Prêt?** → Commencez par `SETUP_INITIAL.md` puis `01_DEMARRAGE_RAPIDE.md`