Usuários e permissões¶
Código de tela
Esta tela faz parte do módulo Sistema/Acesso. Um T-code oficial será atribuído na Fase 2 da documentação.
Lista, cria e edita os usuários do portal Sistemax — quem pode entrar no sistema, com qual nível de acesso e em quais setores. Disponível apenas para usuários Master.
Pré-requisitos¶
- Ter nível Master atribuído ao seu usuário — somente Master vê o botão Novo Usuário e o botão Editar em cada linha
- O colaborador a ser liberado precisa já existir como usuário do ERP — o portal apenas vincula um usuário ERP existente, não cria do zero
Cadastro de usuário ERP ainda não tem tela no portal
Atualmente o portal web não oferece uma tela dedicada para criar usuário do ERP (o pré-requisito acima). Sem esse usuário ERP previamente cadastrado, não é possível liberar acesso ao portal. Essa funcionalidade está prevista, mas ainda em desenvolvimento. Enquanto isso, a criação do usuário ERP precisa ser feita pelo suporte ou diretamente no backend.
Usuário ≠ Cliente
Aqui falamos do operador do sistema (colaborador interno que vai usar o ERP). Não confundir com cliente — consumidor final cadastrado no módulo de cadastros.
Como a lista é organizada¶
A tela abre com uma lista de cards, cada um representando um usuário. Acima da lista há cards de estatísticas e uma barra de filtros:
| Estatística | O que conta |
|---|---|
| Total | Total de usuários do portal |
| Ativos | Quantos têm acesso ao portal habilitado |
| Master | Quantos têm nível Master |
| Outros | Soma de Admin + Gerente + Operacional |
Filtros disponíveis na barra de busca:
- Buscar — por nome, usuário ou email
- Todos os níveis — Master / Admin / Gerente / Operacional
- Todos os setores — filtra por grupo/setor associado
- Todos os status — Ativo / Inativo
Limpar filtros
Quando algum filtro está ativo, surge o botão vermelho Limpar ao lado dos dropdowns — útil para voltar à visão completa rapidamente.
Passo a passo — criando um novo usuário¶
1. Abrir o formulário¶
Clique em Novo Usuário no canto superior direito. A tela de cadastro abre vazia.
2. Selecionar o usuário do ERP¶
No campo Usuário (com busca tipo Select2), escolha o colaborador do ERP que você quer liberar para o portal. Ao selecionar:
- Nome e Email são preenchidos automaticamente
- Só aparecem na lista usuários do ERP que ainda não têm acesso ao portal
Sem alterar o ERP
Criar o acesso ao portal não muda dados do cadastro do ERP — apenas vincula o usuário existente, definindo senha do portal, nível e grupos.
3. Definir Segurança & Acesso¶
| Campo | Obrigatório | Descrição |
|---|---|---|
| Senha do Portal | Sim | Senha inicial para login no portal (diferente da senha do ERP) |
| Nível de Acesso | Sim | Master / Admin / Gerente / Operacional — veja tabela abaixo |
| Perfil de Acesso (Permissões) | Não | Conjunto RBAC de páginas que o usuário pode acessar |
| Acesso ao portal ativo | — | Toggle. Desative para bloquear o login sem apagar o cadastro |
4. Atribuir Grupos & Setores¶
Marque quantos chips de grupo/setor o usuário deve participar. Os grupos determinam quais queries, relatórios e recursos o usuário consegue ver.
5. Salvar¶
Clique em Criar Usuário (ou Salvar Alterações na edição). O usuário volta para a lista com o novo cadastro visível.
Os 4 níveis de acesso¶
| Nível | Cor | Descrição |
|---|---|---|
| 0 — Master | Amarelo | Acesso total. Gerencia usuários, vê tudo. Use com parcimônia — recomendado 1 ou 2 por empresa. |
| 1 — Admin | Roxo | Visualização completa, sem gerenciar usuários |
| 2 — Gerente | Azul claro | Visualização limitada conforme perfil e grupos |
| 3 — Operacional | Cinza | Acesso básico — padrão para usuários novos |
Master tem acesso irrestrito
Usuários Master ignoram o perfil de permissões e os grupos — eles veem tudo. Atribua o nível Master apenas a quem realmente administra o sistema.
Editando um usuário existente¶
Na lista, clique no botão Editar ao lado do usuário. O formulário abre pré-preenchido. Diferenças em relação ao cadastro novo:
- O campo Usuário fica bloqueado — não é possível alterar o login
- O campo Senha do Portal fica opcional: deixe em branco para manter a senha atual; preencha apenas se quiser redefinir
Resetar a senha de um colega
Master pode resetar a senha de qualquer usuário aqui — informe a nova senha e o colaborador deve trocá-la no primeiro acesso (veja Trocando sua senha).
Desativando sem excluir¶
Para bloquear o acesso de alguém sem apagar o cadastro (ex.: férias, afastamento, desligamento temporário):
- Edite o usuário
- Desative o toggle Acesso ao portal ativo
- Salve
Na lista, o usuário aparece com badge cinza Inativo e não consegue mais fazer login até que o toggle seja reativado.
Erros comuns¶
Todos os usuários do ERP já possuem acesso ao portal
Aparece em amarelo no select de usuário se não há cadastros ERP livres para vincular. Solução: cadastre o colaborador no ERP primeiro, depois volte aqui.
Botão Novo Usuário não aparece
O botão é restrito a Master. Se você está logado com nível Admin/Gerente/Operacional, peça a um Master para criar o cadastro.
Usuário criado mas não consegue logar
Verifique se o toggle Acesso ao portal ativo está ligado e se a senha informada ao colaborador é a mesma do cadastro. Em último caso, edite e redefina a senha.