> ## Documentation Index
> Fetch the complete documentation index at: https://docs.assessiq.digital/llms.txt
> Use this file to discover all available pages before exploring further.

# Relatórios

> Visualize e exporte resultados de avaliações em relatórios detalhados.

## Visão Geral

O módulo de Relatórios exibe os resultados das submissões de testes. Cada submissão completa gera um relatório com pontuação, respostas e classificação automática por faixa.

**Acesso:** Menu lateral → **Relatórios**

***

## Listagem de Relatórios

A tela de relatórios exibe todas as submissões concluídas com:

| Coluna              | Descrição                              |
| ------------------- | -------------------------------------- |
| Nome do respondente | Aluno ou Candidato                     |
| Nome do teste       | Título do formulário aplicado          |
| Data                | Data de conclusão                      |
| Pontuação           | `totalScore / maxScore`                |
| Faixa               | Classificação baseada nos score ranges |
| Ações               | Ver / Exportar PDF                     |

### Filtros Disponíveis

* Busca por nome do respondente ou título do teste
* Filtro por período (data inicial e final)
* Filtro por faixa de pontuação

### Escopo por Role

* **PROFESSOR**: vê apenas submissões dos seus testes
* **ADMIN / SUPER\_ADMIN**: vê todas as submissões da organização

***

## Visualização do Relatório

Ao clicar em **Ver Relatório**, a tela exibe:

1. **Cabeçalho** — dados do respondente, data, professor responsável
2. **Resumo** — pontuação total, máxima possível, percentual e faixa de resultado
3. **Respostas por Seção** — cada questão com a resposta dada e pontuação obtida
4. **Gráfico de Desempenho** — distribuição de pontos por seção (quando houver seções)

***

## Exportar PDF

Clique em **Exportar PDF** para gerar e baixar o relatório em formato PDF profissional.

O PDF inclui:

* Identidade visual da organização
* Dados do respondente e do profissional responsável
* Todas as respostas com pontuação
* Faixa de resultado destacada com cor
* Seções com subtotais

A geração é **server-side** (via `app/api/reports/export/route.ts`), garantindo performance e segurança.

<Note>
  O tamanho médio de um PDF de relatório é de 100–300 KB, dependendo do número de questões.
</Note>

***

## Histórico no Perfil do Aluno

O histórico de avaliações de cada aluno também é acessível pelo **modal de detalhes do aluno** na aba **Avaliações**, com links diretos para cada relatório.