Manual do Controle de Caixas

O que o app resolve

Contar caixa saindo do galpão é fácil. O problema é o retorno: parte não volta, ninguém sabe de quem é a falta, e a perda só aparece no fechamento do mês como prejuízo sem dono.

O app trata caixa como empréstimo, não como despesa. Cada cliente, filial e galpão tem saldo próprio, recalculado a cada movimento:

Como todo lugar tem saldo, a caixa nunca some no meio do caminho: ela fica na conta de quem estiver com ela.

O ciclo da caixa

Rotas

A rota é o caminhão em circulação — e no app ela guarda caixa igual a um cliente. Isso não é detalhe técnico: é o que impede a caixa de sumir entre o galpão e a entrega.

Sem rota, a saída ia do galpão direto para o cliente. Se o motorista carregava 100 e entregava 80, as outras 20 ficavam registradas no cliente, que nunca as viu. Com rota, essas 20 aparecem onde de fato estão: no caminhão.

Como cadastrar

Cadastros → + Novo cadastro → Tipo: rota (caminhão). Dê o nome pelo qual a equipe já chama (Rota Centro, Rota Litoral) e escolha o motorista responsável.

Depois, em cada cliente, preencha o campo Rota que atende. É esse vínculo que faz o filtro do painel e a lista do celular funcionarem.

No painel

Um quadro Rotas aparece no topo, com duas contas separadas de propósito:

• No caminhão — carregou e ainda não entregou
• Nos clientes — já entregou e ainda não voltou

Somar as duas esconderia justamente o que interessa: onde a caixa está agora. O botão ver clientes filtra a lista de baixo pela rota, e o filtro também está no seletor ao lado da busca.

No celular

As rotas aparecem nos seletores de Saída e de Destino, ao lado dos galpões e unidades — o caminhão é destino da entrega e origem da coleta. A escolha é feita em cada tela.

Como acessar

Não há instalação nem loja de aplicativo. Para quem trabalha na empresa é um endereço só. O cliente tem o dele.

O endereço antigo do escritório — /admin.html — continua funcionando e mostra essa mesma tela. Quem já o tem salvo nos favoritos não precisa mudar nada.

A tela é uma só, e ela é que decide para onde você vai

Antes eram duas telas de entrada quase iguais, cada uma com um link para a outra no rodapé. Quem abria a errada digitava a credencial certa e lia “usuário ou senha incorretos” — uma mensagem que falava do erro errado: a senha estava certa, o endereço é que não era. E não havia como adivinhar qual das duas portas era a sua.

Hoje você digita uma vez e o sistema abre a tela que é sua:

• você é Administrador e entrou com a senha → abre o painel;
• todo o resto → abre o app de lançamento, na aba Saída.

Por que o campo usa PIN e o escritório usa senha

A tela passou a ser uma só, mas as credenciais continuam duas, e não é descuido: são dois usos diferentes. No galpão a pessoa lança de luva, com o celular numa mão e a caixa na outra, várias vezes por dia — digitar uma senha longa a cada vez atrasa a operação, e o que o PIN protege é só lançamento, que fica registrado com nome e hora e pode ser corrigido. Já o painel vê a operação inteira e mexe em cadastro; ali a senha longa se paga.

Na prática você não precisa saber disso: digite o que você tem, no mesmo campo.

Esqueci a senha do painel

Na tela de entrada, clique em Primeiro acesso ou esqueci a senha. Quem ainda nunca definiu senha prova quem é pelo PIN; quem já tem senha informa a senha atual. Nos dois casos a nova senha vale na hora.

Quem não tem nem um nem outro clica em Pedir ajuda ao escritório. O pedido aparece no painel, em Cadastros → Pedidos de senha, e o administrador cadastra uma senha nova em Usuários. O app não envia e-mail — a senha nova é combinada pessoalmente, e depois disso o administrador marca o pedido como resolvido.

No celular

Abra o endereço do campo no Chrome e use ⋮ → Adicionar à tela inicial. Vira ícone e abre em tela cheia, com cara de aplicativo. Mandar o link por WhatsApp para o motorista funciona bem — é link comum.

Lançamentos

A terceira aba do app de campo, visível para todo mundo. Ela mostra o que foi lançado no período — saídas e retornos, os seus e os dos outros —, uma linha por lançamento.

No lugar de um saldo por local, que é a leitura do escritório, aqui está o extrato do dia: Data, Origem, Destino, Saída, Retorno, Motorista e as quantidades por tipo de caixa.

Os três cartões

• Saída — quantas caixas saíram no que está sendo mostrado
• Retorno — quantas voltaram
• Total geral — a soma das duas pontas

Os três seguem os filtros. Filtrou por um motorista, os cartões passam a falar só dele.

Os filtros

Motorista, Origem, Destino e Entrada / Saída são de múltipla escolha: marque dois motoristas e os dois aparecem. Mais o período, com data de início e fim.

Nada marcado quer dizer todos, e não nenhum — senão a tela abriria vazia sem dizer por quê. As opções saem dos lançamentos do período, não do cadastro inteiro: uma lista com trinta locais dos quais dois se moveram obriga a procurar.

Ajuste e perda ficam de fora desta lista: não são viagem de caixa. Eles aparecem no painel do escritório.

Painel de Ativos

A primeira aba do escritório, chamada Controle de Caixas na tela. É o extrato da operação: uma linha por dia, por caminho — de onde saiu, para onde foi, quanto saiu, quanto voltou e quanto sobrou.

As colunas

A cadeia fecha linha a linha: o Saldo final de uma linha é o Saldo inicial da de baixo, mais o que tiver sido lançado de Estoque naquele dia. Quando o saldo dá um salto, é a coluna Estoque que explica o salto.

Os cinco cartões

Ficam acima da tabela, nesta ordem: primeiro o indicador que se cobra, depois o número que dói, depois o que há, e por fim as duas pontas do período.

O estoque é o único que não segue o filtro: ele sai do razão — o que está nas nossas casas agora —, e não do fluxo do período. Filtrar por uma origem não o estreitaria, só o deixaria parecendo travado, e por isso o rodapé dele avisa.

Os filtros

Todos moram num painel suspenso, que abre no botão Filtros do rodapé da coluna da esquerda. Ele fecha no mesmo botão, clicando fora ou com Esc, e nasce fechado a cada visita — painel aberto não é preferência, é estado passageiro, e reabri-lo sozinho taparia a tabela de quem só queria consultar.

• Origem e Destino — as opções saem dos locais que estão nas linhas, não do cadastro inteiro
• Destino → Estoque Inicial — mostra só os lançamentos de saldo inicial. Só aparece quando há algum no período
• De e Até — o período; em branco, o mês corrente
• Só reais / Só de teste — separa a operação do ensaio
• ✕ Limpar filtros — devolve tudo ao estado inicial, inclusive o grupo da coluna da esquerda. Fica apagado quando não há nada a limpar

A coluna da esquerda agrupa: Todas, Rotas, Unidades, Clientes, Em déficit, Motoristas e Usuários. Os dois últimos trocam a leitura de lugar para pessoa: quanto cada motorista, ou cada usuário, tem em aberto.

No rodapé dessa mesma coluna ficam os quatro botões — Filtros e Limpar filtros em cima, Exportar CSV e Atualizar embaixo. A linha entre eles separa mudar o que vejo de fazer algo com isto.

A coluna inteira recolhe no botão ao lado do título, devolvendo 220px de largura à tabela. Fica guardado neste navegador.

Classificar, arrastar, redimensionar

O título da coluna faz três coisas, e nenhuma atrapalha a outra:

• Clique — classifica por ela. Um clique é crescente, dois é decrescente, três volta à ordem de origem
• Arraste o título — troca a coluna de lugar
• Arraste a borda direita — muda a largura

Para esconder uma coluna, e para fazer as mesmas três coisas sem precisar acertar o arrasto, use a aba Colunas. É o mesmo ajuste visto de outro lugar: o que se arrasta aqui aparece lá, e o que se marca lá esta tabela obedece.

A ordem e a largura ficam guardadas neste navegador, porque são preferência de quem olha. A classificação não: ela é um recorte para responder uma pergunta — quem devolveu menos? —, e não um jeito de trabalhar. Guardada, a tela voltaria dias depois fora da ordem de extrato sem ninguém lembrar por quê.

O ⬇ Exportar CSV sai na mesma ordem de colunas da tela, e sempre na ordem de extrato das linhas.

Painel e extratos

O escritório entra em admin.html e encontra sete páginas: Painel de Ativos, Painel, Extratos, Ajustes, Movimentos, Colunas e Cadastros. Quais delas cada pessoa enxerga é decidido no cadastro dela — Ajustes e Cadastros só o administrador vê.

Na barra lateral elas ficam separadas por módulo: Operação (Painel de Ativos, Painel, Movimentos), Dados (Extratos, Cadastros, Colunas) e Sistema (Ajustes). Sete itens seguidos viram uma lista sem forma — separados, você lê um grupo e ignora os outros. O título de um módulo só aparece se você tiver pelo menos uma página dele: nunca sobra um cabeçalho anunciando uma seção vazia.

Elas ficam numa barra lateral, à esquerda, com a página aberta em destaque. No computador ela fica fixa: as sete páginas ficam à vista o tempo todo, sem nenhum clique para descobrir o que existe. No celular ela vira uma gaveta, que abre pelo botão ☰ no canto superior esquerdo e fecha ao escolher uma página, clicando fora ou com Esc.

Acima do conteúdo, um título de página diz onde você está — Operação · Movimentos. No computador a lateral já responde isso; no celular, com a gaveta fechada, ele é a única pista.

No rodapé da lateral ficam o indicador ● Online — verde quando está tudo enviado, âmbar quando há lançamento na fila e vermelho sem internet —, o círculo com as suas iniciais e o botão de sair. Eles ficam sempre à vista: a lista de páginas rola por dentro dela, e o rodapé não desce junto — antes, com a lista cheia, era preciso rolar a lateral para achar o botão de sair.

Recolher a lateral quando a tabela precisa da largura

No computador, o botão ⟨ no alto da lateral a encolhe para uma faixa só de ícones. É útil na aba Movimentos, onde a tabela é larga. Clique de novo para trazê-la de volta — e a escolha fica guardada naquele computador, como a ordem das colunas.

Com a lateral recolhida, passar o mouse por cima dela a abre de relance, só enquanto o cursor estiver ali. Serve para conferir onde você está sem desfazer a escolha. Tirou o mouse, ela volta a ser a faixa de ícones.

A lateral empurra o conteúdo em vez de passar por cima dele: abrindo, a tabela se ajusta e nenhuma coluna fica escondida atrás do menu.

A página rola por dentro

A lateral e o título da página não saem do lugar quando você rola: o que se move é só o conteúdo. Descendo numa tabela longa, você continua vendo em que página está e como sair dela.

O app de campo usa exatamente a mesma navegação, com as três páginas dele. Quem passa do celular para o painel não reaprende nada.

Painel

Abre com Caixas em poder de clientes e filiais, a Idade das caixas na rua e o Estoque nos galpões. As etiquetas fazem a triagem:

• acima do limite — o cliente passou do teto contratado
• div. −5 — divergência entre o contado no cliente e o conferido na chegada
• a conferir — há devolução esperando o galpão

O botão ⬇ Exportar CSV leva o quadro inteiro para a planilha.

Extratos

Escolha o cliente e o período e clique em Gerar extrato. A partir dali:

• 📲 WhatsApp — abre a conversa com o resumo do saldo já escrito
• 🔗 Link do cliente — o endereço só-leitura para mandar a ele
• ⬇ CSV e 🖨 Imprimir — para anexar à cobrança

Idade das caixas

O que está na rua é separado em quatro faixas — 0-7, 8-15, 16-30 e +30 dias — considerando que as caixas mais antigas são as que ainda não voltaram.

Serve para separar pendência de perda. Caixa de três dias é operação normal; caixa de quarenta dias não volta mais, e é onde a cobrança deve começar.

Movimentos

Tudo o que foi lançado, por qualquer pessoa, numa lista só. É a aba de auditoria e conserto: onde se acha o lançamento errado e onde ele se corrige.

Os filtros

Cada um recarrega a lista sozinho ao mudar. O ⬇ CSV leva o recorte para a planilha.

As colunas da tabela

Arraste o título para trocar a coluna de lugar, e a borda direita para mudar a largura — como no Painel de Ativos. Para esconder, e para fazer as duas sem arrastar, use a aba Colunas.

A coluna dos botões de ação fica de fora: ela não é dado, é o caminho para corrigir. Escondível, alguém a esconderia sem querer e perderia o único jeito de consertar um lançamento; arrastável, cairia no meio da leitura.

Corrigir, cancelar, excluir

• corrigir — muda data, origem, destino, tipo de caixa, quantidade e mais. Guarda o valor antigo, o novo, quem mudou e quando
• cancelar — a linha continua no histórico, marcada como cancelada, e deixa de contar no saldo
• excluir — apaga de vez. Use só para o que nunca deveria ter existido

Colunas

Uma tela só para o desenho das tabelas. Antes, esconder e mover coluna morava dentro do painel de filtros do Painel de Ativos, e num segundo botão na barra de Movimentos — dois lugares diferentes para o mesmo ajuste, e nenhum deles onde se procura.

Uma ficha por módulo

Cada módulo com tabela ajustável tem a sua ficha, e dentro dela uma linha por coluna. Em cada linha, as três coisas que se pode fazer:

• ↑ e ↓ — movem a coluna de lugar. A primeira não sobe, a última não desce, e os botões ficam apagados quando não há para onde ir
• O número em px — a largura da coluna. Vale a partir de 70px
• ✕ esconder — tira a coluna da tabela. Escondida, a linha fica apagada e o botão vira ↩ mostrar

As três estão escritas por extenso no alto da página. A primeira versão usava uma caixa de marcar para esconder, e ninguém achava: marcada, ela não diz o que acontece ao desmarcar, e a palavra esconder não aparecia em lugar nenhum da tela.

Hoje são três: Painel de Ativos, Movimentos e Cadastros · Usuários. O Painel, os Extratos e as demais listas de Cadastros ainda não aparecem, e a própria tela diz isso no rodapé — módulo que falta sem explicação parece coisa quebrada.

A de Usuários é a mais larga do app: nove colunas de dado. Quem não usa e-mail nem telefone esconde as duas e ganha a tela de volta — e é aí que esta aba paga por si.

É o mesmo ajuste da tabela

Esta tela grava no mesmo lugar que o arrasto no cabeçalho: mover aqui é mover lá. Assim que se muda algo, a tabela do módulo se redesenha — não é preciso trocar de aba para ver.

O restaurar padrão de cada ficha apaga as três preferências de uma vez — ordem, largura e escondidas. Apagar só uma deixaria a tabela num meio-termo que ninguém escolheu.

Tudo isso fica guardado neste navegador, e não na conta. É preferência de quem olha, como o zoom da tela — não muda dado, não muda saldo, e não viaja para o computador do colega.

A largura grava quando o campo perde o foco, não a cada tecla: digitando 1 antes de 2 e 0, a coluna encolheria ao mínimo no meio da digitação.

Quem vê esta aba

Qualquer pessoa que tenha o painel — ela não é exclusiva do administrador. Escolher coluna não muda dado nenhum; é a mesma natureza de recolher a coluna da esquerda. Como as outras, pode ser tirada de alguém pela lista de abas do cadastro.

Cadastros

Três blocos, cada um com o seu botão de + Novo.

A tabela de Usuários é ajustável: arraste o título para trocar a coluna de lugar, a borda direita para mudar a largura, e use a aba Colunas para esconder o que não interessa. É a mais larga do app — nove colunas de dado —, então é onde mais rende. Os botões de editar, desativar e excluir ficam fora do ajuste.

Locais e rotas

Todos ficam na mesma lista, mudando só o Tipo: galpão, filial, cliente e rota. Os campos que pesam no dia a dia:

Na lista, cada local tem desativar e excluir. Excluir só funciona em cadastro que nunca rodou: se já tem movimento — ou se é uma rota que já atende algum cliente — o sistema desativa e avisa, porque apagar deixaria o histórico apontando para o vazio.

Locais padrão

Onde a pessoa trabalha — Escritório Central, Base Recife. É o que aparece na coluna Local padrão dos usuários.

Repare que é um cadastro diferente de Locais e rotas. Lá ficam os nós que guardam caixa e têm saldo; aqui é só o posto de trabalho. Um escritório nunca vai segurar caixa, mas é onde alguém fica.

Motoristas

Quem leva a carga, com telefone, CPF, número e categoria da CNH, validade e placa habitual. É essa lista que aparece para escolha na saída do galpão.

Tipo: Fixo é quem roda sempre as mesmas rotas; Volante é quem cobre qualquer uma. O volante aparece na lista de todas as rotas, mesmo que tenha rotas marcadas — se não fosse assim, o campo estaria mentindo. Deixar em branco tem o mesmo efeito prático de volante, e é como ficam os motoristas cadastrados antes deste campo existir.

Rotas que atende: marque as rotas de cada motorista e o celular passa a oferecer só quem atende a rota escolhida na saída. Nada marcado quer dizer todas — ele aparece em qualquer rota. Se a rota escolhida não tiver ninguém atribuído, a lista volta a mostrar todos: melhor oferecer todo mundo do que travar a saída porque faltou um cadastro. Sobrando um único motorista, ele já vem preenchido.

Cadastrar aqui é pré-requisito para a saída do galpão: no celular o motorista se escolhe numa lista fechada, e quem não estiver cadastrado não pode ser lançado.

Quem sai da empresa se desativa pelo botão na lista: ele some da escolha de motorista na saída do galpão, mas o nome continua legível no cadastro e nas cargas que já levou. Excluir apaga de vez — use só para quem foi cadastrado errado.

Cadastro separado dos usuários de propósito: motorista é quem dirige, não quem usa o app. A maioria nunca vai fazer login, e criar conta com PIN para cada um seria inventar senha que ninguém usa.

A validade da CNH aparece em vermelho quando está vencida. O app não bloqueia a saída por isso — só mostra, para o escritório resolver.

Tipos de caixa

Nome e peso em quilos. O peso é opcional, mas vale a pena: é o que separa duas caixas de mesmo nome na hora de lançar, quando aparecem como Caixa Banana · 20 kg. Mantenha a lista curta — ela é escolhida no celular, com pressa.

Não há valor em dinheiro em lugar nenhum do app: nem preço de caixa, nem coluna de valor no painel ou no CSV. Foi retirado em setembro/2026. Caixa perdida se conta em caixas.

Cada quadro desta aba abre e fecha no clique do título, e começa fechado — seis cadastros abertos ao mesmo tempo deixam o que você procura a três rolagens de distância. O número ao lado do nome diz quantos itens há dentro, então quadro fechado não se confunde com cadastro vazio. O que você abrir continua aberto na próxima visita, neste mesmo navegador.

Usuários

O campo Perfil aceita escrever: se o cargo que você precisa não está na lista, digite. Um perfil novo nasce sem poder nenhum — não cadastra e não administra. É de propósito: permissão por digitação seria permissão por engano de digitação. O que a pessoa pode fazer vem das chaves logo abaixo, não do que está escrito no cargo.

Perfis de fábrica: Admin, Gestor, Gerente, Conferente, Motorista e Promotor. Só o Admin tem poder próprio — cadastros e correções. Os outros valem como cargo escrito no crachá: o que cada um pode fazer vem das chaves do cadastro, uma a uma, e não do nome do perfil.

Pode entrar no painel? decide, pessoa por pessoa, quem abre o endereço do escritório. Antes isso vinha do perfil: todo GALPAO entrava. Agora um conferente pode lançar no celular sem ver os números da operação, e um promotor pode ver os números sem virar administrador. Quem fica sem acesso continua usando o app de campo normalmente. Administrador entra sempre — a opção fica travada para ele, senão daria para trancar o último administrador do lado de fora.

Nome, e-mail, perfil, PIN e local padrão. O usuário — ou o e-mail, ou o próprio nome — é o que a pessoa digita na tela de entrada, e serve para as duas credenciais: é o segredo que muda, não o identificador. Um PIN por pessoa, nunca um PIN de função compartilhado entre vários: é o nome de quem contou que dá peso à divergência.

Onde cada um pode lançar

No cadastro do usuário, dois quadros de marcar decidem quais locais aparecem no celular daquela pessoa: Saída (de onde as caixas saem) e Destino (para onde vão). Nada marcado quer dizer nenhum — marcar é conceder. Quem tiver um único local liberado já encontra o campo preenchido, sem precisar escolher.

No retorno os papéis se invertem, porque é o caminho de volta: quem devolve vem da lista de Destino, e quem recebe vem da de Saída.

O que cada um pode lançar

Operações decide se a pessoa lança Saída, Retorno ou os dois. A aba que ela não pode usar some do celular — e, mais importante, o servidor recusa o lançamento mesmo que o pedido chegue por fora do app.

Em quais locais ela ajusta o saldo

Ajustes e perdas marca os locais cujo saldo aquela pessoa pode corrigir pela aba Ajustes — saldo inicial e baixa de perda. Nada marcado = nenhum.

Antes, ter a aba Ajustes dava o saldo inteiro: qualquer galpão, filial, cliente ou rota. Agora a aba é a porta e esta lista é o quarto. Um conferente de filial pode corrigir o saldo da filial dele sem poder mexer no da matriz.

Na aba Ajustes, o seletor de local passa a mostrar só os liberados, e um aviso diz quais são e que é o administrador quem libera — lista curta e sem explicação parece cadastro faltando.

O que cada um pode ver no painel

Abas do painel marca, uma a uma, quais das sete abas do escritório aquela pessoa enxerga. Um gerente pode ver o Painel de Ativos e os Extratos sem ver Movimentos; um conferente pode entrar só para consultar.

Lançamentos: se vê, e de quem

Duas perguntas, uma embaixo da outra:

• Vê os lançamentos? — em não, a aba Lançamentos some do app dela e o painel não lista movimento nenhum
• De quem ela vê os lançamentos — a lista de usuários, com marcar todos. Nada marcado = ninguém. Marque só ela mesma para ela ver apenas o que lançou, ou marque todos para ela ver a operação inteira

O seletor Pode entrar no painel?, mais acima, é um atalho para os casos comuns — todos e apenas os lançamentos dele mesmo. Ele e a lista são a mesma coisa: escolher no seletor marca a lista, e mexer na lista muda o que o seletor mostra. Quando você marca pessoas específicas, ele passa a dizer vê de pessoas escolhidas abaixo.

A segunda trava enquanto a primeira estiver em não — não há de quem ver, e marcar ali não faria efeito.

Ajustes e Cadastros aparecem com a etiqueta dá poder, e você pode concedê-las a quem quiser — basta marcar. A diferença delas é que não entram no "nada marcado = todas": só valem se você marcar de propósito.

Em todos esses quadros — Saída, Destino, Operações, Abas, Ajustes, Tipos de caixa, Motoristas e De quem vê — nada marcado quer dizer nada liberado. Marcar é conceder.

Quem sai da empresa se desativa, pelo botão na lista. Existe também excluir, mas ele só apaga de verdade quem nunca lançou nada: quem já tem movimento no histórico é desativado, porque o nome de quem contou é o que dá peso à divergência. Inativo some das listas e não consegue mais entrar; reativar devolve o acesso.

Pedidos de senha

Este cartão só aparece quando alguém pediu ajuda para entrar no painel. Cada linha mostra o que a pessoa digitou, quando pediu e a qual usuário aquilo corresponde — ou não encontrado, se não corresponder a ninguém cadastrado. Cadastre a senha nova em Usuários, avise a pessoa e depois clique em marcar resolvido.

O último administrador ativo não pode ser desativado nem excluído — nem por ele mesmo. Sem ele ninguém entra no painel, e a volta seria por SQL no banco.

Ajustes

A aba Ajustes existe para o que não passou pelo celular — o histórico anterior ao app, o acerto de erro antigo, a baixa de perda negociada, o saldo inicial de cada local. Só o administrador a enxerga.

Nada é apagado neste app. Lançamento errado se cancela na aba Movimentos, informando o motivo — a linha continua no histórico, marcada como cancelada.

Link do cliente

Cada cliente tem um endereço próprio, com um código no fim. Abre sem login, em qualquer celular, e mostra três coisas: quantas caixas ele tem hoje, a idade delas e o histórico completo de saídas e devoluções. Tem botão de imprimir.

Pegue o link em Cadastros → o cliente → Link do cliente → Copiar link, ou no botão 🔗 Link do cliente da aba Extratos.

É a peça que muda a conversa de cobrança: em vez de mandar um número que o cliente precisa acreditar, você manda o extrato que ele consulta sozinho, na hora que quiser.

Trabalho offline

Galpão de parede grossa e estrada de interior derrubam sinal. O app lida com isso sem pedir nada a quem está usando.

• Sem internet, o lançamento fica guardado no próprio celular, e o topo da tela mostra quantos estão na fila
• Quando o sinal volta, sobe sozinho — ninguém precisa reenviar
• Reenvio não duplica: cada lançamento carrega uma chave única, e é o próprio banco que recusa a repetição
• Se a memória do celular apertar, o app guarda a contagem e descarta a foto — perder a foto é ruim, perder a contagem é pior

O indicador ● Online no topo fica vermelho quando a conexão cai, e mostra o número de itens na fila quando há pendência.

Tipos e estados

Quem vê o quê

O perfil quase não decide nada. chave = vem de um campo do cadastro daquela pessoa, e não do cargo dela.

O Promotor é a única exceção que ainda mora no perfil: ele não vê a aba de Saída, porque trabalha dentro do cliente. O Admin entra no painel sempre, mesmo com a chave desligada — senão daria para trancar o último administrador do lado de fora, e a volta seria por SQL.

Tipos de movimento

Status da carga

É a coluna Status da aba Movimentos, e o filtro de mesmo nome. Ela não diz se o lançamento valeu — todos valem na hora —, e sim em que ponto do ciclo aquela carga está.

O estado AGUARDANDO não existe mais. Lançamentos antigos que ficaram nele passaram a contar no saldo — do contrário ficariam valendo zero para sempre, já que a tela que os confirmava saiu do app.

Lançamento de teste

Quem tem a palavra teste no perfil produz lançamento de teste. Ele conta no saldo como qualquer outro — o que muda é só a leitura: todas as telas têm um seletor Só reais / Só de teste, e nunca os dois misturados. Somar ensaio com operação daria um número que não responde nem a uma pergunta nem a outra.

Nota técnica

Site estático na Vercel, com banco Postgres no Supabase. Sem servidor para manter e sem mensalidade.

O navegador nunca fala com o banco. A chave que abre o Postgres fica no servidor, numa variável de ambiente; a página conhece só o caminho /api. É o que permite manter o PIN curto e o link aberto do cliente sem deixar o banco exposto — tentar ler o banco de fora responde 401 não autorizado.

As fotos ficam no armazenamento do Supabase, e o link aparece no extrato. Lançamentos antigos podem ter assinatura anexada — o campo saiu da tela em setembro/2026, mas o que já foi gravado continua lá.

Alterou o código? Um git push na branch main e a Vercel publica sozinha, em menos de um minuto. Antes disso rode as duas suítes principais:

A primeira executa as regras de produção contra um banco falso em memória — sem rede e sem chave. A segunda lê o HTML e o JavaScript das páginas e confere que cada filtro, coluna e botão está ligado dos dois lados: um campo que aparece na barra mas não viaja no pedido, ou uma coluna com cabeçalho e sem célula, falha ali em vez de falhar na tela de quem usa.

Mexeu em app.js ou styles.css? Rode python scripts/versionar.py antes de commitar. Não há passo de compilação, e sem isso o navegador continua servindo o arquivo antigo do cache — às vezes com HTML novo e JavaScript velho, que é pior do que só estar velho.