Skip to content

UC-007: Desempenho (Visão)

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: trend calculado no Backend (up/down/stable)
  • D-03: by_exam_type[].type usa identifier canônico dos slot types
Navigation

Type to search…

↑↓ navigate↵ selectEsc close