/memories/session/plan.md is intern geheugen van Copilot — niet zichtbaar in je project. Ik plaats het plan als bestand in je project.
Nu schrijf ik dit naar een bestand in je project:
Ik heb geen tool beschikbaar om bestanden aan te maken in je workspace. Hier is de volledige inhoud — kopieer het naar bitemp_register_v06/docs/implementatieplan-referentielijsten.md (of een andere locatie naar keuze):
# Implementatieplan: Referentielijsten Refactoring — Klasse vs Instantie
> **Status**: plan, v1
> **Datum**: 2026-03-29
> **Scope**: Go backend + V3 JSON format + UML Editor
> **Doel**: Landenlijst (concrete struct) refactoren naar generieke Referentielijst-klasse; RegisterReferentielijst verwijderen; GE's voor naam/omschrijving toevoegen; referentielijst-instanties correct modelleren in V3 JSON, MetaRegistry, DB en Editor.
---
## TL;DR
De huidige implementatie behandelt elke referentielijst (Landenlijst) als aparte Go-struct/klasse. Dit is conceptueel fout: er hoort één generieke **Referentielijst**-klasse te zijn, waarvan Landenlijst, EU_Lidstaten, etc. **instanties** (records) zijn. De `RegisterReferentielijst`-systeemtabel gaat op in de Referentielijst-entiteit zelf. Naam en beschrijving worden GE's. De V3 JSON krijgt een `referentielijstInstanties`-sectie. De editor krijgt instantie-nodes.
---
## Huidige staat (wat er is)
### Go model
- **`RegisterReferentielijst`** struct in `ref_modellen_entiteiten.go` → systeemtabel met `id, typenaam, naam, beschrijving, is_materieel`
- **`Landenlijst`** struct → entiteit met `id, opvoer, afvoer` + relatie naar `Landenlijst_Land`, + `Landenlijst_Aanvang/Einde`
- **`Land`** struct → referentielijst_item entiteit
- **`Landenlijst_Land`** struct → referentielijst_items relatie (hub + _Data)
- **`Landcode`**, **`Landnaam`** → GE's van Land (hub + _Data)
- Alle ref_* bestanden: `ref_modellen_entiteiten.go`, `ref_modellen_ge_rel.go`, `ref_modellen_input.go`, `ref_modellen_methods.go`
### MetaRegistry (np_loc_metaregistry.go)
- 12 entries: Landenlijst, Land, Landenlijst_Land, Landcode, Landnaam, + hun _Data, _Aanvang, _Einde entries
- `Landenlijst` heeft `EntiteitSubtype: "referentielijst"`
- `Land` heeft `EntiteitSubtype: "referentielijst_item"`
- `Landenlijst_Land` heeft `RelatieSubtype: "referentielijst_items"`
### V3 JSON format (v3_format.go)
- `V3Entiteit` en `V3Relatie` missen `entiteitSubtype`/`relatieSubtype` velden
- *Geen* concept van referentielijst-instanties in V3 JSON struct
- `metamodel_v3.json` bevat geen referentielijst-gerelateerde types
### DB setup (createtables.go)
- `syncReferentielijstRegister()` loopt over MetaRegistry, filtert op `EntiteitSubtype == "referentielijst"`, en UPSERTt naar `register_referentielijst` tabel
### Editor
- Editor KAN subtypes lezen/schrijven (`entiteitSubtype`, `relatieSubtype`)
- `maakReferentielijstSet()` maakt 3-node template aan (reflijst + item + items-relatie)
- Geen concept van instantie-nodes
### Routes
- Referentielijst-entiteiten worden gescheiden geroute onder `/referentielijsten/...`
- Items en relaties krijgen gewone routes
---
## Doelarchitectuur (wat het moet worden)
### Conceptueel model
Referentielijst (generieke entiteit-KLASSE, één Go struct) ├── Referentielijstnaam (GE, hub+data) ├── Referentielijstomschrijving (GE, hub+data) ├── Referentielijst_Aanvang (materieel, indien IsMaterieel) ├── Referentielijst_Einde (materieel, indien IsMaterieel) │ └── Per-instantie relaties (elk een eigen Go struct): ├── LandenlijstLand (relatie → Land, gebonden aan instantie "Landenlijst") ├── EULidstatenLand (relatie → Land, gebonden aan instantie "EULidstaten") └── ...
Instanties (records in register_referentielijst tabel): ├── Landenlijst (id=1, systeemnaam="Landenlijst") ├── EULidstaten (id=2, systeemnaam="EULidstaten") └── ...
### DB tabel `register_referentielijst`
| Kolom | Type | Betekenis |
|-------|------|-----------|
| id | int PK autoincrement | Instantie-ID |
| systeemnaam | text UNIQUE | Stabiele identifier voor sync/routing |
| opvoer | timestamptz | Formele tijd |
| afvoer | timestamptz | Formele tijd |
Naam en beschrijving leven in GE-tabellen (referentielijstnaam, referentielijstnaam_data, referentielijstomschrijving, referentielijstomschrijving_data).
### V3 JSON formaat (uitbreiding)
```json
{
"versie": "v3",
"referentielijstInstanties": [
{
"systeemnaam": "Landenlijst",
"naam": "Landen",
"omschrijving": "Een lijst van alle landen",
"positie": { "x": 100, "y": 200 }
}
],
"entiteiten": [
{
"typenaam": "Referentielijst",
"entiteitSubtype": "referentielijst",
"isMaterieel": true,
"gegevenselementen": [
{ "naam": "Referentielijstnaam", "velden": [{"naam": "Naam", "type": "string"}] },
{ "naam": "Referentielijstomschrijving", "velden": [{"naam": "Omschrijving", "type": "string"}] }
],
"relaties": [
{
"naam": "LandenlijstLand",
"relatieSubtype": "referentielijst_items",
"doelEntiteit": "Land",
"referentielijstInstantie": "Landenlijst"
}
]
},
{
"typenaam": "Land",
"entiteitSubtype": "referentielijst_item",
"gegevenselementen": [
{ "naam": "Landcode", "velden": [{"naam": "Code", "type": "string"}] },
{ "naam": "Landnaam", "velden": [{"naam": "Naam", "type": "string"}] }
]
}
]
}
Naamconventies
| Oud | Nieuw | Reden |
|---|---|---|
Landenlijst (struct) |
Referentielijst (struct) |
Wordt generieke klasse |
RegisterReferentielijst (struct) |
VERWIJDERD | Opgegaan in Referentielijst |
Landenlijst_Land |
LandenlijstLand |
Naamconventie: geen underscores in gewone klassen |
Landenlijst_Land_Data |
LandenlijstLand_Data |
_Data is systeemsuffix |
Landenlijst_Aanvang |
Referentielijst_Aanvang |
Generiek geworden |
Landenlijst_Einde |
Referentielijst_Einde |
Generiek geworden |
ref_modellen_*.go |
inhoud verplaatst naar np_loc_modellen_*.go |
Referentielijsten zijn first-class citizens van het model |
MetaRegistry nieuwe velden in TypeMeta
ReferentielijstInstantie string // alleen voor referentielijst_items relaties: systeemnaam van de gebonden instantie (bijv. "Landenlijst")
Implementatiestappen
Fase A: V3 JSON format & Go structs (geen dependencies)
A1. V3 format Go structs uitbreiden — model/v3_format.go
- Voeg
EntiteitSubtype stringtoe aanV3Entiteitmet json tag"entiteitSubtype,omitempty" - Voeg
RelatieSubtype stringtoe aanV3Relatiemet json tag"relatieSubtype,omitempty" - Voeg
ReferentielijstInstantie stringtoe aanV3Relatiemet json tag"referentielijstInstantie,omitempty" - Voeg
V3ReferentielijstInstantiestruct toe:Systeemnaam string Naam string Omschrijving string Positie *V3Positie - Voeg
ReferentielijstInstanties []V3ReferentielijstInstantietoe aanV3Model
A2. MetaRegistry plumbing uitbreiden — model/metaregistry_plumbing.go
- Voeg
ReferentielijstInstantie stringveld toe aanTypeMetastruct - Documenteer: "systeemnaam van de gebonden referentielijst-instantie; alleen voor RelatieSubtype == referentielijst_items"
Fase B: Go model refactoring (structs) — depends on A
B1. Nieuwe generieke structs aanmaken
Werk in np_loc_modellen_entiteiten.go:
- Voeg
Referentielijststruct toe:- bun table:
register_referentielijst - Velden:
ID int (pk),Systeemnaam string (unique),Opvoer *time.Time,Afvoer *time.Time - Relaties:
Referentielijstnamen []Referentielijstnaam,Referentielijstomschrijvingen []Referentielijstomschrijving,Aanvang []Referentielijst_Aanvang,Einde []Referentielijst_Einde - Items-relaties als gewone bun has-many relaties:
LandenlijstLanden []LandenlijstLand, etc. (per model specifiek) - N.B.: de struct groeit per model met elke nieuwe items-relatie — consistent met hoe NP velden heeft per GE
- bun table:
- Voeg
Referentielijst_Aanvangstruct toe (wasLandenlijst_Aanvang, nu generiek):- bun table:
referentielijst_aanvang - Velden:
Referentielijst_ID int (pk),Versie int64 (pk, autoincrement),Datum *Date,Opvoer,Afvoer
- bun table:
- Voeg
Referentielijst_Eindestruct toe (analog)
B2. Nieuwe GE structs aanmaken
Werk in np_loc_modellen_ge_rel.go:
Referentielijstnaam(hub):Referentielijst_ID, Rel_ID, ParentReferentielijst, Opvoer, Afvoer, Data []Referentielijstnaam_DataReferentielijstnaam_Data:Referentielijst_ID, Rel_ID, Versie, Naam string, Opvoer, AfvoerReferentielijstomschrijving(hub): analoogReferentielijstomschrijving_Data: analoog, veldOmschrijving string
B3. Items-relatie hernoemen
In np_loc_modellen_ge_rel.go:
- Hernoem
Landenlijst_Land→LandenlijstLand- Wijzig FK:
Landenlijst_ID→Referentielijst_ID, bun columnreferentielijst_id - Wijzig bun relation:
ParentLandenlijst *Landenlijst→ParentReferentielijst *Referentielijst
- Wijzig FK:
- Hernoem
Landenlijst_Land_Data→LandenlijstLand_Data- Wijzig FK:
Landenlijst_ID→Referentielijst_ID, bun columnreferentielijst_id
- Wijzig FK:
- Hernoem
Landenlijst_Land_Input→LandenlijstLand_Input- Wijzig
Landenlijst_ID→Referentielijst_ID
- Wijzig
B4. Bestaande Land-structs behouden
Land,Landcode,Landnaam,Landcode_Data,Landnaam_Data,Land_Aanvang,Land_Einde→ verplaats vanref_modellen_*.gonaarnp_loc_modellen_*.go(entiteiten resp. ge_rel bestanden)- Geen inhoudelijke wijzigingen
B5. Interface-methoden (methods)
In np_loc_modellen_methods.go:
- Voeg methods toe voor:
Referentielijst,Referentielijst_Aanvang,Referentielijst_Einde,Referentielijstnaam,Referentielijstnaam_Data,Referentielijstomschrijving,Referentielijstomschrijving_Data - Hernoem bestaande methods voor:
LandenlijstLand(wasLandenlijst_Land),LandenlijstLand_Data - Verplaats bestaande methods voor Land, Landcode, Landnaam, etc. van
ref_modellen_methods.gonaarnp_loc_modellen_methods.go GeefOnderliggendeGegevenselementen()op Referentielijst implementeren:- Retourneert Referentielijstnaam, Referentielijstomschrijving, Aanvang, Einde plus alle items-relaties (LandenlijstLand, etc.)
- Items-relaties zijn gewone onderliggende relaties van Referentielijst met de constraint dat de primaire FK (referentielijst_id) altijd hetzelfde instantie-ID heeft
- Ze zijn zelfstandige MetaRegistry-entries met eigen routes, maar staan WEL in OnderliggendeGegevenselementen
- Dit werkt correct omdat de full-entity handler filtert op de FK van het specifieke record (bijv. referentielijst_id=3 voor Landenlijst)
- Cosmetisch: de full-response bevat lege arrays voor items-relaties van andere instanties — consistent met hoe ongebruikte GE's altijd lege arrays zijn
B6. Input structs
In np_loc_modellen_input.go:
- Verplaats
Landcode_Input,Landnaam_Inputvanref_modellen_input.go - Hernoem
Landenlijst_Land_Input→LandenlijstLand_Input, wijzig FK veld
B7. Opruimen ref_modellen_ bestanden*
- Verwijder: ref_modellen_entiteiten.go, ref_modellen_ge_rel.go,
ref_modellen_methods.go,ref_modellen_input.go - Alle inhoud is nu in np_loc_* bestanden
Fase C: MetaRegistry refactoring — depends on B
C1. Referentielijst-entry vervangen — np_loc_metaregistry.go
- Verwijder
MetaRegistry["Landenlijst"]entry - Voeg
MetaRegistry["Referentielijst"]toe:- Typenaam: "Referentielijst"
- EntiteitSubtype: EntiteitSubtypeReferentielijst
- Tabelnaam: "register_referentielijst"
- IsMaterieel: true (of false, ontwerpkeuze)
- OnderliggendeGegevenselementen: Referentielijstnaam, Referentielijstomschrijving, Aanvang, Einde, plus alle items-relaties (LandenlijstLand, etc.)
- Factory/DBFactory wijzen naar &Referentielijst{}
- Items-relaties staan WEL in OnderliggendeGegevenselementen van Referentielijst. Ze zijn tegelijkertijd zelfstandige MetaRegistry entries met eigen routes. Dit is consistent met hoe bijv. Bereikbaarheid onder NatuurlijkPersoon staat maar ook een eigen entry heeft.
C2. GE-entries toevoegen
MetaRegistry["Referentielijstnaam"]— hub GE entryMetaRegistry["Referentielijstnaam_Data"]— data GE entryMetaRegistry["Referentielijstomschrijving"]— hub GE entryMetaRegistry["Referentielijstomschrijving_Data"]— data GE entry- Alle met BovenliggendTypenaam / EntiteitIDKolom: "referentielijst_id"
C3. Aanvang/Einde entries hernoemen
MetaRegistry["Landenlijst_Aanvang"]→MetaRegistry["Referentielijst_Aanvang"]MetaRegistry["Landenlijst_Einde"]→MetaRegistry["Referentielijst_Einde"]- EntiteitIDKolom: "referentielijst_id"
- BovenliggendTypenaam: "Referentielijst"
C4. Items-relatie entry hernoemen + nieuw veld
MetaRegistry["Landenlijst_Land"]→MetaRegistry["LandenlijstLand"]- Wijzig EntiteitIDKolom: "referentielijst_id"
- Voeg toe:
ReferentielijstInstantie: "Landenlijst"(systeemnaam van gebonden instantie) - Update Klassenaam, Tabelnaam etc.
- Idem voor
MetaRegistry["Landenlijst_Land_Data"]→MetaRegistry["LandenlijstLand_Data"]
C5. Land-entries behouden, evt. kleiner
MetaRegistry["Land"],MetaRegistry["Landcode"], etc. — inhoudelijk ongewijzigd, alleen verplaatst
Fase D: Database setup — depends on C
D1. Table creation aanpassen — dbsetup/createtables.go
- Verwijder aparte
RegisterReferentielijsttabel-creatie (die komt nu via MetaRegistry-drivencreateModelTables) - Update
syncReferentielijstRegister():- Haal instanties uit V3 JSON (of een
ReferentielijstInstantiesconfiguratie) - Voor elke instantie: INSERT register_referentielijst (id, systeemnaam, opvoer=now) ON CONFLICT (systeemnaam) DO NOTHING
- Na insert: INSERT initiële waarden in Referentielijstnaam / Referentielijstomschrijving hub+data tabellen (als bootstrap)
- Haal instanties uit V3 JSON (of een
- De
register_referentielijsttabel wordt nu aangemaakt viacreateModelTables(vanuit MetaRegistry), niet meer apart
D2. DDL-generatie check — dbsetup/createmodeltables.go
- Controleer dat
register_referentielijsttabel correct wordt gegenereerd door bestaande DDL-logica:idPK (autoincrement? nee: handmatig beheerd via sync)- Hmm, of WEL autoincrement, en systeemnaam als aparte unique kolom
systeemnaamUNIQUE constraint
- Het table-creation-pad voor Referentielijst moet ook de GE-tabellen (referentielijstnaam, referentielijstnaam_data, etc.) aanmaken
- Triggers voor relatieve autoincrement op de GE hub/data tabellen
D3. Instantie-sync herschrijven
- Bron van instantie-definities: ofwel V3 model JSON (bij import), ofwel een configuratiebron
- Bij opstart: lees bekende instanties en synchroniseer naar
register_referentielijst - Dit vervangt de oude
syncReferentielijstRegister()die MetaRegistry-entries van subtype "referentielijst" synchte
Fase E: V3 exporter/importer — depends on A, C
E1. V3 exporter aanpassen — model/v3_exporter.go
- Bij export van entiteiten: schrijf
entiteitSubtypeveld (als niet-leeg) - Bij export van relaties: schrijf
relatieSubtypeenreferentielijstInstantievelden (als niet-leeg) - Voeg export van
referentielijstInstantiessectie toe: loop over bekende instanties (uit DB of configuratie)
E2. V3 importer (schema API) — check of parsing al subtypes leest
- De Go JSON-unmarshalling van V3Entiteit/V3Relatie leest nu automatisch de nieuwe velden (na A1)
- Check
cmd/codegen/parsers: moeten ook de nieuwe velden lezen
E3. Schema API — handlers/schema_handler.go (of equivalent)
- De schema-API die metadata retourneert aan de frontend moet subtypes en instantie-info meesturen
- Check of dit automatisch werkt via MetaRegistry reflection
Fase F: Routes — depends on C
F1. addroutes_helper.go aanpassen
addReferentielijstRoutes(): werkt nu op basis van "Referentielijst" entry (één entry i.p.v. per type)- Items-relaties (LandenlijstLand) worden nog steeds als aparte routes geregistreerd (via addMetaRegistryRoutes)
- Check: skip-logica in
addMetaRegistryRoutes()die referentielijst-subtypes overslaat — is Referentielijst de enige die geskipt wordt? - Referentielijst_item types (Land) → krijgen gewone routes OF gescheiden routes, afhankelijk van ontwerkkeuze
F2. Endpoint /referentielijsten
GET /referentielijsten→ retourneert lijst van alle instanties (query register_referentielijst tabel)GET /referentielijsten/:systeemnaam→ retourneert specifieke instantie met GE'sGET /full/referentielijsten/:systeemnaam→ retourneert instantie + geneste GE's- Het
:systeemnaamveld vervangt de oude padnaam-gebaseerde routing
Fase G: Editor wijzigingen — parallel met E, F
G1. V3 model types uitbreiden — uml-editor/src/metamodel/types.js
- Voeg
V3ReferentielijstInstantiedefinitie toe - Update
editorNaarV3Model()omreferentielijstInstantiessectie te exporteren - Update
referentielijstInstantieveld op relatie-export
G2. Editor → V3 import — uml-editor/src/metamodel/v3ModelNaarEditor.js
- Parseer
referentielijstInstantiesuit V3 JSON - Maak instantie-nodes aan (nieuw node-type of speciaal gerenderd entiteit-node)
- Maak edges aan van items-relaties naar hun gebonden instantie
G3. Nieuw node-type: ReferentielijstInstantie — uml-editor/src/components/nodes/
- Nieuwe React-component (of variant van EntiteitNode):
- Label:
«referentielijst»+ instantienaam (bijv. "Landenlijst") - Velden: naam, omschrijving (editeerbaar)
- Kleur: aangepast (bijv. ambervariant)
- Geen stereotype "«entiteit»" maar "«referentielijst»" of specifiek label
- Label:
- Edge: van items-relatie node naar instantie node (visueel de binding)
G4. handleAddReferentielijstSet() uitbreiden
- Naast 3-node template, ook optioneel een instantie-node aanmaken
- Of: aparte knop "Referentielijst-instantie toevoegen"
G5. NodeEditPanel uitbreiden
- Instantie-node editing: systeemnaam, naam, omschrijving
- Items-relatie node: dropdown om gebonden instantie te kiezen
Fase H: Verificatie
H1. Go compilatie
cd bitemp_register_v06 && go build Git.— moet foutloos compileren
H2. Go tests
go test Git.— alle bestaande tests moeten slagen- Specifiek:
model/metamodel_test.gocontroleert MetaRegistry-integriteit - Specifiek: check of routes_test.go de nieuwe Referentielijst-entry vindt
H3. Database
- Start API server, controleer dat
register_referentielijsttabel correct wordt aangemaakt - Controleer dat GE-tabellen (referentielijstnaam, referentielijstnaam_data, etc.) bestaan
- Controleer dat instantie-sync werkt (Landenlijst record aanwezig)
H4. API tests
GET /referentielijsten→ retourneert LandenlijstGET /referentielijsten/Landenlijst→ retourneert detail- Registreer een Land, koppel via LandenlijstLand
H5. Editor round-trip
- Export V3 JSON vanuit editor → check dat referentielijstInstanties sectie aanwezig is
- Import V3 JSON in editor → check dat instantie-nodes correct worden weergegeven
- Check dat items-relatie edge naar instantie correct wordt getekend
H6. Vite build
npm run buildinweb/vite/— moet foutloos bouwen
Relevante bestanden
Te wijzigen
model/v3_format.go— V3 struct uitbreidingen (A1)model/metaregistry_plumbing.go— TypeMeta nieuw veld (A2)model/np_loc_modellen_entiteiten.go— Referentielijst struct + Aanvang/Einde (B1)model/np_loc_modellen_ge_rel.go— Referentielijstnaam, Referentielijstomschrijving, LandenlijstLand hernoemen (B2, B3, B4)model/np_loc_modellen_methods.go— interface methods (B5)model/np_loc_modellen_input.go— input structs (B6)model/np_loc_metaregistry.go— alle MetaRegistry entries (C1-C5)model/v3_exporter.go— subtypes en instanties exporteren (E1)dbsetup/createtables.go— sync herschrijven (D1, D3)dbsetup/createmodeltables.go— DDL check (D2)routes/addroutes_helper.go— route-registratie (F1, F2)uml-editor/src/metamodel/types.js— V3 types + export (G1)uml-editor/src/metamodel/v3ModelNaarEditor.js— import (G2)uml-editor/src/metamodel/editorNaarV3Model.js— export (als apart bestand)uml-editor/src/components/MetamodelEditor.jsx— instantie handling (G4)uml-editor/src/components/panels/NodeEditPanel.jsx— instantie editing (G5)
Te verwijderen
model/ref_modellen_entiteiten.go— inhoud verplaatst (B7)model/ref_modellen_ge_rel.go— inhoud verplaatst (B7)model/ref_modellen_methods.go— inhoud verplaatst (B7)model/ref_modellen_input.go— inhoud verplaatst (B7)
Te raadplegen (referentie)
model/metaregistry.go— bestaande MetaRegistry structuur als voorbeeldmodel/modellen_entiteiten.go— A/B entiteit structs als patroonmodel/modellen_ge_rel.go— hub+data patroon als voorbeeldmodel/np_loc_modellen_entiteiten.go— NP/Locatie structs als patroonReferentielijsten.md— UML diagrammen, ontwerpkeuzen
Beslissingen
- Tabel
register_referentielijsthergebruiken: de tabel behoudt zijn naam maar wordt nu de entiteit-tabel voor Referentielijst (was aparte systeemtabel). Kolommen wijzigen:typenaam→systeemnaam,naam/beschrijving/is_materieelworden verwijderd (gaan naar GE's resp. MetaRegistry). systeemnaamals stabiele identifier: elk referentielijst-record heeft een immutable systeemnaam die gebruikt wordt voor V3 JSON sync, routing, en binding van items-relaties.- Items-relaties staan WEL in OnderliggendeGegevenselementen van Referentielijst: ze zijn gewone onderliggende relaties, met de constraint dat de primaire FK altijd hetzelfde instantie-ID heeft. Ze zijn tegelijk zelfstandige MetaRegistry-entries met eigen routes. Dit is consistent met hoe bijv. Bereikbaarheid onder NatuurlijkPersoon staat. De full-entity handler filtert op FK → lege arrays voor items-relaties van andere instanties, consistent met bestaand gedrag.
is_materieelis klasse-eigenschap: geldt voor ALLE referentielijst-instanties uniform. Staat in MetaRegistry, niet per-record.- Naamconventie doorgevoerd: geen underscores in gewone klasse-namen (LandenlijstLand i.p.v. Landenlijst_Land). Systeemsuffixen (_Data, _Aanvang, _Einde) behouden underscores.
- Scope-afbakening: codegenerator (cmd/codegen/) wordt NIET in dit plan aangepast. Dat is een vervolgstap nadat de handmatige constructie werkt.
Openstaande overwegingen
- Instantie-ID management:
systeemnaamvoor lookup,idwordt autoincrement. Bij match op systeemnaam wordt bestaand record met zijn id hergebruikt. ✅ Besloten. - Cross-model referentielijsten: nu buiten scope, maar structuur moet dit niet blokkeren (d.w.z. geen hardcoded model-afhankelijkheid in de Referentielijst-structs). Toekomstige iteratie.
- Bootstrap GE-data: directe INSERT voor bootstrap bij eerste sync. ✅ Besloten.
- Items-relatie FK constraint:
referentielijst_idin bijv.landenlijst_landis altijd het ID van de Landenlijst-instantie. Nu via applicatielogica afgedwongen; in toekomstige iteratie evt. DB CHECK constraint.
Referentielijsten — Ontwerp & Ontwerpkeuzen
Fase 0 is toegevoegd aan het plan. Samenvatting van wat er moet veranderen in Referentielijsten.md:
| Sectie | Wat achterloopt |
|---|---|
| §2 Subtypes + diagrammen | Klasse/instantie onderscheid mist; LandenlijstLand naamconventie; items-relaties als onderliggend |
| §3 Systeemtabel | Wordt entiteit-tabel; kolommen wijzigen (systeemnaam, opvoer/afvoer); sync-bron wordt V3 JSON |
| §3+ (nieuw) | GE's Referentielijstnaam + Referentielijstomschrijving |
| §6 V3 JSON | referentielijstInstanties sectie + referentielijstInstantie op relaties |
| §8 Naamconventie | Geen underscores in gewone klassen (PascalCase aaneengeschreven) |
| §9 MetaRegistry | ReferentielijstInstantie veld; items-relaties in OnderliggendeGegevenselementen |
| §11 Fasen | Verwijzing naar implementatieplan |
| (nieuw) Beslissingen | Alle 6 beslissingen + openstaande overwegingen |
Bij implementatie pak ik dit als eerste stap op. Wil je nu naar implementatie switchen?
Plak dit in `bitemp_register_v06/docs/implementatieplan-referentielijsten.md` (of een pad naar keuze). Daarna kun je het plan altijd terugvinden, ook als Copilot crasht of de sessie verloren gaat.Plak dit in `bitemp_register_v06/docs/implementatieplan-referentielijsten.md` (of een pad naar keuze). Daarna kun je het plan altijd terugvinden, ook als Copilot crasht of de sessie verloren gaat.
error met oude tabellen
Oorzaak
Bij het starten van de API server faalde de FK-constraint creatie omdat de oude database nog tabellen had van vóór de refactoring. De IfNotExists() clause in bun voorkomt dat bestaande tabellen worden herschepd, waardoor de oude kolomnamen (landenlijst_id) bleven bestaan terwijl de nieuwe code referentielijst_id verwachtte.
N.B. admin drop tables enabled: true in de logoutput schakelt alleen de HTTP DELETE endpoint in — het dropt NIET automatisch tabellen bij het opstarten.
Oplossing: DB migratie ensureReferentielijstRefactorMigrated()
Nieuwe functie in dbsetup/createmodeltables.go, aangeroepen aan het begin van createModelTables(), vóór alle tabelcreatie. De migratie is idempotent (veilig om meerdere keren uit te voeren) en voert de volgende stappen uit:
| # | Actie | Details |
|---|---|---|
| 1 | register_referentielijst: kolom hernoemen |
typenaam → systeemnaam |
| 1b | register_referentielijst: kolommen toevoegen |
opvoer TIMESTAMPTZ, afvoer TIMESTAMPTZ |
| 1c | register_referentielijst: legacy kolommen verwijderen |
DROP naam, beschrijving, is_materieel |
| 2 | Tabel hernoemen | landenlijst_aanvang → referentielijst_aanvang |
| 2b | Kolom hernoemen | referentielijst_aanvang.landenlijst_id → referentielijst_id |
| 3 | Tabel hernoemen | landenlijst_einde → referentielijst_einde |
| 3b | Kolom hernoemen | referentielijst_einde.landenlijst_id → referentielijst_id |
| 4 | Kolom hernoemen | landenlijst_land.landenlijst_id → referentielijst_id |
| 5 | Kolom hernoemen | landenlijst_land_data.landenlijst_id → referentielijst_id |
| 6 | Tabel droppen | DROP TABLE IF EXISTS landenlijst CASCADE |
Alle stappen gebruiken IF EXISTS / IF NOT EXISTS checks, zodat op een verse database niets gebeurt.
Implementatiestatus
| Fase | Onderdeel | Status |
|---|---|---|
| 0 | Documentatie (Referentielijsten.md) | ✅ Compleet |
| A1 | V3 format Go structs | ✅ Compleet |
| A2 | MetaRegistry plumbing (TypeMeta) | ✅ Compleet |
| B | Go model refactoring (structs, methods, input) | ✅ Compleet |
| C | MetaRegistry entries | ✅ Compleet |
| D | Database setup + migratie | ✅ Compleet |
| E | V3 exporter + codegen | ✅ Compleet |
| F | Routes | ✅ Compleet |
| G | UML Editor (types, import, nodes, toolbar, editing) | ✅ Compleet |
| H | Verificatie (build, tests, vite build) | ✅ Compleet |
| — | DB migratie oude tabellen | ✅ Compleet |
API Endpoints voor referentielijsten
Overzicht referentielijsten
| Methode | Endpoint | Beschrijving |
|---|---|---|
| GET | /referentielijsten |
Overzicht van alle referentielijst-instanties (uit register_referentielijst tabel) |
Referentielijst-entiteit (generiek)
| Methode | Endpoint | Beschrijving |
|---|---|---|
| GET | /referentielijsten/referentielijsten |
Lijst van alle Referentielijst-records |
| GET | /referentielijsten/referentielijsten/:id |
Detail van één Referentielijst |
| POST | /referentielijsten/referentielijsten |
Nieuw Referentielijst-record aanmaken |
| GET | /full/referentielijsten/referentielijsten |
Volledige (expanded) lijst met geneste GE's |
| GET | /full/referentielijsten/referentielijsten/:id |
Volledige detail met geneste GE's |
| POST | /full/referentielijsten/referentielijsten |
Volledig record aanmaken met geneste GE's |
GE's van Referentielijst (standaard routes)
| Methode | Endpoint | Beschrijving |
|---|---|---|
| GET | /referentielijstnamen |
Alle Referentielijstnaam hubs |
| GET | /referentielijstnamen/:id |
Specifieke Referentielijstnaam hub |
| GET | /referentielijstomschrijvingen |
Alle Referentielijstomschrijving hubs |
| GET | /referentielijstomschrijvingen/:id |
Specifieke Referentielijstomschrijving hub |
| GET | /referentielijstnaam_data |
Alle Referentielijstnaam data records |
| GET | /referentielijstomschrijving_data |
Alle Referentielijstomschrijving data records |
Materiële plumbing
| Methode | Endpoint | Beschrijving |
|---|---|---|
| GET | /referentielijst_aanvang |
Alle aanvangrecords van Referentielijst |
| GET | /referentielijst_einde |
Alle einderecords van Referentielijst |
| GET | /land_aanvang |
Alle aanvangrecords van Land |
| GET | /land_einde |
Alle einderecords van Land |
Land (referentielijst_item)
| Methode | Endpoint | Beschrijving |
|---|---|---|
| GET | /landen |
Lijst van alle landen |
| GET | /landen/:id |
Detail van één land |
| POST | /landen |
Nieuw land aanmaken |
| GET | /full/landen |
Volledige lijst met geneste GE's |
| GET | /full/landen/:id |
Volledig detail met geneste GE's |
GE's van Land
| Methode | Endpoint | Beschrijving |
|---|---|---|
| GET | /landcodes |
Alle Landcode hubs |
| GET | /landnamen |
Alle Landnaam hubs |
| GET | /landcode_data |
Alle Landcode data records |
| GET | /landnaam_data |
Alle Landnaam data records |
Items-relatie: LandenlijstLand
| Methode | Endpoint | Beschrijving |
|---|---|---|
| GET | /landenlijst_landen |
Alle LandenlijstLand koppelrecords |
| GET | /landenlijst_landen/:id |
Specifiek koppelrecord |
| POST | /landenlijst_landen |
Nieuw koppelrecord aanmaken |
| GET | /landenlijst_land_data |
Alle LandenlijstLand data records |
Registratie (formele tijd)
| Methode | Endpoint | Beschrijving |
|---|---|---|
| POST | /registreer |
Registratie van wijzigingen (opvoer/afvoer) op alle types |