279 lines
6.8 KiB
Markdown
279 lines
6.8 KiB
Markdown
# Manual do Responsável
|
|
|
|
## Visão Geral
|
|
|
|
O painel do responsável permite gerenciar os estudantes vinculados (filhos), acompanhar seu progresso, acessar materiais e gerenciar pagamentos.
|
|
|
|
## Acesso
|
|
|
|
- **URL**: `/dashboard/guardian`
|
|
- **Role Necessária**: `parent` ou `guardian`
|
|
|
|
---
|
|
|
|
## Funcionalidades
|
|
|
|
### 1. Dashboard Principal
|
|
**Rota**: `/dashboard/guardian`
|
|
|
|
Visão geral de todos os estudantes vinculados.
|
|
|
|
#### Informações Exibidas
|
|
- Número total de estudantes
|
|
- Turmas ativas
|
|
- Total de turmas
|
|
|
|
#### Lista de Estudantes
|
|
Cards com:
|
|
- Nome do estudante
|
|
- Nome de usuário
|
|
- Número de turmas
|
|
- Link para dashboard individual
|
|
|
|
#### Como Testar
|
|
1. Faça login como responsável
|
|
2. Acesse `/dashboard/guardian`
|
|
3. **Esperado**: Ver todos os estudantes vinculados
|
|
|
|
---
|
|
|
|
### 2. Dashboard Individual do Estudante
|
|
**Rota**: `/dashboard/guardian/[id]`
|
|
|
|
Página dedicada a um estudante específico.
|
|
|
|
#### Informações do Estudante
|
|
- Nome completo
|
|
- Nome de usuário
|
|
- Email
|
|
- Data de nascimento
|
|
|
|
#### Turmas Ativas
|
|
Cards das turmas em que o estudante está matriculado:
|
|
- Nome da turma
|
|
- Professores
|
|
- Horário
|
|
- Status
|
|
|
|
#### Turmas Arquivadas
|
|
Turmas inativas ou concluídas.
|
|
|
|
#### Como Testar
|
|
1. No dashboard principal, clique em um estudante
|
|
2. **Esperado**: Ver informações completas do estudante e suas turmas
|
|
|
|
---
|
|
|
|
### 3. Detalhes da Turma do Estudante
|
|
**Rota**: `/dashboard/guardian/[id]/class/[classId]`
|
|
|
|
Visão detalhada de uma turma específica do estudante.
|
|
|
|
#### Informações da Turma
|
|
- Nome
|
|
- Professores
|
|
- Horário e dias
|
|
- Status
|
|
|
|
#### Estatísticas do Estudante
|
|
- Taxa de presença (%)
|
|
- Total de aulas
|
|
- Presentes, atrasados, ausentes
|
|
|
|
#### Materiais Disponíveis
|
|
Arquivos organizados por categoria para download.
|
|
|
|
#### Como Testar - Acessar Turma
|
|
1. No dashboard do estudante, clique em uma turma
|
|
2. **Esperado**: Ver detalhes da turma e materiais
|
|
|
|
#### Como Testar - Baixar Material
|
|
1. Na seção "Materiais", clique em um arquivo
|
|
2. **Esperado**: Download iniciado
|
|
|
|
---
|
|
|
|
### 4. Histórico de Aulas
|
|
**Rota**: `/dashboard/guardian/[id]/class/[classId]/history`
|
|
|
|
Histórico de presença do estudante em uma turma.
|
|
|
|
#### Informações por Aula
|
|
- Data
|
|
- Conteúdo/tema
|
|
- Professor
|
|
- Status de presença do estudante
|
|
|
|
#### Status de Presença
|
|
- `Presente`: Estudante presente
|
|
- `Atrasado`: Estudante chegou atrasado
|
|
- `Ausente`: Estudante faltou
|
|
- `Justificado`: Falta justificada
|
|
|
|
#### Como Testar
|
|
1. Acesse uma turma do estudante
|
|
2. Clique em "Histórico"
|
|
3. **Esperado**: Ver todas as aulas com presença do estudante
|
|
|
|
---
|
|
|
|
### 5. Registrar Novo Estudante
|
|
**Rota**: `/dashboard/guardian/register-student`
|
|
|
|
Formulário para cadastrar um novo estudante vinculado ao responsável.
|
|
|
|
#### Campos Obrigatórios
|
|
- Nome completo
|
|
- Nome de usuário
|
|
- Data de nascimento
|
|
- Senha
|
|
|
|
#### Regras
|
|
- Estudante deve ter menos de 18 anos
|
|
- Senha deve ter no mínimo 8 caracteres
|
|
- Estudante é automaticamente vinculado ao responsável
|
|
|
|
#### Como Testar
|
|
1. Acesse `/dashboard/guardian`
|
|
2. Clique em "Registrar Novo Estudante"
|
|
3. Preencha todos os campos
|
|
4. Clique em "Registrar"
|
|
5. **Esperado**: Estudante criado e vinculado automaticamente
|
|
|
|
---
|
|
|
|
### 6. Gerenciamento de Pagamentos
|
|
**Rota**: `/dashboard/guardian/payments`
|
|
|
|
Gerenciar pagamentos de todos os estudantes vinculados.
|
|
|
|
#### Funcionalidades
|
|
- Ver obrigações de todos os estudantes
|
|
- Filtrar por estudante específico
|
|
- Registrar pagamentos
|
|
- Fazer upload de comprovantes
|
|
- Ver histórico completo
|
|
- Visualizar comprovantes
|
|
|
|
#### Como Testar - Registrar Pagamento
|
|
1. Acesse `/dashboard/guardian/payments`
|
|
2. Na seção "Obrigações", encontre uma pendente
|
|
3. Clique para registrar pagamento
|
|
4. Preencha:
|
|
- Valor (preenchido automaticamente da obrigação)
|
|
- Data do pagamento
|
|
- Método (PIX, transferência, dinheiro, cartão)
|
|
- Nome do pagador (opcional)
|
|
- Upload de comprovante (opcional)
|
|
- Observações (opcional)
|
|
5. Salve
|
|
6. **Esperado**: Pagamento registrado com status "pendente"
|
|
|
|
#### Abas de Navegação
|
|
- **Todos**: Ver pagamentos de todos os estudantes
|
|
- **Por Estudante**: Filtrar por estudante específico
|
|
|
|
#### Status de Pagamento
|
|
- `pending`: Aguardando aprovação
|
|
- `verified`: Pagamento aprovado
|
|
- `rejected`: Pagamento rejeitado
|
|
|
|
#### 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
|
|
|
|
---
|
|
|
|
### 7. Registro de Pagamento Específico
|
|
**Rota**: `/dashboard/guardian/payments/register`
|
|
|
|
Formulário para registrar um pagamento a partir de uma obrigação específica.
|
|
|
|
#### Diferença para a Página Principal
|
|
- Campo de valor já vem preenchido
|
|
- Estudante e turma já estão selecionados
|
|
- Fluxo mais rápido para pagamentos individuais
|
|
|
|
#### Como Testar
|
|
1. A partir de uma obrigação, clique em registrar
|
|
2. Preencha os campos restantes
|
|
3. Salve
|
|
4. **Esperado**: Pagamento registrado
|
|
|
|
---
|
|
|
|
## Fluxo de Uso Típico
|
|
|
|
### Acompanhamento Diário
|
|
1. Acesse `/dashboard/guardian`
|
|
2. Clique em um estudante
|
|
3. Verifique as turmas e atividades recentes
|
|
|
|
### Acompanhamento de Pagamentos
|
|
1. Acesse `/dashboard/guardian/payments`
|
|
2. Verifique obrigações pendentes
|
|
3. Registre os pagamentos feitos
|
|
4. Aguarde aprovação
|
|
|
|
### Acompanhamento Acadêmico
|
|
1. Acesse um estudante
|
|
2. Entre em uma turma
|
|
3. Baixe os materiais para acompanhar
|
|
4. Verifique o histórico de presença
|
|
|
|
---
|
|
|
|
## Checklist de Testes
|
|
|
|
- [ ] Ver lista de estudantes vinculados
|
|
- [ ] Acessar dashboard de um estudante
|
|
- [ ] Ver turmas de um estudante
|
|
- [ ] Acessar detalhes de uma turma
|
|
- [ ] Baixar material da turma
|
|
- [ ] Ver histórico de presença
|
|
- [ ] Registrar novo estudante
|
|
- [ ] Registrar pagamento para um estudante
|
|
- [ ] Ver histórico de pagamentos
|
|
|
|
---
|
|
|
|
## Possíveis Problemas
|
|
|
|
### Não vejo um estudante
|
|
- **Verifique**: O estudante está vinculado à sua conta?
|
|
- **Solução**: Entre em contato com o admin
|
|
|
|
### Não consigo registrar estudante
|
|
- **Verifique**: A data de nascimento indica menor de 18 anos?
|
|
- **Solução**: Estudantes maiores de idade devem se cadastrar sozinhos
|
|
|
|
### Pagamento não é aprovado
|
|
- **Verifique**: O comprovante foi anexado corretamente?
|
|
- **Solução**: Entre em contato com o admin
|
|
|
|
### Não vejo todas as turmas do estudante
|
|
- **Possível causa**: Algumas turmas podem estar arquivadas
|
|
- **Solução**: Verifique na seção "Turmas Arquivadas"
|
|
|
|
---
|
|
|
|
## Relação Responsável-Estudante
|
|
|
|
### Como Funciona o Vínculo
|
|
- Estudantes têm um campo `guardiansAccounts` com IDs dos responsáveis
|
|
- Responsáveis têm um campo `wardAccounts` com IDs dos estudantes
|
|
- A relação é bidirecional
|
|
|
|
### Criando Vínculo (Admin)
|
|
1. Acesse `/admin/dashboard/users`
|
|
2. Edite o estudante
|
|
3. Selecione o responsável na lista
|
|
4. Salve
|
|
|
|
### Criando Vínculo (Auto-registro)
|
|
- Ao registrar um estudante pelo dashboard do responsável, o vínculo é automático
|
|
- Isso só funciona para menores de 18 anos
|