Estudantes - Guia do Professor

Visão Geral

A tela Estudantes é o painel de gestão de alunos do professor. Ela exibe todos os estudantes cadastrados em uma tabela paginada, permitindo cadastrar, editar, excluir, importar em massa via planilha, pesquisar por nome e copiar o link do relatório individual de cada aluno.

Nota sobre permissões: As ações de cadastrar, editar, excluir e importar estudantes estão disponíveis apenas para professores que são gestores da instituição. Professores sem essa permissão visualizam a lista e podem copiar o link do relatório, mas não podem modificar dados.

Layout da Tela

Área	Descrição
Campo de busca	No canto superior esquerdo, permite pesquisar estudantes por nome
Barra de ações	No canto superior direito: ícone de ajuda para importação, botão "Importar" e botão "Adicionar Estudante"
Tabela paginada	Lista de estudantes com colunas: Nome, Turma, Link e Ações
Estado vazio	Mensagem exibida quando não há estudantes cadastrados ou nenhum corresponde à pesquisa

Colunas da Tabela

Coluna	Descrição
Nome	Foto (ou inicial do nome), nome completo e e-mail do estudante. Clicar no nome redireciona para o relatório do estudante
Turma	Nome da turma à qual o estudante pertence
Link	Botão para copiar o link do relatório individual
Ações	Botões de editar e excluir (visível apenas para gestores)

Funcionalidades

1. Pesquisar Estudante

O campo de busca filtra a tabela em tempo real conforme o professor digita.

Fluxo:

Clique no campo "Procurar estudante"
Digite o nome (ou parte do nome) do aluno
A tabela é filtrada automaticamente a cada tecla digitada
Para limpar a busca, apague o texto do campo

2. Cadastrar Estudante

O botão "Adicionar Estudante" abre um modal para cadastrar um novo aluno.

Campos do formulário:

Campo	Obrigatório	Descrição
Nome	Sim	Nome completo do estudante
E-mail	Sim	Endereço de e-mail do estudante
Matrícula	Não	Número de matrícula do aluno
Turma	Sim	Seleção da turma via dropdown

Fluxo:

Clique em "Adicionar Estudante"
Preencha o nome completo
Informe o e-mail
(Opcional) Informe o número da matrícula
Selecione a turma no dropdown
Clique em "Cadastrar"
Mensagem de sucesso: "Estudante cadastrado com sucesso!"
A tabela é atualizada automaticamente

3. Editar Estudante

O botão de editar (ícone de lápis) em cada linha da tabela abre o modal preenchido com os dados atuais do estudante.

Campos editáveis: Nome, e-mail, matrícula e turma.

Fluxo:

Localize o estudante na tabela
Clique no botão de editar (ícone de lápis) na coluna "Ações"
Altere os campos desejados
Clique em "Editar" para salvar
Mensagem de sucesso: "Estudante editado com sucesso!"
A tabela é atualizada automaticamente

4. Excluir Estudante

O botão de excluir (ícone de lixeira vermelha) remove permanentemente o estudante e todas as suas avaliações.

Fluxo:

Localize o estudante na tabela
Clique no botão de excluir (ícone de lixeira) na coluna "Ações"
Um alerta de confirmação aparece:
Título: "Excluir estudante?"
Mensagem: "Deseja realmente excluir o estudante [nome]? Esta ação removerá todas as avaliações desse aluno"
Clique em "Excluir" para confirmar (ou "Cancelar" para voltar)
Mensagem de sucesso: "Estudante excluído com sucesso!"

Atenção: Esta ação é irreversível. Todas as avaliações do estudante serão perdidas permanentemente.

5. Importar Estudantes via Planilha

O botão "Importar" permite cadastrar múltiplos estudantes de uma só vez através de um arquivo de planilha.

Formato esperado da planilha:

Cada linha deve conter, nesta ordem:

Coluna	Conteúdo
1	Nome do estudante
2	E-mail
3	Turma
4	Turno (Manhã, Tarde, Noite ou Integral)

Fluxo:

(Opcional) Clique no ícone de informação (ℹ) ao lado do botão "Importar" para ver as instruções e baixar a planilha modelo
Clique em "Importar"
Selecione o arquivo da planilha no seu computador
Aguarde o processamento (um spinner de carregamento será exibido)
Mensagem de sucesso: "Importação realizada com sucesso"
A tabela é atualizada com os novos estudantes

Dica: Baixe a planilha de exemplo clicando no link "Baixar exemplo de planilha" no tooltip de ajuda para garantir que o formato esteja correto.

6. Copiar Link do Relatório Individual

Cada estudante possui um link único para o seu relatório individual. O botão de copiar (ícone de cópia) na coluna "Link" copia essa URL para a área de transferência.

Fluxo:

Localize o estudante na tabela
Clique no botão de copiar (ícone de cópia) na coluna "Link"
Mensagem de sucesso: "Link copiado! O link para o relatório do aluno foi copiado para a área de transferência."
Cole o link onde desejar (e-mail, mensagem, navegador, etc.)

Utilidade: Esse link pode ser compartilhado com pais, responsáveis ou com o próprio estudante para que acompanhem o desempenho individual.

7. Acessar Relatório do Estudante

Ao clicar no nome ou na foto de um estudante na tabela, o professor é redirecionado para a página de relatório individual daquele aluno, onde pode visualizar o desempenho detalhado por atividade.

Fluxo:

Localize o estudante na tabela
Clique no nome ou na foto do estudante
Você será redirecionado para a tela de relatório por estudante

Fluxos Completos

Fluxo Principal: Cadastrar Alunos e Iniciar Acompanhamento

1. Acessar a tela de Estudantes
2. Clicar em "Adicionar Estudante"
3. Preencher nome, e-mail e selecionar a turma
4. Clicar em "Cadastrar"
5. Repetir para cada estudante
   OU
2. Clicar em "Importar" com a planilha preenchida
3. Aguardar a importação
4. Verificar os estudantes na tabela

Fluxo: Importação em Massa

1. Clicar no ícone de informação (ℹ) para ver as instruções
2. Baixar a planilha de exemplo
3. Preencher a planilha com os dados dos estudantes
   → Coluna 1: Nome
   → Coluna 2: E-mail
   → Coluna 3: Turma
   → Coluna 4: Turno (Manhã, Tarde, Noite ou Integral)
4. Clicar em "Importar"
5. Selecionar o arquivo preenchido
6. Aguardar o processamento
7. Confirmar os estudantes na tabela

Fluxo: Corrigir Dados de um Estudante

1. Pesquisar o estudante pelo nome no campo de busca
2. Clicar no botão de editar (ícone de lápis)
3. Corrigir os campos necessários
4. Clicar em "Editar" para salvar

Fluxo: Compartilhar Relatório com Responsáveis

1. Localizar o estudante na tabela
2. Clicar no botão de copiar link na coluna "Link"
3. Colar o link em um e-mail ou mensagem para o responsável

Fluxo: Remover Estudante

1. Pesquisar o estudante pelo nome
2. Clicar no botão de excluir (ícone de lixeira vermelha)
3. Ler o alerta de confirmação com atenção
4. Clicar em "Excluir" para confirmar
   → Estudante e todas as suas avaliações serão removidos permanentemente