Initial commit

docs/admin.md

@@ -0,0 +1,240 @@
+# Manual do Administrador
+
+## Visão Geral
+
+O painel de administrador permite gerenciar todos os aspectos da plataforma de cursos, incluindo usuários, turmas, provas, pagamentos e arquivos.
+
+## Acesso
+
+- **URL**: `/admin/dashboard`
+- **Role Necessária**: `admin`
+
+---
+
+## Funcionalidades
+
+### 1. Dashboard Principal
+**Rota**: `/admin/dashboard`
+
+Página inicial com cards de navegação para todas as funcionalidades administrativas.
+
+---
+
+### 2. Gerenciamento de Tipos de Turma
+**Rota**: `/admin/dashboard/classTypes`
+
+#### Funcionalidades
+- Criar novos tipos de turma (ex: "Starters", "Movers")
+- Definir faixa etária
+- Definir preço mensal
+- Gerenciar arquivos por tipo de turma
+
+#### Como Testar
+1. Acesse `/admin/dashboard/classTypes`
+2. Clique em "Novo Tipo de Turma"
+3. Preencha nome, idade mínima, idade máxima e preço
+4. Salve
+5. **Esperado**: Tipo de turma aparece na lista
+
+#### Campos
+- `name`: Nome do tipo de turma
+- `minAge`: Idade mínima
+- `maxAge`: Idade máxima
+- `price`: Preço mensal
+
+---
+
+### 3. Gerenciamento de Turmas
+**Rota**: `/admin/dashboard/class`
+
+#### Funcionalidades
+- Criar novas turmas
+- Atribuir professores
+- Definir horário e dias da semana
+- Ativar/desativar turmas
+- Gerenciar alunos matriculados
+- Upload de materiais
+
+#### Como Testar
+1. Acesse `/admin/dashboard/class`
+2. Clique em "Nova Turma"
+3. Selecione o tipo de turma
+4. Adicione professores (multi-select)
+5. Defina os dias da semana
+6. Salve
+7. **Esperado**: Turma criada e visível na lista
+
+#### Campos
+- `classType`: Tipo de turma (obrigatório)
+- `teachers`: Professores (pode ter vários)
+- `schedule`: Horário das aulas
+- `days`: Dias da semana
+- `active`: Status ativo/inativo
+
+---
+
+### 4. Gerenciamento de Usuários
+**Rota**: `/admin/dashboard/users`
+
+#### Funcionalidades
+- Visualizar todos os usuários
+- Editar informações de usuários
+- Gerenciar roles (admin, teacher, student, parent)
+- Vincular responsáveis a estudantes
+- Excluir usuários
+
+#### Como Testar
+1. Acesse `/admin/dashboard/users`
+2. Clique no ícone de editar em um usuário
+3. Altere as roles marcando/desmarcando checkboxes
+4. Para vincular responsável, selecione na lista
+5. Salve
+6. **Esperado**: Roles atualizadas, vínculos criados
+
+#### Roles Disponíveis
+- `admin`: Acesso completo ao painel administrativo
+- `teacher`: Acesso a turmas atribuídas
+- `student`: Acesso a turmas matriculadas
+- `parent`: Acesso a dados dos filhos vinculados
+
+---
+
+### 5. Gerenciamento de Pagamentos
+**Rotas**:
+- `/admin/dashboard/payments` - Visão geral
+- `/admin/dashboard/payments/by-class` - Por turma
+
+#### Funcionalidades
+- Criar obrigações de pagamento para alunos
+- Aprovar/rejeitar pagamentos
+- Visualizar comprovantes
+- Estatísticas de pagamentos
+
+#### Como Testar - Criar Obrigação
+1. Acesse `/admin/dashboard/payments`
+2. Clique em "Nova Obrigação"
+3. Selecione o aluno
+4. Digite o valor e data de vencimento
+5. Salve
+6. **Esperado**: Obrigação aparece na lista do aluno
+
+#### Como Testar - Aprovar Pagamento
+1. Na lista de pagamentos, encontre um pendente
+2. Clique para ver detalhes
+3. Visualize o comprovante
+4. Clique em "Aprovar" ou "Rejeitar"
+5. **Esperado**: Status atualizado
+
+#### Status de Pagamento
+- `pending`: Aguardando aprovação
+- `verified`: Pagamento aprovado
+- `rejected`: Pagamento rejeitado
+
+---
+
+### 6. Provas e Tarefas
+**Rotas**:
+- `/admin/dashboard/exams` - Gerenciar provas
+- `/admin/dashboard/exam-templates` - Templates de prova
+- `/admin/dashboard/assignments` - Atribuir provas a turmas
+- `/admin/dashboard/statistics/exams` - Estatísticas
+
+#### Funcionalidades
+- Criar templates de provas reutilizáveis
+- Adicionar perguntas (múltipla escolha, texto)
+- Atribuir provas a turmas
+- Definir data/hora de início e fim
+- Configurar tentativas permitidas
+- Ver resultados e estatísticas
+
+#### Como Testar - Criar Template
+1. Acesse `/admin/dashboard/exam-templates`
+2. Clique em "Novo Template"
+3. Digite título e descrição
+4. Adicione perguntas:
+   - Pergunta de múltipla escolha: adicione opções e marque a correta
+   - Pergunta de texto: apenas o enunciado
+5. Salve
+6. **Esperado**: Template criado
+
+#### Como Testar - Atribuir Prova
+1. Acesse `/admin/dashboard/assignments`
+2. Clique em "Nova Atribuição"
+3. Selecione o template
+4. Selecione a turma
+5. Defina data/hora início e fim
+6. Configure tentativas permitidas
+7. Salve
+8. **Esperado**: Prova aparece para os alunos da turma
+
+---
+
+### 7. Categorias de Arquivos
+**Rota**: `/admin/dashboard/categories`
+
+#### Funcionalidades
+- Criar categorias para organizar arquivos
+- Ex: "Material de Aula", "Lição de Casa", "Provas Antigas"
+
+#### Como Testar
+1. Acesse `/admin/dashboard/categories`
+2. Clique em "Nova Categoria"
+3. Digite o nome
+4. Salve
+5. **Esperado**: Categoria disponível ao fazer upload de arquivos
+
+---
+
+### 8. Gerenciamento de Arquivos
+**Rotas**:
+- `/admin/dashboard/files` - Lista de arquivos
+- `/admin/dashboard/files/add` - Upload de arquivo
+- `/admin/dashboard/files/[id]` - Editar arquivo
+
+#### Funcionalidades
+- Fazer upload de arquivos
+- Associar a turmas ou tipos de turma
+- Categorizar arquivos
+- Gerenciar permissões
+
+#### Como Testar
+1. Acesse `/admin/dashboard/files/add`
+2. Digite o nome do arquivo
+3. Selecione o arquivo no computador
+4. Selecione a categoria
+5. Associe a uma turma ou tipo de turma (opcional)
+6. Salve
+7. **Esperado**: Arquivo disponível para download na turma
+
+---
+
+## Checklist de Testes
+
+- [ ] Criar tipo de turma
+- [ ] Criar turma com professores
+- [ ] Criar usuário com role student
+- [ ] Criar usuário com role teacher
+- [ ] Vincular responsável a estudante
+- [ ] Matricular estudante em turma
+- [ ] Criar obrigação de pagamento
+- [ ] Aprovar pagamento
+- [ ] Criar template de prova
+- [ ] Atribuir prova a turma
+- [ ] Fazer upload de material para turma
+
+---
+
+## Possíveis Problemas
+
+### Usuário não acessa o admin
+- **Verifique**: O usuário tem a role `admin`?
+- **Solução**: Edite o usuário em `/admin/dashboard/users`
+
+### Turma não aparece para o professor
+- **Verifique**: O professor está atribuído à turma?
+- **Solução**: Edite a turma em `/admin/dashboard/class`
+
+### Aluno não vê a prova
+- **Verifique**: Data/hora da atribuição está correta?
+- **Verifique**: Aluno está matriculado na turma?
+- **Solução**: Verifique a atribuição em `/admin/dashboard/assignments`