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/devolutivaController: 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:
reviewcontém questões + respostas + gabarito (para questionários).feedbackcontém Devolutiva (para exam_written) - D-03:
has_reviewehas_feedbackna lista permitem Frontend renderizar botões condicionalmente