Manual do Sistema
Bioflux Calculadora
Documentação completa sobre o funcionamento, arquitetura, amparo legal, autoria e propriedade intelectual da Calculadora Técnica de Dose v4.0.
Visão Geral do Sistema
A Calculadora Técnica Bioflux é uma ferramenta digital de suporte agronômico que automatiza o cálculo de doses, a recomendação de produtos, o diagnóstico climático e a geração de laudos técnicos de aplicação.
Fornecer ao técnico de campo e ao produtor rural um diagnóstico rápido, confiável e baseado em dados reais para orientar a aplicação foliar dos produtos Bioflux com segurança e eficiência.
v4.0 — Motor de cálculo multi-produto com banco de dados agronômico completo, validação climática dinâmica, diagnóstico de solo e geração de laudo técnico em PDF.
HTML5 + CSS3 + JavaScript puro (sem frameworks). APIs externas: Open-Meteo (clima) e OpenStreetMap / Nominatim (geocodificação). Persistência via localStorage.
Funciona em qualquer navegador moderno (Chrome, Firefox, Edge, Safari). Responsivo para desktop, tablet e smartphone. Funciona sem internet para cálculos (apenas clima requer conexão).
Como Usar a Calculadora
Guia completo e detalhado de todas as funcionalidades da calculadora — do primeiro acesso à geração do laudo técnico. Cada etapa inclui dicas práticas, alertas de atenção e exemplos reais de uso.
Digite o nome do município ou da propriedade rural no campo de busca e pressione o botão de lupa (🔍) ou tecle Enter. O sistema usa a API Nominatim/OpenStreetMap para converter o texto em coordenadas geográficas (latitude/longitude).
Após a busca bem-sucedida, o sistema exibe automaticamente:
Mapa interativo da região via OpenStreetMap, centralizado nas coordenadas encontradas para confirmação visual da localização.
Temperatura, umidade relativa, velocidade do vento e precipitação no momento da consulta, via API Open-Meteo.
Badge colorido indicando se as condições climáticas atuais são Ideais, requerem Atenção ou devem ser Evitadas.
Calendário com a janela de aplicação dos próximos 7 dias, com ícones coloridos por dia e resumo das condições esperadas.
Informe a área total da lavoura que receberá a aplicação. Use os botões [ha] ou [alq] para selecionar a unidade antes de digitar o valor.
Ex: 10 alq → 24,2 ha | 50 ha → 20,66 alq
Defina o volume de calda que seu pulverizador aplica por hectare. O valor padrão é 200 L/ha, mas pode variar de acordo com o equipamento e a cultura:
| Equipamento | Volume típico | Observação |
|---|---|---|
| Pulverizador tratorizado (barra) | 100–150 L/ha | Soja e grãos |
| Pulverizador autopropelido | 80–120 L/ha | Alta eficiência |
| Pulverizador costal motorizado | 200–300 L/ha | Hortifrúti e café |
| Drone agrícola | 15–30 L/ha | Alta concentração |
| Aviação agrícola | 20–40 L/ha | Consultar técnico |
Clique no dropdown "Cultura Principal" e selecione a cultura que será tratada. O sistema atualiza instantaneamente o painel de produtos recomendados, mostrando apenas os produtos com dados de dose validados para aquela cultura.
Os produtos são exibidos com badges de prioridade:
Produto central do programa nutricional da cultura. Deve sempre compor o tanque na aplicação base. Ex: CoMoNi Flux para Soja (fixação biológica de N).
Complementa a nutrição foliar com nutrientes específicos conforme a fase da cultura. Indicado para a maioria das situações.
Para situações específicas de deficiência identificada ou intensificação do programa. Avalie com auxílio de análise de solo ou diagnóstico visual.
Reguladores de pH, compatibilizadores e espalhantes adesivos. Adicionados ao mix conforme a composição e necessidade de cada programa.
Existem três formas de adicionar produtos ao tanque:
Adiciona de uma só vez todos os produtos marcados como Essencial para a cultura selecionada. É a forma mais rápida para montar o mix base recomendado. Ideal para diagnósticos rápidos no campo.
Clique no switch/botão de cada produto individualmente no painel de recomendações. Permite selecionar exatamente quais produtos entram no mix com controle total.
Use o seletor "Adicionar produto ao mix" para buscar e adicionar qualquer produto do catálogo Bioflux, independente de estar listado nas recomendações da cultura atual.
🔢 Ordem Técnica de Mistura no Tanque
O sistema organiza automaticamente os produtos na sequência correta de adição ao tanque, baseada na compatibilidade química e nos parâmetros agronômicos de cada produto:
Com o tanque montado e a área preenchida, o painel de resultados exibe as doses calculadas para cada produto. Os dados são recalculados automaticamente a cada modificação:
Quantidade total do produto necessária para cobrir toda a área informada. Exibida em L ou mL, com conversão automática para L quando o valor supera 1.000 mL.
Quantidade do produto por hectare, conforme especificação técnica de cada produto para aquela cultura. Base para calibração do pulverizador.
Período após a aplicação durante o qual o produto não deve ser reaplicado ou a cultura não deve ser colhida. "Isento" significa sem restrição de carência.
Intervalo mínimo recomendado entre aplicações sequenciais do mesmo produto para máxima eficiência sem risco de fitotoxicidade.
Estágio fenológico ideal para aplicação do produto naquela cultura. Ex: "V3–V5 pré-florada", "Pós-corte", "Botão floral".
Temperatura, umidade, vento e horário recomendado para cada produto. Se o clima atual (passo 1) não atender esses parâmetros, o sistema sinaliza visualmente.
🔎 Validação Técnica do Tanque
Abaixo do tanque, o sistema exibe uma barra de chips coloridos com a validação das condições climáticas em tempo real, considerando o limite mais restritivo entre todos os produtos do mix:
Com o mix configurado, dois botões de ação ficam disponíveis na parte inferior do painel de resultados:
Abre uma nova aba com o laudo completo em HTML, contendo todas as doses calculadas, ordem de mistura, condições climáticas, boas práticas e avisos legais. Use Ctrl+P ou o botão "🖨️ Imprimir / Salvar PDF" para exportar em PDF.
Gera e abre uma mensagem formatada no WhatsApp com o resumo técnico da consulta: cultura, área, local, produtos e doses. Ideal para enviar ao produtor ou ao agrônomo responsável.
🔧 Funcionalidades Adicionais
Ative o painel "Diagnóstico de Solo & Sintomas" clicando no toggle ao lado do título. Preencha os dados do laudo de análise de solo (pH, V%, M.O., Boro, Zinco, Manganês) e selecione os sintomas visuais observados na lavoura (clorose, necrose, deformação etc.). O sistema cruza esses dados e gera uma lista priorizada de produtos recomendados para correção.
Todo o progresso da consulta (área, unidade, cultura, tanque, localização) é salvo automaticamente no navegador via localStorage a cada alteração. Ao reabrir a calculadora — mesmo dias depois — os dados são restaurados exatamente como estavam. Não é necessário cadastro ou login.
O botão "🔄 Nova Consulta" no topo direito da tela limpa todos os dados da sessão atual: área, cultura, tanque, localização, diagnóstico de solo e sintomas. Uma janela de confirmação é exibida antes de prosseguir para evitar limpeza acidental.
❓ Dúvidas Frequentes
▶ O sistema funciona sem internet?
Sim. Todos os cálculos de dose, recomendações por cultura e geração de laudo funcionam sem conexão. Apenas a busca de localização por nome e o diagnóstico climático em tempo real requerem internet, pois usam as APIs externas Open-Meteo e Nominatim.
▶ Posso usar em celular?
Sim. A calculadora é responsiva e funciona em smartphones e tablets. Para melhor experiência no campo, recomendamos salvar o arquivo calc.html na memória do dispositivo e abrir diretamente pelo navegador — sem necessidade de conexão para uso básico.
▶ O laudo não abriu. O que fazer?
O laudo tenta abrir via window.open(). Se o navegador bloquear pop-ups, o sistema usa automaticamente um Blob URL como alternativa, que esmaga o bloqueio de pop-up em quase todos os browsers. Se ainda assim não abrir, verifique se o bloqueador de pop-ups do browser está ativo e permita pop-ups para a calculadora.
▶ Por que o limite de vento muda conforme os produtos?
Cada produto tem uma especificação de vento máximo em sua ficha técnica. O sistema calcula o limite mais restritivo entre todos os produtos do mix atual e aplica esse valor como o limite da aplicação. Isso garante segurança para todos os produtos ao mesmo tempo.
▶ Os dados ficam salvos entre sessões?
Sim. O sistema usa localStorage do navegador para persistir o estado da consulta. Os dados permanecem salvos até que você clique em "🔄 Nova Consulta" ou limpe manualmente os dados do navegador. Cada visitante tem seu próprio armazenamento local — os dados não são enviados a nenhum servidor.
📌 Exemplo Prático: Soja 100ha, Paraná
Motor de Cálculo
O cálculo é centralizado na função updateAllCalculations(), que é disparada a cada interação do usuário. Todas as doses são calculadas dinamicamente com base nos parâmetros de área, cultura e volume de calda.
📐 Fórmulas de Cálculo
Dose Total (mín) = dose_min_L_ha × área_ha
Dose Total (máx) = dose_max_L_ha × área_ha
// Produtos percentuais (adjuvantes/compatibilizadores)
Dose Total (mín) = (dose_min_% / 100) × área_ha × calda_L_ha
Dose Total (máx) = (dose_max_% / 100) × área_ha × calda_L_ha
// Conversão de unidades automática
If mL_total ≥ 1000 → exibir em L (dividir por 1000)
🌬️ Validação Climática Dinâmica
O limite de vento máximo (maxWind) é calculado dinamicamente a partir dos produtos no tanque, usando o produto mais restritivo:
maxWind = min(vento_limite_produto_1, vento_limite_produto_2, ..., 15)
Regras de aptidão climática para aplicação:
💾 Persistência de Estado
O estado completo da sessão (área, cultura, tanque, localização) é salvo automaticamente no localStorage com a chave bioflux_v4. Ao recarregar a página, os dados são restaurados. O botão "🔄 Nova Consulta" limpa completamente esse estado.
Banco de Produtos
O sistema possui um banco de dados agronômico completo com todos os produtos Bioflux. Cada produto contém dados de dose por cultura, condições ideais de aplicação, ordem de mistura e carência.
| Produto | Tipo | Unidade | Ordem Mistura | Carência | Reaplicar |
|---|---|---|---|---|---|
| 🧬 CoMo Flux | Biofertilizante Co+Mo | mL/ha | 3ª | Isento | 10 dias |
| ⚗️ CoMoNi Flux | Biofertilizante Co+Mo+Ni | mL/ha | 3ª | Isento | 14 dias |
| 🌿 Zinco Flux | Fertilizante foliar Zn | L/ha | 2ª | Isento | 14 dias |
| 🌱 Kapa Flux | Bioestimulante K | L/ha | 3ª | Isento | 14 dias |
| 🌿 Asco Flux | Bioestimulante fisiológico | L/ha | 3ª | Isento | 10 dias |
| 🔵 Folium Boro | Fertilizante foliar B | L/ha | 3ª | 7 dias | 21 dias |
| 🟤 Folium Mn | Fertilizante foliar Mn | L/ha | 2ª | 7 dias | 14 dias |
| 🟡 Folium Zn | Fertilizante foliar Zn (aminoácidos) | L/ha | 2ª | 7 dias | 14 dias |
| 🟢 Folium Mg | Fertilizante foliar Mg | L/ha | 2ª | 7 dias | 14 dias |
| 🌈 Folium Total | Fertilizante multi-micronutriente | L/ha | 2ª | 7 dias | 14 dias |
| 🧬 Equalize Flux | Adjuvante regulador de pH | % calda | 1ª | Isento | — |
| 🔗 Compative Flux | Compatibilizador | % calda | 1ª | Isento | — |
| 🍋 Citro Flux | Adjuvante ácido | % calda | 1ª | Isento | — |
| 💧 Co-Adjuvan Flux | Espalhante-adesivo | % calda | 4ª/5ª | Isento | — |
🌾 Culturas Suportadas
Diagnóstico Climático
O sistema integra duas APIs públicas para fornecer dados de clima em tempo real sem necessidade de chaves de API pagas.
Converte o nome da cidade digitada em coordenadas geográficas (latitude e longitude) usando a API pública do Nominatim. Retorna também o nome formatado da cidade e estado para exibição no mapa e laudo.
Com as coordenadas obtidas, busca dados climáticos atuais (temperatura, umidade, vento, chuva) e previsão dos próximos 7 dias. Gratuita, sem limite de requisições para uso não comercial.
📅 Previsão de 7 dias
O sistema exibe a janela de aplicação dos próximos 7 dias com cores indicativas: ✅ Verde = dia favorável, ⚠️ Amarelo = atenção, 🔴 Vermelho = evitar aplicação.
Diagnóstico de Solo
Módulo de interpretação de laudos de análise de solo que cruza os valores informados com os limites agronômicos e gera recomendações de produtos para correção de deficiências identificadas.
Parâmetros AvaliadosLaudo Técnico — 6 Páginas
O laudo é gerado dinamicamente em HTML completo, abrindo em nova aba. Com a atualização mais recente, o documento foi expandido para 6 páginas detalhadas, cada uma com conteúdo específico e numeração própria. Pronto para impressão ou exportação como PDF.
🖨️ Como Gerar e Exportar o Laudo
Área preenchida + cultura selecionada + pelo menos 1 produto no tanque. Sem esses dados, o botão de laudo exibe um alerta.
O sistema abre uma nova aba com as 6 páginas do laudo. Se o pop-up for bloqueado, automaticamente usa um Blob URL como fallback.
No laudo aberto, clique em "🖨️ Imprimir / Salvar PDF" → na janela de impressão do navegador, altere o destino para "Salvar como PDF" → clique Salvar. O laudo inclui quebras de página automáticas entre seções.
Compartilhamento via WhatsApp
O sistema oferece dois pontos de acesso ao WhatsApp com funções distintas:
Acesso direto ao WhatsApp do setor técnico da Bioflux Fertilizantes para suporte, orientação agronômica personalizada e esclarecimento de dúvidas. Disponível em todas as telas.
Gera uma mensagem formatada com cultura, área, volume de calda, localização e as doses mínima–máxima de cada produto do tanque. Usa encodeURIComponent e abre wa.me/?text= para compartilhamento universal.
Identificação de Autoria
Este sistema foi concebido, projetado e desenvolvido integralmente por uma única pessoa, sem uso de plataformas de geração automática de código ou terceirização de desenvolvimento.
bioflux_v4) — sem banco de dados externo, sem servidor
Amparo Legal e Responsabilidade
Para garantir a conformidade com as normas brasileiras de prescrição agronômica, o sistema incorpora travas de segurança e avisos obrigatórios em todas as telas e nos laudos gerados.
Propriedade Intelectual
O sistema Bioflux Calculadora Técnica de Dose é obra protegida pela legislação brasileira de propriedade intelectual. Todos os elementos — interface, lógica de cálculo, banco de dados agronômico e design visual — são de autoria de Tiago Antonio Stankievicz.
(a) Reproduzir total ou parcialmente o software, sua interface, ou sua lógica de cálculo sem autorização prévia por escrito do autor.
(b) Modificar, descompilar, fazer engenharia reversa ou criar obras derivadas sem autorização.
(c) Sublicenciar, vender, transferir ou ceder o sistema a terceiros.
(d) Remover ou alterar os avisos de autoria, copyright ou propriedade intelectual presentes no código ou na interface.
📋 Base Legal
Restrição de Inteligência Artificial
Diante dos novos desafios impostos pelas ferramentas de inteligência artificial generativa, o autor estabelece expressamente as seguintes vedações adicionais às proteções legais já vigentes.
(a) Leitura, extração ou análise do código-fonte deste sistema com finalidade de replicação, aprendizado de máquina ou geração de sistema semelhante.
(b) Engenharia reversa assistida por IA, incluindo o uso de ferramentas como ChatGPT, Claude, Gemini, Copilot ou similares para recriar a lógica, o banco de dados agronômico ou o design deste sistema.
(c) Alimentar LLMs (Large Language Models) ou datasets de treinamento com trechos ou a totalidade do código-fonte, interface ou documentação deste software.
(d) Uso de web scrapers, bots ou agentes automatizados para capturar dados, estrutura ou comportamento do sistema.
⚖️ Enquadramento Legal
O uso de IA para reprodução de software protegido é enquadrável como violação da Lei nº 9.609/98 (Lei de Software) e da Lei nº 9.610/98 (Lei de Direitos Autorais), além de potencialmente caracterizar concorrência desleal nos termos da Lei nº 9.279/96 (Propriedade Industrial).
© 2026 Bioflux Fertilizantes Ltda · Sistema desenvolvido por Tiago Antonio Stankievicz · Todos os direitos reservados.
www.bioflux.com.br · (42) 2702-0510 · (42) 93505-9422