Sprint 2 — DEM-01 À FAIRE¶

Runbook technique (fichiers, SQL, commandes) : demo-conductor/docs/sprints/sprint-2-dem01.md Cette page = vue stratégique pour Marc + Cyrille.

Création de l'étude DEM-01 · Photographie démographique territoriale (Thématique, 450€, 48h).

Spec = HTML Cyrille Besançon¶

Fichier source de vérité : Contexte_par_cyrille/DEM01_Besancon_2026_v3.html

Cyrille a livré un exemple complet sur Besançon qui sert de template qualité (structure, argumentaire, niveau de détail).

Sources de données¶

Source	Table	Usage DEM-01
INSEE RP 2022	`rp_demographics`	Population totale, évolution, densité
INSEE RP détaillé	`rp_details`	Pyramide des âges, structure ménages
Filosofi	`filosofi`	Revenu médian, taux de pauvreté
OMPHALE	`projections`	Trajectoire démographique de référence

Pas de MAJIC, pas de SNE

DEM-01 est volontairement une étude zéro prérequis MAJIC : universelle, disponible pour toutes les communes de France métropolitaine.

Livrables¶

backend/app/report_pipeline/data_collectors/dem_01.py
backend/app/report_pipeline/prompts/dem_01_html_report.py
Tests e2e sur 2 communes : Besançon (comparaison template Cyrille) + Palaiseau (cross-étude avec LOG-01)

Plan d'exécution¶

flowchart LR
    A[Analyser template
Besançon v3] --> B[Identifier blocs
et KPIs]
    B --> C[Écrire
dem_01.py collector]
    C --> D[Écrire mega-prompt
LLM]
    D --> E[Test Besançon
vs spec Cyrille]
    E --> F[Test Palaiseau
cross-étude]
    F --> G[Revue Cyrille]

ISC préview (à décomposer en sprint)¶

Collector extrait RP 2022 complet pour commune + EPCI de rattachement
Collector calcule pyramide des âges en 5 tranches
Collector joint Filosofi (revenu médian, Gini, taux pauvreté)
Template HTML paysage A4 aligné sur Besançon v3
Chaque chiffre a sa source cliquable dans "Sources détaillées"

Cross-étude avec LOG-01

DEM-01 et LOG-01 partagent la même commune — il faut que les chiffres population / ménages soient rigoureusement identiques entre les deux rapports. Prévoir une jointure sur une vue matérialisée commune.