📅 Agenda

Calendario mensal mostrando quantas OS existem em cada dia. Clique num dia pra ver a lista completa embaixo, com horario, cliente e status de cada OS daquele dia. Botao "+ Novo" abre atalhos rapidos: Nova OS, Novo Cliente, Novo Lembrete, Novo Compromisso — sem precisar sair da tela de Agenda.
Compromissos: marcacoes que nao sao OS (ex: reuniao, feriado, folga, compromisso pessoal) — aparecem no calendario com um marcador laranja, pra nao marcar servico em cima sem querer. Tem titulo, data/hora e descricao opcional.

🐭 Armadilhas

Cadastro de armadilhas por cliente: codigo (gerado automatico pelo sistema), tipo e localizacao (ex: "Fundos, proximo ao deposito"). Botao "Inspecionar" registra uma vistoria com status (OK, Com Atividade, Danificada, Substituida) e observacao — a tabela sempre mostra o status e a data da ultima inspecao. Armadilhas nao entram em nenhum PDF (nem OS nem Contrato) — e so um controle interno de campo por enquanto.

🔧 Cadastros de Apoio

Telas proprias pra cadastrar/remover, sem precisar mexer em codigo: Tipos de Servico (Desinsetizacao, Desratizacao, etc — a OS e o Contrato podem marcar mais de um), Tipos de Estabelecimento (Casa, Restaurante, Condominio, etc — tambem pode marcar mais de um na OS), Pragas (nome comum + nome cientifico + categoria — sao as opcoes de checkbox na OS e no Contrato), e Metodos de Aplicacao (pulverizacao, gel, isca, etc). Todos esses cadastros sao so criar e excluir — nao tem edicao, entao se errar o nome e melhor excluir e criar de novo.

🏢 Clientes

Cadastro Pessoa Juridica ou Fisica (CPF nao obrigatorio na Fisica). PJ: digite o CNPJ e o sistema preenche Razao Social, Fantasia e endereco completo automatico (BrasilAPI) — so preenche o que estiver vazio, nao sobrescreve o que voce ja digitou. PF e PJ: digite o CEP e o endereco preenche sozinho tambem (ViaCEP), mesmo sem CNPJ.
PJ tem Classificacao (Matriz/Filial/Franquia) com vinculo a matriz. Observacoes Internas (uso da equipe) e Tecnicas (pre-preenche na OS) ficam salvas separadas. Locais Tratados padrao tambem pre-preenche na OS. Data de aniversario e cadastrada — em Pessoa Fisica aparece um botao "🎂 Zap" do lado da data que ja abre o WhatsApp com uma mensagem de felicitacao e oferta de cupom de 10% de desconto.
Protecao contra duplicidade: nao da pra cadastrar dois PJ com o mesmo CNPJ (bloqueado pelo sistema). Como CPF nao e obrigatorio, o sistema tambem bloqueia cadastrar uma nova Pessoa Fisica no mesmo endereco de outro cliente ja cadastrado.
Ao clicar no cliente: atalhos de Criar OS, WhatsApp, Maps, Editar, Excluir. Card no topo mostra Total, Pessoa Fisica, Pessoa Juridica, Matriz, Filial e Franquia.

📄 Contratos

Contrato recorrente com um cliente: define periodicidade (mensal, bimestral, etc), tecnico fixo, forma de pagamento, valor, e os tipos de servico/pragas cobertos. Uma vez ativo, cada nova visita gera uma OS automaticamente ("Gerar Proxima" na OS concluida) ja com os dados do contrato preenchidos. Abas de status: Rascunho, Aguardando Assinatura, Ativo, Encerrado, Cancelado.
Termos Aditivos: permite anexar alteracoes ao contrato original (mudanca de valor, escopo, garantia, etc) sem apagar o contrato de origem — hoje aceita anexar um PDF ja pronto (a opcao de escrever direto no sistema esta em desenvolvimento).

💰 Financeiro

Lancamento de receitas, despesas e transferencias, com categoria (lista diferente pra Receita e Despesa), vinculo opcional com Cliente, forma de pagamento, numero da nota fiscal, e status (Pendente/Pago/Recebido/Vencido). Resumo automatico no topo (total recebido, gasto, saldo) e filtro por tipo.
Parcelamento: pra contas fixas que se repetem todo mes (agua, luz, telefone, internet), preencha o campo "Parcelas" com a quantidade de meses (ex: 12) na hora de criar — o sistema gera sozinho os 12 lancamentos, um por mes, com a descricao numerada (1/12, 2/12...ate 12/12). So funciona ao criar uma movimentacao nova, nao ao editar uma existente.

🚚 Fornecedores

Cadastro Pessoa Juridica ou Fisica, com dados de contato, endereco (CNPJ preenche tudo automatico via BrasilAPI, ou digite o CEP e preenche via ViaCEP) e observacoes. Ao abrir um fornecedor cadastrado, mostra o historico de movimentacoes financeiras vinculadas a ele e o total gasto.

🔔 Lembretes

Lembretes manuais (ex: renovacao de contrato) vinculados a um cliente, com titulo, mensagem e data de envio. Botao "✓ Notificado" marca como ja avisado. Nao tem edicao de conteudo depois de criado — se precisar mudar o texto, exclua e crie de novo.

🔒 Login e Seguranca

Maximo de 5 pessoas conectadas ao mesmo tempo (limite do plano) — se a vaga estiver cheia, aparece aviso pra aguardar alguem sair. Depois de 5 tentativas de senha errada seguidas, a conta fica bloqueada por 15 minutos por seguranca (o sistema avisa quantas tentativas restam antes de bloquear). Sessao expira sozinha depois de um tempo parado sem uso.

🧾 Orcamentos

Proposta pro cliente antes de virar contrato/OS. Cliente, titulo, validade, tecnico, itens (descricao + quantidade + valor, com o total calculado sozinho), desconto a vista, forma de pagamento. Gera PDF pronto pra baixar e um botao que ja abre o WhatsApp com a mensagem e o link do PDF prontos pra enviar. Status: Rascunho, Enviado, Aprovado, Recusado, Finalizado.

📋 Ordens de Servico

Criar OS: escolha o cliente e o endereco de servico ja vem preenchido automatico com o endereco cadastrado dele — mas e totalmente editavel, se o servico for em outro lugar (filial, obra, etc) so trocar os campos antes de salvar, sem afetar o cadastro do cliente. Tipo(s) de servico e tipo(s) de estabelecimento (pode marcar mais de um), data + hora fim, tecnico aplicador + tecnicos auxiliares, locais tratados, pragas alvo (checkbox), produtos aplicados (ja na propria criacao, desconta do estoque), valor + forma de pagamento + parcelas, garantia, observacoes gerais e tecnicas.
Depois de criada: colher assinatura digital ("Assinar", desenha na tela), anexar fotos antes/depois ("📸 Fotos"), gerar PDF da OS, gerar Comprovante, gerar Certificado PDF (so em Concluida), gerar a proxima OS de contrato recorrente ("🔁 Gerar Proxima", so em Concluida).
Status: Agendada → Em Execucao → Concluida (ou Cancelada a qualquer momento, sem apagar o registro).
A lista mostra o Numero da OS em cada linha, pra achar facil.

📦 Produtos, Estoque e Lotes

Cadastro de produtos com preco de custo/venda, estoque atual e minimo (alerta automatico quando fica baixo). Tela propria de Lotes controla validade por lote de cada produto (codigo do lote, fabricacao, validade, quantidade) — o lote e a validade mais proxima de vencer tambem aparecem direto na tabela de Produtos, com cor de alerta. Lotes so podem ser criados, nao editados depois.

📊 Relatorios

12 relatorios prontos, cada um gera um PDF: Faturamento Mensal, Fluxo de Caixa, Formas de Pagamento, Servicos Executados, Produtividade por Tecnico, Historico por Cliente, Tipos de Pragas Atendidas, Produtos Utilizados, Estoque de Produtos, Contratos a Vencer/Vencidos, Contratos Ativos e Clientes Ativos. A maioria filtra por periodo (data inicio/fim) no topo da tela; os que precisam de um cliente especifico pedem o nome numa caixa de busca.

📉 Retencao de Clientes

Mostra todos os clientes ativos organizados por tempo desde o ultimo atendimento (OS concluida/executada/faturada): Em dia (ate 30 dias), 30-59, 60-89, 90-364, 365+ dias e Nunca atendido. Filtro por faixa no topo. Botoes 💬 Zap e ✉️ Email ja preparam uma mensagem de reativacao pronta pro cliente que tem contato cadastrado. Cliente que pediu pra nao ser contatado fica marcado "NAO CONTATAR" e some dos botoes de reativacao ate ser desbloqueado de novo.

👷 Tecnicos

Cadastro com nome, email, telefone, cargo, data de contratacao e aniversario. Se marcado como Biologo Responsavel, pede o numero do CRBio (aparece nos certificados). Clique em "OS" pra ver todas as ordens de servico daquele tecnico.

👥 Usuarios

Cadastro de quem acessa o sistema, por perfil de acesso: Admin, Operacional, Aplicador. O botao "Editar" permite trocar dados e redefinir a senha de qualquer usuario — nao precisa pedir ajuda pra isso (o email nao pode ser trocado depois de criado). Voce so consegue criar ou editar usuario de nivel igual ou inferior ao seu. Limite de 5 contas ativas no plano atual. Botoes de WhatsApp e 🎂 (aniversario) mandam mensagem direto pro telefone cadastrado.

Se sentir falta de algo, fala com o Jocas — o sistema esta sempre evoluindo.