Antes de começar, veja a página "
Introdução" para os pré-requisitos gerais do sistema e o passo a passo de login. Veja também a página "Usuários" — é lá que um Perfil de Acesso é efetivamente atribuído a uma pessoa. Em caso de dúvidas, consulte também o
FAQ.
Um Perfil de Acesso é um conjunto nomeado de Regras de Acesso, sempre vinculado a um único Módulo (Administração ou Convênios) e a um Tipo de Acesso (Interno ou Externo). É esse conjunto que, associado a um Usuário, define o que ele pode fazer no sistema.
-
Acesse Administração no menu lateral e clique em "Perfis de Acesso".
-
Filtre por Módulo, Tipo e Origem (Todos, Manual ou Automático), ou pesquise por Código/Descrição.

2.1. Perfis de origem Automático só existem via seed/migração — não é possível criar um perfil já marcado como Automático pela tela.
-
Na listagem, clique em "Inserir Perfil".
-
Preencha Código e Descrição (Campo Obrigatório), e opcionalmente Módulo e Tipo de Acesso (padrão Interno). Clique em "Salvar".

Obs: o Código precisa ser único em todo o sistema, não só dentro do Módulo escolhido — dois módulos diferentes não podem ter perfis com o mesmo código. Código e Descrição são sempre gravados em maiúsculas.
- No detalhe de um perfil, clique em "Editar" para alterar Código, Descrição, Módulo ou Tipo de Acesso.

Obs: o botão "Excluir" só aparece quando o perfil não tem nenhuma Regra de Acesso associada (e o perfil não é o "ADMINISTRADOR"). Mesmo assim, se esse perfil já tiver Usuários vinculados, a exclusão falha no servidor.
- No detalhe do perfil, a seção "Regras de Acesso" mostra as regras já Associadas e as Disponíveis para associação — sempre restritas ao mesmo Módulo do perfil.

- Marque uma ou mais regras em Disponíveis e clique em "Associar Selecionadas" — ou marque em Associadas e clique em "Desassociar Selecionadas" para remover.
Obs: não existe um estado "inativo" para uma regra associada — a única forma de tirar uma regra de um perfil é desassociá-la (excluir o vínculo).
| Regra | Descrição |
| RN60.2 | O combo de Módulo, usado ao inserir ou editar um Perfil de Acesso, lista todos os módulos cadastrados, ativos ou inativos — o Status do módulo não é usado como filtro. |
| RN63.1 | Unicidade de Código é global, não por Módulo — dois módulos diferentes não podem ter perfis com o mesmo código. |
| RN63.2 | Código e Descrição são normalizados (maiúsculas) na criação e na atualização. |
| RN63.3 | As regras de acesso disponíveis para associação a um perfil são restritas ao mesmo Módulo do perfil. |
| RN63.4 | Essa restrição de módulo (RN63.3) vale só para a listagem de opções mostrada na tela — o servidor não valida que a regra associada pertence ao mesmo módulo do perfil. |
| RN63.5 | Uma regra só pode ser associada se ainda não estiver, e só desassociada se já estiver. |
| RN63.6 | Toda associação nova nasce com status "Ativa" fixo; a única forma de "desligar" uma regra é a exclusão do vínculo. |
| RN63.7 | Excluir um Perfil só checa se ele existe — a proteção contra perfis com Usuários/Regras vinculados vem de restrição no banco, sem uma mensagem de negócio amigável nesse caso. |
| RN63.8 | O botão de excluir só some da tela se o perfil tiver regras associadas, não for o perfil "ADMINISTRADOR" e o usuário tiver a permissão certa — a checagem não considera vínculo com Usuários, então um perfil sem regras mas com usuários vinculados mostra o botão normalmente e a exclusão falha no servidor. |
| RN63.9 | Novos perfis criados pela tela nunca são marcados como "Automático" — perfis automáticos só existem via seed/migração. |
| RN63.10 | A trava do campo Código para o perfil "ADMINISTRADOR" na tela de edição não funciona — o campo aparece editável mesmo para esse perfil. |
| Campo | Descrição |
| Sistema | Harpia (Gestão 360) |
| Versão | 1.6 |
| Data de Atualização | 2026-10-15 |
| Responsável | Amanda Galvão |
| Público-alvo | usuários administradores responsáveis pelo controle de acesso do sistema |
| Objetivo | consultar, cadastrar, editar e associar Regras de Acesso a um Perfil de Acesso |
| Tipo | Documento de referência / treinamento |
| Versão | Data | Descrição da Alteração | Responsável pela Aprovação |
| 1.6 | 2026-10-15 | Adicionado o bloco "Veja Também" com links para os guias relacionados e o card correspondente no Sumário | Amanda Galvão |
| 1.5 | 2026-10-05 | Ajustes no Design de Interface e Experiência do Usuário. | Amanda Galvão |
| 1.4 | 2026-09-25 | Sincronizadas as Regras de Negócio Relacionadas com o catálogo (adicionadas RN60.2 e RN63.4) | Amanda Galvão |
| 1.3 | 2026-09-24 | Corrigido o link do Sumário para "Regras de Negócio Relacionadas" (o anchor não deveria ter o prefixo "h-", pois o heading não começa com dígito) | Amanda Galvão |
| 1.2 | 2026-09-22 | Alteração de texto. | Amanda Galvão |
| 1.1 | 2026-09-22 | Removida a nota sobre a trava do campo Código e o screenshot duplicado do perfil ADMINISTRADOR | Amanda Galvão |
| 1.0 | 2026-09-22 | Versão inicial da documentação | Amanda Galvão |