Um caminho de escrita por entidade

O dado de medição da obra do hospital mora em três lugares e os três discordam: a planilha diz etapa fechada, o quadro do Monday diz etapa em execução e o faturamento já emitiu a medição cheia. Cena inventada para a didática deste curso. Este capítulo converte o mapa e a auditoria num modelo com um caminho de escrita por tabela.

Ninguém errou de propósito: o mesmo número foi digitado três vezes, por três pessoas, em três momentos diferentes. Cada digitação virou uma verdade local. A reunião de fechamento deixa de tratar da obra e passa a tratar de qual planilha está certa, com Rita Bevilacqua chamando Damião Fontes para arbitrar. Ele arbitra bem, e o defeito está aí: a empresa contratou uma pessoa como mecanismo de reconciliação.

Medição de obra é o workflow mais caro do mapa da Vinco, com 9,5 horas por semana cronometradas, três handoffs e duas digitações duplicadas. As duas digitações duplicadas são a causa mecânica da divergência, e automatizar uma tripla digitação apenas produz três verdades mais rápido.

A segunda das quatro regras do documento da Boom é literal: um caminho de escrita por entidade. O autor escreve que todo substantivo do negócio vira tabela, toda relação vira chave estrangeira e toda tabela tem exatamente um caminho de escrita. A justificativa aparece na mesma página, e é uma frase sobre confiança: no momento em que o dado mora em dois lugares, os dois discordam, e no momento em que discordam, o time para de confiar no sistema.

Repare no encadeamento, porque ele é a tese inteira. Duplicidade não produz erro de dado em primeiro lugar. Produz erro de decisão, porque obriga cada pessoa a escolher em qual cópia acreditar. Um sistema em que essa escolha existe já perdeu, mesmo com todas as cópias corretas por coincidência num determinado dia.

Olhe o grafo procurando registro solto. Não existe nenhum. Toda caixa tem pelo menos uma seta chegando ou saindo, e essa é a segunda regra do modelo de dados no documento da Boom: todo registro se conecta a alguma coisa. O autor escreve que nada flutua isolado, e propõe uma pergunta desconfortável para o que sobra: se um documento não pode ser amarrado a um cliente, a uma obra ou a um processo, pergunte por que você está guardando aquilo.

A pergunta é boa porque muda o assunto. Documento órfão não é problema de organização de pasta, é sintoma de processo que ninguém definiu. Na Vinco, o Drive tinha uma pasta chamada "diversos" com contratos assinados dentro. O modelo de dados não resolve isso automaticamente. Ele torna o problema visível no primeiro dia, porque não existe lugar no schema para pousar um contrato sem cliente.

A primeira regra é de dimensionamento, e é a que mais gente viola por excesso de zelo. Modele o negócio que você tem, mais um tamanho acima. O autor é específico sobre onde parar: projete para o dobro da receita e pare. Quem projeta para um futuro fantasioso de 50 vezes constrói um sistema inchado que ninguém entende, e ninguém entender é o mesmo que ninguém usar.

O custo do schema inchado não aparece no banco, aparece na tela e no treinamento. Cada entidade especulativa vira campo obrigatório que o time não sabe preencher, filtro que ninguém aplica e relatório que nasce vazio. E cada campo que o time não entende vira campo preenchido de qualquer jeito, o que devolve o dado sujo pela porta da frente, agora dentro do sistema novo.

Vamos resolver o caso da Vinco do começo ao fim. Cena inventada para a didática deste curso, com os números fixos que atravessam o curso todo. O ponto de partida já vem escrito: 19 workflows mapeados no passo 01, 58 horas por semana de trabalho manual cronometrado e um estoque de 11 ferramentas classificado no passo 02 em sete para absorver, três para manter e uma para matar.

Rita não inventa entidade. Ela lê os 19 workflows e sublinha os substantivos que aparecem como objeto de trabalho, aqueles que o time conta no plural. Medição de obra, o workflow de 9,5 horas por semana, entrega sozinho os substantivos obra, medição, boletim e fatura, e o workflow de compras entrega pedido, fornecedor e nota. Repetido para os 19, o exercício fecha em 23 entidades, dentro da faixa de 15 a 30 que o paper registra como contagem típica em agosto de 2026. Essa faixa é referência de um praticante e não norma: schema que fecha abaixo dela e cobre o negócio inteiro está certo do mesmo jeito.

As chaves saem do mesmo lugar, e é aqui que a leitura do mapa paga o investimento. Cada handoff cronometrado no passo 01 é uma relação entre dois substantivos que hoje é atravessada por uma pessoa. O handoff "medição aprovada volta para faturamento" é a chave estrangeira que liga medição a fatura. Os três handoffs do workflow de medição viram três relações explícitas. Somadas as relações de todos os workflows, e descontadas as repetidas, a Vinco fecha em 61 chaves estrangeiras, dentro da faixa de 40 a 80 do paper.

O caminho de escrita é a terceira coluna, e é a única que exige decisão em vez de leitura. Para todas as tabelas menos uma, Rita escreve "sistema". Para faturas, escreve outra coisa, porque a contabilidade da Vinco é terceirizada e o livro-razão fiscal continua lá.

A decisão da tabela de faturas merece parágrafo próprio, porque ela é a exceção que prova a regra. Manter a contabilidade como fonte da verdade não é abrir mão do caminho único: o caminho de escrita de faturas continua sendo exatamente um, só que ele é uma sincronização em mão única a partir do sistema contábil. O sistema novo lê e nunca escreve. Duplicar seria criar uma segunda verdade fiscal, que é a pior categoria de duplicidade possível.

O registro publicado no paper da Boom mostra a mesma decisão, na linha de invoices. É a única das cinco linhas do exemplo em que o sistema não é a fonte da verdade, e o documento sinaliza isso de propósito. Vale olhar o formato do registro, porque é ele que o capítulo seguinte transforma em portão.

Existe um teste de bancada que revela duplicidade antes de qualquer código, e ele cabe numa pergunta feita a cada linha do registro: se duas pessoas atualizarem este objeto na mesma manhã, por telas diferentes, quem ganha. Quando a resposta é imediata, o caminho é único. Quando alguém precisa pensar, existe um segundo portão aberto que ninguém declarou, e ele vai ser descoberto depois, num fechamento de mês, com cliente na linha.

O mesmo teste explica por que este capítulo precede a consolidação e a construção de agente. A quarta regra do documento da Boom diz que a IA lê o schema, nunca o silo, e o autor escreve que uma IA só consegue recuperar aquilo que uma ferramenta guarda. Um agente apontado para um modelo com duas verdades não fica confuso de maneira visível: ele responde com aprumo, escolhendo uma das cópias, e a resposta errada chega mais rápido que a certa chegava antes.

O registro de entidades não é documento de arquiteto trancado numa sala. Ele é preenchido lendo o mapa do passo 01 em voz alta com a pessoa que executa cada workflow, porque a versão do fundador e a versão do operador são geralmente dois processos diferentes, conforme o autor escreve. A pessoa que digita a medição três vezes sabe, sem vocabulário técnico, exatamente onde estão as duas digitações duplicadas.

O modelo para copiar é deliberadamente pobre em tecnologia. Ele não menciona banco, framework nem plataforma, porque a escolha de stack é decisão sua e vem depois do schema fechado. Um registro de entidades preenchido é portátil entre stacks; um schema desenhado dentro de uma ferramenta específica não é, e sai caro no dia em que a ferramenta muda de preço ou de dono.

Voltemos à reunião de fechamento da Vinco, a cena que abriu o capítulo. Com o registro fechado, aquela discussão deixa de existir por construção, não por disciplina. Medição tem um caminho de escrita, boletim e fatura leem a mesma linha e não existe mais uma segunda planilha com autoridade concorrente. Damião Fontes continua sendo a pessoa que mais conhece a operação, e passa a usar esse conhecimento para melhorar processo em vez de arbitrar divergência de digitação.

O ganho não é a economia das 9,5 horas por semana, que só se realiza depois da consolidação e da automação. O ganho desta semana é que a empresa passa a ter uma resposta única para cada pergunta de operação, e é essa unicidade que torna possível qualquer coisa que venha depois, agente de leitura incluído.