> ## 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.

# Gestão de Membros

> Adicione, edite e gerencie usuários da plataforma

## Gerenciamento de usuários

Controle completo sobre todos os membros da plataforma. Você pode adicionar membros individualmente, importar via CSV ou gerenciar através de turmas.

## Roles (funções)

A plataforma possui 4 níveis de acesso:

| Role          | Permissões                                                                                      |
| ------------- | ----------------------------------------------------------------------------------------------- |
| **Owner**     | Controle total. Primeiro usuário da plataforma. Não pode ser removido ou ter seu role alterado. |
| **Admin**     | Gestão geral. Pode gerenciar membros (exceto o owner), cursos, convites e configurações.        |
| **Professor** | Cria e gerencia cursos. Pode adicionar estudantes e professores, mas não admins.                |
| **Estudante** | Acessa cursos nos quais está matriculado. Sem acesso ao painel administrativo.                  |

<Note>
  Existe apenas um owner por plataforma. O role de owner não pode ser transferido.
</Note>

## Adicionar membros

### Individualmente

<Steps>
  <Step title="Acesse Admin → Membros">
    Clique em "Novo membro"
  </Step>

  <Step title="Preencha os dados">
    Nome, email e role. Opcionalmente, defina uma senha específica.
  </Step>

  <Step title="Confirme">
    O membro é criado e recebe um email de boas-vindas com suas credenciais.
  </Step>
</Steps>

A senha utilizada é a senha padrão definida nas configurações da plataforma. Se nenhuma senha padrão estiver definida, uma senha aleatória de 6 caracteres é gerada.

### Importação via CSV

Para adicionar muitos membros de uma vez, use a importação por CSV.

**Requisitos do arquivo:**

| Requisito            | Valor                                  |
| -------------------- | -------------------------------------- |
| Formato              | CSV (`.csv`)                           |
| Tamanho máximo       | 5MB                                    |
| Máximo de linhas     | 1.000 membros por importação           |
| Colunas obrigatórias | `nome` e `email`                       |
| Separadores aceitos  | Vírgula (`,`) ou ponto-e-vírgula (`;`) |

<Steps>
  <Step title="Prepare o CSV">
    Crie um arquivo com as colunas `nome` e `email`. Cada linha representa um membro.
  </Step>

  <Step title="Acesse Admin → Membros → Importar">
    Faça upload do arquivo CSV.
  </Step>

  <Step title="Revise">
    O sistema valida os dados e mostra um resumo antes de confirmar.
  </Step>

  <Step title="Confirme a importação">
    Os membros são criados e recebem email de boas-vindas automaticamente.
  </Step>
</Steps>

**Validações aplicadas:**

* Nomes: 1-255 caracteres, aceita acentos e caracteres especiais comuns
* Emails: formato válido e sem duplicatas no arquivo
* Proteção contra injeção CSV (scripts maliciosos são removidos)

<Info>
  A importação pode associar membros automaticamente a um curso específico. Selecione o curso no momento do upload.
</Info>

## Ações disponíveis

Para cada membro, você pode:

| Ação                     | Descrição                                     | Quem pode    |
| ------------------------ | --------------------------------------------- | ------------ |
| **Editar**               | Alterar nome, email, role e matrículas        | Admin, Owner |
| **Reenviar senha**       | Gerar e enviar nova senha por email           | Admin, Owner |
| **Bloquear/Desbloquear** | Impedir ou restaurar acesso à plataforma      | Admin, Owner |
| **Excluir**              | Remover membro permanentemente (irreversível) | Admin, Owner |

<Warning>
  A exclusão de um membro é permanente e remove todos os dados associados: matrículas, progresso, comentários, avaliações e histórico de conversas com IA.
</Warning>

### Restrições de edição

* O owner só pode ser editado por ele mesmo
* Admins não podem editar o owner
* Professores não podem editar admins ou o owner
* Ninguém pode promover um usuário para owner

## Filtros e busca

A lista de membros suporta:

* **Busca por nome ou email**
* **Filtro por role** - Todos, Professores, Banidos
* **Filtro por curso** - Membros matriculados em um curso específico
* **Filtro por status de matrícula** - Ativo, Inativo
* **Paginação** - 20 membros por página

## Turmas

Turmas permitem organizar grupos de membros e matriculá-los em cursos de forma massiva.

### Criar uma turma

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

  <Step title="Defina nome e descrição">
    Nome (3-200 caracteres) e opcionalmente um código personalizado e descrição.
  </Step>

  <Step title="Adicione membros">
    Selecione até 100 membros por vez.
  </Step>

  <Step title="Associe cursos">
    Selecione os cursos que esta turma deve acessar.
  </Step>
</Steps>

### Matrícula automática

* Ao adicionar um membro a uma turma → matriculado automaticamente em todos os cursos da turma
* Ao adicionar um curso a uma turma → todos os membros da turma são matriculados automaticamente

<Note>
  Remover um membro de uma turma não cancela suas matrículas existentes nos cursos.
</Note>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Sistema de convites" icon="envelope" href="/pt-br/admin/invitations">
    Crie códigos de acesso para novos membros
  </Card>

  <Card title="Certificados" icon="certificate" href="/pt-br/admin/certificates">
    Configure emissão de certificados
  </Card>
</CardGroup>