seo-generator-server/QUICK_START.md
StillHammer cd79ca9a4a chore: Add documentation, scripts and monitoring tools
- 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>
2025-10-12 16:10:56 +08:00

3.2 KiB

🚀 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

# 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é)

  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 :

# 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 :

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Linux/WSL : "Permission denied"

# Rendre le script exécutable
chmod +x start-server.sh

# Puis relancer
./start-server.sh

Erreur "Cannot find module"

# 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

# Windows
start-server.bat

# Linux/WSL
./start-server.sh

# Puis ouvrir : http://localhost:3000

C'est tout ! 🚀