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.