Separação de Painéis: SaaS vs Cliente
Definição canônica e fechada dos dois painéis do DBCHECKOUT — decisão crítica para segurança, escalabilidade e clareza comercial
0Ecossistema de Produtos DB
Três produtos compõem o ecossistema. Cada um tem responsabilidade exclusiva e não se sobrepõe.
dbcheckout
PDV · Self-Checkout · Operação
- Opera caixas físicos e self-checkouts
- Emite NFC-e via Celery/Redis
- Grava pedidos no MySQL legado
- FastAPI + Next.js + aiomysql
Usuários: Operadores de Caixa
Stack: FastAPI · Next.js · MySQL
MySQL Legado
fonte de verdade
ETL Noturno
edge function
PostgreSQL
analítico (Supabase)
dbdash
Dashboard Analítico
- Lê KPIs do PostgreSQL
- Análises para gestores
- Insights de IA
Painel SaaS Admin
Gestão da Plataforma
- Redes · Lojas · Planos
- Monitoramento ETL
dbcheckout
Operadores de Caixa
dbdash
Donos · Gerentes · Analistas
Painel SaaS
Time DB · Suporte · TI
Princípio Fundamental
Nada se sobrepõe. Nada mistura. Essa separação evita problemas comerciais, técnicos e jurídicos.
Painel Administrativo
Gerencia o SaaS, não o negócio do cliente
Painel do Cliente
Gerencia o negócio dele, não a plataforma
1Painel Administrativo do SaaS
Quem Usa
Responsabilidade: Gerenciar o SaaS, não o negócio do cliente
1.1 Gestão de Tenants (REDE)
- Criar / editar / desativar redes
- Cadastrar CNPJ
- Definir plano
- Limites de lojas
- Status (ativo / suspenso)
❌ Não vê: Dados de vendas detalhados | Não interfere na operação da loja
1.2 Gestão de Lojas
- Cadastro de lojas por rede
- Código da loja
- Status da loja
- Última consolidação
- Erros de ingestão
1.3 Gestão de Usuários (SaaS)
- Criar usuários
- Reset de senha
- Atribuir perfil
- Bloquear acesso
📌 Regra: Nunca altera dados do cliente
1.4 Integrações & Ingestão
- Configuração de ingestão
- Monitor de uploads
- Logs de processamento
- Reprocessamento técnico
- Erros de schema
1.5 Saúde da Plataforma
- Uso de storage
- Volume de dados por rede
- KPIs de performance do sistema
- Status do Supabase
- Jobs e filas
1.6 Comercial & Billing
- Planos
- Assinaturas
- Limites contratados
- Upgrade / downgrade
- Status de pagamento
1.7 Governança & Auditoria
- Logs de acesso
- Logs administrativos
- Eventos críticos
- Compliance LGPD
O que NÃO Existe no Painel Administrativo
2Painel do Cliente (REDE / LOJA)
Quem Usa
Responsabilidade: Gerenciar o negócio dele, não a plataforma
2.1 Dashboard Executivo
- Faturamento
- Pedidos
- Ticket médio
- Crescimento
- Comparativos
2.2 Vendas & Origem
- Vendas por canal
- Salão / Delivery / Retirada
- Horários
- Dias da semana
2.3 Produtos (Grupo / Tipo / Tamanho)
- Mix de produtos
- Margem
- Curva ABC
- Participação
- Preço médio
2.4 Delivery
- Tempo médio
- Entregadores
- Bairros
- SLA
- Gargalos
2.5 Financeiro
- Formas de pagamento
- Apuração de caixa
- Recebíveis
- Quebras
- Taxas
2.6 Fiscal & Custos
- Tributos
- CMV
- Margem
- Custo real
- Impacto fiscal
2.7 IA & Insights
- Alertas
- Sugestões
- Comparativos
- Tendências
- Previsões
2.8 Configurações do Cliente
- Perfil do usuário
- Loja ativa
- Período padrão
- Preferências visuais
O que NÃO Existe no Painel do Cliente
3Segurança (CRÍTICO)
| Camada | Regra |
|---|---|
| Frontend | Apps separados |
| Backend | Guards por role |
| Supabase | RLS por rede |
| JWT | Claims diferentes |
📌 Um usuário nunca navega entre painéis
4Estrutura de Rotas
Painel Administrativo
/saas/admin/*Todas as rotas do painel administrativo do SaaS
Painel do Cliente
/app/dashboard/*Todas as rotas do dashboard do cliente
5Benefícios da Separação
Segurança Jurídica
Separação clara de responsabilidades e dados
Clareza Comercial
Cliente entende exatamente o que está contratando
Escala SaaS
Arquitetura preparada para crescimento exponencial
Menos Suporte
Usuários não se confundem com funcionalidades
Produto Profissional
Percepção de qualidade e maturidade
Evolução Independente
Cada painel evolui sem impactar o outro
Veredito Técnico
Essa separação é uma das decisões mais críticas de um SaaS profissional. Ela garante segurança, escalabilidade, clareza comercial e evita problemas técnicos e jurídicos no futuro.
🎯 DBCHECKOUT está pronto para operar como um SaaS de nível corporativo
Especificações Relacionadas
Arquitetura de Painéis
DBCHECKOUT - Separação SaaS vs Cliente v1.0