Ga naar hoofdinhoud

Casus WOZ

De Wet waardering onroerende zaken is een herkenbaar domein. Elke gemeente voert deze taken uit, en de meeste mensen weten — op hoofdlijnen — wat een WOZ-beschikking is. Dat maakt het een goede casus om mee te leren. Deze casus is dan ook gebruikt om uitgebreide voorbeelden met maken rondom de principes uit de handreiking Uit betrouwbare bron. Je vindt hier geen abstracte architectuurschema's, maar uitgewerkte voorbeelden: van het registreren van een nieuw object tot het versturen van een formele beschikking.

Eerst leggen we de keuzes in het domeinmodel uit. Welke taakgebieden onderscheiden we, waar liggen de grenzen, en hoe communiceren de bounded contexts met elkaar? Die keuzes zijn niet vanzelfsprekend — ze vragen om een bewuste afweging. Je leest erover op de pagina bounded contexten.

De voorbeelden zijn gegroepeerd in thematische blokken. Elk voorbeeld kan ook op zichzelf gelezen worden, maar het is aan te raden om de logische volgorde te volgen — vooral als je de concepten achter bitemporale registers voor het eerst leert.


Conceptuele achtergrond

Voordat je aan de praktische voorbeelden begint, is het nuttig om de architectuurkeuzes te begrijpen.

Bounded Contexten

Het WOZ-domein bestaat uit meerdere bounded contexten: afgebakende deeldomeinen met elk hun eigen taal, model en verantwoordelijkheden.

  • WOZ Objectbeheer: registreert en beheert de objecten (percelen, gebouwen, appartementen)
  • Waardebepaling: stelt de WOZ-waarde vast op basis van marktgegevens
  • Heffing OZB: berekent de onroerendezaakbelasting op basis van de vastgestelde waarde
  • Beschikking en aanslag: communiceert de besluiten naar de burger

Lees meer over deze contexten in Bounded contexten in het WOZ-domein.

Contextovergangen

De meest in het oog springende contextovergang is die tussen de externe bronnen (BRK, BAG) en WOZ Objectbeheer. De vertaling van externe notificaties naar interne commando's is een bewuste architectuurkeuze die we de Bounded Context Bridge noemen.

Lees meer over dit patroon in Bounded Context Bridge.


Technische achtergrond

De voorbeelden bouwen voort op de beproeving WOZ Axon Kotlin, waar je meer leest over:

  • De technologiestack (Axon Framework, Spring Boot, Kotlin)
  • De architectuurbeslissingen (CQRS, event sourcing)
  • De opzet van het systeem als geheel

Volgende stappen

  1. Lees de achtergronden als je de architectuurkeuzes nog niet goed genoeg kent
  2. Bekijk de registratievoorbeelden in WOZ Objectbeheer voor een fundament in de basisprocessen van WOZ objectbeheer en een eerste begrip in de technische concepten.
  3. Werk de complexere voorbeelden af voor inzicht in twijfel, onderzoek, correcties en het beeindigen van entiteiten voor meer diepgang over de complexe impact van deze mutaties op tijdlijnen.

Veel leesplezier en veel succes met het begrijpen van bitemporale registers!