# 📦 Guide d'Installation - IchiGridEA

## Prérequis

- **MetaTrader 5** (Build 3000+)
- **Windows** 10/11 ou **Wine** sur Linux/Mac
- **Python 3.9+** (pour les scripts du pipeline)
- **Git** (pour la gestion de version)

## Installation Rapide

### 1. Cloner le dépôt

```bash
git clone https://github.com/KinSushi/IchiGrid-EA.git
cd IchiGrid-EA
```

### 2. Copier vers MetaTrader 5

```bash
# Windows (adapter le chemin)
xcopy /E /I . "C:\Users\%USERNAME%\AppData\Roaming\MetaQuotes\Terminal\{TERMINAL_ID}\MQL5\Experts\IchiGridEA"

# Ou manuellement:
# 1. Copier tout le contenu vers MQL5/Experts/IchiGridEA/
# 2. Les fichiers Include/*.mqh dans le sous-dossier Include/
# 3. Les fichiers Files/* dans MQL5/Files/
```

### 3. Compiler dans MetaEditor

1. Ouvrir MetaEditor (F4 dans MT5)
2. Ouvrir `IchiGridEA.mq5`
3. Compiler (F7)
4. Vérifier qu'il n'y a pas d'erreurs

### 4. Attacher à un chart

1. Dans MT5, ouvrir un chart (ex: EURUSD M15)
2. Navigateur → Expert Advisors → IchiGridEA
3. Glisser-déposer sur le chart
4. Configurer les paramètres
5. Cliquer OK

## Installation du Pipeline (Développeurs)

### 1. Installer les dépendances Python

```bash
pip install -r requirements.txt
```

### 2. Configurer les Git hooks

```bash
./setup-hooks.sh
```

### 3. Vérifier l'installation

```bash
python pipeline/scripts/consistency_checker.py
```

## Structure des Dossiers

```
MQL5/
├── Experts/
│   └── IchiGridEA/
│       ├── IchiGridEA.mq5
│       ├── Include/           # Modules MQH
│       └── tests/             # Tests
└── Files/
    ├── IchiGridEA/           # Données persistantes
    │   ├── Memory/
    │   ├── Ghost/
    │   ├── Reports/
    │   ├── Cloud/
    │   └── Logs/
    └── Presets/              # Fichiers .set
```

## Configuration Initiale

### Paramètres Recommandés (Débutant)

```
InpLotInitial = 0.01
InpMaxDrawdownPercent = 10.0
InpEnableGrid = false
InpModeDebug = true
```

### Paramètres Avancés

Voir `Files/Presets/` pour des configurations prêtes à l'emploi:
- `Default.set` - Configuration par défaut
- `GridATR_Volatile.set` - Pour marchés volatiles
- `IchiOnly_Strict.set` - Signaux Ichimoku stricts

## Vérification de l'Installation

1. **Terminal → Experts**: Doit afficher "IchiGridEA initialized"
2. **Dashboard**: Doit apparaître sur le chart
3. **Pas d'erreurs**: Onglet "Journal" vide d'erreurs

## Problèmes Courants

Voir [TROUBLESHOOTING.md](TROUBLESHOOTING.md)

## Support

- Issues GitHub: https://github.com/KinSushi/IchiGrid-EA/issues
- Email: support@sovralys.com