> ## 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

> Endpoints para acesso a relatórios e exportação de PDFs.

## GET /api/reports

Lista submissões concluídas com dados resumidos para exibição em relatórios.

**Escopo:** Professores veem apenas suas submissões; Admins veem todas.

### Query Params

| Param    | Tipo   | Descrição                |
| -------- | ------ | ------------------------ |
| `page`   | number | Página                   |
| `limit`  | number | Itens por página         |
| `search` | string | Busca por aluno ou teste |
| `from`   | string | Data inicial (ISO 8601)  |
| `to`     | string | Data final (ISO 8601)    |

### Resposta

```json theme={null}
{
  "reports": [
    {
      "id": "sub_id",
      "studentName": "Ana Lima",
      "formTitle": "Avaliação Funcional",
      "completedAt": "2026-02-10T14:30:00.000Z",
      "totalScore": 78,
      "maxScore": 100,
      "percentage": 78,
      "scoreLabel": "Acima da média",
      "scoreColor": "#10B981",
      "assignedByName": "Prof. Carlos"
    }
  ],
  "total": 45
}
```

***

## GET /api/reports/:submissionId

Retorna os dados completos de uma submissão para renderização do relatório detalhado.

***

## POST /api/reports/export

Gera o PDF de um relatório e o retorna como download.

### Body

```json theme={null}
{
  "submissionId": "sub_id"
}
```

### Resposta

`Content-Type: application/pdf`

O arquivo PDF é retornado diretamente no corpo da resposta.