Calculateur d'eau quotidienne du bétail

Compteurs invalides, taux manquants ou groupes vides échouent avec invalid_input au lieu d'inventer un total d'eau.

Comment l'eau de boisson quotidienne du bétail est calculée

Vous fournissez liters_per_head_day à partir de tables d'extension, de conseils vétérinaires, de manuels de race ou de votre historique de compteurs, et vous fournissez head_count pour cette classe. Pour chaque groupe, le volume quotidien en litres est head_count multiplié par liters_per_head_day multiplié par climate_factor. Le climate_factor vaut un par défaut, de sorte qu'un plan de base par temps doux n'est que le produit brut. L'endpoint additionne tous les groupes en total_daily_liters et convertit aussi ce total en gallons US et impériaux avec des constantes fixes de litres par gallon, afin que les rapports correspondent au comptage et aux fournisseurs de citernes dans l'un ou l'autre système d'unités. Les champs daily_liters, daily_us_gallons et daily_imp_gallons par groupe permettent de dimensionner les lignes d'abreuvoirs par parcelle ou section d'étable. Étiquettes de classe vides, taux d'eau non positifs et groupes manquants sont rejetés avec invalid_input.

Contrat d'entrée, forme de la réponse et erreurs

Les lignes imbriquées qui ne sont pas des objets, les étiquettes de classe vides, les effectifs fractionnaires, les effectifs négatifs, les taux nuls ou négatifs, NaN et Infinity sont également rejetés avec des messages nommant le champ. Les échecs de validation ne sont pas facturés. Envoyez un corps JSON avec groups comme tableau obligatoire d'un à cinquante objets. Chaque objet doit inclure animal_class comme étiquette chaîne non vide, head_count comme entier non négatif et liters_per_head_day comme nombre fini positif. Des alias sont acceptés par commodité : animals, herd ou stock pour le tableau ; class, species, type ou label pour le nom de classe ; count, heads, n ou animals pour l'effectif ; litres_per_head_day, water_per_head, l_per_head, daily_water_per_head ou liters_per_head pour le taux quotidien. Le climate_factor optionnel (alias factor, heat_factor, multiplier, adjustment) doit être un nombre fini positif lorsqu'il est présent ; omettez-le pour utiliser un. Si groups est absent, n'est pas un tableau, est vide ou dépasse cinquante entrées, la tâche échoue avec invalid_input. En cas de succès, le corps inclut climate_factor, group_count, total_head, un tableau groups reprenant chaque classe nettoyée avec ses volumes quotidiens, total_daily_liters, total_daily_us_gallons, total_daily_imp_gallons, formula reformulant l'identité de la somme, method livestock_water_requirement et un court message adapté aux journaux ou légendes d'UI. Exemple : quarante vaches laitières à cent litres par tête et cent vingt ovins à huit litres par tête avec climate_factor un donnent quatre mille plus neuf cent soixante, soit quatre mille neuf cent soixante litres par jour. Associez le résultat à votre capacité de citerne et à votre calendrier de remplissage ; cet endpoint multiplie et additionne seulement les taux d'abreuvement et ne conçoit ni la plomberie ni les protocoles vétérinaires.

Où une API de besoin en eau du bétail est utile

Les applications de gestion agricole ont besoin d'un oracle déterministe pour que chaque client —formulaire mobile de terrain, planificateur de bureau ou import de tableur— s'accorde sur l'eau quotidienne avec les mêmes effectifs et taux par classe. Les exploitations laitières et viande planifient par lots les remplissages d'abreuvoirs et les livraisons de camions-citernes lorsque le stock change de parcelle. Les formations agricoles professionnelles peuvent noter automatiquement des devoirs de budget hydrique sans monter un modèle hydrologique complet. Une validation échouée ne consomme pas le solde. Les planificateurs de sécheresse d'urgence et les coopératives peuvent recalculer rapidement les totaux lorsque climate_factor augmente lors d'épisodes de chaleur. Comme l'implémentation est parse pure de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle et sans réseau sortant. Gardez les requêtes petites, figez total_daily_liters et daily_liters par groupe dans les tests, et vous obtenez des budgets d'eau reproductibles pour ordres de travail, plugins LMS et workers en bordure sans héberger votre propre infrastructure mathématique d'élevage. Actualisez toujours liters_per_head_day lorsque changent le stade de lactation, le mélange d'espèces ou la saison, et traitez climate_factor comme un multiplicateur transparent documenté pour les auditeurs, non comme une constante cachée enfouie dans le code.