# 🚀 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 ! 🚀**