Handleiding — Regiekamer-mockup (IBRO-proeftuin)

1. Wat is dit — en wat is het niet?

De mockup is een klikbare schets van hoe de toekomstige werkomgeving rond het Portaal en de Regiekamer eruit kan zien: de plek waar mutatiesignalen binnenkomen, beoordeeld worden en tot registratie in de IBRO leiden. De schermen zijn een gespreksvoorstel, gebaseerd op een analyse van bestaande gemeentelijke software (BAG-, BGT- en WOZ-pakketten) — géén ontwerpbesluit en géén werkende applicatie.

De plek in de keten (uit het programmaplan Mercator):

bronnen → PORTAAL → REGIEKAMER → IBRO-registratie → levering (LV's, API's)

Portaal = waar signalen en bronnen binnenkomen · Regiekamer = waar ze geschikt worden gemaakt voor registratie · IBRO = de registratie zelf.

Bijzonder aan deze versie: de werkvoorraad, het te beoordelen signaal en het besluitlog zijn geen verzonnen schermvulling meer, maar worden gegenereerd uit de échte event-store van de proeftuin (391 gebeurtenissen, waarvan 372 echte Noordereiland-objecten uit BGT/BAG). De groene banner bovenin het Werkvoorraad-scherm bevestigt dat.

2. In vijf minuten rondklikken (aanbevolen route)

Open het tabblad Portaal (menubalk bovenin). U ziet de instroom: losse triggers per herkomst (vergunningen, luchtfoto's, terugmeldingen, kwaliteitsqueries, metingen) — nog vóórdat er werk van gemaakt is. Onderaan staat een voorbeeld van hoe losse triggers worden gebundeld tot één werkpakket. Klik op die voorbeeldkaart.

U landt in de Werkvoorraad — het hart van de Regiekamer. Werk is geordend op gebied en zaak, niet per registratie (BAG/BGT/WOZ is hooguit een filter). Elk blok is één werkpakket. Let op de vier verschillende soorten: STP-uitval (rood), automatisch verwerkt (groen), terugmelding (oranje) en een afgerond sloopdossier.

Klik het bovenste pakket aan (Prins Hendrikkade, badge STP-uitval). U komt in Signaal beoordelen: de machine kon dit signaal niet automatisch afronden (betrouwbaarheid 64%, onder de drempel van 85%) en legt het vóór aan de mens. Bekijk links de drie deelsignalen — elk met eigen betrouwbaarheid én herkomst — en het machinevoorstel eronder.

Doorloop de beslisflow: kies eerst in het blok Afbakening voor Geometrie accepteren of Corrigeren op de kaart. Kies daarna rechts een beslissing — probeer eens Verwerpen: er verschijnt een verplicht fouttype-veld plus een verplichte toelichting. Sluit af met Vastleggen als gebeurtenis en lees de bevestigingsregel.

Open tot slot Objectcontext & besluitlog. Dit is de volledige context van één object (het scenario-nieuwbouwpand): kaart, kerngegevens, de tijdlijn met dubbele tijdas en het besluitlog — wie besloot wat, waarom en wanneer. Kijk in de tijdlijn naar versie 3: die is met terugwerkende kracht ingetrokken (✗) maar blijft zichtbaar. Niets verdwijnt ooit uit deze registratie.

Extra: wissel van rol met de keuzelijst rechtsboven in de zwarte balk. Als objectregisseur (regiekamer: biedt werkpakketten aan) ziet u onder elk pakket een andere statusregel dan als objectregistrator (verwerkt de pakketten). Zo wordt het rolonderscheid uit het rollen-document zichtbaar.

3. Scherm voor scherm

3.1 Portaal — instroom vóór bundeling

Het Portaal toont wat er binnenkomt, per herkomst, nog ongebundeld. Het punt van dit scherm: signalen worden pas werk nadat triage ze heeft geclusterd op gebied/zaak. Zo voorkomt de Regiekamer dat drie systemen hetzelfde object drie keer laten aanraken.

Element	Klikbaar?	Toelichting
Instroomrijen (vergunningen, luchtfoto's, …)	nog niet	Tonen soort, herkomst en aantal per 24 uur. Doorklikken naar losse triggers is een volgende stap in de mockup.
Voorbeeldkaart "bundeling Prins Hendrikkade"	ja	Springt naar de Werkvoorraad — illustreert de overgang instroom → werkpakket.

3.2 Werkvoorraad — geordend op gebied en zaak

Deze lijst is de spil van de Regiekamer: alles (uitval, terugmeldingen, signalen, afgeronde dossiers) staat in één afwerkbare lijst met behandelaar en aflopende termijn. De vier pakketten komen uit de echte event-store:

Pakket	Badge	Wat het demonstreert
Prins Hendrikkade 22–30	STP-uitval	Signaal met te lage betrouwbaarheid (64% < 85%): de machine legt het vóór aan de mens. Klik → Signaal beoordelen.
Maaskade 60–68	STP: auto-verwerkt	Signaal boven de drempel (91%): automatisch geregistreerd, géén menselijke actie — maar wél volledig gelogd en toetsbaar in het besluitlog.
Van der Takstraat 5	terugmelding	Melding van een bewoner (pand gesplitst): onderzocht, bevestigd, twee verblijfsobjecten geregistreerd, terugmelding afgehandeld.
Sloop pakhuis (scenario)	sloop	Volledige levenscyclus t/m sloop; het vrijgekomen terrein is geregistreerd zodat de gebiedsdekking sluitend blijft.

Element	Klikbaar?	Toelichting
Werkpakket-kaarten	ja	Openen het bijbehorende scherm (signaal of objectcontext).
Filter-/sorteerchips (▾)	nog niet	Tonen de bedoelde ordening (registratie als filter, termijn aflopend); de dropdowns doen nog niets.
Groene databanner	n.v.t.	Bevestigt dat de lijst uit de event-store is gegenereerd (aantal events).

3.3 Signaal beoordelen — de mens beslist

Dit scherm toont het kernprincipe "AI adviseert, mens besluit" (human-in-the-loop, PvA §3.4). De machine laat zien wat ze voorstelt én hoe zeker ze is — per deelsignaal, met herkomst. Geen enkel pakket op de markt toont dit; hier loopt Rotterdam voorop.

Element	Klikbaar?	Toelichting
Deelsignalen met balkjes (88% / 62% / 41%)	n.v.t.	Betrouwbaarheid en herkomst pér signaal — de basis waarop de operator beslist.
`Geometrie accepteren` / `Corrigeren op de kaart`	deels	De afbakenstap vóór de beslissing. De knoppen registreren uw keuze en tonen een statusregel; het daadwerkelijk verslepen van contourpunten op de kaart is nog schematisch.
`Accepteren` / `Wijzigen` / `Verwerpen` / `Terecht signaal, geen actie`	ja	De vier uitkomsten. Let op: "terecht signaal, geen actie" is een vólwaardige, gelogde uitkomst — signalering die geen fout is wordt gemarkeerd-met-reden, niet weggewerkt.
Fouttype-keuzelijst (bij Verwerpen)	ja	Verplicht bij verwerpen. Het gekozen fouttype wordt "teruggevoerd naar regels en model" — zo leert het systeem van afwijzingen (PvA §3.4, stap 4–5).
Toelichting-veld	ja	Verplicht bij "Verwerpen" en bij "terecht signaal, geen actie". Probeer het leeg te laten: de validatie houdt u tegen.
`Vastleggen als gebeurtenis`	deels	Controleert de verplichte velden en toont de bevestiging zoals die in het besluitlog zou landen. Schrijft (bewust) niet echt naar de event-store.
Beeldmateriaal / minikaart	nog niet	Placeholder: in het echte scherm staat hier luchtfoto/obliek naast de kaart.

3.4 Objectcontext & besluitlog — de registratie met geheugen

Eén klik vanuit elk werkvoorraaditem opent de volledige context van een object. De twee tabellen zijn projecties uit de echte events van het scenario-nieuwbouwpand:

Tijdlijn (dubbele tijdas): elke regel is een versie met een geldigheidsperiode (hoe de werkelijkheid was) én een registratieperiode (wat het systeem wanneer wist). Versie 3 is met terugwerkende kracht gecorrigeerd en blijft als ingetrokken (✗) zichtbaar — formele historie.
Besluitlog: wie besloot wat, waarom en wanneer — inclusief de automatische STP-besluiten. Dit komt "gratis" uit de event-sourcing-kern van de proeftuin en is in geen enkel marktpakket een zichtbare functie.

Beide tabellen zijn alleen-lezen; de kaart en kerngegevens zijn schematisch. Wilt u de tijdreis zélf bedienen, open dan de kaartviewer en gebruik de peildatum-schuif en de vóór/ná-correctie-knoppen.

3.5 De rolswitcher (zwarte balk, rechtsboven)

De keuzelijst wisselt het perspectief tussen twee rollen uit het Mercator-rollendocument. In sommige projectdocumenten heet de verwerkende rol "operator" — hier gebruiken we de Mercator-namen:

Rol	Doet	Wat u ziet veranderen
Objectregisseur	regiekamer: bewaakt termijnen en kwaliteit, bundelt werk en biedt pakketten aan	Onder elk werkpakket: aan wie het is aangeboden, of dat het nog moet.
Objectregistrator	verwerkt de aangeboden pakketten (beoordeelt signalen, registreert)	Onder elk werkpakket: of het aan ú is toegewezen, beschikbaar is, of van een collega is.

4. Begrippen in één zin

Gebeurtenis (event): De kleinste registratie-eenheid: "er is iets besloten of veranderd". De proeftuin bewaart uitsluitend gebeurtenissen — niets wordt ooit overschreven; corrigeren = een nieuwe gebeurtenis toevoegen.
Dubbele tijdlijn: Elk gegeven heeft twee tijdassen: wanneer het gold in de werkelijkheid (geldigheid) en wanneer het systeem het wist (registratie). Daardoor kan de registratie "terugreizen" op beide assen.
STP (straight-through processing): Signalen die betrouwbaar genoeg zijn worden zonder menselijke tussenkomst verwerkt — maar altijd gelogd en toetsbaar.
Auto-drempel (85%): De grens waarboven STP automatisch mag registreren. Een béleidskeuze (bestuurbaar), geen technische modelinstelling.
Uitval: Een signaal onder de drempel: de machine registreert niet maar legt een voorstel voor aan de mens, mét onderbouwing.
Betrouwbaarheid per deelsignaal: Niet één batch-percentage, maar per los signaal een score én een herkomst — zodat de beoordelaar ziet wáár de onzekerheid zit.
Herkomst (PROV-O): Elke gebeurtenis draagt haar bron mee: echt (PDOK/BGT/BAG), synthetisch (testscenario) of STP (automatisch). Echt en nagemaakt blijven altijd scheidbaar.
Terugmelding: Een melding van buiten ("dit klopt niet") die als status-machine met termijnbewaking door het proces loopt; elke statuswijziging is zelf een gebeurtenis.
Werkpakket: Alle signalen, uitval en meldingen van één gebiedsontwikkeling of zaak, gebundeld zodat een object maar één keer wordt aangeraakt.

5. Waar komt de data vandaan?

De mockup wordt bij elke herbouw van de proeftuin gevuld vanuit data/events.jsonl: een append-only logboek met 391 gebeurtenissen. Daarvan zijn er 372 echt (Noordereiland-uitsnede uit BGT en BAG via PDOK, juli 2026); de rest is synthetisch en als zodanig gelabeld — drie testscenario's (nieuwbouw met terugwerkende correctie, sloop, splitsing na terugmelding) plus twee STP-verwerkingen. Twee echte BGT-panden vallen bewust uit omdat hun geometrie niet aan het informatiemodel voldoet: kwaliteitscontrole bij invoer, niet achteraf.

Open de mockup Open de kaartviewer

6. Waar we uw blik op zoeken

Herkenbaarheid — klopt de gebieds-/zaakgerichte werkvoorraad met hoe u uw werk (wilt) organiseren? Wat mist er?
De beslisflow — is afbakenen → beslissen → verplicht motiveren de juiste volgorde? Zijn de fouttypen de juiste?
De automatiseringsgrens — wat zou u het systeem nooit toevertrouwen om zonder mens af te handelen? Is 85% een verdedigbare drempel?

Eén zin per vraag is al waardevol. Noteer uw reacties en bespreek ze bij de eerstvolgende projectafstemming — of mail ze naar Douwe (na de vakantie gelezen).