Antes do primeiro serviço de verdade entrar em produção, o Cervejeiros.Club precisava responder uma pergunta aparentemente banal: onde o código mora? A resposta tomou duas versões no mesmo dia — e a história da correção diz muito sobre como o projeto toma decisões.

A primeira versão — e por que durou horas

A primeira planta baixa agrupava tudo num condomínio vertical: todos os serviços morando em andares de um mesmo prédio, com a fundação administrando as chaves. Elegante no papel, estranho na prática — porque os sete serviços do sistema já tinham casas próprias em outro lugar, com endereços, portões e históricos independentes. Duplicar a moradia significava duplicar o trabalho e criar duas verdades sobre o mesmo serviço.

O operador revogou a decisão no mesmo dia. O que existia de código nas “casas do prédio” foi mudado para as casas de verdade, uma a uma, e a planta baixa foi refeita com uma regra simples:

flowchart TB R["Raiz do projeto:<br/>a fundação compartilhada"] --> C["Receitas comuns<br/>(padrões, conferências, ferramentas)"] R --> H1["Casa do rosto"] R --> H2["Casa das mãos"] R --> H3["Casa do cérebro"] R --> H4["Casa dos sentidos"] H1 -->|"mudou? comita<br/>na própria casa"| G["Arquivo central<br/>com histórico próprio"] H2 --> G H3 --> G H4 --> G C -->|"mudou a fundação?<br/>comita na raiz"| G

A regra do condomínio

  1. Cada serviço desenvolve na sua casa. A pasta do serviço na raiz do projeto é o endereço oficial do trabalho — não existe cópia paralela.
  2. A fundação é mínima por propósito. A raiz guarda só o que é comum a todos: as receitas de conferência, os padrões de estilo, as ferramentas compartilhadas. Nada de lógica de serviço vazando para o prédio.
  3. Mudou a casa, comita na casa; mudou a fundação, comita na raiz. E quando uma mudança de casa afeta a fundação, as duas portas recebem commit — a esteira de qualidade passou a exigir essa dobradiça.
  4. A régua revalidou tudo. Após a mudança, os 17 pontos do gate de qualidade passaram de novo — 17 de 17, do primeiro ao último.

Por que a fundação vem antes das paredes

Um sistema que diz “não” com frequência precisa de uma base onde a disciplina seja barata. A planta baixa é isso: quando cada serviço tem casa, endereço e histórico próprios, a responsabilidade é óbvia, a revisão é local e o rollback não derruba o vizinho. A memória de longo prazo e a memória de curto prazo do sistema nasceram dentro dessa organização — cada uma na casa do cofre.

A lição que ficouA melhor arquitetura não é a mais elegante — é a que respeita a realidade que já existe. As casas dos serviços já viviam na raiz do projeto, com histórico próprio e portões próprios; a planta baixa só precisou reconhecer isso, e não o contrário.

O que a planta baixa destrava

Com a fundação e as casas no lugar, o resto da obra encadeia: o portão de entrada já roteava para as casas, o fiscal automático passou a inspecionar todas elas a cada mudança, e o maestro das entregas lê as receitas de cada casa na hora de publicar. É a diferença entre uma cidade sem zoneamento e um condomínio com endereço, régua e histórico — a base que permite ao Cervejeiros.Club crescer sem virar um bairro sem lei.