Skip to content

UC-008: Simulados (Visão)

UC-008: Simulados (Visão)

Status: EM REVISÃO Data: 2026-04-29 Domínio: platform / activity.assessment Ator: Aluno Terms: Avaliação Simulada, Simulado Escrito, Simulado Objetivo, Simulado VF, Devolutiva do Simulado Escrito, Revisão do Questionário, Resultado Geral do Questionário

Contexto

Visão consolidada dos simulados realizados pelo Aluno. Permite consultar histórico de resultados e acessar revisões (Questionários) ou devolutivas (Simulados Escritos). Diferente do Roteiro de Estudos (UC-005), que mostra o bloco atual — esta visão é cross-blocos.

Endpoints

GET /platform/study/{enrolment_id}/exams                → Lista de simulados
GET /platform/study/{enrolment_id}/exams/{slot_id}      → Detalhe com revisão/devolutiva

Controller: exam_api_controller.php

GET /platform/study/{enrolment_id}/exams — Lista

GET /platform/study/{enrolment_id}/exams
Authorization: Bearer {wstoken}

Resposta:

{
  "summary": {
    "total": 12,
    "by_type": {
      "diagnostic_initial": 5,
      "diagnostic_verify": 5,
      "exam_objective": 2,
      "exam_written": 0
    }
  },
  "exams": [
    {
      "slot_id": "550e8400-0001-0000-0000-000000000001",
      "type": "diagnostic_initial",
      "label": "DI — Direito Constitucional",
      "status": "completed",
      "scope": [{ "type": "discipline", "id": 5, "name": "Direito Constitucional" }],
      "result": {
        "score": 72,
        "level": "intermediario",
        "completed_at": "2026-04-25T14:30:00Z"
      },
      "has_review": true,
      "has_feedback": false,
      "action": {
        "type": "navigate",
        "label": "Revisar",
        "route": "/simulados/550e8400-0001-0000-0000-000000000001"
      }
    }
  ]
}

has_review: true para questionários (VF/Objetivo) — permite ver questões e respostas. has_feedback: true para exam_written após correção — Devolutiva disponível.

GET /platform/study/{enrolment_id}/exams/{slot_id} — Detalhe

GET /platform/study/{enrolment_id}/exams/{slot_id}
Authorization: Bearer {wstoken}

Resposta (questionário — DI/SVD/Objetivo):

{
  "slot_id": "550e8400-0001-0000-0000-000000000001",
  "type": "diagnostic_initial",
  "label": "DI — Direito Constitucional",
  "result": { "score": 72, "level": "intermediario", "completed_at": "2026-04-25T14:30:00Z" },
  "review": {
    "questions": [
      {
        "id": 1,
        "statement_html": "<p>O controle difuso de constitucionalidade pode ser exercido por qualquer juiz ou tribunal.</p>",
        "alternatives": [
          { "key": "V", "label": "Verdadeiro" },
          { "key": "F", "label": "Falso" }
        ],
        "student_answer": "V",
        "correct_answer": "V",
        "is_correct": true
      }
    ],
    "stats": {
      "correct": 14,
      "incorrect": 4,
      "not_sure": 2,
      "total": 20
    }
  },
  "feedback": null
}

Resposta (exam_written — após correção):

{
  "slot_id": "550e8400-0002-0000-0000-000000000001",
  "type": "exam_written",
  "label": "Simulado Escrito — Peça Prática",
  "result": { "submitted_at": "2026-05-10T20:00:00Z", "correction_status": "corrected", "grade": 7.5 },
  "review": null,
  "feedback": {
    "grade": 7.5,
    "comments_html": "<p>Boa estruturação da peça. Atenção ao fundamento legal no item 3.</p>",
    "corrected_at": "2026-05-12T10:00:00Z",
    "corrector": "Tutor"
  }
}

Erros esperados

HTTP Código Situação
401 unauthorized Token inválido ou expirado
404 enrolment_not_found Matrícula não encontrada
404 exam_not_found Slot não encontrado ou não é tipo exam

Decisões

  • D-01: Lista filtra slots de tipo avaliativo (diagnostic_initial, diagnostic_verify, exam_objective, exam_written, exam_truefalse)
  • D-02: review contém questões + respostas + gabarito (para questionários). feedback contém Devolutiva (para exam_written)
  • D-03: has_review e has_feedback na lista permitem Frontend renderizar botões condicionalmente
Navigation

Type to search…

↑↓ navigate↵ selectEsc close