📖 Manual de Operação
🚗 Veículos 🚜 Fazenda
Manual de Operação
Portal de Controle — Veículos + Fazenda
Para uso do operador / funcionário
📌 Versão do manual
——
Esta é a versão mais recente do manual. O histórico completo de mudanças está na aba 📋 Histórico.
Aberto em —

👥 Quem contatar em cada situação

O portal envolve duas pessoas diferentes para tipos diferentes de assunto:

QuemContatar quando…
Pedro (dono da operação) • Dúvidas sobre dados (qual cliente, qual valor, qual atividade)
• Decisões de operação (valor da hora, cobrar ou não, novo cliente)
• Conferir lançamentos antes de salvar
• Antes de fazer qualquer alteração que não está prevista neste manual
Gelsimar (responsável de TI) • Problemas técnicos no sistema (não abre, erro de sincronização)
• Configurações da nuvem
• Restaurar backup
• Lançamento sumiu / dados estranhos
• Necessidade de atualização do sistema
📌
Em resumo: Pedro resolve dúvidas de conteúdo (o que lançar). Gelsimar resolve dúvidas de sistema (como o site funciona).

O que é o portal?

O Portal Pedro Pimenta é um sistema na internet usado para controlar:

  • 🚗 Veículos: abastecimentos e manutenção do Voyage e Montana.
  • 🚜 Fazenda: trator Valmet 78, implementos, tanque de diesel, atividades prestadas a clientes, recebimentos.

Para o passo-a-passo de cada um, troque para a aba 🚗 Veículos ou 🚜 Fazenda acima.

Como abrir o portal

  1. Abra o navegador (Chrome, Safari, Firefox) no celular ou no computador.
  2. Digite o endereço: pedropimenta.pages.dev
  3. Aperte Enter.
💡
Dica importante: no topo da tela do portal tem dois botões: 🚗 Veículos e 🚜 Fazenda. Clique no que quiser usar — os dois mostram dados separados.

Funciona sem internet?

Sim. Depois de abrir uma vez com internet, o portal continua funcionando offline. Os lançamentos ficam salvos no aparelho e sincronizam automaticamente quando a conexão voltar.

No topo da tela aparece um indicador:

  • ● Sincronizado = tudo em dia, conectado.
  • ● Salvo local = sem internet, mas o lançamento ficou guardado e vai subir depois.
  • ● Erro de sync = algo deu errado. Avisar o Pedro.

🚫 O que NÃO fazer (vale pra ambos os portais)

🚫
Nunca apague lançamentos antigos sem pedir ao Pedro. Se viu um erro, prefira EDITAR. Apagar perde dados que outros relatórios usam.
🚫
Não mexer na aba "Configurações" de nenhum dos portais. Lá ficam parâmetros que, se alterados errados, podem zerar o sistema ou misturar com dados de outra pessoa.
🚫
Não fazer "Logout" nem entrar com outra conta. O acesso à nuvem é feito pelo login da conta (Cloudflare Access) — não há mais "chave" ou "identificador" para digitar. Se sair ou trocar a conta, perde o acesso aos dados da nuvem. Em caso de dúvida, avisar o Gelsimar.
🚫
Não "Importar" arquivos da aba Backup. Importar SUBSTITUI todos os dados pelo arquivo. Apenas o Pedro faz isso, quando necessário.
⚠️
Em caso de dúvida: anote a situação num papel (data, hora, o que aconteceu) e pergunte ao Pedro antes de lançar. Melhor lançar 1 dia depois do que lançar errado.

❓ Erros comuns e soluções

Tela mostra "Nuvem desativada"

Isso significa que esse aparelho perdeu a conexão com a nuvem. Não tente reconfigurar sozinho — avisar o Gelsimar (TI). Enquanto isso, pode usar normalmente — os dados ficam salvos no aparelho até reconectar.

O horímetro/km não bate com o último lançamento

Se o sistema avisar que o horímetro está menor que algum lançamento anterior, é porque tem algo errado. Confira no painel do trator/carro com calma. Se realmente parecer estranho (talvez o horímetro tenha sido trocado?), avise o Pedro — ele decide com o Gelsimar como ajustar o sistema.

O cálculo de "Recebido" parecou errado

O "Recebido" é calculado automaticamente pela fórmula: (horímetro final − horímetro inicial) × Preço R$/h. Se está estranho:

  • Confira se digitou o horímetro com a vírgula no lugar certo (ex: 4108,4 e NÃO 41084).
  • Confira o preço/hora (não escrever em milhares — exemplo errado: 10.000 em vez de 100).

Saldo do tanque negativo

Significa que foram lançadas mais saídas do que entradas. Provavelmente esqueceram de lançar uma compra. Avisar o Pedro para confirmar — se for falha de sistema, o Gelsimar ajuda a recuperar.

"Backup há mais de 30 dias"

Avisar o Gelsimar (TI) — ele exporta uma cópia de segurança.

O lançamento que fiz "sumiu"

Provavelmente o aparelho está sem sincronizar. Verifique no topo da tela:

  • Se está ● Salvo local — está OK, vai aparecer quando reconectar.
  • Se está ● Erro de sync — avisar o Gelsimar com o horário aproximado do lançamento.

📱 Como instalar o aplicativo no celular

Em vez de abrir o navegador toda vez, dá pra instalar como um aplicativo no celular. Fica com ícone na tela, abre mais rápido e funciona offline.

No Android (Chrome)

  1. Abra pedropimenta.pages.dev no Chrome.
  2. Toque nos 3 pontinhos do canto superior direito.
  3. Toque em "Instalar app" ou "Adicionar à tela inicial".
  4. Confirmar.

No iPhone (Safari)

  1. Abra pedropimenta.pages.dev no Safari.
  2. Toque no botão de compartilhar (quadrado com seta para cima, na barra de baixo).
  3. Role para baixo e toque em "Adicionar à Tela de Início".
  4. Confirmar.

Pronto — agora aparece um ícone "Pedro Pimenta" no menu do celular, igual qualquer outro app.

📞 Em caso de dúvida

Antes de fazer qualquer alteração que não esteja prevista neste manual:

  • Dúvida sobre o que lançar (cliente, valor, atividade) → Pedro
  • Dúvida sobre como o sistema funciona ou problemas técnicos → Gelsimar (TI)

Lançar 1 dia depois é melhor que lançar errado — corrigir uma entrada é fácil; descobrir um erro 3 meses depois é difícil.

🚗 Portal de Veículos

Controle de abastecimento e manutenção do Voyage e Montana

Acessar clicando no botão 🚗 Veículos no topo do portal.

Selecionar o veículo

No canto superior direito tem uma lista Veículo 1 ▾ — escolha entre Voyage ou Montana antes de lançar qualquer coisa.

⚠️
Cuidado: sempre confira QUAL veículo está selecionado antes de adicionar um abastecimento ou manutenção. Se lançar no carro errado, depois precisa apagar e refazer.

Abas do Portal Veículos

AbaPara que serveVocê usa?
PainelVisão geral: gasto/km, média km/L, próximas trocas de óleoSó leitura
AbastecimentosLançar cada vez que abasteceu o veículoSim, sempre lançar
ManutençõesLançar troca de óleo, reparos, peçasSim, quando ocorrer
AnálisesGráficos e relatóriosSó leitura
ConfiguraçõesCadastros, sincronização, parâmetrosNÃO MEXER
BackupExportar dados para Excel/JSONSó o Pedro

1. Como lançar um abastecimento

1

Abrir o Portal Veículos

No topo, clique em 🚗 Veículos e escolha Voyage ou Montana na lista do canto direito.

2

Clicar na aba "Abastecimentos"

3

Preencher o formulário "Novo abastecimento"

  • Data: o dia que abasteceu
  • Km (odômetro): o número que aparece no painel do carro naquele momento
  • Litros: quantos litros entraram no tanque
  • Combustível: Etanol ou Gasolina
  • Valor R$: total pago
  • Posto: nome do posto (ex: Carrara)
  • Cidade: cidade do posto (ex: Iturama)
  • Tanque cheio: marcar SÓ se encheu o tanque até o fim. Se foi parcial, deixar desmarcado.
4

Clicar em "Adicionar"

Pronto. O lançamento aparece na tabela abaixo.

💡
Por que importa marcar "Tanque cheio"? O sistema usa essa informação para calcular a média de km/L com precisão. Se nunca marcar, a média fica errada.

2. Como lançar uma manutenção

Toda vez que tem gasto com manutenção do veículo, lançar.

  1. Selecionar o carro (Voyage ou Montana).
  2. Aba Manutenções.
  3. Preencher:
    • Data
    • Serviço: o que foi feito (ex: "Troca de óleo + filtro")
    • Categoria: Óleo e Filtros, Pneus, Freios, Suspensão, Motor, Elétrica, Outros
    • Km: do veículo no momento
    • Local: oficina
    • Cidade: cidade da oficina
    • Valor R$: total pago
    • Garantia até (opcional): data até quando a peça/serviço tem garantia
  4. Clicar em "Adicionar".
🔀
Ordenar o "Histórico de manutenção". Clicar no título de uma coluna (Data, Serviço, Categoria, Km, Local, Cidade ou Valor) ordena a lista por aquela coluna. Clicar de novo no mesmo título inverte a ordem (crescente ↔ decrescente). Uma setinha ▲ (crescente) ou ▼ (decrescente) aparece ao lado do título ativo.

🚗 Veículos cadastrados

Carregando…
Lendo do navegador…

🚜 Portal da Fazenda

Trator Valmet 78 · implementos · tanque de diesel · atividades · recebíveis

Acessar clicando no botão 🚜 Fazenda no topo do portal. Aqui se controla TUDO sobre o trator e a atividade rural.

Abas do Portal Fazenda

🔄
Mudou em relação ao manual antigo: antes havia uma aba "Atividades" separada da de "Abastecimentos". Agora é tudo um lançamento só na aba Abastecimentos/Atividades — quando o trator abastece, você já registra o trabalho feito com aquele diesel (horas, cliente, preço, status).
AbaPara que serveVocê usa?
PainelCusto/hora, lucro, alertas de manutençãoSó leitura
Abastecimentos/AtividadesLançamento único: cada abastecimento já traz junto a atividade executada (horas, cliente, preço, status do pagamento)Sim, sempre lançar
RecebíveisSaber quem deve o quê. Marcar pagamentosSim, quando cliente pagar
TanqueCompras de diesel e retiradas do tanque próprioSim, sempre lançar
ManutençõesTroca de óleo, reparos, peças do tratorSim, quando ocorrer
ImplementosLista de pulverizador, arado, grade etc.Só leitura
AnálisesGráficos: receita por cliente, custo por atividadeSó leitura
ConfiguraçõesCadastros e parâmetrosNÃO MEXER
BackupExportar dados e ativar a sincronização na nuvemSó o Pedro

📊 Como o painel da Fazenda é calculado

O Painel combina dados das outras abas. Aqui está de onde vem cada número, para você confiar no que vê.

💰 Custo por hora (3 cards)

CardO que mostraFórmula
Custo TOTAL / hora Quanto cada hora do trator custa (Preço R$/L da última compra de diesel no tanque × litros totais consumidos + Manutenção total) ÷ Horas rodadas
Combustível / hora Quanto sai do bolso do Pedro em diesel por hora (Abastecimentos em posto + Compras do tanque) ÷ Horas rodadas
Manutenção / hora Quanto a manutenção pesa por hora rodada Soma de todas as manutenções (preventiva + corretiva) ÷ Horas rodadas
💡
Modelo de acerto mensal: Todo abastecimento é custo do Pedro, mesmo quando o fornecedor do diesel é também cliente (ex: o Gersomar é cliente DE aplicação E fornecedor DE diesel — Pedro compra o diesel no posto do Gersomar e Gersomar cobra no acerto mensal junto com o que ele paga pela aplicação).
📌
Regra anti-dobra de custo: Combustível que veio do tanque próprio NÃO conta de novo no abastecimento (já foi pago quando o tanque foi enchido).

💼 Financeiro (3 cards)

CardO que mostraFórmula
Lucro líquido Sobra real após custos Receita bruta − Combustível próprio − Manutenção
Receita bruta Total faturado em serviços prestados Soma do "Total R$" de todas as operações lançadas na aba Abastecimentos/Atividades
Recebido / a receber Quanto já entrou no bolso vs o que ainda falta Recebido = soma dos pagamentos registrados.
A receber = saldo devido apenas de clientes externos (Próprio não conta).

⚙️ Operação (4 cards)

CardO que mostraFórmula
Horímetro atual O horímetro do trator hoje Maior horímetro entre os lançamentos (abastecimentos e manutenções) e o horímetro inicial cadastrado em Configurações.
Horas rodadas Quantas horas o trator trabalhou desde a aquisição Horímetro atual − Horímetro inicial do trator (Configurações → Dados do trator)
Combustível total Total de litros consumidos (todos os pagadores) Litros = soma de todos os abastecimentos. R$ = abastecimentos em posto + compras do tanque (independente de quem pagou).
Atividades / Manutenções Quantidade de lançamentos no sistema Contagem de operações e de manutenções; o rodapé do card mostra o total de abastecimentos.

🔧 Próximas manutenções preventivas (tabela)

Cada linha mostra uma manutenção do catálogo (configurada em Configurações) e quando ela está prevista:

ColunaO que mostra
ItemNome da manutenção (cadastrado em Configurações → Catálogo de manutenções)
IntervaloHoras configuradas entre cada manutenção (editável em Configurações)
Última manutençãoData e horímetro da última manutenção que foi vinculada a esse item do catálogo
Próxima (horímetro)Horímetro da última manutenção + intervalo
FaltamPróxima − Horímetro atual. Negativo se já passou.
StatusEm dia = faltam > 20% do intervalo
Próxima = faltam ≤ 20% do intervalo (amarelo)
Vencida = faltam ≤ 0 (vermelho)
⚠️
Atenção: só conta como "última manutenção" se você vinculou ao item do catálogo na hora de lançar (campo "Item do catálogo (se preventiva)" no formulário). Manutenções soltas (sem catálogo) NÃO disparam o cálculo de próxima.

🚨 Alertas (painel inferior)

Avisos que aparecem só quando há algo que precisa de atenção:

  • Tanque de diesel baixo: saldo abaixo do mínimo configurado em Configurações → Tanque de diesel.
  • Pendente de recebimento: total devido por clientes externos. Botão "Ver detalhes" leva para a aba Recebíveis.
  • Garantias próximas do vencimento: manutenções com data ou horímetro de garantia perto de vencer (30 dias ou 100 horas).
  • Concentração de corretivas: 3 ou mais manutenções corretivas nos últimos 30 dias (sugere revisão preventiva ampla).
  • Backup há mais de 14 dias: lembrete amarelo para exportar JSON. Acima de 30 dias vira vermelho.

1. Lançar trabalho do trator (abastecimento + atividade no MESMO lançamento)

Toda vez que o trator abastece, você registra no mesmo lançamento o trabalho feito com aquele diesel. É um lançamento só, na aba Abastecimentos/Atividades, dividido em dois blocos: ⛽ Diesel e 🚜 Operação executada.

🚨
MUITO IMPORTANTE: sempre que tirar diesel do tanque para o trator, é OBRIGATÓRIO lançar. Senão o saldo do tanque fica errado.
1

Abrir Portal Fazenda → aba "Abastecimentos/Atividades"

2

Anotar o horímetro do trator naquele momento

O horímetro fica no painel do trator. As horas trabalhadas são calculadas sozinhas pela diferença para o lançamento anterior.

3

Preencher o bloco ⛽ Diesel

  • Data: dia do abastecimento
  • Horímetro: do trator naquele momento
  • Litros: quanto colocou (obrigatório)
  • Origem: 🪣 Posto Próprio (saiu do seu tanque) ou ⛽ Posto de Terceiros (abasteceu fora)
  • Valor R$: se for 🪣 Posto Próprio, NÃO precisa preencher — o sistema calcula pelo preço médio do tanque. Se for ⛽ Posto de Terceiros, digitar o valor total pago.
  • Fornecedor (do diesel): de quem veio o diesel (Gersomar, Carrara, Fátima…). Todo diesel é custo do Pedro; esse campo registra de quem foi comprado para o acerto mensal.
  • Tanque cheio: deixe marcado quando encher o tanque do trator (ajuda no controle de consumo).
4

Preencher o bloco 🚜 Operação executada

  • Atividade: o que o trator fez (Aplicação de herbicida, Deslocamento…)
  • Cliente do serviço: para quem foi o serviço. Se foi pra você mesmo, escolha Próprio.
  • Horas trabalhadas: vêm automáticas (diferença de horímetro). Só digite se quiser ajustar.
  • Preço R$/h: quanto cobra por hora desse cliente (ex: 100, 150, 180)
  • Total R$: calculado sozinho (horas × preço). Para mudar na mão, clicar no ✏️.
  • Desconto (opcional): em R$ ou %, se deu abatimento.
  • Status: Próprio (uso interno, não cobra), PG (cliente já pagou) ou Pendente (vai cobrar no acerto).
  • Recebido R$: calculado sozinho conforme o status. Para ajustar na mão, clicar no ✏️.
  • Observação: qualquer informação útil.
5

Clicar em "Adicionar"

Se a origem foi 🪣 Posto Próprio, o sistema desconta os litros do tanque automaticamente e mostra um pill 🪣 Posto Próprio na tabela.

Exemplo concreto

Pedro abasteceu o trator com 50 L do próprio tanque e foi fazer aplicação de herbicida no Gersomar. O horímetro chegou a 4108,4 (o lançamento anterior foi em 4099,0, então dá 9,4 h automático). Cobra R$ 100/h. O Gersomar vai pagar no acerto do mês.

Como lançar (um lançamento só):

  • ⛽ Diesel → Data: hoje · Horímetro: 4108,4 · Litros: 50 · Origem: 🪣 Posto Próprio · Valor: (em branco — calcula sozinho) · Fornecedor: Posto Próprio
  • 🚜 Operação → Atividade: Aplicação de herbicida · Cliente: Gersomar · Horas: 9,4 (automático) · Preço R$/h: 100 · Total: 940,00 (automático) · Status: Pendente
💡
Abasteceu em posto, fora do tanque? É o mesmo formulário: em Origem escolha ⛽ Posto de Terceiros, digite os litros e o valor R$ total pago, e em Fornecedor marque de quem comprou (Pedro sempre paga; no acerto mensal esse valor é abatido se o fornecedor também for cliente).

2. Comprar diesel para encher o tanque

1

Portal Fazenda → aba "Tanque"

2

Preencher "Nova entrada (compra de diesel)"

  • Data: dia da compra
  • Litros: quantos litros entraram no tanque
  • Valor R$ total: total pago
  • Fornecedor: quem vendeu (Gersomar, Carrara, etc.)
  • Observação: opcional
3

Clicar em "Registrar entrada"

O saldo do tanque aumenta automaticamente. O preço médio do litro é recalculado.

3. Lançar manutenção do trator

  1. Portal Fazenda → aba Manutenções.
  2. Preencher:
    • Data
    • Tipo: Preventiva (troca de óleo planejada) ou Corretiva (peça quebrou, conserto inesperado)
    • Item do catálogo: só se for preventiva conhecida (Óleo motor, Filtro, etc.). Senão, deixar em branco.
    • Serviço (descrição): o que foi feito
    • Horímetro: no momento do serviço
    • Local: oficina (ex: CBT Tratores)
    • Cidade: cidade da oficina
    • Valor R$: total pago
    • Garantia (opcional): texto livre + data + horímetro
  3. Adicionar.
🔀
Ordenar o histórico de manutenções. Clicar no título de uma coluna ordena a lista por aquela coluna; clicar de novo inverte a ordem (crescente ↔ decrescente). A setinha ▲/▼ ao lado do título mostra a ordem atual.

4. Marcar que cliente pagou

Quando o cliente quita uma atividade (no acerto mensal ou avulso):

1

Portal Fazenda → aba "Recebíveis"

2

Encontrar o cliente que pagou

Tem cards grandes com o nome do cliente, valor total devido e dias em atraso.

3

Pagamento integral (cliente pagou TUDO)

  • Clicar no botão "Marcar tudo pago" do card do cliente.
  • Vai abrir uma janela pedindo a data do pagamento — preencher.
  • Observação (opcional): ex "Acerto abril/26".
  • Clicar em "Confirmar pagamento total".
3b

Pagamento de uma atividade só

Se quer marcar uma atividade específica, role para baixo até a tabela de atividades pendentes e clique em "pago total" ou "parcial" na linha desejada.

📅
Sempre preencha a data CERTA do pagamento — não a data de hoje. Se o cliente pagou no dia 05, ponha 05. Isso é importante para o relatório mensal.

📋 Cadastros atuais da Fazenda (consulta rápida)

🔄
Atualizado em: —
Dados carregados deste navegador. Se um cliente novo foi cadastrado em outro aparelho, atualize a página para sincronizar.

👥 Clientes do trator

Carregando…

🔧 Implementos

Carregando…

🎯 Atividades disponíveis

Carregando…

🛠 Catálogo de manutenções preventivas (com intervalos atuais)

📋 Histórico de versões do manual

Sempre que o portal ganha uma feature nova, este histórico recebe uma linha. Compare com a versão antiga para saber o que mudou.

Versão atual: