Gradebook: notas, categorias e rubricas

Modelo

GradeCategory (peso, drop_lowest)
  └── GradeItem (atividade — quiz, assignment, manual; vinculo opcional a aula, dueDate, isPublished)
      └── Grade (nota por aluno)
          └── Rubric (opcional — criterios)

Calculo (exportacao CSV)

A exportacao CSV calcula a nota final ponderada assim:

courseGrade = Σ (categoryAvg × categoryWeight) / Σ pesosUsados

categoryAvg = average(itemPercents após descartar o drop_lowest da categoria)
itemPercent = studentScore / itemMaxScore × 100

Itens sem categoria sao ponderados pelo proprio GradeItem.weight. Apenas itens publicados contam.

Roadmap: penalidade automatica por atraso (submittedAt > dueDate) e release agendado por data ainda nao sao aplicados. dueDate e armazenado e exibido; isPublished controla a visibilidade.

Rubricas

{
  "name": "Redacao ENEM",
  "criteria": [
    {
      "name": "Dominio da norma culta",
      "weight": 0.2,
      "levels": [
        { "score": 200, "label": "Excelente", "description": "..." },
        { "score": 160, "label": "Bom", "description": "..." },
        { "score": 120, "label": "Regular", "description": "..." }
      ]
    },
    {
      "name": "Compreensao do tema",
      "weight": 0.2,
      "levels": [...]
    }
  ]
}

Aluno ve breakdown expansivel: nota final + cada criterio + comentario.

Integridade flags

O QuizAttempt persiste tabSwitchCount, copyPasteCount, blurCount, timeSpentSec total, IP e user-agent. Um 🛡️ ShieldAlert aparece ao lado da nota do quiz no gradebook quando a tentativa esta flagged — ex.: tab switches acima do maximo configurado, tempo acima do limite, ou tentativas de copy/paste enquanto copy/paste esta bloqueado. O tempo medio por questao e derivado de timeSpentSec ÷ nº de questoes (nao e coluna armazenada). O tooltip mostra o motivo do flag. Professor decide acao (anular, manter, revisar).

Exportacao

GET /api/institution/gradebook/[courseId]/export retorna CSV com:

Aluno
Email
Cada GradeItem como coluna
Media ponderada (por categoria + drop-lowest)

Compativel com Google Sheets, Excel.

Veja tambem

Quiz Engine

FAQ

Como faco media ponderada?

Crie GradeCategory com weight (ex: 'Quizzes' 40%, 'Provas' 60%). Cada GradeItem (atividade) pertence a uma categoria. Studeia calcula media ponderada automaticamente.

Posso usar rubricas em assignments?

Sim. Crie Rubric com criterios (cada um com escala 1-5 ou customizada). Vincule a um GradeItem ou assignment lesson. Ao corrigir, professor avalia criterio-por-criterio e o sistema calcula nota final + breakdown expansivel para o aluno.

Aluno ve a nota imediatamente?

Itens do gradebook usam GradeItem.isPublished — o aluno ve a nota quando o professor publica o item. Quizzes tem o proprio showResultsMode (after_submission, after_due_date, after_all_attempts, manual_release, never). Release agendado por data para itens do gradebook esta no roadmap; hoje a liberacao e o toggle de publicacao.

Tem deteccao de plagio?

Para assignments de texto: integracao com Turnitin via LTI (roadmap). Para quiz: integridade academica nativa (tab switch, time anomalies — exibida como ShieldAlert no gradebook). Para essays: detection LLM opcional (admin habilita).