add journées mondiales et vacances

extractors/README_extractor_events.md

@@ -0,0 +1,39 @@
+# Extractors d'évènements (vacances, journées mondiales)
+
+Scripts CLI ajoutant des évènements dans OEDB, avec cache JSON, paramètres et rapport.
+
+## Commun
+- Cache: dossier `extractors_cache/` (créé automatiquement)
+- Paramètres: `--dry-run` pour simuler sans écrire dans OEDB
+- API OEDB: `--base-url` (par défaut `https://api.openeventdatabase.org`)
+
+## Vacances scolaires FR
+
+```bash
+python3 extractors/fr_holidays_extractor.py \
+  --start 2025-01-01 --end 2025-12-31 \
+  --academie A \
+  --cache extractors_cache/fr_holidays_cache.json \
+  --cache-ttl $((24*3600)) \
+  --base-url https://api.openeventdatabase.org \
+  --dry-run
+```
+
+Sortie: JSON avec `success`, `failed`, `networkErrors`.
+
+## Journées mondiales / internationales
+
+```bash
+python3 extractors/world_days_extractor.py \
+  --year 2025 \
+  --cache extractors_cache/world_days_cache.json \
+  --cache-ttl $((24*3600)) \
+  --base-url https://api.openeventdatabase.org \
+  --dry-run
+```
+
+Remarques:
+- Les sources sont branchées de façon minimaliste (exemples). Brancher des sources plus riches selon besoin.
+- Conversion en format OEDB: évènements non localisés (Point [0,0]) par défaut, `online=yes` pour journées mondiales.
+
+