> ## Documentation Index
> Fetch the complete documentation index at: https://docs.assessiq.digital/llms.txt
> Use this file to discover all available pages before exploring further.

# Módulo de Alunos

> Cadastre e gerencie perfis completos de alunos.

## Visão Geral

O módulo de Alunos gerencia os destinatários dos testes do tipo `STUDENT`. Cada aluno tem um perfil detalhado com dados pessoais, familiares, acadêmicos e muito mais.

**Acesso:** Menu lateral → **Pessoas → Alunos**

***

## Cadastro de Aluno

**Acesso:** Alunos → Novo Aluno

### Dados Cadastrais

| Campo               | Descrição                                 |
| ------------------- | ----------------------------------------- |
| Nome                | Nome completo do aluno                    |
| Status              | ACTIVE / INACTIVE / SUSPENDED / GRADUATED |
| Matrícula           | Código de matrícula único                 |
| Plano               | Plano de mensalidade (free, básico, etc.) |
| Acesso à plataforma | Login/senha próprios do aluno             |

### Informações Pessoais

* Idade, data de nascimento, gênero
* Telefone, endereço completo (rua, número, bairro, cidade, estado, CEP)

### Informações Acadêmicas

* Turma (`grade`), categoria (`studentCategory`)
* Projeto: nome, área de conhecimento, datas de início/fim
* Horários semanais (`weekSchedule`)
* Notebook emprestado (`rentNotebook`)

### Dados Familiares

* Responsável: nome, profissão, especialização
* Pai: nome, profissão, especialização
* Mãe: nome, profissão, especialização

### Acesso Gmail (Opcional)

* Gmail e senha para gestão centralizada de contas educacionais

***

## Ações por Aluno

No menu de ações (⋮) de cada linha da tabela:

| Ação                        | Disponível para             |
| --------------------------- | --------------------------- |
| Ver detalhes                | Todos os roles              |
| Editar perfil               | Todos os roles              |
| Aplicar teste               | Todos os roles              |
| Ver histórico de avaliações | Todos os roles              |
| **Excluir**                 | ADMIN e SUPER\_ADMIN apenas |

***

## Modal de Detalhes

Ao clicar em **Ver** (ícone de olho), um modal completo abre com abas:

| Aba         | Conteúdo                         |
| ----------- | -------------------------------- |
| Pessoal     | Dados básicos, foto, contato     |
| Acadêmico   | Turma, projeto, horários         |
| Família     | Responsável, pai, mãe            |
| Acesso      | Credenciais e configurações      |
| Arquivos    | Documentos e relatórios anexados |
| Mensalidade | Plano e dados de pagamento       |

***

## Filtros e Busca

A listagem de alunos suporta:

* **Busca por nome** em tempo real
* **Filtro por status** (Ativo, Inativo, Suspenso, Formado)
* **Filtro por categoria**
* **Filtro por horário** (turno)
* **Filtro por plano**
* **Paginação** — 20 alunos por página (configurável)

***

## Histórico de Avaliações

Cada aluno tem uma aba de **Avaliações** no modal de detalhes mostrando todas as submissões concluídas com data, pontuação e link para o relatório completo.