Pular para o conteúdo principal

Gerenciamento de Grupos de Usuários

Bem-vindo ao guia de Gerenciamento de Grupos do CMS E-commerce! Este manual irá ajudá-lo a criar, gerenciar e organizar grupos de usuários no sistema.


Visão Geral

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

  • 👥 Organize usuários em grupos para facilitar o gerenciamento de permissões
  • Crie novos grupos com nome, descrição e status personalizados
  • 🔍 Filtre grupos por nome, descrição ou status (ativo/inativo)
  • ✏️ Edite informações de grupos existentes
  • 👤 Gerencie membros adicionando ou removendo usuários dos grupos
  • 🗑️ Exclua grupos quando não forem mais necessários

Esta ferramenta é essencial para organizar permissões e controlar o acesso de usuários às funcionalidades do sistema.


Acessando a Tela de Grupos

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

  • Título "Grupos"
  • Botão "Criar Grupo" (se você tiver permissão)
  • Barra de busca
  • Filtros (Status e Grupos por página)
  • Tabela com os grupos cadastrados

Tela de grupos


Como Criar um Novo Grupo

Passo 1: Clique em "Criar Grupo"

No canto superior direito da tela, clique no botão "Criar Grupo".

Botão Criar Grupo

Passo 2: Preencha as Informações do Grupo

Um modal será aberto solicitando as seguintes informações:

Nome *

  • Digite um nome descritivo para o grupo
  • Exemplo: "Administradores", "Gerentes de Estoque", "Atendimento"
  • Campo obrigatório

Descrição *

  • Descreva o propósito e as responsabilidades do grupo
  • Seja claro sobre quais tipos de usuários devem fazer parte deste grupo
  • Campo obrigatório

Status *

  • Ativo: O grupo está disponível para uso
  • Inativo: O grupo não pode ser utilizado (mas não é excluído)
  • Campo obrigatório

Modal de criação de grupo

Passo 3: Confirme a Criação

  1. Revise as informações preenchidas
  2. Clique em "Criar Grupo"
  3. Aguarde a confirmação (você verá "Criando...")
  4. Você será automaticamente redirecionado para a página de detalhes do grupo criado
Dica

Após criar o grupo, você pode imediatamente adicionar usuários a ele na tela de detalhes.


Como Buscar e Filtrar Grupos

Busca por Texto

A barra de busca permite encontrar grupos específicos por:

  • Nome do grupo
  • Descrição do grupo

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 grupos


Filtro por Status

Você pode filtrar grupos por status para visualizar apenas:

  • Ativos: Grupos disponíveis para uso
  • Inativos: Grupos desativados

Como filtrar:

  1. Clique no seletor "Status"
  2. Escolha o status desejado (Ativo ou Inativo)
  3. A tabela será atualizada automaticamente

Filtro de status

Para remover o filtro:

  • Clique no X ao lado do badge do status ativo
  • Ou selecione "Todos" no seletor

Grupos por Página

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

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

Seletor de grupos por página


Entendendo a Tabela de Grupos

A tabela de grupos exibe as seguintes informações:

Colunas da Tabela

ColunaDescrição
NomeNome do grupo
DescriçãoDescrição e propósito do grupo
StatusIndica se o grupo está ativo ou inativo

Indicadores Visuais de Status

Status Ativo:

  • 🟢 Badge verde com texto "Ativo"
  • Indica que o grupo está disponível para uso

Status Inativo:

  • ⚪ Badge cinza com texto "Inativo"
  • Indica que o grupo está desativado

Tabela de grupos com indicadores de status


Visualizando Detalhes de um Grupo

Para ver informações completas sobre um grupo:

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

Página de detalhes do grupo

Informações Disponíveis na Página de Detalhes

1. Cabeçalho

  • Nome do Grupo: Título principal
  • Descrição: Propósito do grupo
  • Badge de Status: Indicador visual do status (Ativo/Inativo)
  • Botão Deletar: Para excluir o grupo (se você tiver permissão)
  • Botão Voltar: Retorna à lista de grupos

2. Informações Gerais

Painel à esquerda contendo:

  • Nome do Grupo: Editável
  • Descrição: Editável
  • Status: Editável (Ativo/Inativo)
  • Botão Editar: Ativa o modo de edição

Painel de informações gerais

3. Gerenciamento

Painel à direita explicando as funcionalidades:

  • 📝 Informações do Grupo: Edite nome, descrição e status
  • 👥 Gerenciar Membros: Adicione ou remova usuários
  • 🗑️ Excluir Grupo: Remova permanentemente o grupo

Painel de informações gerenciamento

4. Membros do Grupo

Card mostrando todos os usuários associados ao grupo:

  • Contador de membros: Badge com total de usuários
  • Lista de usuários: Cards com nome e foto de perfil
  • Botão Adicionar: Para adicionar novos membros
  • Botão Remover: Em cada card de usuário
  • Paginação: Para navegar entre os membros (10 por página)

Seção de membros do grupo

5. Informações de Auditoria

Painel inferior contendo dados históricos:

Criação:

  • Criado por: Nome do usuário que criou o grupo
  • Data de criação: Data e hora da criação

Última Atualização (se houver):

  • Atualizado por: Nome do usuário que fez a última alteração
  • Data de atualização: Data e hora da última modificação

Informações de auditoria


Como Editar um Grupo

Passo 1: Ative o Modo de Edição

Na página de detalhes do grupo:

  1. Localize o painel "Informações Gerais"
  2. Clique no botão "Editar" no canto superior direito do painel

Botão Editar no painel de informações

Passo 2: Modifique as Informações

Os campos se tornarão editáveis:

  • Nome do Grupo: Campo de texto
  • Descrição: Campo de texto multilinha
  • Status: Seletor (Ativo/Inativo)

Campos em modo de edição

Passo 3: Salve ou Cancele

Após fazer as alterações:

Para Salvar:

  1. Clique no botão "Salvar" (com ícone de check)
  2. Aguarde a confirmação
  3. O modo de edição será desativado automaticamente

Para Cancelar:

  1. Clique no botão "Cancelar" (com ícone de X)
  2. As alterações serão descartadas
  3. Os valores originais serão restaurados

Botões Salvar e Cancelar

Atenção

Se você alterar o status de um grupo para "Inativo", as permissões associadas a este grupo podem ser afetadas. Certifique-se de que isso não causará problemas de acesso para os usuários.


Como Adicionar Usuários ao Grupo

Passo 1: Clique em "Adicionar"

Na página de detalhes do grupo:

  1. Localize o card "Membros do Grupo"
  2. Clique no botão "Adicionar" no canto superior direito do card

Botão Adicionar usuário

Passo 2: Busque o Usuário

Um modal será aberto com:

  • Barra de busca
  • Lista de usuários disponíveis (apenas usuários ativos que não estão no grupo)

Como buscar:

  1. Digite o nome, email ou username do usuário na barra de busca
  2. Pressione Enter para realizar a busca
  3. Os resultados serão filtrados automaticamente
  4. Clique no botão X na barra de busca para limpar a pesquisa

Modal de adicionar usuário

Passo 3: Selecione o Usuário

  1. Clique no card do usuário desejado
  2. O card ficará destacado em azul quando selecionado
  3. Cada card mostra:
    • Nome completo
    • Email
    • Username

Passo 4: Confirme a Adição

  1. Com o usuário selecionado, clique em "Adicionar"
  2. Aguarde a confirmação (você verá "Adicionando...")
  3. O modal será fechado automaticamente
  4. O usuário aparecerá na lista de membros do grupo
Informação

Apenas usuários com status "Ativo" podem ser adicionados a grupos. Usuários inativos não aparecerão na lista.


Como Remover Usuários do Grupo

Passo 1: Localize o Usuário

Na página de detalhes do grupo:

  1. Vá até o card "Membros do Grupo"
  2. Encontre o usuário que deseja remover
  3. Use a paginação se necessário (10 membros por página)

Passo 2: Clique em "Remover"

  1. No card do usuário, clique no botão "Remover" (com ícone de UserMinus)
  2. Um modal de confirmação será exibido

Card de usuário com botão Remover

Passo 3: Confirme a Remoção

O modal de confirmação mostrará:

  • Aviso: Nome do usuário que será removido
  • Alerta: Mensagem indicando que o usuário perderá todas as permissões associadas ao grupo

Modal de confirmação de remoção

Para confirmar:

  1. Clique no botão "Remover" (vermelho)
  2. Aguarde o processamento (você verá "Removendo...")
  3. O modal será fechado e o usuário será removido da lista

Para cancelar:

  1. Clique no botão "Cancelar"
  2. Nenhuma alteração será feita
Atenção

Ao remover um usuário do grupo, ele perderá TODAS as permissões associadas a este grupo. Certifique-se de que isso é o que você deseja fazer.


Como Excluir um Grupo

Passo 1: Acesse os Detalhes do Grupo

  1. Na tabela de grupos, clique no grupo que deseja excluir
  2. Você será redirecionado para a página de detalhes

Passo 2: Clique em "Deletar"

  1. No canto superior direito, clique no botão "Deletar" (vermelho)
  2. Um modal de confirmação será exibido

Botão Deletar grupo

Passo 3: Confirme a Exclusão

O modal de confirmação mostrará:

  • Título: "Confirmar exclusão"
  • Mensagem: Nome do grupo e aviso de que a ação não pode ser desfeita

Modal de confirmação de exclusão

Para confirmar:

  1. Clique no botão "Excluir" (vermelho)
  2. Aguarde o processamento (você verá "Excluindo...")
  3. Você será automaticamente redirecionado para a lista de grupos

Para cancelar:

  1. Clique no botão "Cancelar"
  2. Nenhuma alteração será feita
Importante

A exclusão de um grupo é permanente e NÃO pode ser desfeita. Certifique-se de que:

  • O grupo não possui usuários associados (ou remova-os antes)
  • O grupo não é mais necessário no sistema
  • Você tem autorização para realizar esta ação

Casos de Uso Práticos

1. Criar Estrutura de Permissões por Departamento

Situação: Você precisa organizar usuários por departamento.

Como fazer:

  1. Crie grupos para cada departamento: "Financeiro", "Estoque", "Vendas", "TI"
  2. Defina descrições claras sobre o propósito de cada grupo
  3. Adicione os usuários correspondentes a cada grupo
  4. Configure as permissões de acesso para cada grupo no sistema

2. Gerenciar Acesso Temporário

Situação: Um consultor precisa de acesso temporário ao sistema.

Como fazer:

  1. Crie um grupo chamado "Consultores Temporários"
  2. Defina permissões limitadas para este grupo
  3. Adicione o consultor ao grupo
  4. Quando o projeto terminar, remova o usuário do grupo ou desative o grupo

3. Reestruturar Equipe

Situação: Houve mudanças na estrutura da empresa.

Como fazer:

  1. Acesse os grupos afetados pela mudança
  2. Remova usuários que mudaram de função
  3. Adicione novos membros conforme a nova estrutura
  4. Atualize as descrições dos grupos se necessário
  5. Crie novos grupos para novas funções, se aplicável

4. Desativar Grupo Sazonalmente

Situação: Você tem um grupo usado apenas em determinadas épocas do ano.

Como fazer:

  1. Acesse o grupo em questão
  2. Clique em "Editar"
  3. Altere o status para "Inativo" quando não estiver em uso
  4. Quando a época retornar, altere o status de volta para "Ativo"
Dica

Desativar é melhor que excluir quando você pode precisar do grupo novamente no futuro.


5. Auditar Membros de um Grupo Crítico

Situação: Você precisa revisar quem tem acesso a funcionalidades sensíveis.

Como fazer:

  1. Acesse o grupo de alto privilégio (ex: "Administradores")
  2. Revise a lista de membros no card "Membros do Grupo"
  3. Use a paginação para ver todos os membros
  4. Remova usuários que não devem mais ter essas permissões
  5. Verifique as informações de auditoria para ver quem adicionou cada membro

Problemas Comuns e Soluções

❌ "Nenhum grupo encontrado com esse filtro"

Problema: A tabela está vazia após aplicar filtros ou busca.

Soluções:

  • Verifique se digitou o nome corretamente
  • Tente remover o filtro de status
  • Limpe a busca e tente novamente
  • Verifique se o grupo realmente existe no sistema

❌ Não consigo criar um grupo

Problema: O botão "Criar Grupo" não aparece ou está desabilitado.

Possíveis causas:

  • Você não tem permissão para criar grupos
  • Entre em contato com um administrador para solicitar acesso
  • Verifique se você está logado corretamente

❌ Não consigo editar informações do grupo

Problema: O botão "Editar" não aparece.

Possíveis causas:

  • Você não tem permissão para editar grupos
  • O grupo pode ter restrições especiais
  • Entre em contato com um administrador

❌ Não vejo alguns usuários ao tentar adicionar ao grupo

Problema: Usuários específicos não aparecem na lista de adição.

Possíveis causas:

  • Os usuários já estão no grupo
  • Os usuários têm status "Inativo"
  • Use a barra de busca para encontrar o usuário específico
  • Verifique na tela de Controle de Acesso se o usuário existe e está ativo

❌ Erro ao remover usuário do grupo

Problema: Mensagem de erro ao tentar remover um membro.

Possíveis causas:

  • Problemas de conexão com o servidor
  • Tente novamente em alguns instantes
  • Se o problema persistir, contate o suporte técnico

❌ Não consigo excluir um grupo

Problema: Erro ao tentar deletar o grupo.

Possíveis causas:

  • O grupo pode ter usuários associados (remova-os primeiro)
  • O grupo pode ter dependências no sistema
  • Você pode não ter permissão para excluir grupos
  • Tente primeiro desativar o grupo ao invés de excluí-lo

Boas Práticas

📋 Organização de Grupos

  1. Use nomes descritivos: "Gerentes de Loja" é melhor que "Grupo 1"
  2. Escreva descrições completas: Facilita entender o propósito do grupo no futuro
  3. Crie grupos por função, não por pessoa: Evite "Grupo do Pedro" - prefira "Supervisores de Vendas"
  4. Mantenha a estrutura simples: Não crie grupos demais - isso dificulta a gestão

👥 Gestão de Membros

  1. Revise membros regularmente: Remova usuários que mudaram de função
  2. Documente mudanças importantes: Mantenha registro de grandes alterações
  3. Use grupos existentes: Antes de criar um novo, veja se já existe um adequado
  4. Evite sobreposição excessiva: Um usuário não precisa estar em muitos grupos

🔒 Segurança

  1. Audite grupos críticos mensalmente: Especialmente grupos com altas permissões
  2. Remova acesso imediatamente: Quando um funcionário sair da empresa
  3. Use grupos específicos para dados sensíveis: Separe acessos por criticidade
  4. Prefira desativar a excluir: Mantém histórico de auditoria

🛠️ Manutenção

  1. Limpe grupos inativos anualmente: Exclua grupos que não são mais usados
  2. Atualize descrições: Quando o propósito do grupo mudar
  3. Mantenha consistência: Siga um padrão de nomenclatura
  4. Monitore grupos vazios: Grupos sem membros podem ser desnecessários

Perguntas Frequentes (FAQ)

Qual a diferença entre desativar e excluir um grupo?

Desativar: O grupo permanece no sistema, mas não pode ser usado. Você pode reativá-lo depois. O histórico e auditoria são mantidos.

Excluir: Remove permanentemente o grupo do sistema. Não pode ser desfeito. Use apenas quando tiver certeza absoluta.


Posso adicionar um usuário inativo a um grupo?

Não. Apenas usuários com status "Ativo" podem ser adicionados a grupos. Se precisar adicionar um usuário inativo, primeiro ative-o na tela de Usuários.


Um usuário pode estar em múltiplos grupos?

Sim. Um usuário pode fazer parte de vários grupos simultaneamente e terá a soma de todas as permissões dos grupos aos quais pertence.


O que acontece com os usuários quando um grupo é excluído?

Os usuários não são excluídos, mas perdem todas as permissões associadas àquele grupo. Eles permanecem no sistema e podem ser adicionados a outros grupos.


Posso recuperar um grupo excluído?

Não. A exclusão é permanente. Por isso é recomendado desativar ao invés de excluir, quando houver dúvida.


Quantos usuários posso adicionar a um grupo?

Não há limite definido. Você pode adicionar quantos usuários forem necessários.


As mudanças em grupos afetam usuários logados imediatamente?

As alterações nas informações dos grupos não afetam os usuários já logados. Agora, quando um usuário é adicionado ou removido de um grupo, os mesmo é deslogado automáticamente do sistema, por questão de segurança.


Posso ver quem adicionou um usuário a um grupo?

As informações de auditoria mostram quem criou o grupo e quem fez a última atualização, mas não rastreiam individualmente cada adição de usuário ao grupo.


Atalhos e Dicas Rápidas

  • Enter na busca: Executa a pesquisa
  • Clique na linha: Abre detalhes do grupo
  • Clique no X dos badges: Remove filtro ativo
  • Paginação automática: Ao remover o último usuário de uma página

Glossário

TermoSignificado
GrupoConjunto de usuários com permissões comuns
MembroUsuário que faz parte de um grupo
Status AtivoGrupo disponível para uso e associação de usuários
Status InativoGrupo desativado, não disponível para novas associações
AssociarAdicionar um usuário a um grupo
Desassociar/RemoverRemover um usuário de um grupo
PermissõesDireitos de acesso a funcionalidades do sistema
AuditoriaRegistro de quem criou/modificou o grupo e quando

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
    • Nome do grupo (se aplicável)
    • Ação que você estava tentando realizar
    • Mensagem de erro exibida (se houver)

Informações Úteis ao Contatar o Suporte

Tenha em mãos:

  • Seu nome de usuário
  • Nome do grupo com problema
  • Prints de tela do erro
  • Descrição detalhada do que você tentou fazer
  • Horário aproximado em que o problema ocorreu

Próximos Passos

Após dominar o gerenciamento de grupos, você pode:

  • 🔒 Configurar permissões específicas para cada grupo
  • 👤 Gerenciar usuários individuais na tela de Controle de Acesso
  • 📊 Criar relatórios sobre a estrutura de permissões
  • 🔍 Auditar logs do sistema para monitorar atividades dos grupos

Bom uso do gerenciamento de grupos! 🚀