---
title: 'Papéis, capacidades e escopo'
slug: roles-capacidades-y-alcance
description: >-
  Referência funcional de perfis tenant, capacidades, escopos e
  responsabilidades no GovFrame.
audiencia: >-
  Administrador | Responsável pelos dados | Curador de dados | Engenheiro de
  dados | Superadministrador
roles: >-
  Administrador ou Superadministrador para configurar acessos; consulta para
  todos os perfis autenticados
modulo: Acessos e governança
estado: Comportamento atual validado
revision: '2026-10-19'
section: referencia
order: 10
sources:
  - 'Roles,capacidadesyalcance.md'
locale: pt-br
---
# Papéis, capacidades e escopo

O GovFrame separa três conceitos que costumam ser confundidos:

1. **Perfil tenant:** que tipo de responsabilidade a pessoa tem dentro de uma empresa.
2. **Capacidade:** que ação esse perfil pode executar.
3. **Escopo:** sobre quais Domínios ou Subdomínios pode exercê-la.

Um perfil, por si só, não concede acesso ilimitado. O backend verifica perfil, capacidade, tenant, estado da associação e escopo do objeto.

## Plano de plataforma e plano tenant

`platformRole` e o papel tenant são camadas distintas:

- O **Superadministrador** opera no plano global, pode selecionar uma empresa ativa e administrar configurações de plataforma permitidas.
- O **papel tenant** define a operação de governança dentro da empresa selecionada.
- A seleção global não permite cruzar empresas nem evita as verificações de módulo, associação, capacidade ou escopo em procedimentos tenant.
- A interface pode apresentar “Superadministrador · Administrador”, mas o texto combinado não transforma os dois campos em um único papel persistido.

## Papéis tenant atuais

| Perfil | Chave técnica | Responsabilidade | Capacidades básicas | Escopo habitual |
|---|---|---|---|---|
| **Usuário** | `user` | Consultar, comentar e participar de atividades de gestão autorizadas. | `stewardship.participate` | Conforme as visualizações e solicitações permitidas pelo tenant. |
| **Curador de dados** | `data_steward` | Manter definições e objetos de negócio, participar da curadoria e atender tarefas. | `stewardship.participate`, `business.manage`, `stewardship.manage` | Domínios/Subdomínios atribuídos. |
| **Responsável pelos dados** | `data_owner` | Ser responsável pela governança de seu escopo e aprovar decisões. | As do Curador de dados, mais `domain.manage` e `stewardship.approve`. | Domínios/Subdomínios atribuídos; pode ser global quando aplicável. |
| **Engenheiro de dados** | `data_engineer` | Administrar conectores, repositórios, metadados, snapshots e agendas. | `stewardship.participate`, `technical.manage` | Repositórios atribuídos por meio de escopos técnicos. |
| **Administrador** | `admin` | Administrar pessoas, acessos, taxonomia, governança e configuração tenant. | `business.manage`, `domain.manage`, `taxonomy.manage`, `stewardship.manage`, `stewardship.approve`, `stewardship.participate`, `access.manage`, `technical.manage` | Global dentro do tenant ativo. |

## Capacidades atuais

| Capacidade | Permite principalmente |
|---|---|
| `business.manage` | Criar ou manter termos, regras, dicionário, ativos e outros objetos de negócio dentro do escopo. |
| `domain.manage` | Administrar objetos de domínio, produtos, contratos, políticas e operações que exigem responsabilidade pelo escopo. |
| `taxonomy.manage` | Criar, editar, associar e administrar a estrutura taxonômica, sujeita às salvaguardas do procedimento. |
| `stewardship.manage` | Manter classificações, certificações, comentários e tarefas de curadoria. |
| `stewardship.approve` | Aprovar decisões ou estados de curadoria e governança que assim o exijam. |
| `stewardship.participate` | Consultar e participar de tarefas ou fichas permitidas. |
| `access.manage` | Gerenciar acessos, usuários, associações, solicitações e provisionamento conforme a operação. |
| `technical.manage` | Gerenciar conectores, repositórios, varreduras, snapshots, metadados e agendas dentro do escopo técnico. |

A lista acima descreve capacidades do backend, não apenas botões da interface. Ocultar um botão nunca substitui a recusa no servidor.

## Escopo por Domínio e Subdomínio

Usuários não globais podem ter:

- um ou mais **escopos de Domínio**;
- um ou mais **escopos de Subdomínio**;
- validade e estado para cada atribuição;
- escopos técnicos independentes para Repositórios de dados do Engenheiro.

O sistema calcula o escopo a partir da sessão e do objeto. Não aceita `tenantId`, Domínio, Subdomínio ou usuário enviados pelo navegador como fonte de autorização.

Uma pessoa pode consultar mais objetos do que pode editar. Por exemplo, um Responsável pelos dados ou Curador de dados pode ter visibilidade de objetos do tenant, mas só pode criar, editar, associar ou aprovar dentro do Domínio/Subdomínio autorizado e com a capacidade exigida.

## Responsabilidades de governança

Além do papel da sessão, o catálogo pode registrar responsabilidades de governança:

- **Responsável pelos dados** e **Curador de dados** são atribuídos a nós taxonômicos e podem ser vinculados a Entidades.
- Um Papel de governança é um objeto de catálogo; não deve ser confundido com o papel técnico de `tenant_memberships`.
- Um Produto ou Contrato pode referenciar um papel de Responsável pelos dados.
- Um Workflow pode exigir um papel básico ou um papel de governança configurado pela empresa.

## O que a empresa pode personalizar

A empresa pode personalizar responsabilidades e operações sem transformar o modelo de segurança em um sistema arbitrário de permissões:

- criar e manter objetos de `governanceRoles`;
- definir papéis adicionais de Workflow por meio de `workflowRoleDefinitions`;
- atribuir Responsável pelos dados/Curador de dados a nós taxonômicos;
- atribuir Domínios, Subdomínios e Repositórios a pessoas;
- configurar módulos, configurações regionais, estados e parâmetros de Workflow.

Os cinco perfis básicos e suas capacidades do backend são um contrato atual. A interface não oferece edição livre de cada capacidade por usuário. Se, no futuro, forem habilitados papéis totalmente configuráveis, isso deverá ser documentado como uma alteração de contrato e testado no backend.

## Regras de visibilidade e edição

1. O tenant efetivo é obtido da sessão, do hostname e da associação.
2. Uma associação desativada ou uma empresa suspensa não deve operar normalmente.
3. Um módulo desativado oculta a funcionalidade e seus roteadores rejeitam a operação.
4. Responsáveis pelos dados e Curadores de dados podem consultar de acordo com a política vigente, mas suas ações de gravação são limitadas ao escopo atribuído.
5. O Engenheiro de dados opera somente sobre Repositórios com escopo técnico ativo.
6. O Superadministrador usa procedimentos de plataforma para a administração global; ao atuar sobre objetos tenant, as salvaguardas do procedimento permanecem vigentes.

## Conteúdo relacionado

- [Modelo de objetos e relações](/pt-br/explicaciones/modelo-de-objetos-y-relaciones/)
- [Módulos e dependências](/pt-br/referencia/modulos-y-dependencias/)
- [Configurar pessoas, papéis e escopo](/pt-br/administrar-empresa/personas-y-alcance/)
- [Segurança e privacidade](/pt-br/seguridad/seguridad-y-sesiones/)