Valeurs génétiques (EBV)

Les endpoints /api/ebv donnent accès aux résultats des évaluations génétiques : runs de calcul, EBV par reine et résultats consolidés.

Runs

Méthode	Route	Description
GET	/api/ebv/runs	Liste des runs (?status, ?limit, ?offset)
GET	/api/ebv/runs/[id]	Détail d'un run + artifacts + résumé

Chaque run représente une exécution complète du pipeline génétique. Les statuts possibles sont : pending, running, completed, failed.

Résultats

Méthode	Route	Description
GET	/api/ebv/latest	Derniers résultats (?trait, ?entity_type, ?sort, ?order)
GET	/api/ebv/queens/[id]	EBV d'une reine (?run_id, ?history=true)

Format de réponse EBV

{
  "trait": "honey",
  "raw_value": 2.45,
  "normalized_value": 112,
  "reliability_r2": 0.68,
  "run_id": "uuid-du-run",
  "entity_type": "queen"
}

Champ	Description
trait	Nom du trait (honey, gentleness, vigor, wintering, swarming, comb_sitting, hyg6, hyg24)
raw_value	Valeur brute EBV
normalized_value	Valeur normalisée BeeBreed-like (100 + 10 x (raw - moyenne) / ecart-type)
reliability_r2	Fiabilité r² (0 a 1)
run_id	Identifiant du run de calcul
entity_type	Type d'entité (queen ou worker)

Le paramètre ?history=true sur /api/ebv/queens/[id] retourne l'historique des EBV à travers tous les runs pour visualiser l'évolution.

Compute (admin uniquement)

Les endpoints de calcul déclenchent les différentes étapes du pipeline génétique. Ils nécessitent l'authentification admin (cookie HMAC).

Méthode	Route	Description
POST	/api/env/compute	Pipeline environnement (géocodage + météo)
POST	/api/xgb/compute	Correction XGBoost (effet environnemental)
POST	/api/ebv/compute	BLUPF90 (traits continus : miel)
POST	/api/thrg/compute	THRGIBBS + normalisation (traits ordinaux)
POST	/api/ebv/oneshot	Pipeline complet (env + xgb + blup + thrg)

Admin requis

Les endpoints de compute nécessitent un cookie admin HMAC valide. Ils déclenchent des calculs lourds côté worker et ne doivent être utilisés que par les administrateurs.

---

Voir aussi : Évaluations | Reines | Export