StillHammer
cd79ca9a4a
- Add comprehensive documentation (IMPLEMENTATION_COMPLETE, ProductionReady, QUICK_START, STARTUP_ANALYSIS) - Add startup scripts (start-server.sh, start-server.bat, check-setup.sh) - Add configs directory structure with README - Add ValidationGuards and Main.js backup - Add LLM monitoring HTML interface - Add cache templates and XML files - Add technical report (rapport_technique.md) - Add bundled code.js 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
169 lines
3.2 KiB
Markdown
169 lines
3.2 KiB
Markdown
# 🚀 Quick Start - Lancement Rapide du Serveur
|
|
|
|
Deux méthodes simples pour lancer le serveur SEO Generator.
|
|
|
|
---
|
|
|
|
## 🪟 **Windows (Double-clic)**
|
|
|
|
### Méthode 1 : Fichier .bat
|
|
|
|
1. **Double-cliquer** sur `start-server.bat`
|
|
2. Le script va :
|
|
- ✅ Vérifier Node.js et npm
|
|
- ✅ Installer les dépendances si nécessaire
|
|
- ✅ Lancer le serveur en mode MANUAL
|
|
3. **Ouvrir le navigateur** : http://localhost:3000
|
|
|
|
**Arrêter le serveur** : `Ctrl + C` dans la fenêtre
|
|
|
|
---
|
|
|
|
## 🐧 **Linux / WSL (Terminal)**
|
|
|
|
### Méthode 2 : Fichier .sh
|
|
|
|
```bash
|
|
# Depuis le dossier du projet
|
|
./start-server.sh
|
|
```
|
|
|
|
Le script va :
|
|
- ✅ Vérifier Node.js et npm
|
|
- ✅ Installer les dépendances si nécessaire
|
|
- ✅ Créer le dossier configs/ si absent
|
|
- ✅ Proposer d'ouvrir le navigateur automatiquement
|
|
- ✅ Lancer le serveur en mode MANUAL
|
|
|
|
**Arrêter le serveur** : `Ctrl + C` dans le terminal
|
|
|
|
---
|
|
|
|
## 📋 **Prérequis**
|
|
|
|
Avant le premier lancement :
|
|
|
|
1. **Node.js installé** (v16+ recommandé)
|
|
- Windows : https://nodejs.org/
|
|
- Linux/WSL : `sudo apt-get install nodejs npm`
|
|
|
|
2. **Fichier `.env` configuré** avec :
|
|
- `GOOGLE_SERVICE_ACCOUNT_EMAIL`
|
|
- `GOOGLE_PRIVATE_KEY`
|
|
- `GOOGLE_SHEETS_ID`
|
|
- Clés API (ANTHROPIC, OPENAI, etc.)
|
|
|
|
3. **Dépendances installées** (auto-installé par les scripts)
|
|
|
|
---
|
|
|
|
## ✅ **Vérification que ça fonctionne**
|
|
|
|
Après lancement, tu devrais voir :
|
|
|
|
```
|
|
========================================
|
|
Démarrage du serveur...
|
|
========================================
|
|
|
|
Mode: MANUAL
|
|
Port: 3000
|
|
WebSocket: 8081
|
|
|
|
Interface disponible sur:
|
|
http://localhost:3000
|
|
|
|
Appuyez sur Ctrl+C pour arrêter le serveur
|
|
========================================
|
|
|
|
✅ ManualServer démarré sur http://localhost:3000
|
|
📡 WebSocket logs sur ws://localhost:8081
|
|
```
|
|
|
|
**Ensuite, ouvre ton navigateur** : http://localhost:3000
|
|
|
|
Tu devrais voir la **page d'accueil** avec 2 cards :
|
|
- 🔧 Éditeur de Configuration
|
|
- 🚀 Runner de Production
|
|
|
|
---
|
|
|
|
## 🛠️ **Alternative : Lancement Manuel**
|
|
|
|
Si les scripts ne marchent pas, lancement classique :
|
|
|
|
```bash
|
|
# Installer les dépendances (première fois seulement)
|
|
npm install
|
|
|
|
# Lancer le serveur
|
|
npm start
|
|
|
|
# OU en mode AUTO
|
|
npm start -- --mode=auto
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 **Troubleshooting**
|
|
|
|
### Windows : "Les scripts sont désactivés"
|
|
|
|
Si Windows bloque l'exécution :
|
|
|
|
**Solution 1 (Recommandée)** : Double-clic sur `start-server.bat` directement
|
|
|
|
**Solution 2** : Ouvrir PowerShell en admin et taper :
|
|
```powershell
|
|
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
|
|
```
|
|
|
|
### Linux/WSL : "Permission denied"
|
|
|
|
```bash
|
|
# Rendre le script exécutable
|
|
chmod +x start-server.sh
|
|
|
|
# Puis relancer
|
|
./start-server.sh
|
|
```
|
|
|
|
### Erreur "Cannot find module"
|
|
|
|
```bash
|
|
# Supprimer node_modules et réinstaller
|
|
rm -rf node_modules package-lock.json
|
|
npm install
|
|
```
|
|
|
|
### Port 3000 déjà utilisé
|
|
|
|
Modifier dans `.env` :
|
|
```
|
|
MANUAL_PORT=3001
|
|
```
|
|
|
|
---
|
|
|
|
## 📖 **Aller Plus Loin**
|
|
|
|
- **Documentation complète** : `ProductionReady.md`
|
|
- **Guide d'implémentation** : `IMPLEMENTATION_COMPLETE.md`
|
|
- **Architecture** : `CLAUDE.md`
|
|
|
|
---
|
|
|
|
## 🎯 **Résumé Ultra-Rapide**
|
|
|
|
```bash
|
|
# Windows
|
|
start-server.bat
|
|
|
|
# Linux/WSL
|
|
./start-server.sh
|
|
|
|
# Puis ouvrir : http://localhost:3000
|
|
```
|
|
|
|
**C'est tout ! 🚀**
|