compute_species_features_by_zone #39

📋 Description

Joindre GBIF ↔ IUCN localement, agréger par zone_id et period_year, calculer les counts par statut de menace + score pondéré, puis UPSERT dans species_features_by_zone.

✅ Acceptance Criteria

• DoD générales (logs, idempotence)
• period_year annuel ; jointure via scientific_name normalisé
• Déduplication espèces uniques par (zone_id, period_year, scientific_name_norm)
• Colonnes : species_total_count, species_cr/en/vu/nt_count, vulnerability_weighted_score
• UPSERT idempotent dans species_features_by_zone (+ job_run_zone_errors si partial)
• Log match_rate GBIF↔IUCN + nb espèces non-matchées
• Couverture de tests ≥ 90%

🔗 Prerequisite Issues

⚠️ Dépendances DoR :

• « staging.species_occurrences_raw rempli » → Depends on update_gbif_occurrences #33 (update_gbif_occurrences)
• « staging.iucn_taxa rempli » → Depends on update_iucn_taxonomy #34 (update_iucn_taxonomy)

⚠️ Autres DoR : zones_hex accessible, table species_features_by_zone (UNIQUE(zone_id, period_year, source_version)) :

• Prérequis : Init DB #12, Grille H3 & AOI #20

Source : Notion « compute_species_features_by_zone » (Prétraitements & Pipeline Data).