Bygg bättre API:er med event-sourced domain models

De flesta utvecklare har hamnat i samma sits. Man tar över en stor kodbas, letar efter dokumentation och inser snabbt att den antingen saknas eller inte stämmer med hur systemet faktiskt fungerar. Affärslogiken ligger utspridd i olika filer, reglerna finns gömda i databasändringar och ingen vet riktigt längre vad systemet gör.

Event sourcing erbjuder ett annat sätt att tänka.

Varför event sourcing gör skillnad

Istället för att bara spara det aktuella läget i databasen, sparar man hela historiken av förändringar. Varje åtgärd blir ett oföränderligt event i en logg.

För dig som bygger molnappar, API:er eller microservices ger det här flera tydliga fördelar:

• Auditability – du får en komplett historik utan extra arbete
• Debugging – det går att följa exakt hur systemet hamnade i ett visst läge
• Scalability – skrivoperationer kan skiljas från läsoperationer
• Domain clarity – du tvingas förstå vad som faktiskt händer i verksamheten

Det svåra är att det kan kännas tungt att komma igång.

Domain modeling – det många missar

Innan man skriver kod behöver man kartlägga hur systemet ska fungera. Det handlar om att definiera vilka kommandon som triggar förändringar, vilka events som ska skickas och vilka regler som alltid ska gälla.

Det är den här typen av arbete som avgör om ett system kommer att hålla när det växer eller om det blir svårhanterligt. Och det bör dokumenteras så att hela teamet kan ta del av det.

Ett språk för att beskriva event-sourced arkitektur

Strukturerade modelleringsverktyg hjälper dig att uttryva arkitekturen på ett tydligt och maskinläsbart sätt. Du kan definiera:

• Aggregates – kärnan i affärsobjekten
• Events – fakta om vad som har hänt
• Commands – förfrågningar som leder till förändringar
• Read Models – vyer optimerade för frågor
• Process Managers – logik som samordnar mellan aggregates
• Context Mappings – hur olika delar av systemet kommunicerar

Det här blir levande dokumentation som kan versionshanteras och analyseras.

Verktyg som gör det enklare

Modern teknik gör det lättare att börja med event sourcing. Det finns verktyg som hjälper dig att skapa en modell från grunden eller att dokumentera ett gammalt system.

En av de mer intressanta utvecklingarna är att AI-verktyg kan hjälpa dig att skapa eller analysera modeller. Du kan till exempel ha en dialog med en LLM och få hjälp med att utkasta en modell eller analysera din befintliga kod.