Selos usados:
GA-candidato·Preview·NÃO MEDIDO·Roadmap. Legenda e template (selo + 9 campos) em README.
Depois do dashboard pronto, você o exporta (XLSX, CSV, PNG, PDF, PowerPoint, impressão) e o distribui (link público, Link de TV, embed, assinatura por e-mail/WhatsApp, alertas). Toda saída respeita RLS + máscara de PII e carimbo de confidencialidade. Exemplos usam o workspace sintético Comércio Aurora Ltda.
Guias passo a passo
Esta página é a referência técnica. Para o caminho na tela, veja Ações do cabeçalho do painel, Ler um painel, Link de TV e Assinaturas e alertas.
Exportar XLSX (Excel)#
Selo: GA-candidato
- O que é — exportação do dashboard para Excel, nos modos RESUMO e DETALHE.
- Quando usar — mandar os números para quem trabalha no Excel. Na tela: botão Excel no cabeçalho (resumo) ou Mais ações ▸ Exportar Excel: Resumo (como na tela) / Dados subjacentes (detalhe).
- Como funciona — lê o snapshot com RLS + PII aplicadas; selo de amostra quando truncado; carimbo de confidencialidade em 3 lugares; auditado.
- Pré-requisitos — snapshot disponível; permissão de exportar.
- Como validar — exporte no modo DETALHE; abra o arquivo e confirme os dados, o selo de amostra (se truncado) e o carimbo de confidencialidade.
- Limites e ressalvas — respeita o teto do snapshot; PII mascarada conforme o solicitante.
- Dados de exemplo (sintéticos) — planilha "Receita por UF": SP=250, RJ=90, MG=140.
- Evidência — exportação XLSX (modos resumo/detalhe, selo de amostra, carimbo de confidencialidade) coberta por suíte determinística e contrato de exportação.
- Estado & maturidade — GA-candidato.
Exportar CSV (por visual)#
Selo: GA-candidato
- O que é — CSV de um visual, no dialeto Excel pt-BR.
- Quando usar — levar a série de um gráfico para outra ferramenta. Na tela: botão direito no gráfico ▸ Exportar CSV deste visual.
- Como funciona — no navegador; separador
;, quebra CRLF, decimal com vírgula. - Pré-requisitos — visual com dados.
- Como validar — exporte o CSV de "Receita por categoria" e abra no Excel pt-BR sem quebrar colunas.
- Limites e ressalvas — é por visual (não o painel inteiro). Para só olhar as linhas, sem baixar, use Ver registros (linhas por trás) no mesmo menu (até 200 linhas).
- Dados de exemplo (sintéticos) —
categoria;receita/Bebidas;250. - Evidência — geração de CSV no dialeto Excel pt-BR (separador
;, CRLF, decimal com vírgula) coberta por suíte determinística. - Estado & maturidade — GA-candidato.
Exportar PNG (por visual e da página)#
Selo: GA-candidato · rasterização NÃO MEDIDO
- O que é — imagem PNG de um visual ou da página inteira.
- Quando usar — colar um gráfico numa apresentação ou e-mail. Na tela: botão direito no gráfico ▸ Salvar como imagem; no link público, o botão Salvar como imagem acima do painel salva a página inteira.
- Como funciona — no navegador; o gráfico é desenhado numa imagem em resolução dobrada.
- Pré-requisitos — visual renderizado.
- Como validar — exporte o PNG de um visual e confira a imagem gerada.
- Limites e ressalvas — a rasterização não é testável em CI (o teste
cobre só o nome do arquivo) → o resultado de imagem é
NÃO MEDIDO. - Dados de exemplo (sintéticos) — PNG de "Receita por UF".
- Evidência — o fluxo de exportação PNG é coberto por suíte determinística (nome/estrutura); a rasterização em si não é testável em CI.
- Estado & maturidade — GA-candidato (fluxo); imagem final
NÃO MEDIDO.
Exportar PDF (dashboard sob demanda e relatório agendado)#
Selo: Preview
- O que é — PDF do dashboard sob demanda e PDF do relatório agendado.
- Quando usar — enviar um retrato fiel do painel para quem não acessa a plataforma. Na tela: botão PDF no cabeçalho, ou Mais ações ▸ Exportar PDF: PDF. Quando o PDF não sai, um balão explica o motivo e aponta Prévia de impressão ▸ Imprimir / PDF como alternativa.
- Como funciona — um worker de renderização na nuvem imprime a página; para o dashboard sob demanda, a credencial é um token de embed efêmero (5 min, escopo de 1 painel, com a RLS da sessão), então o worker imprime exatamente o recorte do solicitante (PII mascarada, painel despublicado recusado); auditado; download anti-IDOR.
- Pré-requisitos — datalake e worker de relatórios configurados e o plano com PDF liberado (Business+). Sem isso, não gera.
- Como validar — com o worker de renderização configurado, gere o PDF do dashboard e confirme o mesmo recorte da tela + carimbo de confidencialidade.
- Limites e ressalvas — depende de infraestrutura paga; a geração real e a
latência de impressão são
NÃO MEDIDO. - Dados de exemplo (sintéticos) — PDF de "Aurora Varejo — Julho/2026".
- Evidência — a lógica de recorte (token de embed efêmero, RLS da sessão, PII mascarada, anti-IDOR) é coberta por suíte determinística; a geração real depende do worker de impressão em nuvem.
- Estado & maturidade — Preview; depende do worker de renderização; geração
NÃO MEDIDO.
Exportar PowerPoint (PPTX)#
Selo: GA-candidato · aparência final NÃO MEDIDO
- O que é — exporta o painel para PowerPoint: uma página do painel = um slide (16:9).
- Quando usar — montar a apresentação executiva a partir do dashboard. Na tela: botão PPT no cabeçalho ou Mais ações ▸ PowerPoint: Apresentação (.pptx).
- Como funciona — clone do padrão do XLSX (sessão / anti-IDOR / visão segura / auditoria); dado → forma nativa quando possível (KPI = caixa de número; bar/line/pie = charts nativos; tabela/matriz/mapas/exóticos = tabela com cap + selo AMOSTRA); grade proporcional; cores do tema; carimbo de confidencialidade em 3 lugares. Determinístico: mesmo input + mesmo relógio → bytes idênticos.
- Pré-requisitos — snapshot disponível; permissão de exportar.
- Como validar — exporte o PPTX de um painel de 2 páginas e confirme 2 slides
- slide-título com a data do snapshot.
- Limites e ressalvas — o teste valida o XML interno (mini-parser de ZIP),
não a aparência aberta no Office → render visual é
NÃO MEDIDO. - Dados de exemplo (sintéticos) — slide "Receita por UF" (SP/RJ/MG).
- Evidência — geração determinística do PPTX (bytes idênticos para o mesmo input) coberta por suíte que valida o XML interno; a aparência aberta no Office não é testada.
- Estado & maturidade — GA-candidato; fecha a lacuna "sem PowerPoint" da
auditoria inicial; aparência no Office
NÃO MEDIDO.
Impressão#
Selo: GA-candidato
- O que é — a Prévia de impressão: a folha do painel do jeito que sai no papel, com cabeçalho e rodapé.
- Quando usar — cópia rápida em papel ou PDF pelo navegador, inclusive quando o plano não tem o PDF sob demanda.
- Como funciona — botão Prévia de impressão no cabeçalho (ou em Mais ações, em tela estreita). Na prévia, Imprimir: escolhe Todas, Só a página aberta ou páginas soltas; Imprimir / PDF abre a impressão do navegador; Fechar (Esc) volta. Quem edita ajusta Cabeçalho e rodapé. No link público, o botão é Imprimir.
- Pré-requisitos — nenhum.
- Como validar — abra a prévia de um painel de 3 páginas, marque só 2 e confira que a impressão sai com 2 folhas no tamanho configurado.
- Limites e ressalvas — o resultado final depende do navegador.
- Dados de exemplo (sintéticos) — impressão da página "Resumo".
- Evidência — impressão pelo navegador com estilos próprios de impressão.
- Estado & maturidade — GA-candidato.
Links públicos e embed#
Selo: Preview
- O que é — link público não-adivinhável (
/d/[slug]), publicação web aberta (/painel/[slug]) e embed por token HMAC em portais de terceiros. - Quando usar — compartilhar um painel fora da plataforma sem dar login.
- Como funciona — links leem o snapshot com PII sempre mascarada e
sem custo para o visitante; a web aberta exige digitar o nome + avisos e é
auditada; o embed usa token HMAC-SHA256 (TTL 15 min, teto 12h), timing-safe,
com checagem de Origin/Referer e CSP
frame-ancestorspor allowlist. - Pré-requisitos — publicar o painel; para embed, a origem na allowlist. Na tela: Mais ações ▸ compartilhar (cartões 1 · Link secreto, 2 · Embed na sua aplicação, 3 · Publicar na web (indexável)).
- Como validar — gere o link
/d/<slug>, abra anônimo e confirme os dados com PII mascarada; embuta em um portal da allowlist e confirme o carregamento. - Limites e ressalvas — links públicos são permanentes por design (sem
senha e sem expiração) — cortar o acesso é gerar novo link; a allowlist
de embed é global da plataforma, não por workspace. Por isso
Preview. - Dados de exemplo (sintéticos) —
/d/aurora-vendas-julhomostrando SP/RJ/MG. - Evidência — links públicos, publicação web aberta e embed por token HMAC
(TTL, timing-safe, checagem de Origin/Referer, CSP
frame-ancestors) cobertos por suíte determinística. - Estado & maturidade — Preview; falta senha/expiração opcional e allowlist por workspace.
Link de TV (modo TV/kiosk)#
Selo: Preview
- O que é — o link secreto com
?tv=1: o painel em tela cheia, sem menus, com a folha escalada para caber na tela 16:9 inteira, páginas que giram e dados que se atualizam sozinhos. - Quando usar — TV ou monitor de parede na loja, na fábrica, no comercial.
- Como funciona — copiado em Compartilhar ▸ Link de TV ▸ copiar
link de TV. O dono configura no editor (faixa Página ▸ TV ▾): páginas
que giram, Segundos em cada página (10–600, padrão 30), Atualizar os
dados a cada (min) (mínimo 1) e Mostrar relógio e data no canto; e pode
arrumar um layout próprio de TV. Páginas de dica e de detalhamento ficam fora
da rotação por padrão. O link aceita
tvIntervalo,tvRefreshetvRelogio=0|1, que passam na frente da configuração, e compõe com?f=. Se o navegador recusar a tela cheia automática, aparece ⛶ Tela cheia. - Pré-requisitos — painel publicado (o Link de TV é o link secreto).
- Como validar — abra
/d/<slug>?tv=1numa janela 1920×1080 e noutra 1366×768: o mesmo desenho ocupa as duas telas sem rolagem; a página troca no intervalo configurado. - Limites e ressalvas — mesmas do link secreto (sem senha nem validade); não vale dentro do sistema nem no embed.
- Dados de exemplo (sintéticos) — "Vendas do dia — Loja Centro" girando 3 páginas a cada 45 s com relógio.
- Evidência — rotação, limites de intervalo, escolha de páginas e escala da folha cobertos por suíte determinística; tela cheia e cursor dependem do navegador.
- Estado & maturidade — Preview.
Assinaturas por e-mail#
Selo: Preview
- O que é — o dono agenda (dia da semana + hora) o envio do painel por e-mail, com KPIs + link + XLSX anexo; o leitor também pode se inscrever.
- Quando usar — mandar o resumo semanal para a diretoria automaticamente.
- Como funciona — no editor, Ferramentas ▸ Publicação ▸ Enviar automaticamente (assinatura) ▸ Salvar assinatura; o disparo é verificado a cada 5 minutos; RLS por destinatário soma com o Filtro por destinatário (nunca amplia); o link é suprimido quando há filtro de linha; Mais ações ▸ Inativar pausa; registro de entrega (delivery ledger). Com envios agendados, o leitor vê Receber por e-mail no cabeçalho e entra ou sai da lista sozinho (Inscrito ✓ (cancelar)).
- Pré-requisitos — o envio de e-mail da plataforma configurado, com domínio verificado; sem isso, o envio não acontece e o registro fica como falha.
- Como validar — agende uma assinatura para
ana@example.com, espere o horário e confirme o e-mail com KPIs + anexo. - Limites e ressalvas — entrega real é
NÃO MEDIDO. - Dados de exemplo (sintéticos) — assinatura "Resumo semanal" às segundas 8h
para
maria@example.com. - Evidência — agendamento, RLS por destinatário, supressão de link sob filtro, inscrição do leitor e registro de entrega cobertos por suíte determinística; a entrega real depende de domínio de e-mail verificado.
- Estado & maturidade — Preview; entrega
NÃO MEDIDO.
Assinaturas e alertas por WhatsApp#
Selo: Preview
- O que é — envio de painel/alerta por WhatsApp pelo canal oficial do WhatsApp. Na tela: o campo de WhatsApp da assinatura, o Canal do alerta, ou Enviar por WhatsApp no menu do painel em BI → Workspace.
- Quando usar — avisar no WhatsApp quando um KPI vira, ou mandar o resumo.
- Como funciona — canal oficial (número + WABA do produto, dentro dos Termos), com template aprovado para abrir a janela de 24h e consentimento do destinatário.
- Pré-requisitos — canal de WhatsApp configurado na plataforma, template aprovado e consentimento do destinatário.
- Como validar — com as envs e o template aprovados, dispare um alerta e confirme a mensagem no número consentido.
- Limites e ressalvas — depende de credencial e de template aprovado;
entrega real é
NÃO MEDIDO. Não afirmamos GA deste canal (teto Preview), apesar de ser o caminho oficial. - Dados de exemplo (sintéticos) — alerta "Receita do dia abaixo da meta" enviado a um número de teste consentido.
- Evidência — canal oficial (Cloud API), consentimento do destinatário e roteamento de envio cobertos por suíte determinística; a entrega real depende de credencial + template aprovado.
- Estado & maturidade — Preview; entrega
NÃO MEDIDO.
Relatórios agendados "Analista de IA"#
Selo: Preview
- O que é — relatório periódico com narrativa de IA (headline, resumo
executivo, destaques, anomalias, recomendações) e página pública
/r/[slug]. - Quando usar — um "analista" que manda a leitura dos números no horário.
- Como funciona — cron tz-aware; as queries são congeladas na criação
(≤500 linhas/query); a narrativa é gerada por IA e gravada; idempotente por
@@unique([reportId, scheduledFor]); entrega por e-mail/WhatsApp; PDF opcional. - Pré-requisitos — plano com IA e canais configurados. Na tela: IA → Relatórios ▸ Novo relatório — ver Telas de Relatórios.
- Como validar — crie um relatório semanal, dispare o cron e confirme a página
/r/<slug>com a narrativa e o envio. - Limites e ressalvas — narrativa depende de chave de IA; linhas do
snapshot viajam ao provedor de LLM (ver as ressalvas de IA da plataforma);
entrega
NÃO MEDIDO. - Dados de exemplo (sintéticos) — relatório "Vendas semanais Aurora" com headline sobre SP liderando.
- Evidência — execução do relatório (queries congeladas na criação, idempotência por agendamento) e renderização cobertas por suíte determinística.
- Estado & maturidade — Preview.
Alertas (limiar, anomalia, histórico, webhook)#
Selo: Preview
- O que é — alertas por visual (limiar) e por relatório (anomalia %), com histórico, backtest e webhook de saída assinado.
- Quando usar — avisar quando um KPI cruza um limite ou o número foge do padrão. Na tela: no editor, com o gráfico selecionado, faixa Formatar ▸ Alerta (Avisar quando, Medida, Resumir por, Canal, Destinatário); para relatórios, Alertas inteligentes no assistente de Novo relatório.
- Como funciona — limiar absoluto (
>,>=,<,<=) avaliado no refresh; dispara só na transição para violado (rearma ao normalizar); anomaliabelow/above/drop_pct/spike_pctvs baseline com cooloff; canais e-mail / WhatsApp / webhook (POST no sistema do cliente, HMAC-SHA256 comX-Ingestia-Signature, retry). Histórico de disparos e backtest da regra. - Pré-requisitos — plano Business+ para alertas; canal configurado (para webhook, uma URL https do cliente).
- Como validar — configure "Receita do dia < 1.000 → webhook", force a violação e confirme o POST assinado + o registro no histórico.
- Limites e ressalvas — a avaliação é no refresh do painel (não há cron
dedicado de alerta); entrega real é
NÃO MEDIDO. Alerta ligado a meta não existe: a tela de Metas foi removida do produto em 26/09/2026 — o alvo vira uma medida sobre a sua tabela de metas, e o alerta é por visual. - Dados de exemplo (sintéticos) — limiar "Receita < 1.000" com realizado 900.
- Evidência — avaliação de limiar/anomalia, disparo por transição, histórico, backtest e webhook assinado (HMAC) cobertos por suíte determinística.
- Estado & maturidade — Preview; entrega
NÃO MEDIDO.
Última revisão: 2026-10-03.
Estado & evidência: formatos de export (XLSX/CSV/PNG/PPTX) cobertos por
testes de contrato/estrutura; rasterização PNG, aparência PPTX, geração PDF e
toda entrega externa (e-mail/WhatsApp/webhook) são NÃO MEDIDO (dependem de
nuvem/credencial). Toda saída aplica RLS + PII + confidencialidade. Estados
derivados da matriz de estados do produto (teto Preview). Nenhum recurso é GA
de produto.