Initial commit

docs/teacher.md

@@ -0,0 +1,187 @@
+# 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