KDV/ framework

Documentação / Práticas

Acordos de produto de dados

Explicite responsáveis, qualidade, compatibilidade e utilização.

Propósito

O contrato é um acordo de trabalho versionado entre quem produz, governa e consome um produto. Descreve a oferta, os destinatários, as finalidades e as expectativas. Um esquema de dados não estabelece por si só responsabilidade ou autorização. O modelo original KDV é legível por pessoas e não alega conformidade com ODCS ou outro padrão técnico.

Baseline mínimo

  • Identidade, versão, Hive, Cell e dono do produto
  • Propósito, consumidores e interfaces de entrega
  • Definições, esquema, origem e linhagem
  • Classificação, uso permitido, retenção e condições de acesso
  • Limites de qualidade, testes, atualização e contacto de incidentes
  • Compatibilidade, depreciação e registo de revisão e aprovação

Versão e compatibilidade

Acorde como distinguir alterações incompatíveis, acréscimos compatíveis e correções documentais. Avise os consumidores antes de substituir o acordo por uma versão incompatível. Preserve aprovações anteriores e um caminho de transição ou retirada. Pode adotar versionamento semântico, mas a equipa deve definir o efeito das alterações para os consumidores.

Exemplo sintético

Uma equipa fictícia de planeamento de serviços precisa de um agregado semanal de pedidos. O domínio do serviço responde pelo significado; uma equipa do subdomínio prepara os dados; o dono do produto acorda a atualização e os usos permitidos. A primeira entrega é um agregado interno, sem copiar registos identificáveis. A equipa guarda os resultados de qualidade e revê se o produto apoia a decisão pretendida.

Questões de revisão

  • Quem pode decidir e qual é o papel exercido?
  • Que regra ou acordo autoriza a ação?
  • Que evidências demonstram a execução e as suas limitações?
  • Quando serão revistos o resultado ou a exceção?

Continuar a leitura


Conhecimento original KDV Framework. Edição comunitária de trabalho 0.1. CC BY 4.0. Referenciais mantêm os direitos dos titulares; não implica avaliação oficial ou certificação.

GitHub · CC BY 4.0