O caixa do dia, fechado no balcão.
Cada loja lança o turno pelo celular, sem login e sem treinamento. A gerência confere, corrige e vê para onde foi o dinheiro — de um painel só.
Entre e olhe por dentro
O painel está no ar com dados de exemplo. Use a conta de teste — dá para navegar por fechamentos, saídas, gráficos e notas fiscais.
Duas metades, dois públicos
Quem fecha o caixa é quem estava no balcão, no fim do expediente, com pressa. Quem confere está no escritório, no dia seguinte. São duas telas, não uma com permissões em cima.
As telas do painel
Uma rota por pergunta que a gerência faz durante o dia.
/fechamentosO que foi lançado, para conferir e corrigir
/por-lojaQuanto cada loja fez e quais turnos ainda não chegaram
/saidasRetiradas e quem retirou, despesas, consumo e desperdício
/graficosA evolução do período
/notas-fiscaisAs NF-e importadas, por loja e por plano de contas
/catalogoOs salgados da empresa, para o desperdício ser contado por item
/empresaCódigo de acesso, lojas, funcionários e aparelhos conectados
/<empresa>O formulário do turno, no endereço público de cada empresa
Quem enxerga o quê
Todo usuário pertence a um grupo; sem grupo, o login é recusado. O isolamento por empresa vive no get_queryset de cada ViewSet — quem chamar a API direto continua vendo só a própria conta.
Tudo, mais o Django Admin.
A própria empresa: código de acesso, lojas, funcionários, quem pode retirar dinheiro — e o painel.
O painel. Vê, confere e corrige o caixa; não administra a empresa.
Quatro decisões que explicam o resto
O token nunca chega ao JavaScript
O JWT vive em cookie HTTP-only. O navegador chama sempre o próprio domínio, em /backend/*, e o Next reescreve para o Django — assim o cookie continua first-party.
A empresa vem do cookie, não da URL
O aparelho da loja carrega a empresa no próprio cookie. Trocar um número no endereço não abre as lojas de mais ninguém.
Nenhuma despesa entra sem prova
A NF-e chega como XML, lida com proteção contra expansão de entidades. Nota de saída, nota de outra empresa e nota repetida são recusadas — e a mesma prova não entra duas vezes.
Nada sob /api/ é guardado
Toda resposta sai com Cache-Control: no-store. Sem isso a lista de lojas congelava no celular do balcão mesmo depois de recarregar — o pedido nem saía do aparelho.
Como é feito
Dois repositórios independentes, cada um com o seu Docker Compose, ligados como submódulos no repositório guarda-chuva. Deploy em Coolify.
Backend
FechaCaixa-back
- Python 3.12 · Django 6 base
- Django REST Framework rotas e regras
- SimpleJWT token em cookie HTTP-only
- Celery + Redis trabalho em segundo plano
- MySQL banco
- drf-spectacular Swagger gerado do código
- openpyxl planilha do painel
Frontend
FechaCaixa-front
- Next.js 16 App Router
- React 19 · TypeScript componentes e tipos
- Tailwind CSS 4 · HeroUI estilo
- TanStack Query cache dos dados do servidor
- Zustand estado de sessão
- Vitest testes
- PWA o formulário instala no celular
O código
Cada repositório tem o próprio README, com as variáveis de ambiente, os comandos e as decisões daquele lado.