UC-007: Desempenho (Visão)
Status: EM REVISÃO Data: 2026-04-29 Domínio: platform / metrics Ator: Aluno Terms: Desempenho (Visão), Gráfico de Desempenho, Métrica de Desempenho, Contexto de Análise de Métricas, Dimensão de Análise de Métricas, Desempenho Geral, Desempenho por Disciplina, Desempenho por Módulo, Desempenho por Tipo de Fonte, Desempenho por Tipo de Simulado, Desempenho da Prática com Flashcards, Gráfico de Progresso
Contexto
Visão agregada de desempenho do Aluno na Área do Aluno. Apresenta gráficos, métricas por disciplina/módulo/tipo de fonte/tipo de simulado, e progresso geral. Backend entrega dados prontos para renderização (REF-90-A §16 — agrupamento no Backend).
Endpoint
GET /platform/study/{enrolment_id}/performance
Authorization: Bearer {wstoken}Controller: performance_api_controller.php
Resposta
{
"overall": {
"score": 68,
"trend": "up",
"total_activities": 42,
"total_time_minutes": 1200
},
"by_discipline": [
{
"discipline_id": 5,
"name": "Direito Constitucional",
"score": 72,
"trend": "up",
"units_studied": 4,
"units_total": 12
},
{
"discipline_id": 8,
"name": "Direito Penal",
"score": 55,
"trend": "stable",
"units_studied": 1,
"units_total": 15
}
],
"by_module": [
{
"module_id": 1,
"name": "Módulo 1",
"score": 65,
"status": "completed"
},
{
"module_id": 2,
"name": "Módulo 2",
"score": 70,
"status": "in_progress"
}
],
"by_source_type": [
{ "source": "legislacao", "score": 78 },
{ "source": "doutrina", "score": 62 },
{ "source": "jurisprudencia", "score": 55 }
],
"by_exam_type": [
{ "type": "diagnostic_initial", "label": "DI", "score": 72, "count": 5 },
{ "type": "diagnostic_verify", "label": "SVD", "score": 88, "count": 5 },
{ "type": "exam_objective", "label": "Simulado Objetivo", "score": 65, "count": 2 }
],
"breakdown": [
{ "module_id": 1, "discipline_id": 5, "exam_type": "exam_truefalse", "source": "legislation", "score": 75, "count": 8 },
{ "module_id": 1, "discipline_id": 5, "exam_type": "exam_written_discursiva", "score": 70, "count": 1 }
],
"flashcard_practice": {
"sessions_total": 12,
"cards_reviewed": 360,
"accuracy": 73,
"trend": "stable"
},
"progress": {
"percentage": 35,
"modules_completed": 1,
"modules_total": 8,
"current_module": "Módulo 2"
}
}Mapeamento de terms
| Term | Campo | Nota |
|---|---|---|
| Desempenho Geral | overall.score |
Média aritmética simples das médias por disciplina |
| Desempenho por Disciplina | by_discipline[] |
Média por disciplina |
| Desempenho por Módulo | by_module[] |
Média por módulo |
| Desempenho por Tipo de Fonte | by_source_type[] |
Legislação, Doutrina, Jurisprudência |
| Desempenho por Tipo de Simulado | by_exam_type[] |
DI, SVD, Objetivo, etc. |
| Desempenho da Prática com Flashcards | flashcard_practice |
Accuracy, sessões, cards |
| Cruzamento de dimensões | breakdown[] |
Tabela de fatos — permite filtros cruzados (módulo × disciplina × tipo × fonte) no frontend |
| Gráfico de Progresso | progress |
% e módulos completed/total |
| Contexto de Análise de Métricas | Implícito | Filtrado por enrolment_id |
Erros esperados
| HTTP | Código | Situação |
|---|---|---|
| 401 | unauthorized |
Token inválido ou expirado |
| 404 | enrolment_not_found |
Matrícula não encontrada |
| 403 | plan_not_active |
Plano do Aluno não está ativo |
Decisões
- D-01: Endpoint único retorna todas as dimensões — Backend agrupa (§16)
- D-02:
trendcalculado no Backend (up/down/stable) - D-03:
by_exam_type[].typeusa identifier canônico dos slot types