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.