Manual de Operação — Portal Pedro Pimenta

Pedro Pimenta

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:

Quem	Contatar 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

Abra o navegador (Chrome, Safari, Firefox) no celular ou no computador.
Digite o endereço: pedropimenta.pages.dev
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 "Ajustes" de nenhum dos portais. Lá ficam configurações que, se alteradas erradas, podem zerar o sistema ou misturar com dados de outra pessoa.

🚫

Não mudar o "Identificador da nuvem". Esse campo está em Ajustes → Sincronização. Se mudar, perde a conexão com os dados da nuvem.

🚫

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)

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

No iPhone (Safari)

Abra pedropimenta.pages.dev no Safari.
Toque no botão de compartilhar (quadrado com seta para cima, na barra de baixo).
Role para baixo e toque em "Adicionar à Tela de Início".
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

Aba	Para que serve	Você usa?
Painel	Visão geral: gasto/km, média km/L, próximas trocas de óleo	Só leitura
Abastecimentos	Lançar cada vez que abasteceu o veículo	Sim, sempre lançar
Manutenção	Lançar troca de óleo, reparos, peças	Sim, quando ocorrer
Análises	Gráficos e relatórios	Só leitura
Ajustes	Cadastros, sincronização, configuração	NÃO MEXER
Backup	Exportar dados para Excel/JSON	Só o Pedro

1. Como lançar um abastecimento

Abrir o Portal Veículos

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

Clicar na aba "Abastecimentos"

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.

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.

Selecionar o carro (Voyage ou Montana).
Aba Manutenção.
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
Clicar em "Adicionar".

🚗 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

Aba	Para que serve	Você usa?
Painel	Custo/hora, lucro, alertas de manutenção	Só leitura
Atividades	Cada serviço prestado pelo trator (aplicação, deslocamento)	Sim, sempre lançar
Recebíveis	Saber quem deve o quê. Marcar pagamentos	Sim, quando cliente pagar
Abastecimentos	Cada abastecimento do trator (do tanque ou de posto)	Sim, sempre lançar
Tanque	Compras de diesel e retiradas do tanque próprio	Sim, sempre lançar
Manutenção	Troca de óleo, reparos, peças do trator	Sim, quando ocorrer
Implementos	Lista de pulverizador, arado, grade etc.	Só leitura
Análises	Gráficos: receita por cliente, custo por atividade	Só leitura
Ajustes	Cadastros e configuração	NÃO MEXER
Backup	Exportar dados	Só o Pedro

1. Lançar serviço prestado pelo trator

Sempre que o trator trabalhar (aplicação de herbicida, deslocamento, etc.), lançar:

Abrir Portal Fazenda → aba "Atividades"

Anotar o horímetro antes de começar e depois de terminar

O horímetro fica no painel do trator. Anote num papel se precisar.

Preencher "Nova atividade / serviço"

Data inicial: dia que começou
Data final: dia que terminou (deixe em branco se for o mesmo dia)
Horímetro inicial: antes de começar
Horímetro final: ao terminar
Atividade: Aplicação de herbicida / Deslocamento / etc.
Implemento: o que estava acoplado (Pulverizador, Arado…) — pode deixar vazio se não usou nenhum
Cliente: para quem o serviço foi prestado. Se foi pra você mesmo, escolha Próprio.
Preço R$/h: quanto cobra por hora desse cliente (ex: 100, 150, 180)
Recebido R$: deixa o sistema calcular sozinho. Se o cliente JÁ pagou tudo na hora, está OK. Se não pagou ainda, clique no botão ✏️ e coloque 0.
Observação: PG / Pendente / qualquer informação útil

Clicar em "Adicionar"

Exemplo concreto

Pedro fez aplicação de herbicida no Gersomar de 01 a 07 de janeiro. Horímetro foi de 3904,1 para 3926,1. Cobrou R$ 100/h. Gersomar pagou tudo no acerto do mês.

Como lançar:

Data inicial: 01/01/2026 · Data final: 07/01/2026
Horímetro inicial: 3904,1 · Horímetro final: 3926,1
Atividade: Aplicação de herbicida · Implemento: Pulverizador · Cliente: Gersomar
Preço R$/h: 100 · Recebido R$: 2200 (calcula sozinho)

2. Abastecer o trator pelo tanque próprio

🚨

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

Portal Fazenda → aba "Abastecimentos"

Preencher "Novo abastecimento"

Data: hoje
Horímetro: do trator naquele momento
Origem do diesel: escolher 🪣 Tanque próprio
Litros: quanto tirou do tanque (ex: 50)
Valor R$: NÃO PRECISA preencher — o sistema calcula sozinho pelo preço médio do tanque
Atividade: o que vai fazer (Aplicação, Deslocamento…)
Custo de: quem paga essa hora de trator (Próprio, Gersomar, etc.)
Posto / Cidade: pode deixar vazio
Observação: opcional

Clicar em "Adicionar"

O sistema vai descontar os litros do tanque automaticamente. Aparece um pill 🪣 Tanque na tabela.

3. Abastecer o trator em posto (não no tanque)

Quando o trator abastece em posto (ex: Carrara, Gersomar):

Portal Fazenda → Abastecimentos.
Escolher ⛽ Posto / fora do tanque em "Origem do diesel".
Preencher litros e valor R$ total pago.
Preencher posto e cidade.
Em "Custo de" → marcar quem pagou (Pedro = Próprio; ou o cliente, se o cliente bancou).
Adicionar.

4. Comprar diesel para encher o tanque

Portal Fazenda → aba "Tanque"

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

Clicar em "Registrar entrada"

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

5. Lançar manutenção do trator

Portal Fazenda → aba Manutenção.
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
Adicionar.

6. Marcar que cliente pagou

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

Portal Fazenda → aba "Recebíveis"

Encontrar o cliente que pagou

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

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".

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)

Carregando…

📋 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: