Dopamina ERP
Painel administrativo privado do Bar Dopamina. A aplicação centraliza autenticação, vendas, CMV, despesas, compras, estoque, planejamento, cadastros e importações em uma única base Supabase.
Stack
- Next.js 16 + React 19 + TypeScript
- Supabase Auth + Postgres + Row Level Security
- Vercel para hospedagem de produção
- GitHub para versionamento
Rodando localmente
- Use Node.js 22 ou superior.
- Copie
.env.example para .env.local e preencha as duas variáveis públicas.
- Execute
npm install.
- Execute
npm run dev.
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=
SUPABASE_SERVICE_ROLE_KEY=
ZIG_API_TOKEN=
ZIG_REDE_ID=c2e57314-673f-408c-926a-a553dd187e8f
ZIG_LOJA_ID=e40336a8-5039-4237-b75c-972c79c7e467
CRON_SECRET=
Publicação
O repositório é a fonte oficial do projeto. A Vercel deve estar conectada à
branch main e receber as duas variáveis públicas acima nos ambientes de
produção, preview e desenvolvimento. Cada atualização da main gera uma nova
publicação automática.
Estrutura funcional
/: login, cadastro e recuperação de senha./auth/redefinir: definição de uma nova senha após o link do Supabase./dashboard: área protegida para proprietário e gerência aprovados.supabase/migrations: esquema central, índices, RLS e fluxo de aprovação.
Todo cadastro novo entra como manager com status pending. O primeiro proprietário deve ser promovido manualmente no Supabase; depois, o próprio fluxo administrativo poderá aprovar a gerência.
Base de dados central
| Domínio | Fonte única |
|---|
| Pessoas e acesso | profiles + business_members |
| Negócio e áreas | businesses + areas |
| Produtos, insumos e consumo | items + recipes + recipe_items |
| Fornecedores e compras | suppliers + purchases + purchase_items |
| Vendas e importações | sales_imports + sales + sale_items |
| Estoque | stock_movements + inventory_counts |
| Despesas e planejamento | expenses + forecasts |
| Rastreabilidade | audit_logs |
As telas não criam cópias paralelas desses dados. Por exemplo, CMV, estoque e compras compartilham os mesmos itens e custos.
API Zig
Vendas, faturamento e formas de pagamento possuem uma integração server-only e incremental. A sincronização consulta a Zig por dia, registra tentativas, não duplica transações e mantém as planilhas como contingência. O mapeamento completo, regras e pendências estão em docs/zig-api-integration.md.
Segurança
- RLS está habilitado em todas as tabelas operacionais.
- Usuários autenticados só enxergam dados do negócio quando a associação está ativa.
- Novos cadastros não recebem acesso automaticamente.
- Chaves administrativas do Supabase nunca devem ser expostas no navegador.
Verificação
npm run lint
npm run build
