---
type: dashboard
app: "apps/vendas.md"
publico: executivo
pergunta: "Como está a receita da Vale Sul este mês, e onde está o problema (loja/vendedor/produto)?"
decisoes_que_suporta: ["remanejar meta comercial entre lojas", "priorizar visita comercial a cliente/vendedor fraco", "negociar reposição com fornecedor de produto em queda"]
bi_desk_destino: "Comercial — decisão do analista Camila Duarte"
---

# Fichas de widget (5 de 9 permitidos)

Wireframe: [wireframes/vendas-executivo.html](../wireframes/vendas-executivo.html)

Público executivo: `mensagem` é obrigatório em toda ficha. A tendência diária de
Receita Líquida (antiga ficha 4) acompanhava um único KPI (ficha 2) — convertida
para `tendencia-inline` dentro do próprio card, reduzindo a tela de 6 para 5
widgets sem perder informação (wireframe-kit.md, skill lumo-mockup).

```yaml
- widget: 1
  titulo: "Filtros — período e loja"
  mensagem: "Isola o resultado por loja e período para localizar onde nasce o problema do mês"
  relacao: lookup
  confianca: confirmado   # controle estrutural, sem ambiguidade de negócio
  metricas: []
  dimensoes: ["dim_calendario.mes", "dim_loja.nome"]
  filtros: []
  interacoes: "cross-filtra os widgets 2-5"
  encoding: { datalabels: nao, legenda: nao, formato: "n/a" }
  posicao: { y: 0, x: 0, w: 4, h: 3 }
  custom: false

- widget: 2
  titulo: "Receita Líquida — mês corrente"
  mensagem: "Receita cresce no mês, mas o ritmo diário desacelera nas últimas semanas"
  relacao: tendencia-inline
  confianca: confirmado   # herda o confianca: confirmado de metricas/receita-liquida.md
  metricas: ["/metricas/receita-liquida.md"]
  dimensoes: ["dim_calendario.dia"]
  filtros: ["responde ao widget 1"]
  interacoes: "nenhuma — KPI + sparkline (≤80px) dentro do card, variação ▲/▼ vs mês anterior"
  encoding: { datalabels: sim, legenda: nao, formato: "R$ mil" }
  posicao: { y: 0, x: 4, w: 4, h: 3 }
  custom: false

- widget: 3
  titulo: "Ticket Médio — mês corrente"
  mensagem: "Ticket médio cai mesmo com receita em alta — mais pedidos menores, não vendas mais fortes"
  relacao: metrica-unica
  confianca: confirmado   # herda o confianca: confirmado de metricas/ticket-medio.md
  metricas: ["/metricas/ticket-medio.md"]
  dimensoes: []
  filtros: ["responde ao widget 1"]
  interacoes: "nenhuma — KPI puro"
  encoding: { datalabels: sim, legenda: nao, formato: "R$" }
  posicao: { y: 0, x: 8, w: 4, h: 3 }
  custom: false

- widget: 4
  titulo: "Ranking de Receita Líquida por Vendedor — mês corrente"
  mensagem: "Poucos vendedores concentram a maior parte da receita — risco de dependência"
  relacao: ranking
  confianca: hipótese   # top-N/critério de corte do ranking ainda não fechado com Marcos
  metricas: ["/metricas/receita-liquida.md"]
  dimensoes: ["dim_vendedor.nome"]
  filtros: ["responde ao widget 1"]
  interacoes: "clique no vendedor filtra widget 5 (drill até vendedor fica FORA — ver fora-de-escopo.md; este clique só recorta, não abre novo nível)"
  encoding: { datalabels: sim, legenda: nao, formato: "R$ mil" }
  posicao: { y: 3, x: 0, w: 12, h: 6 }
  custom: false

- widget: 5
  titulo: "Receita Líquida por Loja — mês corrente"
  mensagem: "Receita cresce mas concentrada na loja matriz"
  relacao: parte-todo
  confianca: confirmado   # layout reconduzido para barra empilhada e aprovado por Marcos (log.md v1.0)
  metricas: ["/metricas/receita-liquida.md"]
  dimensoes: ["dim_loja.nome"]
  filtros: ["responde ao widget 1"]
  interacoes: >
    responde ao filtro do widget 1; pedido original do analista era donut,
    mas Vale Sul tem 5 lojas — estourou o limite de 4 fatias do kit
    (wireframe-kit.md, skill lumo-mockup, "regra de integridade"). Reconduzido
    para barra empilhada antes de seguir pra aprovação do cliente.
  encoding: { datalabels: sim, legenda: sim, formato: "R$ mil" }
  posicao: { y: 9, x: 0, w: 12, h: 6 }
  custom: false
```

# Notas de layout

KPI-row (widgets 1-3) no topo com o cross-filter — Receita Líquida já traz a
tendência diária embutida como sparkline, sem gráfico separado. Ranking por
vendedor no meio em largura total (4), parte-todo por loja embaixo (5) —
layout padrão de público executivo (3-6 KPIs + 2-4 gráficos, subdivisão em 3
colunas).
