Calculadora de Campo

1. OBJETIVO

Para que serve a Calculadora de Campo

A Calculadora de Campo H3M foi criada para apoiar o supervisor e a equipe operacional no planejamento e acompanhamento de atividades ambientais em campo.

O sistema não é uma ferramenta de compras. Ele serve para estimar materiais, organizar estoque, planejar metas por projeto, registrar produção diária, calcular custo previsto e acompanhar o que foi planejado contra o que foi realizado.

2. LÓGICA DO SISTEMA

Como as informações se conectam

A lógica principal é simples: o estoque central alimenta o projeto, o projeto recebe calculadoras e metas, a produção diária alimenta o realizado, e os painéis do supervisor e do projeto comparam o planejado com o executado.

1. Estoque central: armazena insumos, unidade, saldo, custo unitário e valor total.
2. Projeto: organiza responsável, área, local, datas, talhões, calculadoras, insumos previstos e metas.
3. Calculadoras: estimam quantidades técnicas, como mudas, hidrogel, adubo, água, mourões, arames, biomanta e sementes. A conta rápida pode ser usada isolada ou vinculada ao projeto.
4. Estoque previsto do projeto: mostra o que será necessário retirar do estoque e qual custo estimado.
5. Produção diária: registra o que foi executado por dia, equipe, H/T, talhão e atividade.
6. Consumo estimado: registra a baixa estimada do estoque para um projeto e atualiza saldo.
7. Painel do supervisor: resume projetos abertos, em andamento e encerrados, avanço geral, pendência e custo previsto de estoque.
8. Painel do projeto: compara planejado x realizado, mostra análises salvas, pendências, custo previsto, consumo registrado e evolução diária.

3. PERFIS DE ACESSO

Quem vê e quem altera cada informação

A Calculadora de Campo deve trabalhar com hierarquia de acesso. A prévia local simula essa regra na interface; na VPS, a validação precisa acontecer no login, no banco de dados e nas rotas do módulo.

4. FLUXO RECOMENDADO

Ordem ideal de uso

1. Abra o app e acesse Estoque para conferir ou cadastrar os insumos principais.
2. Acesse Projeto e selecione um projeto existente ou clique em Novo projeto.
3. Preencha Dados: nome, responsável, área total, local/base e datas previstas.
4. Preencha Talhões: divida a área total em talhões ou frentes internas.
5. Preencha Cálculos: selecione a calculadora necessária e gere a estimativa.
6. Use Usar insumos sugeridos no projeto quando quiser levar o resultado da calculadora para o estoque previsto.
7. Preencha Estoque: revise quantidades, custo previsto, saldo e possível falta.
8. Preencha Metas: defina atividade, talhão, meta e unidade de controle.
9. Clique em Salvar projeto.
10. No fim do dia, acesse Diário e registre a produção executada.
11. Acesse Supervisor para ver a carteira geral ou Projeto > Acompanhar para ver planejado x realizado de um projeto específico.
12. Quando houver retirada ou uso estimado de material, acesse Consumo e registre a baixa estimada.

5. PROJETO

Como abrir, criar ou editar um projeto

A tela de projeto é dividida em três áreas: Abrir projeto, Planejar e Acompanhar.

Passo a passo para criar projeto

1. Entre em Projeto.
2. Clique em Novo projeto.
3. Na etapa Dados, informe o nome ou número do projeto.
4. Informe o responsável. Se necessário, use o botão + para incluir novo nome na base suspensa.
5. Informe área total em hectares, local/base, início previsto e término previsto.
6. Continue para Talhões, Cálculos, Estoque e Metas.
7. Clique em Salvar projeto para confirmar.

6. TALHÕES

Como dividir a área do projeto

Talhão é a divisão interna da área do projeto. Ele pode representar uma frente de serviço, gleba, trecho ou área operacional.

1. Na tela Projeto > Planejar > Talhões, clique em Adicionar talhão.
2. Informe o nome, por exemplo: Talhão 1, Talhão 2 ou Frente Norte.
3. Informe a área em hectares.
4. Inclua observações se houver restrição de acesso, prioridade, pendência ou característica local.
5. Confira o resumo: o app mostra se a soma dos talhões está igual, abaixo ou acima da área total do projeto.

7. CALCULADORAS

Como usar os cálculos dentro do projeto

As calculadoras ajudam a estimar quantitativos técnicos antes da execução. A Calculadora rápida serve para simulação avulsa e pode vincular o resultado ao projeto. Dentro do projeto, elas são usadas uma por vez para evitar excesso de informação na tela.

Módulos disponíveis

• Plantio florestal: calcula mudas, taxa de mortalidade, água, adubo, hidrogel seco e hidrogel preparado.
• Cercamento: calcula mourões, arame, grampos, esticadores e custo estimado por metro.
• Irrigação: calcula volume de água, volume por irrigação e viagens de caminhão-pipa.
• Adubação: converte dose por hectare, aplicações e dose por muda.
• Bioengenharia: calcula biomanta, grampos, sementes, adubo e água.

Passo a passo

1. Acesse Projeto > Planejar > Cálculos.
2. Escolha o tipo de cálculo no campo suspenso.
3. Preencha os campos técnicos do módulo.
4. Clique em Calcular este módulo.
5. Revise o resultado estimado.
6. Se o resultado fizer parte do planejamento, clique em Usar insumos sugeridos no projeto.

8. ESTOQUE

Como cadastrar, filtrar e usar insumos

O estoque central guarda a base de insumos usada nos cálculos e nos consumos estimados. Cada item possui saldo, unidade, custo unitário e valor total calculado.

Cadastrar ou atualizar insumo

1. Acesse Estoque.
2. Informe o nome do insumo.
3. Escolha a unidade: un., kg, g, L, m, m², m³, sc ou cx.
4. Informe o saldo atual.
5. Informe o custo unitário considerado.
6. Confira o valor total calculado.
7. Inclua observações se necessário.
8. Clique em Salvar no estoque.

Regra de atualização

Se o nome do insumo já existir, o sistema soma o saldo informado ao saldo atual, atualiza o custo unitário e recalcula o valor total.

Filtros disponíveis

• Todos os itens: mostra tudo que está cadastrado.
• Com saldo: mostra itens com quantidade maior que zero.
• Saldo baixo: mostra itens com quantidade entre 1 e 10 na unidade cadastrada.
• Saldo zerado: mostra itens sem saldo disponível.
• Buscar insumo: filtra por nome, unidade ou observação.

9. METAS

Como definir o planejado

Meta é o que precisa ser executado. Ela pode ser vinculada ao projeto geral ou a um talhão específico.

1. Acesse Projeto > Planejar > Metas.
2. Escolha a atividade: Cerca, Plantio Total, Plantio Enriquecido ou Manutenção do Plantio.
3. Selecione o talhão, se a meta for específica de uma área.
4. Informe o valor da meta.
5. Escolha a unidade: ha, m², m, un., kg, L ou un./m.
6. Salve o projeto.

10. PRODUÇÃO DIÁRIA

Como registrar o executado em campo

A produção diária é o registro operacional do que foi feito no dia. Ela alimenta o painel de planejado x realizado.

1. Acesse Diário.
2. Selecione o projeto.
3. Informe a data da produção.
4. Escolha a frente de serviço.
5. Escolha o talhão, se aplicável.
6. Informe número de colaboradores e H/T do dia.
7. Informe os quantitativos executados.
8. Confira a prévia: produção total, área executada, produção por colaborador e produção por H/T.
9. Clique em Salvar produção.

Campos por atividade

• Cerca: covas, mourões e arames fixados em metros.
• Plantio Total: área executada em m², covas, coroas, adubação e plantio.
• Plantio Enriquecido: área executada em m², covas, coroas, adubação e plantio.
• Manutenção do Plantio: área executada em m², covas, cordas, adubação e replantio.

11. CONSUMO E CUSTO

Como registrar uma baixa estimada

O consumo estimado registra o uso de insumos do estoque em um projeto. Ele atualiza saldo e mantém custo vinculado ao projeto.

1. Acesse Consumo.
2. Informe responsável pelo lançamento, unidade/base, projeto e atividade.
3. Selecione o insumo do estoque.
4. Informe quantidade usada.
5. Confira unidade e custo unitário puxados do estoque.
6. Confira o custo total antes de salvar.
7. Informe data, local e observações.
8. Clique em Salvar consumo.

12. ACOMPANHAMENTO

Como interpretar o painel do projeto

O painel do projeto mostra a leitura gerencial do trabalho. Ele cruza metas, produção diária, estoque previsto e consumos.

• Realizado: soma do que foi executado conforme registros de produção diária.
• Planejado: soma das metas cadastradas no projeto.
• Pendente: diferença entre planejado e realizado.
• Área por talhão: compara área total do projeto e soma dos talhões.
• Calculadoras do projeto: mostra resultados dos módulos selecionados e as análises salvas/vinculadas ao projeto.
• Estoque central previsto: mostra insumos planejados, custo e falta estimada.
• Saídas e baixas: mostra consumos já registrados para o projeto.
• Dashboard operacional: mostra produção do dia, produtividade, meta diária, previsto até hoje e status do prazo.
• Evolução diária: gráfico com produção do dia, acumulado e meta.

13. OFFLINE E SINCRONIZAÇÃO

Como funciona quando não há internet

O app é preparado como PWA. Isso significa que a interface pode continuar abrindo no aparelho e os dados são guardados localmente no navegador.

O que salva offline

• Rascunho de projeto enquanto o usuário digita.
• Projetos salvos ou parcialmente salvos com nome.
• Estoque cadastrado ou atualizado.
• Produção diária.
• Consumos estimados.
• Cálculos realizados.
• Notas de melhoria.

Como sincroniza

1. Quando o app está em localhost ou aberto como arquivo local, ele opera apenas localmente.
2. Quando está na VPS em endereço HTTPS, ele tenta buscar dados centrais e enviar dados locais.
3. Se estiver sem internet, os dados continuam no aparelho.
4. Ao voltar a conexão, clique em Sincronizar ou aguarde a sincronização automática.
5. O botão muda de estado para indicar Local, Offline, Sincronizando, Sincronizado ou Pendente.

14. NOTAS DE MELHORIA

Como registrar comentários para evolução do sistema

A tela de notas serve como bloco de observações para quem está testando ou usando o sistema. Ela permite registrar a tela, o projeto, a prioridade, o problema observado e uma sugestão de solução.

1. Acesse Mais opções > Notas.
2. Informe autor, área/tela relacionada, projeto e prioridade.
3. Descreva o problema, ajuste ou melhoria desejada.
4. Informe sugestão de solução, se houver.
5. Clique em salvar.
6. Use Copiar tudo para enviar o resumo para desenvolvimento.

15. ROTINA RECOMENDADA

Como usar no dia a dia

Antes de iniciar o projeto

1. Atualize o estoque central.
2. Crie ou revise o projeto.
3. Divida a área em talhões.
4. Rode as calculadoras necessárias.
5. Revise insumos previstos e possíveis faltas.
6. Defina metas por atividade.

Durante a execução

1. Registre produção diária no fim de cada dia.
2. Registre consumo estimado quando houver uso/baixa de insumos.
3. Confira o painel do projeto para acompanhar pendências e ritmo.
4. Sincronize quando houver internet.

Ao final ou em reunião

1. Abra o painel do projeto.
2. Confira planejado x realizado.
3. Revise custos e consumo.
4. Exporte relatórios CSV se necessário.
5. Registre melhorias identificadas durante o uso.

16. EXEMPLOS PRÁTICOS

Situações para treinamento