Usuários - Editar, Desativar e Excluir

O que é

Tela onde você ajusta um usuário já cadastrado do painel administrativo: muda nome, e-mail, telefone, troca o perfil de acesso, ativa/desativa a conta, dispara o e-mail de redefinição de senha e configura o usuário como vendedor (com código próprio). A exclusão definitiva e a ativação/desativação rápida ficam na listagem (/admin/usuarios), mas todas as alterações de dados acontecem aqui na edição.

Você normalmente chega nesta página quando um colaborador muda de função (e precisa de outro perfil), quando alguém esquece a senha (e você dispara o reset), quando alguém deixa a empresa (desativar ou excluir) ou quando precisa habilitar um usuário como vendedor para gerar links de vendas.

Como usar

1. Vá em Sistema > Usuários no sidebar (rota /admin/usuarios).
2. Localize o usuário na lista. Use a busca por nome/e-mail e os filtros de Status e Perfil para refinar.
3. Clique em Editar (no botão do rodapé do cartão, ou no item Editar do dropdown de ações).
4. Ajuste os campos conforme necessário:
   • Nome - obrigatório, exibido em listagens e nos e-mails.
   • E-mail - obrigatório (exceto modo Vendedor Externo). É o login do usuário. Precisa ser único entre usuários ativos.
   • Telefone - máscara (99) 99999-9999. Pode ser obrigatório dependendo da configuração de campos padrão.
   • Usuário ativo - toggle verde. Desligue para bloquear o login sem apagar o histórico.
   • Perfil de Acesso - uma ou mais opções. É obrigatório selecionar ao menos um perfil.
5. Clique em Salvar Alterações (botão azul fixo na barra do rodapé). Para salvar e seguir editando, use a seta ao lado e escolha Salvar e continuar editando.

Casos especiais

Trocar o perfil de acesso (papel)

Na seção Perfil de Acesso, marque/desmarque os checkboxes dos perfis desejados. O usuário precisa ficar com pelo menos um perfil selecionado, senão o formulário rejeita com "Selecione pelo menos um perfil." Após salvar, o cache de permissões é limpo automaticamente e a nova permissão vale no próximo carregamento de página do usuário.

Habilitar como vendedor (com código de vendas)

Na seção Configurações de Vendedor, ligue o toggle Habilitar como Vendedor. Se o usuário ainda não tem código, ele é gerado automaticamente ao salvar e aparece na caixa roxa abaixo do toggle, com botão Copiar. Esse código é usado no link "Meu Link de Vendas" para atribuir reservas a quem vendeu.

Modo Vendedor Externo

O cartão roxo/rosa no topo (Vendedor Externo) oculta e-mail, telefone, status, vendedor e perfis, deixando só o Nome editável. Ao salvar com esse toggle ligado:

• Atribui automaticamente o perfil Vendedor Externo (sem acesso ao admin).
• Marca Habilitar como Vendedor = sim.
• Mantém o usuário ativo.
• Não exige e-mail real (mantém o existente ou aceita vazio).

Use para parceiros que só precisam de link de vendas, sem login no painel.

Enviar e-mail de redefinição de senha

Na seção Senha de Acesso, clique no botão azul Enviar email de redefinição. O usuário recebe um link por e-mail para definir uma nova senha - você não digita a senha no formulário. Útil quando o usuário esqueceu ou quando você acabou de criar a conta sem definir senha inicial.

Desativar o usuário (sem excluir)

Duas formas:

• Na edição: desligue o toggle Usuário ativo e clique em Salvar Alterações.
• Na listagem (mais rápido): abra o dropdown de ações na linha do usuário e clique em Desativar (ou Ativar se já estiver inativo). Aplica imediatamente sem abrir a edição.

O usuário desativado não consegue mais logar, mas todo histórico (reservas vendidas, ações no log, etc.) é preservado.

Excluir definitivamente

Na listagem /admin/usuarios, clique no botão vermelho com ícone de lixeira na linha do usuário. A exclusão é via soft-delete (o registro fica marcado como apagado no banco e some das listas).

Se mais tarde você cadastrar um novo usuário com o mesmo e-mail do excluído, o sistema restaura o registro antigo em vez de criar um novo - isso preserva o histórico, mas reativa o cadastro com os dados novos.

Não é possível desativar/excluir você mesmo

O sistema bloqueia desativar ou excluir o próprio usuário logado. Você verá "Você não pode desativar seu próprio usuário." ou "Você não pode excluir seu próprio usuário." e a ação é cancelada. Peça a outro proprietário/gerente que faça por você.

Erros comuns e como resolver

• "O nome é obrigatório." - Causa: campo Nome vazio. Solução: preencha o nome completo.
• "O e-mail é obrigatório." - Causa: campo E-mail vazio fora do modo Vendedor Externo. Solução: informe um e-mail válido ou ative o toggle Vendedor Externo.
• "Informe um e-mail válido." - Causa: formato inválido (sem @, domínio incorreto). Solução: corrija o e-mail.
• "Este e-mail já está em uso." - Causa: outro usuário ativo já usa esse endereço. Solução: confirme se a pessoa não está cadastrada (use o filtro de busca na listagem); se for um cadastro antigo excluído, restaure-o ao recadastrar com o mesmo e-mail.
• "Selecione pelo menos um perfil." - Causa: nenhum checkbox marcado em Perfil de Acesso. Solução: marque ao menos um perfil ou ative o modo Vendedor Externo (atribui o perfil automaticamente).
• "Você não pode desativar seu próprio usuário." - Causa: tentou desativar o próprio cadastro a partir da listagem. Solução: peça a outro administrador para fazer.
• "Você não pode excluir seu próprio usuário." - Causa: tentou excluir o próprio cadastro. Solução: peça a outro administrador para fazer.

Onde encontrar

• URL: /admin/usuarios/{usuario}/edit
• Caminho no menu: Sistema > Usuários, depois Editar na linha do usuário
• Permissão necessária: editar os usuários (para alterar e disparar reset/toggle), excluir os usuários (para excluir)
• Módulo necessário: nenhum

Veja também

• Cadastrar Novo Usuário
• Gerenciar Papéis e Permissões
• Gestão de Usuários do Sistema
• Auditoria e Logs de Atividade