1. Calcul des sous-indices #41

📋 Description

Implémenter les fonctions de calcul des sous-indices écologiques dans packages/scoring. Chaque sous-indice mesure une composante de la pression / sensibilité écologique d'une zone H3, à partir des features déjà agrégées (par zone × période). Ces fonctions sont pures : elles reçoivent les données en argument, normalisent les indicateurs (score = (valeur − min) / (max − min)) et retournent le résultat — aucune connexion DB. Elles sont appelées par le job de calcul de l'indice global et par les tests de validation, jamais comme jobs indépendants.

Sous-indices du MVP : pression humaine (building_area_ratio, road_density_major/all, urban_landuse_ratio, ndbi), végétation / dégradation (état NDVI + perte NDVI), sensibilité espèces (pondération NT/VU/EN/CR), dynamique / tendance (baisse NDVI, hausse NDBI). Le sous-indice de protection réglementaire arrivera en V1 — les signatures doivent accepter une composante protection nulle.

✅ Acceptance Criteria

• Les fonctions de calcul des sous-indices sont implémentées
• Chaque fonction respecte les règles de normalisation
• Les fonctions peuvent être appelées par le job de scoring
• Les fonctions peuvent être utilisées dans les tests de validation
• La couverture de tests unitaires atteint 80 % minimum
• Documentation des formules utilisées + normalisation des indicateurs
• DoD générales respectées (cf. DoR/DoD section Indices & Analyses)

🔗 Prerequisite Issues

Les sous-indices consomment les features agrégées par zone — les tables de features doivent exister (DoR Générale : « les tables de features nécessaires existent ») :

• Job extract_sentinel_2 #36 (Job extract_sentinel_2 → satellite_features_by_zone : NDVI/NDWI/NDBI)
• Compute OSM features + Cleanup #38 (Compute OSM features → osm_features_by_zone : bâti, routes, urbain)
• compute_species_features_by_zone #39 (compute_species_features_by_zone → species_features_by_zone : counts NT/VU/EN/CR)

Prérequis transverse : structure du module packages/scoring et règles qualité (#19). La gestion des valeurs manquantes / cas limites doit être définie avant de figer les fonctions.

Source : Notion « 1. Calcul des sous-indices » (Indices & Analyses).