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

{
  "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

{
  "submissionId": "sub_id"
}

Resposta

Content-Type: application/pdf

O arquivo PDF é retornado diretamente no corpo da resposta.