Visualisaties t.b.v. voorbeelden
Om in de voorbeelden duidelijk te maken wat daar precies gebeurt en in welke volgorde, zijn visualisaties behulpzaam. Die voorbeelden laten zien hoe registers werken in de praktijk: welke commando's binnenkomen, welke gevolgen worden vastgelegd, welke notificaties worden verstuurd en welke snapshots in de projectie ontstaan. De volgorde en het verloop over tijd spelen daarin een centrale rol.
De TimelineViewer maakt zichtbaar wat er is gebeurd over het verloop van de tijd: notificaties, commando's, gevolgen en snapshots verschijnen als gebeurtenissen op een chronologische tijdlijn. Welke onderdelen zichtbaar zijn, hangt af van welke gegevens worden meegegeven aan het component — alle elementen zijn optioneel.
De ProjectionViewer bouwt voort op de TimelineViewer en legt de nadruk op projecties. Het component ondersteunt het bekijken van verschillende projecties en visualiseert ze in een bitemporeel diagram, zodat duidelijk wordt hoe de toestand van gegevens zich over twee tijdsdimensies heeft ontwikkeld.
De TimelineViewer
De TimelineViewer toont de verwerkte gebeurtenissen in een register als een chronologische tijdlijn. De tijdlijn loopt van boven naar beneden: het vroegste tijdstip staat bovenaan, het nieuwste onderaan.
Elke gebeurtenis heeft een eigen kleur:
- Paars — notificaties: signalen die vanuit buiten de bounded context worden ontvangen of vanuit de bounded context naar buiten worden verstuurd
- Blauw — commando's: de instructies die zijn binnengekomen en verwerkt
- Oranje — gevolgen: de vastgelegde effecten van die verwerking
- Groen — snapshots: de resulterende toestanden in de projectie
Klik op een item in de tijdlijn om de details ervan te bekijken. De details verschijnen in de tijdlijn.
De ProjectionViewer
De ProjectionViewer combineert de TimelineViewer met een aanvullend onderdeel: een bitemporeel diagram. Dit diagram maakt zichtbaar hoe de staat van een collectie gegevens zich over twee tijdsdimensies heeft ontwikkeld.
Drie tijdstippen, twee tijdsdimensies
Elke snapshot in de projectie heeft drie tijdstippen. Dat zijn geen drie onafhankelijke tijdsdimensies: het gevolgtijdstip en het projectietijdstip zijn twee verschijningsvormen van dezelfde systeemtijd, zodat het geheel bitemporeel blijft (zie bitemporele opslag van snapshots). Zie ook Tijdstippen en geldigheid voor de conceptuele achtergrond.
- het geldigheidstijdstip: vanaf wanneer de snapshot geldig is in het domein. Als er ook een eindetijdstip bekend is, vormen ze samen een geldigheidstijdvak. Dit tijdstip is afkomstig uit het commando en wordt meegedragen in het gevolg.
- het gevolgtijdstip: wanneer het gevolg is vastgelegd in het register (de Axon event store). Dit is het tijdstip uit de gevolgenboekhouding.
- het projectietijdstip: wanneer de projectierij is weggeschreven naar de database. Dit tijdstip wordt bepaald bij het produceren van de projectie. Het is alleen zichtbaar in de projectie, niet in het gevolg zelf.
Het bitemporeel diagram
Onder de tijdlijn staat in de ProjectionViewer een bitemporeel diagram. Dit diagram toont de snapshots als rechthoeken in een tweedimensionaal vlak:
- De horizontale as geeft het geldigheidstijdstip (en geldigheidstijdvak) van de snapshot weer.
- De verticale as geeft het gevolgtijdstip of het projectietijdstip weer — te wisselen via de links aan de linkerkant van het diagram.
De geselecteerde snapshot is groen gemarkeerd; overige snapshots zijn grijs. Door op een vlak te klikken selecteer je het betreffende snapshot.
Meerdere projecties
Wanneer de meegegeven snapshots afkomstig zijn van meer dan één projectietype, toont de ProjectionViewer automatisch een knoppenbalk onder de tijdlijn. De balk heeft het label Projectie: en bevat voor elke projectie een knop met de naam van die projectie. De actieve projectie is blauw gemarkeerd; de overige zijn omlijnd.
Door op een knop te klikken wissel je naar die projectie. De tijdlijn filtert dan op de snapshots van de geselecteerde projectie, en het bitemporeel diagram toont de tijdlijnen die daarbij horen.
De projectiedetails
Naast het diagram staat het projectiedetailpaneel. Dit toont de projectierij die hoort bij de geselecteerde snapshot: het geldigheidstijdstip, het gevolgtijdstip en de inhoud van de rij, zoals objectnummer, type, kadastraal object en belanghebbenden. Klap je herkomst open, dan zie je de herkomst van de snapshot: onder meer het toegepaste gevolg en de softwarecomponent en -versie die de snapshot heeft geproduceerd.
Voorbeeld
Onderstaand voorbeeld toont een collectie gegevens rondom een WOZ-object. Klik op een snapshot in de tijdlijn of het diagram om de bijbehorende projectierij te bekijken.
Technische architectuur
De viewer-componenten zijn technische componenten van deze documentatie en bouwen op elkaar voort. Het onderstaande diagram toont welk component afhankelijk is van welk ander component.
ExampleDetailsViewer is een zelfstandige wrapper zonder afhankelijkheden van andere viewer-componenten. Deze geeft informatie over het gebruikte scenario en locatie van de data die gebruikt wordt. Deze staat gebruikelijk in elk voorbeeld bovenaan en geeft een korte info over het scenario en een metadata over de gebruikte data, wat een referentie is naar de .json die gebruikt is.
Naar aanleiding van een appartementsrechtsplitsing ontstaat een nieuw appartement in de BRK.Brondata
BrkBridgeAppartementOntstaanVoorbeeldTest-er-ontstaat-een-nieuw-appartement.jsonCommitfcfbf63Opgehaald6 oktober 2026