Files
course-plat/docs/teacher.md
T
2026-08-31 14:10:20 -03:00

4.7 KiB

Manual do Professor

Visão Geral

O painel do professor permite gerenciar turmas, fazer upload de materiais, registrar presença e criar/corrigir provas.

Acesso

  • URL: /dashboard/teacher
  • Role Necessária: teacher

Funcionalidades

1. Dashboard Principal

Rota: /dashboard/teacher

Lista de todas as turmas atribuídas ao professor com cards mostrando:

  • Nome da turma
  • Número de alunos
  • Horário

Como Testar

  1. Faça login como professor
  2. Acesse /dashboard/teacher
  3. Esperado: Ver todas as turmas atribuídas

2. Detalhes da Turma

Rota: /dashboard/teacher/class/[id]

Página principal de gerenciamento de uma turma específica.

Informações Exibidas

  • Nome da turma
  • Professores atribuídos
  • Horário e dias
  • Status (ativo/inativo)
  • Estatísticas: número de alunos, taxa de presença, média das notas

Lista de Alunos

Tabela com:

  • Nome do aluno
  • Taxa de presença
  • Média das provas
  • Status

Ações Disponíveis

  • Upload de Materiais: Adicionar arquivos para a turma
  • Registrar Aula: Registrar presença e conteúdo da aula
  • Ver Histórico: Ver todas as aulas anteriores
  • Copiar Link: Copiar link da aula virtual

Como Testar - Upload de Material

  1. Acesse uma turma
  2. Clique em "Upload de Materiais"
  3. Digite o nome do arquivo
  4. Selecione o arquivo no computador
  5. Selecione a categoria
  6. Salve
  7. Esperado: Arquivo aparece na seção de materiais

Como Testar - Registrar Aula

  1. Acesse uma turma
  2. Clique em "Registrar Aula"
  3. Digite o tema/conteúdo da aula
  4. Selecione a data
  5. Marque a presença dos alunos (Presente, Atrasado, Ausente, Justificado)
  6. Salve
  7. Esperado: Aula registrada no histórico

3. Histórico da Turma

Rota: /dashboard/teacher/class/[id]/history

Lista de todas as aulas registradas com:

  • Data da aula
  • Conteúdo/tema
  • Professor que registrou
  • Resumo de presença

Como Testar

  1. Acesse uma turma
  2. Clique em "Ver Histórico"
  3. Esperado: Ver todas as aulas com presença registrada

4. Templates de Provas

Rota: /dashboard/teacher/exam-templates

Gerenciar templates de provas reutilizáveis.

Funcionalidades

  • Criar novo template
  • Editar templates existentes
  • Adicionar perguntas (múltipla escolha ou texto)
  • Definir como público ou privado

Como Testar - Criar Template

  1. Acesse /dashboard/teacher/exam-templates
  2. Clique em "Novo Template"
  3. Digite título e descrição
  4. Clique em "Adicionar Pergunta"
  5. Selecione o tipo:
    • Múltipla Escolha: Digite a pergunta, adicione opções, marque a correta
    • Texto: Digite apenas a pergunta
  6. Salve
  7. Esperado: Template criado e disponível para atribuir

5. Resultados de Provas

Rota: /dashboard/teacher/assignments/[id]/results

Ver e corrigir provas dos alunos.

Funcionalidades

  • Ver tentativas dos alunos
  • Corrigir provas manualmente
  • Ver notas automáticas (para múltipla escolha)
  • Acompanhar status de correção

Status de Correção

  • pending: Aguardando correção
  • auto-graded: Corrigido automaticamente
  • partially-graded: Parcialmente corrigido
  • fully-graded: Totalmente corrigido

Como Testar

  1. Acesse os resultados de uma atribuição
  2. Clique em uma tentativa de aluno
  3. Para perguntas de texto, digite a nota e comentários
  4. Salve
  5. Esperado: Nota atribuída, status atualizado

Fluxo de Trabalho Típico

Preparar uma Turma

  1. Acesse a turma
  2. Faça upload dos materiais da primeira aula
  3. Verifique a lista de alunos

Durante o Curso

  1. Antes de cada aula: Faça upload do material
  2. Após cada aula: Registre a presença e o conteúdo
  3. Periodicamente: Crie e atribua provas

Criar uma Prova

  1. Crie o template em /dashboard/teacher/exam-templates
  2. Atribua à turma (isso pode precisar de intervenção do admin)
  3. Acompanhe os resultados em /dashboard/teacher/assignments/[id]/results

Checklist de Testes

  • Ver lista de turmas atribuídas
  • Acessar detalhes de uma turma
  • Fazer upload de material
  • Registrar uma aula com presença
  • Ver histórico de aulas
  • Criar template de prova
  • Ver resultados de prova
  • Corrigir prova manualmente

Possíveis Problemas

Não consigo ver uma turma

  • Verifique: Você está atribuído a essa turma?
  • Solução: Entre em contato com o admin

Não consigo atribuir prova à turma

  • Possível causa: Essa funcionalidade pode estar apenas no admin
  • Solução: Peça ao admin para atribuir a prova

Material não aparece para os alunos

  • Verifique: O upload foi concluído com sucesso?
  • Verifique: A turma está correta?
  • Solução: Tente fazer upload novamente