Inleiding
Deze sectie bevat concrete, uitgewerkte code-casussen bij de handreiking Uit betrouwbare bron. Geen abstracte architectuurschema's, maar werkende implementaties die je kunt lezen, draaien en aanpassen.
Voor wie zijn deze voorbeelden?
Voor ontwikkelaars en ontwerpers die een overheidsregister bouwen of ontwerpen. Je kent de theorie — of je leest die parallel in de handreiking — en wil zien hoe die theorie eruitziet als je het in code uitdrukt.
Hoe zijn de voorbeelden georganiseerd?
De voorbeelden zijn uitgewerkt in diverse casussen. Hoe ver elk domein is uitgewerkt, is afhankelijk van welke voorbeelden we hebben willen uitwerken en willen laten zien. Elk voorbeeld heeft tags voor de verschillende aspecten uit de handreiking.
Een uitgebreide casus is de casus WOZ, de Wet waardering onroerende zaken. Deze casus is uitgewerkt van het domein naar bounded contexten en van notificaties en contextovergangen naar commandos naar gevolgen en projecties.
Hoe gebruik je de voorbeelden?
Niet als blauwdruk om blind te kopiëren. Elk register is anders; jouw domein heeft andere grenzen, andere taal, andere regels dan WOZ.
Gebruik de voorbeelden als vertrekpunt en referentie:
- Ze laten zien hoe je een bounded context afbakent en die keuze vastlegt.
- Ze laten zien hoe commando's en gevolgen eruitzien in werkende code.
- Ze laten zien hoe de scheiding tussen bijhouding en levering (CQRS) in de praktijk werkt.
- Ze laten zien waar een contextovergang plaatsvindt en hoe je die expliciet maakt.
Lees de handreiking en de casus naast elkaar. De handreiking legt uit waarom; de casus laat zien hoe.