FechaCaixa

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.

E-mailteste@email
Senhateste-12345
Abrir fechacaixa.io

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.

O formulário

no celular da loja

Abre no endereço da empresa e não pede login. O aparelho digita o código de acesso uma vez e vale por 180 dias.

  • Instala como app na tela de início
  • Manhã e tarde; domingo e feriado, um turno só
  • Dinheiro, Pix, cartão — e as saídas do turno
  • Revisão com o total antes de enviar

O painel

com login, para a gerência

Onde o dia vira número: o que cada loja fez, o que ainda não chegou e para onde foi o dinheiro que saiu da gaveta.

  • Conferir, corrigir, cancelar ou lançar um turno retroativo
  • Saídas separadas: retirada, despesa, consumo e desperdício
  • Alerta de loja que não lançou e de lançamento repetido
  • Gráficos do período e planilha para exportar
  • Cada empresa com as suas lojas, funcionários e aparelhos

As telas do painel

Uma rota por pergunta que a gerência faz durante o dia.

/fechamentos

O que foi lançado, para conferir e corrigir

/por-loja

Quanto cada loja fez e quais turnos ainda não chegaram

/saidas

Retiradas e quem retirou, despesas, consumo e desperdício

/graficos

A evolução do período

/notas-fiscais

As NF-e importadas, por loja e por plano de contas

/catalogo

Os salgados da empresa, para o desperdício ser contado por item

/empresa

Có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.

Admin

Tudo, mais o Django Admin.

Gerente

A própria empresa: código de acesso, lojas, funcionários, quem pode retirar dinheiro — e o painel.

Funcionario

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.