Pular para o conteúdo principal

Gerenciamento de Usuários do Sistema

Bem-vindo ao guia de Gerenciamento de Usuários do CMS E-commerce! Este manual irá ajudá-lo a visualizar, criar, editar e gerenciar todos os usuários do sistema.

Visão Geral​

A tela de Gerenciamento de Usuários permite que você:

  • 👥 Visualize todos os usuários cadastrados no sistema
  • 🔍 Busque usuários por nome, username ou email
  • ➕ Crie novos usuários com informações completas
  • ✏️ Edite usuários existentes e atualize seus dados
  • 📊 Filtre usuários por status (Ativo/Inativo)
  • 👁️ Visualize detalhes completos de cada usuário
  • 👨‍👩‍👧‍👦 Veja os grupos aos quais cada usuário pertence

Esta ferramenta é essencial para gerenciar o acesso ao sistema e manter os dados dos usuários atualizados.

Acessando a Tela de Usuários​

A tela de usuários está localizada no menu de Administração do sistema. Ao acessá-la, você verá:

  • Título "Usuários"
  • Subtítulo "Gerencie os usuários do sistema"
  • Botão "Criar Usuário"
  • Barra de busca
  • Filtros (Status e Usuários por página)
  • Tabela com os usuários cadastrados

Tela de usuários

Como Buscar Usuários​

Busca por Texto​

A barra de busca permite encontrar usuários específicos por:

Como usar:

  1. Digite o texto desejado no campo de busca
  2. Pressione Enter para realizar a busca
  3. Os resultados serão filtrados automaticamente

Barra de busca de usuários

Dica

Use termos específicos para resultados mais precisos. Por exemplo: "silva" para encontrar todos os usuários com "Silva" no nome.

Filtro por Status​

Você pode filtrar usuários pelo status:

  • ✅ Ativo: Usuários com acesso ativo ao sistema
  • ⚪ Inativo: Usuários sem acesso ao sistema

Como filtrar:

  1. Clique no seletor "Status"
  2. Escolha "Ativo" ou "Inativo"
  3. A tabela será atualizada automaticamente

Filtro de status

Para remover o filtro:

  • Selecione "Todos os status" no seletor

Entendendo a Tabela de Usuários​

A tabela de usuários exibe as seguintes informações:

Colunas da Tabela​

ColunaDescrição
NomeNome completo do usuário
UsernameNome de usuário utilizado para login
EmailEndereço de email do usuário
StatusStatus atual do usuário (Ativo ou Inativo)

Indicadores Visuais​

Status:

  • 🟢 Verde: Usuário ativo (pode acessar o sistema)
  • ⚪ Cinza: Usuário inativo (sem acesso ao sistema)

Tabela de usuários

Navegação:

  • Clique em qualquer linha da tabela para ver os detalhes completos do usuário

Como Criar um Novo Usuário​

Para criar um novo usuário no sistema:

Passo 1: Clique em "Criar Usuário"​

No canto superior direito da tela, clique no botão "Criar Usuário".

Botão Criar Usuário

Passo 2: Preencha as Informações de Acesso​

Um modal será aberto com um formulário dividido em três seções. Comece preenchendo as Informações de Acesso:

Campos obrigatórios:

  • Username *: Nome de usuário único para login
    • Exemplo: joao.silva
  • Email *: Endereço de email válido
  • Senha *: Mínimo de 8 caracteres
  • Confirmar Senha *: Deve ser idêntica à senha
  • Status *: Ativo ou Inativo

Formulário de criação - Informações de Acesso

Atenção

O username e o email devem ser únicos no sistema. O sistema exibirá um erro se já existirem.

Passo 3: Preencha as Informações Pessoais​

Na segunda seção, preencha os dados pessoais do usuário:

Campos obrigatórios:

  • Nome Completo *: Nome completo do usuário
    • Exemplo: João da Silva
  • Gênero *: Selecione uma opção
    • Masculino
    • Feminino
    • Outro
    • Prefiro não dizer

Campos opcionais:

  • Data de Nascimento: Formato DD/MM/AAAA
  • Telefone Fixo: Exemplo: (11) 9999-9999
  • Telefone Celular: Exemplo: (11) 99999-9999

Formulário de criação - Informações Pessoais

Passo 4: Preencha o Endereço​

Na terceira seção, preencha o endereço do usuário:

Campos obrigatórios:

  • CEP *: 8 dígitos sem formatação
    • Exemplo: 12345678
  • Rua *: Nome da rua
    • Exemplo: Rua das Flores
  • Número *: Número do endereço
    • Exemplo: 123
  • Complemento *: Complemento do endereço
    • Exemplo: Apto 101
  • Bairro *: Nome do bairro
    • Exemplo: Centro
  • Cidade *: Nome da cidade
    • Exemplo: São Paulo
  • Estado (UF) *: Sigla do estado (2 letras)
    • Exemplo: SP

Campos opcionais:

  • Código IBGE: Código IBGE da cidade
    • Exemplo: 3550308

Formulário de criação - Endereço

Passo 5: Confirme a Criação​

  1. Revise todos os dados preenchidos
  2. Clique no botão "Criar Usuário"
  3. Aguarde o processamento (você verá "Criando...")
  4. O modal será fechado automaticamente
  5. O novo usuário aparecerá na tabela

Botões de ação do formulário

Para cancelar:

  • Clique no botão "Cancelar" ou no X no canto superior direito do modal
Dica

Todos os campos marcados com * são obrigatórios. O botão "Criar Usuário" só será habilitado quando todos os campos obrigatórios estiverem preenchidos corretamente.

Visualizando Detalhes de um Usuário​

Para ver informações completas sobre um usuário:

  1. Clique em qualquer linha da tabela de usuários
  2. Você será redirecionado para a página de detalhes

Tela de detalhes do usuário

Informações Disponíveis na Tela de Detalhes​

1. Cabeçalho do Usuário​

No topo da página você verá:

  • Nome completo do usuário
  • Username do usuário
  • Badge de Status: Ativo (verde) ou Inativo (cinza)
  • Badge de 2FA: Aparece se o usuário tem autenticação de dois fatores ativa
  • Botão Atualizar: Para editar os dados do usuário
  • Botão Voltar: Para retornar à lista de usuários

Cabeçalho dos detalhes

2. Card de Informações Básicas​

Este card exibe:

Informações de Acesso:

  • Username
  • Email
  • Status (Ativo/Inativo)

Informações Pessoais:

  • Nome completo
  • Data de nascimento (se cadastrada)
  • Gênero
  • Telefone fixo (se cadastrado)
  • Telefone celular (se cadastrado)

Card de Informações Básicas

3. Card de Endereço​

Este card exibe todas as informações de endereço:

  • CEP
  • Rua
  • Número
  • Complemento (se cadastrado)
  • Bairro
  • Cidade
  • Estado
  • Código IBGE (se cadastrado)

Card de Endereço

4. Card de Grupos do Usuário​

Este card mostra todos os grupos aos quais o usuário pertence:

  • Contador de grupos: Badge com o número total de grupos
  • Lista de grupos: Nome de cada grupo
  • Navegação: Clique em um grupo para ver seus detalhes

Se o usuário não estiver em nenhum grupo, será exibida a mensagem: "Nenhum grupo associado".

Card de Grupos

5. Card de Informações de Auditoria​

Este card exibe informações de rastreamento:

Criação:

  • Data e hora de criação do usuário

Última Atualização:

  • Data e hora da última modificação (se houver)

Card de Auditoria

Como Editar um Usuário​

Para atualizar as informações de um usuário:

Passo 1: Acesse os Detalhes do Usuário​

  1. Clique na linha do usuário na tabela
  2. Você será levado à página de detalhes

Passo 2: Clique em "Atualizar"​

No canto superior direito, clique no botão "Atualizar".

Botão Atualizar

Passo 3: Edite as Informações​

Um modal será aberto com o formulário de edição, pré-preenchido com os dados atuais do usuário.

Modal de edição

Você pode editar:

Informações de Acesso:

  • Username
  • Email
  • Status
Informação

No formulário de edição, não é possível alterar a senha. Para redefinir a senha de um usuário, utilize a funcionalidade específica de redefinição de senha.

Informações Pessoais:

  • Nome completo
  • Data de nascimento
  • Gênero
  • Telefone fixo
  • Telefone celular

Endereço:

  • Todos os campos de endereço podem ser atualizados

Passo 4: Salve as Alterações​

  1. Faça as modificações necessárias
  2. Clique no botão "Salvar Alterações"
  3. Aguarde o processamento (você verá "Salvando...")
  4. O modal será fechado automaticamente
  5. Os dados serão atualizados na tela

Para cancelar:

  • Clique no botão "Cancelar" ou no X no canto superior direito do modal

Usuários por Página​

Para facilitar a navegação, você pode ajustar quantos usuários são exibidos por vez:

  1. Localize o seletor "Usuários por página"
  2. Escolha entre: 10, 15, 20, 25, 30 usuários por página
  3. Use a paginação no rodapé da tabela para navegar

Casos de Uso Práticos​

1. Criar um Novo Usuário para um Funcionário​

Situação: Um novo funcionário foi contratado e precisa de acesso ao sistema.

Como fazer:

  1. Clique em "Criar Usuário"
  2. Preencha as informações de acesso (username único, email corporativo, senha temporária)
  3. Preencha os dados pessoais e endereço
  4. Defina o status como "Ativo"
  5. Clique em "Criar Usuário"
  6. Informe o novo funcionário sobre suas credenciais de acesso

2. Desativar um Usuário​

Situação: Um funcionário saiu da empresa e não deve mais ter acesso ao sistema.

Como fazer:

  1. Busque o usuário pelo nome ou email
  2. Clique na linha do usuário
  3. Clique em "Atualizar"
  4. Altere o status para "Inativo"
  5. Clique em "Salvar Alterações"

3. Atualizar Dados de Contato​

Situação: Um usuário mudou de telefone ou endereço.

Como fazer:

  1. Busque o usuário
  2. Acesse os detalhes do usuário
  3. Clique em "Atualizar"
  4. Atualize os campos de telefone e/ou endereço
  5. Clique em "Salvar Alterações"

4. Verificar Grupos de um Usuário​

Situação: Você precisa saber a quais grupos um usuário pertence.

Como fazer:

  1. Busque o usuário
  2. Clique na linha do usuário para ver os detalhes
  3. Role até o card "Grupos do Usuário"
  4. Visualize todos os grupos e suas permissões
  5. Clique em um grupo para ver mais detalhes

5. Buscar Usuários Inativos​

Situação: Você precisa fazer uma auditoria de usuários inativos no sistema.

Como fazer:

  1. Clique no filtro "Status"
  2. Selecione "Inativo"
  3. A tabela exibirá apenas usuários inativos
  4. Exporte a lista ou faça as análises necessárias

Problemas Comuns e Soluções​

❌ "Username já existe"​

Problema: Ao criar um usuário, o sistema informa que o username já está em uso.

Soluções:

  • Escolha um username diferente
  • Verifique se já existe um usuário cadastrado com esse username
  • Use variações como: joao.silva2, j.silva, joaosilva

❌ "Email já cadastrado"​

Problema: O sistema informa que o email já está em uso.

Soluções:

  • Verifique se o usuário já não está cadastrado no sistema
  • Use um email alternativo
  • Entre em contato com o usuário que possui esse email

❌ "Senha e Confirmar Senha não coincidem"​

Problema: As senhas digitadas não são idênticas.

Soluções:

  • Digite a senha novamente com atenção
  • Copie e cole a senha em ambos os campos
  • Verifique se não há espaços extras

❌ "CEP inválido"​

Problema: O sistema não aceita o CEP digitado.

Soluções:

  • Digite apenas números (sem hífen ou pontos)
  • Verifique se o CEP tem exatamente 8 dígitos
  • Confirme se o CEP está correto

❌ Não vejo o botão "Criar Usuário"​

Problema: O botão não aparece na tela.

Explicação:

  • Você pode não ter permissão para criar usuários
  • Entre em contato com um administrador do sistema
  • Solicite as permissões necessárias

Entendendo os Status de Usuários​

Status: Ativo (1)​

Significado: O usuário tem acesso completo ao sistema.

Características:

  • Pode fazer login
  • Pode executar ações conforme suas permissões
  • Aparece como disponível para atribuições

Indicador visual: Badge verde com texto "Ativo"

Status: Inativo (0)​

Significado: O usuário não pode acessar o sistema.

Características:

  • Não pode fazer login
  • Login será bloqueado automaticamente
  • Histórico de ações é preservado
  • Pode ser reativado a qualquer momento

Indicador visual: Badge cinza com texto "Inativo"

Autenticação de Dois Fatores (2FA)​

Alguns usuários podem ter a autenticação de dois fatores ativada.

Identificação​

Na página de detalhes do usuário, você verá um badge "2FA Ativo" ao lado do status se a autenticação de dois fatores estiver habilitada.

Badge 2FA

O que é 2FA?​

A autenticação de dois fatores adiciona uma camada extra de segurança ao login:

  1. Usuário digita username e senha (primeiro fator)
  2. Sistema solicita um código temporário (segundo fator)
  3. Usuário fornece o código do aplicativo autenticador
  4. Acesso é liberado
Segurança

Recomendamos ativar 2FA para todos os usuários com acesso administrativo ou a dados sensíveis.

Campos Opcionais vs Obrigatórios​

Campos Obrigatórios (marcados com *)​

Informações de Acesso:

  • Username
  • Email
  • Senha (apenas na criação)
  • Confirmar Senha (apenas na criação)
  • Status

Informações Pessoais:

  • Nome Completo
  • Gênero

Endereço:

  • CEP
  • Rua
  • Número
  • Complemento
  • Bairro
  • Cidade
  • Estado (UF)

Campos Opcionais​

Informações Pessoais:

  • Data de Nascimento
  • Telefone Fixo
  • Telefone Celular

Endereço:

  • Código IBGE
Informação

Embora alguns campos sejam opcionais, recomendamos preencher o máximo de informações possível para facilitar a comunicação e a gestão dos usuários.

Validações de Campos​

O sistema aplica validações automáticas nos campos:

Username​

  • Deve ser único no sistema
  • Apenas letras, números, pontos e underscores
  • Não pode conter espaços

Email​

Senha​

  • Mínimo de 8 caracteres
  • Recomendado usar letras maiúsculas, minúsculas, números e símbolos

CEP​

  • Deve ter exatamente 8 dígitos
  • Apenas números

Estado (UF)​

  • Deve ter exatamente 2 letras
  • Exemplo: SP, RJ, MG

Telefones​

  • Aceita formatos variados
  • Recomendado: (XX) XXXXX-XXXX ou (XX) XXXX-XXXX

Dicas de Segurança e Boas Práticas​

🔒 Criação de Usuários​

  1. Use senhas fortes com pelo menos 8 caracteres
  2. Não compartilhe credenciais - cada pessoa deve ter seu próprio usuário
  3. Ative 2FA para usuários com acesso administrativo
  4. Revise permissões regularmente

📋 Gestão de Usuários​

  1. Desative usuários que não precisam mais de acesso
  2. Mantenha dados atualizados (email, telefone, endereço)
  3. Revise usuários inativos periodicamente
  4. Documente alterações importantes de permissões

👥 Organização​

  1. Use padrões para usernames (ex: nome.sobrenome)
  2. Use emails corporativos sempre que possível
  3. Organize usuários em grupos de acordo com suas funções
  4. Mantenha a nomenclatura consistente

🛡️ Auditoria​

  1. Monitore criação de novos usuários
  2. Revise alterações de status regularmente
  3. Verifique grupos atribuídos aos usuários
  4. Acompanhe usuários com 2FA desativado

Perguntas Frequentes (FAQ)​

Posso excluir um usuário?​

Não é possível excluir usuários, pois isso pode afetar o histórico de auditoria e logs do sistema. Em vez disso, desative o usuário alterando seu status para "Inativo".

Como resetar a senha de um usuário?​

O formulário de edição não permite alterar a senha. Use a funcionalidade específica de redefinição de senha ou entre em contato com o suporte técnico.

Quantos usuários posso cadastrar?​

Não há limite técnico definido no sistema. O número de usuários permitidos pode depender do seu plano ou licença.

O usuário pode alterar seus próprios dados?​

Depende das permissões configuradas. Geralmente, usuários podem alterar dados pessoais básicos, mas não podem modificar username, email ou status.

O que acontece quando desativo um usuário?​

O usuário não poderá mais fazer login no sistema, mas:

  • Seu histórico de ações é preservado
  • Ele continua aparecendo em logs e auditorias
  • Pode ser reativado a qualquer momento
  • Seus dados permanecem no sistema

Posso criar usuários em lote?​

A interface atual permite criar usuários individualmente. Para criação em lote, entre em contato com o suporte técnico.

Suporte​

Precisa de Ajuda?​

Se você encontrou algum problema ou tem dúvidas:

  1. Verifique este manual para soluções comuns
  2. Consulte a seção de Problemas Comuns acima
  3. Entre em contato com o suporte técnico com as seguintes informações:
    • Print da tela ou descrição do problema
    • Username do usuário (se aplicável)
    • Mensagens de erro exibidas
    • O que você estava tentando fazer

Informações Úteis ao Contatar o Suporte​

Tenha em mãos:

  • Seu nome de usuário
  • Username do usuário que está tendo problema
  • Descrição detalhada da situação
  • Prints de tela (se possível)

Glossário​

TermoSignificado
UsernameNome único usado para identificar o usuário no login
StatusEstado atual do usuário (Ativo = pode acessar, Inativo = bloqueado)
2FAAutenticação de Dois Fatores - segurança adicional no login
CEPCódigo de Endereçamento Postal - identifica o endereço
IBGEInstituto Brasileiro de Geografia e Estatística - código da cidade
UFUnidade Federativa - sigla do estado (2 letras)
BadgeIndicador visual colorido que mostra status ou informações importantes
ModalJanela que aparece sobre a tela principal para ações específicas
CardCaixa visual que agrupa informações relacionadas
AuditoriaRegistro de quando algo foi criado ou modificado e por quem

Próximos Passos​

Após dominar o gerenciamento de usuários, você pode:

  • 👥 Organizar usuários em grupos para facilitar a gestão de permissões
  • 🔐 Configurar regras de acesso específicas para cada usuário ou grupo
  • 📊 Gerar relatórios de usuários ativos e inativos
  • 🔍 Monitorar atividades dos usuários através dos logs de auditoria

Bom uso da ferramenta de gerenciamento de usuários! 🚀