> For the complete documentation index, see [llms.txt](https://traga-ja.gitbook.io/traga-ja/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://traga-ja.gitbook.io/traga-ja/dashboard.md).

# Dashboard

## Dashboard — Guia de Uso

### Visão Geral

O **Dashboard** é a tela inicial do painel administrativo. Ele exibe um resumo das estatísticas do negócio no período selecionado e oferece atalhos rápidos para as principais seções do sistema.

***

### Seletor de Período

No topo da seção de estatísticas há controles para filtrar os dados por período:

**Atalhos rápidos:**

| Botão           | Período                        |
| --------------- | ------------------------------ |
| Hoje            | Apenas o dia atual             |
| Últimos 7 dias  | Dia atual + 6 dias anteriores  |
| Últimos 30 dias | Dia atual + 29 dias anteriores |

**Período personalizado:** use os campos de data (início e fim) para definir qualquer intervalo desejado.

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FICbAolQEyBptagviQw5q%2FDashaBoardData.png?alt=media&amp;token=22981d69-1d05-44dc-a047-5253934f07fd" alt=""><figcaption></figcaption></figure>

> Todas as estatísticas e gráficos da página são atualizados automaticamente ao mudar o período.

***

### KPIs — Pedidos & Receita

Dois cards de destaque exibem os principais indicadores do período selecionado:

| KPI                        | Descrição                                                  |
| -------------------------- | ---------------------------------------------------------- |
| Total de Pedidos Entregues | Quantidade de pedidos com status **Finalizado** no período |
| Receita Total              | Soma do valor de todos os pedidos finalizados no período   |

Cada card exibe também um **indicador de crescimento** comparando com o período anterior equivalente:

* Seta verde (↑) — crescimento positivo
* Seta vermelha (↓) — queda em relação ao período anterior

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FGg7qOwgJFXYUGHZgix7H%2FDashPedidos.png?alt=media&amp;token=cb0a40ad-9039-475e-81dc-345e6d326942" alt=""><figcaption></figcaption></figure>

***

### Gráficos

#### Receita ao Longo do Tempo

Gráfico de linha exibindo a evolução da receita dia a dia dentro do período selecionado. Permite identificar tendências, picos de venda e dias de baixo movimento.

#### Distribuição por Status

Gráfico de pizza com a proporção dos pedidos por status no período:

| Status     | Descrição                               |
| ---------- | --------------------------------------- |
| Novos      | Pedidos recebidos mas ainda não aceitos |
| Em Preparo | Pedidos aceitos e sendo preparados      |
| Saindo     | Pedidos saídos para entrega             |
| Concluídos | Pedidos finalizados com sucesso         |
| Recusados  | Pedidos recusados                       |

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2F00b1m7VZbT8Wn55OGPTM%2FDashgrafficos.png?alt=media&amp;token=d4790843-6620-4a92-979e-08c1d9a67ede" alt=""><figcaption></figcaption></figure>

***

### Itens Mais Vendidos

Lista com os **10 itens mais vendidos** no período, ordenados por quantidade. Cada linha exibe:

* Posição no ranking
* Foto do item (quando disponível)
* Nome e categoria
* Preço médio
* Quantidade vendida
* Receita gerada pelo item

> Itens que foram excluídos do cardápio após a venda ainda aparecem no ranking com o badge **"Deletado"**, garantindo que o histórico não seja perdido.

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FlqpYxGPOumkZ1HEF5hTG%2FDashItens.png?alt=media&amp;token=d16f400f-cfdf-4f16-b28a-07fd76d8472f" alt=""><figcaption></figcaption></figure>

***

### Receita por Categoria

Abaixo do ranking de itens, um painel exibe a **receita agrupada por categoria**, com:

* Nome da categoria
* Quantidade de itens distintos vendidos
* Total de unidades vendidas
* Receita total gerada
* Percentual sobre o total — com barra de progresso visual

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FzT9jjDRHPuZ29SfkErHe%2FDashLista.png?alt=media&amp;token=ec22177a-f3b1-48ec-91dc-ef733040cbba" alt=""><figcaption></figcaption></figure>

***

### Atalhos Rápidos

Na parte inferior da página há quatro cards de acesso direto às seções mais utilizadas:

| Atalho                 | Destino                                  |
| ---------------------- | ---------------------------------------- |
| Gerenciar Cardápios    | Página de categorias e itens do cardápio |
| Localidades de Entrega | Configuração de zonas e taxas de entrega |
| Cupons de Desconto     | Criação e gestão de cupons promocionais  |
| Sistema de Fidelidade  | Configuração de fidelidade e cashback    |

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2Fe20TTrbPwcDy6kemMPuT%2FDashaFinalllllllllllllllllllllllllllll.png?alt=media&amp;token=5ec12bc7-1d17-4a94-aa39-3a801429165e" alt=""><figcaption></figcaption></figure>