Valores Geneticos (EBV)

Os endpoints /api/ebv fornecem acesso aos resultados da avaliacao genetica: execucoes de calculo, EBV por rainha e resultados consolidados.

Execucoes

Metodo	Rota	Descricao
GET	/api/ebv/runs	Listar execucoes (?status, ?limit, ?offset)
GET	/api/ebv/runs/[id]	Detalhe da execucao + artefactos + resumo

Cada execucao representa uma execucao completa da pipeline genetica. Os estados possiveis sao: pending, running, completed, failed.

Resultados

Metodo	Rota	Descricao
GET	/api/ebv/latest	Ultimos resultados (?trait, ?entity_type, ?sort, ?order)
GET	/api/ebv/queens/[id]	EBV de uma rainha (?run_id, ?history=true)

Formato de resposta EBV

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

Campo	Descricao
trait	Nome da caracteristica (honey, gentleness, vigor, wintering, swarming, comb_sitting, hyg6, hyg24)
raw_value	Valor bruto do EBV
normalized_value	Valor normalizado estilo BeeBreed (100 + 10 x (bruto - media) / std)
reliability_r2	Fiabilidade r2 (0 a 1)
run_id	Identificacao da execucao de calculo
entity_type	Tipo de entidade (queen ou worker)

O parametro ?history=true em /api/ebv/queens/[id] devolve o historico de EBV ao longo de todas as execucoes para visualizar a evolucao no tempo.

Calcular (apenas admin)

Os endpoints de calculo ativam as diferentes fases da pipeline genetica. Requerem autenticacao de administrador (cookie HMAC).

Metodo	Rota	Descricao
POST	/api/env/compute	Pipeline ambiental (geocodificacao + meteorologia)
POST	/api/xgb/compute	Correcao XGBoost (efeito ambiental)
POST	/api/ebv/compute	BLUPF90 (caracteristicas continuas: mel)
POST	/api/thrg/compute	THRGIBBS + normalizacao (caracteristicas ordinais)
POST	/api/ebv/oneshot	Pipeline completa (env + xgb + blup + thrg)

Admin necessario

Os endpoints de calculo requerem um cookie HMAC admin valido. Ativam calculos pesados no worker e devem ser utilizados apenas por administradores.

---

Ver tambem: Avaliacoes | Rainhas | Exportacao