Alunos

A seção Alunos fica no grupo Acadêmico da sidebar e concentra todo o ciclo de vida dos alunos da escola: cadastro, vínculos com turmas e responsáveis, edição e arquivamento. Alunos arquivados saem desta seção e passam a ser gerenciados em Sistema > Arquivados > Alunos.

---

Lista de alunos

A tela principal exibe uma tabela paginada com todos os alunos ativos da escola. Cada linha mostra:

• Avatar e nome completo do aluno, com o identificador logo abaixo do nome em fonte monoespaçada. O identificador pode ser a matrícula, o CPF ou um código interno.
• Turmas vinculadas, exibidas como badges coloridos. Se o aluno pertencer a mais de duas turmas, as demais ficam ocultas e aparecem em um tooltip ao passar o cursor sobre o indicador +N.
• Responsáveis vinculados, exibidos com avatar e primeiro nome. Da mesma forma, responsáveis além dos dois primeiros ficam resumidos em um contador com tooltip.
• Menu de ações, no ícone ⋯, que oferece os atalhos "Editar" e "Arquivar" sem precisar abrir o registro.

Clicar em qualquer linha da tabela abre diretamente a tela de edição do aluno.

Busca: um campo de busca no topo filtra os resultados em tempo real pelo nome do aluno. A paginação é resetada a cada nova busca.

Estado vazio: quando não há alunos cadastrados, a tela exibe um ícone ilustrativo, a mensagem "Nenhum aluno cadastrado" e o botão "Novo Aluno". Se a busca não retornar resultados, a mensagem é "Nenhum resultado para [termo]".

---

Criar um aluno

Para adicionar um novo aluno, clique em Novo Aluno no canto superior direito da lista. Você também pode abrir o Menu de Comandos e selecionar "Novo Aluno".

O formulário está dividido em três seções:

1. Dados do aluno

1. Clique na área de avatar para fazer upload de uma foto de perfil. Aceita PNG ou JPG de até 2 MB e é opcional.
2. Preencha o Nome completo — campo obrigatório.
3. Preencha o Identificador — aceita CPF, número de matrícula ou código interno da escola. O campo exibe um botão de cópia para facilitar o reuso do valor. Não é obrigatório.
4. Informe a Data de nascimento usando o seletor de data. Não é obrigatório.

2. Turmas

5. Clique em Turmas para abrir o seletor de turmas.
6. Pesquise pelo nome da turma e selecione uma ou mais. Cada turma selecionada aparece como badge dentro do seletor. A seleção pode ser desfeita individualmente.

3. Responsáveis

7. Clique em Responsáveis para abrir o seletor de responsáveis.
8. Busque pelo nome ou CPF do responsável e selecione quantos forem necessários. Veja os detalhes na próxima seção.

Salvar

9. A barra de ações aparece na parte inferior da tela assim que algum campo é alterado. Clique em Salvar para confirmar o cadastro, ou em Descartar para reverter todas as alterações.
10. Ao tentar sair da página com alterações não salvas, o sistema exibe um alerta de confirmação.

---

Vincular responsáveis

O campo Responsáveis usa um componente de multi-seleção com busca integrada. O campo de busca dentro do seletor aceita tanto o nome quanto o CPF do responsável — os dois valores são indexados para a busca, de modo que digitar parte do CPF já filtra corretamente.

Funcionamento passo a passo:

1. Abra o seletor clicando no campo "Responsáveis".
2. Digite o nome ou o CPF, parcial ou completo, do responsável desejado.
3. A lista de sugestões exibe o nome do responsável e, abaixo, o CPF como identificador secundário.
4. Clique no responsável para selecioná-lo. É possível selecionar múltiplos responsáveis na mesma operação.
5. Os responsáveis selecionados ficam marcados na lista e exibidos como itens dentro do seletor.
6. Para remover um responsável, clique no × ao lado do nome ou desmarque-o na lista.

Apenas usuários com o papel Responsável aparecem neste seletor. Responsáveis arquivados não são listados.

Alternativa: o vínculo também pode ser feito pelo lado do responsável. Ao criar ou editar um responsável em Pessoas > Responsáveis, o campo "Alunos" permite selecionar os alunos vinculados e até criar um novo aluno diretamente pelo mini-formulário inline, sem sair da tela do responsável.

---

Editar um aluno

Clique em qualquer linha da lista de alunos, ou em "Editar" no menu ⋯, para abrir a tela de edição.

O cabeçalho da tela exibe o nome, o identificador e o avatar do aluno, com um botão de voltar para "Alunos". O botão Arquivar fica no canto superior direito do cabeçalho.

Os campos disponíveis na edição são os mesmos do formulário de criação:

• Avatar, que pode ser substituído ou removido
• Nome completo
• Identificador
• Data de nascimento
• Turmas vinculadas, em multi-seleção
• Responsáveis vinculados, em multi-seleção com busca por CPF

Qualquer alteração ativa a barra de ações na parte inferior. Clique em Salvar para persistir as mudanças ou em Descartar para restaurar o estado original. A navegação com alterações pendentes exibe um alerta de confirmação.

---

Arquivar / Desarquivar aluno

Arquivar

O arquivamento está disponível de duas formas:

• Na lista de alunos, pelo menu ⋯ da linha correspondente.
• Na tela de edição, pelo botão "Arquivar" no cabeçalho.

Em ambos os casos, um diálogo de confirmação é exibido com a mensagem "O aluno será removido das listagens ativas." Confirme clicando em Confirmar.

Efeitos do arquivamento:

• O aluno desaparece imediatamente da lista ativa em Acadêmico > Alunos.
• O aluno deixa de aparecer nos seletores de alunos em turmas e responsáveis.
• Todos os vínculos anteriores de turmas e responsáveis são preservados e ficam visíveis na tela de visualização em Arquivados.
• O aluno é contabilizado fora do uso ativo na tela de Assinatura.

Desarquivar

Para restaurar um aluno arquivado:

1. Acesse Sistema > Arquivados na sidebar.
2. Selecione a aba Alunos.
3. Localize o aluno na lista, que fica em modo somente-leitura e tem busca disponível.
4. Clique na linha para abrir os detalhes do aluno. A tela exibe os dados em modo read-only: nome, identificador, data de nascimento, turmas vinculadas, responsáveis vinculados e a data em que o aluno foi arquivado.
5. Clique em Desarquivar aluno no topo da tela e aguarde a confirmação.

O aluno retorna imediatamente para a lista ativa em Acadêmico > Alunos com todos os vínculos anteriores restaurados.

---