Saltar para o conteúdo
BeryX
Voltar ao guia do aplicativo

Documentação do BeryX

Domínio

O scorecard de um domínio (data product): score agregado, issues abertas, SLA, conformidade, consumidores, datasets e membros. Usa-o para saber se o data product cumpre o SLA e as políticas e o que falta corrigir.

O que podes fazer

  • Ver o «Score do domínio» (média dos datasets, com a variação face a há 7 dias) e as «Issues abertas por severidade»; «Ver nas Atividades» abre as atividades filtradas por este domínio.
  • Declarar ou editar o «SLA» do data product e seguir o cumprimento diário em «Ver cumprimento».
  • Rever a «Readiness por caso de uso», a «Conformidade do data product» com as políticas efetivas, os «Consumidores» e a «Versão e ciclo de vida»; as equipas e os agentes consumidores e o changelog só aparecem a administradores.
  • Ver os «Consumidores registados» por tipo: os sistemas de IA e os exposures dbt que usam os datasets do domínio aparecem sozinhos, com o selo «derivado». Administradores e o owner do domínio registam um consumidor externo com o canal de notificação que recebe o aviso quando o SLA é violado com severidade crítica, e retiram os que registaram.
  • Em «Versão e ciclo de vida», ver o estado (rascunho, publicado ou descontinuado), a versão em vigor e as «Versões publicadas» com o resumo de cada uma. Administradores e o owner do domínio usam «Publicar versão»: primeiro veem as mudanças desde a última versão, marcadas como major (quebram o consumidor) ou minor, e só publicam ao confirmar. Num data product descontinuado, publicar volta a pô-lo em publicado com uma versão minor, mesmo sem outras mudanças.
  • Copiar os «Trust facts» com «Copiar JSON» ou «Copiar MCP», para colar num agente, catálogo ou ticket: só metadados, nunca dados.
  • Em «Partilha pública», ativar a montra do data product: um badge para o README («SLA 99,2 % · pronto para BI», com a cor da readiness) e uma página pública com o SLA, a readiness e o veredito de cada dataset. Administradores e o owner do domínio ativam, geram um link novo e revogam; quem vê o domínio vê o link e as vistas da página.
  • Acompanhar a qualidade dos metadados do domínio e percorrer os datasets, com o score e as issues abertas de cada um, e os membros.
  • Usar «Editar domínio» para mudar o nome, a descrição, os datasets e os membros. Declarar o SLA, editar o domínio e definir a meta dos metadados é para administradores e para o owner do domínio; mudar o owner e «Apagar domínio» só para administradores.

Ver também

English

Domain

The scorecard of a domain (data product): aggregate score, open issues, SLA, conformance, consumers, datasets and members. Use it to check whether the data product meets its SLA and policies and what still needs fixing.

What you can do

  • See the “Domain score” (average of its datasets, with the change versus 7 days ago) and “Open issues by severity”; “View in Activities” opens Activities filtered to this domain.
  • Declare or edit the data product's “SLA” and follow daily attainment with “View attainment”.
  • Review “Readiness by use case”, “Data product conformance” with the effective policies, “Consumers” and “Version and lifecycle”; consuming teams and agents and the changelog are only shown to administrators.
  • See the “Registered consumers” by kind: the AI systems and dbt exposures that use the domain's datasets appear on their own, marked “derived”. Administrators and the domain owner register an external consumer with the notification channel that gets a notice when the SLA is breached with critical severity, and remove the ones they registered.
  • In “Version and lifecycle”, see the status (draft, published or deprecated), the current version and the “Published versions” with each one's summary. Administrators and the domain owner use “Publish version”: they first see the changes since the last version, marked major (they break the consumer) or minor, and only publish once they confirm. On a deprecated data product, publishing puts it back to published with a minor version, even with no other changes.
  • Copy the “Trust facts” with “Copy JSON” or “Copy MCP” to paste into an agent, catalogue or ticket: metadata only, never data.
  • Under “Public sharing”, enable the data product showcase: a badge for the README (“SLA 99,2 % · pronto para BI”, coloured by readiness) and a public page with the SLA, readiness and each dataset's verdict. Administrators and the domain owner enable it, generate a new link and revoke it; anyone who sees the domain sees the link and the page views.
  • Track the domain's metadata quality and browse its datasets, each with its score and open issues, and its members.
  • Use “Edit domain” to change the name, description, datasets and members. Declaring the SLA, editing the domain and setting the metadata goal are for administrators and the domain owner; changing the owner and “Delete domain” are for administrators only.

See also