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

# Gerenciamento de Usuários

> Crie, edite e gerencie os usuários da plataforma.

## Visão Geral

O módulo de Usuários (Admin) permite gerenciar todas as contas que têm acesso à plataforma.

**Acesso:** Menu lateral → **Admin → Usuários**
**Roles necessários:** `ADMIN` ou `SUPER_ADMIN`

***

## Criar Novo Usuário

**Acesso:** Admin → Usuários → Novo Usuário

| Campo         | Descrição                                            | Obrigatório |
| ------------- | ---------------------------------------------------- | :---------: |
| Primeiro Nome | —                                                    |      ✅      |
| Último Nome   | —                                                    |      ❌      |
| E-mail        | Usado para login                                     |      ✅      |
| Username      | Identificador único (4–64 chars, letras/números/`_`) |      ✅      |
| Senha         | Mínimo 8 caracteres                                  |      ✅      |
| Role          | PROFESSOR / ADMIN / SUPER\_ADMIN                     |      ✅      |
| Organização   | Vincula o usuário a uma organização                  |      ❌      |

Ao criar, o sistema:

1. Cria o registro na tabela `User`
2. **Cria automaticamente** o perfil `Teacher` vinculado (para roles de staff), garantindo que nome e e-mail apareçam na página de perfil

***

## Editar Usuário

No menu de ações (⋮) da listagem, clique em **Editar**. É possível alterar:

* Nome, e-mail
* Role (SUPER\_ADMIN pode alterar para qualquer role; ADMIN apenas para PROFESSOR/ADMIN)
* Status (ACTIVE / INACTIVE / SUSPENDED)
* Organização

***

## Excluir Usuário

<Warning>
  A exclusão é irreversível e remove o usuário e todos os dados vinculados. Use com cautela.
</Warning>

Somente `SUPER_ADMIN` pode excluir usuários.

***

## Status de Usuário

| Status      | Comportamento                              |
| ----------- | ------------------------------------------ |
| `ACTIVE`    | Login permitido normalmente                |
| `INACTIVE`  | Conta desativada, não consegue fazer login |
| `SUSPENDED` | Login bloqueado temporariamente            |

***

## Sincronizar Usuários

**Acesso:** Admin → Sincronizar Usuários

Se houver usuários criados fora do fluxo padrão (ex.: via OAuth pela primeira vez), use a sincronização para garantir que todos os registros existentes no banco tenham os campos obrigatórios preenchidos corretamente.