Calculadora de água diária do gado

Contagens inválidas, taxas ausentes ou grupos vazios falham com invalid_input em vez de inventar um total de água.

Como a água de beber diária do gado é calculada

Você informa liters_per_head_day a partir de tabelas de extensão, orientação veterinária, manuais de raça ou do próprio histórico de medidores, e informa head_count para essa classe. Para cada grupo o volume diário em litros é head_count vezes liters_per_head_day vezes climate_factor. O climate_factor tem padrão um, de modo que um plano base de clima ameno é só o produto bruto. O endpoint soma todos os grupos em total_daily_liters e também converte esse total para galões americanos e imperiais com constantes fixas de litros por galão, para que relatórios batam com a medição e com fornecedores de tanques em qualquer sistema de unidades. São devolvidos daily_liters, daily_us_gallons e daily_imp_gallons por grupo para dimensionar linhas de bebedouro por piquete ou seção de curral. Rótulos de classe vazios, taxas de água não positivas e grupos ausentes são rejeitados com invalid_input.

Contrato de entrada, formato da resposta e erros

Linhas aninhadas que não são objetos, rótulos de classe em branco, contagens fracionárias, contagens negativas, taxas zero ou negativas, NaN e Infinity também são rejeitados com mensagens que nomeiam o campo. Falhas de validação não são cobradas. Envie um corpo JSON com groups como array obrigatório de um a cinquenta objetos. Cada objeto deve incluir animal_class como rótulo de string não vazio, head_count como inteiro não negativo e liters_per_head_day como número finito positivo. Aliases são aceitos por conveniência: animals, herd ou stock para o array; class, species, type ou label para o nome da classe; count, heads, n ou animals para a contagem; litres_per_head_day, water_per_head, l_per_head, daily_water_per_head ou liters_per_head para a taxa diária. O climate_factor opcional (aliases factor, heat_factor, multiplier, adjustment) deve ser um número finito positivo quando presente; omita-o para usar um. Se groups estiver ausente, não for array, estiver vazio ou tiver mais de cinquenta entradas, a tarefa falha com invalid_input. Em sucesso o corpo inclui climate_factor, group_count, total_head, um array groups ecoando cada classe limpa com seus volumes diários, total_daily_liters, total_daily_us_gallons, total_daily_imp_gallons, formula reafirmando a identidade da soma, method livestock_water_requirement e uma mensagem curta adequada a logs ou legendas de UI. Exemplo: quarenta vacas leiteiras a cem litros por cabeça e cento e vinte ovelhas a oito litros por cabeça com climate_factor um produzem quatro mil mais novecentos e sessenta, ou seja quatro mil novecentos e sessenta litros por dia. Combine o resultado com a capacidade do tanque e o calendário de enchimento; este endpoint apenas multiplica e soma taxas de consumo e não projeta hidráulica nem protocolos veterinários.

Onde uma API de necessidade de água do gado agrega valor

Aplicativos de gestão rural precisam de um oráculo determinístico para que cada cliente —formulário móvel de campo, planejador de desktop ou importação de planilha— concorde na água diária com as mesmas contagens e taxas por classe. Operações leiteiras e de corte planejam em lote enchimentos de bebedouros e entregas de caminhão-pipa quando o rebanho se move entre piquetes. Cursos de agricultura profissional podem corrigir automaticamente trabalhos de orçamento hídrico sem montar um modelo hidrológico completo. Validação falha não consome saldo. Planejadores de seca de emergência e cooperativas podem recalcular totais com rapidez quando climate_factor sobe em eventos de calor. Como a implementação é parse pura tier A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo e sem rede de saída. Mantenha as solicitações pequenas, fixe total_daily_liters e daily_liters por grupo nos testes, e você obtém orçamentos de água reproduzíveis para ordens de serviço, plugins LMS e workers na borda sem hospedar infraestrutura própria de matemática pecuária. Atualize sempre liters_per_head_day quando mudarem o estágio de lactação, a mistura de espécies ou a estação, e trate climate_factor como um multiplicador transparente documentado para auditores, não como constante oculta enterrada no código.