Dashboard e relatórios da campanha

São duas telas por campanha. O Dashboard é a tela inicial do painel: totais, série diária, recortes e mapa de calor geográfico de uma campanha. Relatórios é a tela onde o operador vê e baixa os dados da campanha num lugar só, em abas, com download em CSV.

Nos dois casos a campanha é um seletor da tela. O Dashboard abre na campanha ativa que começou por último.

O dashboard é dinâmico

Cada bloco só aparece quando a campanha usa aquilo. Um bloco ausente quer dizer "não se aplica", e o painel o esconde — nunca um zero travado como no sistema antigo. Quem decide é o servidor; o painel obedece e reorganiza a grade.

Alguns exemplos do que condiciona cada bloco: os valores e o ticket médio só vêm quando alguma regra ativa da campanha é por valor; os produtos só quando alguma regra é por quantidade ou produto; o total de números da sorte só na modalidade Sorteio; as posições e a apuração só na modalidade Posição premiada; a faixa etária só quando o formulário pede data de nascimento e alguém informou; os estados só quando o formulário pede estado e alguém informou.

A série diária cobre o período até hoje, no fuso do negócio, com dias sem movimento em zero. Acima de noventa e dois dias ela vira semanal, e o próprio bloco informa a granularidade aplicada.

Os filtros do dashboard

Sem nenhum filtro, é a campanha inteira. Os filtros disponíveis são período, rede, loja, estado, canal de entrada da nota, município e produto.

Cada filtro aceita várias opções: dentro do mesmo filtro valem como "ou", entre filtros diferentes como "e".

Rede, loja, estado e município são do local da compra, não do cadastro. Com qualquer um deles aplicado, duas coisas mudam: a contagem de cadastros passa a ser "quem comprou ali no período" (a inscrição não tem local), e a conversão some, porque seria sempre cem por cento. O painel troca o rótulo Cadastros por Participantes nesse caso.

A lista de opções dos filtros traz só o que tem nota na campanha. Lista vazia faz o painel esconder aquele filtro. O calendário dos filtros de data segue o idioma escolhido no painel.

Alertas, projeção e comparação

Os alertas aparecem quando há algo a dizer, e ficam vazios quando se escolhe um período, quando a campanha está fora do andamento ou quando não há nada a apontar.

A projeção só aparece em campanha em andamento, sem período escolhido e com histórico suficiente. A comparação com o período anterior só aparece quando se escolhe um período, e some quando o período anterior cai todo antes da campanha.

O mapa de calor geográfico

O mapa tem duas visões: onde as pessoas moram (pelo cadastro) e onde elas compram (pela loja, e na falta dela pela nota). Ele usa os mesmos filtros do dashboard, e há uma contagem de quem ficou fora do mapa por não ter localização.

O dashboard personalizado

Cada usuário pode salvar o próprio arranjo de gráficos — quais e onde. Os números continuam vindo do dashboard da campanha. Não exige permissão de recurso, porque é a tela do próprio usuário.

É um arranjo por usuário e ele vale para todas as campanhas: gráfico que a campanha não usa simplesmente desaparece da tela. Há a ação de restaurar o padrão. Em tela estreita os gráficos empilham e a edição do arranjo fica para o computador.

Relatórios: as abas

A tela tem uma aba por relatório, na ordem em que o operador conta a campanha: Participantes, Notas fiscais, Números da sorte, Posições premiadas, Apuração e Apuração SPA. A última aba, Resultado da campanha, não é um relatório: é leitura de tela, sem arquivo.

O que cada relatório traz, em uma linha:

• Participantes: uma inscrição na campanha.
• Notas fiscais: uma nota ativa enviada.
• Números da sorte: um número válido.
• Posições premiadas: uma posição distribuída.
• Apuração: uma posição apurada.

Cada relatório declara esse grão em uma frase visível na tela: é o que evita somar a coluna errada.

Relatório que não se aplica à campanha aparece com o aviso "Este relatório não se aplica à campanha" — por exemplo, a Apuração SPA exige Sorteio ou Posição premiada. Ganhadores não tem aba: a exportação dele continua em Gerenciar e Ganhadores.

Relatórios: filtros, prévia e download

As cinco primeiras abas funcionam como Gerenciar e Participantes: barra de filtros acima da tabela, "Limpar filtros", paginação e o botão Baixar CSV, que baixa o recorte filtrado inteiro, não só a página exibida. O filtro de loja tem busca, porque uma campanha de rede pode ter centenas de lojas. Ao trocar um filtro, a tela volta para a página 1.

A prévia traz páginas de cinquenta linhas e o total do recorte. As células chegam já formatadas, idênticas às do CSV — a mesma data no mesmo fuso, o mesmo dinheiro, o mesmo rótulo de situação. É isso que faz "o que eu vejo é o que eu baixo" ser verdade. Célula vazia aparece como traço.

As colunas e a ordem são as padrão de cada relatório: a tela não oferece escolha de colunas nem ordenação por coluna. A ordem é sempre do mais recente para o mais antigo.

A aba Apuração tem uma particularidade: o arquivo dela é o mesmo de Gerenciar e Posições, com layout fixo. A tabela mostra só algumas colunas desse arquivo, e ela inclui a posição de participação cancelada, que a aba Posições premiadas não mostra.

Apuração SPA

É o arquivo no layout fixo que a SPA exige: sem filtro, sem escolha de colunas e sem teto de linhas. O operador escolhe a apuração (pela data de sorteio cadastrada no prêmio) e as modalidades, e usa "Conferir antes de baixar". A conferência mostra quantas linhas e participantes saem, o tamanho estimado, as inconsistências e uma prévia das primeiras linhas.

O botão de baixar só aparece depois da conferência. As inconsistências não bloqueiam o download, porque a lista enviada à SPA precisa ser completa. Acima de 250 MB o arquivo sai partido num ZIP. Trocar a apuração ou as modalidades limpa a conferência.

Se a campanha não tem nenhum prêmio com data de sorteio, a tela avisa que é preciso cadastrar a data do sorteio no prêmio.

Resultado da campanha

A aba Resultado da campanha compara os indicadores da campanha — inscritos, notas fiscais, valor comprado, ticket médio, notas por inscrito e participantes com nota — com a campanha anterior, que a tela cita pelo nome e pela data. A campanha anterior é a campanha ativa que começou por último antes desta.

Ela também mostra quem se inscreveu: novos são os inscritos sem inscrição em campanha anterior do cliente; voltaram são o resto, e os dois somam os inscritos. A série "Novos e recorrentes em cada campanha" traz todas as campanhas ativas do cliente, com a campanha aberta destacada.

Na primeira campanha do cliente não há com o que comparar, e a aba não mostra os indicadores — ela avisa isso em uma linha. Variação de um valor que antes era zero aparece como "novo", não como porcentagem.

Meus relatórios

Cada aba comum tem o botão "Salvar filtros", que grava a aba e os filtros aplicados com um nome. Os salvos aparecem no card Meus relatórios, acima das abas: clicar no nome abre a aba com os filtros preenchidos.

O salvo é só de quem salvou e vale só na campanha em que foi criado. O nome é obrigatório e não pode repetir para o mesmo usuário na mesma campanha. A única edição aceita é Renomear; para outro recorte, filtre e salve de novo. Apagar tira só o recorte salvo — o relatório e os dados continuam na aba. Salvo sem filtro é aceito, e quer dizer o relatório inteiro. "Limpar filtros" volta para o relatório inteiro, não para o recorte salvo.

A Apuração SPA não tem "Salvar filtros", porque não tem filtro.

O que fica de fora de cada relatório

Essa é a pergunta que o operador faz quando o número da tela não bate com o do dashboard: participação cancelada e nota cancelada não entram em nenhum relatório pronto, e chance invalidada também não. A Apuração é a exceção: ela mostra a posição de participação cancelada, porque o arquivo dela é o de hoje e tirar linha seria mudá-lo.

Os dois tetos do download

O download vai direto para o navegador, o que deixa baixar arquivos grandes sem travar a aba. Por isso a prévia informa o total, o limite e se o recorte passa do teto, e a tela desabilita o botão de baixar acima do teto, mostrando o aviso que o servidor mandou.

O segundo teto é de downloads simultâneos por cliente: quem passa dele recebe a mensagem de que já há relatórios sendo gerados e deve tentar de novo em instantes.

Permissões

O Dashboard exige ler campanhas — ele traz só contagens, sem dado de participante.

O item Relatórios do menu só aparece para quem tem a permissão global Exportar dados. Cada relatório exige essa global mais a permissão de ler o recurso de onde o dado sai: participações em Participantes, posições premiadas em Posições premiadas e na Apuração, notas em Notas fiscais, números em Números da sorte. A global não basta sozinha. Meus relatórios exige só a global, porque um salvo é apenas um nome e uma lista de filtros. A aba Resultado da campanha segue a permissão de ler campanhas, porque só traz contagens.

Atenção: os relatórios saem sem mascaramento. O CPF sai completo. Essa é a diferença entre os relatórios e as exportações de Gerenciar, que mascaram para quem não tem a permissão Vê dados sensíveis. O controle aqui é a própria permissão global Exportar dados, que poucas pessoas têm.

Não existe tela de consulta de números da sorte

Os números aparecem no relatório Números da sorte e dentro do detalhe do participante. Não há módulo próprio de consulta de números por campanha no painel.

Seis orientações que resolvem quase toda dúvida nessas duas telas:

Bloco que não aparece no dashboard não é erro: aquele recorte não se aplica à campanha. Valores só aparecem se alguma regra é por valor, faixa etária só se o formulário pede data de nascimento e alguém informou, e assim por diante.

Ao filtrar por rede, loja, estado ou município, o dashboard passa a falar de local de compra. A contagem de cadastros muda de sentido e a conversão desaparece — a tela troca o rótulo para avisar.

Cada relatório diz o que é uma linha dele. Vale ler essa frase antes de somar colunas: no relatório de Participantes uma linha é uma inscrição, no de Posições premiadas é uma posição distribuída.

Nota cancelada, participação cancelada e chance invalidada não entram nos relatórios prontos. É o motivo mais comum de o número do relatório ser menor que o da tela de Gerenciar.

A permissão de baixar relatório é a global Exportar dados, e ela precisa vir acompanhada da permissão de ler aquele recurso. É deliberado que poucas pessoas tenham: o relatório sai com CPF completo, sem máscara.

Para comparar a campanha com a anterior e ver quantos inscritos são novos, use a aba Resultado da campanha. Para guardar um recorte que se usa sempre, use "Salvar filtros".

• Falha: um bloco esperado não aparece no dashboard.
• Possivel causa: o dashboard é dinâmico e o bloco só vem quando a campanha usa aquilo. Valores dependem de regra por valor, produtos de regra por quantidade ou produto, e perfil de campo preenchido no formulário.
• Como orientar: confira as regras da modalidade e o formulário da campanha. Bloco ausente quer dizer que não se aplica.
• Quando escalar: se a campanha usar aquele recurso e o bloco continuar ausente, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a conversão desapareceu do dashboard depois de aplicar um filtro.
• Possivel causa: com filtro de local, a conversão some de propósito, porque seria sempre cem por cento. A inscrição não tem local.
• Como orientar: explique a mudança de sentido. Com filtro de local, a contagem passa a ser de quem comprou ali, e o painel troca o rótulo Cadastros por Participantes.
• Quando escalar: não é falha.

• Falha: o número do relatório não bate com o da tela de Gerenciar.
• Possivel causa: participação cancelada, nota cancelada e chance invalidada não entram nos relatórios prontos. A Apuração é a exceção.
• Como orientar: confira se há cancelamentos no recorte. Em Gerenciar, use o filtro de incluir inativas para comparar.
• Quando escalar: se não houver cancelamento no recorte e os números continuarem diferentes, abrir issue no Jira (projeto DEV) com as evidências e os dois números.

• Falha: o cliente quer escolher as colunas ou a ordem do CSV.
• Possivel causa: a tela usa as colunas e a ordem padrão de cada relatório e não oferece essa escolha.
• Como orientar: explique que o arquivo sai com as colunas padrão do relatório e, se precisar, o cliente reorganiza na planilha depois de baixar.
• Quando escalar: não é falha. Se for um pedido recorrente, registrar como sugestão de melhoria no Jira (projeto DEV).

• Falha: o botão de baixar o relatório está desabilitado.
• Possivel causa: o recorte passou do teto de linhas do download. A prévia informa o total, o limite e o aviso.
• Como orientar: leia o aviso exibido e filtre o recorte por período ou por outro filtro disponível até ficar abaixo do teto.
• Quando escalar: se o recorte estiver abaixo do teto e o botão continuar desabilitado, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o download responde que já há relatórios sendo gerados.
• Possivel causa: existe limite de downloads simultâneos por cliente e ele foi atingido.
• Como orientar: aguarde os downloads em andamento terminarem e tente de novo em instantes.
• Quando escalar: se não houver nenhum download em andamento e a recusa persistir, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a Apuração SPA não oferece nenhuma apuração para escolher.
• Possivel causa: a campanha não tem prêmio com data de sorteio cadastrada, ou não usa Sorteio nem Posição premiada.
• Como orientar: cadastre a data do sorteio no prêmio da campanha e volte à aba.
• Quando escalar: se houver prêmio com data de sorteio e a lista continuar vazia, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a aba Resultado da campanha não mostra os indicadores.
• Possivel causa: é a primeira campanha do cliente e não há campanha anterior com que comparar.
• Como orientar: explique que a comparação só existe a partir da segunda campanha. A composição de novos e recorrentes continua aparecendo.
• Quando escalar: não é falha.

• Falha: o usuário tem a permissão de exportar dados e recebe recusa ao baixar um relatório.
• Possivel causa: a global Exportar dados não basta. É preciso também a permissão de ler o recurso de onde o dado sai.
• Como orientar: oriente o Master a marcar o ler do recurso correspondente no role. Posições premiadas e Apuração pedem Posições premiadas, e Notas fiscais pede Notas fiscais.
• Quando escalar: se as duas permissões estiverem marcadas e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o cliente procura uma tela de consulta de números da sorte e não encontra.
• Possivel causa: não existe tela própria de consulta de números por campanha. Os números aparecem no relatório Números da sorte e no detalhe do participante.
• Como orientar: oriente a usar o relatório Números da sorte em Relatórios ou a aba de números do detalhe do participante em Gerenciar.
• Quando escalar: não é falha.