Bestand: RELEASE.md

# 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 in cmd/codegen/CHANGELOG.md. Versionering-conventie: docs/versiebeheer.md — backend-tags gebruiken de prefix api/ (baseline api/v0.5.0 op main). 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): argument sorteer: [{ veld, aflopend }] op <padnaam> en full_<padnaam>_list, hooguit drie sleutels. veld is 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 geen ORDER 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 marks register.zoeksleutel en register.sorteerbaar uit de bijlage marks naast het V3-model geven een index ix_<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 in dynql (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.sql versie 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.sorteerbaar nog 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 marks op /export/v3 niet).
  • Andere stap: nee.
  • App: bitemp-go-api:0.29.0 via update.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 als marks naast kruisverbanden; 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.sorteerbaar en (gereserveerd) register.tekstzoeken op 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 velden marks en markContext) zetten de geldende marks als blok marks naast 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/v3 en 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.0 en bitemp-render-svc:0.5.0 via update.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 met uniek een 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 compileerde model niet 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): dbsetup zet 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.sql voor 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.0 via update.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 met requiredDecision) 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.0 en bitemp-render-svc:0.4.9 via update.sh. Geen schemawijziging, geen rebuild.
  • Daarna zet DEMO-PROJECT de Waterstede-scenario's in het demo-project (script klaar).
  • Fundament: bitemp-devloop met 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.mjs vult 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.0 en bitemp-render-svc:0.4.8 via update.sh. Geen schemawijziging, geen rebuild. Daarna (optioneel, aanbevolen) per server één keer node 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.7 en viz-frontend:0.43.0 via update.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") op POST …/samenvoegen, doorgegeven aan de sidecar; antwoord met opgelost. Zonder keuze werkt het als in 0.26.0.
  • render 0.4.6: keuze op /samenvoegen (opgelost, samenhang in het antwoord); /vergelijk geeft per verschil sleutel, mapId, ouderId en de mappen. Een sidecar 0.4.5 weigert keuze (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.6 en viz-frontend:0.42.0 via update.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/samenvoegen schrijft de ops voor main en branch in één transactie en vervangt de basis; 409 met reden conflicten, buiten_map of volgnummer_verschoven. Ook de CORS-header X-Omnium-Client (al op main, alleen voor dev).
    • render 0.4.5: POST /samenvoegen rekent het samengevoegde model en de ops uit en speelt ze ter controle na. Een oudere sidecar geeft 502 met reden sidecar.
  • 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.5 en viz-frontend:0.41.0 via update.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-Client toe (alleen nodig voor de Studio op een Vite-poort in dev).

Uitrol:

  • App: bitemp-render-svc:0.4.4 en viz-frontend:0.40.0 via update.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): profielVersies in het werkbestand; een oudere Studio meldt een project dat op een nieuwere profielversie leunt. Bewaking in render-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.3 en viz-frontend:0.39.0 via update.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.3 via update.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: erft wordt ook een generalisatie voor 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.2 via update.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): erft wordt een generalisatie-connector, ook als het project al iets bevat (ging verloren); een V3.1-veld zonder goType en zonder verplicht is optioneel (werd verplicht). Melding AI-INRICHTEN.
  • E2E-test voor Branch maken….

Uitrol:

  • App: viz-frontend:0.38.1 via update.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. formulierdiagram van een branch) plus laatsteVolgnummer, zodat Imprint de Studio-stores niet hoeft na te bouwen. Blob, ops op model:<profiel> en het laatste volgnummer in één REPEATABLE READ-transactie; naspelen door render-svc POST /materialiseer (render 0.4.2, al uitgebracht). Een oudere sidecar geeft 502 met reden sidecar.
  • Eén branch per ouder + map: POST …/afsplitsen met een mapId geeft 409 {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 de mapId door aan de render-sidecar (POST /vergelijk). Het antwoord gaat door met main/tak: {projectId, laatsteVolgnummer} erbij. Lezen op branch én ouder. Werkt pas met een render-svc die /vergelijk kent (OMNIUM-UI, nog niet uitgebracht); tot dan 502 met reden sidecar.
  • namens op POST …/ops: de eindgebruiker voor wie een serviceaccount schrijft (Imprint via omnium-schrijver). Alleen van accounts in env OMNIUM_NAMENS_ACCOUNTS, anders 403 namens_niet_toegestaan. actor blijft het account; namens staat ernaast in GET …/ops en SSE. Schema: kolom studio_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, met OMNIUM_NAMENS_ACCOUNTS=omnium-schrijver, het account omnium-schrijver (rol modelleur, token in de secret) en een toegangsrij schrijven op 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 met FOR UPDATE op de ouder. De blob, tot_volgnummer en de staart-ops (met dezelfde volgnummers) komen van de ouder, net als de toegang; wie afsplitst wordt eigenaar.
    • GET …/:id/basis geeft de onveranderlijke basis (profiel + ops) uit de nieuwe tabel studio_project_basis, voor een 3-weg-merge. De compactie raakt hem niet.
    • Lijst en GET tonen herkomst {ouderProject, basisVolgnummer, mapId, afgesplitstOp, afgesplitstDoor, gearchiveerd}. De server kent geen mappen: mapId is alleen herkomst.
    • De van de ouder gekopieerde ops tellen niet mee voor project_in_gebruik.
  • verwachtLaatsteVolgnummer op POST …/ops (optioneel): 409 volgnummer_verschoven als het project verder is. Voor de merge naar de ouder en als revisiecheck per op.
  • Schema: kolommen ouder_project_id, basis_volgnummer, map_id, gearchiveerd op studio_projecten (ADD COLUMN IF NOT EXISTS) en de tabel studio_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 op model:<profiel>); nodig voor GET /api/studio/projecten/:id/model/:profiel van de backend.

Uitrol:

  • App: bitemp-render-svc:0.4.2 en viz-frontend:0.38.0 via update.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 veld verplicht (alleen strenger), key, elementId; vorm bestand; 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-neutraal naast 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 als bronUuid);
    • een bpmn-artefact haalt zijn proces uit het project (bron.model: "project:<profiel>").
  • 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-gzac 0.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.

  • 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/v3 gebruikt 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_domeinen opnieuw uit het model, ook het standaardpakket. Op cg-test kwam ide_bestanden zo 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 register mee.

    Zie DEVLOOP.md §"Standaardpakket bij de startup-rebuild".

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. goCommentaar zet 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/v3 in de render-sidecar en dus GET /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, bijvoorbeeld aanvraagtypedefinitie_aanvraagtype met _data, _aanvang en _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>/:id toont referentielijst_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 $ref naar zo'n relatie.

Uitrol:

  • Fundament: bitemp-devloop:0.25.2, door FUNDAMENT.
  • App: niet nodig, want alleen codegen verandert. bitemp-go-api:0.22.1 staat 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 (koppelsoorten in de project-JSON, sync-operatie kruis/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: true maakt 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).
  • 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/versies toont de lijst en ook bron_project_*; die herkomstvelden ontbraken sinds 0.21.0.
  • Opruimen van achtergebleven tabellen (alleen devloop, met het beheerwachtwoord):
    • GET /admin/wees-tabellen en POST /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 DROP zonder CASCADE.
  • Devloop-image: bewaart /app/_image/model als 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):
    • ExterneReferentie en 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;
    • precies met [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.sh op app. De kolom gebouwde_domeinen komt 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 met domeinen en precies: 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 met DROP COLUMN blijft een bewuste beheerdersstap (CODEGEN.md §7.3e).
  • De upgrade naar 0.24.13 gaf ongeveer twee minuten uitval. De startup-rebuild las schema_versies met alle kolommen van het model, vóór de migratie die bron_project_id toevoegt. Dat gaf "column does not exist", waarna de ingebakken code startte en het register 404 gaf. De laders lezen nu alleen id, schema_json en status (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_versies zonder 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. Zonder domeinen worden alle domeinen van het model gebouwd. De gebouwde versie wordt actief met bron: "studio-project" en de herkomst bron_project_id, bron_project_versie en bron_tot_volgnummer, die ook in GET /api/schema/versies staat.
  • 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_profiel of export (422), met de meldingen van 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.achterstand zegt hoeveel wijzigingen er niet in zitten. Bedoeld voor pariteit met een V3-bestand.
  • Codegen: een subtype heeft geen eigen tijdlijn. isMaterieel: true of tijdprecisie op een entiteit met erft laat 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 "; de V3-export laat ze weg en de modelcontrole waarschuwt. Codegen weigert ze op een entiteit met 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/:id geeft 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, server mee.
  • De eigen tab noemt zich met clientId in de body of de header X-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 hook extraCompartimenten (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, en X-Omnium-Achterstand als er operaties zijn die nog niet in de snapshot zitten.
  • Soort svg bij de gedeelde plaatjes: POST …/beelden met soort: "svg" (zonder png) 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. .png op 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; HEAD geeft 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.js snapshotNu), 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 soort svg. 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 draagt data-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=studio tekent 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-versie op de wortel (komt ongewijzigd door de Go-API); de sidecar zet ook X-Render-Versie, en GET /health geeft versie. Bron: render-svc/package.json.
  • Bouw: de bundel vond @xyflow/system niet in een schone checkout (Docker), omdat de bronnen in web/vite staan zonder node_modules. render-svc heeft het pakket nu als devDependency en bouw.mjs zoekt ook in de eigen node_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=studio via 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=studio op POST /api/render/svg (stap 1, 04-11): een Studio-projectexport of één profiel in de body, profiel en diagram als keuze, elk ingebouwd profiel (M2). POST /views geeft ook weergaven: [{ id, naam, profiel }]. 422 bij een eigen profiel uit de ontwerper of een onbekend elementtype; 503 studio-niet-beschikbaar als de profielbundel ontbreekt (v3 werkt dan door). Zie docs/RENDER_API.md §taal=studio.
  • Tekent met de ene tekenaar (stap 5, 04-11): diagramsvg/studio.js krijgt tekenDiagram en naarSvg uit 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), met controleer: 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 (geen foreignObject, geen scripts).
  • Bouw: render-svc/bouw.mjs (esbuild, .jsx als stub) maakt de profielbundel; Dockerfile.render en .dockerignore aangepast. npm test in render-svc/ bouwt en test.
  • Niet getest: taal=studio via 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 kolom datum van de _Aanvang-/_Einde-tabellen van date naar timestamptz verbreed (een dag wordt middernacht UTC).
  • Voor materieel én enkelvoudige GE's/relaties verdwijnt de constraint ux_<tabel>_enkelvoudig_actief op 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_REBUILD geldt 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 /full en 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, kolom timestamptz, einde exclusief.
  • uuid uit de Studio: op de zeven V3-soorten (entiteit, GE, relatie, veld, enum, datatype, referentielijst-instantie); codegen neemt hem over in TypeMeta.UUID, EnumUUIDs, DatatypeRegistry, ReferentielijstInstantieRegistry en als tag uuid:"…" 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 /health en de subcommando's bitemp-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_desc voor 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 hij uniek; 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 openbaar GET /api/beeld/<token>.png. Het token (24 bytes) is de toegang. Momentopname: zelfde plaatje = zelfde adres, immutable. Actueel: één adres per diagram, no-cache met 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, tabel gebruiker_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.json in de repo-root; OMNIUM_URL/OMNIUM_TOKEN uit 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), tabel melding_bestand voor 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. Enum Gebruikersrol uitgebreid; PEP en Rego-beleid kennen dezelfde rangorde.
  • Toegang per Studio-project, "alles dicht tenzij" (handlers/studio_project_toegang.go): tabel studio_project_toegang; eigenaar en beheerder mogen alles, anderen alleen met een rij (gebruiker of *, lezen/schrijven). Zonder leesrecht 404. Lijst gefilterd en met recht; 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): tabel gebruiker_uitnodiging (alleen de hash van de token), beheer-endpoints /api/gebruikers/uitnodigingen, openbaar /api/uitnodiging/:token (+ /accepteer, rate limited). Aan met UITNODIGEN_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; /full en 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} (was 0..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 .qea die 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 met STUDIO_EA_IMPORT_MAPPEN (zonder: 501, dus uit op app en pf), _DIR, _NODE, _API, _PULL; zie docs/API_REFERENCE.md en .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, APIVersion 0.12.0): tabel studio_project_ops (operatielog per project, volgnummer), kolom studio_projecten.tot_volgnummer (snapshot-grens), tabel studio_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-PUT ruimt operaties t/m de grens op. Nieuwe instelling STUDIO_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.0 en bitemp-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: no en stuurt elke 15 s een keepalive (nginx proxy_read_timeout 60 s). Caddy streamt text/event-stream zonder 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) en GET/POST/PUT/DELETE /api/studio/projecten[/:id] (handlers/studio_project_handler.go). Lezen voor iedereen die is ingelogd, schrijven voor editor, verwijderen door eigenaar of admin; PUT weigert met 409 (plus servermeta) als de versie op de server verder is. Bewust geen bitemporele entiteit: tussenstap tot het modelregister.
  • APIVersion staat op 0.11.0.

Databasegevolg bij uitrol

  • studio_projecten wordt bij het opstarten aangemaakt (IfNotExists); geen migratie van bestaande tabellen.

Uitrol

  • Twee images: bitemp-go-api:0.11.0 en bitemp-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, header API-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 gebruiker wordt bij de eerste opstart omgezet. De oude platte tabel heet daarna gebruiker_oud; elke rij wordt een registratie (identiteit, status, roltoewijzing) en de wachtwoord-hash gaat naar gebruiker_inlog. Bestaande wachtwoorden blijven werken. gebruiker_oud blijft staan; verwijder hem met de hand als alles klopt. Idempotent.
  • handlers.LoginHandler en handlers.SeedAdminGebruiker zijn verhuisd naar package gebruikers. 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-tabel gebruiker_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 beheer is alleen voor admins, ook lezen en ook met LEESTOEGANG=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.0 en bitemp-viz-frontend:0.12.0; render-svc blijft 0.1.0.
  • Backup vooraf (de tabel gebruiker wordt omgezet). update.sh doet 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.svg en …/views.json: een gepubliceerd model op naam, versie en tijdstip (asOf), uit schema_versies.
    • ETag over de SVG en 304 op If-None-Match; fouten als application/problem+json; 502 als 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 in docker-compose.yml en in deploy/vps/docker-compose.vps.yml.
  • Scripts:
    • maak_uitleg_correctie.py: de tekst van een uitleg wijzigen in één replay;
    • maak_nl_kaartdata.py zet elke stip op de mediaan van de adressen van de gemeente;
    • geef_definities_code.py voert 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 bij vorm-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 in docker-compose.vps.yml (nog niet uitgerold).

Gewijzigd

  • APIVersion (OpenAPI en de header API-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_URL op de API: het interne adres van de sidecar (standaard http://127.0.0.1:8095).
  • RENDER_IMAGE in de .env van de VPS-compose (standaard markwestbroek/bitemp-render-svc:latest).
  • Op de sidecar zelf: RENDER_SVC_PORT (8095), RENDER_SVC_HOST en RENDER_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.

Zie web/vite/CHANGELOG.md.

Uitrol

  • Drie images: bitemp-go-api:0.9.0, bitemp-viz-frontend:0.11.0 en, nieuw, bitemp-render-svc:0.1.0 (git-tag render/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: /version gaf op 6 oktober commit d2340e69 (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 in docker-compose.pf.yml staat.
  • Na het uitrollen: controleer /version, de header API-Version: 0.9.0 en één POST /api/render/svg (voorbeeld in VPS_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 generiek filter-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 in OPENBARE_FORMULIEREN:
    • vaste waarden worden afgedwongen, bron aanmeldformulier;
    • een nieuwe doelentiteit kan vanuit een relatieveld, met plaatshouder-id's op de server.
  • 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).
  • code op definities: formulier-, weergave- en lijstdefinities hebben een leesbare sleutel die op elke instantie gelijk is. Te gebruiken in plaats van het id, ook in OPENBARE_FORMULIEREN.
  • Validatie en uniekheid:
    • Normaliseren volgens het datatype op de server (model/normalisatie.go).
    • Validatie-API POST /api/valideer en /api/valideer/functies.
    • Uniekheid in het model (uniek: entiteit, domein of register): een botsing geeft een 422 met code uniek.
    • Gedeelde testset voor Go en JS (testdata/validatie/).
  • Datatype EnumLijst: meer enum-waarden in één veld. Gebruikt voor CG_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). Zie docs/AI_ASSISTENT.md en docs/AI_PROXY_MODEL.md.
  • 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.
  • Waarden worden bij het opslaan genormaliseerd, bv. 1234 ab → 1234 AB. Een client die exact dezelfde tekst terugverwacht, krijgt de genormaliseerde vorm.
  • Een dubbele code op een formulier-, weergave-, lijstdefinitie of uitleg wordt geweigerd (422 uniek). Een replay met dubbele codes faalt dus.
  • APIVersion (OpenAPI en de header API-Version) staat nu op 0.8.0. Hij stond nog op 0.6.0.

Gerepareerd

  • GraphQL: or zonder alternatieven is nooit waar, null in and/or wordt 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.

Zie web/vite/CHANGELOG.md.

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, zie VPS_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.devloop en de in-container rebuild bouwen mét. Lokaal: go run -tags devtools .
  • POST /registraties en POST /wijzigingen zijn verwijderd (de audit-routes zijn read-only). POST /{padnaam} en DELETE /{padnaam}/:id lopen nu via de registratie-engine en leveren een registratie_id; er ontstaat dus altijd een registratie met wijzigingen.
  • Authenticatie wordt afgedwongen. Bij AUTH_ENABLED=true is JWT_SECRET verplicht (anders start de API niet), muterende routes vereisen minimaal de rol editor, 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 doet RegistreerJSONCore één herkansing. Interne fouten lekken geen databasetekst meer.

Toegevoegd

  • REGISTRATIE_TIJD=synthetisch|klok (default synthetisch, de demo-modus waar de tijdlijnpagina's op leunen; echte implementaties zoals het CG-domein horen klok).
  • 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 /viz uit een andere map (test-instantie in een worktree zonder gebouwde frontend).
  • Enum-validatie: schema:"enum=…" wordt gecontroleerd tegen EnumWaarden (422 application/problem+json, code enum).
  • 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. Zie docs/REGRESSIETEST.md en docs/TESTSUITE_VERKENNING.md. Startscripts: scripts/regressie-ui.ps1, scripts/regressie-bekijk.ps1, scripts/regressie-np-loc.ps1; seed-generator scripts/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 met FOR UPDATE.
  • PATCH /full/{padnaam}/:id injecteert 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 een max_queries-scenario.
  • .env staat niet meer in git; .env.example dekt alle sleutels.

Gerepareerd

  • Enkelvoudige hub vervangen liet actieve data achter (fix/enkelvoudige-hub-afvoer): kinderen krijgen de rel_id van 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: zie docs/plans/2026-09-21 Merge-notitie — reflijst-combobox en enkelvoudige hub-afvoer.md §5.
  • /api/viz/reflijst/{typenaam}/opties toont 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/rebuild of /admin/diff gebruikt, tenzij daar bewust een devtools-image draait. Voor app.omnium-ide.nl is dat besluit nog open (zie docs/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=true dat JWT_SECRET en 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 (enum Geslachtsaanduiding) en Aanspraak (aanspreektitel, formeelAanspreken — beide optioneel, de illustratie van driewaardige optionaliteit), plus de relaties Woonlocatie → Locatie en Gebiedsligging → Gemeentedeel.
  • Nieuw domein org-geo (prefix org_geo_): Afdeling, Medewerker, Gemeentedeel; Organisatie en Gemeente uit CG hergebruikt in plaats van nagemaakt (de MetaRegistry is één map op typenaam). Init in model/metaregistry_plumbing.go.
  • Databasegevolg bij uitrol: puur additief. dbsetup.CreateTables loopt over de MetaRegistry en maakt elke tabel met CREATE TABLE IF NOT EXISTS; de nieuwe org_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.go botst met datatype_aliases_extra.go bij een volledige export, en *_modellen_input.go draagt handmatige delta's (Aanvang/Einde eruit, sommige schema:-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 plus latest; versie-tag onveranderlijk), waarom altijd linux/amd64, de releaseprocedure per component, rollback en de checklist.
  • Vervallen: het oude image-tagschema v06.00.01. De Docker-tag is voortaan het componentnummer uit docs/versiebeheer.md §7 zonder prefix en zonder v.
  • Gepubliceerd:
    • markwestbroek/bitemp-go-api:0.5.0 + latest — ongewijzigde Go-code t.o.v. tag api/v0.5.0; dit is de eerste v06-API op Docker Hub (daar stonden alleen nog v04.*-tags uit maart/april).
    • markwestbroek/bitemp-viz-frontend:0.6.0 + latest — bevat Toegangsspraak/Toegangsregel en de Sequence-, BPMN- en ArchiMate-profielen; zie web/vite/CHANGELOG.md.
  • Bijgewerkt: docker.md (§ inleiding, componenttabel, §12), .env.docker.example, docker-compose.api-only.yml en docker-compose.frontend-only.yml (verouderde :v05/:v06 defaults → :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 de Registratie-struct:
    • Bron *string (JSON: bron, Bun: bron,nullzero) — systeem of component dat de registratie aanmaakte
    • BronKenmerk *string (JSON: bron_kenmerk, Bun: bron_kenmerk,nullzero) — referentie in het bronsysteem (bijv. process instance ID)
  • dbsetup/createtables.go — Nieuwe idempotente migratiefunctie ensureRegistratieBronMigrated: voegt bron en bron_kenmerk VARCHAR-kolommen toe aan de registratie-tabel als die nog niet bestaan. Aanroep in CreateTables() na ensureRegistratieDomeinenMigrated.

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 BSN 430050100 (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 een registratie_id werkt (geen entiteit/GE/REL). De resolver bouwt de ongedaanmaking-payload server-side en delegeert aan dezelfde RegistreerJSONCore als de bestaande maak_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 typed maakRegistratieOngedaan, §4b JSON-fallback, §5 stap-voor-stap workflow-tabel.
  • Tests: 2 nieuwe tests in dynql/maak_registratie_ongedaan_test.go voor input-validatie van de nieuwe resolver.

Bestanden:

  • dynql/mutation_resolvers.go — makeMaakRegistratieOngedaanResolver() toegevoegd
  • dynql/schema_builder.go — maakRegistratieOngedaan field geregistreerd
  • dynql/maak_registratie_ongedaan_test.go — nieuwe tests
  • GRAPHQL.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 action removeStructuralEdge(edgeId) voor het verwijderen van scope-edges (en andere structurele edges) uit de store.

  • ide/DiagramCanvas.jsx — Nieuwe handleEdgesChangeWrapped wrapper rond onEdgesChange van React Flow: vangt type === "remove" changes (Delete-toets) en verwijdert scope-edges óók uit structuralEdges. 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 ook removeStructuralEdge aan 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 — Handler verplaatsDomein: detecteert multi-select (_multiSelected.size > 1), toont prompt met beschikbare domeinen + huidig domein als default, gevolgd door bevestigingsdialoog. Past updateElement(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) in onDrop — browsers onderdrukken window.confirm tijdens drag-events. (2) Scroll-back fix (iteratief): Eerst prevScrollSelRef getest, maar root cause bleek treeData in effect-deps. Definitieve fix: treeData volledig uit useEffect([selectedElementId, selectieVersie]) verwijderd. Boom rendert nu zonder extra scroll-triggers. (3) e.dataTransfer.effectAllowed = "copyMove" — was "copy", blokkeerde dropEffect = "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 nu namedDiagPos map uit alle named diagrams bij import. Gebruikt als fallback voor Overzicht-diagram wanneer ent.positie / ge.positie / rel.positie ontbreken. 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: Zelfde namedDiagPos fallback toegevoegd voor directe EditorV2-import (alle 8 posities: enum, datatype, refInstantie, entiteit, GE, relatie, anker voor doelEnt en anker-node). Notities krijgen nu ook naam-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> met onBlur callback (EditField ondersteunt geen onBlur prop). Naam beklijft nu correct.

  • ide/DiagramCanvas.jsx: handleEdgeDoubleClick nu 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: notitie en constraint toegevoegd 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 een naam-veld. Notities kunnen nu een aangepaste naam hebben (gescheiden van de tekst). Naam wordt opgeslagen in element.naam; als niet ingesteld, valt terug op ID.

  • ide/ProjectBrowser.jsx: Notities en constraints verschijnen nu in de domeinboom. Notities tonen hun naam (als ingesteld) of anders een preview van de tekst (eerste 40 tekens). Constraints tonen hun naam.

  • store/adapters.js: 5 technische fixes:

    1. Diagram-nodes export: elementId: n.elementId || n.id (Zustand slaat op als { elementId, position }, niet { id }).
    2. Diagram-nodes import: { elementId: n.elementId, position } format; nodes zonder elementId worden overgeslagen.
    3. Notitie import: naam: n.naam || n.id (voordien werd naam altijd op ID gesteld).
    4. Notitie scopeRefs import: Lus over scopeRefs array → stuctural edges met data: { kind: "scope" }.
    5. Notitie export: Teksteen en naam apart (voorheen fallback naar naam). ScopeRefs geëxporteerd als array van doelId's.
  • pages/IdePage.jsx: referentielijstInstanties nu ook gefilterd bij domeinexport (voordien werden AdellijkeTitels/Landenlijst meegenomen).

  • umleditor/components/MetamodelEditor.jsx: onConnect krijgt 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 positie uit 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; tekst is inhoud, naam is 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 _Data struct. Bevat: rel_id: Int, inhoudsvelden uit DataTypenaam, secundaire FK (bij relaties, SecondaireEntiteitIDKolom), en aanvang/einde sub-inputs (PlumbingDatumInput) voor materiële types.
      • Stap 2: ENT PatchInputObjects (<Typenaam>PatchInput) via OnderliggendeGegevenselementen. Elk hub-type wordt als [GEInput]-lijst opgenomen; aanvang/einde plumbing-subtypes worden overgeslagen.
    • PlumbingDatumInput — gedeeld {datum: Date} input type voor materieel aanvang/einde.
    • getPatchInputType(typenaam) — geeft het gebouwde PatchInput type terug, valt terug op JSONScalar als niet beschikbaar.
    • inputTypeCache / patchInputTypeCache — voorkomen dubbele aanmaak.
    • Helpers: buildInputSkipSet, addStructInputFields, goTypeToGraphQLInput (parallellen aan de output type builder, maar produceren graphql.Input).
  • dynql/typed_mutations.go (bijgewerkt):

    • AddTypedMutationsForEntiteit roept nu getPatchInputType(meta.Typenaam) aan voor het patch-argument type. Resolvers zijn onveranderd — graphql-go deserialiseert InputObject naar map[string]interface{}, en json.Marshal produceert dezelfde JSON.
  • dynql/schema_builder.go (bijgewerkt):

    • BuildPatchInputTypes() wordt aangeroepen vlak vóór de mutations loop, zodat de patchInputTypeCache gevuld is wanneer AddTypedMutationsForEntiteit loopt.

Tests

  • dynql/input_type_builder_test.go (nieuw, 8 testcases):
    • TestBuildPatchInputTypes_VultCacheVoorAlleEntiteiten — alle ENTs krijgen een PatchInput type.
    • TestBuildPatchInputTypes_NatuurlijkPersoonHeeftGERollen — NatuurlijkPersoonPatchInput bevat namen, persoonsidentificaties, burgerschappen, bereikbaarheden; aanvang/einde plumbing ontbreken correct.
    • TestBuildPatchInputTypes_GEInputHeeftRelID — rel_id aanwezig.
    • TestBuildPatchInputTypes_GEInputHeeftDataVelden — inhoudsvelden uit _Data (voorletters, achternaam) aanwezig; PK-velden (natuurlijkpersoon_id, versie) afwezig.
    • TestBuildPatchInputTypes_MaterieleGEHeeftAanvangEinde — aanvang/einde aanwezig op NatuurlijkPersoon_BurgerschapInput.
    • TestBuildPatchInputTypes_WijzigMutatieGebruiktTypedInput — wijzigNatuurlijkPersoon.Args["patch"] is een *graphql.InputObject, niet meer JSONScalar.
    • TestBuildPatchInputTypes_BereikbaarheidHeeftLocatieID — locatie_id aanwezig, natuurlijkpersoon_id afwezig.
    • TestGetPatchInputType_FallbackOpJSONScalar — onbekend type valt terug op JSONScalar.
  • 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 van RegistreerMetNieuweAanpak. 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).
  • handlers/crud_handlers.go:
    • Nieuwe WijzigEntiteitCore(ctx, meta, id, rawBody, modus, audit) — pure PATCH-engine die BouwWijzigingen + RegistreerCore orkestreert. Retourneert *RegistreerResult, meldingen[] en *RegistreerError.
    • MakePatchFullEntityByMetaHandler is nu een dunne Gin-adapter rond de core.
    • VoerEntiteitAfCore (al toegevoegd in vorige stap) wordt nu hergebruikt door GraphQL.
  • dynql/mutation_resolvers.go (vervangen):
    • http.Post naar localhost:8082/registratie/... is weg. Geen registreerBaseURL of findEntiteitMetaVoorVeldnaam meer.
    • registreer, corrigeer, maak_ongedaan roepen RegistreerJSONCore direct aan met de juiste defaultRegistratietype.
    • SetRegistreerBaseURL blijft 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 registratie
      • corrigeer<Typenaam>(id, patch: JSON!) — PATCH-modus correctie
      • voer<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: roept AddTypedMutationsForEntiteit voor elke meta in de registry aan; registeredEntiteitMetas is verwijderd.

Tests

  • dynql/typed_mutations_test.go (nieuw, 3 testcases):
    • TestAddTypedMutationsForEntiteit_RegistreertWijzigCorrigeerVoerAf — assert wijzigA, corrigeerA, voerAAf aanwezig + arg-namen id/patch.
    • TestAddTypedMutationsForEntiteit_GeenOpVoorNietEntiteit — GE/REL geeft 0 velden.
    • TestAddTypedMutationsForEntiteit_AlleEntiteitenKrijgenDrieMutations — sweep over hele MetaRegistry.

Vervolg (apart traject)

  • Volle typed <Type>OpvoerInput met 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 → één Afvoer-wijziging via RegistreerCore. PFK-types (composite key) afgewezen met 400 — gebruik daar POST /registratie/.
    • MakePatchFullEntityByMetaHandler(meta) — PATCH /full/{padnaam}/:id met JSON Merge Patch (RFC 7396). Hybride wrapper (variant A/B), ?modus=registratie|correctie, meldingen[] in response.
  • handlers/wijziging_builder.go (nieuw, ~290 regels): pure BouwWijzigingen(in) vertaalt PATCH-body naar []WijzigingRequest. Geen DB-toegang.
    • Parent-context disambiguatie: bouwt RepresentatiePlusNaam direct vanuit og.Doeltype i.p.v. via globale GetByVeldnaamMetPayload. Lost veldnaam-collisions op (bv. "naam" = NatuurlijkPersoon_Naam én ApiStandaard_Naam → in PATCH-context altijd correct het type van de parent).
  • routes/addroutes_helper.go: DELETE-route in addMetaRegistryRoutes, PATCH-route in addMetaRegistryFullRoutes.
  • 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 naar RegistreerCore.
  • 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 exact NatuurlijkPersoon_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 op GetByVeldnaamMetPayload voor 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 van rawUMLNaarEditor-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.
  • 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.jsx handleImportResult: extra case "raw-editor" → rawEditorNaarStore.
  • src/ide/DetailsPanel.jsx: voor entiteit met losse velden tonen we de VeldenEditor met 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 via rawEditorNaarStore.
  • Totaal: 110/110 groen (was 91/91); npm run build succesvol.

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 valideerVoorV3 aanroept 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, synct domein met 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 kardinaliteit 1 of 0..1 o.b.v. verplicht.
  • B7 — Promoot relatie tot associatieklasse (relatieNaarAssociatieklasse): vervangt directe edge A→B door A→Rel_A_B→B. Velden=[] initieel — ASOC-vorm activeert pas bij eerste veld via relatieVorm().

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 zodat node --test de imports vindt.
  • package.json script: 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/*.mmd met README.

Side effects

  • src/umleditor/import/rawuml.js en src/umleditor/import/_helpers.js: ontbrekende .js extensies 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

  1. React 18 committeert DOM in meerdere microtask-fases
  2. XyFlow 12 plaatst een ResizeObserver in useLayoutEffect op het canvas-element
  3. In Chrome vuurt ResizeObserver synchroon zodra observe() wordt aangeroepen (als element al dimensies heeft)
  4. 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
  5. Resultaat: DOM-tree-mismatch, removeChild op 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 requestAnimationFrame fired
  • ResizeObserver vuurt in een schone phase, niet tijdens commit
  • All state (nodes, edges) is al geïnitialiseerd; de ~16ms delay is onmerkbaar

Bestanden:

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.js is uitgebreid van een spec-only bestand naar een volwaardige module: JSDoc-typedefs voor RuwUMLModel / RuwUMLNode / RuwUMLEdge / RuwUMLVeld, plus een nieuwe ruwUMLNaarEditor()-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.md met het waarom, het formaat, de pijplijn en de motivatie waarom XMI buiten RuwUML blijft.

Refactor: pure parsers

  • importMermaid.js is van 309 → ~175 regels gegaan: alleen tokenisatie en block-parsing. mermaidNaarRuw() is nu apart geëxporteerd. importVanMermaid is een 1-liner: ruwUMLNaarEditor(mermaidNaarRuw(text)).
  • importPlantUML.js op dezelfde manier herschreven (van 335 → ~175 regels, plantumlNaarRuw() apart geëxporteerd).
  • importXMI.js blijft 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 in docs/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.js documenteert 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 vlag isPlaceholder: true.

Nieuw: OrphanDialog

  • web/vite/src/umleditor/components/OrphanDialog.jsx toont per orphan naam + reden + drie radio-keuzes en een bulk-actie-dropdown ("alles op …"). Bevestigen levert een keuzes-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.jsx heeft een nieuwe importMetOrphanCheck(importerFn, accept, bron). De drie handlers (handleImportXMI, handleImportMermaid, handleImportPlantUML) zijn een 1-liner geworden die deze wrapper aanroepen. Bij orphans verschijnt de OrphanDialog; bij abort wordt er niets in het canvas geladen.

IDE-importdialoog: textuele UML-bronnen + auto-detect

  • web/vite/src/ide/ImportDialog.jsx accepteert nu naast V3/IDE-v1 JSON ook .mmd, .md, .puml, .plantuml, .xmi, .xml en .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 OrphanDialog als in de editor. Daarna wordt de graaf via editorNaarV3Model omgezet naar V3 en als V3-bestand aan de bestaande IDE-importflow doorgegeven (de onImport-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 promoteEntiteitAssociaties zette 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. promoteEntiteitAssociaties blijft als ongebruikt hulpmiddel in _helpers.js staan voor toekomstig gebruik.

Bug: PlantUML-import verloor generalisatie

  • Oorzaak: maakEdge in importPlantUML.js had 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 mapStereotypesNaarMeta in _helpers.js met aliasmap voor: ent/entiteit/objecttype, ge/gegevenselement/gegevensgroeptype, rel/relatie/relatiesoort/relatieklasse/associationclass, reflijst/referentielijst, refitem/referentielijstitem, refitems/referentielijstitems, refinstantie/referentielijstinstantie, plus modifiers materieel, datatype/gestructureerd datatype, enum/enumeration.
  • Mermaid en PlantUML gebruiken voortaan deze resolver; subtypes (entiteitSubtype, relatieSubtype) worden meegenomen.
  • XMI-import herkent nu ook taggedValue bitemp::metatype en behandelt die via dezelfde alias-resolver. MIM-stereotypen blijven werken via de bestaande mapStereotypeNaarMetatype-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: handleLoad herkende payload.flowState al 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.jsx triggerde 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 gooide Failed to execute 'removeChild' on 'Node'.
  • Fix: /web/vite/src/umleditor/ toegevoegd aan de heeftDomIntensieveWijziging-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): EditorV2Page rendert eerst de editor met demo-data en doet daarna in een useEffect een fetch naar /api/schema/versies. Bij respons werd setData(...) én setEditorKey(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 op Failed 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. editorKey is 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 in importMermaid.js → [\ \-\.\*<>o|]+. Generalisatie-edges worden nu correct herkend en als isGeneralization: true edge 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 onSelectionContextMenu in plaats van onNodeContextMenu. Hierdoor was het domein-wijzigen-menu niet bereikbaar via rechtsklik op een multi-selectie.
  • Fix: toonContextMenu detecteert nu of de selectie model-nodes bevat (heeftDomeinWijziging-vlag). ContextMenu toont 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: UnmarshalJSON in model/REST request models.go gebruikte MetaRegistry.GetByVeldnaam(veldnaam) voor het opzoeken van een representatietype op JSON-veldnaam. Omdat meerdere types dezelfde Veldnaam kunnen hebben (bijv. ApiStandaard_Naam en NatuurlijkPersoon_Naam → beide "naam"), werd de eerste match (niet-deterministisch) geretourneerd, wat leidde tot fouten als NatuurlijkPersoon_Naam_Input werd gebruikt terwijl ApiStandaard_Naam werd verwacht.
  • Fix: UnmarshalJSON extraheert nu de JSON-sleutels uit de inner payload (bijv. apistandaard_id, naam) en roept de reeds bestaande MetaRegistry.GetByVeldnaamMetPayload(veldnaam, payloadKeys) aan. Die disambigueert op EntiteitIDKolom (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.go gebruikt nu een index (wijzigingIdx).
  • Alle foutmeldingen bevatten nu wijziging[N], de representatienaam én de veldnaam, 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.
  • maxHeight van 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" in enumTypeCache, 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): in fieldsVoorMeta() wordt nu de werkelijke Go-typenaam (bijv. "Gemeenterol") als enum-naam doorgegeven aan goTypeToGraphQL(), 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.md voor de volledige analyse.

Debug logging verwijderd

  • Tijdelijke [DEBUG laadHubKinderen], [DEBUG entityToMap] en [DEBUG flattenEntityMap] prints in dynql/query_resolvers.go zijn 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 zowel PublicatieDetail.jsx als MarkdownWeergave.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 veld rol vóór verdere navigatie.
  • Geïmplementeerd in parseSegment() en resolveVeldpadUitContext(), verplaatst naar publicatieUtils.js.

Frontend: data-segment skip (REST ↔ GraphQL transparantie)

  • Templates die producten.data.type gebruiken, werken nu ook op GraphQL-responses waarbij data al afgevlakt is: het data-segment wordt geskipt als de key ontbreekt.

Frontend: GraphQL query builder in PublicatieDetail

  • Als een WeergaveDefinitie een detailTemplate heeft, haalt PublicatieDetail data 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 na flattenEntityMap() op alle vier call-sites (full entity, full list, forward relation, reverse relation).
  • Per kind-entiteit met een SecondaireEntiteitIDKolom en een IsWeergaveVeld-AfgeleidVeld worden de FK-waarden gebatcht opgehaald, de weergavenaam berekend via berekenWeergavenaamVlak() + 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 voor evalueerCELConcatenatie, navigeerAfgeleidPad, berekenWeergavenaamVanEntiteit — geen DB nodig, volledig in-memory.
  • JS (web/vite/src/publicatie/publicatieUtils.test.js): 27 unit tests voor parseSegment, segmentNaarString, resolveVeldpadUitContext, extractVeldpaden, buildSelectieTree, buildGraphQLQuery — gedraaid met node --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 zowel web/vite/src/publicatie/PublicatieDetail.jsx als web/vite/src/components/editor/MarkdownWeergave.jsx.
  • Styling: tabelopmaak toegevoegd in web/vite/src/styles/common-ground-theme.css voor zowel .cg-markdown-viewer__body table als .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 PublicatieDetail werden eerst ge-escaped in renderTemplate() en daarna nogmaals via markdownNaarHtml(), waardoor tekst als API&#39;s &amp; opslag zichtbaar werd.
  • Oplossing: placeholder-invoeging in renderTemplate() gebruikt nu ruwe tekst; escaping blijft centraal in markdownNaarHtml().
  • 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:

  1. TanStack Table kan kolom-IDs met punten (.) intern inconsistent afhandelen.
  2. Kolommen gebaseerd op accessorFn + een verouderde typeMetaByTypenaam-closure konden null teruggeven in de filter-fase, ondanks correct tonen in de cell-renderer.

Oplossing (dubbele aanpak):

  • sanitizeKolId(): vervangt punten in veldpaden door __ voor veilige TanStack-sleutels.
  • resolvedData memo: 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 uit resolvedData[sanitizeKolId(veldpad)] leest.
  • standaardSortering ID 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 dependencies voor alle inkomende «use»-lijnen.
  • De metadata voor deze lijnen (id, sourceHandle, targetHandle, hidden) blijft nu behouden in V3 JSON via useEdges[].
  • Daarnaast blijft deze info nu ook behouden bij editor → V3 → codegen → MetaRegistry → V3 → editor roundtrips, doordat de codegenerator useEdges[] opslaat in EditorLayout.UseEdges in de gegenereerde *_metaregistry.go bestanden 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 geneste has-many relaties met callback-filters.
  • Symptoom: reflect: call of reflect.Value.Field on zero Value tijdens relation.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 TABLE signature toe via CREATE OR REPLACE FUNCTION (SQLSTATE 42P13).
  • 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. Zie ONTWERP_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 oudere viz/schema-API nodig te hebben.
  • Nieuw type V3Runtime in model/v3_format.go met velden: veldnaam, padnaam, tabelnaam, idKolom, heeftPFK, entiteitIDKolom, klassenaam, relatieveAutoincrement.
  • V3Runtime wordt als "runtime" (omitempty) opgenomen in V3Entiteit, V3Gegevenselement en V3Relatie.
  • V3Veld uitgebreid met OAS 3.1 type, format en verplicht velden, zodat frontends weten welk invoerveld ze moeten renderen.
  • V3 exporter (model/v3_exporter.go) aangevuld met runtimeVanMeta() en oasTypeVoorGoType() helpers; alle drie de builder-functies vullen nu Runtime en de veld-loop vult Type/Format/Verplicht.
  • Volledig backward-compatible: alle nieuwe JSON-velden gebruiken omitempty, codegen en UML-editor negeren ze.
  • Nieuwe tests in model/v3_exporter_test.go voor runtime op entiteiten, relaties, en OAS type/format op velden.
  • Zie docs/v3_1_runtime.md voor de volledige technische documentatie.

Runtime fix notes (2026-03-26)

  • Editor v2 laadt bij opstart standaard de nieuwste DB-versie via GET /api/schema/versies en daarna model_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/versies CORS-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.AfgeleideVelden
    • V3Veld.Afgeleid
    • V3Veld.AfleidingsregelTaal
    • V3Veld.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.