{"id":5989,"date":"2025-06-26T14:51:15","date_gmt":"2025-06-26T17:51:15","guid":{"rendered":"https:\/\/elemarjr.com\/livros\/arquiteturadesoftware\/?post_type=volume-4&p=5989"},"modified":"2025-07-24T10:01:18","modified_gmt":"2025-07-24T13:01:18","slug":"arquitetura-quantitativa-deixando-os-dados-guiarem-as-decisoes","status":"publish","type":"volume-4","link":"https:\/\/elemarjr.com\/livros\/arquiteturadesoftware\/volume-4\/arquitetura-quantitativa-deixando-os-dados-guiarem-as-decisoes\/","title":{"rendered":"Arquitetura Quantitativa: Deixando os Dados Guiarem as Decis\u00f5es"},"content":{"rendered":"

Em qualquer organiza\u00e7\u00e3o de software que atinja uma certa maturidade, uma verdade inconveniente emerge: sempre haver\u00e1 mais projetos, mais demandas e mais complexidade do que a capacidade dos arquitetos para acompanh\u00e1-los de perto. O arquiteto, muitas vezes visto como o guardi\u00e3o da qualidade t\u00e9cnica e da vis\u00e3o de longo prazo, torna-se um gargalo. Este dilema nos for\u00e7a a questionar nosso modo de opera\u00e7\u00e3o tradicional, que podemos chamar de <\/span>Arquitetura Qualitativa<\/b>.<\/span><\/p>\n

A abordagem qualitativa \u00e9 aquela do arquiteto-artes\u00e3o: imerso no dia a dia, participando de reuni\u00f5es, desenhando diagramas detalhados e inspecionando artefatos de forma manual. \u00c9 um trabalho de imenso valor, essencial para a concep\u00e7\u00e3o e o refinamento de sistemas complexos. No entanto, sua natureza artesanal a torna inerentemente pouco escal\u00e1vel. Em um cen\u00e1rio com dezenas de projetos simult\u00e2neos, \u00e9 simplesmente invi\u00e1vel manter esse n\u00edvel de envolvimento em todos eles. O resultado? Projetos cr\u00edticos seguem sem a devida supervis\u00e3o, a d\u00edvida t\u00e9cnica se acumula silenciosamente e a eros\u00e3o arquitetural se instala.<\/span><\/p>\n

A promessa da Intelig\u00eancia Artificial (IA) como uma copiloto para o arquiteto \u00e9 real, mas vem com uma condi\u00e7\u00e3o crucial: ela precisa de contexto. Sem dados concretos sobre nossos sistemas, equipes e processos, a IA nos oferece respostas gen\u00e9ricas, clich\u00eas arquiteturais que pouco ajudam a resolver nossos problemas espec\u00edficos. A verdadeira amplifica\u00e7\u00e3o do nosso trabalho s\u00f3 acontece quando aprendemos a alimentar a m\u00e1quina com os dados certos, transformando-a de uma enciclop\u00e9dia gen\u00e9rica em uma especialista no nosso dom\u00ednio.<\/span><\/p>\n

Este cap\u00edtulo \u00e9 um convite para essa transforma\u00e7\u00e3o. Propomos uma mudan\u00e7a de paradigma: de uma arquitetura baseada primariamente na intui\u00e7\u00e3o e na interven\u00e7\u00e3o manual para uma <\/span>Arquitetura Quantitativa<\/b>, onde os dados n\u00e3o apenas informam, mas guiam ativamente nossas decis\u00f5es. O objetivo n\u00e3o \u00e9 eliminar a an\u00e1lise qualitativa, mas sim torn\u00e1-la cir\u00fargica, direcionando nosso tempo e esfor\u00e7o para os pontos onde eles gerar\u00e3o o maior impacto. Aprenderemos a instrumentar nossos sistemas e processos para extrair m\u00e9tricas que revelem a sa\u00fade real da nossa engenharia, permitindo-nos atuar de forma proativa, e n\u00e3o reativa.<\/span><\/p>\n

Nossa jornada para nos tornarmos arquitetos orientados a dados come\u00e7a no lugar mais honesto e revelador de qualquer projeto de software: o reposit\u00f3rio de c\u00f3digo-fonte. \u00c9 l\u00e1 que a verdadeira hist\u00f3ria da nossa organiza\u00e7\u00e3o \u00e9 escrita, commit a commit, e \u00e9 l\u00e1 que come\u00e7aremos a ouvir o que ela tem a nos dizer.<\/span><\/p>\n

O Reposit\u00f3rio de C\u00f3digo como Fonte da Verdade<\/h2>\n

Para nos tornarmos arquitetos orientados a dados, precisamos de uma fonte de verdade que seja imune a vieses, pol\u00edticas organizacionais e \u00e0 falibilidade da mem\u00f3ria humana. Precisamos de um registro que conte a hist\u00f3ria real do nosso software, n\u00e3o a hist\u00f3ria que gostar\u00edamos de contar. Felizmente, essa fonte j\u00e1 existe e est\u00e1 ao nosso alcance: o reposit\u00f3rio de controle de vers\u00e3o. \u00c9 aqui que adotamos nosso primeiro princ\u00edpio fundamental: <\/span>“Follow the Code”<\/b> (Siga o C\u00f3digo). Em vez de seguir o dinheiro, como fazem os auditores financeiros, n\u00f3s, arquitetos, seguiremos o fluxo de altera\u00e7\u00f5es no c\u00f3digo para descobrir onde a verdadeira a\u00e7\u00e3o acontece.<\/span><\/p>\n

A Rede Social do Desenvolvedor<\/h4>\n

Pense no seu sistema de controle de vers\u00e3o, como o Git, n\u00e3o apenas como um arquivo de backups, mas como a rede social da sua equipe de engenharia. Cada <\/span>commit<\/span> \u00e9 uma postagem, uma declara\u00e7\u00e3o de trabalho conclu\u00eddo. As mensagens de commit s\u00e3o as legendas, revelando a inten\u00e7\u00e3o por tr\u00e1s da mudan\u00e7a. Os pull requests (ou merge requests) s\u00e3o os f\u00f3runs de discuss\u00e3o onde o trabalho \u00e9 revisado, criticado e aprimorado pelos colegas. O hist\u00f3rico de um arquivo \u00e9 sua linha do tempo, contando a hist\u00f3ria de sua evolu\u00e7\u00e3o, desde seu nascimento at\u00e9 suas mais recentes e complexas transforma\u00e7\u00f5es.<\/span><\/p>\n

Essa “rede social” \u00e9 a cr\u00f4nica mais honesta da sua organiza\u00e7\u00e3o. Ela revela quem s\u00e3o os colaboradores mais ativos, quais \u00e1reas do sistema recebem mais aten\u00e7\u00e3o, onde as discuss\u00f5es s\u00e3o mais acaloradas e, crucialmente, como a estrutura da sua organiza\u00e7\u00e3o se reflete na estrutura do seu c\u00f3digo. Ignorar essa riqueza de informa\u00e7\u00f5es \u00e9 como tentar entender uma sociedade ignorando sua linguagem e sua cultura.<\/span><\/p>\n

A Postura do “Dr. House”: Confie nos Dados, N\u00e3o Apenas nas Opini\u00f5es<\/h4>\n

Ao chegar em um novo projeto ou empresa, a tenta\u00e7\u00e3o \u00e9 agendar uma s\u00e9rie de reuni\u00f5es para perguntar \u00e0s equipes: “Onde est\u00e3o os pontos de dor?”. Embora valioso, esse m\u00e9todo sofre de um vi\u00e9s fundamental: as pessoas, mesmo com as melhores inten\u00e7\u00f5es, podem n\u00e3o ter a vis\u00e3o completa. As respostas ser\u00e3o influenciadas pela \u00faltima crise, por frustra\u00e7\u00f5es pessoais ou por uma compreens\u00e3o limitada do sistema como um todo. Como na famosa m\u00e1xima do Dr. House, “Everybody lies” (Todo mundo mente).<\/span><\/p>\n

O arquiteto quantitativo adota a postura do Dr. House: ele ouve os “sintomas” relatados pelas equipes, mas confia nos “exames” para fazer o diagn\u00f3stico. O reposit\u00f3rio \u00e9 seu laborat\u00f3rio. A an\u00e1lise do hist\u00f3rico de commits \u00e9 o seu exame de sangue, a tomografia que revela as anomalias, as inflama\u00e7\u00f5es e os pontos de estresse que podem n\u00e3o ser vis\u00edveis a olho nu. Antes de aceitar uma opini\u00e3o como fato, vamos verificar o que os dados nos dizem.<\/span><\/p>\n

Primeiros Passos Pr\u00e1ticos: Extraindo o Log de Commits<\/h4>\n

Para come\u00e7ar nossa investiga\u00e7\u00e3o, precisamos extrair os dados brutos. Nosso objetivo \u00e9 gerar um log estruturado dos commits, focando em um per\u00edodo de tempo relevante que capture a atividade recente do projeto. Uma janela de <\/span>tr\u00eas meses<\/b> \u00e9 um excelente ponto de partida, pois tende a refletir o estado atual do desenvolvimento, filtrando grandes refatora\u00e7\u00f5es estruturais do passado distante.<\/span><\/p>\n

Usando a linha de comando do Git, podemos construir uma consulta poderosa para extrair exatamente o que precisamos. A m\u00e1gica acontece ao combinar o comando <\/span>git log<\/span> com flags de formata\u00e7\u00e3o e estat\u00edsticas.<\/span><\/p>\n

O comando a seguir \u00e9 um exemplo robusto para extrair um log detalhado, incluindo os arquivos modificados em cada commit, e salv\u00e1-lo em um arquivo para an\u00e1lise posterior:<\/span><\/p>\n

git<\/span> log<\/span> --pretty=format:\"COMMIT|%H|%an|%ad|%s\"<\/span> --numstat<\/span> --since=\"3<\/span> months<\/span> ago\"<\/span> ><\/span> commit_log.txt<\/span><\/pre>\n
Vamos analisar cada parte deste comando:<\/span><\/p>\n