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

# Gerenciando Estudantes

> Acompanhe e gerencie alunos matriculados em seus cursos usando filtros, turmas e acoes em lote

## Gestao de estudantes

Acompanhe seus alunos, gerencie matriculas e organize estudantes em turmas para controle eficiente.

## Lista de membros

Acesse **Admin → Membros** para ver todos os usuarios da plataforma. A tabela exibe:

| Coluna               | Descricao                   |
| -------------------- | --------------------------- |
| **Nome**             | Nome completo do membro     |
| **Email**            | Endereco de email           |
| **Data de cadastro** | Quando a conta foi criada   |
| **Ultimo login**     | Data do acesso mais recente |
| **Status**           | Ativo ou Bloqueado          |
| **Avatar**           | Foto de perfil              |

A visualizacao se adapta ao dispositivo: em desktop e exibida como tabela, em mobile como cards.

## Filtros e busca

### Abas de filtragem

| Aba             | Conteudo                           |
| --------------- | ---------------------------------- |
| **Todos**       | Todos os membros da plataforma     |
| **Professores** | Apenas usuarios com role professor |
| **Banidos**     | Usuarios com acesso bloqueado      |

### Filtros avancados

| Filtro                  | Descricao                                                    |
| ----------------------- | ------------------------------------------------------------ |
| **Busca por texto**     | Pesquisa por nome ou email (case-insensitive, em tempo real) |
| **Curso**               | Filtra por estudantes matriculados em um curso especifico    |
| **Status de matricula** | Ativo ou Bloqueado                                           |
| **Periodo de cadastro** | Filtra por intervalo de datas (formato DD/MM/AAAA)           |

<Tip>
  Combine filtros para encontrar rapidamente um grupo especifico. Por exemplo, filtre por curso + status "Ativo" para ver apenas estudantes ativos de um curso.
</Tip>

## Acoes por membro

Para cada estudante, voce pode executar as seguintes acoes:

| Acao                     | Descricao                                        |
| ------------------------ | ------------------------------------------------ |
| **Editar**               | Modificar dados do perfil do estudante           |
| **Ver perfil**           | Acessar pagina completa do estudante             |
| **Reenviar senha**       | Envia um email com nova senha para o estudante   |
| **Bloquear/Desbloquear** | Alterna o status de acesso da conta              |
| **Excluir**              | Remove a conta permanentemente (com confirmacao) |

<Warning>
  A exclusao de um membro e permanente e remove todos os dados associados (progresso, notas, certificados). Use o bloqueio quando quiser apenas suspender o acesso temporariamente.
</Warning>

## Turmas

Turmas sao grupos de estudantes associados a um conjunto de cursos. Elas facilitam a gestao de matriculas em lote.

### Criar uma turma

<Steps>
  <Step title="Acesse Admin → Turmas">
    Clique em **Nova turma**.
  </Step>

  <Step title="Configure a turma">
    Preencha os campos:

    | Campo                    | Descricao                                          |
    | ------------------------ | -------------------------------------------------- |
    | **Nome**                 | Nome identificador da turma                        |
    | **Codigo personalizado** | Codigo opcional para referencia (ex: TURMA-2024-A) |
    | **Descricao**            | Texto descritivo sobre a turma                     |
    | **Status**               | `ativo` ou `arquivado`                             |
  </Step>

  <Step title="Adicione membros">
    Busque e selecione estudantes para adicionar a turma (ate 100 por vez).
  </Step>

  <Step title="Associe cursos">
    Selecione os cursos que os membros da turma devem acessar (ate 50 por vez).
  </Step>
</Steps>

### Matricula automatica

Quando voce adiciona um estudante a uma turma, ele e **automaticamente matriculado** em todos os cursos associados a essa turma. Da mesma forma, quando um novo curso e adicionado a turma, todos os membros existentes sao matriculados automaticamente.

<Info>
  A matricula automatica e acionada por triggers no banco de dados, garantindo que a associacao aconteca instantaneamente.
</Info>

### Gerenciar membros da turma

Na pagina de detalhes da turma, voce pode:

* **Buscar membros** por nome ou email
* **Adicionar membros** via dialogo de busca com selecao multipla
* **Remover membros** individualmente (a matricula nos cursos da turma e mantida)
* Ver a **contagem de membros** e **cursos associados**

### Gerenciar cursos da turma

* **Buscar cursos** por nome
* **Adicionar cursos** via dialogo de busca
* **Remover cursos** da turma (matriculas existentes sao mantidas)

## Importacao em lote (CSV)

Para adicionar muitos estudantes de uma vez, use a importacao via CSV.

<Steps>
  <Step title="Clique em Importar">
    Na pagina de membros, clique no botao de importacao.
  </Step>

  <Step title="Prepare o arquivo CSV">
    O arquivo deve conter as colunas `nome` e `email` (obrigatorias). Aceita separadores por virgula ou ponto e virgula.
  </Step>

  <Step title="Configure a importacao">
    Selecione o **role** dos usuarios importados (estudante ou professor) e opcionalmente um **curso** para matricula automatica.
  </Step>

  <Step title="Envie o arquivo">
    O sistema processa o CSV e exibe o progresso da importacao. Cada usuario recebe um email de boas-vindas com as credenciais de acesso.
  </Step>
</Steps>

**Limites da importacao:**

| Restricao                       | Valor                                  |
| ------------------------------- | -------------------------------------- |
| Tamanho maximo do arquivo       | 5 MB                                   |
| Maximo de registros por arquivo | 1.000                                  |
| Colunas obrigatorias            | `nome`, `email`                        |
| Separadores aceitos             | Virgula (`,`) ou ponto e virgula (`;`) |

## Informacoes de progresso

Para cada estudante matriculado em um curso, voce pode acompanhar:

* **Progresso** - Percentual de conclusao do curso
* **Status da matricula** - Ativa, bloqueada ou expirada
* **Data de expiracao** - Se a matricula tem prazo
* **Ultimo acesso** - Quando o estudante acessou pela ultima vez

## Proximos passos

<CardGroup cols={2}>
  <Card title="Analytics" icon="chart-line" href="/pt-br/teachers/analytics">
    Metricas detalhadas sobre desempenho dos estudantes
  </Card>

  <Card title="Gestao de membros (admin)" icon="users-gear" href="/pt-br/admin/member-management">
    Funcionalidades administrativas avancadas
  </Card>
</CardGroup>
