188 lines
4.7 KiB
Markdown
188 lines
4.7 KiB
Markdown
# 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
|