← Anterior: [A janela do sistema](https://iurru.com/manual/Interface) · [Manual](https://iurru.com/manual/) · Próxima: [PDV](https://iurru.com/manual/PDV)

# Início (painel)

**Menu:** Início

A primeira tela depois do login — o retrato do dia (o que já aconteceu hoje,
sem precisar abrir mais nada) seguido, mais abaixo, de uma análise histórica
de vendas sob demanda. A ideia por trás da divisão em dois: os cards do topo
são leves e aparecem sozinhos ao abrir a tela; a análise histórica (gráficos)
é pesada e só busca dado depois de um clique — ver [Análise de
vendas](#análise-de-vendas) — pra não deixar a tela inicial lenta pra abrir
todo santo dia.

Cada bloco só aparece pra quem tem a permissão correspondente — não é
"esconder o valor", o bloco inteiro some da tela (ver tabela abaixo). Sem
permissão de relatórios, aparece um aviso amarelo no topo: "Análise e
gráficos não estão disponíveis — Sua permissão não inclui acesso a
relatórios. Peça a um administrador para ativar 'Relatórios' no cadastro do
seu usuário."

---

## Resumo do dia

Linha de cards no topo, cada um independente dos outros — perder a permissão
de um não tira os demais da tela.

| Card | O que mostra | Permissão |
| --- | --- | --- |
| **Vendas hoje** | Quantidade de vendas concluídas hoje | `pos.open` |
| **Faturamento hoje** | Faturamento líquido das vendas concluídas hoje ([como é calculado](https://iurru.com/manual/Relatorios#como-o-faturamento-é-calculado)) | `pos.open` |
| **Saldo em caixa** | Saldo do caixa aberto agora — fica **vermelho** se negativo | `cash.view` (ou acesso de caixa equivalente) |
| **Alertas de estoque** | Contagem resumida: `N críticos` (vermelho, produto zerado ou abaixo do mínimo crítico), `N atenção` (amarelo) ou `OK` (verde) se nada estiver em alerta | `inventory.view` |

Logo abaixo, mais dois cards maiores, na mesma condição de permissão:

- **Estoque crítico (top 10)** — tabela com os 10 produtos de menor estoque
  em relação ao mínimo cadastrado, colunas *Atual* × *Mínimo*; zerado aparece
  em vermelho e negrito, os demais em amarelo. Só aparece se houver pelo menos
  um alerta (`inventory.view`).
- **Resumo financeiro** — quatro números: **A pagar (vencido)** e **A receber
  (vencido)** (contas já passadas do prazo, `financial_entries` em atraso —
  ver [Financeiro](https://iurru.com/manual/Financeiro)), e **A pagar (7 dias)** / **A receber (7
  dias)** (o que vence nos próximos 7 dias a partir de hoje). Vencido a pagar
  aparece em vermelho quando > 0; vencido a receber em amarelo. Precisa de
  `reports.view` (mesma permissão de [Relatórios](https://iurru.com/manual/Relatorios), não uma
  permissão financeira separada).

---

## Análise de vendas

Bloco de gráficos abaixo do resumo — **não carrega sozinho**. Ao abrir a
tela, essa seção fica vazia até clicar em **Gerar relatório** (canto inferior
direito do card de filtros); só depois disso a busca de dados dispara, com
uma tela de carregamento (engrenagem girando) enquanto não chega. Trocar um
filtro depois de já ter gerado busca de novo automaticamente, sem precisar
clicar em Gerar relatório outra vez — o clique só é necessário na primeira
vez, pra não pesar a abertura da tela.

> **Importante:** considera **apenas vendas concluídas**. Orçamentos, vendas em
> aberto e vendas canceladas ficam de fora — os números aqui são de dinheiro que
> efetivamente entrou.

### Filtros

| Filtro | Opções |
| --- | --- |
| **Período** | De / Até, com atalhos: Últimos 7, 30 e 90 dias, Este mês, Mês anterior, Ano (YTD) |
| **Loja** | Todas as lojas ou uma específica — o botão *Filtrar loja atual* aplica a loja do seletor |
| **Categoria** | Todas ou uma |
| **Marca** | Todas ou uma |
| **Unidade** | Todas ou uma |
| **Produto** | Todos ou um específico |

O botão **Limpar filtros** volta ao padrão (últimos 30 dias, sem os demais
filtros).

### Indicadores

- **Faturamento (período)** — líquido de descontos (do item e da venda) e de
  devoluções, pela [mesma regra dos relatórios](https://iurru.com/manual/Relatorios#como-o-faturamento-é-calculado)
- **Vendas (período)** — quantidade
- **Ticket médio**
- **Quantidade vendida (itens)**

### Gráficos

| Gráfico | Leitura |
| --- | --- |
| **Faturamento por dia** | Curva do período — mostra picos e vales |
| **Faturamento por dia da semana** | Soma agrupada de domingo a sábado — revela o dia forte da loja |
| **Faturamento por mês** | Tendência de longo prazo |
| **Por categoria (tipo)** | Receita por categoria de produto |
| **Mês × categoria (heatmap)** | Top 12 categorias por faturamento; cada célula é o faturamento no mês, com a cor indicando intensidade |

Cada gráfico pode ser **minimizado** ou **expandido** individualmente, sem
afetar os demais. O botão **Exportar Planilha** (canto direito, fundo verde)
gera um CSV com os dados dos gráficos do recorte atual — nome do arquivo
inclui o período (`dashboard-analise-AAAA-MM-DD-AAAA-MM-DD.csv`); fica
desabilitado enquanto não houver dado carregado ou uma nova busca estiver em
andamento.

Quando não há movimento no recorte escolhido, a tela informa "Sem dados no
período com estes filtros" — não é erro, é filtro apertado demais.

---

## Onde ver mais

Para análise por produto, margem e contas, vá em [Relatórios](https://iurru.com/manual/Relatorios). Para
classificação de produtos por participação na receita, veja
[Curva ABC](https://iurru.com/manual/Catalogo-apoio#curva-abc). Para o detalhe de cada conta em atraso
que o card de Resumo financeiro resume, veja [Financeiro → Clientes em
atraso](https://iurru.com/manual/Financeiro#clientes-em-atraso) (a parte de clientes) e
[Financeiro](https://iurru.com/manual/Financeiro) (lançamentos em geral).

---

← Anterior: [A janela do sistema](https://iurru.com/manual/Interface) · [Manual](https://iurru.com/manual/) · Próxima: [PDV](https://iurru.com/manual/PDV)
