← Todos os textos

Conheça seus Geebos

Nesta página

Vamos falar dos Geebos: Generic Business Objects (GBOs).

Todo produto tem os seus. São os substantivos do seu sistema.
Num app de tarefas simplíssimo: Usuário → Lista → Tarefa. Esse é o seu conjunto de geebos.

Acertar isso cedo não é questão de vida ou morte, mas o tempo que você queima em reengenharia cresce com a ambiguidade dessas relações. Estudos colocam manutenção e evolução em ≈70–90 % do custo ao longo da vida1, então geebos vagos são literalmente dinheiro jogado fora.

Os times continuam complicando demais: renomeando no meio do caminho, abstraindo cedo demais, se enfiando em casos extremos. IA generativa e geradores de schema aceleram o trabalho braçal (a McKinsey mediu ≈2× de ganho em tarefas comuns2), mas o modelo continua sendo responsabilidade das pessoas.

Princípios que mantêm o caos longe

  1. Comece pelo consumidor e trabalhe de trás para frente
    Modele primeiro o que sua UI / API realmente precisa.

  2. Mantenha a camada de dados chata
    Tabelas ou documentos simples vencem uma esperteza elegante que você vai acabar refatorando.

  3. Espelhe a API no modelo de dados (a menos que a DX exija mesmo um BFF)
    Consistência melhora a produtividade e a adoção entre desenvolvedores3.

  4. Só adicione complexidade onde ela agrega valor
    Abstrações precisam pagar aluguel desde o primeiro dia.

  5. Dê o nome uma vez e nunca mais mude
    Identificadores são ~70 % dos caracteres do código-fonte4, e mudar nome toda hora mata a compreensão.

Quando abstrações cedo ajudam

Lidando com uma pilha de serviços de terceiros? Copie de uma API bem arquitetada (pense na Stripe). Aponte um LLM para as especificações OpenAPI dos fornecedores, peça um subconjunto unificado e deixe esse subconjunto virar o seu geebo. Tudo interno mapeia para ele, e adaptadores finos traduzem para cada provedor. Uma linguagem comum limpa, zero mapeamentos Frankenstein feitos à mão.

Resumindo

Defina seus geebos.
Escreva-os.
Respeite-os.

Seu time e o você do futuro vão agradecer.

Footnotes

  1. Which Factors Affect Software Projects Maintenance Cost More? (Acta Inform Med, 2013) – reports 90 % of lifecycle cost falling in maintenance. https://pmc.ncbi.nlm.nih.gov/articles/PMC3610582/ ↩

  2. McKinsey Digital – Unleashing developer productivity with generative AI (June 2023). Finds up-to-2× speed gains on typical coding tasks. https://www.mckinsey.com/capabilities/mckinsey-digital/our-insights/unleashing-developer-productivity-with-generative-ai ↩

  3. Zuplo Blog – How to Improve API Design for Better Developer Productivity (Mar 2025). Links consistent API design to faster integration and happier devs. https://zuplo.com/blog/2025/03/21/improving-api-design-for-developer-productivity ↩

  4. Impermanent Identifiers: Enhanced Source Code Comprehension and Refactoring (arXiv 2406.09066, 2024) – notes identifiers make up ~70 % of source-code characters. https://arxiv.org/pdf/2406.09066 ↩