Termo

Fonte da verdade

Info

Escrito originalmente em francês. Traduzido por IA — o sentido foi preservado, não a prosa.

Definição curta

Artefato designado como o que prevalece em caso de divergência entre várias representações de um mesmo objeto, e a partir do qual as outras são reconstruídas ou corrigidas.

Definição detalhada

A expressão vem dos sistemas de informação, onde single source of truth designa o local único em que um dado é armazenado, sendo que os outros locais guardam apenas cópias derivadas. Ali o sentido é estrito: a unicidade é uma propriedade de arquitetura, garantida pelo sistema.

Nos artigos deste blog, o termo é usado para artefatos e não para dados, e a unicidade é uma escolha de organização, não uma garantia técnica. Nada impede uma especificação de contradizer o repositório; designar o repositório como fonte da verdade diz apenas o que faremos com a contradição — corrigir a especificação, nunca o contrário.

Duas propriedades distintas costumam se confundir sob este termo. Prevalecer é uma posição: sabemos quem tem razão. Servir de fonte é uma capacidade: sabemos extrair dali os outros artefatos. Um objeto pode ter a posição sem a capacidade — era a situação do código enquanto ele continuava ilegível para quem produzia os documentos.

Uso no domínio

Usado para resolver um conflito entre dois artefatos sem reunir seus autores, e para definir o sentido de fabricação de uma cadeia de documentos de produto.

Sinônimos e variantes

"O que prevalece", "referência", "single source of truth" no seu uso de origem.

Não confundir com

  • Entregável — Entregável — produção formatada para um destinatário, orientada por construção. Uma fonte da verdade não é orientada para um público; um mesmo objeto pode, no entanto, ser as duas coisas, e é o caso do código.
  • Artefato intermediário — Artefato intermediário — documento produzido para fazer a informação circular dentro da organização, perecível e sem destinatário externo. Ele deriva de uma fonte da verdade, ele não é uma.
  • Feature flag — Feature flag — interruptor inscrito no código e ajustado fora dele, cujo estado decide qual de vários comportamentos é executado. Ele não concorre com a fonte da verdade: é o que a impede de decidir sozinha o que um cliente específico observa.
  • Arquivo (acervo) — conservação do que existiu. A fonte da verdade diz o estado atual; o acervo diz um estado passado e não pretende prevalecer sobre o presente.

Exemplos

"O código não é mais apenas o entregável final: ele se torna o elemento central, a fonte da verdade em torno da qual gravitam e a partir da qual são reconstruídos os demais artefatos do produto."

Ambiguidades / debates

A palavra "verdade" faz acreditar numa exaustividade que não existe. O repositório prevalece sobre o que o produto faz e não diz nada sobre o que foi desejado nem sobre o que foi descartado. Uma organização pode, portanto, ter várias fontes da verdade sem contradição, se cada uma reinar sobre uma questão diferente — o que então tira do termo a unicidade de origem.