Acessar a tela de Grupos

O usuário acessa o menu Cadastro > Grupos. Ao abrir a tela, o sistema monta a lista de empresas do painel de filtros (as empresas vinculadas ao usuário logado, mais a opção “Geral” inserida no início da lista, representando os grupos sem empresa) e carrega a grade com os grupos já cadastrados.

Clicar em Novo

O usuário clica no botão Novo, disponível apenas para quem tem a permissão de novo grupo. O sistema abre o formulário de cadastro vazio.

Preencher o campo Nome

O usuário digita o nome do grupo, com até 200 caracteres. Este campo é obrigatório.

Preencher o campo Descrição

O usuário digita uma descrição explicando a finalidade do grupo. Este campo também é obrigatório.

Selecionar as empresas vinculadas (opcional)

O usuário marca, na lista de empresas exibida, uma ou mais empresas às quais o grupo deve ficar vinculado. A lista oferecida é composta pelas empresas vinculadas ao próprio usuário logado, já vindo com a empresa que é o contexto atual desse usuário marcada por padrão; o usuário pode desmarcá-la ou marcar outras. Se nenhuma empresa ficar marcada, o grupo é salvo como um grupo “Geral”, visível a todos os usuários do sistema.

Clicar em Salvar

O usuário clica no botão de salvar. Antes de enviar qualquer dado ao servidor, o sistema confere no próprio navegador se os campos Nome e Descrição estão preenchidos; se algum estiver vazio, o formulário não é enviado e o usuário precisa completar o preenchimento.

Validação do servidor

O sistema envia identificador, nome, descrição e lista de empresas ao servidor. O servidor confirma se já existe outro grupo com o mesmo nome informado; se existir, a gravação é recusada.

Confirmação da gravação

Se o servidor aceitar a gravação, o sistema exibe a notificação “Operação efetuada com sucesso.” e, ao fechar essa notificação, retorna o usuário para a listagem de grupos, mantendo os filtros que estavam aplicados antes de abrir o cadastro. Se o servidor recusar a gravação (por exemplo, por nome duplicado), o sistema exibe o texto do erro e mantém o formulário aberto com os dados já digitados, para o usuário corrigir e tentar novamente.

Reabrir o grupo salvo para vincular usuários

Depois que o grupo já existe, o usuário pode reabri-lo pela listagem (clicando em Editar ou dando duplo clique na linha) e clicar no botão “Usuários”, disponível apenas para grupos já salvos. O sistema abre um modal de vínculo de usuários.

Buscar um usuário no modal “Usuários”

Dentro do modal, o usuário digita, no campo de busca, o identificador ou o nome da pessoa que deseja vincular ao grupo. O sistema retorna apenas usuários ativos, que pertençam a pelo menos uma das empresas vinculadas ao grupo (ou a qualquer empresa, se o grupo for “Geral”).

Selecionar o usuário encontrado

Ao clicar em um usuário retornado pela busca, o sistema cria o vínculo automaticamente, sem pedir nenhuma confirmação. A grade do modal é recarregada, o campo de busca é limpo e é exibida a notificação “Operação efetuada com sucesso.”.

Descrição

Nome que identifica o grupo dentro do sistema. É por esse nome que os usuários reconhecem o grupo na listagem e em outras telas que fazem referência a ele.

Comportamento

O sistema não permite enviar o formulário sem esse campo preenchido, avisando o usuário antes mesmo de enviar os dados ao servidor. Ao salvar, o servidor verifica se já existe outro grupo com o mesmo nome (considerando todos os grupos do sistema, não apenas os de uma empresa); se existir, a gravação é recusada com a mensagem “Já existe um Grupo com o nome {nome informado}” e o formulário permanece aberto com os dados digitados.

Impacto

Aparece na coluna “Nome” da listagem de grupos e é o texto usado para localizar esse grupo em outras partes do sistema, como ao vinculá-lo a um plano de ação do módulo de Melhoria Contínua.

Descrição

Texto livre que explica a finalidade do grupo, complementando o Nome com mais detalhes sobre para que ele serve.

Comportamento

Assim como o campo Nome, o sistema não permite salvar o formulário sem esse campo preenchido.

Impacto

Aparece na coluna “Descrição” da listagem de grupos.

Descrição

Define a quais empresas o grupo fica vinculado. Se nenhuma empresa for marcada, o grupo se torna um grupo “Geral”, visível a todos os usuários do sistema.

Comportamento

No cadastro de um grupo novo, a lista de opções é composta pelas empresas vinculadas ao usuário logado, já vindo com a empresa que é o contexto atual desse usuário marcada por padrão. Na edição de um grupo já existente, essa mesma lista de empresas é recalculada, mas sem aplicar essa pré-marcação automática: a marcação exibida passa a refletir apenas as empresas que já estão realmente vinculadas ao grupo aberto, e não o contexto de quem está editando. Ao salvar, se a marcação corresponder à opção “Geral”, o sistema converte automaticamente para “nenhuma empresa vinculada”.

Impacto

Define diretamente quem consegue ver esse grupo na listagem (apenas usuários com acesso a todas as empresas marcadas aqui, ou qualquer usuário, se o grupo for “Geral”) e também restringe quais usuários podem ser buscados no modal de vínculo desse grupo.

Descrição

Filtro usado para restringir quais grupos aparecem na grade de listagem, conforme a empresa vinculada a cada grupo.

Comportamento

O painel de filtros vem recolhido por padrão. As opções disponíveis são as empresas vinculadas ao usuário logado, mais a opção “Geral” inserida no início da lista, representando os grupos sem nenhuma empresa vinculada. A seleção só passa a valer, recarregando a grade, quando o usuário clica no botão “Filtrar”; escolher a opção não recarrega a grade sozinho.

Impacto

Ao selecionar uma empresa específica, a grade passa a mostrar apenas os grupos vinculados a ela; ao selecionar a opção “Geral”, a grade mostra apenas os grupos sem nenhuma empresa vinculada.

Descrição

Usado para localizar um usuário e vinculá-lo ao grupo que está sendo editado. Só aparece disponível depois que o grupo já foi salvo pelo menos uma vez.

Comportamento

A busca considera o identificador do usuário quando o texto digitado é numérico, ou o nome do usuário (contendo o texto digitado, em qualquer posição) quando não é. Os resultados são restritos aos usuários ativos que pertençam a pelo menos uma das empresas vinculadas ao grupo em edição; quando o grupo é “Geral” (sem empresa vinculada), a busca deveria considerar usuários de todas as empresas, sem restrição. Existe, porém, uma situação já conhecida em que essa busca não retorna nenhum resultado para grupos “Geral”: se isso acontecer, trata-se de um comportamento identificado pela equipe técnica e deve ser reportado ao suporte. Ao clicar em um usuário retornado pela busca, o vínculo é criado automaticamente, sem pedir confirmação.

Impacto

O usuário selecionado passa a aparecer na grade do modal (colunas “Id Usuário” e “Nome do Usuário”) e passa a ter acesso a esse grupo.

Descrição

Identificador único do grupo, gerado automaticamente pelo sistema no momento do cadastro.

Comportamento

É a coluna usada como ordenação padrão da grade (do maior para o menor); também aparece na mensagem de confirmação exibida antes de excluir um grupo (“Você está prestes a remover o grupo: {id} – {nome}”).

Impacto

Nenhum impacto direto para o usuário além de identificar o registro; internamente é o valor que o sistema usa para diferenciar o cadastro de um grupo novo da edição de um já existente.

Descrição

Reflete o valor preenchido no campo Nome do formulário de cadastro do grupo.

Comportamento

Pode ser usada como critério de ordenação da grade, com os espaços nas pontas do texto desconsiderados na comparação.

Impacto

Nenhum além da própria exibição na listagem.

Descrição

Reflete o valor preenchido no campo Descrição do formulário de cadastro do grupo.

Comportamento

Pode ser usada como critério de ordenação da grade, com os espaços nas pontas do texto desconsiderados na comparação.

Impacto

Nenhum além da própria exibição na listagem.

Descrição

Identificador do usuário vinculado ao grupo.

Comportamento

É a coluna usada como ordenação padrão da grade do modal (do maior para o menor). A paginação desta grade acontece inteiramente dentro do navegador, sem nova busca ao servidor a cada página.

Impacto

Nenhum além da própria exibição no modal.

Descrição

Nome do usuário vinculado ao grupo.

Comportamento

Exibido ao lado do Id Usuário na grade do modal.

Impacto

Nenhum além da própria exibição no modal.

Conversão Automática do Grupo “Geral”

Quando o usuário deixa o formulário sem nenhuma empresa marcada (ou marca explicitamente a opção “Geral”), o sistema converte essa escolha, no momento de salvar, para “nenhuma empresa vinculada”. Na prática, isso significa que o grupo fica automaticamente visível a todos os usuários do sistema, sem exigir nenhuma configuração adicional.

Integração com Melhoria Contínua

Um grupo pode estar associado a planos de ação corretiva do módulo de Melhoria Contínua. Ao excluir um grupo, o sistema verifica, junto com os vínculos de usuário, também os vínculos desse grupo com planos de ação. A documentação de origem deixa claro que a exclusão é bloqueada quando existem usuários vinculados ao grupo, mas não deixa claro se um vínculo com plano de ação também impede a exclusão da mesma forma: [informação ambígua na documentação de origem, validar com analista responsável se vínculos com planos de ação da Melhoria Contínua também bloqueiam a exclusão de um grupo].

Grupo “Geral” sem Empresa Vinculada

Quando nenhuma empresa é marcada no formulário (ou a opção “Geral” é selecionada), o grupo é salvo sem vínculo a nenhuma empresa e passa a ser visível para todos os usuários do sistema, independentemente da empresa deles.

Visibilidade por Empresa na Listagem

Um grupo com uma ou mais empresas vinculadas só aparece na listagem de um usuário quando todas essas empresas estiverem entre as empresas às quais esse usuário tem acesso. Basta uma única empresa vinculada fora do alcance do usuário para que o grupo inteiro deixe de aparecer para ele. Grupos “Gerais” aparecem sempre, para todos os usuários.

Filtro de Empresa Restringe Ainda Mais a Visibilidade

Ao selecionar uma empresa específica no filtro Empresa da listagem, apenas grupos vinculados a essa empresa aparecem; ao selecionar a opção “Geral”, apenas grupos sem nenhuma empresa vinculada aparecem.

Nome do Grupo Precisa ser Único

Não é permitido cadastrar ou renomear um grupo para um nome já usado por outro grupo, mesmo que esse outro grupo pertença a uma empresa diferente. A tentativa é recusada com a mensagem “Já existe um Grupo com o nome {nome informado}” e a gravação não é concluída.

Campos Obrigatórios do Formulário

Os campos Nome (até 200 caracteres) e Descrição precisam estar preenchidos para que o formulário possa ser enviado; essa verificação acontece no próprio navegador, antes de qualquer tentativa de salvar no servidor.

Exclusão Bloqueada com Usuários Vinculados

Um grupo não pode ser excluído se houver algum usuário vinculado a ele. A tentativa é recusada com a mensagem “Não é possível excluir este grupo, pois existem usuários vinculados a ele.”. É necessário desvincular todos os usuários pelo modal “Usuários” do próprio grupo antes de conseguir excluí-lo.

Exclusão de Grupo Já Removido

Se o grupo que o usuário tenta excluir já tiver sido removido por outra pessoa, a exclusão é recusada com a mensagem “401 >> grupo não encontrado, ou dados inválidos para esta operação.”.

Vínculo de Usuário Não Pode ser Duplicado

Um mesmo usuário não pode ser vinculado duas vezes ao mesmo grupo; a tentativa é recusada com a mensagem “400 >> Grupo já cadastrado neste usuário.”.

Remoção de Vínculo Exige Existência

Só é possível remover um vínculo entre usuário e grupo se esse vínculo ainda existir; se ele já tiver sido removido por outra pessoa, a tentativa é recusada com a mensagem “401 >> Relação usuário x grupo não encontrada.”.

Edição de Grupo Excluído por Outro

Se, entre a abertura da tela de edição e o clique em salvar, o grupo tiver sido excluído por outra pessoa, a gravação é recusada com a mensagem “401 >> Grupo não encontrado.”.

Restrição para Perfil Fiscal

Usuários com o perfil fiscal não têm acesso à tela de Grupos: não conseguem visualizar a listagem, nem cadastrar, editar ou excluir grupos.

Permissões Específicas por Ação

Visualizar a listagem, cadastrar um grupo novo, editar um grupo existente e excluir um grupo são ações controladas por quatro permissões diferentes e independentes entre si; um usuário pode ter acesso liberado para algumas dessas ações e não para outras, dependendo do que foi configurado no seu perfil de acesso.

Busca Restrita às Empresas do Grupo

No modal “Usuários”, só é possível buscar e vincular usuários que pertençam a pelo menos uma das empresas vinculadas ao grupo (ou usuários de qualquer empresa, se o grupo for “Geral”), e apenas usuários ativos.

Limitação Conhecida em Grupos “Geral”

Existe uma situação já identificada em que a busca de usuário no modal “Usuários” de um grupo “Geral” (sem empresa vinculada) não retorna nenhum resultado, mesmo havendo usuários ativos no sistema. Caso isso ocorra, trata-se de um comportamento conhecido pela equipe técnica, e deve ser reportado ao suporte.

Pré-seleção Apenas no Cadastro Novo

Ao cadastrar um grupo novo, a empresa que é o contexto atual do usuário logado já vem marcada, como sugestão, na lista de empresas do formulário. Ao editar um grupo já existente, essa pré-seleção automática não é aplicada: a marcação exibida passa a refletir somente as empresas efetivamente vinculadas ao grupo, e não o contexto de quem está editando.

Registro de Responsável por Alteração

O sistema grava automaticamente qual usuário (pelo e-mail) cadastrou, editou ou excluiu um grupo, e qual usuário vinculou individualmente um usuário a um grupo. Já a remoção de um vínculo entre usuário e grupo, e o vínculo de vários grupos de uma só vez (recurso usado por outra tela do sistema), não gravam essa informação de responsável.