Bitemporeel register v06 en Omnium Studio
De actieve versie van het modelgedreven register en de modelwerkbank. Lees eerst het productoverzicht en de walkthrough. De integrale review van 2026-09-30 beschrijft de huidige mogelijkheden, beperkingen en voorgestelde prioriteiten. Dit is een proof of concept, geen productieverklaring.
Features
- Registreren, corrigeren en ongedaan maken met audit trail.
- Hub + Data-opslag in PostgreSQL via Bun; formeel tijdreizen en materiele plumbing.
- MetaRegistry-gedreven REST, GraphQL, OpenAPI en codegen.
- Omnium Studio met profielgedreven modelleren en import/export.
- Generiek materieel queryen, volledige presence/ref-validatie en consistente samengestelde reads zijn nog open verbeterpunten; zie de review.
Requirements
- Go volgens go.mod, momenteel 1.25.0.
- PostgreSQL voor de registerruntime.
- Een ondersteunde Node-versie voor Vite 8, bijvoorbeeld Node 22.12 of hoger binnen een ondersteunde release, voor frontendontwikkeling.
Getting Started
Werk vanuit bitemp_register_v06/. Gebruik een eigen ontwikkel-/testdatabase:
startup voert database-setup uit. Neem .env.example als basis voor
lokale configuratie, zonder bestaande instellingen te overschrijven. Credentials
horen niet in broncode of git. De stapsgewijze PowerShell-instructies staan in de
walkthrough.
$env:PORT = '8082'
go run .
De API luistert dan lokaal op http://localhost:8082. Gebruik het hele package
(go run .), niet alleen het hoofdbestand. Frontend en eventuele devtools hebben
een afzonderlijke startprocedure; zie de walkthrough en DEVLOOP.
Render-API (SVG van modeldiagrammen, voor Imprint). POST /api/render/svg en
GET /api/models/{naam}/diagram.svg / …/views.json (naam + versie + asOf) tekenen via een
Node-sidecar. Start die naast de API met node render-svc/server.mjs (luistert op
127.0.0.1:8095, de standaard van RENDER_SVC_URL), of via F5 met de compound
Start frontend and debug API v06. Zonder sidecar geven deze routes een 502. Contract en
tekenkeuzes: RENDER_API.
Een clean-clone-installatie is in de review nog niet uitgevoerd.
Tests and Coverage (VS Code Tasks)
In VS Code you can run the predefined tasks from .vscode/tasks.json:
go: test all (v06)- Runs all tests in
bitemp_register_v06.
- Runs all tests in
go: coverage all (v06)- Generates
coverage.outand prints function-level coverage in the terminal.
- Generates
go: coverage html (v06)- Generates
coverage.out,web/coverage.html(detail) andweb/coverage_functions.txt(function summary).
- Generates
The HTML report is written to:
bitemp_register_v06/web/coverage.html
When the API is running, you can open it via:
/viz/coverage_report.html(recommended start page)/viz/coverage_functions.txt(function-level percentages)/viz/coverage.html(raw Go source heatmap)
Open this file in your browser to inspect coverage per package and per function.
Devloop / self-rebuilding workflow
Voor het werken met de UML-editor, schema-publicatie, multi-domein codegen en veilige rebuilds in Docker is er nu een aparte devloop-handleiding:
Kort samengevat:
- de devloop draait normaal op
http://localhost:8182 - lokaal testen buiten Docker kan ook, bijvoorbeeld op
http://localhost:8082, zolangDEVLOOP=trueis gezet - de editor kan publiceren naar
schema_versiesen daarna één of meer domeinen laten rebuilden/codegenereren - de rebuild-flow ondersteunt fallback via
_baseline/model/en_pre_rebuild/model/, zodat een mislukte codegen/build niet meteen de hele app onbruikbaar maakt - de automatische
exit 42herstart wordt alleen in Docker gebruikt (DEVLOOP_CONTAINER=true)
Voor de volledige workflow, voorbeelden met schema_versie_id, en rollback-gedrag: zie docs/DEVLOOP.md.
Referentielijsten
Het model ondersteunt generieke referentielijsten via één Referentielijst-entiteit.
Individuele lijsten (Landenlijst, EU-Lidstaten, etc.) zijn records in de tabel register_referentielijst, niet aparte Go-structs.
Architectuur
Referentielijst— generieke entiteit (tabelregister_referentielijst, PKid, uniquesysteemnaam)Referentielijstnaam/Referentielijstomschrijving— GE's (hub+data) voor naam en omschrijvingLandenlijstLand— items-relatie (koppelrelatie,relatieSubtype: referentielijst_items) tussen instantie "Landenlijst" en entiteitLandLand— referentielijst-item entiteit met GE'sLandcodeenLandnaam
Endpoints
| Methode | Endpoint | Beschrijving |
|---|---|---|
| GET | /referentielijsten |
Overzicht van alle referentielijst-instanties |
| GET | /referentielijsten/referentielijsten |
Lijst Referentielijst-records |
| GET | /referentielijsten/referentielijsten/:id |
Detail van één Referentielijst |
| GET | /full/referentielijsten/referentielijsten |
Volledige lijst met geneste GE's |
| GET | /full/referentielijsten/referentielijsten/:id |
Volledig detail met geneste GE's |
| GET | /landen |
Lijst van alle landen |
| GET | /full/landen/:id |
Volledig land met GE's |
| GET | /landenlijst_landen |
Alle LandenlijstLand koppelrecords |
Zie docs/ai-chats/plans/2026-03-29 referentielijsten PLAN.md voor het volledige implementatieplan en alle endpoints.
OpenAPI 3.1 & Interactieve documentatie
De API publiceert OpenAPI 3.1.0 specificaties conform de NL API Strategie (ADR 2.1.0). De specs worden dynamisch gegenereerd uit de MetaRegistry.
Volledige documentatie:
docs/OPENAPI.md— endpoints, CLI-export, architectuur, ADR-compliance en schema-overzicht.
| Methode | Endpoint | Beschrijving |
|---|---|---|
| GET | /openapi.json |
Geconsolideerde OAS 3.1 spec (JSON) |
| GET | /openapi.yaml |
Geconsolideerde OAS 3.1 spec (YAML) |
| GET | /openapi |
Lijst beschikbare domeinen |
| GET | /openapi/:domein |
Domein-specifieke spec (bijv. /openapi/abuvwxy.json) |
| GET | /swagger |
Swagger UI — interactieve API-verkenner |
| GET | /redoc |
ReDoc — leesbare API-documentatie |
Specs naar bestanden exporteren voor Git:
go run ./cmd/openapi-export # alle specs naar openapi/
go run ./cmd/openapi-export --domein CG # alleen één domein
DB migratie
Bij het starten van de API worden oude tabellen (van de Landenlijst-als-entiteit structuur) automatisch gemigreerd naar de nieuwe generieke structuur via ensureReferentielijstRefactorMigrated(). Dit is idempotent.
Visualisatie (React + Vite)
De actieve visualisaties draaien nu als React + Vite build onder:
- Zie ook
UML_EDITOR_INTEGRATIE.mdvoor de opname van de UML editor als subtree en frontend-pagina.
http://localhost:8082/viz/react/(data-overzicht)http://localhost:8082/viz/react/tijdlijn.html(tijdlijn)http://localhost:8082/viz/react/editor-v2.html(UML-editor v2)http://localhost:8082/viz/react/universum.html(3D Universum)http://localhost:8082/viz/react/registraties.html(registraties replay)http://localhost:8082/viz/react/ide.html(IDE — modelbestanden)http://localhost:8082/viz/react/inhoud.html(inhoud-editor)http://localhost:8082/viz/react/publicatie.html(publicatie & devloop)http://localhost:8082/viz/(landingspagina met links)
De index-pagina:
- haalt schema op via
GET /api/viz/schema - toont entiteiten, gegroepeerde GEs en relaties op basis van het actuele schema
- ondersteunt opvoeren van nieuwe entiteiten, registreren van wijzigingen, correcties en ongedaanmakingen
- maakt
opv:-waarden klikbaar zodat je direct naar de registratiedetails navigeert - volgt de visualisatiehiërarchie uit
docs/frontend-viz-design.md
De tijdslijn-pagina:
- toont alleen registraties die relevant zijn voor de gekozen entiteit
- combineert registratie- en snapshotvisualisatie in een horizontale tijdslijn
- visualiseert ongedaanmakingen met pijlen en highlights naar de ongedaan gemaakte representaties
- ondersteunt
Download PNGenKopieer PNGvoor export van de tijdslijn - gebruikt dezelfde leeshiërarchie als de index-pagina voor entiteiten, GE's, relaties en registratieblokken
Zie docs/frontend-viz-design.md voor de ontwerpregels van de viz-kaarten, informatiehiërarchie en samenvattingsregels.
De oude links naar de legacy schema- en archiefpagina's zijn verwijderd van de startpagina's.
3D Data Universum
Een interactieve 3D-visualisatie van het metamodel, gebouwd met react-force-graph-3d en Three.js. Toont alle representatietypes (entiteiten, gegevenselementen, relaties) als gekleurde bollen in een force-directed graph, met kleuren uit de MetaRegistry.
Belangrijkste features:
- Domeinfilter: toggle-knoppen per domein om specifieke delen van het model te isoleren
- Instance drill-down: dubbelklik op een node om de onderliggende data op te halen
- Keyboard-navigatie: Alt+←/→ (history), Enter (drill-down), Escape (deselecteren)
Zie docs/3D_UNIVERSUM.md voor het volledige ontwerp, de implementatie en de roadmap.
Formulieren, weergaven en vormen
Formulieren, overzichten en publicatiepagina's zijn data in het configuratiedomein (FormulierDefinitie, LijstDefinitie, WeergaveDefinitie), met een vormenbibliotheek voor invoer en weergave (inhoud en vorm gescheiden). Invoervelden controleren de regels van hun datatype uit het model (bv. de 11-proef van een BSN).
docs/FORMULIERDEFINITIES.md: de layout, vorm/vormConfig, nieuw, bewerken ("Bewerken via") en openbaar indienen. Een definitie wijs je aan met haar leesbarecode(bv.nieuwe-organisatie) of met haar id (§1.1).docs/PUBLICATIE_TEMPLATES.md: detail-templates,{{#vorm}}-blokken en meerdere weergaven per type (?weergave=<code of id>).docs/plans/2026-09-26 Invoersoort en vorm (ontwerp).md: het ontwerp (invoersoort, vorm, opslag, keuzebron), de 22 vormen, EnumLijst en de open vragen.- Showcase:
/viz/react/vormen.html: elke vorm in invoer en weergave, met de opgeslagen inhoud. docs/AI_ASSISTENT.md: de vormai-assist(voorstel, de mens beslist), eigen sleutel of toegangscode, en de AI-proxy.
Afgeleide velden (Derived Fields)
Het metamodel (V3) ondersteunt afgeleide velden — velden waarvan de waarde wordt berekend uit andere velden, analoog aan UML derived attributes (/attribuut).
Er zijn twee niveaus:
- Veld-niveau: een veld binnen een GE/relatie gemarkeerd als
afgeleid: true, met een afleidingsregel die verwijst naar velden in hetzelfde GE. - Entiteit-niveau: een
afgeleideVelden[]array op de entiteit, met afleidingen die verwijzen naar velden uit verschillende onderliggende GE's/relaties (bijv.Naam.roepnaam).
De standaard expressietaal is CEL (Common Expression Language), een type-safe, open standaard van Google.
{
"naam": "weergavenaam",
"goType": "string",
"afleidingsregelTaal": "cel",
"afleidingsregel": "Naam.roepnaam != null ? Naam.roepnaam : Naam.voorletters + ' ' + Naam.achternaam"
}
In de UML-editor worden afgeleide velden weergegeven met een oranje / prefix en cursieve stijl.
Zie afgeleide-velden.md voor de volledige documentatie, CEL-syntaxvoorbeelden en codestructuur.
Belangrijke status (maart 2026):
- Afgeleide velden blijven nu ook behouden na publiceren naar DB + refresh.
- Root cause was dat de backend V3-structuur de velden
afgeleideVelden,afgeleid,afleidingsregelTaalenafleidingsregelnog niet had gemodelleerd. - De CORS-middleware staat nu vroeg in de routerregistratie, zodat ook
/api/schema/versiescorrect CORS-headers teruggeeft voor Vite oplocalhost:5174. - Bij editorproblemen met
[demo]als bron: controleer eerst API/CORS in browser console en endpointGET /api/schema/versies.
Opmerking:
- De frontend gebruikt gebuilde assets (geen runtime React-CDN meer nodig).
- Voor lokale markdown-documentatie kun je nu ook gebruiken:
http://localhost:8080/docs(overzicht van alle.mdbestanden)http://localhost:8080/docs/web/readme.md(web handleiding)
Schema model endpoints (V3)
Voor het registermodel in V3-formaat zijn er drie relevante endpoints:
GET /api/schema/model- Retourneert de actieve schema-versie uit de database (
status='active'). - Als er nog geen actieve DB-versie bestaat, valt deze route terug op code-export.
- Retourneert de actieve schema-versie uit de database (
GET /api/schema/model/code- Retourneert altijd de actuele modeltoestand uit de draaiende code.
- Deze route is onafhankelijk van de inhoud van
schema_versies. - Response bevat
bron="code"enmodel_bron="code".
GET /api/schema/model/:id- Retourneert exact één opgeslagen schema-versie uit de database.
- Geen fallback naar code-export.
Metadata voor code-export
Voor GET /api/schema/model/code kun je metadata uit environment variables laten teruggeven:
SCHEMA_CODE_MODEL_NAAMSCHEMA_CODE_MODEL_BESCHRIJVINGSCHEMA_CODE_MODEL_VERSIESCHEMA_CODE_BUILD_VERSIESCHEMA_CODE_GO_MODULESCHEMA_CODE_INDIENERSCHEMA_CODE_OPMERKING
Deze waarden vullen zowel top-level responsemetadata als, waar van toepassing, de modelvelden (naam, beschrijving, versie).
Voor uitgebreide ontwerpachtergrond en lifecycle: zie model/ontwerpkeuzen.md.
API Reference
Een volledige referentie van alle endpoints, query-parameters, URL-parameters en gedrag staat in docs/API_REFERENCE.md.
Codegen proberen (V3)
Volledige handleiding: zie
docs/CODEGEN.mdvoor de complete workflow, domeinscheiding, roundtrip-verificatie en het toevoegen van nieuwe domeinen.
Je kunt de codegenerator op drie manieren draaien:
- Vanuit een draaiende API (aanbevolen):
go run ./cmd/codegen --from-url http://localhost:8082/api/schema/model/code --output model
- Vanuit een specifieke database-versie op ID:
go run ./cmd/codegen --from-url http://localhost:8082/api/schema/model/123 --output model
- Vanuit een bestand:
go run ./cmd/codegen --input model.json --output model
model.json is hierbij alleen een voorbeeldnaam. De codegenerator leest het pad dat je via --input meegeeft; dat mag dus ook bijvoorbeeld exports/metamodel_v3.json zijn.
Inputformat en editor-export
- Codegen verwacht een V3-model met top-level
entiteiten. - Wrapper payloads met top-level
modelworden ondersteund. - Extra top-level velden (zoals
flowStateuit de editor) worden genegeerd. - Let op: het oude/platte editor-model met
types/relatiesis geen V3 input voor codegen.
Als je model uit de editor wilt gebruiken voor codegen, gebruik dan bij voorkeur eerst de V3 API-bron (/api/schema/model/code) als input voor codegen.
MetaRegistry metadata uit codegen
Codegen zet de geconfigureerde meervoudsvorm nu expliciet in TypeMeta.Meervoud.
- Voor entiteiten, gegevenselement-hubs en relatie-hubs komt deze waarde uit het V3-model (
meervoud). - Voor afgeleide plumbing-types (
_Data,_Aanvang,_Einde) gebruikt codegen een veilige default op basis van het afgeleide type. GET /api/viz/schemageeft deze waarde terug alsmeervoud(met fallback naarpadnaamvoor oudere handgeschreven entries zonder explicieteMeervoud).
Modus: standalone vs. additive
De codegenerator ondersteunt twee modi via --mode:
| Modus | Beschrijving |
|---|---|
standalone (default) |
Genereert bestanden die de gehele MetaRegistry en DatatypeRegistry definiëren. Bestaande definities worden overschreven. |
additive |
Genereert bestanden die via Go init() functies toevoegen aan de bestaande registries. Het register groeit: de handgeschreven basis-entries (A, B, etc.) blijven intact en het gegenereerde model wordt ernaast geladen. |
Standalone (standaard — vervangt het hele model):
go run ./cmd/codegen --from-url http://localhost:8082/api/schema/model/5 --output model
Additive (voegt toe aan bestaand model, met file-prefix):
go run ./cmd/codegen --from-url http://localhost:8082/api/schema/model/5 \
--output model --mode additive --prefix hr
Dit genereert bestanden als hr_metaregistry.go, hr_modellen_entiteiten.go, etc. In de MetaRegistry worden entries toegevoegd via init():
func init() {
MetaRegistry["Medewerker"] = TypeMeta{ ... }
MetaRegistry["Medewerker_Naam"] = TypeMeta{ ... }
}
De DatatypeRegistry wordt uitgebreid via append():
func init() {
DatatypeRegistry = append(DatatypeRegistry, V3Datatype{ ... }, ...)
}
Hoe werkt dit? Go garandeert dat package-level
var-declaraties (waarMetaRegistryenDatatypeRegistryworden geïnitialiseerd) worden uitgevoerd vóór alleinit()-functies. Daardoor bestaat de map/slice al wanneer de additiveinit()entries toevoegt.
--prefix flag
Met --prefix hr krijgen alle gegenereerde bestanden het prefix hr_:
| Zonder prefix | Met --prefix hr |
|---|---|
metaregistry.go |
hr_metaregistry.go |
modellen_entiteiten.go |
hr_modellen_entiteiten.go |
modellen_ge_rel.go |
hr_modellen_ge_rel.go |
modellen_methods.go |
hr_modellen_methods.go |
modellen_input.go |
hr_modellen_input.go |
datatype_registry.go |
hr_datatype_registry.go |
Dit voorkomt dat gegenereerde bestanden de handgeschreven bestanden overschrijven.
Validatie en foutmeldingen
Codegen valideert nu vooraf en geeft concrete foutregels, onder andere voor:
- verplichte V3 structuur (
versie,entiteiten) - ongeldige type-namen (PascalCase voor type-namen)
- ongeldige padnamen (
meervoudin lowercase/snake_case) - ontbrekende of ongeldige
doelEntiteitbij relaties
Debuggen in VS Code
In bitemp_register_v06/.vscode/launch.json staan launch-configs voor:
Go API v06: debugRender-svc v06(render-sidecar voor de render-API, zie RENDER_API)Codegen v06: from code endpointCodegen v06: from DB model idCodegen v06: from file
Stop/Herstart in de debug-toolbar reageert niet (2026-10-07): dan hangt meestal een
oude dlv-sessie die poort 8082 nog bezet houdt; elke nieuwe start van Go API v06: debug
kan dan niet binden en valt stil, terwijl de toolbar de oude sessie blijft tonen.
Controleren en opruimen (PowerShell):
netstat -ano | Select-String ":8082 .*LISTENING" # PID van het __debug_bin-proces
Get-CimInstance Win32_Process | Where-Object Name -like 'dlv*' |
Select-Object ProcessId, ParentProcessId, CreationDate, CommandLine
taskkill /PID <pid van dlv.exe dap> /T /F # stopt dlv én de debug-binary
Daarna gewoon weer F5. De achtergebleven __debug_bin.exe*-bestanden in deze map zijn
dlv-tijdelijken (gitignored) en kunnen weg.
Model publiceren vanuit editor (POST)
In Editor v2 is er een toolbar-knop Publiceer schema-model.
Die knop post het actuele V3-model naar POST /api/schema/model en vraagt vooraf om:
versienaamindieneropmerking(optioneel, wordt als query-parameter meegegeven)
Bij succes krijg je de nieuwe id van de opgeslagen proposed schema-versie terug.
Admin endpoint security
The destructive endpoint for dropping all tables is:
DELETE /admin/db/droptables/:password
You can configure the expected password with environment variable:
ADMIN_DROP_PASSWORD
If ADMIN_DROP_PASSWORD is not set, the default fallback password is 1234.
You must also explicitly enable dropping with:
ALLOW_DROP_TABLES=true
If ALLOW_DROP_TABLES is not true, the endpoint returns 403 Forbidden and will not execute.
Domein-specifiek droppen
Om alleen de tabellen van een bepaald domein te droppen (bijv. np-loc of cg), gebruik de domein query parameter:
DELETE /admin/db/droptables/:password?domein=np-loc
Dit dropt alleen de model-tabellen (entiteiten, gegevenselementen, relaties) die in de MetaRegistry tot het opgegeven domein behoren. De gedeelde plumbing-tabellen (registratie, wijziging) worden niet gedropt.
Zonder domein parameter worden alle tabellen gedropt (bestaand gedrag).
Call examples
curl (local):
# Alle tabellen droppen
curl -X DELETE http://localhost:8080/admin/db/droptables/1234
# Alleen tabellen van domein 'np-loc' droppen
curl -X DELETE "http://localhost:8080/admin/db/droptables/1234?domein=np-loc"
Postman:
- Method:
DELETE - URL:
http://localhost:8080/admin/db/droptables/1234- Optioneel query param:
domein=np-loc
- Optioneel query param:
- Body: none
Expected responses:
200 OK→ tables successfully dropped401 Unauthorized→ invalid password403 Forbidden→ dropping disabled (ALLOW_DROP_TABLESis nottrue)500 Internal Server Error→ database not initialized or drop operation failed
Safe production settings
Recommended production configuration:
APP_ENV=productionGIN_MODE=releaseALLOW_DROP_TABLES=false- Set a strong custom
ADMIN_DROP_PASSWORD(do not use1234)
Notes:
- On startup, the API logs whether dropping tables is enabled.
- If dropping is enabled in production context (
APP_ENV=productionorGIN_MODE=release), the API logs a warning.
Example .env values
Development (local only):
APP_ENV=development
GIN_MODE=debug
ALLOW_DROP_TABLES=true
ADMIN_DROP_PASSWORD=1234
DATABASE_URL=postgres://postgres:1234@localhost:5432/bitemp_go_db?sslmode=disable
Production:
APP_ENV=production
GIN_MODE=release
ALLOW_DROP_TABLES=false
ADMIN_DROP_PASSWORD=use-a-long-random-secret
DATABASE_URL=postgres://<user>:<strong-password>@<host>:5432/<db>?sslmode=require
Docker
For Docker build/run/share instructions (without docker compose), see docker.md. For a short release flow, see RELEASE.md.
Contributing
Contributions are welcome! If you find any issues or have suggestions for improvement, please create a new issue or submit a pull request.
License
This project is licensed under the European Union Public Licence v. 1.2 (EUPL-1.2). See the LICENSE file in the repository root. The EUPL is available in all official EU languages (including Dutch) at https://interoperable-europe.ec.europa.eu/collection/eupl/eupl-text-eupl-12; all language versions are equally valid.
Third-party components keep their own licences (for example web/vite/public/method-draw/LICENSE).
GraphQL
GraphQL API Complete Your bitemporal API now has a production-ready GraphQL endpoint. Here's what was implemented:
📊 What Was Added gqlgen Integration - Industry-standard, type-safe GraphQL for Go
Comprehensive Schema - Full bitemporal data model including:
Entity A/B queries and mutations Relationships (RelationAB) Data elements (AÜ, AV, BX, BY) Audit tracking (Registration, Change/Wijziging) Task management DateTime scalar handling Gin Integration - GraphQL seamlessly integrated with your existing Gin server
Database Ready - Resolvers have access to your Bun ORM via r.DB
🚀 Access Your GraphQL API Endpoints:
🎮 Playground (Interactive IDE): GET http://localhost:8080/graphql/playground 📤 Query/Mutation Endpoint: POST/GET http://localhost:8080/graphql/query 📝 Key Files graph/schema.graphqls - Schema definition graph/schema.resolvers.go - Resolver stubs (ready to implement) graph/resolver.go - Dependency injection with DB handlers/graphql_handler.go - Gin integration GRAPHQL.md - Complete usage guide with examples 💡 Next Steps Implement resolvers in schema.resolvers.go (they currently panic) Start with Task resolvers since you already have the model Use Bun to query your database The schema is already designed for your bitemporal data model - just implement the database logic!
HOW TO USE
POST Task
{
"id": "1",
"title": "De eerste taak",
"description": "bjksdajk jk kjads",
"status": "Al weer klaar"
}
This executes:
INSERT INTO "tasks" ("id", "title", "description", "due_date", "status")
VALUES ('1', 'De eerste taak', 'bjksdajk jk kjads', '0001-01-01 00:00:00+00:00', 'Al weer klaar')
POST Full Entity (A)
{
"id": "3",
"opvoer": "2026-02-11T19:00:00Z",
"vs": [
{
"rel_id": 3,
"a_id": "3",
"ccc": "eerste ccc op a=3"
},
{
"rel_id": 4,
"a_id": "3",
"ccc": "tweede ccc op a=3"
}
],
"us": [
{
"rel_id": 5,
"a_id": "3",
"aaa": "eerste aaa op a=3",
"bbb": true
}
]
}
REGISTRATION
Via de endpoints:
/registreer/as- for entity A registration/registreer/bs- for entity B registration
You can perform:
- Register an entity (A or B) with its data elements (Full A or Full B)
- Deregister an entity, including all valid (not yet deregistered) data elements
- Modify data elements of an entity (arbitrary combination of register and deregister operations)
- TODO: implement and enforce singularity/plurality constraints
Register Full Entity A
{
"registratie": {
"registratietype": "registratie",
"tijdstip": "2026-01-02T11:00:00Z",
"opmerking": "Initiële invoering van entiteit A"
},
"wijzigingen": [
{
"opvoer": {
"a": {
"id": "5",
"us": [
{
//"rel_id": 5, niet nodig bij PFK autoinc rel_id
"a_id": "5",
"aaa": "a5",
"bbb": true
}
],
"vs": [
{
//"rel_id": 7, idem
"a_id": "5",
"ccc": "c5-1"
},
{
//"rel_id": 8, idem
"a_id": "5",
"ccc": "c5-2"
}
]
}
}
}
]
}
Deregister Full Entity A
{
"registratie": {
"registratietype": "registratie",
"tijdstip": "2026-02-16T10:30:00Z",
"opmerking": "Afvoer van entiteit A"
},
"wijzigingen": [
{
"afvoer": {
"a": {
"id": "5"
}
}
}
]
}
Modify Data Elements
Deregister U5 and register U6 for entity A:
{
"registratie": {
"registratietype": "registratie",
"tijdstip": "2026-02-16T10:30:00Z",
"opmerking": "Afvoer van u5 en opvoer van u6 (zelfde moment, ongebroken formele tijdslijn)"
},
"wijzigingen": [
{
"afvoer": {
"u": {
"rel_id": 5,
"a_id": "5",
"aaa": "a5",
"bbb": true
}
}
},
{
"opvoer": {
"u": {
"rel_id": 6,
"a_id": "5",
"aaa": "a6",
"bbb": false
}
}
}
]
}
DONE v6: big thing = materiele as (axis, tijdslijn) toegevoegd
1 JSON voor een request waarbij Aanvang en /of Einde wordt toegevoegd aan een bestaande Entiteit
{
"registratie": {
"registratietype": "registratie",
"tijdstip": "2026-02-16T10:30:00Z",
"opmerking": "Opvoer van aanvang en einde van A=1"
},
"wijzigingen": [
{
"opvoer": {
"aanvang": {
"a_id": "1",
"datum": "01-01-2020"
}
}
},
{
"opvoer": {
"einde": {
"a_id": "1",
"datum": "31-12-2025"
}
}
}
]
}
2 Aanvang en Einde op een entiteit via plumbing behandelen als een GE
- bij opvoer, afvoer en correctie
- ongedaanmaking moet misschien iets speciaals gebeuren in de queries
3 Full handlers uitbreiden met meer dan één laag diepe relaties (vanwege bovenstaande mogelijke materiele 'mickey mouse oortjes' op entiteiten en gegevenselementen)
- Dan heeft het GE een drievoudige PFK:
entiteit-id{ent}_{GE}.rel-id{ent}_{GE}_data.versie
- De splitsing van het gegevenselement in
{ent}_{GE}en{ent}_{GE}_datais een vorm van plumbing. - De API blijft nog dezelfde, met toevoeging van aanvang en einde als optionele types onder elk materieel element.
- Bij creatie worden de tabellen gesplitst gemaakt met indien materieel de aanvang en einde tabellen:
{ent}_{GE}_aanvangen{ent}_{GE}_einde - deze gedragen zich dus als een _data tabel met een versie.
DONE = lijst van kleine en grotere items die zijn gebouwd
1 API's
- full handlers uitbreiden met meer dan één relatie (array en itereren)
2 Registratie: speciaal Registratie (POST) endpoint dat het volgende doet:
- post registratie (onthoudt ID en tijdstip)
- post gegevens (met reg_tijdstip in opvoer; opvoer kan altijd maar 1x, maar kan worden leeggemaakt bij ongedaanmaking van de opvoerende-registratie)
- onthoudt id's of stop ze in de structs
- post records in tussentabel wijziging (heel specifiek met soft links)
3 refactoren van de huidige ingewikkelde registreren code. (gegenned) Die is niet geparameteriseerd en warrig.
4 Autoincrement van registratie en wijziging
5 tijdelijk: registratietijdstip loopt per uur op samen met het registratienummer, zodat registraties altijd sequentieel gedaan worden
6 MetaRegistry en structs zijn de enige files die bepalen welke data in het register zit! Registratie en Wijziging zijn 'plumbing'.
7 nu is de geconfigureerde data A, B, A-B, en U, V, X en Y
8 ook configureerbaar: het gegevenselementen en relaties krijgen een PFK die de entiteit-id en een relatief id combineert. Het relatief id is autoincrement via een trigger. De code maakt de triggers aan bij createtables.
9 enkel- en meervoudigheid in een tag vastleggen (eigen tag? validatie tag?) in de modellen, zodat de /registreren/{entiteit} handler bij de opvoer van een nieuw enkelvoudig gegevenselement het actuele GE automatisch kan afvoeren
- gedaan bij opvoer van een enkelvoudig gegevenselement: de eerder wordt afgevoerd
- bij het vinden van meerdere actieve GEs wordt een foutmelding gegeven (en niet opgevoerd / afgevoerd)
10 elke request vormt een transactie
11 reeds afgevoerde records kunnen niet weer afgevoerd worden (todo: goed testen, maar geldt voor alles)
12 ongedaanmaking en correctie
13 documenteer huidige formele tijdreisqueries 14 maak ze A/B/U/V onafhankelijk (metamap): genereer op basis van de metamap (geparameteriseerde) views in de DB en gebruik die in de code
14 react pagina's
- onafhankelijk maken van A/B/U/V/X/Y
- enkelvoudig meervoudig tonen (1 of *)
- entiteit vette rand
- uitbreiden met klikbare elementen, waarop je acties kunt doen: afvoeren, opvoeren, corrigeren
- correctie van bepaalde reg mogelijk
- ongedaanmaken van reg mogelijk (onder voorwaarden)
- bij verstuur correctie van A en alleen wijzigen van 1 veld van de 7, alleen het gewijzigde veld corrigeren. Correctie mag een deelverzameling van een eerdere registratie zijn, qua welke velden worden gewijzigd.
15 react met vite maken
16 In react pagina's:
- enkel- meervoudigheid op formulier tonen
- type is nu number of string (of bool of datetime), terwijl in de struct int of float of string (of book of datetime) is: kan dat ook over naar typescript? dus onderscheid geheel, gebroken getal
- misschien al neigen naar OAS met format? Of hoe doet GraphQL dat?
- in formulier: groeperen op type
- in formulier: het type, verplichtheid en enkel of meervoudigheid reflecteren
- in formulier: soort invoerveld en validatie volgt type
- in formulier via metamap / schema api: enums als type
- secondaire ID's in een relatie worden opgezocht uit de mogelijke seondaire entiteiten
- reg vak alles iets kleiner
17 log alle requests en responses van /registratie/
- tevens een view op registraties in react waarop je:
- het opmerking veld inline in de tabel kunt editen
- een export van een keuze kunt maken
- zo een export kunt importeren en afspelen, met een entiteit-id en registratie-id offset (om de database een beetje gevuld te krijgen)
18 React: formulier elementen worden nu als het goed is hergebruikt, maar ben nog niet helemaal overtuigd
19 In modellen de materiële tijd toevoegen = aanvang en einde
- Voor elke representatie een aparte {REP}_Aanvang + {REP}_Einde tabel. (DONE)
- In de structs een standaard Aanvang en Einde plumbing struct, die zich in feite gedraagt als:
- een GE op de entiteit (DONE in DB, PFK met 2 velden)
- een _data element op een GE (todo, punt 2 eerst) (DONE in DB: PFK met 3 velden)
20 Een UML editor voor het model
- roundtrip engineering van model naar code
- model versies in het register vastleggen
- export naar mermaid, plantUML en XMI (tbv EA)
21 Enums
- in de metaregistry (en in de frontend als gevolg)
- en in de custom struct tags
- als soort van type, en niet alleen de waarden. Die staan al in de enum in go
- en gaan als het goed is ook mee in het schema
22 Datatypen, gegevenssoorten netjes inbouwen.
23 Register uitbreiden met menselijke klassen
- NP-locatie, via UML editor
24 Referentielijsten ✅ DONE (maart 2026)
- Generieke Referentielijst-klasse met instantie-records geïmplementeerd
- Zie Implementatieplan voor details
- Landenlijst (concrete struct) → Referentielijst (generieke entiteit) met instantie-records
- Referentielijstnaam + Referentielijstomschrijving als GE's (hub+data)
- LandenlijstLand als items-relatie (referentielijst_items) gebonden aan instantie "Landenlijst"
- V3 JSON: referentielijstInstanties sectie + referentielijstInstantie op relaties
- UML Editor: instantie-nodes, binding-edges, toolbar + editing
- Codegen: entiteitSubtype/relatieSubtype/referentielijstInstantie emissie
- DB migratie: automatische rename tabellen/kolommen bij eerste start na upgrade
- referentielijst_item als gegevenstype/enumeratie in type-keuzelijsten in de editor
25 Afgeleide velden
- ook in ENT (vooral eigenlijk)
- soort van formule (OCL? DMN? -> maar wat voor?)
- / in UML view
- kan het label zijn in de index en tijdlijn viewer
- isLabelInTimelineViews property
- opnemen in de generator en daarna in:
- registratie- en tijdlijn-views betere layout m.b.v. weergave-velden, als die er zijn, anders gewoon id
26 tabel views en invulformulieren vanuit het model (na genereren)
- dit is minder een editor, maar meer een viewer / navigator
27 UML editor
- trekken lijntjes van punt naar punt: bewaren handle positie source en target
- selecteren van een groep elementen (voor verslepen)
- auto kiezen handles lijntjes op basis van positie source en target (bij import)
- import van XMI
- posities uit XMI import en in export mappen
- Export naar MIM
28 Domeinen aan schema's toegevoegd. Heel verhaal, zit overal doorheen!
- zie 2026-04-03 domeinen.md
BUGS
API:
10 aan een ongedaan gemaakte U1 bij een ongedaan gemaakte A1 kan nu gewoon een nieuwe U worden toegevoegd... ?
20 react index
- correctie aanvang/einde geeft ook bovenliggende hub mee, wat niet hoeft
TE TESTEN
React
- code: hergebruik formulier elementen okee?
- entity pagina: payload checken. Er gebeuren rare dingen (data cross GE)
TODO
05 log àlle requests en responses? (hoe?)
08 loop tijdsreizen nog eens na (KVK voorbeelden) want corrigeren is nu nog hetzelfde als wijzigen. Je hebt twee soorten tijdreizen (of 3).
10 Testdata, bootstrap 11 autogen testdata vanuit model
15 Afgeleide velden
- opnemen in:
- a. de wijzigings handler: de nu-staat uitrekenen m.b.v. go packages voor CEL etc.
- b. de database (liever niet)
- opnemen in de API's of niet?
- maken voor NP naam incl. naamgebruik
16 Referentielijsten
- vullen met data
- meer lijsten
20 react - edit popups
- corrigeren en afvoeren hebben heel weinig met elkaar te maken en staan gebroederlijk naast elkaar
- functioneel scheiden
- door niet te klikken maar rechts te klikken: bekijk | bewerk | voer af
- door eerst een popup met alle data te tonen in een view-kaart
- op die kaart: 1 bewerk (= afvoer + nieuwe opvoer) (enkelvoudig is eigenlijk altijd dit) 2 corrigeer ( = corrigeer) 3 voer af zonder opvolger
- functioneel scheiden
21 react pagina's
- enkelvoudig meervoudig tonen (1 of *)
- corrigeert registratie r ook een lijntje tekenen?
- enkele view:
- inhoudelijke info over wijzigingen
- Klikken op gerelateerde record: record ophalen en ook tonen, inclusief kinderen en relaties
- Dan kun je het hele model doorklikken. Vraag hoe dat netjes past, of dat defocus ook kan (A klapt weer in naar alleen een kleine A?)
- inklappen inclusief kinderen tonen (klein, maar zonder data)?
25 react pagina's uitbreiden met:
- (latere!) ongedaangemaaktheid van regs tonen
- dit is een soort 'blik op de toekomst'
30 UML model versies
- delta tussen een nieuwe en de huidige bepalen
- impact van de delta bepalen (breaking of niet)
- Export naar MIM linked data json iets
- kleur uit EA importeren
31 UML editor
- meerdere canvassen, per domein één (of naar keuze) -> IDE
- afhankelijkheid kunnen instellen -> TODO IDE
- overerving zelf kunnen tekenen
- alignen
- relatie-visualisatie:
- met velden: associatieklasse
- probleem: de lijnen tussen A en REL en REL en B zijn geen relaties, maar alleen maar de link tussen A en REL en REL en B
- ze hebben een richting: hoe visualiseren?
- pijl is niet meer UML 2
- pijl langs lijn?
- ze hebben een richting: hoe visualiseren?
- probleem: de lijnen tussen A en REL en REL en B zijn geen relaties, maar alleen maar de link tussen A en REL en REL en B
- zonder: alleen een lijn met een label "relatie"
- labels bij rollen verplaatsbaar (hoe in V3 en metareg?)
- volgorde velden veranderen
- met velden: associatieklasse
35 IDE
- multiselect in PB
- afhankelijkheid tussen domeinen kunnen instellen = domein diagram maken :-)
- drag and drop GE en ENT is er al: relaties moeten getekend
- niet altijd? (reproduce?)
- drag and drop - complete (shift?): ENT + alle GE's (en RELs) mee?
- auto-order / custom order
- dubbelklik op edge: straighten
- undo / redo doet het niet
- edge types: compositie, overerving, associatieklasse (!)
- diagram or any element rename in PB
- domeinkleur instellen, uberhaupt properties van domein instellen mogelijk
- welke properties allemaal?
- layout bar verplaatsbaar
- any bar
- afgeleide velden CEL expressie breakout met kleurcodes en autocomplete enzo? Proberen met testwaarden
- voorbeelden en testwaarden in REPs (t.b.v. expressies bijv. maar ook als document bij example).
- velden (attr) ook omschrijving
- meer dan dat: [0..*] enz
- volgorde velden kunnen veranderen (custom order)
40 Generator
- optie om project leeg te halen voor het genereren.
- optie database drop tables of migreer
- oppassen met reflijst plumbing in generiek!
45 Dabase migratie / backup naar json
- dat dus
50 Overerving verder uitwerken!
- basically een extra FK:
- van een ENT naar een ENT of
- van een GE naar een GE
- (of van een REL naar een REL?) -> deze even niet
55 Formulieren
- bewaar kan ook voor alle GEn ipv per stuk. Typisch is dat ook zo.
- bewaar of corrigeer is anders. Beide mogelijk maken. Ongedaan maken via een bekijk registratie moet ook kunnen. Daar wil je misschien ook de historie netjes inzien.
- Bereikbaarheid gaat nu nergens heen: uitleggen primaire en secundaire ID + lijst beschikbare adressen (had ik al uitgelegd)
60 3D weergave model en tijdslijnen :-)
65 Autonumber Entiteit-IDs? Simpel maar wenselijk 66 autogen GUID werkt al of moet daar iets gedaan worden?
70 pbac: wat is een goed policy formaat? 71 pip maken op basis van metamodel? 72 pep inbouwen