Relatórios — Visão Geral

Tempo estimado: 5 minutos por relatório

Onde Acessar

/admin/reports — hub central de tudo que produz relatório.

Relatórios Pré-Construídos

Os mais usados (1 clique para gerar):

Vendas

• Vendas por Período — diário/semanal/mensal com breakdown
• Vendas por Item — top items vendidos no período
• Vendas por Forma de Pagamento — cash vs cartão vs PIX
• Vendas por Canal — PDV / Delivery / Marketplace

Operacional

• CMV Detalhado — custo por categoria de menu
• SLA Cozinha — tempo de preparo, % no prazo
• Turnover de Mesa — taxa de rotação por mesa
• No-Show Reservas — clientes que faltaram

Pessoal

• Vendas por Atendente — performance individual
• Cortesias por Atendente — fraud surveillance
• Horas Trabalhadas — total por funcionário no mês
• Folha — Resumo — preview antes de processar

Fiscal

• NF-es Emitidas — total + valor + ICMS por período
• Inutilizações — notas inutilizadas (com motivo)
• Sintegra — formato exigido pela Receita estadual

Marketing

• CRM — Top Clientes — quem gasta mais
• Loyalty — Saldo de Pontos — passivo contábil
• Campanhas — Performance — open/click/conversão

Custom Report Builder

Para algo que pré-construído não cobre:

1. Relatórios → Builder
2. Selecione dimensões (linhas) — ex.: Categoria, Atendente, Filial
3. Selecione métricas (colunas) — ex.: Receita, Quantidade, Margem
4. Selecione filtros — período, tipo, etc.
5. Visualize tabela ou gráfico
6. Salvar como template se quiser reusar

Exportar

Cada relatório tem botões:

• PDF — formatado para impressão / envio
• XLSX — para análise no Excel
• CSV — para importar em outros sistemas

Tabela formatada em PDF é gerada via pdfmake (mesma engine de NF-e DANFE).

Agendar Envio

Relatórios podem ser enviados automaticamente por email em frequência configurada:

1. Abra um relatório
2. Agendar Envio
3. Frequência: diário / semanal / mensal
4. Destinatários: emails (admin, contador, sócio)
5. Formato: PDF anexo + resumo HTML inline
6. Salvar

Útil para "relatório de vendas todo domingo às 23h para o sócio". Sem ele lembrar de pedir.

Permissões

• reports.view.all — vê todos os relatórios
• reports.financial — vê DRE, lucro líquido (sensível)
• reports.staff_performance — vê performance individual

Branch managers veem só sua filial; admin vê o tenant todo.

Performance

• Relatórios pré-construídos — geralmente < 2s
• Custom com janela > 6 meses — pode levar 30s+
• Janela > 1 ano — sistema sugere usar export assíncrono (gera em background, manda por email)

Histórico

Cada relatório gerado fica em Relatórios → Histórico por 90 dias:

• Relink para download
• Auditoria de quem viu o quê