Usuários - Cadastrar Novo Usuário

O que é

Página de cadastro de um novo usuário da sua empresa. Cria o registro em users, vincula um ou mais perfis de acesso (papéis RBAC) e, opcionalmente, dispara um e-mail para o próprio usuário definir a senha de acesso ao painel admin.

O fluxo atende dois cenários: membro interno da equipe (com e-mail, telefone, status ativo e perfil que dá acesso ao painel) e Vendedor Externo, um cadastro simplificado apenas com o nome, que não acessa o admin e existe só para ser atribuído a links de venda ou reservas.

Como usar

1. Vá em Sistema > Usuários no sidebar e clique em Novo Usuário na listagem.
2. Se o usuário for apenas vendedor externo (sem acesso ao painel), ative o toggle Cadastrar como Vendedor Externo no cartão roxo do topo. O formulário recolhe para mostrar somente o campo de nome.
3. Preencha Informações do Usuário:
   • Nome - obrigatório, nome completo.
   • E-mail - obrigatório no fluxo padrão; será o login do usuário.
   • Telefone - opcional por padrão; pode ser obrigatório se a configuração de campos personalizados da sua empresa assim definir.
   • Usuário ativo - toggle verde, marcado por padrão. Usuário inativo não consegue fazer login.
4. Em Acesso ao Sistema, decida se quer Enviar email para definir senha. Com o toggle ativo o usuário recebe um link para criar a própria senha. Sem isso o cadastro fica com senha aleatória e você precisa redefinir manualmente depois.
5. Em Configurações de Vendedor, ative Habilitar como Vendedor se o usuário precisar de link próprio de vendas. O código do vendedor é gerado automaticamente ao salvar.
6. Em Perfil de Acesso, marque um ou mais perfis. Cada cartão clicável mostra o nome e a descrição do papel. O cadastro exige pelo menos um perfil selecionado.
7. Confirme em Criar Usuário. Para emendar mais cadastros use Criar e adicionar outro ou para refinar o usuário recém-criado use Criar e continuar editando.

Casos especiais

Vendedor Externo (cadastro simplificado)

Quando o toggle Cadastrar como Vendedor Externo está ativo, o formulário oculta e-mail, telefone, status, acesso ao sistema, vendedor e perfis. O sistema preenche automaticamente: papel externo, is_vendedor=1, sem envio de e-mail e gera um e-mail fictício externo-{uuid}@noreply.invalid para satisfazer a unicidade do banco. O usuário não consegue logar no admin - serve apenas para receber atribuições de venda.

O toggle só aparece se houver algum perfil cadastrado com a flag is_external = true.

Todos os perfis selecionados são externos

Se você não usa o toggle mas marca manualmente apenas perfis externos, o sistema aplica o mesmo relaxamento: e-mail vira opcional e, se vazio, recebe um endereço fictício; is_vendedor é forçado para 1; o e-mail de definição de senha é desativado.

Restauração de usuário excluído

Se já existiu um usuário com o mesmo e-mail e ele foi excluído (soft delete), o cadastro restaura o registro antigo em vez de criar um novo, atualizando nome, telefone, status e senha aleatória. Os dados históricos vinculados ao ID original são preservados.

Sem perfis internos cadastrados

Se você ainda não tem nenhum perfil com is_external=false, o bloco Perfil de Acesso mostra um estado vazio com o link Criar perfil de acesso. Você precisa criar pelo menos um perfil antes de seguir, já que o campo é obrigatório.

Erros comuns e como resolver

• "O nome é obrigatório." - Causa: campo Nome em branco. Solução: preencha o nome completo.
• "O e-mail é obrigatório." - Causa: e-mail em branco no fluxo padrão. Solução: informe um e-mail válido, ou ative Cadastrar como Vendedor Externo se o usuário não precisa de login.
• "Informe um e-mail válido." - Causa: formato de e-mail incorreto. Solução: ajuste para o padrão [email protected].
• "Este e-mail já está em uso." - Causa: outro usuário ativo (não excluído) já tem esse e-mail na sua empresa. Solução: confirme se a pessoa já existe em Sistema > Usuários e edite o registro existente; se foi excluído antes, o cadastro restaura automaticamente.
• "Selecione pelo menos um perfil." ou "Selecione um perfil válido." - Causa: nenhum cartão de perfil foi marcado no bloco Perfil de Acesso. Solução: marque pelo menos um perfil. Se não existir nenhum, use o link Criar perfil de acesso para cadastrá-lo antes.

Onde encontrar

• URL: /admin/usuarios/create
• Caminho no menu: Sistema > Usuários > Novo Usuário
• Permissão necessária: criar os usuários
• Módulo necessário: nenhum

Veja também

• Gestão de Usuários do Sistema
• Editar e Desativar Usuários
• Gerenciar Papéis e Permissões