← Alle berichten

Ken je Geebo's

Op deze pagina

Laten we het hebben over Geebo’s, Generic Business Objects (GBO’s).

Elk product heeft ze. Het zijn de zelfstandige naamwoorden in je systeem.
Voor een doodsimpele to-do-app: User → List → Task. Dat is je geebo-set.

Ze vroeg goed krijgen is geen kwestie van leven en dood, maar de tijd die je kwijt bent aan herbouw schaalt mee met de vaagheid in die relaties. Onderzoek schat onderhoud en doorontwikkeling op ≈70–90 % van de kosten over de hele levensduur1, dus vage geebo’s zijn letterlijk weggegooid geld.

Teams maken het nog steeds te ingewikkeld: hernoemen halverwege, voorbarige abstracties, uitweiden over randgevallen. Gen-AI en schemagenerators versnellen het hakwerk (McKinsey mat ≈2× winst bij gangbare taken2), maar mensen blijven eigenaar van het model.

Principes die de chaos op afstand houden

  1. Begin bij de afnemer en werk terug
    Modelleer eerst wat je UI of API echt nodig heeft.

  2. Houd de datalaag saai
    Simpele tabellen of documenten verslaan elegante slimmigheid die je uiteindelijk toch refactort.

  3. Laat de API de spiegel zijn van het datamodel (tenzij DX echt een BFF vraagt)
    Consistentie verhoogt de productiviteit van ontwikkelaars en de adoptie3.

  4. Voeg complexiteit alleen toe waar die waarde oplevert
    Abstracties moeten meteen huur betalen.

  5. Benoem dingen één keer, en daarna nooit meer
    Identifiers zijn ~70 % van de tekens in broncode4. Steeds wisselende namen vermoorden het begrip.

Wanneer vroege abstracties wel helpen

Heb je een stapel externe diensten om te temmen? Leen dan van een goed ontworpen API (denk aan Stripe). Wijs een LLM naar de OpenAPI-specs van de leveranciers, laat hem een gedeelde subset bouwen en laat die subset jouw geebo worden. Alles intern verwijst ernaar. Dunne adapters vertalen naar elke aanbieder. Een schone gemeenschappelijke taal, zonder zelfgebouwde Frankenstein-mappings.

TL;DR

Definieer je geebo’s.
Schrijf ze op.
Respecteer ze.

Je team en je toekomstige zelf zullen je dankbaar zijn.

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 ↩