Idempotence & Exécution #21

📋 Description

Garantir que chaque job est relançable sans doublons ni effets de bord, via une gestion standardisée de l'idempotence et des statuts dans job_runs (+ erreurs fines par zone optionnelles).

Comprend : packages/core/idempotency.py avec build_key(...) (clé déterministe stable), helpers DB (start_run, finish_success/failure/partial, mark_zone_error), convention skip/retry (success ⇒ skip, failed/partial ⇒ retry), scopes region:{aoi_id} / zone:{zone_id}.

✅ Acceptance Criteria

• Module packages/core/idempotency.py implémenté
• Construction de clé déterministe et stable (mêmes inputs ⇒ même clé)
• Gestion standard des statuts : running | success | failed | partial
• Règle d'exécution : success ⇒ skip ; sinon retry safe
• Mise à jour atomique (transaction) : running au démarrage, success/failed/partial à la fin
• Support partial : job_run_zone_errors alimentée quand des zones échouent
• Tests unitaires ciblés (clé stable, transitions, success⇒skip, failed⇒retry, partial + zone_errors)
• Coverage ≥ 90% sur la partie logique
• mettre à jour les fichiers déjà implémenté sans ce système comme generate_h3_grid

🔗 Prerequisite Issues

⚠️ Dépendances déclarées dans la DoR :

• « table job_runs / job_run_zone_errors prête » → Depends on Init DB #12 (Init DB)
• « Convention bucket_id fixée via core.time_bucket » → Depends on Normalisation temporelle (core.time_bucket) #17 (Normalisation temporelle)

Source : Notion « Idempotence & Exécution » (Outils commun).