Um dicionário de dados descreve cada campo que uma solução guarda, para que o negócio, os desenvolvedores e os testadores entendam a mesma coisa por "valor do sinistro". Para cada campo, ele registra:
- Nome e uma definição simples ("claim_amount: o valor que o segurado pede para receber, antes de qualquer franquia").
- Tipo de dado: texto, número inteiro, decimal, data, sim ou não, ou uma lista de códigos (um conjunto fixo de valores permitidos).
- Formato e tamanho: YYYY-MM-DD, duas casas decimais, 12 caracteres.
- Se é obrigatório ou opcional, e qualquer regra de validação ("não pode estar no futuro").
- Origem e dono: de onde vem o valor e quem decide o que ele significa.
A armadilha em que muita gente cai: códigos que parecem números. Um número de apólice como 0048213 é texto, não número inteiro: guardado como número, ele perde o zero à esquerda, e ninguém nunca soma dois números de apólice. Se você nunca faria contas com ele, provavelmente é texto.
Parte de um dicionário de dados.