Handreiking

De handreiking beschrijft hoe overheidsregisters zo ontworpen en gebouwd kunnen worden dat ze betrouwbaar, transparant en herstelbaar zijn. Ze is bedoeld voor ontwikkelaars en ontwerpers die werken aan capabele registers bij de overheid.

Twee vormen

De handreiking is beschikbaar in twee vormen:

Formele specificatie (ReSpec) – een doorlopend referentiedocument met formele documentstatus, bedoeld om naar te verwijzen of als standaard te implementeren.

Leesversie (deze site) – dezelfde inhoud, opgedeeld in navigeerbare hoofdstukken, voor wie de inhoud wil verkennen en begrijpen.

Deze handreiking gaat hand in hand met een scala aan voorbeelden uit verschillende domeinen. Deze voorbeelden helpen om de handreiking beter te ervaren, te begrijpen en dieper inzicht te verkrijgen. Daarnaast zijn deze voorbeelden daadwerkelijk gebouwd in code en dienen ze als inspiratie voor daadwerkelijke implementatie van betrouwbare registers gebouwd volgens de handreiking.

Breng je een bestaand referentiekader mee – bijvoorbeeld uit relationele databases of event sourcing? Dan is het de moeite waard om eerst een instapverhaal te lezen: die benoemen de aannames die dat referentiekader meebrengt en wijzen de weg naar de relevante hoofdstukken hieronder.

Hoofdstukken

Aanleiding en doel – Waarom deze handreiking er is: de overheid digitaliseert snel, maar het vermogen om overheidshandelen te begrijpen, controleren en fouten te herstellen houdt geen gelijke tred. Introduceert de 'happy flow' en 'crappy flow' en het begrip epistemische nederigheid.

Wat is een register? – Definitie van het begrip register, perspectieven op de scope en de architectuurlagen waarop de handreiking zich richt.

De overheid verkaveld – Hoe de overheid is opgedeeld in domeinen en bounded contexten, en wat er gebeurt bij contextovergangen.

Uitvoeringscontext van registers – De overheid als producent van gevolgen en consument van leveringen: signaal, taak, gevolg en levering.

De datalaag van de overheid – Tekortkomingen van bestaande registers, overheidsbrede ontwikkelingen, en de uitgangspunten voor deze handreiking.

Conceptueel registermodel – Het conceptuele model van een betrouwbaar register dat beschrijft welke functionaliteit zo'n register moet leveren en hoe die functionaliteit inwerkt op binnen het register bekende data-objecten.

Verdieping: Registerbreed – Verdieping van aspecten en handelingen met bijzonder belang voor de betrouwbaarheid van het register.

Verdieping: Gevolgenjournaal – Verdieping van aspecten en handelingen met bijzonder belang voor de betrouwbaarheid van het register in relatie tot het gevolgenjournaal.

Verdieping: Projecties – Verdieping van aspecten en handelingen met bijzonder belang voor de betrouwbaarheid van het register in relatie tot projecties.

Begrippenoverzicht – Alle begrippen uit de handreiking op een rij, per cluster gegroepeerd en met hun Engelse vertaling.