Modelo de objetos e relações

O GovFrame usa a taxonomia como espinha dorsal. A taxonomia organiza o contexto de negócio; os demais objetos se relacionam com um ou mais níveis para explicar o significado de um dado, quem é responsável por ele, onde está, como é controlado e como é publicado.

Esta página responde a duas perguntas:

1. Em que nível taxonômico cada objeto se relaciona?
2. Como os objetos de negócio, técnicos e operacionais se conectam entre si?

1. A taxonomia é o eixo de navegação

O tenant pode trabalhar com um destes modelos:

Taxonomia padrão:   Domínio → Entidade → Atributo
Taxonomia expandida: Domínio → Subdomínio → Entidade → Atributo

Um objeto pode ter uma associação direta com um nível ou chegar a ele por meio de uma relação derivada. Por exemplo, um Campo técnico aponta diretamente para um Atributo; o Domínio é obtido percorrendo Atributo → Entidade → (Subdomínio) → Domínio.

2. Regra de associação direta e herdada

• Direta: o registro armazena explicitamente o vínculo com o nível taxonômico. Exemplo: um Produto armazena domainId e, opcionalmente, subdomainId.
• Por componente: o vínculo é armazenado em uma relação reutilizável que permite associar um objeto a um ou mais nós. Exemplo: um Repositório pode ser associado a vários Domínios ou Subdomínios.
• Herdada: o sistema calcula o contexto a partir de um objeto filho. Exemplo: uma Regra de qualidade herda o Domínio e o Subdomínio do Atributo ao qual pertence.
• Derivada por composição: um Contrato pode chegar a Atributos, Regras, Campos e Termos por meio de suas tabelas de associação, embora seu escopo principal seja Domínio/Subdomínio.

A associação herdada não altera o nível original do objeto. Ela serve para filtros, autorização, navegação, cobertura e análise de impacto.

3. Matriz de objetos e níveis de relação

Riscos e controles: precisão do modelo atual

Na implementação atual, não existe um módulo de catálogo independente chamado Riscos ou Controles com tabelas próprias equivalentes às de Termos ou Regras. O controle é representado por combinações de objetos existentes, por exemplo:

• uma Regra de qualidade como controle técnico;
• uma Política/Procedimento como controle normativo;
• um Workflow, tarefa ou aprovação como controle operacional;
• uma Regra incluída em um Contrato como compromisso verificável;
• uma classificação, certificação ou tarefa de stewardship como acompanhamento.

A interface pode exibir riscos, alertas ou cobertura derivados do dashboard e de tarefas, mas esta documentação não os apresenta como um inventário independente até que esse módulo e seu contrato de dados existam.

4. Como o ecossistema se forma

O fluxo funcional típico é:

Taxonomia
  ↓
Responsáveis e escopo
  ↓
Termos de negócio ───────────────┐
  ↓                              │
Entidades e Atributos             │
  ↓                              │
Dicionário técnico ← Repositório ← Conector / fonte
  ↓
Regras de qualidade ────────────┐ │
  ↓                            │ │
Produto de dados ← Ativos ←────┘ │
  ↓                              │
Contrato de dados ← Termos, Atributos, Regras, Campos, Sistemas
  ↓
Workflows, solicitações, tarefas, aprovações e auditoria

Os KPIs e Objetivos atravessam o ecossistema: adotam um nível taxonômico primário e podem documentar sua fórmula, fonte de medição, controle, evidência, produto ou contrato por meio de vínculos tipados.

5. Como ler uma relação na interface

1. Comece pelo Domínio ou Subdomínio para entender o contexto e o escopo.
2. Avance até a Entidade e o Atributo para encontrar o significado preciso.
3. A partir de um Atributo, consulte as Regras de qualidade e os Campos do Dicionário técnico.
4. A partir do Campo, identifique o Repositório, o esquema, a tabela, a coluna e o Sistema, quando estiverem registrados.
5. Percorra Produtos e Contratos para entender o que é entregue, a quem e com quais compromissos.
6. Use Workflows, tarefas e solicitações para acompanhar decisões pendentes, alterações e acessos.

O Explorador de relações tem três perspectivas: Visão geral para descobrir, Impacto para analisar dependências e Detalhe técnico para acompanhar o vínculo entre a taxonomia e as fontes físicas. O guia de uso está em Como ler o mapa de relações.

6. Limites importantes

• Todas as relações são isoladas por empresa e devem respeitar o escopo do usuário.
• Os códigos técnicos identificam registros, mas os guias funcionais devem exibir nomes legíveis.
• Uma associação de alto nível não significa que todos os Campos de uma fonte estejam associados a todos os Atributos.
• Uma Regra de qualidade só gera SQL quando tem associações válidas a Campos físicos.
• Desativar um módulo oculta e bloqueia sua operação para o tenant, mas não exclui automaticamente seus dados.

Conteúdo relacionado

• Funções, capacidades e escopo
• Módulos e dependências
• Como ler o mapa de relações
• Índice oficial