# Relatórios

> O mapa dos relatórios do painel: que pergunta cada um responde, como usar os filtros, quando os números atualizam e onde ficam as exportações.

Os relatórios mostram como está a sua conta em números. Eles respondem três perguntas: quem está ativo, como os alunos avançam no conteúdo e como vai a operação. Eles só mostram dados; nada se muda por aqui.

## Qual relatório responde a sua pergunta

Abra **Relatórios** no menu. A página mostra um cartão por relatório, em três grupos:

| Grupo | Pergunta | Relatórios |
|---|---|---|
| **Engajamento** | Quem está ativo e quem se destaca | [Alunos](https://help.cademi.cloud/pt/relatorios/alunos.md) e [Ranking](https://help.cademi.cloud/pt/relatorios/ranking.md) |
| **Aprendizado** | Como o aluno avança dentro do conteúdo | [Produtos](https://help.cademi.cloud/pt/relatorios/produtos.md), [Provas](https://help.cademi.cloud/pt/relatorios/provas.md) e [Certificados](https://help.cademi.cloud/pt/relatorios/certificados.md) |
| **Operação** | A saúde da operação: atendimento e base de e-mails | [Atendimento](https://help.cademi.cloud/pt/relatorios/atendimento.md) e [E-mails inválidos](https://help.cademi.cloud/pt/relatorios/emails-invalidos.md) |

Alguns exemplos:

- Quantos alunos não entram há mais de 15 dias? Abra **Alunos**.
- Em que aula os alunos param? Abra **Produtos** e depois o relatório de aulas do produto.
- A equipe responde os chamados a tempo? Abra **Atendimento**.
- Algum aluno não recebeu o e-mail de acesso? Abra **E-mails inválidos**.

Clique num cartão para abrir o relatório. Dentro dele, **Voltar para Relatórios** leva de volta ao grupo.

No alto da página há duas abas: **Relatórios** e **Exportações**. [Exportações](https://help.cademi.cloud/pt/relatorios/exportacoes.md) não é um relatório. É a lista dos arquivos que você pediu em outras telas, prontos para baixar.

## Como usar os filtros

Os relatórios usam os mesmos controles:

- **Período**: as abas no canto direito escolhem um período pronto, por exemplo **Este mês**, **Mês passado** ou **Todos**. O chip **Período** abre **De** e **Até** para escolher um intervalo. Você pode preencher só uma das duas datas.
- **Produto** ou **Vitrine**: um chip que aceita mais de um item.
- **Busca**: o campo no alto filtra só a lista, para achar um produto ou uma prova. Os números do alto não mudam com a busca.
- **Limpar filtros**: desfaz os chips de uma vez. O botão mostra quantos filtros estão aplicados.

Quando você digita datas, o período muda para **Personalizado**. Quando você escolhe uma aba pronta, as datas são apagadas.

**Atenção: o chip não filtra a mesma coisa em todo relatório.**

- Em Ranking, Provas e Certificados, o chip **Produto** filtra a tela inteira: números e lista.
- Em Produtos, o chip **Vitrine** filtra só a lista. **Total de produtos** e **Certificados emitidos** são sempre da conta inteira.

Os filtros ficam no endereço da página. Copie o link para mandar o mesmo filtro a outro administrador.

As listas carregam em blocos. **Carregar mais resultados** traz o bloco seguinte, até 200 linhas. Depois disso, a tela pede para você refinar com a busca ou os filtros.

## Quando os números atualizam

Cada relatório atualiza num ritmo:

| Relatório | Quando atualiza |
|---|---|
| Alunos, Produtos, Provas e Certificados | Uma vez por dia. O selo **Atualizado a cada 24h** aparece no canto superior direito |
| Atendimento | Uma vez por dia |
| Ranking | Em cerca de 15 minutos |
| E-mails inválidos e Exportações | Quase na hora |

Por exemplo: um aluno que concluiu uma aula agora aparece no relatório de amanhã.

Em Provas e Certificados, só os números do alto sem filtro atualizam uma vez por dia. A lista, o detalhe e os números com filtro são calculados na hora.

## O que é "aluno ativo"

Nos relatórios, ativo é quem fez login. A janela de tempo muda conforme a tela:

- No relatório de Alunos, **Ativos (últimos 7 dias)** conta quem entrou nos últimos 7 dias.
- Na lista de **Alunos > Alunos**, o filtro **Status** com **Ativo** usa 30 dias.

Nenhum dos dois diz se a matrícula está ativa ou se o produto abre. Um aluno com acesso vitalício que não entrou este mês é inativo nos dois. Para saber o que um aluno pode acessar, abra o perfil dele (veja [Matrículas e acessos](https://help.cademi.cloud/pt/alunos/matriculas-e-acessos.md)).

## Bom saber

- **Quem vê os relatórios.** O item **Relatórios** aparece no menu só para administradores com a permissão de relatórios. Em Alunos e Ranking, abrir um aluno (**Ver aluno**) pede também a permissão de ver alunos. Sem ela, o nome aparece, mas não vira link. Em Provas, Certificados e E-mails inválidos, o link do aluno não depende dessa permissão.
- **Exportar alunos.** Os relatórios não têm botão de exportar. O arquivo de alunos sai de **Alunos > Alunos**, no botão **Exportar**, com os filtros da lista. Ele fica em **Exportações**.
- **Alunos na lixeira.** Eles saem do ranking, das conclusões de prova e do total de certificados. Os certificados deles contam à parte, em **Emissões a alunos removidos**. Se você restaura o aluno, os números dele voltam. A lista de E-mails inválidos e o Atendimento não tiram esses alunos.
- **Quais produtos aparecem.** Os relatórios de Produtos, Provas e Certificados listam os produtos das vitrines que não foram excluídas. Uma vitrine oculta, não listada ou em rascunho continua aparecendo. Um produto excluído ainda pode aparecer numa linha de rodapé, como **Outros produtos (excluídos ou sem certificado ativo)**.

## Perguntas frequentes

**Um aluno concluiu uma aula hoje e o relatório não mostra. Está errado?** Não. Alunos, Produtos, Provas e Certificados atualizam uma vez por dia. A aula aparece no relatório de amanhã.

**Não vejo Relatórios no menu.** O item só aparece para administradores com a permissão de relatórios.

**Onde exporto os dados de um relatório?** Os relatórios não têm botão de exportar. Exporte a lista em **Alunos > Alunos**, no botão **Exportar**. O arquivo fica em **Exportações**.