Valores geneticos (EBV)

Los endpoints /api/ebv proporcionan acceso a los resultados de la evaluacion genetica: ejecuciones de calculo, EBV por reina y resultados consolidados.

Ejecuciones

Metodo	Ruta	Descripcion
GET	/api/ebv/runs	Listar ejecuciones (?status, ?limit, ?offset)
GET	/api/ebv/runs/[id]	Detalle de la ejecucion + artefactos + resumen

Cada ejecucion representa una ejecucion completa del pipeline genetico. Los estados posibles son: pending, running, completed, failed.

Resultados

Metodo	Ruta	Descripcion
GET	/api/ebv/latest	Ultimos resultados (?trait, ?entity_type, ?sort, ?order)
GET	/api/ebv/queens/[id]	EBV de una reina (?run_id, ?history=true)

Formato de respuesta EBV

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

Campo	Descripcion
trait	Nombre del caracter (honey, gentleness, vigor, wintering, swarming, comb_sitting, hyg6, hyg24)
raw_value	Valor bruto del EBV
normalized_value	Valor normalizado tipo BeeBreed (100 + 10 x (bruto - media) / desv. tipica)
reliability_r2	Fiabilidad r2 (0 a 1)
run_id	Identificador de la ejecucion de calculo
entity_type	Tipo de entidad (queen o worker)

El parametro ?history=true en /api/ebv/queens/[id] devuelve el historial de EBV a lo largo de todas las ejecuciones para visualizar la evolucion en el tiempo.

Calculo (solo administrador)

Los endpoints de calculo desencadenan las diferentes etapas del pipeline genetico. Requieren autenticacion de administrador (cookie HMAC).

Metodo	Ruta	Descripcion
POST	/api/env/compute	Pipeline ambiental (geocodificacion + meteorologia)
POST	/api/xgb/compute	Correccion XGBoost (efecto ambiental)
POST	/api/ebv/compute	BLUPF90 (caracteres continuos: miel)
POST	/api/thrg/compute	THRGIBBS + normalizacion (caracteres ordinales)
POST	/api/ebv/oneshot	Pipeline completo (env + xgb + blup + thrg)

Se requiere administrador

Los endpoints de calculo requieren una cookie HMAC de administrador valida. Desencadenan calculos intensivos en el worker y solo deben ser utilizados por administradores.

---

Vea tambien: Evaluaciones | Reinas | Exportacion