Племенные ценности (EBV)
Конечные точки /api/ebv предоставляют доступ к результатам генетической оценки: запускам расчётов, EBV по каждой матке и сводным результатам.
Запуски
| Метод | Маршрут | Описание |
|---|---|---|
GET | /api/ebv/runs | Список запусков (?status, ?limit, ?offset) |
GET | /api/ebv/runs/[id] | Детали запуска + артефакты + сводка |
Каждый запуск представляет собой полное выполнение генетического конвейера. Возможные статусы: pending, running, completed, failed.
Результаты
| Метод | Маршрут | Описание |
|---|---|---|
GET | /api/ebv/latest | Последние результаты (?trait, ?entity_type, ?sort, ?order) |
GET | /api/ebv/queens/[id] | EBV для матки (?run_id, ?history=true) |
Формат ответа EBV
{
"trait": "honey",
"raw_value": 2.45,
"normalized_value": 112,
"reliability_r2": 0.68,
"run_id": "uuid-of-the-run",
"entity_type": "queen"
}
| Поле | Описание |
|---|---|
trait | Название признака (honey, gentleness, vigor, wintering, swarming, comb_sitting, hyg6, hyg24) |
raw_value | Исходное значение EBV |
normalized_value | Нормализованное значение по типу BeeBreed (100 + 10 x (raw - mean) / std) |
reliability_r2 | Достоверность r2 (от 0 до 1) |
run_id | Идентификатор запуска расчёта |
entity_type | Тип сущности (queen или worker) |
Параметр ?history=true в /api/ebv/queens/[id] возвращает историю EBV по всем запускам для визуализации изменений во времени.
Расчёт (только администратор)
Конечные точки расчёта запускают различные этапы генетического конвейера. Они требуют аутентификации администратора (HMAC-кука).
| Метод | Маршрут | Описание |
|---|---|---|
POST | /api/env/compute | Конвейер окружающей среды (геокодирование + погода) |
POST | /api/xgb/compute | Коррекция XGBoost (эффект окружающей среды) |
POST | /api/ebv/compute | BLUPF90 (непрерывные признаки: мёд) |
POST | /api/thrg/compute | THRGIBBS + нормализация (порядковые признаки) |
POST | /api/ebv/oneshot | Полный конвейер (env + xgb + blup + thrg) |
Требуется администратор
Конечные точки расчёта требуют действующей HMAC-куки администратора. Они запускают ресурсоёмкие вычисления на воркере и должны использоваться только администраторами.