Como ler o mapa de relações

O Explorador de relações ajuda a responder a uma pergunta específica: como este conceito de negócio se conecta aos responsáveis, controles, fontes técnicas e produtos?

A taxonomia continua sendo o eixo. Não é um grafo livre em que todos os objetos aparecem no mesmo nível.

Antes de começar

• O módulo Explorador de relações deve estar ativo para a empresa.
• Só aparecem objetos do tenant e do escopo autorizado.
• O mapa parte do objeto selecionado ou de uma semente válida do tenant quando é aberto sem seleção.
• Atributos e campos são consultados progressivamente; não são carregados todos no primeiro nível.

A faixa de caminho é o seletor de contexto

O caminho superior funciona como o explorador de pastas do Windows:

Empresa / Domínio / Subdomínio / Entidade / Atributo / Repositório / Campo

• Cada segmento representa um nível disponível.
• Ao clicar em um segmento, você retorna a esse nível e os objetos relacionados daquele contexto são exibidos.
• Volver al nivel anterior sobe um nível sem perder a visualização atual.
• Limpiar selección retorna o mapa à semente geral.
• A mesma faixa mostra a profundidade, os filtros efetivos e a quantidade de objetos/relações.

O caminho não abre o inspetor automaticamente. Mudar de contexto serve para navegar; Detalhe abre as informações ampliadas somente quando solicitado.

Visão geral: entender o ecossistema

Use Visão geral quando ainda não souber qual relação está procurando.

1. Selecione um Domínio ou Subdomínio.
2. Examine a coluna taxonômica: Entidades e Atributos.
3. Observe as laterais: Termos, Regras, Repositórios, Sistemas, Produtos e Contratos.
4. Clique em um objeto para mudar o contexto do mapa.
5. Use o caminho superior para subir ou voltar a uma pasta conceitual anterior.

A Visão geral prioriza nomes e agrupamentos compreensíveis. Ela não tenta exibir todos os campos físicos de uma fonte.

Impacto: analisar um objeto escolhido

Impacto responde o que alimenta o objeto e o que pode ser afetado se ele mudar.

• Objeto analisado: selecionado pelo controle visível de objeto raiz.
• Upstream: origens ou elementos que alimentam o objeto.
• Downstream: produtos, contratos, regras, sistemas ou processos que dependem dele.
• Filtros de impacto: reduzem o resultado a categorias como Qualidade, Produtos, Contratos ou Sistemas.
• Profundidade: indica quantos saltos são percorridos a partir do objeto raiz.

Exemplo:

Atributo “Data de ingresso”
  ← Campo técnico em tabela acadêmica
  ← Repositório universitário
  → Regra de completude
  → Contrato de dados
  → Produto de dados

Se não houver um caminho upstream ou downstream real, a tela deve explicar essa ausência. Não deve inventar uma dependência pelo simples fato de os objetos compartilharem o mesmo Domínio.

Detalhe técnico: seguir a relação física

Detalhe técnico foi pensado para o Engenheiro de dados, o Curador de dados e o Responsável pelos dados que precisam verificar a rastreabilidade.

Coluna vertebral

O centro mantém uma hierarquia legível:

Domínio
  ↓
Subdomínio
  ↓
Entidade
  ↓
Atributo

Nas laterais aparecem os objetos relacionados:

Atributo ↔ Regra de qualidade
Atributo ↔ Campo do Dicionário técnico
Campo ↔ Repositório / esquema / tabela / coluna
Repositório ↔ Sistema

Uma Entidade ou um Repositório pode mostrar linhas internas de atributos ou campos. O cartão exibe inicialmente até oito linhas; +N e a rolagem interna permitem consultar o restante sem transformar todo o diagrama em quadros ilegíveis.

Como investigar um campo

1. Selecione a Entidade ou o Atributo no eixo central.
2. Procure o cartão de Repositório ou Dicionário técnico.
3. Verifique o nome da tabela e da coluna, o esquema, o tipo e o estado da associação.
4. Siga a linha até o Atributo taxonômico.
5. Abra Detalhe se precisar da tabela completa de campos, da origem ou da descrição.

O nome funcional do Atributo é exibido na interface. O código técnico fica reservado à persistência, à validação, à importação ou ao SQL gerado.

O que significa uma linha

Filtros e profundidade

Os filtros são aplicados ao contexto ativo, não ao tenant inteiro:

• A profundidade 1 mostra relações diretas.
• A profundidade 2 permite seguir um salto adicional.
• Arestas equivalentes são exibidas uma única vez.
• Filtros incompatíveis com a raiz são desabilitados para evitar um mapa vazio ou enganoso.
• Mudar de nível pelo caminho recalcula a profundidade e os filtros válidos.

Quando abrir Detalhe

Não abra o painel lateral a cada clique. Mantenha o canvas livre para navegar e use Detalhe quando quiser:

• ler a descrição, as responsabilidades e o estado;
• revisar todos os atributos ou campos;
• consultar associações técnicas e origem;
• abrir a ficha completa do objeto.

Problemas frequentes

O mapa parece vazio

Verifique se há um objeto raiz visível, se o módulo está ativo e se a profundidade e os filtros são compatíveis. O sistema mantém a raiz renderizada durante o carregamento e mostra um estado explicativo se não houver relações.

Uma tabela aparece, mas seus campos não

A tabela pode existir como Repositório sem que todos os seus campos estejam no Dicionário técnico ou associados a atributos. Abra Detalhe e verifique o estado de cada campo; não presuma que a relação com a tabela implica associação de colunas.

Aparecem duas linhas semelhantes

A interface deduplica relações equivalentes por par de objetos. Se duas linhas representarem relações semanticamente distintas, a legenda deverá diferenciá-las; se forem o mesmo vínculo, deverá ser exibida apenas uma.

Não consigo navegar para um nível anterior

Use o segmento correspondente do caminho superior ou Volver al nivel anterior. Limpar a seleção retorna à semente geral sem mudar de empresa.

Conteúdo relacionado

• Modelo de objetos e relações
• Papéis, capacidades e escopo
• Módulos e dependências

Resultado esperado

Você consegue distinguir uma associação de negócio de uma relação física registrada, navegar por Visão geral, Impacto e Detalhe técnico e reconhecer quando uma dependência ainda não está documentada.