Initial commit

docs/student.md

@@ -0,0 +1,248 @@
+# Manual do Estudante
+
+## Visão Geral
+
+O painel do estudante permite visualizar turmas, acessar materiais, fazer provas, registrar presença e gerenciar pagamentos.
+
+## Acesso
+
+- **URL**: `/dashboard/student`
+- **Role Necessária**: `student`
+
+---
+
+## Funcionalidades
+
+### 1. Dashboard Principal
+**Rota**: `/dashboard/student`
+
+Lista de todas as turmas matriculadas com cards mostrando:
+- Nome da turma
+- Professores
+- Horário
+- Status
+
+#### Como Testar
+1. Faça login como estudante
+2. Acesse `/dashboard/student`
+3. **Esperado**: Ver todas as turmas matriculadas
+
+---
+
+### 2. Detalhes da Turma
+**Rota**: `/dashboard/student/class/[id]`
+
+Página principal de uma turma específica.
+
+#### Informações Exibidas
+- Nome da turma
+- Professores
+- Horário e dias
+- Status
+
+#### Estatísticas
+- Taxa de presença (%)
+- Total de aulas
+- Presentes, atrasados, ausentes
+
+#### Materiais Disponíveis
+Arquivos organizados por categoria com opção de download.
+
+#### Provas Disponíveis
+Lista de provas para fazer com:
+- Data limite
+- Tempo disponível
+- Botão para iniciar
+
+#### Feed de Atividades Recentes
+Mostra as últimas atividades da turma.
+
+#### Como Testar - Acessar Turma
+1. No dashboard, clique em uma turma
+2. **Esperado**: Ver detalhes completos da turma
+
+#### Como Testar - Baixar Material
+1. Acesse uma turma
+2. Na seção "Materiais", clique em um arquivo
+3. **Esperado**: Download do arquivo iniciado
+
+---
+
+### 3. Histórico da Turma
+**Rota**: `/dashboard/student/class/[id]/history`
+
+Lista de todas as aulas com:
+- Data
+- Conteúdo/tema
+- Professor
+- Status de presença do aluno
+
+#### Status de Presença
+- `Presente`: Aluno presente
+- `Atrasado`: Aluno chegou atrasado
+- `Ausente`: Aluno faltou
+- `Justificado`: Falta justificada
+
+#### Como Testar
+1. Acesse uma turma
+2. Clique em "Histórico"
+3. **Esperado**: Ver todas as aulas com sua presença
+
+---
+
+### 4. Fazendo Provas
+**Rota**: `/dashboard/student/assignments/[id]/take`
+
+Interface para fazer provas online.
+
+#### Funcionalidades
+- Timer com contagem regressiva
+- Perguntas de múltipla escolha e texto
+- Barra de progresso
+- Salvar automaticamente
+- Entender automaticamente ao acabar o tempo
+
+#### Como Testar
+1. Acesse uma turma
+2. Na seção "Provas Disponíveis", clique em "Iniciar"
+3. Responda às perguntas
+4. Clique em "Entregar" ou aguarde o tempo acabar
+5. **Esperado**: Prova entregue, redirecionado para resultados
+
+#### Importante
+- O timer não para se você sair da página
+- Após o tempo acabar, a prova é entregue automaticamente
+- Você pode ver suas respostas antes de entregar
+
+---
+
+### 5. Resultados de Provas
+**Rota**: `/dashboard/student/assignments/[id]/results`
+
+Ver resultados das provas feitas.
+
+#### Informações Exibidas
+- Nota final
+- Tempo gasto
+- Tentativas anteriores
+- Feedback por pergunta (se disponível)
+- Opção de tentar novamente (se permitido)
+
+#### Como Testar
+1. Após fazer uma prova, você será redirecionado para resultados
+2. Ou acesse através da turma > Provas
+3. **Esperado**: Ver nota, respostas e feedback
+
+---
+
+### 6. Pagamentos
+**Rota**: `/dashboard/student/payments`
+
+Gerenciar obrigações de pagamento e histórico.
+
+#### Funcionalidades
+- Ver obrigações pendentes
+- Registrar novos pagamentos
+- Ver histórico de pagamentos
+- Fazer upload de comprovantes
+- Ver status (pendente, aprovado, rejeitado)
+
+#### Como Testar - Registrar Pagamento
+1. Acesse `/dashboard/student/payments`
+2. Na seção "Obrigações", clique em uma pendente
+3. Preencha:
+   - Data do pagamento
+   - Método (PIX, transferência, dinheiro, cartão)
+   - Nome do pagador (opcional)
+   - Upload de comprovante (opcional)
+4. Salve
+5. **Esperado**: Pagamento registrado com status "pendente"
+
+#### Métodos de Pagamento
+- `pix`: PIX
+- `transferência`: Transferência bancária
+- `dinheiro`: Dinheiro
+- `cartão_crédito`: Cartão de crédito
+- `cartão_débito`: Cartão de débito
+
+#### Status
+- `pending`: Aguardando aprovação
+- `verified`: Pagamento aprovado
+- `rejected`: Pagamento rejeitado
+
+---
+
+### 7. Perfil
+**Rota**: `/profile`
+
+Editar informações pessoais.
+
+#### Informações Editáveis
+- Nome completo
+- Nome de usuário
+- Email
+- Data de nascimento
+
+#### Informações Somente Leitura
+- Roles (funções)
+- Responsáveis (se menor de idade)
+- Estudantes sob responsabilidade (se responsável)
+
+#### Como Testar
+1. Acesse `/profile`
+2. Altere qualquer campo permitido
+3. Clique em "Salvar Alterações"
+4. **Esperado**: Dados atualizados, mensagem de sucesso
+
+#### Restrições para Menores de Idade
+- Estudantes menores de 18 não podem remover responsáveis existentes
+- Podem apenas ver quais responsáveis estão vinculados
+
+---
+
+## Fluxo de Uso Típico
+
+### Dia a Dia
+1. **Antes da aula**: Acesse a turma e baixe o material
+2. **Durante o curso**: Faça as provas disponíveis antes da data limite
+3. **Após provas**: Acompanhe seus resultados
+
+### Mensalmente
+1. Acesse `/dashboard/student/payments`
+2. Verifique obrigações pendentes
+3. Registre os pagamentos feitos
+4. Aguarde aprovação
+
+---
+
+## Checklist de Testes
+
+- [ ] Ver lista de turmas matriculadas
+- [ ] Acessar detalhes de uma turma
+- [ ] Baixar material da turma
+- [ ] Ver histórico de presença
+- [ ] Fazer uma prova
+- [ ] Ver resultados de prova
+- [ ] Registrar um pagamento
+- [ ] Editar perfil
+
+---
+
+## Possíveis Problemas
+
+### Não vejo uma turma
+- **Verifique**: Você está matriculado nessa turma?
+- **Solução**: Entre em contato com o admin
+
+### Prova não aparece
+- **Verifique**: A data/hora da prova está dentro do período?
+- **Verifique**: Você já tentou o número máximo de vezes?
+- **Solução**: Verifique com o professor
+
+### Pagamento não é aprovado
+- **Verifique**: O comprovante foi anexado corretamente?
+- **Solução**: Entre em contato com o admin
+
+### Não consigo editar responsável
+- **Possível causa**: Você tem 18 anos ou mais
+- **Solução**: Adultos não podem ter novos responsáveis, apenas remover existentes