# Taux de change BCE - Guide utilisateur

## Ce que fait cette fonctionnalité
L'application peut importer les taux de change officiels de la BCE dans la table interne des taux.

Cela permet aux équipes d'utiliser directement en base des taux FX à jour et historiques.

## Utilisation standard
Lancer la commande d'import :

```bash
php artisan lnc:sync-ecb-exchange-rates
```

Par défaut, cela importe les taux des 7 derniers jours.

## Importer un historique plus long
Vous pouvez forcer un rattrapage historique en années **depuis aujourd'hui** :

```bash
php artisan lnc:sync-ecb-exchange-rates --years=10
```

Cet exemple importe jusqu'à 10 ans d'historique BCE se terminant à la date du jour.

## Importer X années à partir d'une date fixe
Pour les très longues plages (par exemple 20–30 ans), utilisez une **date de début** et une **durée en années** (l'import est découpé automatiquement en plusieurs requêtes BCE) :

```bash
php artisan lnc:sync-ecb-exchange-rates --start=2000-01-01 --years=30
```

Optionnel : fixer une date de fin explicite :

```bash
php artisan lnc:sync-ecb-exchange-rates --start=2010-01-01 --end=2020-12-31
```

## Notes

- La source des données est la BCE.
- La devise de base est l'EUR.
- Les taux sont disponibles les jours de publication BCE (jours ouvrés).
- Relancer la commande met à jour les lignes existantes (réexécution sans risque).
- L'import peut **échouer** si la période sélectionnée ne retourne aucune ligne (ex : plage de dates incorrecte).

## Flux d'exploitation recommandé

1. Faire un backfill initial (exemple : 5 ou 10 ans)
2. Lancer un import quotidien via cron
3. Relancer manuellement à tout moment si nécessaire

## Problèmes fréquents

- **Pas de nouvelles données certains jours**
  - Comportement normal les jours sans publication (week-end / jours fériés).
- **L'import échoue**
  - Vérifier l'accès internet du serveur et les logs (`storage/logs`).