seogeneratorserver/public/README-Interface.md

🧪 Interface de Test Modulaire - Guide d'Utilisation

🚀 Démarrage Rapide

1. Démarrer le serveur :

   npm start
   

2. Accéder à l'interface :

   • Dashboard principal : http://localhost:3000
   • Interface de test : http://localhost:3000/test-modulaire.html
   • API Status : http://localhost:3000/api/status

🎯 Interface de Test Modulaire

Fonctionnalités principales

🔧 Configuration des Tests

• Ligne Google Sheet : Numéro de ligne à traiter (2-100)
• Selective Enhancement : Base d'amélioration du contenu
• Adversarial Mode : Techniques adversariales anti-détection
• Human Simulation : Simulation comportement humain
• Pattern Breaking : Cassage patterns syntaxiques LLM

📊 Types de Tests Disponibles

1. Test Individual : Test d'une configuration spécifique
2. Benchmark Complet : Comparaison de multiples configurations
3. Comparaison Résultats : Tableau de comparaison des performances

Logs Temps Réel

L'interface utilise WebSocket (port 8081) pour afficher les logs en temps réel :

• 🟦 DEBUG : Informations détaillées
• 🟢 INFO : Messages opérationnels
• 🟡 WARN : Avertissements
• 🔴 ERROR : Erreurs
• ⚪ TRACE : Traces d'exécution

Statistiques Affichées

• Durée : Temps d'exécution total en ms
• Éléments Générés : Nombre d'éléments traités
• Selective : Modifications Selective Enhancement
• Adversarial : Modifications Adversarial
• Human Sim : Modifications Human Simulation
• Pattern Breaking : Modifications Pattern Breaking
• Taille Finale : Caractères du contenu final
• Personnalité : Personnalité IA sélectionnée

🎛️ Configurations Recommandées

Configuration Légère (Tests Rapides)

Selective: lightEnhancement
Adversarial: none  
Human: none
Pattern: none

Configuration Standard (Usage Général)

Selective: standardEnhancement
Adversarial: light
Human: lightSimulation  
Pattern: standardPatternBreaking

Configuration Intensive (Anti-détection Max)

Selective: fullEnhancement
Adversarial: heavy
Human: heavySimulation
Pattern: heavyPatternBreaking

Configuration Adaptive (Automatique)

Selective: adaptive
Adversarial: adaptive
Human: adaptiveSimulation
Pattern: adaptivePatternBreaking

📈 Interprétation des Résultats

Métriques de Performance

• < 30 000ms : Performance excellente
• 30 000-60 000ms : Performance acceptable
• > 60 000ms : Performance à optimiser

Efficacité Anti-détection

• Total Modifications > 10 : Très efficace
• Total Modifications 5-10 : Efficace
• Total Modifications < 5 : Peu efficace

Qualité du Contenu

• Taille finale > 3000 chars : Contenu riche
• Taille finale 1500-3000 chars : Contenu standard
• Taille finale < 1500 chars : Contenu léger

🔧 API Endpoints

Test Individual

POST /api/test-modulaire
Content-Type: application/json

{
  "rowNumber": 2,
  "selectiveStack": "standardEnhancement",
  "adversarialMode": "light",
  "humanSimulationMode": "lightSimulation",
  "patternBreakingMode": "standardPatternBreaking",
  "source": "web_interface"
}

Benchmark

POST /api/benchmark-modulaire
Content-Type: application/json

{
  "rowNumber": 2
}

Configuration

GET /api/modulaire-config

🎯 Bonnes Pratiques

1. Tests Progressifs : Commencer par des configurations légères
2. Monitoring Ressources : Surveiller CPU/mémoire pendant les benchmarks
3. Logs Analysis : Utiliser les logs pour diagnostiquer les problèmes
4. Comparaisons : Toujours comparer plusieurs configurations
5. Sauvegarde Config : Sauvegarder les configurations performantes

🐛 Dépannage

Problèmes Courants

• Timeout : Augmenter la limite ou réduire l'intensité
• Logs vides : Vérifier connexion WebSocket port 8081
• Erreur 500 : Vérifier logs serveur dans la console
• Config non sauvée : Vérifier localStorage du navigateur

Support

• Logs serveur : Console Node.js
• Logs client : Console navigateur (F12)
• Logs détaillés : Fichier logs/app-YYYY-MM-DD.log

📝 Notes Techniques

• WebSocket : Port 8081 pour logs temps réel
• HTTP Server : Port 3000 par défaut
• Timeout : 2 minutes par défaut pour les tests
• Memory : ~200MB RAM par test complet
• Storage : Logs rotatifs, configs en localStorage