# 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`