Évaluations

Les endpoints /api/queens/evaluations permettent d'enregistrer et de consulter les évaluations terrain des reines. BeePass utilise 8 traits pour l'évaluation génétique.

Endpoints

Méthode	Route	Description
GET	/api/queens/evaluations	Liste des évaluations
POST	/api/queens/evaluations	Créer une évaluation
GET	/api/queens/evaluations/[id]	Détail d'une évaluation
PUT	/api/queens/evaluations/[id]	Modifier une évaluation
DELETE	/api/queens/evaluations/[id]	Supprimer une évaluation
POST	/api/queens/evaluations/bulk	Import batch (max 200)

Champs

Champ	Type	Requis	Description
queen_id	uuid	Oui	ID de la reine F0 évaluée
eval_year	integer	Oui	Année d'évaluation
honey_yield_kg	number	Non	Production de miel (kg)
gentleness	1-4	Non	Douceur
vigor	1-4	Non	Vigueur
wintering	1-4	Non	Hivernage
swarming	1-4	Non	Non-essaimage
comb_sitting	1-4	Non	Tenue de cadre
hyg6_cleaned	0-50	Non	Cellules nettoyées à 6h (Pin Test)
hyg24_cleaned	0-50	Non	Cellules nettoyées à 24h (Pin Test)
country_code	string	Non	Code pays ISO 3166
postal_code	string	Non	Code postal de l'exploitation

Traits ordinaux

Les traits gentleness, vigor, wintering, swarming et comb_sitting utilisent une échelle de 1 (mauvais) à 4 (excellent). Les traits hygiéniques (hyg6_cleaned, hyg24_cleaned) représentent le nombre de cellules nettoyées sur 50 (Pin Test).

Import batch

L'endpoint bulk accepte un tableau d'évaluations (maximum 200 par requête) :

POST /api/queens/evaluations/bulk

[
  {
    "queen_id": "uuid-reine-1",
    "eval_year": 2025,
    "honey_yield_kg": 32.5,
    "gentleness": 3,
    "vigor": 4
  },
  {
    "queen_id": "uuid-reine-2",
    "eval_year": 2025,
    "honey_yield_kg": 28.0,
    "hyg6_cleaned": 42,
    "hyg24_cleaned": 48
  }
]

• Le champ owner_id est forcé côté serveur (session authentifiée)
• Le champ evaluation_source est automatiquement défini à import
• Les évaluations invalides sont rejetées individuellement (les valides sont insérées)

---

Voir aussi : Reines | EBV | Export