Submissões

Endpoints para gerenciar respostas e resultados de testes.

GET /api/submissions

Lista submissões do usuário autenticado (ou todas, para admins).

Query Params

Param	Tipo	Descrição
page	number	Página
limit	number	Itens por página
formId	string	Filtrar por formulário
studentId	string	Filtrar por aluno
isCompleted	boolean	Apenas concluídas

Resposta

{
  "submissions": [
    {
      "id": "sub_id",
      "formId": "form_id",
      "studentId": "student_id",
      "totalScore": 75,
      "maxScore": 100,
      "isCompleted": true,
      "createdAt": "2026-02-01T10:00:00.000Z",
      "form": { "title": "Avaliação Funcional" },
      "student": { "name": "Ana Lima" }
    }
  ],
  "total": 120
}

---

GET /api/submissions/:id

Retorna uma submissão completa com todas as respostas.

{
  "id": "sub_id",
  "totalScore": 75,
  "maxScore": 100,
  "isCompleted": true,
  "answers": [
    {
      "questionId": "q_id",
      "questionText": "A criança consegue...",
      "selectedOptionId": "opt_id",
      "selectedOptionText": "Sim, com autonomia",
      "points": 3
    }
  ]
}

---

POST /api/reports/export

Gera e retorna o PDF do relatório de uma submissão.

Autenticação: Obrigatória

Body (JSON)

{
  "submissionId": "sub_id"
}

Resposta

Content-Type: application/pdf — retorna o arquivo PDF diretamente.