Nada é dado como verdade por ter sido contado. Cada afirmação carrega de onde veio.
A falha mais perigosa de um sistema que escreve bem é o sucesso narrado: dizer que fez, com confiança e detalhe, sem ter feito. Não há aqui nenhuma proteção que dependa de acreditar. O que vale é o que ficou registado.
Cada dado diz de onde veio
Todo o valor que aparece nesta empresa traz uma etiqueta de origem, e ela viaja com o valor até ao ecrã:
- Real — medido ou recebido de uma fonte a sério.
- Inferido — calculado a partir de outra coisa.
- Presumido — um pressuposto assumido, escrito para poder ser corrigido.
- Sintético — produzido por um ensaio. Nunca conta como trabalho entregue.
- Simulado — a peça que faltava, marcada como tal.
Sem etiqueta de origem, um número de ensaio e um número de cliente têm o mesmo aspeto numa tabela, e a partir daí tudo o que se decide com aquela tabela está errado sem ninguém saber.
O registo não se reescreve
O registo é só de acrescentar. Corrigir um erro faz-se lançando o acontecimento inverso, nunca apagando o anterior — a auditoria fica a contar a história toda, incluindo o engano e a correção. Um registo que se pode limpar não prova nada, porque a única entrada que interessaria é sempre a que teria sido apagada.
Estados finais, sem palavras vagas
Um trabalho acaba num de cinco estados: concluído, falhado, sem orçamento, à espera de uma decisão tua, ou dependente de algo que não existe. Não há «em curso» eterno nem «quase pronto». Nenhum trabalho pode declarar-se bem-sucedido só porque a narrativa dele diz que correu bem.
O que isto te permite fazer
- Perguntar «isto foi mesmo feito?» e obter uma resposta que não é uma opinião.
- Ver quem decidiu o quê, quando, e com que informação disponível na altura.
- Distinguir num relance o que é resultado de cliente do que é ensaio.
- Mostrar a empresa a alguém de fora sem ter de pedir que confie em ti.
Onde isto é mesmo aplicado
- A origem de cada dado
policies/policy.provenance-transparency.md - O registo de acontecimentos
src/routes/company.audit.tsx
Este texto explica; aqueles ficheiros decidem. Se discordarem, é este texto que está errado.