Especificação Técnica

Painel do Cliente (Rede / Loja)

Especificação completa com wireframes, componentes, fluxos de tela e regras de negócio para o dashboard analítico do DBCHECKOUT

Versão 1.0•Última atualização: Janeiro 2025

1Visão Geral do Painel

Usuários

Donos de rede, gerentes, administrativo e operação

Objetivo

Gerenciar o negócio com dados consolidados e IA

Isolamento

Cada rede vê apenas seus próprios dados

Princípio Fundamental

Este painel é focado 100% no negócio do cliente. Ele não tem acesso a configurações da plataforma, billing ou dados de outras redes. Tudo é filtrado por RLS no Supabase.

2Layout e Navegação

Pizza Express
Loja 045 ▼
Jan 2025 ▼
Dashboard
Vendas
Produtos
Delivery
Financeiro
Fiscal
IA Insights

Wireframe: Layout Principal do Cliente

Sidebar (Navegação Principal)

  • Dashboard - Visão executiva
  • Vendas & Origem - Canais e horários
  • Produtos - Mix e margem
  • Delivery - Performance de entrega
  • Financeiro - Caixa e recebíveis
  • Fiscal & Custos - Tributos e CMV
  • IA Insights - Alertas e sugestões

Header (Barra Superior)

  • Seletor de Loja

    Admin de rede vê todas as lojas

  • Filtro de Período

    Dia / Semana / Mês / Ano

  • Exportar Dados

    CSV / Excel / PDF

  • Perfil do Usuário

    Configurações e logout

3Módulo: Dashboard Executivo

Dashboard Executivo - Janeiro 2025
Faturamento
R$ 142k
↑ 12.5%
Pedidos
1.247
↑ 8.3%
Ticket Médio
R$ 114
↑ 3.8%
Margem
42.3%
↓ 1.2%
Faturamento (últimos 30 dias)
Vendas por Canal
Top 5 Produtos

Wireframe: Dashboard Executivo

KPIs Principais

Faturamento

Soma de todas as vendas no período

Fonte: kpi_vendas_[periodo].faturamento

Comparativo: vs. período anterior

Pedidos

Total de pedidos realizados

Fonte: kpi_vendas_[periodo].pedidos

Comparativo: vs. período anterior

Ticket Médio

Valor médio por pedido

Fonte: kpi_vendas_[periodo].ticket_medio

Cálculo: Faturamento / Pedidos

Margem

Margem de contribuição percentual

Fonte: kpi_vendas_[periodo].margem

Cálculo: (Faturamento - CMV) / Faturamento

Gráficos e Visualizações

  • Evolução do Faturamento

    Gráfico de linha mostrando tendência dos últimos 30 dias

  • Vendas por Canal

    Gráfico de pizza: Salão / Delivery / Retirada

  • Top 5 Produtos

    Ranking dos produtos mais vendidos com faturamento

  • Comparativo Semanal

    Gráfico de barras comparando semanas do mês

Filtros Temporais

Dia

Visão diária

Semana

Consolidado semanal

Mês

Consolidado mensal

Ano

Consolidado anual

Regra: Todos os filtros consomem dados das tabelas consolidadas correspondentes (kpi_vendas_dia, kpi_vendas_semana, kpi_vendas_mes, kpi_vendas_ano)

4Módulo: Vendas & Origem

Vendas por Canal

45%
Salão

R$ 63.900 em 562 pedidos

38%
Delivery

R$ 53.960 em 474 pedidos

17%
Retirada

R$ 24.140 em 211 pedidos

Vendas por Horário

11:00 - 14:00
R$ 92.300
18:00 - 22:00
R$ 63.900
14:00 - 18:00
R$ 35.550

Vendas por Dia da Semana

SEGR$ 18k
TERR$ 16k
QUAR$ 19k
QUIR$ 21k
SEXR$ 28k
SÁBR$ 32k
DOMR$ 24k

5Módulo: Produtos (Grupo / Tipo / Tamanho)

Hierarquia de Produtos

1
Grupo

Ex: Pizzas, Bebidas, Sobremesas

2
Tipo

Ex: Pizza Salgada, Pizza Doce, Refrigerante

3
Tamanho

Ex: Pequena, Média, Grande, Família

Mix de Produtos

Pizzas SalgadasR$ 89.400 (63%)

784 unidades • Margem: 45.2%

BebidasR$ 28.400 (20%)

1.247 unidades • Margem: 62.8%

Pizzas DocesR$ 17.040 (12%)

142 unidades • Margem: 48.5%

SobremesasR$ 7.100 (5%)

89 unidades • Margem: 55.3%

Curva ABC

ProdutoCategoriaFaturamentoQtdMargemClasse
Pizza Calabresa GPizza SalgadaR$ 24.50024546.2%A
Pizza Mussarela GPizza SalgadaR$ 21.80021844.8%A
Coca-Cola 2LBebidasR$ 15.60078065.0%B
Pizza Portuguesa MPizza SalgadaR$ 12.40015543.5%B
PudimSobremesasR$ 3.2004058.0%C

6Módulo: Delivery

Performance de Entrega

Tempo Médio

38min

Meta: 45min

No Prazo

87%

412 de 474 pedidos

Atrasados

13%

62 pedidos

Entregas por Bairro

Centro

142 entregas • Tempo médio: 32min

R$ 16.100
Jardim América

98 entregas • Tempo médio: 38min

R$ 11.200
Vila Nova

87 entregas • Tempo médio: 42min

R$ 9.900
Bairro Distante

45 entregas • Tempo médio: 58min ⚠️

R$ 5.100

Performance dos Entregadores

EntregadorEntregasTempo MédioNo PrazoStatus
João Silva14234min92%Excelente
Maria Santos12836min89%Excelente
Pedro Costa9842min85%Bom
Ana Oliveira10648min78%Atenção

7Módulo: Financeiro

Formas de Pagamento

Cartão de Crédito
52%

R$ 73.840

648 transações

PIX
28%

R$ 39.760

349 transações

Dinheiro
15%

R$ 21.300

187 transações

Cartão de Débito
5%

R$ 7.100

63 transações

Recebíveis

Já Recebido

Dinheiro + PIX

R$ 61.060
A Receber (D+1)

Cartão de débito

R$ 7.100
A Receber (D+30)

Cartão de crédito

R$ 73.840

Taxas e Comissões

Forma de PagamentoFaturamentoTaxaCustoLíquido
Cartão de CréditoR$ 73.8403.5%-R$ 2.584R$ 71.256
PIXR$ 39.7600.99%-R$ 394R$ 39.366
DinheiroR$ 21.3000%R$ 0R$ 21.300
Cartão de DébitoR$ 7.1001.99%-R$ 141R$ 6.959
TOTALR$ 142.000-R$ 3.119R$ 138.881

8Módulo: IA Insights

Alertas Inteligentes

Margem em Queda

A margem caiu 1.2% este mês. Principais causas: aumento no custo de ingredientes (+8%) e promoções agressivas.

Sugestão: Revisar precificação ou negociar com fornecedores

Delivery Lento em Horário de Pico

Entre 19h-21h, o tempo médio de entrega está 15min acima da meta. Isso pode estar afetando a satisfação dos clientes.

Sugestão: Adicionar 1 entregador no horário de pico

Oportunidade: Bebidas

Bebidas têm margem de 62.8%, mas representam apenas 20% do faturamento. Há espaço para aumentar vendas nesta categoria.

Sugestão: Criar combos pizza + bebida com desconto

Tendência Positiva

Faturamento cresceu 12.5% vs. mês anterior. Sexta e sábado são os dias mais fortes, representando 42% da receita semanal.

Continue monitorando para manter o crescimento

Previsões e Tendências

Previsão de Faturamento

Próximos 7 dias baseado em histórico

SegR$ 4.200
TerR$ 3.800
QuaR$ 4.500
QuiR$ 5.000
SexR$ 6.700
SábR$ 7.600
DomR$ 5.700
Produtos em Alta

Crescimento nos últimos 30 dias

Pizza Portuguesa

+28%

Coca-Cola 2L

+18%

Pizza Doce Brigadeiro

+12%

Como a IA Funciona

  • Análise de Dados Consolidados

    A IA consome apenas dados das tabelas consolidadas (kpi_vendas_*), nunca acessa o banco legado

  • Comparativos Automáticos

    Compara período atual vs. anterior, identifica variações significativas e gera alertas

  • Previsões Baseadas em Histórico

    Usa dados históricos para prever tendências e sugerir ações preventivas

  • Insights Armazenados

    Todos os insights são salvos na tabela ai_insightspara histórico e auditoria

9Fluxos de Tela Principais

Fluxo 1: Análise de Queda de Faturamento

1

Dashboard

Identificar queda no KPI

2

Vendas & Origem

Verificar canais

3

Produtos

Analisar mix

4

IA Insights

Ver sugestões

Fluxo 2: Otimização de Delivery

1

IA Insights

Alerta de atraso

2

Delivery

Ver performance

3

Entregadores

Identificar gargalo

4

Ação

Ajustar escala

Fluxo 3: Exportação de Relatório

1

Qualquer Módulo

Selecionar período

2

Header

Clicar em "Exportar"

3

Modal

Escolher formato

4

Download

Arquivo gerado

10Stack Tecnológico

Frontend

  • • React 19
  • • TypeScript
  • • TailwindCSS
  • • React Router
  • • Recharts (gráficos)
  • • React Query

Banco de Dados

  • • Supabase (PostgreSQL)
  • • Row Level Security
  • • Realtime subscriptions
  • • Tabelas consolidadas

IA & Analytics

  • • OpenAI GPT-4
  • • Análise preditiva
  • • Alertas automáticos
  • • Sugestões contextuais

Especificações Relacionadas

Arquitetura de Painéis

Separação SaaS vs Cliente

Painel Administrativo

Gestão da plataforma SaaS

Setup Supabase

Base principal do sistema

Especificação Geral

Visão geral da plataforma

Especificação do Painel do Cliente

DBCHECKOUT - Dashboard Analítico v1.0

Voltar ao Início