Relacionamentos em resumo
A decisão de modelagem
| A coisa relacionada é | Modele como | Porque |
|---|---|---|
| Governada — uma entidade que você mantém | Um relacionamento | A entidade relacionada é dona dos próprios dados; cópias divergem |
| Não governada — sem registro mantido | Um atributo | Do contrário você inventa uma entidade que não governa |
Nunca ambos. Duas cópias de um fato divergem.
Resolução por chave natural
Sistemas de origem referenciam a outra ponta pelo que têm — um identificador fiscal, um número de conta — não por um identificador da plataforma.
A afirmação de cada origem é registrada como uma asserção por direito próprio, antes de qualquer vínculo ser feito. Essa separação é o que faz carregamento fora de ordem funcionar: a asserção registra o que a origem disse, tenha ou não a plataforma podido agir sobre isso.
Nada é chutado. Uma asserção que não pode ser resolvida sem ambiguidade espera em vez de escolher um candidato.
Estados
| Estado | Significado |
|---|---|
| Pendente | Destino ainda não encontrado; reprocessada conforme dados chegam |
| Resolvida | Existe uma aresta canônica |
| Ambígua | A chave correspondeu a vários candidatos |
| Conflitante | O destino resolveu, mas a aresta não pôde ser criada |
| Rejeitada | Um curador a rejeitou |
| Expirada | A origem parou de afirmar o fato |
Vigência
Relacionamentos carregam um período de vigência, então um vínculo que termina é encerrado, não excluído. Perguntar quem o detinha em março passado devolve a resposta certa.
A cardinalidade é avaliada dentro da janela, então um relacionamento de um por ponta pode legitimamente ter vários ocupantes históricos.
Um sinal que vale ler
Ambiguidade recorrente numa regra diz que a chave não é tão identificadora quanto se supôs. Corrija a regra em vez de decidir a mesma classe de caso repetidamente à mão.
A seguir
Última verificação no commit d3c2586b (2026-08-03)