Évolution climatique — Gironde, France, monde

Étude de l'évolution du climat à partir de données ouvertes, publiée sous forme de tableau de bord. Chaque chiffre affiché est traçable jusqu'à sa source et au script qui l'a produit.

Architecture

Sources ouvertes ──► ETL Python (GitHub Actions, mensuel) ──► data/processed/*.json ──► Site Next.js (Vercel)
                     télécharge, contrôle, calcule             contrat validé              affiche, ne calcule rien

Dossier	Rôle
etl/	Calcul scientifique. schema.py = contrat de données, pipeline.py = orchestrateur, config/indicators.yaml = registre des indicateurs
data/processed/	Résultats publiés (JSON + manifest.json, rapports validation-<phase>.json). Seule interface entre l'ETL et le site
data/raw/	Cache des téléchargements, hors Git
web/	Site Next.js (App Router, TypeScript, Tailwind, ECharts, zod)
.github/workflows/	ci.yml (tests à chaque push), etl.yml (exécution mensuelle)
docs/	Sources, méthode, journal des phases

Le contrat de données existe en deux exemplaires qui doivent rester identiques : etl/schema.py (pydantic) et web/lib/schema.ts (zod). Un JSON non conforme est refusé par la CI côté Python, puis par le build côté site.

Ajouter un indicateur

1. Écrire un module etl/sources/<source>.py exposant build(ctx) -> Indicator.
2. Le déclarer dans etl/config/indicators.yaml.
3. python -m etl.pipeline --only <id> puis python -m etl.validate.

La page /<échelle>/<id> apparaît automatiquement au build suivant. Aucun code côté site. Un nouveau thème ajoute de même son bouton et sa page /<échelle>/themes/<thème>, dans la famille « Autres » tant qu'il n'est pas rattaché à une famille dans web/lib/family.ts. Pour rattacher l'indicateur à une famille (matrice, superposition, carte, navigation entre lieux), le constructeur renseigne variable (vocabulaire etl/config/variables.yaml) et place (station ou composite). Une nouvelle variable s'ajoute au vocabulaire ; le site n'en connaît aucune à l'avance.

Apparence

Couleurs dans web/app/globals.css. Les couleurs de données (échelles, chaud/froid, bandes) ne suivent pas le thème. Photo de l'accueil : web/public/accueil/vallee-glaciaire.jpg, Unsplash.

Lancer en local

pip install -r etl/requirements.txt
python -m etl.pipeline && python -m etl.validate
python -m pytest etl/tests

cd web && npm install && npm run dev     # http://localhost:3000

Déploiement Vercel

Projet Vercel relié à ce dépôt, Root Directory = web, option « Include files outside the root directory » activée (le build lit ../data/processed). Chaque commit sur main, y compris ceux de l'ETL mensuel, redéploie le site.

État

• P0 (socle) : close le 22/10/2026.
• P1 (températures homogénéisées de Gironde) : close le 23/10/2026. 20 indicateurs, validés contre ClimatHD et recoupés avec ERA5. Voir docs/validation-p1.md.