seogeneratorserver/public/README-Interface.md
StillHammer dbf1a3de8c Add technical plan for multi-format export system
Added plan.md with complete architecture for format-agnostic content generation:
- Support for Markdown, HTML, Plain Text, JSON formats
- New FormatExporter module with neutral data structure
- Integration strategy with existing ContentAssembly and ArticleStorage
- Bonus features: SEO metadata generation, readability scoring, WordPress Gutenberg format
- Implementation roadmap with 4 phases (6h total estimated)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-18 16:14:29 +08:00

163 lines
4.6 KiB
Markdown

# 🧪 Interface de Test Modulaire - Guide d'Utilisation
## 🚀 Démarrage Rapide
1. **Démarrer le serveur :**
```bash
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