# Release-/wijzigingslog — Backend (Go API) & overall
Dit is het chronologische wijzigingslog voor de backend en overkoepelende wijzigingen. Frontend/Studio heeft een eigen log in
web/vite/CHANGELOG.md; de generator incmd/codegen/CHANGELOG.md. Versionering-conventie:docs/versiebeheer.md— backend-tags gebruiken de prefixapi/(baselineapi/v0.5.0opmain). Entries hieronder zijn deels gemengd FE/BE (historisch).
api 0.29.0 / devloop 0.32.0 (2026-11-18)
Akkoord Mark 18-11 ("ja" op de release met de sortering; "alvast akkoord voor push en images"; "uitrol op app is okee, op pf niet"). Hoort bij studio 0.46.0 / render 0.5.0 hieronder; devloop 0.32.0 is api 0.29.0 met studio 0.46.0 en render 0.5.0. Aanleiding: de performancetest met het zaakmodel (Omnium als derde stack naast OneGround en Open Zaak).
- Sorteren van lijsten in GraphQL (
dynql/sortering.go,docs/dynamische-graphql-laag.md§Sorteren): argumentsorteer: [{ veld, aflopend }]op<padnaam>enfull_<padnaam>_list, hooguit drie sleutels.veldis een kolom van de entiteit of<GE of relatie>.<veld>. De waarde is die van het actieve record (op het peiltijdstip); zonder waarde achteraan; daarna altijd de id. Een veld dat het toegangsbeleid verbergt is geen sorteersleutel. - REST-lijsten met een vaste volgorde: de lijst en de
/full-lijst van een entiteit hadden geenORDER BY, zodat een record bij bladeren op twee pagina's kon staan of ontbreken. Ze sorteren nu altijd op id (na een eventuele?sort=). - Marks naar een index (indexwerk stap 4,
docs/INDEXEN.md§Marks): de marksregister.zoeksleutelenregister.sorteerbaaruit de bijlagemarksnaast het V3-model geven een indexix_<tabel>_<kolom>_zoek. De rebuild uit een Studio-project stuurt de marks van het project mee naar/export/v3(render 0.5.0); de codegen zoekt het veld op zijn uuid. Een mark die niet te plaatsen is geeft een waarschuwing, de bouw gaat door. - Façade fase 1 (FACADE):
cmd/facade, lezen op Open Zaak en Open Object met de voorkant van een Omnium-register, en de Lader-naad indynql(laden los van opslaan). Voor een gewoon register verandert er niets: de karakteriseringstest geeft 0 van 210 queries verschil. - Migratiescript
docs/migraties/2026-11-18-cg-test-kolomtypen.sqlversie 2 (beide tijdvormen, zes kolommen); op cg-test uitgevoerd op 18-11.
Getest: go test ./... groen op main; dynql met PostgreSQL (sortering: oplopend, aflopend,
meervoudig, peiltijdstip, twee sleutels, met filter en paginering); regressiesuite np-loc,
afgeleide relaties en de karakteriseringstest van de Lader groen; het zaakmodel met de twee
marks van AI-INRICHTEN in een proefkopie: codegen voor vier domeinen, de schema-tags, de twee
indexdefinities en de build. Niet getest: de keten van een mark in een Studio-project tot een
index op een draaiend register, sorteren op een grote tabel, en gelijktijdige belasting.
Bekende grenzen:
- Het sorteren van een lijst gebruikt de index van
register.sorteerbaarnog niet: de sorteerwaarde is een subquery per entiteit. De index dient het filter (waarde of bereik). - Filteren en sorteren op een GE-veld kan alleen in GraphQL, niet in REST.
- Een mark weghalen haalt de index niet weg.
Uitrol:
- Schemawijziging: nee voor een bestaand register. Indexen uit marks komen er pas na een rebuild met een model dat marks draagt. De indexen van 0.28.0 staan er al.
- Rebuild uit het Studio-project: niet nodig. Wel nodig om marks uit de Studio in het
register te krijgen; dat vraagt render 0.5.0 naast api 0.29.0 (een oudere sidecar kent het
veld
marksop/export/v3niet). - Andere stap: nee.
- App:
bitemp-go-api:0.29.0viaupdate.sh. pf: niet uitgerold (keuze Mark). Fundament:bitemp-devloop:0.32.0, door FUNDAMENT.
studio 0.46.0 / render 0.5.0 (2026-11-18)
Akkoord Mark 18-11 ("ja, graag"). De api-release die hierop volgt (0.29.0, sorteren en indexen uit marks) en de devloop zijn van BACKEND.
- Marks (MDA): aanwijzingen op een modelelement voor een transformatie, los van het model
(plan
docs/plans/2026-11-18 Marks — markeringen op het model (plan).md). Marks staan in lagen met labels; een context is een keuze van lagen in een volgorde. In het werkbestand alsmarksnaastkruisverbanden; mee in de projectsync (marks/patchMarks) en in vergelijken en samenvoegen van een branch. - In de Studio: sectie Marks in Eigenschappen (per element, en per veld een tabel velden × soorten), Lagen… voor lagen, eigen marksoorten en de soorten van transformaties. Op het canvas een ruitje rechtsboven op een element, achter een veldnaam, of in het label van een lijn, met een kaartje bij erboven hangen.
- Soorten:
register.zoeksleutel,register.sorteerbaaren (gereserveerd)register.tekstzoekenop een veld van het canonieke model; daarnaast eigen marksoorten van het project (project.<naam>), in elke taal. - V3-bijlage: Exporteer V3 en de sidecar (
POST /export/v3, nieuwe optionele veldenmarksenmarkContext) zetten de geldende marks als blokmarksnaast het model; de codegen zoekt per mark het veld op de uuid. - E2e: de tests 02 en 17 slagen weer (alleen de tests waren verouderd).
- render 0.5.0: de code van studio 0.46.0, met de marks in
/export/v3en in het naspelen (/materialiseer,/vergelijk,/samenvoegen). Een render 0.4.9 werkt met deze Studio, maar kent dan geen marks: ze vallen weg bij samenvoegen en bij de serverexport.
Getest: Studio-unit 1790/1790, render-svc 34/34, e2e 185/185.
Uitrol:
- App:
viz-frontend:0.46.0enbitemp-render-svc:0.5.0viaupdate.sh. Geen schemawijziging en geen rebuild voor dit deel. - Fundament: frontend 0.46.0 en render 0.5.0, met de devloop van BACKEND (api 0.29.0); wat die vraagt staat in de melding van BACKEND.
api 0.28.0 / devloop 0.31.0 (2026-11-18)
Akkoord Mark 18-11 ("okee, release maar"). Studio blijft 0.45.0 en render 0.4.9; devloop 0.31.0 is api 0.28.0 met studio 0.45.0 en render 0.4.9. Aanleiding: het zaakmodel voor de loadtest (derde stack naast OneGround en Open Zaak) en wat de bouwproef daarvan aan het licht bracht.
- Indexen uit het model (
dbsetup/indexen.go,docs/INDEXEN.md): elke relatie krijgt een index op de doelkant(doel_id, bron_id), elk veld metuniekeen partiële index op de actuele stand. Ze worden bij start en rebuild aangemaakt (IF NOT EXISTS, niet fataal). Gemeten op een miljoen rijen: de omgekeerde relatie van 14 ms naar 0,07 ms, de uniekheidscontrole van 16 ms naar 0,02 ms per opvoer. - Fix codegen: een enum die meerdere domeinen gebruiken komt in één domein
(
model/v3_enum_domein.go,docs/CODEGEN.md§8). Voorheen compileerdemodelniet meer ("redeclared in this block"). De rebuild zet de domeinen in de goede volgorde. Gevonden door FACADE en AI-INRICHTEN. - Codegen: validatiefout als type/format het gegevenstype tegenspreken (
docs/CODEGEN.md§4). Een veld zonder goType met"type": "string"en datatype Geheel, JaNee, Datum of DatumTijd werd zonder melding een tekstveld. Een Studio-export heeft goType en valt erbuiten. - Melding bij een afwijkend kolomtype (
dbsetup/kolomtypen.go,docs/KOLOMTYPEN.md):dbsetupzet het type van een bestaande kolom niet om; een kolom die niet bij het model past, staat nu bij elke start in het logboek, met het statement dat hem zou omzetten. - BACKLOG §43: de kolomnaam van datumvelden wijkt af van andere velden (besluit: laten staan).
Getest: go test ./... groen (in de basismap; de EA-importtest heeft web/vite/node_modules
nodig), regressiesuite np-loc, afgeleide relaties en databaseproef groen met de indexen en de
kolomtypecontrole, oude en nieuwe codegen vergeleken op tien bestaande domeinen (uitvoer gelijk),
zaakmodel: codegen voor vier domeinen, build en zelftest in een proefkopie. Niet getest: een
rebuild via de devloop met het zaakmodel, en gelijktijdige belasting.
Uitrol:
- Schemawijziging: ja, alleen indexen. Bij de eerste start komen er indexen bij; geen tabel of kolom verandert. Op een grote tabel blokkeert het aanmaken schrijvers zolang het duurt.
- Rebuild uit het Studio-project: niet nodig. De codegen-wijzigingen werken pas bij de eerstvolgende rebuild.
- Andere stap: nee voor de release zelf. Los ervan: het migratiescript
docs/migraties/2026-11-18-cg-test-kolomtypen.sqlvoor vijf tekstkolommen op cg-test (akkoord Mark 18-11; FUNDAMENT voert het uit). - Na de eerste start: het logboek nalopen op regels
[dbsetup] LET OP: kolom …. - App en pf:
bitemp-go-api:0.28.0viaupdate.sh. Fundament:bitemp-devloop:0.31.0.
studio 0.45.0 / render 0.4.9 (2026-11-16)
Akkoord Mark 16-11 ("daarna 1 en 2 en daarna een release als je wilt"). api blijft 0.27.0; devloop (api 0.27.0 met studio 0.45.0 en render 0.4.9) bouwt FUNDAMENT.
- DMN-beslistabel in het project: op een beslissing in een DMN DRD bewerk je de tabel in een
dialoog (Eigenschappen → beslistabel). De invoerkolommen volgen uit de pijlen in het DRD; het veld
kies je op het invoergegeven (eigenschap gegeven, M3-datatype
veld-verwijzing). Een getekende «traceert naar» van een invoergegeven wordt dat gegeven. Een beslissing kan de uitkomst van een andere lezen: export (DMN-XML metrequiredDecision) en simulatie rekenen de keten uit. Profiel DMN DRD 1.1.0. - Projectboom: een diagram zonder map staat in de root; "Niet ingedeeld" is weg. De klassieke editors (dmn-js, bpmn.io, Canoniek model IDE v1, Berichtdefinities) zijn alleen nog zichtbaar voor een beheerder.
- Gebruikers → Projecten…: een gebruiker achteraf aan projecten toewijzen; in Toegang… een namenlijst met waarschuwing bij een onbekende naam.
- Simulatie (SIMULATIE): scenario's in het project (nieuw profiel Simulatiemodel, M3-aard
instantie), het object als objectdiagram en als kaart, alle scenario's toetsen, cm-vorm zonder e-dienstmodel, lijnen en objecten getoetst, Waterstede-scenario's. Profiel Object 1.1.0. - Fix: lijnen naast het vak na vergroten en weer verkleinen.
- Rondleiding: vier stappen erbij; BPMN-XML schrijft data-objecten; BPMN-import koppelt het type terug.
- render 0.4.9: de code van studio 0.45.0 (27 profielen, met Simulatiemodel; DMN DRD 1.1.0, Object 1.1.0).
Getest: Studio-unit 1769/1769 op main, render-svc 33/33, e2e 177 geslaagd (02 en 17 falen al langer op main).
Uitrol:
- App:
viz-frontend:0.45.0enbitemp-render-svc:0.4.9viaupdate.sh. Geen schemawijziging, geen rebuild. - Daarna zet DEMO-PROJECT de Waterstede-scenario's in het demo-project (script klaar).
- Fundament:
bitemp-devloopmet frontend 0.45.0 en render 0.4.9, door FUNDAMENT.
studio 0.44.0 / render 0.4.8 / devloop 0.30.2 (2026-11-15)
Akkoord Mark 15-11 ("Wil je releasen? Ook naar fundament"). api blijft 0.27.0; devloop 0.30.2 is api 0.27.0 met studio 0.44.0.
- Samenvoegen naar MAIN per veld: verschillende velden van hetzelfde element aan beide kanten geven geen conflict meer; een regel per veld in de boom, ook voor velden in een compartiment (gekoppeld op uuid, anders op naam; een hernoeming op dezelfde plek blijft één veld).
- Projectformaat 4: elk modelelement en veld van het canonieke model heeft een uuid. De Studio
vult ontbrekende aan bij het openen en na elke eigen wijziging, afgeleid (uuid v5), zodat
gelijktijdige clients en een branch met zijn MAIN dezelfde uuid's krijgen.
scripts/projecten-uuids-aanvullen.mjsvult alle projecten op een server in één keer aan. - Uuid's tonen (beheer): een instelling voor de beheerder.
- BPMN-data-object met een type (SIMULATIE): type uit een gegevenstaal (M3-aard
gegevens), rol invoer/uitvoer, toestand, lezen en schrijven; het type is de tracering «traceert naar»; gerelateerde elementen over talen heen. Profielversies: BPMN 1.2.0; canoniek, puur-UML, MIM, ERD 1.1.0. Donker thema: namen op het canvas leesbaar. - render 0.4.8: de code van studio 0.44.0 (samenvoegen per veld, profielversies). Een render 0.4.7 werkt met deze studio, maar voegt dan alleen per element samen.
Getest: Studio-unit 1713/1713 (na de merge), render-svc npm test 30/30 (scenario's 11 en 12
erbij), e2e 12, 23, 30, 58, 63 en 64 (22/22); SIMULATIE: e2e 33, 53, 54, 63, 64.
Uitrol:
- App:
viz-frontend:0.44.0enbitemp-render-svc:0.4.8viaupdate.sh. Geen schemawijziging, geen rebuild. Daarna (optioneel, aanbevolen) per server één keernode scripts/projecten-uuids-aanvullen.mjs --omnium <url>(kijken) en met--toepassen. - Fundament:
bitemp-devloop:0.30.2(met frontend 0.44.0 en render 0.4.8), door FUNDAMENT.
studio 0.43.0 / render 0.4.7 / devloop 0.30.1 (2026-11-14)
Akkoord Mark 14-11 ("C&M&R en daarna verder"). api blijft 0.27.0; devloop 0.30.1 is api 0.27.0 met studio 0.43.0.
- Fix, belangrijk voor Fundament: de automatische plaatsing van een element in de map van zijn diagram (BOOM-1) ging niet naar de server. De projectboom toonde het element in de map, maar alleen lokaal; anderen, de server en Verschil met MAIN zagen het "zonder map". Oorzaak: de plaatsing liep binnen de actie die haar uitlokte, en de sync legt alleen de buitenste actie vast. Nu is het een eigen operatie. Bestaande projecten herstellen bij het openen in een Studio 0.43.0.
- Samenvoegen naar MAIN: schuifje met drie standen per regel (↶ MAIN overnemen, – niets doen, → naar MAIN / MAIN overschrijven); diagrammen en elementen onder een package liggen nu in de map van dat package (op Fundament stonden ze "buiten de map"), met het package als ouder in de boom; diagrambundels staan in de boom en gaan niet meer zonder hun diagrammen; de boom toont het type uit het profiel (Entiteit, Gegevenselement, …).
- Startnaam met lidwoord: NieuweEntiteit, NieuwGegevenselement (M3
ElementType.lidwoord). - render 0.4.7: de code van studio 0.43.0 (vergelijken en samenvoegen met packages en bundels). Een render 0.4.6 werkt nog met deze studio, maar mist dan packages en bundels in de vergelijking.
Getest: Studio-unit 1685/1685, render-svc npm test 28/28 (scenario's 9 en 10 erbij), e2e 23, 46,
54, 58, 62 en 63; lokaal door Mark met echte API en sidecar.
Uitrol:
- App:
bitemp-render-svc:0.4.7enviz-frontend:0.43.0viaupdate.sh. Geen schemawijziging. - Fundament:
bitemp-devloop:0.30.1(met frontend 0.43.0 en render 0.4.7), door FUNDAMENT.
studio 0.42.0 / render 0.4.6 / api 0.27.0 / devloop 0.30.0 (2026-11-14)
Akkoord Mark 14-11 ("eerst C&M en misschien zelfs minor releasen, want een andere klus wacht op een duidelijke merge"). Branch terugmergen, stap 2a.
- Kiezen met vinkjes in een boom in Verschil met MAIN…: map → submap → diagram of element → relatie onder haar bron. Gekozen gaat naar MAIN; niet gekozen blijft in de branch en komt bij de volgende vergelijking terug. Een conflict blokkeert niet meer (aan = de branch wint). Wat buiten de map ligt staat standaard uit.
- Terugzetten naar MAIN (↶ per regel, keuze
"terug"): de branch neemt de versie van MAIN letterlijk over, ook "geen kleur". - Vangnet samenhang: een keuze die een verwijzing stuk maakt (relatie zonder bron of doel,
node zonder element, koppeling zonder kant, plaatsing zonder map) weigert de API met
409 reden "samenhang". - api 0.27.0:
keuze(true|false|"terug") opPOST …/samenvoegen, doorgegeven aan de sidecar; antwoord metopgelost. Zonderkeuzewerkt het als in 0.26.0. - render 0.4.6:
keuzeop/samenvoegen(opgelost,samenhangin het antwoord);/vergelijkgeeft per verschilsleutel,mapId,ouderIden demappen. Een sidecar 0.4.5 weigertkeuze(400 → 502 in de API), dus api en render samen uitrollen. - devloop 0.30.0 = api 0.27.0 met studio 0.42.0.
Getest: Studio-unit (incl. keuzeBoom.test.js), render-svc npm test met de nieuwe scenario's over
meerdere rondes (samenvoegScenario.test.mjs, 8 scenario's), Go met integratietest tegen Postgres,
e2e 63 en 58. Lokaal door Mark met echte API en sidecar ("lijkt wel goed te werken").
Uitrol:
- App:
bitemp-go-api:0.27.0,bitemp-render-svc:0.4.6enviz-frontend:0.42.0viaupdate.sh. Geen schemawijziging. - Fundament:
bitemp-devloop:0.30.0(met frontend 0.42.0 en render 0.4.6), door FUNDAMENT.
studio 0.41.0 / render 0.4.5 / api 0.26.0 / devloop 0.29.0 (2026-11-14)
Akkoord Mark 14-11. Neemt studio 0.40.0 / render 0.4.4 mee: die zijn getagd, maar er zijn geen images van gebouwd. Deze release is dus de eerste die de simulatie uitrolt.
- Branch samenvoegen naar MAIN, stap 1 (plan
docs/plans/2026-11-14 Branch terugmergen …): knop Samenvoegen naar MAIN in Verschil met MAIN…. Alles uit de branch gaat naar main, een conflict blokkeert, daarna haalt de branch main op en wordt die stand de nieuwe basis. Wijzigingen buiten de afgesplitste map gaan alleen na bevestiging mee.- api 0.26.0:
POST /api/studio/projecten/:id/samenvoegenschrijft de ops voor main en branch in één transactie en vervangt de basis; 409 met redenconflicten,buiten_mapofvolgnummer_verschoven. Ook de CORS-headerX-Omnium-Client(al op main, alleen voor dev). - render 0.4.5:
POST /samenvoegenrekent het samengevoegde model en de ops uit en speelt ze ter controle na. Een oudere sidecar geeft 502 met redensidecar.
- api 0.26.0:
- Uit studio 0.40.0: simulatie van BPMN en DMN met cm-objecten, BPMN-profiel 1.1.0, JUEL naar CEL; Modelleren, Koppelingen en Profielontwerp geen preview meer; zie de 0.40.0-entry hieronder.
- devloop 0.29.0 = api 0.26.0 met studio 0.41.0.
Getest: Studio-unit 1667/1667, render-svc 17/17, go test ./handlers/ (samenvoegen ook als
integratietest tegen Postgres), e2e 63 en 58; lokaal door Mark met echte API en sidecar.
Uitrol:
- App:
bitemp-go-api:0.26.0,bitemp-render-svc:0.4.5enviz-frontend:0.41.0viaupdate.sh. Geen schemawijziging. - Fundament:
bitemp-devloop:0.29.0(met de frontend 0.41.0 en render 0.4.5), door FUNDAMENT.
studio 0.40.0 / render 0.4.4 (2026-11-14)
Akkoord Mark 14-11. api blijft 0.25.0.
- Simulatie van BPMN en DMN met cm-objecten (activiteit Simulatie), met het GPK-voorbeeld in vier processen, signalen met een filter over de zaak, Stap/Afspelen/Doorlopen en JUEL naar CEL.
- BPMN-profiel (M2) 1.1.0: signaalnaam, filter en één instantie per zaak op events, kandidaatgroep op gebruikerstaken. Een Studio 0.39.0 meldt bij een project dat met 1.1.0 is bewaard dat er velden kunnen ontbreken; bewerken mag.
- Studio: Modelleren, Koppelingen en Profielontwerp zijn geen preview meer; de rondleiding noemt de diagrambundels.
- Render 0.4.4: de profielen van studio 0.40.0 in de bundel (BPMN 1.1.0).
- Op main, nog niet in een api-release: CORS staat de header
X-Omnium-Clienttoe (alleen nodig voor de Studio op een Vite-poort in dev).
Uitrol:
- App:
bitemp-render-svc:0.4.4enviz-frontend:0.40.0viaupdate.sh. - Fundament: een devloop met studio 0.40.0 is niet gebouwd; op verzoek.
studio 0.39.0 / render 0.4.3 / devloop 0.28.4 (2026-11-12)
Akkoord Mark 12-11. api blijft 0.25.0; devloop 0.28.4 is api 0.25.0 met studio 0.39.0.
- Versie per profiel (M2), genoteerd in het project (M1):
profielVersiesin het werkbestand; een oudere Studio meldt een project dat op een nieuwere profielversie leunt. Bewaking inrender-svc/profielVersies.vast.json(versie + vingerafdruk van de structuur per profiel). - Klembord over projecten en tabs (KLEM-1): kopiëren in het ene project, plakken in het andere, als hetzelfde element of als kopie.
- Werkkopie per project (TAB-1): twee tabs met twee projecten halen elkaars werk niet meer door elkaar. De bestaande werkkopie in de browser verhuist één keer mee naar haar project; werkkopieën die 30 dagen niet zijn bewerkt worden opgeruimd.
- Render 0.4.3: dezelfde tekenaar; de bundel bevat de profielen met hun versie.
Let op: een oudere Studio-versie leest de nieuwe werkkopie-sleutels niet. Na een rollback van de frontend is lokaal werk dat niet op de server staat daar niet zichtbaar.
Uitrol:
- App:
bitemp-render-svc:0.4.3enviz-frontend:0.39.0viaupdate.sh. - Fundament:
bitemp-devloop:0.28.4, door FUNDAMENT.
studio 0.38.3 / devloop 0.28.3 (2026-11-10)
Patch (akkoord Mark 10-11). render blijft 0.4.2; devloop 0.28.3 is api 0.25.0 met studio 0.38.3.
- Canvas: na een diagramwissel nam een element de maat mee die je hem op het vorige diagram met de muis gaf; lijnen eindigden dan naast het vak in het niets (evenementen-branch). Opgelost.
- Projectsync: een antwoord dat nog onderweg was voor het vorige project (MAIN ↔ branch) wordt genegeerd.
- Menubalk: de naam van het open project naast Project; een branch als "⑂ naam (van MAIN)".
Uitrol:
- App:
viz-frontend:0.38.3viaupdate.sh. - Fundament:
bitemp-devloop:0.28.3, door FUNDAMENT.
studio 0.38.2 / devloop 0.28.2 (2026-11-10)
Patch (akkoord Mark 10-11). render blijft 0.4.2; devloop 0.28.2 is api 0.25.0 met studio 0.38.2.
- V3-delta-import:
erftwordt ook eengeneralisatievoor een nieuwe entiteit die op geen van de meegebrachte diagrammen staat (bv. bij de export van een project als basis). Melding AI-INRICHTEN.
Uitrol:
- App:
viz-frontend:0.38.2viaupdate.sh. - Fundament:
bitemp-devloop:0.28.2, door FUNDAMENT.
studio 0.38.1 / devloop 0.28.1 (2026-11-10)
Patch (akkoord Mark 10-11). render blijft 0.4.2; devloop 0.28.1 is api 0.25.0 met studio 0.38.1.
- V3-delta-import (Importeer V3 in project):
erftwordt eengeneralisatie-connector, ook als het project al iets bevat (ging verloren); een V3.1-veld zondergoTypeen zonderverplichtis optioneel (werd verplicht). Melding AI-INRICHTEN. - E2E-test voor Branch maken….
Uitrol:
- App:
viz-frontend:0.38.1viaupdate.sh. - Fundament:
bitemp-devloop:0.28.1, door FUNDAMENT.
api 0.25.0 / devloop 0.28.0 (2026-11-10)
Werkplaats laag 2 (akkoord Mark 10-11). devloop 0.28.0 is api 0.25.0 met studio 0.38.0 (daarin
ook feat/fd-formulier); render blijft 0.4.2.
GET /api/studio/projecten/:id/model/:profiel: de actuele stand van één profiel (bv.formulierdiagramvan een branch) pluslaatsteVolgnummer, zodat Imprint de Studio-stores niet hoeft na te bouwen. Blob, ops opmodel:<profiel>en het laatste volgnummer in één REPEATABLE READ-transactie; naspelen door render-svcPOST /materialiseer(render 0.4.2, al uitgebracht). Een oudere sidecar geeft 502 met redensidecar.- Eén branch per ouder + map:
POST …/afsplitsenmet eenmapIdgeeft409 {reden: "branch_bestaat", projectId}als er al een niet-gearchiveerde branch voor die map is. Zo komen "Branch maken" in de Studio en de werkplaats op dezelfde branch uit.
Getest: go test ./... slaagt (behalve de EA-test die node_modules nodig heeft), met nieuwe
integratietests (model-route met een nep-sidecar; branch_bestaat, ook na archiveren).
Uitrol:
- Fundament:
bitemp-devloop:0.28.0, door FUNDAMENT. Geen schemawijziging. - App: niet nodig.
api 0.24.0 / devloop 0.27.0 (2026-11-10)
Vervolg op de branches en het schrijfkanaal voor de werkplaats (werkplaats-plan §4B, akkoord Mark 10-11). studio blijft 0.36.0 en render 0.3.9; devloop 0.27.0 is api 0.24.0 met studio 0.36.0.
GET /api/studio/projecten/:id/vergelijk: de API stelt basis, branch en ouder samen (elk{profiel, ops}) en geeft ze met demapIddoor aan de render-sidecar (POST /vergelijk). Het antwoord gaat door metmain/tak: {projectId, laatsteVolgnummer}erbij. Lezen op branch én ouder. Werkt pas met een render-svc die/vergelijkkent (OMNIUM-UI, nog niet uitgebracht); tot dan 502 met redensidecar.namensopPOST …/ops: de eindgebruiker voor wie een serviceaccount schrijft (Imprint viaomnium-schrijver). Alleen van accounts in envOMNIUM_NAMENS_ACCOUNTS, anders 403namens_niet_toegestaan.actorblijft het account;namensstaat ernaast inGET …/opsen SSE. Schema: kolomstudio_project_ops.namens(ADD COLUMN IF NOT EXISTS).
Getest: go test ./... slaagt (behalve de EA-test die node_modules nodig heeft), met nieuwe
integratietests tegen Postgres (vergelijk met een nep-sidecar; namens voor serviceaccount en
modelleur).
Uitrol:
- Fundament:
bitemp-devloop:0.27.0, door FUNDAMENT, metOMNIUM_NAMENS_ACCOUNTS=omnium-schrijver, het accountomnium-schrijver(rol modelleur, token in de secret) en een toegangsrijschrijvenop het project Inrichten. - App: niet nodig.
api 0.23.0 / devloop 0.26.0 (2026-11-10)
Branchen van een Studio-project, stap 1 (werkplaats-plan §4B, akkoord Mark 09-11). studio blijft 0.36.0 en render 0.3.9; devloop 0.26.0 is api 0.23.0 met studio 0.36.0.
- Afgeleide projecten. Een branch is een eigen project dat van een ouder is afgesplitst, zodat
operatielog, SSE, compactie, toegang, export/v3 en render ongewijzigd werken.
POST /api/studio/projecten/:id/afsplitsen {naam, mapId?, id?}maakt hem in één transactie metFOR UPDATEop de ouder. De blob,tot_volgnummeren de staart-ops (met dezelfde volgnummers) komen van de ouder, net als de toegang; wie afsplitst wordt eigenaar.GET …/:id/basisgeeft de onveranderlijke basis (profiel+ops) uit de nieuwe tabelstudio_project_basis, voor een 3-weg-merge. De compactie raakt hem niet.- Lijst en
GETtonenherkomst {ouderProject, basisVolgnummer, mapId, afgesplitstOp, afgesplitstDoor, gearchiveerd}. De server kent geen mappen:mapIdis alleen herkomst. - De van de ouder gekopieerde ops tellen niet mee voor
project_in_gebruik.
verwachtLaatsteVolgnummeropPOST …/ops(optioneel): 409volgnummer_verschovenals het project verder is. Voor de merge naar de ouder en als revisiecheck per op.- Schema: kolommen
ouder_project_id,basis_volgnummer,map_id,gearchiveerdopstudio_projecten(ADD COLUMN IF NOT EXISTS) en de tabelstudio_project_basis.
Nog niet: mergen (/vergelijk, /samenvoegen, stap 3) en namens voor serviceaccounts.
Getest:
go test ./...slaagt (behalve de EA-test die node_modules nodig heeft), met nieuwe integratietests tegen Postgres: afsplitsen na compactie, basis na compactie van de branch, toegang, verwijderen, 409 op het volgnummer, en afsplitsen terwijl vier clients ops sturen.
Uitrol:
- Fundament:
bitemp-devloop:0.26.0, door FUNDAMENT. - App: niet nodig.
studio 0.38.0 / render 0.4.2 / devloop 0.27.3 (2026-11-10)
Akkoord Mark 10-11. api blijft 0.24.0; devloop 0.27.3 is api 0.24.0 met studio 0.38.0.
- Studio: Branch maken… op een map (biedt een bestaande branch voor die map aan), het e-dienstformulier als FormulierDefinitie, kortere kop voor een conditioneel blok.
- Render:
POST /materialiseer— één profiel nagespeeld (blob-deel + de ops opmodel:<profiel>); nodig voorGET /api/studio/projecten/:id/model/:profielvan de backend.
Uitrol:
- App:
bitemp-render-svc:0.4.2enviz-frontend:0.38.0viaupdate.sh. - Fundament:
bitemp-devloop:0.27.3, door FUNDAMENT.
studio 0.37.1 / render 0.4.1 / devloop 0.27.2 (2026-11-10)
Patch (akkoord Mark 10-11). De mapvolgorde hangt niet meer van de klok af: na afsplitsen meldde Verschil met MAIN schijnconflicten op mappen, en clients konden de volgorde verschillend naspelen. api blijft 0.24.0; devloop 0.27.2 is api 0.24.0 met studio 0.37.1.
studio 0.37.0 / render 0.4.0 / devloop 0.27.1 (2026-11-10)
Akkoord Mark 10-11. api blijft 0.24.0; devloop 0.27.1 is api 0.24.0 met studio 0.37.0.
- Branch stap 1: het Project-menu toont de herkomst van een afgeleid project en Verschil met MAIN… (nieuw, gewijzigd, weg, conflict, alleen op MAIN; filter op de map). Van server ophalen… noemt "branch van …".
- Render 0.4.0: nieuwe route
POST /vergelijk(drieweg op de nagespeelde stand), met een eigen grens van 32 MB (RENDER_SVC_MAX_BYTES_VERGELIJK).GET /api/studio/projecten/:id/vergelijk(api 0.24.0) gebruikt hem; zonder deze sidecar geeft die route 502. - FormulierDefinitie voor e-diensten (FORMULIERDEFINITIES.md §2.6):
stap; op een veldverplicht(alleen strenger),key,elementId; vormbestand;invoegen {formulier}(sjabloon, opgelost bij het lezen); getypte conditiewaarde. De profiel-round-trip verliest geen eigenschappen meer. - Werkplaats: herkomst per levering (
generatie,studioProjectId,totVolgnummer), traceregels per modelveld,formulier-neutraalnaast elk formulier.
Uitrol: app (frontend + render), Fundament via FUNDAMENT (devloop 0.27.1 + render 0.4.0).
studio 0.36.0 / render 0.3.9 / devloop 0.25.7 (2026-11-09)
Kleine release voor de demo van 10-11 (akkoord Mark 09-11). api blijft 0.22.3; devloop 0.25.7 is api 0.22.3 met studio 0.36.0.
- Inrichtingsartefacten:
- de dossierlijst als artefact (
gzac-case-list-json, regelset dossier 0.7.0); - het tabblad met widgets in het GZAC-dossier, met de pasfoto-widget (
bron); - de samenvatting met aanvraagtype, partijen en bijlagen;
- een registratietitel per bestandsveld in Open Formulieren;
bronElementId= het Studio-id (uuid apart alsbronUuid);- een bpmn-artefact haalt zijn proces uit het project (
bron.model: "project:<profiel>").
- de dossierlijst als artefact (
- BPMN naar GZAC, regelset 0.8.1: de portaaltaak gaat naar
zaakInitiator; geen PL-ACTIE bij een taak die alleen procesvariabelen zet. - BPMN-tekening: tandwiel voor de servicetaak; een taak mag smaller (minimum 90 px) en het selectiekader volgt de getekende vorm.
- Render: dezelfde tekenaar, dus het tandwiel ook in de SVG's.
Uitrol: app (frontend + render), Fundament via FUNDAMENT.
studio 0.35.0 / render 0.3.8 / devloop 0.25.6 (2026-11-08)
Release voor de demo van 10-11 (akkoord Mark 08-11). api blijft 0.22.3; devloop 0.25.6 is api 0.22.3 met studio 0.35.0.
-
BPMN naar GZAC, regelset
bpmn-naar-gzac0.8.0: het generieke beoordelen met berichten.- Een werpend bericht wekt een wachtend proces (
correlate()) of start er een. - De berichtnaam kan een variabele zijn.
- Een taak kan vaste procesvariabelen zetten.
- Een pool als deelnemer (Klantportaal) is documentatie.
- Een gebruikerstaak kan een portaaltaak worden (
create-portaaltaak).
Zie docs/TRANSFORMATIES.md.
- Een werpend bericht wekt een wachtend proces (
-
Call activity: dikke rand en ⊞; variabelen erheen en terug (
camunda:in/camunda:out, regelset 0.7.0). -
Studio:
- het domein komt uit het package (alleen-lezen bij GE en relatie);
- geen "0.5 preview"-strook meer;
- een tabnaam is cursief zolang een wijziging nog niet op de server staat.
-
Render:
/export/v3gebruikt dezelfde domeinafleiding.
Uitrol: app (frontend + render), Fundament via FUNDAMENT.
api 0.22.3 / devloop 0.25.5 (2026-11-08)
Patch voor de startup-rebuild (devloop); studio blijft 0.34.1 en render 0.3.7.
-
Een nieuwe pod start weer mét de gebouwde domeinen. De startup-rebuild genereerde alle domeinen van
gebouwde_domeinenopnieuw uit het model, ook het standaardpakket. Op cg-test kwamide_bestandenzo uit het Studio-model, en dat past niet bij de handgeschreven handlers. De build faalde, en elke nieuwe pod startte zonder inrichting. Nu:- elk domein op de lijst draagt de vlag
gegenereerd; - de startup-rebuild genereert van het standaardpakket alleen de domeinen met die vlag;
- een lijst van vóór deze release (zonder vlaggen) genereert van het standaardpakket alleen
register; - een project-rebuild zonder lijst neemt van het standaardpakket ook alleen
registermee.
Zie DEVLOOP.md §"Standaardpakket bij de startup-rebuild".
- elk domein op de lijst draagt de vlag
Getest:
go test ./...slaagt, met nieuwe tests voor de keuze en de opslag van de vlag.- Proef in een verse devloop-container: een model met een niet-passend ide-bestanden, een rebuild van een proefdomein, daarna een nieuwe container op dezelfde database. De startup-rebuild sloeg het standaardpakket over, de build slaagde en het proefdomein antwoordde.
Uitrol:
- Fundament:
bitemp-devloop:0.25.5, door FUNDAMENT. Versie 6 op cg-test start daarmee goed, zonder nieuwe rebuild. - App: niet nodig.
api 0.22.2 / devloop 0.25.4 (2026-11-08)
Patch voor codegen; studio blijft 0.34.1 en render 0.3.7.
- Een meerregelige beschrijving breekt de build niet meer. Codegen zette een beschrijving uit
de Studio als
// <Type> — <beschrijving>in de code. De regel na een regelovergang werd dan code:non-declaration statement outside function body, bij de rebuild van Inrichten op cg-test.goCommentaarzet nu//voor elke volgende regel. Dat geldt voor entiteiten, GE's, relaties, datatypes en de bestandskop (CODEGEN.md §7.3g).
Getest: go test ./... slaagt. De nieuwe test gen_commentaar_test.go parseert alle gegenereerde
bronnen met een beschrijving met regelovergangen, een lege regel en een apostrof. Zonder de fix
faalt die test zoals op cg-test.
Uitrol: Fundament bitemp-devloop:0.25.4, door FUNDAMENT. App is niet nodig, want alleen codegen
verandert.
studio 0.34.1 / render 0.3.7 / devloop 0.25.3 (2026-11-08)
Patch voor de rebuild van het project Inrichten vóór de demo (akkoord Mark 08-11). api blijft 0.22.1; devloop 0.25.3 is api 0.22.1 met studio 0.34.1.
- V3-export:
doelEntiteit= de naam van het doel (FUNDAMENT 08-11). Na een hernoeming verschillen element-id en naam; de export zette het id, zodat de relatie (GpkKaartAanvraag → Gehandicaptenparkeerkaartaanvraag) naar een niet-bestaande entiteit wees. Raakt/export/v3in de render-sidecar en dusGET /api/studio/projecten/:id/v3. - Verder in deze Studio: de inrichtingsexport uit een Studio-project en de referentielijst als
veldtype in de lezer (zie
web/vite/CHANGELOG.md, docs/TRANSFORMATIES.md §11.16).
Uitrol: app (frontend + render), Fundament via FUNDAMENT.
api 0.22.1 / devloop 0.25.2 (2026-11-08)
Patch voor de nieuwe richting van de items-relatie (plan 2026-11-07 Referentielijst-instanties, §1). Die staat nu op het referentielijst-item en wijst naar Referentielijst. Nodig voor de rebuild van het project Inrichten op cg-test vóór de demo (akkoord Mark 08-11). Studio blijft 0.34.0, render 0.3.6.
- Eigen tabel
<item>_<relatie>voor zo'n relatie, bijvoorbeeldaanvraagtypedefinitie_aanvraagtypemet_data,_aanvangen_einde.- Marks naamregel geeft de relatie de naam van het oude item (Aanvraagtype naast AanvraagtypeDefinitie). Met tabel = relatienaam hergebruikte de nieuwe relatietabel de tabel van de oude entiteit, mét haar rijen.
- De Go-typenaam blijft de relatienaam.
- De oude richting (bijvoorbeeld
landenlijstland) verandert niet.
- Niet meer onder Referentielijst. Codegen hing de relatie ook onder Referentielijst
(
VoegOnderliggendGEToe). Daar koppelde hij via<item>_id = referentielijst.id, dus met de rijen van het verkeerde item.
Getest:
go test ./...slaagt, met een nieuwe codegen-test voor beide richtingen.- Proef in een eigen devloop-container: eerst de oude entiteit Aanvraagtype met 3 rijen, daarna een
rebuild naar AanvraagtypeDefinitie met de relatie Aanvraagtype.
- De oude tabel bleef onaangeroerd.
- Een Referentielijst-record en twee items met lidmaatschap registreren werkte.
GET /full/<item>/:idtoontreferentielijst_id.- Referentielijst toont geen vreemde leden.
- Zie CODEGEN.md §8.
Nog niet gebouwd (plan §8):
- de seed en binding van instanties;
- de controle dat het lidmaatschap het gebonden record raakt (33.4);
- de opties-route voor een
$refnaar zo'n relatie.
Uitrol:
- Fundament:
bitemp-devloop:0.25.2, door FUNDAMENT. - App: niet nodig, want alleen codegen verandert.
bitemp-go-api:0.22.1staat wel op Hub.
studio 0.34.0 / render 0.3.6 / devloop 0.25.1 (2026-11-08)
Samen uitgebracht met api 0.22.0 (hieronder, nu pas gepusht). Geen Go-wijzigingen; devloop 0.25.1
is api 0.22.0 met de Studio van 0.34.0. Details: web/vite/CHANGELOG.md.
- Studio: elementen uit een andere taal op een diagram; koppelingen (kruisverbanden) als
dependency-lijnen met een bewerkbare soortenlijst per project (
koppelsoortenin de project-JSON, sync-operatiekruis/zetSoorten); leesrichtingspijl langs de lijn; Delete is één undo-stap; gerelateerde elementen toevoegen; een referentielijst als veldtype (plan Referentielijst-instanties §8, deel 1:$ref= de items-relatie, overgang via de item-entiteit; bestaande$ref-velden worden bij het laden omgezet); de assistent en de MCP wijzigen velden (verplicht, type, naam) en laten sequence-berichten niet meer samenvouwen (AI-3); SHACL-profiel (preview) en ODRL AssetCollection (M2). - Render 0.3.6: dezelfde tekenaar als de Studio (leesrichtingspijl,
$ref-labels). - Let op: de backend-kant van de referentielijst-verwijzing (opties-route voor een items-relatie, codegen-controle, registratiecontrole §33.4) volgt nog.
api 0.22.0 / devloop 0.25.0 (2026-11-07)
Het register heeft een eigen, expliciete domeinenlijst (besluit Mark 07-11). Het Studio-model mag meer domeinen hebben dan er gegenereerd worden. Studio blijft 0.33.0, render 0.3.5.
- Domeinkeuze bij
POST /admin/rebuild:domeinen: een lijst namen, of{domein, prefix};alle_domeinen: true;- een Studio-project zonder lijst bouwt de bestaande domeinen (in het register én in het model).
precies: truemaakt de lijst de samenstelling van het register. Andere domeinen gaan eruit: hun bestanden en init-aanroepen. Het standaardpakket blijft altijd staan: beheer, configuratie, financieel, gegevenstypen, ide_bestanden en register.- Wijst een overgebleven domein nog naar een weggelaten type, tabel of datatype, dan weigert de
rebuild met 422, reden
verwijzingen, met de plek erbij. Op dit moment geldt dat voor register → AdellijkeTitel (np-loc).
- Wijst een overgebleven domein nog naar een weggelaten type, tabel of datatype, dan weigert de
rebuild met 422, reden
schema_versies.gebouwde_domeinen: elke actieve versie onthoudt haar domeinen. De startup-rebuild bouwt precies die lijst, zodat een verse container geen ingebakken domeinen terugbrengt.GET /admin/schema/versiestoont de lijst en ookbron_project_*; die herkomstvelden ontbraken sinds 0.21.0.- Opruimen van achtergebleven tabellen (alleen devloop, met het beheerwachtwoord):
GET /admin/wees-tabellenenPOST /admin/wees-tabellen/opruimen {tabellen};- alleen tabellen van types die niet meer in de MetaRegistry staan, die leeg zijn en waar geen wijzigingen naar verwijzen;
- de lijst moet gelijk zijn aan het overzicht;
- één
DROPzonder CASCADE.
- Devloop-image: bewaart
/app/_image/modelals onveranderlijke referentie. - GitAdres is een algemeen datatype in gegevenstypen, met een controleregel voor https, ssh, git en gebruiker@host:pad. Het stond in CG; inrichting gebruikt het ook.
- Codegen (voorbereiding op gegevenstypen uit het model, CODEGEN.md §7.3f):
ExterneReferentieen alle weergavevelden gaan mee;- het domein gegevenstypen krijgt een canonieke registry die vervangt in plaats van toevoegt;
- simulatie export → codegen: 0 verschillen, ronde 2 byte-gelijk. Zolang een rebuild gegevenstypen niet expliciet noemt, blijft het handgemaakte bestand staan.
Getest:
go test ./...slaagt (de EA-test draait met node).- Alle 1443 JS-tests slagen.
- E2E in een eigen devloop-container:
- de weigering op verwijzingen werkt;
preciesmet [CG, np-loc, org-geo] haalde 68 tabellen van drie domeinen weg; de zelftest en de databaseproef slaagden;- een verse container bouwde dezelfde lijst;
- het opruimen weigerde een verkeerde lijst (409) en ruimde de goede op (349 → 281 tabellen).
Uitrol:
- Image
bitemp-go-api:0.22.0, daarna./update.shop app. De kolomgebouwde_domeinenkomt er bij het opstarten bij. - Op app verandert er niets: geen lijst betekent additief, zoals voorheen.
- Fundament:
bitemp-devloop:0.25.0. Om de demodomeinen uit cg-test te halen: een rebuild metdomeinenenprecies: true, daarna de wees-tabellen opruimen (DEVLOOP.md §"Domeinen van het register").
api 0.21.1 / devloop 0.24.14 (2026-11-07)
Patch voor twee fouten die FUNDAMENT op cg-test vond. Studio blijft 0.33.0, render 0.3.5.
- Een veld dat uit het model verdween, brak elke nieuwe opvoer van dat type. Een additieve
rebuild laat de kolom van zo'n veld bewust staan, want de waarden zijn historie.
INSERT … RETURNING *gaf hem dan terug, en bun weigerde:Artefact_ArtefactInhoud_Data does not have column "formaat"(500, na schema-versie 3/4). Nu:- de database draait met
bun.WithDiscardUnknownColumns(); - dbsetup maakt een vervallen kolom die NOT NULL is zonder standaardwaarde nullable, bij het opstarten en verliesvrij;
- elke vervallen kolom wordt gelogd (
[dbsetup] vervallen kolom …). Er wordt niets weggegooid; opruimen metDROP COLUMNblijft een bewuste beheerdersstap (CODEGEN.md §7.3e).
- de database draait met
- De upgrade naar 0.24.13 gaf ongeveer twee minuten uitval. De startup-rebuild las
schema_versiesmet alle kolommen van het model, vóór de migratie diebron_project_idtoevoegt. Dat gaf "column does not exist", waarna de ingebakken code startte en het register 404 gaf. De laders lezen nu alleenid,schema_jsonenstatus(DEVLOOP.md §Startup-rebuild).
Getest: go test ./... groen. Twee nieuwe proeven tegen PostgreSQL spelen beide gevallen na:
- een tabel met een vervallen
formaat VARCHAR NOT NULL: de insert lukt en de oude waarde blijft; - een
schema_versieszonder de nieuwe kolommen: de oude code gaf de fout van cg-test, de nieuwe laadt de actieve versie.
Uitrol: image bitemp-go-api:0.21.1, daarna ./update.sh op app. Geen migratie en geen nieuwe
instellingen. Fundament: bitemp-devloop:0.24.14, uitrol door FUNDAMENT.
api 0.21.0 / studio 0.33.0 / render 0.3.5 (2026-11-07)
Het Studio-project wordt de bron van het register (besluit Mark 07-11: "het model is de bron voor het genereren"). Op Fundament bouwde de rebuild uit een V3-bestand in een repo, terwijl de Studio uit losse domeinbestanden gevuld was; die liepen uit elkaar.
Api 0.21.0 / devloop 0.24.13 (BACKEND):
POST /admin/rebuild {project_id, domeinen?, profiel?}(alleen devloop, rol admin plus beheerwachtwoord, zoals elke rebuild). De API knipt het canonieke profiel (diagram05) uit de snapshot van het project en laat de render-sidecar er V3 van maken. Er is geen tweede omzetting in Go. Zonderdomeinenworden alle domeinen van het model gebouwd. De gebouwde versie wordt actief metbron: "studio-project"en de herkomstbron_project_id,bron_project_versieenbron_tot_volgnummer, die ook inGET /api/schema/versiesstaat.- Weigeringen hebben een
reden:achterstand(409): er zijn wijzigingen ná de snapshot. Zet eerst een snapshot; de Studio doet dat zelf.bezig(409): er loopt al een rebuild.geen_project(404).geen_profielofexport(422), met demeldingenvan de Studio-controle.sidecar(502): de sidecar is onbereikbaar of ouder dan 0.3.5.
GET /api/studio/projecten/:id/v3(ingelogd plus leesrecht, ook met een API-token, ook op app): het V3-model van het project zonder te bouwen,{model, meldingen, bron}. Ook bij achterstand;bron.achterstandzegt hoeveel wijzigingen er niet in zitten. Bedoeld voor pariteit met een V3-bestand.- Codegen: een subtype heeft geen eigen tijdlijn.
isMaterieel: trueoftijdprecisieop een entiteit meterftlaat codegen (dus ook een rebuild) falen, met de melding dat de tijdlijn van de ouder komt (CODEGEN.md §7.3d). Dit zat al in devloop 0.24.12; nu ook in de api-tag. - Migratie bij het opstarten: drie kolommen op
schema_versies(ADD COLUMN IF NOT EXISTS).
Render 0.3.5 (OMNIUM-UI): POST /export/v3 {profiel, ops?, profielId?} →
{model, meldingen, nagespeeld, renderVersie}. Eerst draaien de modelmigraties van het profiel
(overerving, «gebruikt», composities), daarna dezelfde export als Exporteer V3. ops speelt
bewerkingen ná de snapshot na; de rebuild gebruikt dat nog niet. De bundel trekt nu zustand,
zundo en react mee; die staan als devDependencies in render-svc, zodat Dockerfile.render bouwt.
Studio 0.33.0 (OMNIUM-UI): Project → Register bouwen… zet eerst een snapshot, vraagt het
beheerwachtwoord, bouwt via /admin/rebuild {project_id} en wacht op /health. Het item staat er
alleen als de server een devloop is; op app (404 op /admin/rebuild/status) blijft het weg.
Getest op main b9052c31 (BACKEND): 1441 unit, vite build, render-svc 9/9, Studio-e2e 112/112 (eigen
Vite op 5182), go test ./... groen, ook tegen PostgreSQL. De keten api → sidecar is beproefd
met een echt model: Portfolio.v3 → profiel → /export/v3 → rebuild-invoer gaf dezelfde
entiteiten, GE's, materialiteit, enums en datatypes. Niet beproefd: een volledige rebuild in een
devloop-container uit een project.
Uitrol: images bitemp-go-api:0.21.0, bitemp-viz-frontend:0.33.0 (met --build-arg VITE_GIT_SHA=$(git rev-parse --short HEAD)) en bitemp-render-svc:0.3.5, daarna ./update.sh op
app. Geen nieuwe instellingen. Op app bestaat alleen de leesroute …/v3, want de rebuild is
devloop-only. Fundament: bitemp-devloop:0.24.13, frontend en render op digest, uitrol door
FUNDAMENT. Render 0.3.5 moet er zijn vóór een rebuild uit een project.
studio 0.32.0 / render 0.3.4 (2026-11-06)
Een avond met Mark en FUNDAMENT in het registermodel: overerving en «gebruikt» worden echte
modelgegevens, en een subtype heeft geen eigen tijdlijn. Api blijft 0.20.0. Details:
web/vite/CHANGELOG.md (studio 0.32.0).
Model (Mark/FUNDAMENT): erft uit een V3-import wordt één generalisatie-connector,
getekend op elk diagram waar beide entiteiten staan; oude projecten worden bij het openen
gevouwen (ERFT-1). Een veld van het type van een enumeratie, gegevenstype of
referentielijst-item legt zelf een «gebruikt»-lijn en haalt hem weer weg (GEBR-1).
Subtype zonder eigen tijdlijn (besluit Mark): een subtype ís een exemplaar van zijn ouder,
dus aanvang en einde horen bij de ouder. Bij een subtype staan materieel en tijdprecisie in de
inspector uit, met "De tijdlijn komt van erft (CODEGEN.md §7.3d). Die controle zit in
devloop 0.24.12; het api-image van app voert geen codegen uit en blijft 0.20.0.
Canvas: kopiëren en plakken via rechtsklik en als kopie (Ctrl+Shift+V); een diagram kopiëren en elders plakken in de projectboom; klik op de achtergrond toont het diagram in de inspector; de inspector van een verbinding noemt zijn uiteinden, en rechtsklik zet een ontbrekend uiteinde op het diagram; een rechte lijn zijwaarts schuiven houdt hem recht, en meer lijnen tussen hetzelfde paar waaieren uit; een zelf-relatie met een associatieklasse hangt niet meer los. De assistent en de MCP kunnen een diagram hernoemen.
Render 0.3.4: de tekenaar van studio 0.32.0 (bundel). De SVG van de server verandert: oude generalisaties gevouwen, «gebruikt» uit het veldtype, lijnen spreiden en verschuiven, de zelf-relatie met associatieklasse.
Getest op main fe68953c (BACKEND): 1441 unit, vite build, render-svc 6, Studio-e2e 110/110 (eigen
Vite op 5182; 14-studio-vormen faalde één keer onder parallelle belasting, los en bij een tweede
volledige run groen), go test ./cmd/codegen groen.
Uitrol: images bitemp-viz-frontend:0.32.0 (met --build-arg VITE_GIT_SHA=$(git rev-parse --short HEAD)) en bitemp-render-svc:0.3.4, daarna ./update.sh op app. Geen migratie en geen
nieuwe instellingen; api blijft 0.20.0. Fundament: frontend en render op digest, plus
bitemp-devloop:0.24.12 (de codegen-controle op subtypes), uitrol door FUNDAMENT.
api 0.20.0 (2026-11-06)
Defensief samenwerken (besluit Mark 06-11): een Studio-project wordt niet meer in zijn geheel vervangen terwijl iemand anders erin bezig is. Studio blijft 0.31.0, render 0.3.3.
Aanleiding: op cg-test vervingen we met een PUT het project Inrichten (versie 2→3). Een open tab
wist daar niets van en zette een kwartier later met een laadModel-op zijn oude kopie terug. Een
PUT vervangt alleen de snapshot. Open tabs krijgen daarvan geen bericht.
PUT /api/studio/projecten/:idgeeft 409,reden: "project_in_gebruik", zodra een andere client bezig is: een open SSE-verbinding van een andere tab, of een operatie van een andere tab in de laatste 5 minuten. Er verandert dan niets. Het antwoord noemt wie (anderen: [{clientId, actor, bron, laatst?}]) en geeft, net als de versie-409,servermee.- De eigen tab noemt zich met
clientIdin de body of de headerX-Omnium-Client(Studio 0.31.0 doet dat al). Zonder clientId, bij een script of een oudere Studio, telt elke open verbinding als een ander. Een script dat een heel project wil vervangen, kan dat dus alleen als niemand het open heeft. - Uitzondering: een tab die zelf live verbonden is en alle operaties al heeft (
tot_volgnummer≥ het laatste volgnummer), mag zijn stand wel bewaren. Dat is dezelfde stand als die van de anderen. Zo blijven compactie, Naar server sturen en de snapshot voor Kopieer als SVG-link werken als je samenwerkt. Een tab die achterloopt krijgt de 409; de Studio meldt dan wie er bezig is, zonder overschrijfvraag. - De gewone versie-409 heet nu
reden: "versie_verouderd". - Open: de server controleert niet of de inhoud van zo'n snapshot echt de som van de operaties is. Hele modellen vervangen hoort eigenlijk bij versiebeheer (nieuw model of nieuwe versie, de oude behouden). Dat is nog niet uitgewerkt.
Code: handlers/studio_project_in_gebruik.go; docs: docs/STUDIO.md (§Wie is online).
Getest op main 1653558f: go build en go vet schoon, go test ./... groen tegen PostgreSQL. Dat
geldt ook voor de nieuwe test (eigen tab alleen, andere tab verbonden, script, recente op,
achterlopende en bijgewerkte snapshot, na het venster). TestEaImportPakkettenLezerMetNode vraagt
web/vite/node_modules.
Uitrol: image bitemp-go-api:0.20.0, daarna ./update.sh op app. Geen migratie en geen nieuwe
instellingen. App moet minstens studio 0.31.0 draaien; dat is zo sinds 06-11. Fundament:
bitemp-devloop:0.24.11 met dezelfde Go-code, uitrol door FUNDAMENT.
studio 0.31.0 / render 0.3.3 (2026-11-06)
Een middag met Mark in de Studio: de projectboom wordt een plek om te modelleren, en de sync
wordt defensiever. Api blijft 0.19.0. Details: web/vite/CHANGELOG.md
(studio 0.31.0).
Projectboom (fase 0 van het plan "Linked data als M2"): elementen maken in een map of ín een ander element (echte relatie: lidmaatschap of insluiting, bv. een GE in een entiteit), omhangen door te slepen, één boomouder, Nieuw diagram hiermee, Toon gebruik ▸, diagrammen onder een package, kinderen selecteren en met Ctrl meeslepen. Klikken blijft in het huidige diagram.
Canvas en tabs: Ctrl+C / Ctrl+V tussen diagrammen, tabs verslepen en sluiten via rechtsklik, diagrambundels (eigen of gedeeld in het project), maat aanpassen aan inhoud op een selectie.
Model: «gebruikt» in plaats van «use» in het canonieke model (ook in oude snapshots, via de migratie in de tekenaar); de GE-kardinaliteit is standaard 0..* en volgt nooit meer uit de velden (besluit Mark).
Sync: laadModel gaat via het diff-vangnet, zodat een open tab geen wijziging van buitenaf
meer terugzet; een PUT noemt de eigen tab (clientId), klaar voor de PUT-weigering van api
0.20.0 (BACKEND, nog niet uitgebracht).
Render 0.3.3: de tekenaar van studio 0.31.0 (bundel), met de model-migratie van het profiel vóór het tekenen.
Getest op main: 1429 unit, vite build, render-svc 6, MCP 10, Studio-e2e 103/103.
Uitrol: images bitemp-viz-frontend:0.31.0 (met --build-arg VITE_GIT_SHA=$(git rev-parse --short HEAD)) en bitemp-render-svc:0.3.3, daarna ./update.sh op app. Geen migratie, geen
nieuwe instellingen; api blijft 0.19.0.
studio 0.30.0 / render 0.3.2 (2026-11-06)
De server tekent nu wat de Studio tekent. Gevonden op de SVG-link van app (Mark, 06-11): het
canonieke model miste de «use»-lijnen, en de kop van de buitenste levenslijn viel buiten beeld.
Api blijft 0.19.0 (geen Go-wijziging). Details: web/vite/CHANGELOG.md
(studio 0.30.0).
Render 0.3.2 (de tekenaar zit in de bundel van render-svc; geen wijziging aan de service
zelf):
- de geïmporteerde presentatie-edges van een diagram (
diagram.edges, de «use»-lijnen van het canonieke model), de afgeleide vakken van de hookextraCompartimenten(validatie en weergave van een gegevenstype, overgeërfde velden), een opgenomen deel als sub-vak, en de stijl per labeldeel. Canvas en tekenaar delen daar nu één functie voor; - het inhoudsvak telt mee in het beeld: de kop van de buitenste levenslijn valt niet meer buiten
de
viewBox. Een pakket of fragment bovenaan geeft een beeld dat 1 tot 3 hoger is; - een levenslijn is nooit breder dan 14 (
ShapeRenderer.bovengrens, nieuw in het vormcontract).
Studio 0.30.0: hetzelfde in documenten en gedeelde plaatjes, en een sequence-diagram uit een
plan van de ✨ assistent of de MCP krijgt punten bij elk bericht en dus activaties
(diagramprofielen/sequence/plaatsUitPlan.js). De twaalf sequence-diagrammen van Omnium
architectuur op app zijn op 06-11 zo hersteld (150 punten bij 75 berichten).
Getest op main fe97e24d: 1412 unit, vite build, render-svc 6, MCP 10, Studio-e2e 90/90 (met een nieuwe pariteitstest die teksten, maat, pad en labelstijl met het echte canvas vergelijkt).
Uitrol: images bitemp-viz-frontend:0.30.0 (met --build-arg VITE_GIT_SHA=$(git rev-parse --short HEAD)) en bitemp-render-svc:0.3.2, daarna ./update.sh op app. Geen migratie, geen
nieuwe instellingen; api blijft 0.19.0. Fundament heeft de nieuwe tekenaar pas met een nieuw
devloop-image; dat is niet gebouwd.
api 0.19.0 / studio 0.29.0 (2026-11-06)
De server tekent nu zelf een diagram uit een Studio-project (stap 6 van het plan Eén tekenaar),
en de Studio heeft er een knop voor. Render blijft 0.3.1. Frontend:
web/vite/CHANGELOG.md (studio 0.29.0).
Databasegevolg: een nieuwe gedeeltelijke unieke index idx_studio_gedeeld_beeld_svg op
studio_gedeeld_beeld (project_id, profiel_id, diagram_id) WHERE soort = 'svg' AND ingetrokken_op IS NULL, bij de start aangemaakt (IF NOT EXISTS). Geen nieuwe kolommen of tabellen; bestaande
rijen blijven ongemoeid. Geen nieuwe instellingen. De nieuwe routes hebben de render-sidecar nodig
(RENDER_SVC_URL, render 0.2.0 of nieuwer voor taal=studio); zonder sidecar geven ze 502 en
werkt de rest gewoon.
Backend 0.19.0 (minor; BACKEND, handlers/render_project.go, docs/RENDER_API.md
§Projectdiagram):
- Projectdiagram als SVG, met toegang. Privacy-besluit Mark 05-11: een diagram uit een Studio-project is op te halen door wie is ingelogd met leesrecht op het project (ook met een persoonlijk API-token), én via een link met een onraadbaar token, zoals de gedeelde plaatjes.
GET /api/studio/projecten/{id}/diagram.svg?profiel=&diagram=&theme=&idPrefix=en…/views.json(ingelogd + leesrecht). ETag,Cache-Control: private, no-cache,X-Omnium-Project-Versie, enX-Omnium-Achterstandals er operaties zijn die nog niet in de snapshot zitten.- Soort
svgbij de gedeelde plaatjes:POST …/beeldenmetsoort: "svg"(zonderpng) geeft/api/beeld/<token>.svg, openbaar. De server tekent bij elke aanvraag; er wordt geen plaatje bewaard. Eén link per diagram; zelfde lijst, zelfde intrekken..pngop zo'n token geeft 404. - De server tekent de snapshot van het project (
taal=studio); de database knipt alleen het profiel van het diagram uit de blob (de sidecar neemt 5 MB aan). De openbare link geeft een fout van de sidecar niet door (die noemt andere diagramnamen of een element), alleen een kale melding. Een getekende SVG blijft tien minuten in het geheugen, op projectversie. - Bekend en open: de tekening loopt achter op operaties ná de snapshot (de Studio zet daarom een
snapshot vlak vóór het maken van een link); een diagramverwijzing naar een ander profiel toont
"diagram" in plaats van de naam;
HEADgeeft 404.
Studio 0.29.0 (OMNIUM-UI en TRANSFORMATIES):
- Kopieer als SVG-link (de server tekent): rechtsklik op het lege canvas van een project op de
server. Het klembord krijgt het
.svg-adres; er gaat geen plaatje mee. De Studio brengt eerst de snapshot bij (snapshot op verzoek,sync/verzender.jssnapshotNu), zodat de link het diagram van nu toont; latere wijzigingen verschijnen bij de volgende snapshot. In Gedeelde plaatjes heet de soort "SVG — de server tekent". Werkt alleen tegen api 0.19.0; een oudere api geeft 400 op soortsvg. Wie alleen leesrecht heeft, kan een link maken maar geen snapshot zetten en krijgt de laatst bewaarde stand. - Labels op dezelfde zijde van een lijn stapelen (de fix van render 0.3.1, nu ook in de Studio: documenten en gedeelde plaatjes): conditie en naam op een BPMN-stroom staan onder elkaar.
- Inrichting: bronnen als artefacten (TRANSFORMATIES): de exportstap levert het
e-dienstmodel, het logisch model, de processen en de beslissingen mee als bronbestand; elk
artefact noemt zijn bronnen en een traceregel draagt
bronElementId.
Getest op main 41b7da9b. Backend (BACKEND): go build en go vet schoon, go test ./... groen;
TestEaImportPakkettenLezerMetNode vraagt web/vite/node_modules en is groen in een checkout
die dat heeft. De echte keten (API + sidecar 0.3.1 + PostgreSQL) is beproefd, ook vanuit de
Studio: link maken, snapshot op verzoek, het net toegevoegde element in de SVG. Frontend
(OMNIUM-UI): 1398 unit, vite build, Studio-e2e 89/89 (de server nagebootst). Niet getest: de
SVG-link met AUTH_ENABLED=true vanuit de Studio, en met een tweede client tegelijk.
Uitrol: images bitemp-go-api:0.19.0 en bitemp-viz-frontend:0.29.0 (met --build-arg VITE_GIT_SHA=$(git rev-parse --short HEAD)), daarna ./update.sh op app (maakt eerst een backup).
Geen migratie en geen volgorde; api en frontend gaan samen. Render blijft 0.3.1 (staat op Hub).
Fundament: bitemp-devloop:0.24.10 met dezelfde Go-code, uitrol door FUNDAMENT.
render 0.3.1 (2026-11-06)
Alleen de render-sidecar (patch); api blijft 0.18.0, studio 0.28.0. De labelfix staat in de
frontendbron (diagramcore/tekenaar/lijnen.js) en komt voor de Studio mee in de volgende
studio-release (CHANGELOG [Unreleased]).
- Labels stapelen zoals op het canvas (OMNIUM-UI, 387cdc43): labels op dezelfde zijde van een
lijn schuiven 18 px onder elkaar, zoals
ConnectorEdge. Eerste melding uit het inrichtingsregister: bij de BPMN-gateway "Ontvankelijk?" (GPK, "Aanvraag oppakken") lagen naam ("ja"/"nee") en conditie op hetzelfde punt. Elk label draagtdata-dc-label="<connector-id>". Een lang label op een kort segment kan nog over een vorm vallen, net als op het canvas. - Getest: render-svc 6/6; het GPK-diagram uit de fixture (
cg-test/gpk-processen.bpmn-model.json) bekeken: conditie en naam onder elkaar. OMNIUM-UI: 1397 unit, Studio-e2e 88/88 (met labeltest). - Main bevat ook stap 6 van BACKEND (projectdiagram als SVG,
2d30eeb9); die Go-wijziging wordt pas als api 0.19.0 uitgebracht en zit niet in dit image.
Uitrol: image bitemp-render-svc:0.3.1; op Fundament door FUNDAMENT, op app met ./update.sh.
studio 0.28.0 / render 0.3.0 (2026-11-05)
Frontend en render-sidecar; api blijft 0.18.0 (geen Go-wijziging sinds 47dc540f). Aanleiding: het inrichtingsregister wil BPMN, DMN, CMMN en formulieren van een e-dienst als SVG vastleggen, op Fundament.
Render-sidecar 0.3.0 (render-svc/, image bitemp-render-svc:0.3.0, git-tag render/v0.3.0):
- Profielvormen (stap 3 en 4 van het plan Eén tekenaar, OMNIUM-UI): elke ingebouwde vorm is
nu een ShapeType, dus
taal=studiotekent BPMN, DMN-DRD, CMMN, formulier, use case, activity, ArchiMate en sequence (levenslijn met activaties) met de vormen van het canvas; geen terugval meer op de 35 diagrammen van het architectuurproject. Lijnen zoals het canvas: padfuncties van@xyflow/system, markers, labelchips. De tekening verandert dus zichtbaar t.o.v. 0.2.0. - Versie in de uitvoer: elke SVG draagt
data-render-versieop de wortel (komt ongewijzigd door de Go-API); de sidecar zet ookX-Render-Versie, enGET /healthgeeftversie. Bron:render-svc/package.json. - Bouw: de bundel vond
@xyflow/systemniet in een schone checkout (Docker), omdat de bronnen inweb/vitestaan zondernode_modules.render-svcheeft het pakket nu als devDependency enbouw.mjszoekt ook in de eigennode_modules. Bundel ±0,7 MB. - Getest: sidecar 6/6, tekenaar- en diagramsvg-tests, Go-handler; image in een container op de
Studio-export Inrichten (Fundament, 95 elementen): 200, versie in SVG en header. Synthetische
proefdiagrammen per profiel (BPMN, DMN, CMMN, formulier) visueel bekeken. Niet getest:
taal=studiovia de draaiende Go-API.
Frontend (studio 0.28.0): één tekenaar, stap 3 en 4 af. Het canvas tekent nu met dezelfde
tekenaar als documenten, gedeelde plaatjes en de render-API; alle profielvormen zijn ShapeTypes en
de oude React-vormen en de shape-registry zijn weg. Lijnen in documenten en op de server lopen
zoals op het canvas (zelfde aanhechting en padfuncties, markers, labelchips). Sequence: de
levenslijn tekent via het sjabloon, met de afgeleide activaties ook in documenten en op de server,
en een zelf-aanroep valt binnen de aanroep. Eigen vormen uit de Studio-instellingen zijn
ShapeTypes en tekenen ook in documenten; de voorbeelden in de instellingen en de
profiel-ontwerper tekenen met de tekenaar. Hersteld: de arcering van de regelkaart "mag niet"
(toegangsregel). Nieuw: regressietest tests/e2e/41-studio-tekenaar-pariteit.spec.js. Verder het
inrichtingswerk van 05-11 (dossier, servicetaak, zaaktypelink); zie
web/vite/CHANGELOG.md.
Uitrol: images bitemp-render-svc:0.3.0 en bitemp-viz-frontend:0.28.0 (met
--build-arg VITE_GIT_SHA=…), docs/DOCKER_RELEASE.md; render op Fundament door FUNDAMENT, op
app met ./update.sh. Geen databasegevolg, geen nieuwe instellingen.
studio 0.27.0 / render 0.2.0 (2026-11-05)
Alleen frontend en render-sidecar; de api op app blijft 0.18.0 (geen Go-wijziging sinds
47dc540f). Eerste stappen van het plan Eén tekenaar (docs/plans/2026-11-04 Eén tekenaar — vormen als sjablonen in het M2 (plan).md, BACKLOG §36): dezelfde view voor documenten, gedeelde
plaatjes en de render-API; het canvas tekent nog ongewijzigd (stap 3) en de meeste profielvormen
staan nog op de terugval (stap 4).
Render-sidecar 0.2.0 (render-svc/, image bitemp-render-svc:0.2.0, git-tag render/v0.2.0):
taal=studioopPOST /api/render/svg(stap 1, 04-11): een Studio-projectexport of één profiel in de body,profielendiagramals keuze, elk ingebouwd profiel (M2).POST /viewsgeeft ookweergaven: [{ id, naam, profiel }]. 422 bij een eigen profiel uit de ontwerper of een onbekend elementtype; 503studio-niet-beschikbaarals de profielbundel ontbreekt (v3werkt dan door). Ziedocs/RENDER_API.md§taal=studio.- Tekent met de ene tekenaar (stap 5, 04-11):
diagramsvg/studio.jskrijgttekenDiagramennaarSvguit de bundel van de sidecar zelf mee (één register van vormen; een vorm die in stap 4 een ShapeType wordt, tekent de API zonder wijziging), metcontroleer: true— een renderer die het vormcontract breekt geeft een 500 in plaats van foute SVG. Alle 35 diagrammen van het architectuurproject voldoen aan de Imprint-eisen (geenforeignObject, geen scripts). - Bouw:
render-svc/bouw.mjs(esbuild,.jsxals stub) maakt de profielbundel;Dockerfile.renderen.dockerignoreaangepast.npm testinrender-svc/bouwt en test. - Niet getest:
taal=studiovia de draaiende Go-API (alleen de sidecar en het image).
Frontend (studio 0.27.0, samengevat): vormcontract ShapeType/ShapeRenderer in het M3
(diagramcore/types/shapeType.js), de tekenaar diagramcore/tekenaar/ (maat, inhoud door de
motor, lijnen via materialiseerConnectoren, veertien basisvormen), documenten ({{svg}}) en
gedeelde plaatjes tekenen ermee; de schets blijft als lichte stand. Zie
web/vite/CHANGELOG.md.
Uitrol: images bitemp-viz-frontend:0.27.0 (met --build-arg VITE_GIT_SHA=…) en
bitemp-render-svc:0.2.0 (docs/DOCKER_RELEASE.md §4.2a), daarna ./update.sh op app. Geen
databasegevolg, geen nieuwe instellingen. Bekend en open: lange tekst loopt onder een vak uit bij
een opgeslagen kleine maat (activity, ArchiMate; terugval 14 px waar het canvas 12 px heeft),
lijnen door tekst, sequence-berichten overlappen — allemaal stap 4.
api 0.18.0 / studio 0.26.0 (2026-10-31)
De Go-wijzigingen van 23 tot en met 31 oktober die tot nu toe alleen via de devloop-images
(0.24.0 – 0.24.8) naar Fundament gingen, nu ook als api-release voor app; plus uuid uit de
Studio (BACKLOG §40). Het devloop-image bitemp-devloop:0.24.9 voor Fundament bevat dezelfde
code. Frontend: web/vite/CHANGELOG.md (studio 0.26.0).
Databasegevolg (bij het opstarten, [dbsetup] in de log; verliesvrij en idempotent):
- Bij representaties met
tijdprecisie: tijdstip(in het meldingen-domein onder meer MeldingStatus en MeldingBehandelaar) wordt de kolomdatumvan de_Aanvang-/_Einde-tabellen vandatenaartimestamptzverbreed (een dag wordt middernacht UTC). - Voor materieel én enkelvoudige GE's/relaties verdwijnt de constraint
ux_<tabel>_enkelvoudig_actiefop de hub (meerdere formeel actieve voorkomens naast elkaar zijn daar nu de bedoeling; de engine bewaakt de materiële overlap). De kindtabellen houden hun constraint. - Geen nieuwe tabellen. Geen nieuwe instellingen voor app (
STARTUP_REBUILDgeldt alleen voor de devloop-container).
Brekend / gedragswijzigingen:
- Opvolging van een materieel enkelvoudig element (
handlers/registration_opvolging.go, besluit Mark 25/27-10): een nieuw voorkomen mét aanvang sluit de voorganger materieel af (automatisch einde, eigen_Einde-record in dezelfde registratie); een nieuw voorkomen zonder aanvang terwijl er een voorganger is geeft 422, net als een aanvang op of vóór die van de voorganger. De meldingen-API zet de aanvang zelf; de inhoud-editor van de Studio vraagt erom. - Subtype toont zijn sleutel als
id: een subtype met eigen GE's heeft in JSON{"<subtype>": {"id": N}}(was<ouder>_id); de databasekolom blijft<ouder>_id. - Uniek-controle gebruikt de SQL-kolomnaam uit het bun-schema en is fataal (liep eerder door in een afgebroken transactie).
- Een onleesbare waarde bij
POST /registratie/(tijdstip, datum, getal) geeft 422 problem+json met veldpad (was een kale 400 met de Go-fout).
Backend (minor):
- Materieel tijdreizen:
?geldigOp=(datum of RFC 3339) op/fullen als argument in GraphQL (model/materieel_tijd.go); naast het formele peiltijdstip. - Tijdprecisie per materiële representatie: V3
tijdprecisie: datum|tijdstip, in TypeMeta; bij tijdstip zijn aanvang/einde RFC 3339, kolomtimestamptz, einde exclusief. uuiduit de Studio: op de zeven V3-soorten (entiteit, GE, relatie, veld, enum, datatype, referentielijst-instantie); codegen neemt hem over inTypeMeta.UUID,EnumUUIDs,DatatypeRegistry,ReferentielijstInstantieRegistryen als taguuid:"…"op_Data-velden; de V3-export en het platte schema (/api/viz/schema,/api/schema/model/code) geven hem terug. Leeg (weggelaten) tot een register uit een V3 mét uuid's is gegenereerd.GET /api/volgorde/:padnaam(via,doel,na): entiteiten in afhankelijkheidsvolgorde, 409 bij een cyclus (voor de uitrol van e-diensten op Fundament).GET /healthen de subcommando'sbitemp-go-api startup-rebuild | zelftest | dbproef.- Codegen: zelf-relaties en expliciet doeltype (
DoelTypenaam), goType-afleiding, overerving (subtype met eigen GE's, ook over domeinen heen), typenaam-/tabelnaamcontrole over domeinen, weigering van een domein-run voor een onbekend domein,schema_descvoor veldbeschrijvingen, Bron-/DoelKardinaliteit in TypeMeta;cmd/codegen/CHANGELOG.md. - Devloop (alleen het devtools-image): startup-rebuild uit de actieve schema-versie, zelftest
en databaseproef vóór activeren, de rebuild registreert domeinen in de catalogus, FK-constraints
niet-fataal, verse baseline in het image (
.dockerignore).
Frontend (studio 0.26.0, samengevat): V3 als delta in het project (importeer alleen de
wijzigingen, met review zoals de EA-import), uuid op modelelementen en velden, namen uniek
per domein met ⚠ op het canvas, de veldkiezer leest het projectmodel en bindt een FieldRef via
de uuid, en de rondgang V3 → Studio → V3 is dicht.
Uitrol: images bitemp-go-api:0.18.0 en bitemp-viz-frontend:0.26.0 (met --build-arg VITE_GIT_SHA=$(git rev-parse --short HEAD)), daarna ./update.sh op app (maakt eerst een backup).
Fundament: bitemp-devloop:0.24.9, uitrol door FUNDAMENT. Bekend en open: /full-reads niet
snapshot-consistent (BACKLOG §32), correctie op afgevoerde hub geeft 500 (§34), B35
(exclusiviteit over de "is"-GE's).
studio 0.25.0 (2026-10-31)
Alleen frontend; de api op app blijft 0.17.0. De Go-wijzigingen sinds studio 0.24.0 (afgeleide
relaties, tijdprecisie, subtype-id, enkelvoudig materieel) zijn via de devloop-images naar
Fundament gegaan; een api-release voor app is een aparte stap. Geen databasegevolg, geen nieuwe
instellingen. Frontend: web/vite/CHANGELOG.md (studio 0.25.0).
Studio 0.25.0, samengevat: de inrichting van e-diensten uit het model. Uit het canonieke model en een e-dienstbestand maakt de Studio het objecttype (met de verzoek-envelop voor GZAC), het formulier voor Open Formulieren, het zaaktype voor de Catalogi API en de GZAC-dossierbundel (dossierschema, formulieren, tabbladen). Uit een BPMN-model maakt hij uitvoerbare BPMN voor GZAC (het vervolgproces start op een bericht). Een beslistabel (DMN) toetst de ontvankelijkheid in het oppakproces. Exporteren → Inrichtingsartefacten maakt alles in één zip voor het register op Fundament. Verder:
- de V3.1-veldsleutels overleven de Studio (
verplicht,uniek,type,format). In 0.24.0 maakte een import of export alle velden verplicht en verloor hijuniek; dat is nodig voor modelleren in Omnium op Fundament; - tijdprecisie in het canonieke profiel;
- voorwaardelijk tonen van een eigenschap (M3
zichtbaarAls); - in de inhoud-editor materiële elementen als lijst van voorkomens;
- een JSON-boom en een BPMN-diagram voor lange JSON of BPMN-XML in een tekstveld.
Uitrol: image bitemp-viz-frontend:0.25.0 (met --build-arg VITE_GIT_SHA=$(git rev-parse --short HEAD)), daarna ./update.sh op app; Omnium op Fundament via FUNDAMENT.
studio 0.24.0 (2026-10-23)
Alleen frontend; de api blijft 0.17.0. Geen databasegevolg, geen nieuwe instellingen. Frontend:
web/vite/CHANGELOG.md (studio 0.24.0). Uitrol: alleen app.
Studio 0.24.0, samengevat: auto-layout op leesvolgorde in alle profielen (zes richtingen als
submenu, per profiel een LayoutStijl; M3: betekenis in aard en facetten, weergave in de stijl)
en ArchiMate-lagen die de afhankelijkheden volgen; use case naar Cockburn (primaire actor,
trigger, condities, flow of events) met een layout zoals een modelleur hem zet; het
superprofiel — notitie, constraint, annotatie-lijn en diagramverwijzing in elk profiel;
doorklikken naar een diagram in elk profiel, Verwezen door, Zoek in projectboom voor een
diagram, de ⧉ op de plaat met live doelnaam; groupings en locaties als containers (M3:
containerVoor mag een lijst zijn; slepen in een grouping laat andere relaties staan); de
assistent en de MCP kunnen verplaatsen en opstellen en zeggen wat ze niet deden.
Uitrol: image bitemp-viz-frontend:0.24.0 (met --build-arg VITE_GIT_SHA=$(git rev-parse --short HEAD)), daarna ./update.sh op app.
api 0.17.0 / studio 0.23.0 (2026-10-16)
Plaatjes als link voor Confluence, en de meldingen van app (#4, #7, #8). Frontend:
web/vite/CHANGELOG.md (studio 0.23.0). Uitrol: alleen app.
Databasegevolg: nieuwe tabel studio_gedeeld_beeld (plumbing, geen register-domein), bij de
start aangemaakt met een gedeeltelijke unieke index (één actueel plaatje per diagram). De PNG's
staan in MinIO onder beelden/<token>.png, of zonder MinIO in de tabel. Bestaande data blijft
ongemoeid. Geen nieuwe instellingen; nginx stuurt /api/beeld/ al naar de API.
Backend (minor):
- Gedeelde plaatjes (
handlers/studio_beeld_handler.go):POST/GET /api/studio/projecten/:id/beelden(lezen op het project),DELETE …/beelden/:token(wie deelde of wie schrijven mag), en openbaarGET /api/beeld/<token>.png. Het token (24 bytes) is de toegang. Momentopname: zelfde plaatje = zelfde adres,immutable. Actueel: één adres per diagram,no-cachemet ETag. Intrekken verwijdert het object; project weg = plaatjes weg./api/beeld/is publiek in de PEP.
Frontend (studio 0.23.0, samengevat): plaatjes als link bij Kopieer voor Teams/Confluence (ingebed, momentopname of houd up to date), Gedeelde plaatjes met intrekken, rechtsklik Kopieer als plaatje-link; velden via de assistent en de MCP (ook enumeratiewaarden, melding #4); op raster (#7); documentdiagram recht met kardinaliteit (#8); lege rijen weg in het use case-document; Studio-instellingen crashten niet meer (React Flow #001 door de levenslijn).
Uitrol: images bitemp-go-api:0.17.0 en bitemp-viz-frontend:0.23.0 (frontend met
--build-arg VITE_GIT_SHA=$(git rev-parse --short HEAD)), daarna ./update.sh op app.
studio 0.22.0 (2026-10-16) — alleen frontend
Geen backendrelease: api blijft 0.16.0. Use case als ouder in de projectboom (M3
uitwerking, het AD eronder), de boom opgeruimd (elementen volgen hun diagram, Niet ingedeeld
en de elementenlijst alleen voor wat echt zwerft), de ✨ assistent ook vanaf het canvas en met
weghalen, Gebruikt op in de eigenschappen en ongebruikte elementen cursief (melding #5 van Hugo),
Kopieer voor Teams/Confluence in het documentvoorbeeld, de profiel-ontwerper met de ontbrekende
M3-velden, en de hint token (omt_) tegenover toegangscode (om-). Details:
web/vite/CHANGELOG.md.
Configuratie app (al toegepast 16-10): REGISTRATIE_TIJD=klok in deploy/vps/docker-compose.vps.yml
— app viel zonder die regel terug op de synthetische demotijd (alle registraties op 1 jan 2026;
melding #6). Bestaande registraties houden hun tijdstip.
Uitrol: alleen de frontend op app (--build-arg VITE_GIT_SHA=$(git rev-parse --short HEAD)).
api 0.16.0 / studio 0.21.0 (2026-10-15)
AI-hulp (AI-1 MCP, AI-2 assistent), sequence fase 0 en de projectboom (BOOM-1). Frontend:
web/vite/CHANGELOG.md (studio 0.21.0). Uitrol: alleen app.
Databasegevolg: nieuwe tabel gebruiker_token (persoonlijke API-tokens, alleen de sha256),
bij de start aangemaakt; bestaande data blijft ongemoeid.
Nieuwe instellingen (app-compose): AI_UPSTREAM_KEY, AI_UPSTREAM_URL, AI_UPSTREAM_MODEL
en AI_DATA_DIR op een volume bitemp_api_ai_data (zoals pf al had). Zonder sleutel in
/srv/omnium/.env staat de proxy uit (503) en werkt de assistent alleen met een eigen sleutel in
de browser; toegangscodes maakt een beheerder in AI-toegang (docs/AI_ASSISTENT.md).
Backend (minor):
- Persoonlijke API-tokens (
middleware/token.go,gebruikers/token.go, tabelgebruiker_token):Authorization: Bearer omt_…werkt als de gebruiker zelf;GET/POST /api/auth/tokens,DELETE /api/auth/tokens/:id. Met een token geen nieuw token. Studio: Gebruikers → Mijn API-tokens. tools/omnium-mcp: MCP-server (stdio) voor Claude Code en andere AI-clients, met tools voor meldingen (lezen mét schermafbeeldingen, reageren, behandelen), projecten en modellen (modeltalen,project_bekijken,model_wijzigen: plan → controle tegen de taal → projectsync-operaties; dezelfde regelset en toepasser als de assistent in de Studio)..mcp.jsonin de repo-root;OMNIUM_URL/OMNIUM_TOKENuit de omgeving. README in de map.scripts/bouw-domeinen.ps1: de backend bouwen met een deel van de domeinen (CODEGEN §12).
Frontend (studio 0.21.0, samengevat): ✨ assistent in context (rechtsklik op map of element: modellen in meerdere talen, submappen, bestaande elementen, uitlijnen, gesprek blijft open); boomregel (een element volgt het eerste geplaatste diagram waarop het staat — tekenen, slepen, import, migratie bij laden); sequence fase 0 (koppen, guard/retour, verticaal slepen, activaties afgeleid, tekenen van lijn naar lijn, zelf-bericht); Mijn API-tokens.
Uitrol: images bitemp-go-api:0.16.0 en bitemp-viz-frontend:0.21.0 (frontend met
--build-arg VITE_GIT_SHA=$(git rev-parse --short HEAD)); AI_UPSTREAM_KEY in
/srv/omnium/.env (chmod 600) vóór ./update.sh, anders blijft de proxy uit.
studio 0.20.1 (2026-10-14) — alleen frontend
Geen backendrelease: api blijft 0.15.0. De Studio meldt voortaan zelf een nieuwe versie
(versie.json + strook met Herladen) en toont na een update Wat is er nieuw; Help heeft een
link naar de releaselog. Meldingen #5–#7 opgelost. Details:
web/vite/CHANGELOG.md. Bouwen: docker build -f Dockerfile.frontend --build-arg VITE_GIT_SHA=$(git rev-parse --short HEAD) … (de commit komt anders niet in de image).
Uitrol: alleen de frontend op app. Deze ene keer is nog een F5 nodig; daarna meldt de Studio het.
api 0.15.0 / studio 0.20.0 (2026-10-14)
Melden vanuit Omnium (HELP-3). Frontend: web/vite/CHANGELOG.md (studio
0.20.0). Uitrol: alleen app.
Databasegevolg: nieuwe tabellen voor het domein meldingen (hubs en _Data) en
melding_bestand, bij de start aangemaakt; bestaande data blijft ongemoeid.
Backend (minor):
- Domein
meldingen(codegen): Melding met inhoud, context, bijlage, status, prioriteit, reactie; relaties Melder en Behandelaar naar Gebruiker. Via de generieke routes,/registratie/en GraphQL alleen voor beheerders (middleware.IsBeheerdomein). - Package
meldingen:/api/meldingen(melden, eigen lijst, één melding, reageren, bijlagen, behandeling door de beheerder), tabelmelding_bestandvoor bijlagen (MinIO of database). Plan:docs/plans/meldingen/§5.
api 0.14.0 / studio 0.19.0 (2026-10-14)
Mensen uitnodigen om Omnium te proberen, in een probeerproject en niet in het productieproject.
Frontend: web/vite/CHANGELOG.md (studio 0.19.0). Uitrol: alleen app;
pf later.
Databasegevolg: drie nieuwe tabellen (studio_project_toegang, studio_migraties,
gebruiker_uitnodiging), bij de start aangemaakt. Bij de eerste start met AUTH_ENABLED=true
krijgt elke bestaande gebruiker eenmalig toegang tot elk bestaand Studio-project (bouwer en hoger
schrijven, de rest lezen); daarna geldt "alles dicht tenzij". De enum Gebruikersrol is uitgebreid
(lezer, modelleur, ontwerper, bouwer, beheerder); de oude namen blijven geldig.
Aanzetten na de uitrol (optioneel): UITNODIGEN_ENABLED=true en
STUDIO_BASIS_URL=https://app.omnium-ide.nl in de env van de api. Zonder SMTP verschijnt de link
alleen in het scherm.
Backend, uitnodigen en toegang (minor; nieuwe tabellen, eenmalige datamigratie):
- Vijf rollen (
middleware/rollen.go): lezer < modelleur < ontwerper < bouwer < beheerder; viewer/editor/admin blijven als alias geldig. EnumGebruikersroluitgebreid; PEP en Rego-beleid kennen dezelfde rangorde. - Toegang per Studio-project, "alles dicht tenzij" (
handlers/studio_project_toegang.go): tabelstudio_project_toegang; eigenaar en beheerder mogen alles, anderen alleen met een rij (gebruiker of*, lezen/schrijven). Zonder leesrecht 404. Lijst gefilterd en metrecht;GET/PUT /api/studio/projecten/:id/toegang. Schrijven vraagt rol modelleur, EA-import bouwer. Migratie: bij de eerste start krijgen alle bestaande gebruikers toegang tot alle bestaande projecten (eenmalig,studio_migraties), zodat niemand iets kwijtraakt. - Uitnodigen (
gebruikers/uitnodiging.go): tabelgebruiker_uitnodiging(alleen de hash van de token), beheer-endpoints/api/gebruikers/uitnodigingen, openbaar/api/uitnodiging/:token(+/accepteer, rate limited). Aan metUITNODIGEN_ENABLED=true. - De debug-bodylogger (
APP_DEBUG_LOGS=1) slaat paden met wachtwoorden over (inloggen, wachtwoord zetten, uitnodiging accepteren).
Plan en stand: docs/plans/2026-10-12 Gebruikers uitnodigen en toolrechten (ontwerpvoorstel).md §6.
Backend, verder sinds api 0.13.0 (op main sinds 11–13 oktober):
- Toegangsbeleid fase 1a/1b (
docs/plans/2026-10-12 Toegang op beleid): beleidsbundel en PDP in Go, superpolicy (Standaard en Bij conflict), en de PEP op het leespad die antwoorden per veld snoeit (TOEGANG_BUNDEL; zonder bundel verandert er niets). De Studio exporteert de bundel. - Afgeleide relaties: codegen maakt er geen tabel voor;
/fullen GraphQL berekenen ze bij het lezen, met doelobjecten (<rol>_doelen) en lui laden (alleen de aangesproken rollen). - Licentie EUPL-1.2; Caddy-config gelijk met live (
/ai,/tts, omnium.imprint-engine.nl). - Render-API: een gegevenselement-lijn toont
0..*met{enkelvoudig|meervoudig}(was0..1); Imprint ziet dat na de uitrol.
studio 0.18.0 (2026-10-13) — alleen frontend
Geen backendrelease: api blijft 0.13.0. De Studio krijgt de beschrijving als vaste
M3-eigenschap (met migratie van toelichting/description/notes), een inspector die ook met de
pijltjes en zonder open diagram werkt, projectboom-fixes en de export van een beleidsbundel.
Details: web/vite/CHANGELOG.md. Op main staan ook backendcommits (afgeleide
relaties, beleidsbundel en PDP in Go); die gaan mee met de volgende api-release. Uitrol: alleen de
frontend-image op app.
studio 0.17.0 (2026-10-12) — alleen frontend
Geen backendrelease: api blijft 0.13.0. De Studio krijgt canvas-fixes (deselecteren, kaders,
vergroten, aanhechten op toppen, donker thema, slepen uit een domein), afgeleide relaties en de
UML 2.5.1 Property-kernset, en documenten als Markdown + afbeeldingen. Details:
web/vite/CHANGELOG.md. De backendcommits voor afgeleide relaties
(berekenen bij lezen, GraphQL-doelobjecten, codegen zonder tabel) staan op main en gaan mee met de
volgende api-release. Uitrol: alleen de frontend-image op app; pf bouwt api en frontend uit één
commit en wacht daarom op die api-release.
Sparx EA ↔ Omnium: api 0.13.0 / studio 0.16.0 (2026-10-10)
Backend (minor, niet brekend; geen databasegevolg):
- EA-import via de server (
handlers/studio_ea_import_handler.go): de Studio kiest een git-repo en een.qeadie de server zelf vindt, plus pakket en doelmap; de api start de node-sidecar (web/vite/scripts/importeer-qea.mjs, dezelfde EA-lezers als de browser) met een JWT van de aanvrager. De sidecar schrijft operaties naar het projectlog en zet daarna zelf een snapshot. Routes:GET /api/studio/ea-import/repos,…/repos/:repo/bestanden,…/repos/:repo/pakketten?bestand=,POST /api/studio/projecten/:id/ea-import,GET …/ea-import[/:taak](taken in geheugen). Inrichting metSTUDIO_EA_IMPORT_MAPPEN(zonder: 501, dus uit op app en pf),_DIR,_NODE,_API,_PULL; ziedocs/API_REFERENCE.mden.env.example. Vereist node op de host of in de container. - Projectinhoud tot 100 MB (
studioProjectInhoudMax, was 20 MB): de Zandbak MW als werkbestand is al 19,5 MB. Let op: Caddy en nginx op de VPS laten requests tot 20 MB door, dus op app en pf blijft 20 MB de feitelijke grens tot die mee omhoog gaan. - CORS staat ook de worktree-dev-poorten 5176–5179 toe.
Frontend 0.16.0: Sparx EA-import uit .qea (merge op GUID met review, lijnen per diagram,
sequence), XMI 2.1-export, acht nieuwe profielen en BPMN/DMN op EA-niveau (ook native BPMN/DMN-XML),
overerving en abstracte elementtypen in het M3, profielstores in IndexedDB, documenten uit
sjablonen, ArchiMate-blokken, verplaatsbare dialogen en canvas-fixes. Zie
web/vite/CHANGELOG.md.
Uitrol: images bitemp-go-api:0.13.0 en bitemp-viz-frontend:0.16.0; render-svc 0.1.0
ongewijzigd. Na de uitrol laden bestaande gebruikers hun lokale modellen één keer over naar
IndexedDB (automatisch).
Snapshot-grens: studio 0.15.2 (2026-10-08)
Alleen frontend (patch). De opslag-aanroep stuurde tot_volgnummer niet mee: de snapshot-grens
bleef 0, compactie deed niets en na Van server ophalen werden alle operaties nogmaals afgespeeld
(een Omhoog van vóór de snapshot dus tweemaal). Zie web/vite/CHANGELOG.md.
Uitrol: één image bitemp-viz-frontend:0.15.2; geen databasegevolg. Daarna één keer Naar server
sturen (zet de grens en ruimt het log op) en bij de anderen Van server ophalen.
Boomvolgorde in de sync: studio 0.15.1 (2026-10-08)
Alleen frontend (patch). Omhoog/Omlaag in de projectboom reist nu als operatie naar collega's,
en de snapshot draagt de boomvolgorde expliciet mee (structuur.plaatsingVolgorde): jsonb
herschikt objectsleutels, waardoor wie ophaalde een andere volgorde kreeg dan wie stuurde. Zie
web/vite/CHANGELOG.md. Uitrol: één image bitemp-viz-frontend:0.15.1;
api 0.12.0 en render-svc 0.1.0 ongewijzigd; geen databasegevolg. Bestaande projecten: één keer
Naar server sturen (de ene) en Van server ophalen (de andere) om gelijk te komen.
Projectsync stap 2 en canvas-bediening vervolg: api 0.12.0 / studio 0.15.0 (2026-10-08)
Samenwerken wordt live: operatielog, SSE-kanaal, compactie, wie is online en de werkruimte per
gebruiker op de server (backend, zie de projectsync-sectie hieronder). Plus het vervolg van de
canvas-bediening (alleen frontend; details in web/vite/CHANGELOG.md
onder 0.15.0 en in docs/STUDIO.md). Canvas-bediening samengevat:
- Geen browser-popups meer: alle prompt/confirm/alert-vensters lopen via de eigen dialoogservice
(
naamDialog.jsx), die bij de muisklik verschijnt; Nieuwe map/Nieuwe submap maken de map direct aan en hernoemen inline. - Projectboom: sorteren met Ctrl+↑/↓ en Omhoog/Omlaag, pijltjesnavigatie (↑/↓/←/→/Enter), versleepbare splitter tussen Mappen en Elementen; map-ids uniek binnen een milliseconde (fix).
- Velden herordenen (attributen, operaties): ↑/↓ en Ctrl+↑/↓ in de inspector (focus volgt), Ctrl+↑/↓ in het inline-veld op het canvas (heropent pas na de rebuild — fix voor overschreven namen).
- Uitlijnen: zelfde breedte/hoogte/maat naar de laatst geselecteerde; centreren benoemd zoals EA (verticaal = boven elkaar, Alt+V; horizontaal = naast elkaar, Alt+H).
- Sneltoetsen instelbaar (Studio-instellingen → Sneltoetsen) met EA-achtige standaarden.
- Graaf (demo), SP en de Profiel-editor staan standaard niet meer in de activity bar.
Projectsync, stap 2 (api 0.12.0) — backend én frontend
Samenwerken wordt live: elke modelwijziging is een benoemde operatie die naar de server gaat en
bij collega's binnenkomt (plan docs/plans/2026-10-07 Projectsync …, docs/API_REFERENCE.md §15).
- Backend (api 0.12.0,
APIVersion0.12.0): tabelstudio_project_ops(operatielog per project, volgnummer), kolomstudio_projecten.tot_volgnummer(snapshot-grens), tabelstudio_werkruimtes(tabs/open mappen per gebruiker per project). Endpoints:POST/GET …/ops,GET …/events(SSE, met presence),GET/PUT …/werkruimte,GET /api/studio/instellingen. Compactie: een snapshot-PUTruimt operaties t/m de grens op. Nieuwe instellingSTUDIO_SYNC_POLL_MS(standaard 5000). - Frontend: operatielaag met outbox en verzender (SSE, poll als terugval), undo-rebase bij
remote operaties, werkruimte los van het project (werkbestand v3, zonder tabs/viewports;
localStorage
studio-werkruimte:<projectId>), menu Project met sync-stand, Live synchroniseren, Nu verversen; "N anderen online" in de menubalk; Studio-instellingen → Samenwerken.
Uitrol
- Twee images:
bitemp-go-api:0.12.0enbitemp-viz-frontend:0.15.0; render-svc blijft 0.1.0. Databasegevolg: twee nieuwe tabellen en één kolom, bij het opstarten aangemaakt; geen migratie van bestaande gegevens. - nginx in de frontend-image hoeft niet aangepast: het SSE-kanaal zet
X-Accel-Buffering: noen stuurt elke 15 s een keepalive (nginxproxy_read_timeout60 s). Caddy streamttext/event-streamzonder bufferen. - Na het uitrollen: in twee browsers hetzelfde project openen; de menu-kop toont "live" en een verplaatsing in de ene verschijnt direct in de andere.
Uitrol (canvas-bediening vervolg)
- Zit in dezelfde frontend-image 0.15.0. Geen databasegevolg. Nieuwe localStorage-sleutels:
studio05-sneltoetsen,studio05-project-elementen-hoogte,studio-werkruimte:<projectId>; bestaande taakbalk-voorkeuren blijven geldig.
Projectsync, stap 1: api 0.11.0 / studio 0.14.0 (2026-10-07)
Samenwerken aan een Studio-project, eerste trede: het project gaat als geheel naar de server en
terug. Zie docs/plans/2026-10-07 Projectsync — eenmalig naar de server, daarna operaties als events (plan).md en docs/API_REFERENCE.md §15. Frontend: zie
web/vite/CHANGELOG.md (0.14.0; neemt ook 0.13.0 mee, dat nooit is
uitgerold).
Backend (api 0.11.0)
Toegevoegd
- Studio-projecten op de server: tabel
studio_projecten(model.StudioProject; één JSONB-blob per project, versieteller) enGET/POST/PUT/DELETE /api/studio/projecten[/:id](handlers/studio_project_handler.go). Lezen voor iedereen die is ingelogd, schrijven vooreditor, verwijderen door eigenaar ofadmin;PUTweigert met 409 (plus servermeta) als de versie op de server verder is. Bewust geen bitemporele entiteit: tussenstap tot het modelregister. APIVersionstaat op 0.11.0.
Databasegevolg bij uitrol
studio_projectenwordt bij het opstarten aangemaakt (IfNotExists); geen migratie van bestaande tabellen.
Uitrol
- Twee images:
bitemp-go-api:0.11.0enbitemp-viz-frontend:0.14.0; render-svc blijft 0.1.0. - Live (app en pf) draaide op 7 oktober api 0.10.0 / studio 0.12.0; deze uitrol neemt dus ook studio 0.13.0 (canvas-bediening) mee.
- Na het uitrollen:
/version, headerAPI-Version: 0.11.0, en in de Studio Project → Naar server sturen gevolgd door Van server ophalen… in een tweede browser.
Canvas-bediening: studio 0.13.0 (2026-10-07)
Alleen frontend. Inline hernoemen op canvas, in projectboom en lijsten (ook velden en
relatienamen), verbind-modus vanaf het hele vlak (Shift), kaders die hun inhoud meeslepen, taakbalken
automatisch op een rij bovenin, en een reeks fixes uit gebruik (resizen vanaf links/boven,
datatype-hernoeming trekt door naar attribuuttypen, diagram verwijderen in de projectboom, slepen
uit boom/lijst naar het diagram). Zie web/vite/CHANGELOG.md en
docs/STUDIO.md (canvas-bediening, 2026-10-07).
Uitrol
- Eén image:
bitemp-viz-frontend:0.13.0; api blijft 0.10.0, render-svc 0.1.0. - Geen databasegevolg, geen migratie. Taakbalk-voorkeuren in localStorage blijven geldig; wie zijn balken al had verplaatst zet ze met Beeld → Taakbalken op een rij bovenin terug.
Gebruikersbeheer: api 0.10.0 / studio 0.12.0 (2026-10-06)
Gebruikers worden niet meer met SQL in een platte tabel gezet: een gebruiker is nu een
bitemporele entiteit (domein beheer, gegenereerd uit een V3-model), met een beheerscherm in de
Studio. Ontwerp en besluiten: docs/plans/gebruikersbeheer/; gebruik: docs/AUTH_DEVELOPER_GUIDE.md
§3.5a, §6 en §11.
Backend (api 0.10.0)
Brekend / databasegevolg
- De tabel
gebruikerwordt bij de eerste opstart omgezet. De oude platte tabel heet daarnagebruiker_oud; elke rij wordt een registratie (identiteit, status, roltoewijzing) en de wachtwoord-hash gaat naargebruiker_inlog. Bestaande wachtwoorden blijven werken.gebruiker_oudblijft staan; verwijder hem met de hand als alles klopt. Idempotent. handlers.LoginHandlerenhandlers.SeedAdminGebruikerzijn verhuisd naar packagegebruikers. De routes en antwoorden van/api/auth/*zijn gelijk gebleven.
Toegevoegd
- Entiteit Gebruiker (domein
beheer):GebruikerIdentiteit,GebruikerStatus(materieel, actief/geblokkeerd),GebruikerRoltoewijzing(meervoudig, materieel; een rol met een einde verloopt vanzelf). Hash en laatste login in de plumbing-tabelgebruiker_inlog, nooit in een registratie. GET /api/gebruikers,PUT /api/gebruikers/:id/wachtwoord(admin),PUT /api/auth/wachtwoord(eigen wachtwoord, met het huidige ter controle; minstens 10 tekens).- Rol en status per verzoek uit het register (cache 30 s): een blokkade of een verlopen rol werkt binnen een halve minuut, niet pas als het token na 24 uur verloopt.
Gewijzigd
- Domein
beheeris alleen voor admins, ook lezen en ook metLEESTOEGANG=open: op de gegenereerde routes, in de registratie-engine (dus ook via/registratie/, PATCH en GraphQL) en het staat niet in het GraphQL-schema.
Frontend (studio 0.12.0)
Zie web/vite/CHANGELOG.md: activiteit Gebruikers en uitloggen in de
menubalk.
Uitrol
- Twee images:
bitemp-go-api:0.10.0enbitemp-viz-frontend:0.12.0; render-svc blijft 0.1.0. - Backup vooraf (de tabel
gebruikerwordt omgezet).update.shdoet dat voor app; pf.sh niet, maak daar met de hand een dump. - Na het uitrollen in de API-log:
gebruikersbeheer: N gebruiker(s) uit gebruiker_oud overgezet. Log in met je bestaande wachtwoord en open Gebruikers in de Studio.
Render-API, GraphQL-profiel en transformaties: api 0.9.0 / studio 0.11.0 (2026-10-06)
Het werk van 28 september tot en met 6 oktober: de render-API voor Imprint, het GraphQL-schema als profiel, transformaties in een vaste vorm en het voorbereidende werk voor toegangsbeleid (FTV, ODRL). Geen brekende wijzigingen en geen databasegevolg ten opzichte van api 0.8.0.
Backend (api 0.9.0)
Toegevoegd
- Render-API voor modeldiagrammen (
docs/RENDER_API.md), gevraagd door Imprint:POST /api/render/svg: een V3-model in de body, SVG terug. Openbaar: de route tekent alleen wat de aanroeper meestuurt en leest geen registerdata.GET /api/models/{naam}/diagram.svgen…/views.json: een gepubliceerd model op naam, versie en tijdstip (asOf), uitschema_versies.ETagover de SVG en304opIf-None-Match; fouten alsapplication/problem+json;502als de sidecar niet bereikbaar is.
- Sidecar
render-svc(Node, zonder dependencies;Dockerfile.render): tekent met dezelfde code als de Studio (web/vite/src/diagramsvg). Alleen intern bereikbaar. Eerste image:markwestbroek/bitemp-render-svc:0.1.0. Opgenomen indocker-compose.ymlen indeploy/vps/docker-compose.vps.yml. - Scripts:
maak_uitleg_correctie.py: de tekst van een uitleg wijzigen in één replay;maak_nl_kaartdata.pyzet elke stip op de mediaan van de adressen van de gemeente;geef_definities_code.pyvoert bij een meervoudige layout de oude rij af en de nieuwe op.
- Replays voor pf (
replay files/): standaardweergave Initiatief v2, de correctie van de uitleg bijvorm-nl-map, en de correctie van het AI-voorbeeld en de dubbele layouts (05-10). - Toegangsbeleid, voorbeelden (
authz/, geen onderdeel van de draaiende API):gbo-voorbeeld/: de casus uit het FTV GraphQL-profiel vanuit het canoniek model, met SDL, ODRL, Rego en een native ODRL-evaluator;odrl-viewer-voorbeelden/: drie stukken beleid als ODRL voor de viewer van de werkgroep FTV.
- Deploy (VPS): toegangslogs voor de Imprint-sites in de
Caddyfile; de render-sidecar staat klaar indocker-compose.vps.yml(nog niet uitgerold).
Gewijzigd
APIVersion(OpenAPI en de headerAPI-Version) staat op 0.9.0.
Databasegevolg bij uitrol
Geen ten opzichte van 0.8.0. Komt een omgeving van een oudere versie, dan gelden de gevolgen van de tussenliggende releases; zie Uitrol.
Nieuwe instellingen
RENDER_SVC_URLop de API: het interne adres van de sidecar (standaardhttp://127.0.0.1:8095).RENDER_IMAGEin de.envvan de VPS-compose (standaardmarkwestbroek/bitemp-render-svc:latest).- Op de sidecar zelf:
RENDER_SVC_PORT(8095),RENDER_SVC_HOSTenRENDER_SVC_MAX_BYTES(5 MB).
Bekend en open
- Zonder sidecar geven de render-routes 502; de rest van de API merkt er niets van.
- De tweede instantie (
docker-compose.pf.yml) heeft de sidecar nog niet. /full-reads zijn niet snapshot-consistent op het formele leesmoment (BACKLOG §32).- Een correctie op een afgevoerde hub geeft een kale 500 (BACKLOG §34).
- De codegen neemt veldbeschrijvingen uit de V3 niet mee (BACKLOG §35).
Frontend (studio 0.11.0)
- GraphQL-schema-profiel: het typesysteem van GraphQL als diagramprofiel, met SDL in en uit.
- Transformaties in een vaste vorm (lezer → regelset → toepasser → schrijver), met de import "Mermaid flowchart → use case-model" en de export "Toegangsspraak → ODRL (ODRL-AP-NL)".
- SVG-tekenaar voor modeldiagrammen, de basis van de render-API.
- Kaart van Nederland: stippen op de mediaan van de adressen, toetsenbord en zoeken.
Uitrol
- Drie images:
bitemp-go-api:0.9.0,bitemp-viz-frontend:0.11.0en, nieuw,bitemp-render-svc:0.1.0(git-tagrender/v0.1.0;docs/DOCKER_RELEASE.md§4,docs/VPS_DEPLOYMENT.md). - app.omnium-ide.nl draait nog de API van 16 september. Een uitrol daar neemt dus ook api
0.7.0 en 0.8.0 mee. Lees daarvan Brekend en Gewijzigd hieronder, maak eerst een backup en
test op de pf-instantie of lokaal. De nieuwe tabellen en kolommen van 0.8.0 worden bij het
opstarten aangemaakt (
[dbsetup]in de log). - pf.common-ground-lab.nl is bij:
/versiongaf op 6 oktober commitd2340e69(5 oktober), dus api 0.8.0 plus de render-routes. Deze release heeft daar geen databasegevolg; de data blijft onaangeroerd. pf bouwt de API uit de git-checkout (deploy/vps/pf.sh); de render-routes geven er 502 zolang de sidecar niet indocker-compose.pf.ymlstaat. - Na het uitrollen: controleer
/version, de headerAPI-Version: 0.9.0en éénPOST /api/render/svg(voorbeeld inVPS_DEPLOYMENT.md).
Formulieren, publicatie en de tweede instantie: api 0.8.0 / studio 0.10.0 (2026-09-28)
Het werk voor het Common Ground-portfolio op pf.common-ground-lab.nl (22–28 september). Alles
is daar al uitgerold (docs/VPS_DEPLOYMENT.md, rondes 2–11). Deze release bevat
gedragswijzigingen (vóór 1.0 toegestaan in een minor). Lees Gewijzigd vóór het uitrollen.
Backend (api 0.8.0)
Toegevoegd
- Opgeslagen documenten (QueryDefinitie). GraphQL-queries op naam uitvoeren
(
documentId+ variabelen), met materiële status en toegang (publiek/intern). Plus een generiekfilter-argument op de lijst-queries. De publicatiepagina en de embed lezen hiermee alleen geaccepteerde initiatieven. - Openbaar indienen van een formulier.
POST /aanmelding/:formulier(id of code) voor de formulieren inOPENBARE_FORMULIEREN:- vaste waarden worden afgedwongen, bron
aanmeldformulier; - een nieuwe doelentiteit kan vanuit een relatieveld, met plaatshouder-id's op de server.
- vaste waarden worden afgedwongen, bron
- Notificaties (NORA/FDS, CloudEvents NL GOV), fase 1:
NotificatieDefinitie, en bezorging per e-mail of webhook;- SMTP (standaard poort 465), met
POST /notificaties/testmail(admin).
- DashboardDefinitie: tegels op QueryDefinities (
dashboard.html). - LijstDefinitie: het overzicht in de inhoud-editor als data.
- Uitleg: de uitleg bij een vraag, per taal, met soort inhoud of vorm (§2.5 in
FORMULIERDEFINITIES.md). codeop definities: formulier-, weergave- en lijstdefinities hebben een leesbare sleutel die op elke instantie gelijk is. Te gebruiken in plaats van het id, ook inOPENBARE_FORMULIEREN.- Validatie en uniekheid:
- Normaliseren volgens het datatype op de server (
model/normalisatie.go). - Validatie-API
POST /api/valideeren/api/valideer/functies. - Uniekheid in het model (
uniek: entiteit, domein of register): een botsing geeft een 422 met codeuniek. - Gedeelde testset voor Go en JS (
testdata/validatie/).
- Normaliseren volgens het datatype op de server (
- Datatype
EnumLijst: meer enum-waarden in één veld. Gebruikt voorCG_laag, dat meervoudig is geworden, met Utility erbij. - AI:
- een proxy met tijdelijke toegangscodes (
/ai/v1/chat/completions, beheer via/api/ai/codes): hash-opslag, verloop, daglimieten, IP-limiet; POST /api/ai/lees-url(SSRF-veilig). Ziedocs/AI_ASSISTENT.mdendocs/AI_PROXY_MODEL.md.
- een proxy met tijdelijke toegangscodes (
- Leespoort
LEESTOEGANG=documenten(standaard uit). - Kolommigratie bij het opstarten (
ensureNieuweKolommen): ontbrekende, niet-verplichte kolommen worden toegevoegd. Mislukt dat, dan wordt het alleen gelogd.
Gewijzigd
- GraphQL:
- queries zijn openbaar; mutaties vereisen de rol
editor; - zonder peiltijdstip is het "nu";
- de weergavenaam wordt ook op rootniveau en voor relaties zonder eigen weergaveveld berekend;
- datums en enums komen als echte waarden terug.
- queries zijn openbaar; mutaties vereisen de rol
- Waarden worden bij het opslaan genormaliseerd, bv.
1234 ab→1234 AB. Een client die exact dezelfde tekst terugverwacht, krijgt de genormaliseerde vorm. - Een dubbele
codeop een formulier-, weergave-, lijstdefinitie of uitleg wordt geweigerd (422uniek). Een replay met dubbele codes faalt dus. APIVersion(OpenAPI en de headerAPI-Version) staat nu op 0.8.0. Hij stond nog op 0.6.0.
Gerepareerd
- GraphQL:
orzonder alternatieven is nooit waar,nullinand/orwordt overgeslagen, en de weergavenaam volgt de klassenaam. - Notificaties: een EHLO met de eigen hostnaam, een eigen Message-ID en een afzendernaam. Microsoft 365 zette de mail eerst in quarantaine.
Databasegevolg bij uitrol
Bij het opstarten worden de nieuwe tabellen aangemaakt: QueryDefinitie-GE's,
NotificatieDefinitie en notificatie_bezorging, DashboardDefinitie, LijstDefinitie en Uitleg.
Ook worden ontbrekende kolommen toegevoegd (code, soort); zie [dbsetup] in de log. Verder
is er geen migratie nodig.
Nieuwe instellingen
OPENBARE_FORMULIEREN, SMTP_*, LEESTOEGANG, AI_UPSTREAM_KEY, AI_UPSTREAM_URL,
AI_UPSTREAM_MODEL en AI_DATA_DIR. Allemaal optioneel: leeg betekent dat de functie uit staat.
Bekend en open
- Een correctie op een afgevoerde hub geeft een kale 500 (BACKLOG §34).
- De codegen neemt veldbeschrijvingen uit de V3 niet mee (BACKLOG §35).
- Uniekheid in het canonieke profiel: nog geen besluit.
Frontend (studio 0.10.0)
Onder meer:
- Formulieren: nieuw-modus, openbaar aanmelden en de invoersoort gescheiden van de vorm, met
een vormenbibliotheek van ruim dertig vormen en de showcase
vormen.html. - Publicatie: de kale embed voor commonground.nl, weergavevormen in detail-templates, en een tweede weergave naast de standaard.
- Verder: dashboards, LijstDefinities, datatype-validatie bij het invullen, de AI-assistent met de invulhulp, de uitleg bij een vraag, en de kaart van NL met Caribisch Nederland.
Uitrol
- Voor pf is dit de huidige stand, met de API gebouwd uit de git-checkout. Na de uitrol speel
je de replays af die bij de release horen (
replay files/…-2026-09-2*.json, zieVPS_DEPLOYMENT.md). - Voor app.omnium-ide.nl geldt hetzelfde voorbehoud als bij 0.7.0: wordt
/admin/*gebruikt, dan is een devtools-image nodig. - Na het uitrollen: kijk in de log naar
[dbsetup](nieuwe tabellen en kolommen).
Backend-review, hardening en testsuite: api 0.7.0 / studio 0.9.0 (2026-09-22)
Uitkomst van de backend-review van 7 juli (docs/reviews/2026-07-07-backend-code-review.md),
de regressie- en loadsuite die daaruit volgde, en de fix op de enkelvoudige hub-afvoer.
Deze release bevat brekende wijzigingen (vóór 1.0 toegestaan in een minor, zie
docs/versiebeheer.md §2). Lees Brekend vóór het uitrollen.
Backend (api 0.7.0)
Brekend
/admin/*bestaat alleen nog in een build met-tags devtools(devloop, rebuild, droptables, createtables, diff, de suite-editor). De standaard-images (Dockerfile,Dockerfile.api) bouwen zonder die tag: daar geven die routes 404.Dockerfile.devloopen de in-container rebuild bouwen mét. Lokaal:go run -tags devtools .POST /registratiesenPOST /wijzigingenzijn verwijderd (de audit-routes zijn read-only).POST /{padnaam}enDELETE /{padnaam}/:idlopen nu via de registratie-engine en leveren eenregistratie_id; er ontstaat dus altijd een registratie met wijzigingen.- Authenticatie wordt afgedwongen. Bij
AUTH_ENABLED=trueisJWT_SECRETverplicht (anders start de API niet), muterende routes vereisen minimaal de roleditor, en een onbekende rol wordt geweigerd. De autorisatie (PDP) staat standaard op dicht bij een fout. - Beheerwachtwoorden: de dev-default wordt in productie geweigerd; het wachtwoord kan
via de header
X-Beheer-Wachtwoord. - Statuscodes: een onbekend id geeft 404 (was 500 met
sql: no rows); een dubbel id, twee gelijktijdige correcties op hetzelfde gegeven en een deadlock geven 409 zonder SQL-tekst (was 500 met de ruwe Postgres-fout). Bij een deadlock doetRegistreerJSONCoreéén herkansing. Interne fouten lekken geen databasetekst meer.
Toegevoegd
REGISTRATIE_TIJD=synthetisch|klok(defaultsynthetisch, de demo-modus waar de tijdlijnpagina's op leunen; echte implementaties zoals het CG-domein horenklok).- Connectiepool instelbaar (
db_pool.go):DB_MAX_OPEN_CONNS(default 25),DB_MAX_IDLE_CONNS,DB_CONN_MAX_LIFETIME,DB_CONN_MAX_IDLE_TIME. Zonder pool gaf de API bij 100 gelijktijdige gebruikers 500's (too many clients) en verbond hij voortdurend opnieuw; met pool verdrievoudigt de leesdoorvoer op 2000 NP's. WEB_DIR: serveer/vizuit een andere map (test-instantie in een worktree zonder gebouwde frontend).- Enum-validatie:
schema:"enum=…"wordt gecontroleerd tegenEnumWaarden(422application/problem+json, codeenum). - Regressie- en loadsuite (
-tags integration): alle scenario's als data (regressie/scenarios/*.json, formaat v2), suite-editor op/admin/regressie(devtools-build), loadtests met rollen (lezen terwijl er geregistreerd wordt), drempels die de test laten falen, export naar k6 en Hurl. Ziedocs/REGRESSIETEST.mdendocs/TESTSUITE_VERKENNING.md. Startscripts:scripts/regressie-ui.ps1,scripts/regressie-bekijk.ps1,scripts/regressie-np-loc.ps1; seed-generatorscripts/genereer-load-seed.py.
Gewijzigd
- Enkelvoudig-invariant in de database: per enkelvoudige tabel een uitgestelde
EXCLUDE-constraint (precies één actief record), gecontroleerd bij de commit zodat ongedaanmaking blijft werken. Reads in de engine gebruiken de transactie metFOR UPDATE. PATCH /full/{padnaam}/:idinjecteert de URL-id als parent-FK; een item zonder expliciete FK gaf 500.- Formele-tijdafleiding set-based:
GET /full/…?t=doet voor 5 entiteiten 21 queries (was 60+); bewaakt door eenmax_queries-scenario. .envstaat niet meer in git;.env.exampledekt alle sleutels.
Gerepareerd
- Enkelvoudige hub vervangen liet actieve data achter (
fix/enkelvoudige-hub-afvoer): kinderen krijgen derel_idvan de hub zoals die na insert is, afvoer van een hub (ook als enkelvoudige voorganger) voert zijn actieve kinderen af, en opvoer onder een niet-actieve hub wordt geweigerd. Geborgd door regressiescenario 19. Bestaande data kan restanten bevatten: ziedocs/plans/2026-09-21 Merge-notitie — reflijst-combobox en enkelvoudige hub-afvoer.md§5. /api/viz/reflijst/{typenaam}/optiestoont alleen data onder een actieve hub (geen dubbele opties meer).
Databasegevolg bij uitrol
Bij het opstarten maakt dbsetup de nieuwe EXCLUDE-constraints aan en verwijdert de
oude unieke index. Botst een constraint met bestaande inconsistente data, dan blijft het
bij een regel WARN: enkelvoudig-invariant constraint … niet aangemaakt en start de API
gewoon. Kijk bij de eerste start naar die regels. Verder geen migratie.
Bekend en open
/full-reads zijn niet consistent op één leesmoment: onder schrijflast kan een lezer een actieve hub met al afgevoerde data zien (~1% in de gemengde loadtest). De opgeslagen data is correct.test/2026-09-21-bevinding-002-…, backlog §32.- Verplichte velden en
ref:-verwijzingen worden niet afgedwongen; een weggelaten verplicht veld wordt als nulwaarde opgeslagen.test/2026-09-21-bevinding-003-…, backlog §33. - De hub-guard geeft 500 in plaats van 409/422 (backlog §32.7).
Frontend (studio 0.9.0)
GE-opname in de entiteit, bewerkbare velden in canoniek-uml, magic link, containers en
pools, reconnect, de zoekende combobox voor relatievelden, en een frontend-image die
zonder nieuwe build instelbaar is — zie web/vite/CHANGELOG.md.
Uitrol
- Frontend-image 0.9.0: kan overal uitgerold worden; de defaults geven het oude
gedrag. Nodig voor de tweede instantie pf.common-ground-lab.nl (
API_UPSTREAM). - API-image 0.7.0: niet uitrollen naar een omgeving waar de Studio
/admin/rebuildof/admin/diffgebruikt, tenzij daar bewust een devtools-image draait. Voor app.omnium-ide.nl is dat besluit nog open (ziedocs/plans/2026-09-21 Opdracht tweede instantie pf.common-ground-lab.nl — …§3a). Voor een live register zoals pf is de standaard-build juist de bedoeling. - Controleer vóór het uitrollen met
AUTH_ENABLED=truedatJWT_SECRETen de beheerwachtwoorden gezet zijn; anders start de API niet.
Demo-model np-loc-org+geo en OAS → canoniek: api 0.6.0 / studio 0.8.0 (2026-09-16)
Consolidatie na de FTV-demo van Toegangsspraak (15 september). Baseline voor het volgende werk; de eerstvolgende stap is een UI voor gebruikersbeheer.
Backend (api 0.6.0)
- np-loc uitgebreid: GE's
Geslacht(enumGeslachtsaanduiding) enAanspraak(aanspreektitel,formeelAanspreken— beide optioneel, de illustratie van driewaardige optionaliteit), plus de relatiesWoonlocatie→LocatieenGebiedsligging→Gemeentedeel. - Nieuw domein
org-geo(prefixorg_geo_):Afdeling,Medewerker,Gemeentedeel;OrganisatieenGemeenteuit CG hergebruikt in plaats van nagemaakt (de MetaRegistry is één map op typenaam). Init inmodel/metaregistry_plumbing.go. - Databasegevolg bij uitrol: puur additief.
dbsetup.CreateTablesloopt over deMetaRegistryen maakt elke tabel metCREATE TABLE IF NOT EXISTS; de nieuweorg_geo_*- en np-loc-tabellen komen er bij het opstarten vanzelf bij. Geen migratie, geen wijziging aan bestaande data. - Codegen-voetangels vastgelegd in
docs/CODEGEN.md§7.4:datatype_aliases.gobotst metdatatype_aliases_extra.gobij een volledige export, en*_modellen_input.godraagt handmatige delta's (Aanvang/Einde eruit, sommigeschema:-tags weg). Structureel oplossen staat op backlog §29.3/29.4. - Bewaakt door
model/demo_model_test.go(rollen, velden, relatie-doelen, enums).
Frontend (studio 0.8.0)
OpenAPI → canoniek model, doorkijk over relaties in de modelboom, composities als
connector en de handle-normalisatie — zie
web/vite/CHANGELOG.md.
Uitrol
VPS: docs/VPS_DEPLOYMENT.md §11 (docker compose pull +
up -d --force-recreate api frontend). De Studio-sandbox persisteert: een al geladen
canoniek model toont de compositielijnen pas na opnieuw inladen.
Docker-publicatie + tag-beleid: api 0.5.0 / studio 0.6.0 (2026-07-29)
Backend en frontend als losse images naar Docker Hub gepubliceerd, en het tag-beleid vastgelegd.
- Nieuw:
docs/DOCKER_RELEASE.md— welke images we publiceren, hoe we taggen (kale component-semver pluslatest; versie-tag onveranderlijk), waarom altijdlinux/amd64, de releaseprocedure per component, rollback en de checklist. - Vervallen: het oude image-tagschema
v06.00.01. De Docker-tag is voortaan het componentnummer uitdocs/versiebeheer.md§7 zonder prefix en zonderv. - Gepubliceerd:
markwestbroek/bitemp-go-api:0.5.0+latest— ongewijzigde Go-code t.o.v. tagapi/v0.5.0; dit is de eerste v06-API op Docker Hub (daar stonden alleen nogv04.*-tags uit maart/april).markwestbroek/bitemp-viz-frontend:0.6.0+latest— bevat Toegangsspraak/Toegangsregel en de Sequence-, BPMN- en ArchiMate-profielen; zieweb/vite/CHANGELOG.md.
- Bijgewerkt:
docker.md(§ inleiding, componenttabel, §12),.env.docker.example,docker-compose.api-only.ymlendocker-compose.frontend-only.yml(verouderde:v05/:v06defaults →:latest),docs/versiebeheer.md(§6, §7.1a),docs/TRUENAS_DEPLOYMENT.md(backend krijgt nu ook een versie-tag).
Operaton-provenance op Registratie + PoC Process Engine v2 (2026-05-21)
Twee gekoppelde wijzigingen: (1) bron/bron_kenmerk velden op Registratie in bitemp v06, en (2) de Go-worker en BPMN v2-flow in process_engine_v01.
Wijzigingen in bitemp_register_v06
model/model_plumbing.go— Twee nieuwe nullable velden op deRegistratie-struct:Bron *string(JSON:bron, Bun:bron,nullzero) — systeem of component dat de registratie aanmaakteBronKenmerk *string(JSON:bron_kenmerk, Bun:bron_kenmerk,nullzero) — referentie in het bronsysteem (bijv. process instance ID)
dbsetup/createtables.go— Nieuwe idempotente migratiefunctieensureRegistratieBronMigrated: voegtbronenbron_kenmerkVARCHAR-kolommen toe aan deregistratie-tabel als die nog niet bestaan. Aanroep inCreateTables()naensureRegistratieDomeinenMigrated.
Wijzigingen in process_engine_v01
internal/worker/service_task.go— Worker v2 volledig herschreven met 5 topics en correcte padnamen uit de bitemp MetaRegistry:check-locatie→ GET/full/locaties/{locatie_id}check-np→ GET/full/natuurlijk_personen/{np_id}registreer-np-bereikbaarheid→ POST/registratie/(NP + bereikbaarheid in één registratie)registreer-bereikbaarheid→ POST/registratie/(alleen bereikbaarheid)register-call→ POST/registratie/(NP-only, v1-compatibel)- Alle
handleRegistreer-aanroepen injecteren"bron": "operaton"+"bron_kenmerk": processInstanceID
deployments/poc/registreer_inwoner_v2.bpmn— Nieuw multi-branch BPMN-proces:check-locatie→ gateway → (locatie bestaat) →check-np→ gateway → 3 paden (niet gevonden, actueel inwoner-fout, historisch)deployments/poc/start_pieter_v2.json— Testpayload met geldig BSN430050100(11-proef: 88 = 8×11)
Smoke-test (2026-05-21)
Process registreer_inwoner_v2 COMPLETED, registratie_id=888, bron=operaton, bron_kenmerk=e8574958-5499-11f1-83f4-aaf489597b8d.
Zie process_engine_v01/README.md voor volledige details en padnamen-referentie.
GraphQL: typed maakRegistratieOngedaan mutation + registratie-flow docs (2026-05-01)
Aanvulling op de Fase 3B-full typed mutations: ongedaanmaking heeft nu ook een volledig getypeerd pad in GraphQL, en de docs leggen de complete 3B-stijl flow voor een NP uit (initiële opvoer → wijzigingen → correcties → afvoer → ongedaan).
- Nieuw:
maakRegistratieOngedaan(registratie_id: Int!, opmerking: String)— typed mutation die op eenregistratie_idwerkt (geen entiteit/GE/REL). De resolver bouwt de ongedaanmaking-payload server-side en delegeert aan dezelfdeRegistreerJSONCoreals de bestaandemaak_ongedaan(input: JSON!). Audit-trail en transactiegedrag zijn identiek. - Documentatie:
- GRAPHQL.md — Mutations-sectie herschreven: typed (voorkeur)
vs JSON (fallback) met expliciete "normale flow" beschrijving (initiële
opvoer via
registreer, vervolgstappen typed, ongedaanmaking typed). Registraties+wijzigingen-query expliciet gedocumenteerd als read-only audit-pad. - postman/graphql-nploc-requests.md —
Volledige NP-flow herschreven: §2a eenvoudige opvoer, §2b uitgebreide opvoer
(NP + naam + BSN + burgerschap + naamgebruik + bereikbaarheid in één
registreer), §2c-§2k typed wijzigingen/correcties/afvoer, §3 generieke JSON-fallback (multi-entiteit), §4a typedmaakRegistratieOngedaan, §4b JSON-fallback, §5 stap-voor-stap workflow-tabel.
- GRAPHQL.md — Mutations-sectie herschreven: typed (voorkeur)
vs JSON (fallback) met expliciete "normale flow" beschrijving (initiële
opvoer via
- Tests: 2 nieuwe tests in
dynql/maak_registratie_ongedaan_test.govoor input-validatie van de nieuwe resolver.
Bestanden:
dynql/mutation_resolvers.go—makeMaakRegistratieOngedaanResolver()toegevoegddynql/schema_builder.go—maakRegistratieOngedaanfield geregistreerddynql/maak_registratie_ongedaan_test.go— nieuwe testsGRAPHQL.md,postman/graphql-nploc-requests.md— flow & docs
C8 (Notities & Constraints) IDE↔EditorV2 roundtrip — Round 5 + Feature I54 (2026-05-01)
Twee items in één release: bugfix scope-edge verwijdering (Round 5) + nieuwe feature "Verplaats elementen naar ander domein" (I54).
Wijzigingen
Frontend (web/vite/src/):
-
store/useModelStore.js— Nieuwe actionremoveStructuralEdge(edgeId)voor het verwijderen van scope-edges (en andere structurele edges) uit de store. -
ide/DiagramCanvas.jsx— NieuwehandleEdgesChangeWrappedwrapper rondonEdgesChangevan React Flow: vangttype === "remove"changes (Delete-toets) en verwijdert scope-edges óók uitstructuralEdges. Zonder deze wrapper bleven scope-edges in de store hangen na visueel verwijderen, en doken bij volgende V3-export weer op. -
ide/DiagramCanvas.jsx—handleRemoveEdgeFromDiagram(rechtsklik > "Verwijder uit diagram") roept nu ookremoveStructuralEdgeaan voor scope-edges. -
ide/BrowserContextMenu.jsx— Nieuw menu-item "↪️ Verplaats naar domein…" voor alle element-types (entiteit, GE, relatie, enumeratie, gegevenstype, referentielijstInstantie, notitie, constraint). -
ide/ProjectBrowser.jsx— HandlerverplaatsDomein: detecteert multi-select (_multiSelected.size > 1), toont prompt met beschikbare domeinen + huidig domein als default, gevolgd door bevestigingsdialoog. PastupdateElement(id, { domein: ... })toe op alle geselecteerde elementen. Lege invoer → "(geen domein)". Multi-selectie wordt na actie gewist. -
ide/ProjectBrowser.jsx— Drag & drop naar domein-rij: element(en) slepen vanuit de boom op een domein-map toont een bevestiging + verplaatst het domein. Visuele feedback: domein-rij kleurt groen met stippelrand (--ide-tree-dragover) tijdens hover. Multi-select (Ctrl+klik) wordt meegenomen bij de drop. Bugfixes: (1)setTimeout(0)inonDrop— browsers onderdrukkenwindow.confirmtijdens drag-events. (2) Scroll-back fix (iteratief): EerstprevScrollSelRefgetest, maar root cause bleektreeDatain effect-deps. Definitieve fix:treeDatavolledig uituseEffect([selectedElementId, selectieVersie])verwijderd. Boom rendert nu zonder extra scroll-triggers. (3)e.dataTransfer.effectAllowed = "copyMove"— was"copy", blokkeerdedropEffect = "move"in domein-drop-handler (browser vereist match tussen allowed ↔ drop). Canvas-drops ("copy") en domein-drops ("move") nu beide ondersteund.
Tests
Test-run nog te draaien (Vitest watch-mode hing bij vorige poging).
Technisch detail
Root cause scope-edge bug: Scope-edges leven uitsluitend in useModelStore.structuralEdges (niet in diagram.edges). React Flow's onEdgesChange werkt alleen de lokale useEdgesState bij. handleNodesChangeWrapped had al een sync-pad voor node-deletions, maar voor edges ontbrak die. Gevolg: V3-export las verouderde structuralEdges → scope-lijnen kwamen terug bij re-import.
I54 feature: Bewust een eenvoudige prompt+confirm-flow gekozen (consistent met bestaande "Hernoem"/"Verwijder uit model" patterns in dezelfde handler). Een rijkere modaal kan later komen zodra meer elementen gepaard verplaatst moeten worden.
C8 (Notities & Constraints) IDE↔EditorV2 roundtrip — Position Fix Round 4 (2026-05-01)
Positie-fix voor V3 JSON imports waarbij posities alleen in diagrammen[].nodes staan (niet als entity-level positie velden). Tevens dubbele scope-lijntjes (scopeRefs) gefixt.
Wijzigingen
Frontend (web/vite/src/):
-
store/adapters.js—v3ModelNaarStore: Bouwt nunamedDiagPosmap uit alle named diagrams bij import. Gebruikt als fallback voor Overzicht-diagram wanneerent.positie/ge.positie/rel.positieontbreken. Geldt voor entiteiten, GE's, relaties, anker, enums, datatypes en referentielijstInstanties. -
store/adapters.js— Import scopeRefs: Deduplicatie toegevoegd bij import van notitie- en constraint-scopeRefs (skip als target al gezien). Voorkomt dubbele scope-edges in de store. -
store/adapters.js— Export scopeRefs:[...new Set(...)]toegevoegd voor zowel notitie- als constraint-scopeRefs bij export. Voorkomt duplicaten in de V3 JSON. -
umleditor/metamodel/v3ModelNaarEditor.js: ZelfdenamedDiagPosfallback toegevoegd voor directe EditorV2-import (alle 8 posities: enum, datatype, refInstantie, entiteit, GE, relatie, anker voor doelEnt en anker-node). Notities krijgen nu ooknaam-veld en scopeRefs-edges bij directe import (was ontbrekend). Scope-edges gededupliceerd voor constraints én notities.
Tests
Alle 115 unit-tests groen.
Technisch detail
Root cause positie-bug: IDE exporteert posities via elementPositie(diagrams, "overzicht"). Wanneer een V3 JSON zonder entity-level positie velden wordt geïmporteerd, bouwen v3ModelNaarStore en v3ModelNaarEditor.js het Overzicht-diagram met default grid-posities. Vervolgens leest de export die defaults terug → EditorV2 ziet foute posities.
Fix: namedDiagPos map scannen alle diagrammen[].nodes bij import. Volgorde van prioriteit: ent.positie → namedDiagPos.get(id) → grid-fallback.
Root cause dubbele scope-lijntjes: Gebruiker tekende meerdere scope-lijntjes naar hetzelfde doel, of een V3 JSON had duplicaten in scopeRefs[]. Bij import werden alle entries omgezet naar structurele edges zonder deduplicatie. Fix: Set deduplicatie bij zowel import als export.
Drie additionele bugs gefixed in IDE/EditorV2 roundtrip na user-feedback:
Wijzigingen
Frontend (web/vite/src/):
-
ide/DetailsPanel.jsx: Naam-input voor notities nu custom<input>metonBlurcallback (EditField ondersteunt geenonBlurprop). Naam beklijft nu correct. -
ide/DiagramCanvas.jsx:handleEdgeDoubleClicknu met early-return voor scope-edges (data.kind === "scope"). Gestippelde lijnen verdwijnen niet meer bij dubbelklik. -
ide/DiagramCanvas.jsx: Diagram-posities worden nu gesynchroniseerd. Bij drag/position-change, niet alleen het actieve diagram updaten, maar ook het Overzicht-diagram (single source of truth voor V3-export). Waarom: posities per diagram opgeslagen, maar V3-export leest uit Overzicht. Meerdiagram-scenario's nu consistent.
Tests
Alle 115 unit-tests groen.
Technisch detail
Diagram-synchronisatie: Elk diagram (diagrams[diagramId].nodes) bevat unieke node-posities.
Bij export, leest posLookup() prioritair uit diagrams[overzicht]. Maar als een element ALLEEN
in benoemd diagram staat (niet in Overzicht), zijn oude/afwezige posities. Fix: sync posities
naar Overzicht bij elke update. Dit voorkomt positie-divergentie en zorgt correcte IDE→EditorV2
roundtrip.
C8 (Notities & Constraints) IDE↔EditorV2 roundtrip (2026-05-01)
Alle C8-elementen (notities en constraints) kunnen nu bidirectioneel uitgewisseld worden tussen de IDE en EditorV2 via V3 JSON, met correcte posities, scopeRefs en domeinfiltering.
Wijzigingen
Frontend (web/vite/src/):
-
ide/BrowserContextMenu.jsx:notitieenconstrainttoegevoegd aan alle context-menu-items (toonInDiagram,toonDetails,hernoem,kopieerID,verwijder). Beide node-typen hebben nu een volledig rechts-klik menu. -
ide/DetailsPanel.jsx: NotitieEditor krijgt eennaam-veld. Notities kunnen nu een aangepaste naam hebben (gescheiden van detekst). Naam wordt opgeslagen inelement.naam; als niet ingesteld, valt terug op ID. -
ide/ProjectBrowser.jsx: Notities en constraints verschijnen nu in de domeinboom. Notities tonen hunnaam(als ingesteld) of anders een preview van detekst(eerste 40 tekens). Constraints tonen hunnaam. -
store/adapters.js: 5 technische fixes:- Diagram-nodes export:
elementId: n.elementId || n.id(Zustand slaat op als{ elementId, position }, niet{ id }). - Diagram-nodes import:
{ elementId: n.elementId, position }format; nodes zonder elementId worden overgeslagen. - Notitie import:
naam: n.naam || n.id(voordien werd naam altijd op ID gesteld). - Notitie scopeRefs import: Lus over
scopeRefsarray → stuctural edges metdata: { kind: "scope" }. - Notitie export: Teksteen en naam apart (voorheen fallback naar naam). ScopeRefs geëxporteerd als array van doelId's.
- Diagram-nodes export:
-
pages/IdePage.jsx:referentielijstInstantiesnu ook gefilterd bij domeinexport (voordien werden AdellijkeTitels/Landenlijst meegenomen). -
umleditor/components/MetamodelEditor.jsx:onConnectkrijgt dezelfde scope-edge-logica als DiagramCanvas: als source een notitie/constraint is, wordt een scope-edge aangemaakt (type"metamodel",data: { kind: "scope" }). MetamodelEdge rendert dit correct als dashed lijn.
Testen
Alle 115 unit-tests groen (geen nieuwe tests nodig; bestaande tests valideren de adapters.js-fixes).
Notities
- Positieverschil IDE ↔ EditorV2: De IDE rendert ASOC-patronen met zichtbare
anchor-nodes; EditorV2 heeft geen visuele anchors. Positieverschillen in de
layout zijn daardoor normaal — element-level
positieuit V3 is consistent. - ScopeRefs: Scope-edges worden nu bidirectioneel uitgewisseld; meerdere scope-lijnen vanuit één notitie worden volledig bewaard.
- Naam vs Tekst: Notities hebben nu beide velden;
tekstis inhoud,naamis optioneel label. V3 export/import respecteren dit onderscheid.
GraphQL typed patch inputs: PatchInput per ENT (2026-05-xx)
Fase 3B-full: het vrije JSON! scalar in wijzig<X> en corrigeer<X> is vervangen
door volledig getypeerde <Typenaam>PatchInput InputObject-types. Deze worden bij
startup dynamisch gebouwd vanuit de MetaRegistry (geen codegen nodig).
Wijzigingen
-
dynql/input_type_builder.go(nieuw):BuildPatchInputTypes()— bouwt in twee stappen alle typed inputs:- Stap 1: GE/REL hub InputObjects (
<GETypenaam>Input) via reflectie op de_Datastruct. Bevat:rel_id: Int, inhoudsvelden uitDataTypenaam, secundaire FK (bij relaties,SecondaireEntiteitIDKolom), enaanvang/eindesub-inputs (PlumbingDatumInput) voor materiële types. - Stap 2: ENT PatchInputObjects (
<Typenaam>PatchInput) viaOnderliggendeGegevenselementen. Elk hub-type wordt als[GEInput]-lijst opgenomen; aanvang/einde plumbing-subtypes worden overgeslagen.
- Stap 1: GE/REL hub InputObjects (
PlumbingDatumInput— gedeeld{datum: Date}input type voor materieel aanvang/einde.getPatchInputType(typenaam)— geeft het gebouwde PatchInput type terug, valt terug opJSONScalarals niet beschikbaar.inputTypeCache/patchInputTypeCache— voorkomen dubbele aanmaak.- Helpers:
buildInputSkipSet,addStructInputFields,goTypeToGraphQLInput(parallellen aan de output type builder, maar producerengraphql.Input).
-
dynql/typed_mutations.go(bijgewerkt):AddTypedMutationsForEntiteitroept nugetPatchInputType(meta.Typenaam)aan voor hetpatch-argument type. Resolvers zijn onveranderd — graphql-go deserialiseert InputObject naarmap[string]interface{}, enjson.Marshalproduceert dezelfde JSON.
-
dynql/schema_builder.go(bijgewerkt):BuildPatchInputTypes()wordt aangeroepen vlak vóór de mutations loop, zodat depatchInputTypeCachegevuld is wanneerAddTypedMutationsForEntiteitloopt.
Tests
dynql/input_type_builder_test.go(nieuw, 8 testcases):TestBuildPatchInputTypes_VultCacheVoorAlleEntiteiten— alle ENTs krijgen een PatchInput type.TestBuildPatchInputTypes_NatuurlijkPersoonHeeftGERollen—NatuurlijkPersoonPatchInputbevatnamen,persoonsidentificaties,burgerschappen,bereikbaarheden; aanvang/einde plumbing ontbreken correct.TestBuildPatchInputTypes_GEInputHeeftRelID—rel_idaanwezig.TestBuildPatchInputTypes_GEInputHeeftDataVelden— inhoudsvelden uit_Data(voorletters,achternaam) aanwezig; PK-velden (natuurlijkpersoon_id,versie) afwezig.TestBuildPatchInputTypes_MaterieleGEHeeftAanvangEinde—aanvang/eindeaanwezig opNatuurlijkPersoon_BurgerschapInput.TestBuildPatchInputTypes_WijzigMutatieGebruiktTypedInput—wijzigNatuurlijkPersoon.Args["patch"]is een*graphql.InputObject, niet meerJSONScalar.TestBuildPatchInputTypes_BereikbaarheidHeeftLocatieID—locatie_idaanwezig,natuurlijkpersoon_idafwezig.TestGetPatchInputType_FallbackOpJSONScalar— onbekend type valt terug opJSONScalar.
- Totaal: alle suites groen (
go test ./...).
GraphQL Command-laag: directe core-calls + per-ENT typed mutations (2026-04-30)
Fase 3 van de PATCH/DELETE/GraphQL-roadmap. De GraphQL-mutations roepen de pure
handlers.*Core-functies nu direct aan in plaats van een interne HTTP-roundtrip
te maken. Daarnaast krijgt elk entiteit-type drie typed mutations
(wijzig<X>, corrigeer<X>, voer<X>Af) bovenop de bestaande generieke
registreer / corrigeer / maak_ongedaan.
Wijzigingen
handlers/registration_handlers.go:- Nieuwe
RegistreerJSONCore(ctx, rawBody, defaultRegistratietype, audit)— transport-onafhankelijke variant vanRegistreerMetNieuweAanpak. Doet unmarshal +NormaliseerWijzigingen+RegistreerCore. Gebruikt door REST en GraphQL. RegistreerMetNieuweAanpak()is nu een dunne Gin-adapter rond de core; response-shape onveranderd (incl.registratieId-alias).
- Nieuwe
handlers/crud_handlers.go:- Nieuwe
WijzigEntiteitCore(ctx, meta, id, rawBody, modus, audit)— pure PATCH-engine dieBouwWijzigingen+RegistreerCoreorkestreert. Retourneert*RegistreerResult,meldingen[]en*RegistreerError. MakePatchFullEntityByMetaHandleris nu een dunne Gin-adapter rond de core.VoerEntiteitAfCore(al toegevoegd in vorige stap) wordt nu hergebruikt door GraphQL.
- Nieuwe
dynql/mutation_resolvers.go(vervangen):http.Postnaarlocalhost:8082/registratie/...is weg. GeenregistreerBaseURLoffindEntiteitMetaVoorVeldnaammeer.registreer,corrigeer,maak_ongedaanroepenRegistreerJSONCoredirect aan met de juistedefaultRegistratietype.SetRegistreerBaseURLblijft als no-op (deprecated) voor back-compat.
dynql/typed_mutations.go(nieuw):AddTypedMutationsForEntiteit(fields, meta)registreert per ENT:wijzig<Typenaam>(id, patch: JSON!)— PATCH-modus registratiecorrigeer<Typenaam>(id, patch: JSON!)— PATCH-modus correctievoer<Typenaam>Af(id)— afvoer
- Modus zit in de mutation-naam; geen
modus-arg. - Voor GE/REL-types is dit (nog) een no-op — die hebben (entId, relId) nodig en volgen in de typed-input iteratie.
dynql/schema_builder.go: roeptAddTypedMutationsForEntiteitvoor elke meta in de registry aan;registeredEntiteitMetasis verwijderd.
Tests
dynql/typed_mutations_test.go(nieuw, 3 testcases):TestAddTypedMutationsForEntiteit_RegistreertWijzigCorrigeerVoerAf— assertwijzigA,corrigeerA,voerAAfaanwezig + arg-namenid/patch.TestAddTypedMutationsForEntiteit_GeenOpVoorNietEntiteit— GE/REL geeft 0 velden.TestAddTypedMutationsForEntiteit_AlleEntiteitenKrijgenDrieMutations— sweep over hele MetaRegistry.
Vervolg (apart traject)
- Volle typed
<Type>OpvoerInputmet recursieve graphql-input-types (per onderliggende GE/REL-rol een veld), en typed mutations voor GE/REL met (entId, relId) — gepland in de "typed-input"-iteratie.
REST/CRUD per padnaam: DELETE + PATCH + parent-context disambiguatie (2026-04-29)
Generieke REST CRUD-endpoints op basis van MetaRegistry, bovenop de gedeelde
RegistreerCore-engine (één audit-pad, één transactiemodel).
Wijzigingen
handlers/crud_handlers.go(nieuw):MakeDeleteEntityByMetaHandler(meta)—DELETE /{padnaam}/:id→ éénAfvoer-wijziging viaRegistreerCore. PFK-types (composite key) afgewezen met 400 — gebruik daarPOST /registratie/.MakePatchFullEntityByMetaHandler(meta)—PATCH /full/{padnaam}/:idmet JSON Merge Patch (RFC 7396). Hybride wrapper (variant A/B),?modus=registratie|correctie,meldingen[]in response.
handlers/wijziging_builder.go(nieuw, ~290 regels): pureBouwWijzigingen(in)vertaalt PATCH-body naar[]WijzigingRequest. Geen DB-toegang.- Parent-context disambiguatie: bouwt
RepresentatiePlusNaamdirect vanuitog.Doeltypei.p.v. via globaleGetByVeldnaamMetPayload. Lost veldnaam-collisions op (bv."naam"=NatuurlijkPersoon_NaaménApiStandaard_Naam→ in PATCH-context altijd correct het type van de parent).
- Parent-context disambiguatie: bouwt
routes/addroutes_helper.go: DELETE-route inaddMetaRegistryRoutes, PATCH-route inaddMetaRegistryFullRoutes.handlers/openapi_generator.go:delete-operatie op{padnaam}/{id},patch-operatie op/full/{padnaam}/{id}met modus-param + merge-patch+json request body schemas.
Tests
handlers/crud_handlers_test.go(3 tests): PFK-afwijzing, NotFound, happy-path delegatie naarRegistreerCore.handlers/wijziging_builder_test.go(12 tests): variant A/B wrapper, ID-mismatch (409), verboden ENT-veld (400), lege body (400), correctie zonder rel_id (400), correctie met rel_id (afvoer+opvoer), no-op rel_id melding, registratie genegeerd rel_id melding, onbekende modus (400), ongeldige JSON (400), array op meervoudige rol, parent-context disambiguatie naar exactNatuurlijkPersoon_Naam(vóór deze fix:ApiStandaard_Naam).- Totaal: alle suites groen (
go test ./...).
Documentatie
docs/REST_CRUD.md(nieuw): endpoints, body-formats, modus, foutcodes-tabel (200/400/404/409/412/500), ETag/If-Match-ontwerp (follow-up).docs/BACKLOG.md: Fase 2 DELETE + PATCH ✅; ETag 🟡 follow-up; nieuw open punt: domein/parent-filter opGetByVeldnaamMetPayloadvoor andere callers (POST/registratie/, normalizer).
IDE: lossless mermaid/UML-import + V3-validator (2026-04-27)
Mermaid/PlantUML/XMI-import in de IDE-pagina was kapot: alleen klassen kwamen binnen,
geen velden, geen edges, geen default diagram. Root cause: het IDE-pad ging via
editorNaarV3Model, dat geen velden op entiteit-niveau en geen directe ent→ent edges
ondersteunt, dus die werden stilletjes weggegooid.
Wijzigingen
src/store/adapters.js:- Nieuwe
rawEditorNaarStore(graaf, opts): 1-op-1 lossless mapping vanrawUMLNaarEditor-output naar IDE-store-shape (elements + structuralEdges + overzicht-diagram). Behoudt velden op entiteiten en directe entiteit→entiteit edges. - Nieuwe
valideerVoorV3(state): vlagt entiteiten met losse velden (regel V3-001) en directe entiteit→entiteit edges (V3-002). Bedoeld om bij V3-export en build te tonen, met directe links naar B5/B6/B7.
- Nieuwe
src/ide/ImportDialog.jsx: textuele UML-imports worden ingepakt als_format: "raw-editor"envelope (niet meer omgezet naar V3).editorNaarV3Model- import verwijderd.src/pages/IdePage.jsxhandleImportResult: extra case"raw-editor"→rawEditorNaarStore.src/ide/DetailsPanel.jsx: voor entiteit met losse velden tonen we deVeldenEditormet een waarschuwingsbanner ("⚠ niet metamodel-conform — gebruik B6 om te splitsen"). Bewerkbaar zodat kleine opschoning (naam/type) vóór splitsen kan.src/umleditor/import/importMermaid.js+importPlantUML.js: relatieve imports./rawuml→./rawuml.js(node-ESM-compatibel, zoals al elders gedaan).
Tests
src/store/rawEditorAdapter.test.js(NIEUW, 19 tests):rawEditorNaarStore: lege/undefined input, behoud van velden op entiteit, behoud van directe ent→ent edges, posities in overzicht-diagram, naam-collision.valideerVoorV3: lege store, V3-001 entiteit-velden, V3-002 directe edges, generalisatie/dependency/GE-edges blijven OK.- End-to-end import van alle 5 demo-bestanden in
demos/orphan-tests/(01–05): orphan-detectie + placeholder-roundtrip viarawEditorNaarStore.
- Totaal: 110/110 groen (was 91/91);
npm run buildsuccesvol.
Backlog gevolgen
- 0.2 (IDE mermaid-import) en 0.3 (orphan-tests) gemarkeerd als opgelost.
- Vervolg: UI-banner bij "Exporteer V3" en "Publiceer/Rebuild" die
valideerVoorV3aanroept en overtredingen toont met klikbare links naar de B5/B6/B7-acties.
IDE: editor-bewerkingen B5/B6/B7 + Project Browser-icoonplaatsing + node:test infra (2026-04-27)
Editor-bewerkingen (src/ide/transformations.js)
Drie pure transformaties die structurele wijzigingen op model-niveau doorvoeren met
gestructureerde {ok, warnings, errors, elements, structuralEdges, newIds, removedIds} output.
- B5 — Cast Entiteit naar GE (
castEntiteitNaarGE): zet metatype, synctdomeinmet parent (warning bij verschil), verwijdert inkomende edges van vreemde entiteiten en uitgaande edges naar entiteiten/relaties; voegt parent→GE compositie toe indien afwezig. - B6 — Splits Entiteit in GE's (
splitsEntiteit): genereert per geselecteerd veld een nieuwe GE${ent.typenaam}_${PascalCase(veld.naam)}met kardinaliteit1of0..1o.b.v.verplicht. - B7 — Promoot relatie tot associatieklasse (
relatieNaarAssociatieklasse): vervangt directe edgeA→BdoorA→Rel_A_B→B. Velden=[] initieel — ASOC-vorm activeert pas bij eerste veld viarelatieVorm().
UI-toegang:
- B5/B6: contextmenu op entiteit in
ProjectBrowser.jsx("Cast naar GE" / "Splits in GE's") - B7: edge-contextmenu in
DiagramCanvas.jsx("Promoot tot associatieklasse"), alleen zichtbaar voor entiteit↔entiteit edges die geen dependency zijn.
Caller patroon: passToePatch(useModelStore, patch) — controleert ok, toont warnings,
en commit elements/structuralEdges atomair via setState.
Project Browser: + iconen in FlexLayout tab-titel (iteratie 2)
Eerdere iteratie plaatste de "📁+" en "📐+" iconen in een vaste header-strip boven
de tree. Nieuwe plaatsing: in de FlexLayout tab-titel zelf, links van de
"maximize"-knop, via onRenderTabSet met renderValues.stickyButtons.
<FlexLayout.Layout
onRenderTabSet={(tabSetNode, renderValues) => {
const selected = tabSetNode.getSelectedNode();
if (selected?.getComponent?.() === COMP_BROWSER) {
renderValues.stickyButtons.push(
<button onClick={handleNieuwDomein}>📁+</button>,
<button onClick={handleNieuwDiagram}>📐+</button>
);
}
}}
/>
Voordeel: de iconen staan nu echt naast de "Project Browser" tab-tekst en nemen geen verticale ruimte meer in beslag.
Test-infrastructuur: node:test + Vite-alias resolver
web/vite/test/register-aliases.mjs+alias-resolver.mjs: minimale ESM-loader die@umleditor/...,@store/...,@shared/...,@ide/...aliases naar bestandspaden mapt zodatnode --testde imports vindt.package.jsonscript:npm test→node --import ./test/register-aliases.mjs --test 'src/**/*.test.js'.- Nieuwe testbestanden:
src/ide/transformations.test.js(18 tests B5/B6/B7)src/umleditor/import/rawuml.test.js(16 tests adapter + orphan-helpers)src/store/adapters.test.js(12 tests filterStoreByDomein + mergeStoreDomein)
- Totaal: 91 tests groen.
- Demo-bestanden voor handmatige UI-validatie:
demos/orphan-tests/*.mmdmet README.
Side effects
src/umleditor/import/rawuml.jsensrc/umleditor/import/_helpers.js: ontbrekende.jsextensies toegevoegd op relatieve imports zodat Node ESM-resolutie werkt (Vite was hier toleranter).
UML-editor + IDE: React 18 concurrent-mode + XyFlow ResizeObserver race-fix (2026-04-26)
Kritieke bug-fix: crash op elke paginalaad van editor-v2 (/react/editor-v2.html) en IDE (/react/ide.html).
Symptomen
- Bij paginalaad: error boundary toont "Failed to execute 'removeChild' on 'Node': The node to be removed is not a child of this node"
- Crash treedt op na initiële commit van MetamodelEditor/DiagramCanvasInner
- Zou willekeurig lijken, maar reproduceerbaar op elke laad (niet HMR-gerelateerd)
- StrictMode al uitgeschakeld; single-mount pattern al aanwezig in EditorV2Page
Root cause: React 18 concurrent mode + XyFlow 12 ResizeObserver race
- React 18 committeert DOM in meerdere microtask-fases
- XyFlow 12 plaatst een
ResizeObserverinuseLayoutEffectop het canvas-element - In Chrome vuurt
ResizeObserversynchroon zodraobserve()wordt aangeroepen (als element al dimensies heeft) - Dit gebeurt nog tijdens React's commit-fase → XyFlow probeert interne state te updaten en DOM-nodes te verplaatsen terwijl React nog bezig is met DOM-transfer
- Resultaat: DOM-tree-mismatch,
removeChildop node die React nog niet heeft vrijgegeven
Fix: defer ReactFlow mount één animation frame
const [reactFlowGereed, setReactFlowGereed] = useState(false);
useEffect(() => {
const raf = requestAnimationFrame(() => setReactFlowGereed(true));
return () => cancelAnimationFrame(raf);
}, []);
// In JSX:
{reactFlowGereed && <ReactFlow ... >...</ReactFlow>}
Hierdoor:
- React's initiële commit is compleet vóór
requestAnimationFramefired - ResizeObserver vuurt in een schone phase, niet tijdens commit
- All state (nodes, edges) is al geïnitialiseerd; de ~16ms delay is onmerkbaar
Bestanden:
- web/vite/src/umleditor/components/MetamodelEditor.jsx — editor-v2 fix
- web/vite/src/ide/DiagramCanvas.jsx — IDE fix
Impact: beide pagina's nu stabiel laadbaar; geen functionaliteitsverandering.
UML-import: RuwUML-tussenformaat + parser/adapter-splitsing (2026-04-26)
Derde slice van de UML-import-refactor. Doel: alle editor-conventies (stereotype-resolutie, ID-generatie, kleurkeuze, generalisatie-richting, edge-flags) op één plek concentreren, zodat de tekstuele parsers klein en puur blijven en bug-fixes niet drie keer hoeven te landen.
Nieuw: RuwUML als operationeel formaat
web/vite/src/umleditor/import/ruwuml.jsis uitgebreid van een spec-only bestand naar een volwaardige module: JSDoc-typedefs voorRuwUMLModel/RuwUMLNode/RuwUMLEdge/RuwUMLVeld, plus een nieuweruwUMLNaarEditor()-adapter die alle interpretatie naar editor-shape doet (stereotype-mapping, ID/kleur/positie, edge-conversie, auto-aanmaak van ontbrekende doel-nodes).- Nieuw uitgebreid ontwerpdocument:
docs/RAWUML.mdmet het waarom, het formaat, de pijplijn en de motivatie waarom XMI buiten RuwUML blijft.
Refactor: pure parsers
importMermaid.jsis van 309 → ~175 regels gegaan: alleen tokenisatie en block-parsing.mermaidNaarRuw()is nu apart geëxporteerd.importVanMermaidis een 1-liner:ruwUMLNaarEditor(mermaidNaarRuw(text)).importPlantUML.jsop dezelfde manier herschreven (van 335 → ~175 regels,plantumlNaarRuw()apart geëxporteerd).importXMI.jsblijft op zijn eigen pad — XMI heeft stabiele IDs, EA's AssociationClass-patroon en MIM-tagged-values die direct op editor-vorm mappen; een tussenstap zou informatie verliezen. Zie de uitleg indocs/RAWUML.md§6.
Onveranderd
- De orphan-helpers (
detecteerOrphans,pasOrphanActiesToe) en de OrphanDialog blijven ongewijzigd; ze werken op de editor-shape ná conversie en zijn dus identiek bruikbaar voor alle drie de bronnen.
UML-editor + IDE: orphan-detectie bij UML-import + textuele formaten in IDE-importdialoog (2026-04-26)
Tweede blok van de UML-import-refactor (zie docs/ontwerpgedachten/KISS/VAC/2026-04-26 refactor uml to v3.md). Doel: voorkomen dat losliggende GE/relatie-nodes na een UML-import stilletjes als "modelleerfout" in het canvas blijven hangen, en dezelfde Mermaid/PlantUML/XMI-bronnen ook vanuit de IDE kunnen worden ingelezen.
Nieuw: RuwUML-tussenformaat (JSDoc-spec) + orphan-helpers
web/vite/src/umleditor/import/ruwuml.jsdocumenteert via JSDoc een neutraal tussenformaat (RuwUMLModel/RuwUMLNode/RuwUMLEdge) tussen de drie parsers en de editor. In deze iteratie is alleen de spec gevuld; de drie parsers blijven editor-shape produceren.- Twee runtime-helpers werken direct op de editor-shape (
{nodes, edges}) en zijn dus meteen bruikbaar zonder parser-refactor:detecteerOrphans(graaf): vindt GE-nodes zonder compositie-edge vanuit een entiteit en relatie-nodes zonder koppeling naar een entiteit/anker.pasOrphanActiesToe(graaf, orphans, keuzes): voert per orphan de gekozen actie uit (placeholder,overslaan,abort) en geeft een nieuwe graaf + samenvattingsregels terug.
- Placeholders krijgen een eigen kleur (
#fde68a) en een vlagisPlaceholder: true.
Nieuw: OrphanDialog
web/vite/src/umleditor/components/OrphanDialog.jsxtoont per orphan naam + reden + drie radio-keuzes en een bulk-actie-dropdown ("alles op …"). Bevestigen levert eenkeuzes-map op; annuleren breekt de hele import af.- Gestyled als overlay-modal in de bestaande IDE/editor-paletkleuren (geen nieuwe CSS-bestanden).
Editor-v2: import-handlers door één wrapper
MetamodelEditor.jsxheeft een nieuweimportMetOrphanCheck(importerFn, accept, bron). De drie handlers (handleImportXMI,handleImportMermaid,handleImportPlantUML) zijn een 1-liner geworden die deze wrapper aanroepen. Bij orphans verschijnt de OrphanDialog; bijabortwordt er niets in het canvas geladen.
IDE-importdialoog: textuele UML-bronnen + auto-detect
web/vite/src/ide/ImportDialog.jsxaccepteert nu naast V3/IDE-v1 JSON ook.mmd,.md,.puml,.plantuml,.xmi,.xmlen.txt. Het formaat wordt automatisch bepaald op extensie en (bij ambigue extensies als.md/.txt/.xml) op een korte content-sniff (classDiagram→ Mermaid,@startuml→ PlantUML,<XMI/<?xml→ XMI).- Voor textuele formaten wordt direct na het kiezen van het bestand de juiste parser gedraaid; orphans verschijnen in dezelfde
OrphanDialogals in de editor. Daarna wordt de graaf viaeditorNaarV3Modelomgezet naar V3 en als V3-bestand aan de bestaande IDE-importflow doorgegeven (deonImport-handler hoeft dus niets te weten van de bron-syntax).
Bewust niet in dit blok
- De drie parsers leveren nog steeds editor-shape op; de RuwUML-conversie + gedeelde
ruwUMLNaarEditor-adapter staat in een vervolgslice. De huidige orphan-laag werkt op de editor-shape, dus dit blokkeert geen nieuwe functionaliteit. - ENT→GE-cast en handmatige conversie naar associatieklasse blijven uitgesteld.
UML-editor: import-roundtrip-bugs + stereotype-aliassen + ruwe save (2026-04-26)
Eerste blok van de UML-import-refactor (zie docs/ontwerpgedachten/KISS/VAC/2026-04-26 refactor uml to v3.md). Dit blok lost concrete roundtrip-bugs op en voegt enkele kleine, defensieve uitbreidingen toe; de bredere architectuur-refactor (RuwUML-tussenformaat, IDE-integratie, placeholder-dialoog) volgt in een volgend blok.
Ingetrokken: ASOC-promotie bij import van directe entiteit↔entiteit-edges
- Eerdere aanpak (verwijderd): een gedeelde helper
promoteEntiteitAssociatieszette directe entiteit↔entiteit-edges direct na de import om naar het ASOC-patroon (anker + relatie-node + drie edges). - Reden van intrekking: dit was te invasief voor eenvoudige UML-imports. Een associatieklasse ´zonder velden´ heeft conceptueel geen apart anker; de relatie í´s het anker (één bubble). Het patroon hoort een handmatige modelkeuze te zijn, niet een automatische import-bewerking. De ENT→GE-cast en de handmatige conversie naar associatieklasse landen in blok 2.
- Bestanden:
importMermaid.js,importPlantUML.js— alleen het aanroepen is verwijderd.promoteEntiteitAssociatiesblijft als ongebruikt hulpmiddel in_helpers.jsstaan voor toekomstig gebruik.
Bug: PlantUML-import verloor generalisatie
- Oorzaak:
maakEdgeinimportPlantUML.jshad geen detectie voor<|--/--|>/<|../..|>en zette zulke pijlen weg als gewone associaties (of als dependency wegens de..). - Fix: generalisatie-detectie + bron/doel-omdraaiing analoog aan
importMermaid.js. Dependency-detectie scherper gemaakt:..zonder|is dependency,..|is generalisatie. - Bestand:
web/vite/src/umleditor/import/importPlantUML.js.
Uitbreiding: stereotype-aliassen + bitemp::metatype taggedValue
- Nieuwe gedeelde resolver
mapStereotypesNaarMetain_helpers.jsmet aliasmap voor:ent/entiteit/objecttype,ge/gegevenselement/gegevensgroeptype,rel/relatie/relatiesoort/relatieklasse/associationclass,reflijst/referentielijst,refitem/referentielijstitem,refitems/referentielijstitems,refinstantie/referentielijstinstantie, plus modifiersmaterieel,datatype/gestructureerd datatype,enum/enumeration. - Mermaid en PlantUML gebruiken voortaan deze resolver; subtypes (
entiteitSubtype,relatieSubtype) worden meegenomen. - XMI-import herkent nu ook taggedValue
bitemp::metatypeen behandelt die via dezelfde alias-resolver. MIM-stereotypen blijven werken via de bestaandemapStereotypeNaarMetatype-fallback. - Bestanden:
_helpers.js,importMermaid.js,importPlantUML.js,importXMI.js.
Toevoeging: rauwe editor-staat opslaan (.editor-flow.json)
- Extra toolbar-knop 💾⚡ Ruwe staat slaat alleen
{ nodes, edges }op met markering_format: "editor-flow-v1". Bedoeld voor ontwikkeltijd: een werkende canvas-staat bewaren ook als die nog niet als V3 geldig is. - Laden vereist geen wijziging:
handleLoadherkendepayload.flowStateal en past die direct toe. - Bestanden:
MetamodelEditor.jsx,panels/Toolbar.jsx.
Bug: removeChild runtime-crash na hot-reload van editor-v2
- Oorzaak: de HMR-handler in
main.jsxtriggerde alleen een volledige reload bij wijzigingen in/uml-editor/src/(oude editor-locatie) en/web/vite/src/ide/, niet bij/web/vite/src/umleditor/(de huidige editor-v2-module). Een partiële HMR-update liet React Flow met stale DOM-nodes achter; de eerstvolgende render gooideFailed to execute 'removeChild' on 'Node'. - Fix:
/web/vite/src/umleditor/toegevoegd aan deheeftDomIntensieveWijziging-check, zodat wijzigingen in de editor-v2-module ook een volledige page-reload veroorzaken. - Bestand:
web/vite/src/main.jsx.
Bug: removeChild-crash bij eerste paginalaad van editor-v2
- Echte oorzaak (al langer bestaand):
EditorV2Pagerendert eerst de editor met demo-data en doet daarna in eenuseEffecteen fetch naar/api/schema/versies. Bij respons werdsetData(...)énsetEditorKey(k+1)aangeroepen om de editor met nieuwe data te remounten. Die geforceerde unmount-tijdens-startup race't met React Flow's interne DOM-cleanup (portals, observers); de reconciler ploft dan opFailed to execute 'removeChild' on 'Node': The node to be removed is not a child of this node. Symptomen: foutoverlay direct na harde reload (Cmd+Shift+R), Vite herstarten "loste" het op omdat de timing dan toevallig weer goed viel. - Fix: editor wordt pas één keer gemount nádat de fetch klaar is (succes of fail-fallback naar demo). Tijdens het laden toont de pagina een lichte placeholder.
editorKeyis verwijderd; geen remount-trick meer nodig. - Bestand:
web/vite/src/pages/EditorV2Page.jsx.
UML-editor: Mermaid-import overerving + domeinmenu multi-selectie (2026-04-26)
Bug: Mermaid import herkende generalisatiepijlen niet
- Oorzaak: het regex-patroon voor pijlsyntax (
[\ \-\.\*<>o]+) bevatte geen|, waardoor<|--en--|>pijlen (generalisatie/overerving) stil werden genegeerd en geen edge aanmaakten. - Fix:
|toegevoegd aan de tekenklasse inimportMermaid.js→[\ \-\.\*<>o|]+. Generalisatie-edges worden nu correct herkend en alsisGeneralization: trueedge aangemaakt. - Bestand:
web/vite/src/umleditor/import/importMermaid.js
Verbetering: domein wijzigen toegankelijk bij multi-selectie met edges
- Probleem: bij een selectie van meerdere nodes én edges vuurt React Flow
onSelectionContextMenuin plaats vanonNodeContextMenu. Hierdoor was het domein-wijzigen-menu niet bereikbaar via rechtsklik op een multi-selectie. - Fix:
toonContextMenudetecteert nu of de selectie model-nodes bevat (heeftDomeinWijziging-vlag).ContextMenutoont in het uitlijnmenu onderaan een Domein wijzigen-sectie (met bestaande domein-snelknoppen + vrij invoerveld) wanneer deze vlag actief is. - Bestanden:
MetamodelEditor.jsx,ContextMenu.jsx
Korte checklist voor een API-release met losse DB-stack.
Replay: betere foutdiagnose + preview; fix GE-veldnaam-disambiguatie (2026-04-19)
Bug: GE-veldnaam "naam" werd gekoppeld aan verkeerde entiteit bij replay
- Oorzaak:
UnmarshalJSONinmodel/REST request models.gogebruikteMetaRegistry.GetByVeldnaam(veldnaam)voor het opzoeken van een representatietype op JSON-veldnaam. Omdat meerdere types dezelfdeVeldnaamkunnen hebben (bijv.ApiStandaard_NaamenNatuurlijkPersoon_Naam→ beide "naam"), werd de eerste match (niet-deterministisch) geretourneerd, wat leidde tot fouten alsNatuurlijkPersoon_Naam_Inputwerd gebruikt terwijlApiStandaard_Naamwerd verwacht. - Fix:
UnmarshalJSONextraheert nu de JSON-sleutels uit de inner payload (bijv.apistandaard_id,naam) en roept de reeds bestaandeMetaRegistry.GetByVeldnaamMetPayload(veldnaam, payloadKeys)aan. Die disambigueert opEntiteitIDKolom(bijv.apistandaard_id→ApiStandaard_Naam). - Impact: replay files met GE's waarvan de veldnaam gedeeld wordt door meerdere types werken nu correct.
Backend: uitgebreidere foutmeldingen in de registreer-handler
- De wijziging-loop in
handlers/registration_handlers.gogebruikt nu een index (wijzigingIdx). - Alle foutmeldingen bevatten nu
wijziging[N], derepresentatienaamén develdnaam, zodat direct duidelijk is welke stap in de replay-body faalde. - Oud:
"failed to handle opvoer van NatuurlijkPersoon_Naam: ...". - Nieuw:
"wijziging[3]: opvoer van ApiStandaard_Naam (veldnaam=naam) mislukt: ...".
Frontend: replay-preview toont de geïmporteerde file
- Na import van een replay file wordt de volledige JSON opgeslagen en getoond in de preview-sectie onderaan de pagina (inclusief bron, export-tijdstip en aantal entries). Vóór import blijft het voorbeeld van de huidige registratieselectie zichtbaar.
maxHeightvan de preview verhoogd naar 400px.
Frontend: uitklapbare fout-details per replay-entry
- Foutrijen krijgen een rode achtergrond en zijn klikbaar (▸ / ▾).
- De detail-rij toont side-by-side:
- Request body (zoals verzonden, inclusief ID-offsets).
- Response body (volledige API-response, inclusief de nieuwe gedetailleerde foutmelding).
- De API
error-string uit de response body wordt direct getoond in de "Fout / details" kolom.
GraphQL enum cache fix — rol en andere enum-velden correct in response (2026-04-18)
Bug: enum-velden (o.a. rol) waren null in GraphQL-responses
- Oorzaak:
schemaTypeVoorReflectType()retourneerde"string"als Go-typenaam voor alle string-based enum-types (Gemeenterol, Fase, Organisatietype, etc.).makeEnumType()cachete het eerste enum-type onder key"string"inenumTypeCache, waarna alle volgende enums diezelfde (verkeerde) enum kregen. Bij serialisatie vond graphql-go de werkelijke waarde niet terug in de verkeerde enum →null. - Fix (
dynql/field_builder.go): infieldsVoorMeta()wordt nu de werkelijke Go-typenaam (bijv."Gemeenterol") als enum-naam doorgegeven aangoTypeToGraphQL(), zodat elke enum een unieke cache-entry krijgt. - Impact: alle enum-velden in alle hub+data types (InitiatiefGemeente.rol, Initiatief.fase, Organisatie.organisatietype, etc.) retourneren nu correcte waarden.
- Documentatie: zie
docs/graphql-enum-handling.mdvoor de volledige analyse.
Debug logging verwijderd
- Tijdelijke
[DEBUG laadHubKinderen],[DEBUG entityToMap]en[DEBUG flattenEntityMap]prints indynql/query_resolvers.gozijn verwijderd.
Frontend: pipe-karakter in data breekt markdown-tabellen niet meer
- Oorzaak:
renderTemplate()injecteerde ruwe datawaarden (met|) in markdown-templates;splitTabelRij()splitste op álle pipes. - Fix:
renderTemplate()(PublicatieDetail.jsx) escaped pipes als\|bij invoeging.splitTabelRij()split nu alleen op niet-geëscapede pipes (lookbehind regex) en unescaped daarna — in zowelPublicatieDetail.jsxalsMarkdownWeergave.jsx.
Publicatie detail — GraphQL query builder, [key=value] filter, weergavenaam-verrijking (2026-04-17)
Frontend: [key=value] filter in veldpad-templates
- Template-placeholders ondersteunen nu filter-syntax:
{{gemeenten[rol=Realiseert].weergavenaam}}filtert een array op het veldrolvóór verdere navigatie. - Geïmplementeerd in
parseSegment()enresolveVeldpadUitContext(), verplaatst naarpublicatieUtils.js.
Frontend: data-segment skip (REST ↔ GraphQL transparantie)
- Templates die
producten.data.typegebruiken, werken nu ook op GraphQL-responses waarbijdataal afgevlakt is: hetdata-segment wordt geskipt als de key ontbreekt.
Frontend: GraphQL query builder in PublicatieDetail
- Als een WeergaveDefinitie een
detailTemplateheeft, haaltPublicatieDetaildata op via GraphQL in plaats van REST/full/. - Functies
extractVeldpaden(),buildSelectieTree(),treeNaarGql(),buildGraphQLQuery()bouwen een gerichte GraphQL-query op basis van de template-placeholders. - Voordeel: diepe navigatie via forward FK relaties (bijv. contactpersoon-naam via Initiatief → ContactpersoonRelatie → NatuurlijkPersoon) werkt nu zonder extra REST-calls.
- Herbruikbare functies zijn verplaatst naar
web/vite/src/publicatie/publicatieUtils.js.
Backend: weergavenaam-verrijking in GraphQL-responses (dynql/query_resolvers.go)
verrijkWeergavenamen()wordt aangeroepen naflattenEntityMap()op alle vier call-sites (full entity, full list, forward relation, reverse relation).- Per kind-entiteit met een
SecondaireEntiteitIDKolomen eenIsWeergaveVeld-AfgeleidVeld worden de FK-waarden gebatcht opgehaald, de weergavenaam berekend viaberekenWeergavenaamVlak()+evalueerCELConcatenatieVlak(), en in de response-map ingezet. - Nieuwe helperfuncties:
laadWeergavenamenBatch(),berekenWeergavenaamVlak(),evalueerCELConcatenatieVlak(),navigeerAfgeleidPadVlak(),extractIntFromMap().
Tests toegevoegd
- Go (
handlers/full_handlers_weergavenaam_test.go): 12 unit tests voorevalueerCELConcatenatie,navigeerAfgeleidPad,berekenWeergavenaamVanEntiteit— geen DB nodig, volledig in-memory. - JS (
web/vite/src/publicatie/publicatieUtils.test.js): 27 unit tests voorparseSegment,segmentNaarString,resolveVeldpadUitContext,extractVeldpaden,buildSelectieTree,buildGraphQLQuery— gedraaid metnode --test.
Publicatie markdown — tabelweergave hersteld (2026-04-16)
- Oorzaak: de lokale markdown-renderer in de frontend ondersteunde geen GFM-tabellen, waardoor tabelsyntax als platte tekst werd weergegeven op de publicatiepagina en in de markdown-preview.
- Oplossing: tabelparsing toegevoegd aan
markdownNaarHtml()in zowelweb/vite/src/publicatie/PublicatieDetail.jsxalsweb/vite/src/components/editor/MarkdownWeergave.jsx. - Styling: tabelopmaak toegevoegd in
web/vite/src/styles/common-ground-theme.cssvoor zowel.cg-markdown-viewer__body tableals.cg-form-card table. - Resultaat: geldige markdown-tabellen renderen nu als HTML-tabel in publicatie en editor-preview.
Publicatie markdown — HTML entities niet meer zichtbaar (2026-04-16)
- Oorzaak: placeholderwaarden in
PublicatieDetailwerden eerst ge-escaped inrenderTemplate()en daarna nogmaals viamarkdownNaarHtml(), waardoor tekst alsAPI's & opslagzichtbaar werd. - Oplossing: placeholder-invoeging in
renderTemplate()gebruikt nu ruwe tekst; escaping blijft centraal inmarkdownNaarHtml(). - Resultaat: waarden uit de API worden weer normaal getoond, bijvoorbeeld
API's & opslag.
CG Portfolio — modeluitbreiding extra velden + meervoudige weergave (2026-04-16)
DB-migratie: 20260415_add_cg_beoordeling_etalage_extra_velden.sql
Voer dit script uit op de applicatiedatabase (bitemp_go_db_v06) vóór de volgende backend-start. Alle kolommen zijn nullable (backward-compatible).
Nieuwe kolommen op bestaande tabellen:
| Tabel | Kolom | Type | Toelichting |
|---|---|---|---|
initiatief_planning_data |
obstakels |
TEXT | Beschrijving van obstakels voor de planning |
initiatief_planning_data |
verwacht_ready_datum |
DATE | Verwachte datum van gereedmelding |
initiatief_product_data |
vervangt_ouder_product |
BOOLEAN | Vervangt dit product een ouder product? |
initiatief_bijdrage_data |
score |
INTEGER | Numerieke beoordelingsscore |
initiatief_initiatiefinfo_data |
aanmeldingsdatum |
DATE | Datum van aanmelding van het initiatief |
Nieuwe tabellen (initiatief_beoordeling, initiatief_beoordeling_data, initiatief_beoordeling_aanvang, initiatief_beoordeling_einde, initiatief_etalage, initiatief_etalage_data) worden automatisch aangemaakt via Bun IfNotExists() bij backend-start — geen handmatige DDL nodig.
Backend: meervoudige weergavenaam-verrijking (handlers/full_handlers.go)
Relatie-hubs met een SecondaireEntiteitIDKolom én een IsWeergaveVeld-AfgeleidVeld (zoals InitiatiefDomein) krijgen nu automatisch een weergavenaam-veld meegeleverd in de /full/-response. De waarde wordt server-side bepaald door de doelentiteit (bijv. Domein) op te halen en het AfgeleidVeld-pad te navigeren.
Frontend: meervoudige veldpaden (PublicatieTabel.jsx)
resolveVeldpad() ondersteunt nu meervoudig momentvoorkomen: bij een GE/relatie met meerdere actieve items worden alle waarden verzameld en samengevoegd met ", ". Voorbeeld: "initiatief_domeinen.weergavenaam" geeft "Standaarden, Componenten".
Weergave replay bijgewerkt
registraties-replay-init-standaard-weergavedefinities.json: kolom "Domeinen" (veldpad "initiatief_domeinen.weergavenaam") toegevoegd aan de Initiatief-standaardweergave.
Frontend: filter voor meervoudige kolommen (PublicatieTabel.jsx)
De globale zoekfunctie en per-kolom-filter werken nu ook correct voor meervoudige veldpaden (bijv. "initiatief_domeinen.weergavenaam").
Oorzaken van het probleem:
- TanStack Table kan kolom-IDs met punten (
.) intern inconsistent afhandelen. - Kolommen gebaseerd op
accessorFn+ een verouderdetypeMetaByTypenaam-closure kondennullteruggeven in de filter-fase, ondanks correct tonen in de cell-renderer.
Oplossing (dubbele aanpak):
sanitizeKolId(): vervangt punten in veldpaden door__voor veilige TanStack-sleutels.resolvedDatamemo: pre-berekent alle kolomwaarden upfront (inclusief meervoudige samenvoegingen) als directe string-properties op elke rij.- Kolommen gebruiken nu
accessorKey(eenvoudige string) i.p.v.id + accessorFn, zodat TanStack de waarde rechtstreeks uitresolvedData[sanitizeKolId(veldpad)]leest. standaardSorteringID is eveneens gesaniteerd.
Resultaat: filter en sortering werken nu voor alle kolomtypen — enkelvoudig en meervoudig.
Editor v2 — dependency visibility & roundtrip fix (2026-04-08)
«use»dependency-edges kunnen nu per stuk of per doel-node verborgen/getoond worden via rechtsklik in editor v2.- Rechtsklik op een stippellijn →
Verberg deze dependency. - Rechtsklik op een enum of gegevenstype →
Verberg dependencies/Toon dependenciesvoor alle inkomende«use»-lijnen. - De metadata voor deze lijnen (
id,sourceHandle,targetHandle,hidden) blijft nu behouden in V3 JSON viauseEdges[]. - Daarnaast blijft deze info nu ook behouden bij editor → V3 → codegen → MetaRegistry → V3 → editor roundtrips, doordat de codegenerator
useEdges[]opslaat inEditorLayout.UseEdgesin de gegenereerde*_metaregistry.gobestanden en de V3 exporter die weer teruggeeft.
Frontend visual tweak (2026-04-01)
- Index visualisatie: centrale entiteitstekst schaalt nu mee met de lengte van de weergavetekst in de representatiekaart.
- Effect: lange labels (zoals bij Locatie-adressen) worden iets kleiner getoond dan korte labels, zodat de verhouding met NatuurlijkPersoon visueel consistenter blijft.
Runtime fix notes (2026-03-21)
GET /full/<entiteit>?t=<...>: tijdelijke workaround toegevoegd voor een Bun v1.1.14 panic bij genestehas-manyrelaties met callback-filters.- Symptoom:
reflect: call of reflect.Value.Field on zero Valuetijdensrelation.selectMany. - Aanpak: peiltijdstip-filter blijft op hub-niveau actief; geneste hub-kinderen (
Data,Aanvang,Einde) worden tijdelijk niet mee-geladen in dezelfde full-query. - Trade-off: full-responses bevatten tijdelijk geen geneste hub-kinderen; clients moeten hiervoor (tijdelijk) dedicated endpoints gebruiken.
- TODO: na Bun-upgrade opnieuw valideren en callback-filter op geneste relaties herstellen.
- DB startup fix: bestaande functie
f_formele_wijziging_op_peil(timestamptz)wordt nu eerst gedropt en daarna opnieuw aangemaakt. - Reden: PostgreSQL staat geen wijziging van de
RETURNS TABLEsignature toe viaCREATE OR REPLACE FUNCTION(SQLSTATE42P13). - Post-load hub-kinderen:
laadHubKinderenNaQuery()laadt Data/Aanvang/Einde records in aparte batch-queries na de hoofd-query, als workaround voor de Bun v1.1.14 geneste has-many panic. ZieONTWERP_DATA_PATTERN.md§15. - Afgeleide formele tijd:
vulAfgeleideFormeleTijdVoorFullEntity()daalt nu ook af in hub-kinderen (Data/Aanvang/Einde) bij peiltijdstip-filtering.
V3.1 runtime extensie (2026-03-29)
- V3 modelformaat uitgebreid met runtime/deployment metadata (
V3Runtime), zodat frontends (content editor, formulieren) en API-clients alle benodigde paden, tabelnamen en kolominfo rechtstreeks uit de model-API (/api/schema/model) kunnen lezen — zonder de oudereviz/schema-API nodig te hebben. - Nieuw type
V3Runtimeinmodel/v3_format.gomet velden:veldnaam,padnaam,tabelnaam,idKolom,heeftPFK,entiteitIDKolom,klassenaam,relatieveAutoincrement. V3Runtimewordt als"runtime"(omitempty) opgenomen inV3Entiteit,V3GegevenselementenV3Relatie.V3Velduitgebreid met OAS 3.1type,formatenverplichtvelden, zodat frontends weten welk invoerveld ze moeten renderen.- V3 exporter (
model/v3_exporter.go) aangevuld metruntimeVanMeta()enoasTypeVoorGoType()helpers; alle drie de builder-functies vullen nuRuntimeen de veld-loop vultType/Format/Verplicht. - Volledig backward-compatible: alle nieuwe JSON-velden gebruiken
omitempty, codegen en UML-editor negeren ze. - Nieuwe tests in
model/v3_exporter_test.govoor runtime op entiteiten, relaties, en OAS type/format op velden. - Zie
docs/v3_1_runtime.mdvoor de volledige technische documentatie.
Runtime fix notes (2026-03-26)
- Editor v2 laadt bij opstart standaard de nieuwste DB-versie via
GET /api/schema/versiesen daarnamodel_url. - Statusbar toont nu modelbron (
[DB #id (status)]of[demo]) en modelnaam met tooltip op modelbeschrijving. - CORS-fix: middleware-registratie staat nu vóór alle route-definities, zodat ook
GET /api/schema/versiesCORS-headers teruggeeft voor Vite dev-origin (localhost:5174). - Persistency-fix afgeleide velden: Go V3 struct-model uitgebreid zodat deze velden niet meer wegvallen bij
POST /api/schema/model:V3Entiteit.AfgeleideVeldenV3Veld.AfgeleidV3Veld.AfleidingsregelTaalV3Veld.Afleidingsregel- nieuw type
V3AfgeleidVeld
- Effect: afgeleide velden blijven nu behouden na publiceren naar DB en reload van editor v2.
1. Nieuwe image bouwen en pushen
docker build --no-cache -t markwestbroek/bitemp-go-api:v06.00.01 .
docker push markwestbroek/bitemp-go-api:v06.00.01
2. API tag bijwerken op server
In .env.docker:
API_IMAGE=markwestbroek/bitemp-go-api:v06.00.01
2.1 Eerste deployment op een lege server
Als de doel-database nog niet bestaat, kun je de API deze eenmalig laten aanmaken:
AUTO_CREATE_DATABASE=true
Optioneel (aanrader): gebruik een admin connectie met CREATEDB-rechten:
DATABASE_ADMIN_URL=postgres://postgres:<password>@<host>:5432/postgres?sslmode=disable
Na succesvolle eerste start kun je AUTO_CREATE_DATABASE weer uitzetten of verwijderen.
3. API stack redeployen
docker compose -f docker-compose.api-only.yml up -d
4. Smoke test
curl http://<server-ip>:8082/version
curl http://<server-ip>:8082/viz/index_schema.html
docker logs --tail 100 bitemp-go-api-v06
5. Rollback (indien nodig)
Zet API_IMAGE terug naar vorige stabiele tag in .env.docker en redeploy:
docker compose -f docker-compose.api-only.yml up -d
6. Opruimen (optioneel)
Verwijder lokaal oude ongebruikte images:
docker image prune -a
Verwijder oude tags in Docker Hub volgens je bewaarbeleid.