Valori genetici (EBV)

Gli endpoint /api/ebv danno accesso ai risultati delle valutazioni genetiche: esecuzioni di calcolo, EBV per regina e risultati consolidati.

Esecuzioni

Metodo	Rotta	Descrizione
GET	/api/ebv/runs	Elenco delle esecuzioni (?status, ?limit, ?offset)
GET	/api/ebv/runs/[id]	Dettaglio di un'esecuzione + artefatti + riepilogo

Ogni esecuzione rappresenta un lancio completo della pipeline genetica. Gli stati possibili sono: pending, running, completed, failed.

Risultati

Metodo	Rotta	Descrizione
GET	/api/ebv/latest	Ultimi risultati (?trait, ?entity_type, ?sort, ?order)
GET	/api/ebv/queens/[id]	EBV di una regina (?run_id, ?history=true)

Formato di risposta EBV

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

Campo	Descrizione
trait	Nome del carattere (honey, gentleness, vigor, wintering, swarming, comb_sitting, hyg6, hyg24)
raw_value	Valore grezzo EBV
normalized_value	Valore normalizzato BeeBreed-like (100 + 10 x (grezzo - media) / deviazione standard)
reliability_r2	Affidabilità r² (da 0 a 1)
run_id	Identificativo dell'esecuzione di calcolo
entity_type	Tipo di entità (queen o worker)

Il parametro ?history=true su /api/ebv/queens/[id] restituisce lo storico degli EBV attraverso tutte le esecuzioni per visualizzarne l'evoluzione.

Calcolo (solo admin)

Gli endpoint di calcolo avviano le diverse fasi della pipeline genetica. Richiedono l'autenticazione admin (cookie HMAC).

Metodo	Rotta	Descrizione
POST	/api/env/compute	Pipeline ambiente (geocodifica + meteo)
POST	/api/xgb/compute	Correzione XGBoost (effetto ambientale)
POST	/api/ebv/compute	BLUPF90 (caratteri continui: miele)
POST	/api/thrg/compute	THRGIBBS + normalizzazione (caratteri ordinali)
POST	/api/ebv/oneshot	Pipeline completa (env + xgb + blup + thrg)

Admin richiesto

Gli endpoint di calcolo richiedono un cookie admin HMAC valido. Avviano calcoli intensivi lato worker e devono essere utilizzati esclusivamente dagli amministratori.

---

Vedi anche: Valutazioni | Regine | Esportazione