Como chegamos às respostas.
A interface é curta. A conta não é escondida.
Cotação
O Mercado usa o motor próprio PULSO da COLHEZ pela rota de mesma origem /api/pulso/current. O resultado não copia uma cotação: combina referências independentes do mercado físico do Espírito Santo — CCCV e Cooabriel — com os contratos internacionais ICE Robusta/Coffee C e a PTAX oficial do Banco Central.
O núcleo é um nowcast relativo ancorado. Para cada produto, o preço-base avança pela variação conjunta de ICE e PTAX elevada a uma elasticidade regional versionada. Assim o Conilon não herda 100% de cada oscilação internacional e a Arábica mantém dinâmica própria. CCCV e Cooabriel não entram defasadas: cada cotação física é normalizada por qualidade e trazida do seu horário-base ao mercado atual antes da agregação geométrica.
O motor descarta componentes que se afastem mais de 2,5% do centro robusto. Se ICE ou câmbio falham, o consenso físico assume como contingência com confiança reduzida. As fontes têm caches independentes, single-flight e atualização automática de 15 segundos durante a sessão; a ICE pode fornecer dado atrasado. O Painel do Café nunca é consultado pela aplicação: serve somente como benchmark externo nos testes temporais, cuja tolerância máxima é de 1%.
Previsão e mapa
Temperatura, umidade, chuva, nuvens e vento vêm do MET Norway Locationforecast 2.0, sob CC BY 4.0. É previsão numérica, não medição de uma estação instalada na lavoura. O mapa usa MapLibre, fotografia World Imagery e localidades/vias OpenFreeMap/OpenStreetMap. A posição precisa é diferenciada de uma referência municipal; a malha visual consulta nove pontos e quatro momentos da previsão.
A visualização atmosférica é autoral: a COLHEZ transforma cobertura de nuvens e precipitação desses nove pontos em volumes, campos e filetes sobre o satélite. Ela muda com o horário escolhido e não cria chuva quando a previsão está seca. O mapa orienta; os cards continuam sendo a leitura climática principal.
Todos os instrumentos pertencem a uma leitura identificada. Localização, revisão e horário formam um snapshot; o mapa só aceita uma malha quando esses três dados coincidem com chuva, vento, pulverização e irrigação. Ao mudar o local, a camada anterior é removida antes da nova resposta.
Chuva e pulverização
O sinal de chuva começa em 0,2 mm. A COLHEZ não inventa probabilidade quando a fonte não a fornece. A janela climática compara chuva horária, vento, temperatura e umidade: chuva até 0,1 mm, vento entre 2 e 15 km/h, temperatura até 30 °C e umidade a partir de 55%.
“Favorável” descreve somente o clima. Não autoriza produto, dose, mistura ou aplicação e não substitui bula ou orientação técnica.
Balanço climático da irrigação
A estimativa de 24 horas calcula ET0 pelo método Hargreaves baseado em FAO-56, aplica Kc de referência do café igual a 0,90 e mostra: ETc = ET0 × Kc; saldo = chuva prevista − ETc. A conta fica visível no card.
O saldo não mede umidade do solo, reserva do perfil, eficiência do sistema, idade, densidade ou manejo da lavoura. Por isso informa cobertura climática, não manda ligar ou desligar a bomba.
Localização e atualização
A busca usa um índice local de 5.571 municípios brasileiros. O GPS depende da permissão do navegador. O servidor respeita o cache da fonte, consolida chamadas iguais e pode conservar uma leitura anterior por até seis horas apenas em falha transitória, sempre identificada como atrasada.
Medição do talhão e plantas
Existem três entradas para a mesma conta. No mapa, cada toque cria um vértice em latitude e longitude. Caminhando, o GPS registra o contorno, recusa leituras com erro maior que 30 metros e ignora deslocamentos menores que 2 metros para reduzir ruído parado. Quem já conhece a área pode informar os hectares diretamente.
A área é calculada sobre uma superfície esférica com raio de 6.378.137 metros, convertida de metros quadrados para hectares e exibida com duas casas decimais. O perímetro soma as distâncias geodésicas entre os pontos e fecha o último segmento ao concluir. Se World Imagery atrasar, o mapa-base OpenStreetMap assume automaticamente; a entrada manual permanece disponível mesmo se os dois mapas falharem.
A estimativa de plantas usa somente a conta exposta no card: plantas = área em m² ÷ (espaçamento entre linhas × espaçamento entre plantas). Entradas ausentes, negativas ou iguais a zero não produzem resultado.
É uma estimativa geométrica de consulta, não levantamento cadastral. Precisão do satélite, do GPS, do desenho, fechamento do percurso e falhas ou carreadores do talhão podem alterar o número real.