# 📁 Structure du Projet - Version Nettoyée

## ✅ Nettoyage effectué : 168 fichiers archivés

**De 182 fichiers Python → 49 fichiers Python essentiels**

## 🎯 Structure Organisée

### 📂 **CORE - Bot Principal**
```
trading_bot.py              # Bot de trading principal
config.py                   # Configuration centrale
```

### 🌐 **SERVICES**
```
dashboard_api_server.py     # Serveur API & Dashboard (port 8889)
bot_watchdog.py             # Surveillance 24/7 et redémarrage auto
auto_updater_service.py     # Mise à jour automatique des données
```

### 🧠 **IA & MACHINE LEARNING**
```
ai_predictor.py             # Prédicteur IA principal
ai_advanced_scorer.py       # Scoring avancé (GPU RTX)
ai_opportunity_selector.py  # Sélection d'opportunités
ai_realtime_service.py      # Service IA temps réel
ai_self_optimizer.py        # Auto-optimisation des paramètres
ensemble_predictor.py       # Ensemble de modèles
train_ai_model.py           # Entraînement du modèle
```

### 📊 **ANALYSEURS**
```
advanced_feature_engineering.py    # Features avancées
correlation_analyzer.py            # Analyse de corrélations
feature_engineering.py             # Features de base
long_term_trend_analyzer.py        # Tendances long terme
market_regime_detector.py          # Détection régime marché
monte_carlo_simulator.py           # Simulations Monte Carlo
multi_timeframe_analyzer.py        # Multi-timeframes
performance_analyzer.py            # Analyse de performance
risk_adjusted_scorer.py            # Score ajusté au risque
technical_analyzer.py              # Analyse technique
time_pattern_analyzer.py           # Patterns temporels
volatility_scorer.py               # Score de volatilité
volume_profile_analyzer.py         # Profil de volume
```

### 📈 **STRATÉGIES**
```
advanced_strategies.py      # Stratégies avancées
dynamic_blacklist.py        # Blacklist dynamique
dynamic_sltp.py             # Stop Loss / Take Profit dynamiques
enhanced_signal_engine.py   # Moteur de signaux amélioré
market_safety.py            # Sécurité marché
smart_entry_criteria.py     # Critères d'entrée intelligents
smart_rotation.py           # Rotation intelligente
```

### 🔧 **UTILITAIRES**
```
crypto_data_fetcher.py      # Récupération données crypto
fetch_historical_data.py    # Données historiques
historical_data_updater.py  # Mise à jour historique
telegram_notifier.py        # Notifications Telegram
trade_logger.py             # Logging des trades
backtesting.py              # Backtesting
```

### 🎮 **SCRIPTS PRINCIPAUX**
```
Reset_trading.py            # Redémarrage complet du système
sell_all.py                 # Vente de toutes les positions
check_balance.py            # Vérifier le solde
check_positions.py          # Vérifier les positions
```

### 🧹 **MAINTENANCE**
```
cleanup_obsolete_files.py   # Nettoyage des fichiers obsolètes
```

### 🚀 **SCRIPTS DE DÉMARRAGE**
```
start_watchdog.ps1          # Démarrer le watchdog
start_watchdog.bat          # Démarrer le watchdog (batch)
install_watchdog_service.ps1 # Installer service Windows
```

### 📁 **DOSSIERS**
```
api/                        # Modules API
models/                     # Modèles ML sauvegardés
trade_logs/                 # Logs de trading
historical_data/            # Données historiques
crypto_cache/               # Cache des données crypto
tests/                      # Tests unitaires
archive_YYYYMMDD_HHMMSS/    # Archives des fichiers obsolètes
```

### 📋 **FICHIERS DE DONNÉES**
```
watchlist.json              # Liste de surveillance
positions.json              # Positions ouvertes
dynamic_blacklist.json      # Blacklist dynamique
performance_blacklist.json  # Blacklist basée sur performance
performance_whitelist.json  # Whitelist basée sur performance
market_safety_status.json   # Statut sécurité marché
ai_training_stats.json      # Stats d'entraînement IA
```

### 📝 **DOCUMENTATION**
```
WATCHDOG_GUIDE.md           # Guide du watchdog
README.md                   # Documentation principale
PROJET_STRUCTURE.md         # Ce fichier
```

## 🗑️ **Fichiers Archivés (168)**

### Catégories archivées:
- **53** scripts de test obsolètes
- **15** scripts d'analyse temporaires
- **7** scripts de correction (fix)
- **9** scripts de vente manuelle
- **11** scripts de debug
- **15** scripts de vérification redondants
- **6** anciens scripts de démarrage
- **4** scripts de synchronisation
- **19** scripts divers obsolètes
- **3** anciens dashboards
- **25** fichiers de logs/backups

### 📁 Archive:
```
archive_20260116_125029/
├── tests_obsoletes/
├── analyze_obsolete/
├── fix_scripts/
├── manual_sells/
├── debug_scripts/
├── check_scripts/
├── old_starters/
├── sync_scripts/
├── demo_scripts/
├── misc_obsolete/
├── old_dashboards/
└── logs_backups/
```

## 🎯 Avantages de la Structure Nettoyée

✅ **Clarté** : Structure logique et organisée  
✅ **Maintenance** : Plus facile à maintenir  
✅ **Performance** : Moins de fichiers = chargement plus rapide  
✅ **Documentation** : Chaque fichier a un rôle clair  
✅ **Sécurité** : Les anciens fichiers sont archivés, pas supprimés  

## 📊 Statistiques

| Métrique | Avant | Après | Amélioration |
|----------|-------|-------|--------------|
| Fichiers Python | 182 | 49 | **-73%** |
| Structure | Désorganisée | Organisée | ✅ |
| Maintenance | Difficile | Facile | ✅ |

## 🔍 Comment Utiliser

### Démarrer le système:
```powershell
# 1. Démarrer le watchdog (surveillance 24/7)
.\start_watchdog.ps1

# 2. Vérifier que tout fonctionne
python check_positions.py
python check_balance.py
```

### Accéder au dashboard:
```
http://localhost:8889/dashboard.html
```

### En cas de problème:
```powershell
# Redémarrage complet
python Reset_trading.py

# Vérifier les logs
Get-Content watchdog.log -Tail 50
Get-Content trading_bot.log -Tail 50
```

## 📝 Notes

- Les fichiers archivés sont dans `archive_20260116_125029/`
- Si besoin, ils peuvent être restaurés manuellement
- Le watchdog surveille le bot 24/7 et le redémarre automatiquement
- La structure est maintenant optimale pour le développement et la maintenance

---

*Dernière mise à jour: 2026-01-16*  
*Nettoyage effectué par: cleanup_obsolete_files.py*