# 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="/files/l9NUa1R1p8B5u9dZxQOE" 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="/files/8CnShfeAMiyd1Iaacmnh" 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="/files/QyzWjJ8jmCzRAulDAlPg" 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="/files/Dvbr77Le2jaxiS30qeaR" 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="/files/wNqUMGEtlp8XA8cnhp0w" 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="/files/jvAv1Roi8sc4SVeLhETe" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://traga-ja.gitbook.io/traga-ja/dashboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.