Extraction and analysis of data on Benin from the GDELT database
# 🇧🇯 Bénin Insights Challenge — iSHEERO × DataCamp Donates 2026
> **Transformer des données mondiales en connaissance locale.**
---
## Table des matières
1. Présentation du projet
2. Équipe
3. Structure du projet
4. Installation
5. Sources de données
6. Extraction des données
7. Nettoyage et exploration des données
8. Analyse approfondie par le ML
9. Dashboard
10. Insights clés
11. Usage de l'IA
---
## 1. Présentation du projet
Ce projet est réalisé dans le cadre du **Hackathon iSHEERO × DataCamp Donates 2026 — Bénin Insights Challenge**.
**Mission :** Extraire et analyser les événements concernant le Bénin depuis la base de données mondiale **GDELT** sur les 12 derniers mois (Jan 2025 – Décembre 2025), puis produire des insights actionnables à destination de journalistes, chercheurs et décideurs publics.
**Source de données :** GDELT (Global Database of Events, Language and Tone) — une base publique qui surveille en temps réel les médias du monde entier dans plus de 100 langues, disponible sur Google BigQuery.
**Période analysée :** `20250101` → `20251231`
**Filtre géographique :** `ActionGeo_CountryCode = 'BN'` (Bénin, code FIPS)
---
## 2. Équipe
| Profil | Nom | Responsabilité |
|--------|-----|----------------|
| Data Engineer | Martin-Junior ADECHI | Pipeline GDELT, extraction BigQuery, nettoyage des données |
| Data Analyst | Denakpo Paule | Dashboard interactif, visualisations, executive summary |
| ML Engineer | BONI Zoul | Analyse de sentiment, clustering, classification des événements |
| Data Scientist | TADOGBE Ahouéfa Trésor Steffi | Approche analytique, interprétation, rapport final, pitch |
---
## 3. Structure du projet
```
.
├── data/
│ ├── raw/ # Données brutes extraites de BigQuery
│ └── processed/ # Données nettoyées
│
├── notebooks/
│ ├── data_extraction.ipynb # Extraction BigQuery
│ ├── data_cleaning.ipynb …