initial commit

INDEX.md

@@ -0,0 +1,244 @@
+# 📋 Index - Fichiers et Documentation
+
+## 🗂️ Structure du Projet
+
+```
+WebNationsGlory_ServeurBuild_Red/
+│
+├── 📄 Documentation
+│   ├── README.md                ← Vue d'ensemble générale
+│   ├── QUICKSTART.md           ← Démarrage rapide (5 min)
+│   ├── CONFIGURATION.md        ← Configuration détaillée
+│   ├── MAINTENANCE.md          ← Commandes et troubleshooting
+│   ├── DEPLOYMENT.md           ← Production & HTTPS
+│   └── INDEX.md                ← Ce fichier
+│
+├── 🚀 Scripts de Démarrage
+│   ├── setup.sh               ← Préparation initiale
+│   ├── install.sh             ← Installation des dépendances
+│   ├── start.sh               ← Lancer l'application
+│   └── .gitignore             ← Fichiers à ignorer Git
+│
+├── 📦 Backend (Express.js - Node.js)
+│   ├── package.json           ← Dépendances Node.js
+│   ├── .env.example           ← Template de configuration
+│   └── src/
+│       ├── server.js          ← Point d'entrée principal
+│       ├── routes/
+│       │   ├── auth.js        ← Authentification & login
+│       │   ├── rcon.js        ← Console RCON & redémarrage
+│       │   ├── logs.js        ← Gestion des logs
+│       │   ├── players.js     ← Liste des joueurs
+│       │   ├── whitelist.js   ← Gestion whitelist
+│       │   ├── backup.js      ← Création de backups
+│       │   └── server.js      ← Paramètres serveur
+│       └── utils/
+│           └── rcon.js        ← Client RCON (protocole)
+│
+├── 🎨 Frontend (HTML/CSS/JavaScript)
+│   ├── package.json           ← Meta frontend
+│   └── public/
+│       ├── index.html         ← Page HTML principale
+│       ├── css/
+│       │   └── style.css      ← Tous les styles
+│       └── js/
+│           └── app.js         ← Application React-like
+│
+├── 🐳 Deployment
+│   ├── Dockerfile             ← Build Docker
+│   └── docker-compose.yml     ← Orchestration Docker
+│
+└── 🔧 Configuration
+    ├── .gitignore
+    ├── docker-compose.yml
+    └── Dockerfile
+```
+
+## 📖 Guides de Lecture
+
+### Pour Démarrer Rapidement
+1. **QUICKSTART.md** - 5 minutes pour être opérationnel
+2. Suivez les 5 étapes simples
+
+### Pour Comprendre la Configuration
+1. **README.md** - Vue d'ensemble
+2. **CONFIGURATION.md** - Configuration détaillée
+3. Éditer les fichiers .env
+
+### Pour Utiliser l'Application
+1. Ouvrir http://localhost:3000
+2. Créer le compte admin
+3. Utiliser les onglets du dashboard
+
+### Pour Administrer le Serveur
+1. **MAINTENANCE.md** - Commandes utiles
+2. Sauvegardes régulières
+3. Monitoring
+
+### Pour la Production
+1. **DEPLOYMENT.md** - Configuration HTTPS/Proxy
+2. Sécurité renforcée
+3. Certificats SSL
+
+## 🔑 Points Clés
+
+### Configuration
+- **Backend .env**: Variables d'environnement critiques
+- **Server.properties**: RCON du serveur MC
+- **Ops.txt**: Liste des administrateurs
+
+### Sécurité
+- SESSION_SECRET unique en production
+- HTTPS recommandé
+- Firewall bien configuré
+
+### Maintenance
+- Backups réguliers
+- Logs à surveiller
+- Mises à jour Node.js
+
+## 🚀 Quickstart Ultime
+
+```bash
+# 1. Configuration serveur MC
+# Éditer server.properties:
+enable-rcon=true
+rcon.port=25575
+rcon.password=YourPassword123
+
+# 2. Installation
+cd WebNationsGlory_ServeurBuild_Red
+./install.sh
+
+# 3. Configuration app
+nano backend/.env
+
+# 4. Lancement
+./start.sh
+
+# 5. Accès
+# Ouvrir: http://localhost:3000
+```
+
+## 📚 Fichiers Importants à Connaître
+
+| Fichier | Rôle | Éditer? |
+|---------|------|--------|
+| backend/.env | Configuration | ✏️ OUI |
+| backend/src/server.js | Point d'entrée | ❌ Non |
+| frontend/public/js/app.js | Interface | ❌ Non (sauf custom) |
+| README.md | Documentation | ✏️ Opcional |
+| CONFIGURATION.md | Guide détaillé | ❌ Non |
+
+## 🎯 Fonctionnalités par Fichier
+
+### Routes API
+
+**auth.js** 🔐
+- Création compte admin
+- Connexion/Déconnexion
+- Changement mot de passe RCON
+
+**rcon.js** ⌨️
+- Exécution commandes RCON
+- Historique commandes
+- Redémarrage serveur
+- Sauvegarde monde
+
+**logs.js** 📜
+- Visualisation logs
+- Recherche dans logs
+- Gestion fichiers logs
+
+**players.js** 👥
+- Liste joueurs
+- UUID et connexions
+- Statistiques
+
+**whitelist.js** ✅
+- Ajouter joueurs
+- Retirer joueurs
+- Gestion format
+
+**backup.js** 💾
+- Créer backups
+- Lister backups
+- Supprimer backups
+
+**server.js** ⚙️
+- Lire paramètres
+- Modifier paramètres
+- Configuration globale
+
+### Utils
+
+**rcon.js** 🔌
+- Client RCON (protocole Minecraft)
+- Connection/Auth
+- Envoi commandes
+- Parsing réponses
+
+## 🔄 Flux de Requête
+
+```
+Browser (frontend/public/js/app.js)
+    ↓
+    HTTP Request
+    ↓
+Backend Express (backend/src/server.js)
+    ↓
+    Route Handler (backend/src/routes/*.js)
+    ↓
+    RCON Client (backend/src/utils/rcon.js)
+    ↓
+Serveur Minecraft
+    ↓
+Response → Backend → Browser
+```
+
+## 🎓 Pour Apprendre
+
+- **JavaScript**: app.js (client-side)
+- **Node.js**: server.js (backend)
+- **Express**: routes/*.js (API)
+- **RCON Protocol**: utils/rcon.js
+- **HTML/CSS**: index.html + style.css
+
+## 🚨 Fichiers Critiques
+
+Ne pas modifier sans savoir:
+- ✓ backend/src/utils/rcon.js - Protocole RCON
+- ✓ backend/src/server.js - Point d'entrée
+- ✓ backend/src/routes/auth.js - Sécurité
+
+Peuvent être modifiés:
+- ✏️ frontend/public/css/style.css - Design
+- ✏️ frontend/public/js/app.js - Interface
+- ✏️ backend/.env - Configuration
+
+## 📞 Ressources
+
+- **Node.js Docs**: https://nodejs.org/docs
+- **Express Docs**: https://expressjs.com
+- **Minecraft Wiki RCON**: https://wiki.vg/RCON
+- **JavaScript MDN**: https://developer.mozilla.org
+
+## ✅ Checklist d'Installation
+
+- [ ] Node.js 14+ installé
+- [ ] ./install.sh exécuté
+- [ ] backend/.env configuré
+- [ ] Serveur MC avec RCON activé
+- [ ] Premier compte admin créé
+- [ ] Test RCON validé
+- [ ] Documentations lues
+
+## 🎉 Vous êtes Prêt!
+
+Profitez de votre interface d'administration! 🚀
+
+Pour plus d'aide, consultez:
+1. QUICKSTART.md (5 min)
+2. CONFIGURATION.md (détails)
+3. MAINTENANCE.md (commandes)
+4. DEPLOYMENT.md (production)