1. Para que serve

O módulo Admin Perfis permite consultar perfis de acesso, criar perfis personalizados, atualizar suas informações e controlar o estado de cada perfil.

Perfis de sistema são identificados separadamente e não podem ser excluídos. Perfis personalizados podem ter suas permissões de acesso a fontes configuradas em nível de banco, tabela e coluna.

Lista Perfis de Acesso com busca, origem, páginas e ações
Figura 1 — Lista de perfis de acesso.

2. Consultar perfis

A listagem permite buscar por nome ou descrição e apresenta nome, descrição, origem/pertencimento e quantidade de páginas. O selo Sistema identifica perfis protegidos. Perfis de sistema são somente visualizados; perfis personalizados podem ser ativados ou desativados, editados e excluídos.

A coluna Origem / Pertence a indica se o perfil pertence à matriz ou a uma filial e, quando aplicável, informa as unidades que receberam uma cópia.

Quando não houver perfis, a tela informa a situação e oferece o caminho para criar o primeiro perfil.

3. Criar um perfil personalizado

  1. Clique em Novo Perfil.
  2. Informe o Nome do perfil.
  3. Preencha uma Descrição breve.
  4. Selecione as páginas disponíveis e configure o acesso a dados (fontes e grants).
  5. Clique em Salvar.
  6. Confira a mensagem de sucesso e o novo perfil na listagem.

O nome é obrigatório; a descrição é opcional. As páginas começam sem seleção e as permissões de dados podem ser definidas no próprio diálogo.

Diálogo Novo Perfil com nome, páginas e acesso a dados
Figura 2 — Criação de perfil personalizado.

4. Campos do perfil

Campo Descrição Obrigatório
Nome Identificação do perfil na aplicação. Sim
Descrição Resumo da finalidade do perfil. Não
Páginas disponíveis Rotas que o perfil poderá acessar; o backend continua validando as capacidades. Não

O perfil pode incluir páginas administrativas e de serviço, além de permissões detalhadas por fonte, tabela e coluna.

5. Editar ou visualizar um perfil

  1. Localize o perfil na lista.
  2. Clique em Editar para um perfil personalizado ou em Visualizar para um perfil de sistema.
  3. Revise o nome, a descrição e as páginas disponíveis.
  4. Ajuste os acessos detalhados quando aplicável.
  5. Clique em Salvar ou em Cancelar.

O nome de um perfil de sistema fica bloqueado para edição. O diálogo de edição também permite revisar páginas e grants de dados.

Diálogo Editar perfil com páginas e configuração de acesso a dados
Figura 3 — Edição de perfil e configuração de acesso a dados.

6. Configurar acesso a fontes

Ao editar um perfil existente, a área Configurar Acesso a Dados permite selecionar fontes estruturadas e não estruturadas.

  1. Marque a fonte que o perfil poderá acessar.
  2. Abra Tabelas para consultar as tabelas disponíveis.
  3. Use o campo Filtrar tabelas... quando necessário.
  4. Selecione tabelas específicas ou use Selecionar todas e Limpar.
  5. Abra Colunas para restringir o acesso a colunas determinadas.
  6. Use Todas ou Limpar para as colunas da tabela.
  7. Clique em Salvar no diálogo do perfil.

Colunas identificadas como PII podem ser sinalizadas na lista para apoiar a revisão do acesso. Fontes não estruturadas podem exibir a quantidade de documentos disponíveis.

7. Ativar ou desativar um perfil

Na listagem, selecione Desativar para interromper o acesso associado ao perfil ou Ativar para reabilitá-lo. A aplicação solicita confirmação antes de alterar o estado.

A confirmação informa que usuários com um perfil desativado não poderão acessar o sistema. Confirme somente após revisar o perfil selecionado.

8. Excluir um perfil personalizado

  1. Clique em Excluir na linha do perfil personalizado.
  2. Leia a confirmação apresentada.
  3. Confirme somente se tiver certeza da remoção.

Perfis de sistema não podem ser excluídos. Para perfis personalizados, a confirmação informa que a exclusão é permanente e não pode ser desfeita.

9. Cuidados com permissões

Conceda somente o acesso necessário para a função do perfil. A seleção de uma fonte, tabela ou coluna pode ampliar a quantidade de dados disponíveis aos usuários vinculados.

Revise antes de salvar

Confirme o perfil, as fontes, as tabelas e as colunas selecionadas antes de clicar em Salvar. Não use o nome ou a descrição do perfil para registrar senhas, tokens ou dados pessoais.

10. Principais fluxos

  • Criar: Novo Perfil → informar nome e descrição → configurar acessos → Criar Perfil.
  • Editar: localizar perfil → Editar → atualizar dados → Salvar.
  • Restringir dados: editar perfil → selecionar fonte → escolher tabelas e colunas → Salvar.
  • Alterar status: selecionar Ativar ou Desativar → revisar confirmação → confirmar.
  • Excluir: selecionar perfil personalizado → Excluir → revisar confirmação → confirmar.