Relatórios

Todos os endpoints requerem autenticação admin.

Dashboard

GET /api/admin/dashboard

Retorna métricas do dia atual:

• Total de pedidos

• Faturamento total

• Pedidos por status

• Ticket médio

Query params:

Param	Tipo	Descrição
date	string	Data YYYY-MM-DD (padrão: hoje)

---

Top Produtos

GET /api/admin/reports/top-products

Retorna os produtos mais vendidos no período.

Query params:

Param	Tipo	Descrição
start_date	string	Data inicial YYYY-MM-DD
end_date	string	Data final YYYY-MM-DD
limit	int	Quantidade de resultados (padrão: 10)

Resposta:

[
  {
    "product_id": 5,
    "product_name": "X-Burguer",
    "total_sold": 142,
    "revenue": 3677.80
  }
]

---

Top Clientes

GET /api/admin/reports/topCustomers

Retorna os clientes com maior volume de pedidos.

Query params:

Param	Tipo	Descrição
start_date	string	Data inicial
end_date	string	Data final
limit	int	Quantidade (padrão: 10)

---

Totais de Pedidos

GET /api/admin/ordersTotals

Retorna totais agrupados por forma de pagamento.

---

Relatório do Caixa

GET /api/admin/cashRegisters/{id}/report

Ver detalhes em caixa.md.

---

Faturamento (Billing)

GET /api/admin/billings

Listagem das faturas da plataforma para o restaurante (histórico de cobranças do plano).