Visão geral

◆ Dashboard — /admin

Painel de abertura com KPIs + "Painel rápido" (chips com pedidos pendentes, e-mails não lidos, chats abertos) no topo de todas as abas. Métricas úteis (30d): ticket médio, pedidos válidos, cancelamentos, canais (delivery/retirada/salão), tempo médio de preparo (aceito→pronto) e de entrega (saiu→entregue), pico e mais vendidos.

$ Financeiro / Métricas — /admin/financeiro

Receita, formas de pagamento, ticket, série temporal, conciliação de caixa, exportações (CSV/PDF/e-mail/WhatsApp). DRE em camadas (/admin/api/financeiro/dre, §9/§13): receita bruta → (−) cancelamentos/descontos/impostos → receita líquida → (−) CMV → lucro bruto → (−) taxas de adquirente/entrega → margem de contribuição → (−) pessoal/ocupação/operacionais → EBITDA → resultado líquido. Não é mais "receita − despesa".

📈 BI · Inteligência — /admin/bi *(novo)*

_bi_analytics calcula: curva ABC (A até 80% acumulado, B até 95%, C resto; o item que cruza 80% ainda é A); margem/lucro por produto (via CMV); previsão de estoque (consumo = ficha × qtd vendida → dias até acabar); queda de venda (última semana < 60% da média); campeão sem lucro (classe A/B margem <15%); pico por categoria.

🧾 Despesas / Contas a pagar — /admin/financeiro/despesas

CRUD de despesas (criar/pagar/excluir) com categorias, fornecedor, vencimento, recorrência. Tiles: pago no mês/a pagar/vencidas. Modelo Despesa. Alimenta lucro líquido e DRE.

💵 Contas a receber — /admin/contas-receber *(novo)*

Recebíveis por cliente/forma com bruto, taxa%, líquido, data de liquidação, status e baixa (individual/lote). Atraso por vencimento. Modelo Recebivel.

🏦 Conciliação financeira — /admin/conciliacao *(novo)*

Vendido × taxa × líquido × recebido × a receber, por forma/adquirente + editor de taxas/prazos. Automação: "Gerar recebíveis" (_gerar_recebiveis_pedidos) varre pedidos pagos e cria Recebivel aplicando taxa/prazo por forma (config fin_taxas). Ex.: R$100 crédito 3,2% → líquido R$96,80, liquidação +30d.

💳 TEF / Maquininha — /admin/tef *(novo)*

Registra transação da maquininha (valor, forma, parcelas, bandeira, adquirente, NSU, autorização) — modo manual ou negada. Automação: aprovada vira Recebivel conciliável (_tef_para_recebivel); cancelar zera transação + recebível. Modelo TefTransacao. Pronto para agente pinpad/SmartPOS.

Versão para IA/crawler: /manual.md (Markdown cru) · /manual/completo (página única) · /sitemap.xml