Bestand: docs/ai-chats/exports/2026-04-02-verbeteren-van-inhoudspagina-en-opmaaksuggesties.md

Chat: Verbeteren van inhoudspagina en opmaaksuggesties

  • Datum: 2026-04-02 21:35
  • Sessie-ID: 349eeaab-3a97-4d2a-b46e-1ab08a6ca856
  • Berichten: 14

πŸ§‘ User

Kun je de inhoud pagina wat overzichtelijker maken?

  • Kijk maar naar commonground.nl voor de fonts, geen times-achtig font, dat is ouderwets.
  • id mag subtiel achter de titel. rel_id hoeft niet genoemd. ID: 1-1 of 1.1 (en indien versie getoond wordt: 1.1.1)
  • formele tijd is te lang: opvoer = 1 is genoeg, en dan rechts van de id -> je moet dan de tijd terugrekenen naar de symbolische tijd t=1 enz.

Als je nog andere suggesties hebt (fontgrootten oid) hoor ik het graag.


πŸ€– Assistant

Now let me check commonground.nl for fonts and also understand the registratie data to build the symbolic time mapping. Now I have a good picture. Let me implement all the changes. Here's my plan:

  1. Font: Add Google Fonts (Open Sans) to β€” no Times-achtig font
  2. ****:
    • Compact ID subtiel achter titel: NatuurlijkPersoon #1 (al zo!) maar de entity card toont nu apart β†’ verwijder dat
    • Opvoer als symbolische rechts van ID, niet als volle timestamp
    • GE-secties: compact niet apart tonen, enkel subtiel
  3. ****:
    • Immutable velden: verberg en entiteit ID als apart label, toon compact
    • Formele tijd: in plaats van volle timestamp
  4. CSS: Kleine verbeteringen

Now update the CSS font-family to ensure Open Sans is used (and remove Rijksoverheid Sans which isn't loaded):


Now the main work β€” update EntiteitFormulier.jsx. Let me rewrite the entity header card and GE sections:


Now update the entity header section β€” replace the entity card that shows and full opvoer timestamp:


Now update the child GE section headers β€” replace the with a cleaner format:


Now the big piece β€” update to use compact ID display and symbolic time:


Now replace the immutable fields display and formele tijd section in RepresentatieFormulier:


Now replace the old "Formele tijd" section that showed full timestamps:


Now update the correction form label that still shows explicitly in EntiteitFormulier:


Geen fouten. Hier is een samenvatting van de wijzigingen:

Wijzigingen

Font β€” : Google Fonts "Open Sans" geladen; : font-family omgezet naar "Open Sans" (geen Times-achtig serif font meer).

Compact ID β€” :

  • Entiteit-header toont nu NatuurlijkPersoon #1 met ID subtiel achter de titel
  • GE-secties: niet meer apart getoond; correctie-label zonder

****:

  • Immutable velden samengevoegd tot compact #1.1 formaat (entiteit_id.rel_id, met optioneel .versie)
  • en entiteit-ID niet meer als losse labels

Symbolische tijd β€” In beide formulieren:

  • Volle timestamps (2026-01-01 01:00:00) vervangen door (symbolische uren sinds 2026-01-01)
  • Rechts uitgelijnd naast de ID-regel
  • Afvoer in rood:
  • Oude "Formele tijd" blok met volle timestamps verwijderd

Suggesties voor verdere verbetering

  • Heading sizes: De huidige heading sizes (h2: 1.375rem) zijn al compact. Overweeg de heading in de entity card iets groter te maken (bijv. 1.25rem) en GE-sectie titels op 0.9375rem te zetten voor meer hiΓ«rarchie.
  • Meer whitespace: De cards staan nu dicht op elkaar. Een tussen secties zou luchtiger aanvoelen.
  • Kleur-accenten op de scroll-knoppen: Die gebruiken al de MetaRegistry-kleur β€” dat is goed. Overweeg een subtiele schaduw (box-shadow) toe te voegen voor diepte.

πŸ§‘ User

  • Ik zie nog steeds een serif font. Het mag idd groter (suggestie).
  • belangrijk: #1.1 en t=1 mogen boven de gele streep
  • alle suggesties zijn goed: wil je die laten zien?

πŸ€– Assistant

The CSS variable is set but it needs to actually be applied. Let me check how the body/document styling works: I see β€” the common-ground-theme class uses a CSS variable, but font-family needs to also be applied directly on the .common-ground-theme element itself. The variable --utrecht-document-font-family is only a token β€” it's not automatically applied to elements. Now I see the structure. The CSS variable is defined but font-family isn't directly applied. Let me also look at how the cg-form-section__title is structured to understand the "above/below yellow line" issue β€” the title has , so content inside the title div is above the line, content after it is below.

Now let me make all changes at once: Now I have full context. The #1.1 and are rendered Now I have full context. The #1.1 and are rendered inside the but outside the cg-form-section__title div. They need to move into the title area. Let me also read the current RepresentatieFormulier rendering context in EntiteitFormulier to see exactly where the formulier is called from: I see the issue clearly now. The #1.1 and are rendered inside (below the yellow line), but they should be part of the cg-form-section__title (above the yellow line). The cleanest approach: pass the compact ID and t-value up into the title in , and strip them from for the enkelvoudig case.

Let me now read the complete RepresentatieFormulier rendering to understand the full structure: Now I have the full picture. The approach:

  1. Font: Add font-family directly to .common-ground-theme (the CSS variable alone isn't enough)
  2. Move #id and t= above yellow line: In , compute the compact ID + symbolic time and add it to the cg-form-section__title. Extract the compact-ID logic into a helper. For the RepresentatieFormulier, still show it for standalone usage but flag it to skip when embedded inside EntiteitFormulier.
  3. Suggestions: bigger heading, more whitespace, subtle shadows on scroll buttons

Now the key part β€” move compact ID + symbolic time into the title (above yellow line) in EntiteitFormulier, and add it as a prop for RepresentatieFormulier to skip rendering it when embedded: Now I need to:

  1. In EntiteitFormulier: put compact ID + t= in the title row for enkelvoudige GEs
  2. In RepresentatieFormulier: add a hideIdEnTijd prop to skip the redundant display

Now add hideIdEnTijd={true} to the enkelvoudig RepresentatieFormulier call:


Now update RepresentatieFormulier to accept and use :


Now wrap the compact ID + time block with the condition:


Now add the subtle shadow to the scroll-buttons in EntiteitFormulier:


Alle wijzigingen zijn doorgevoerd:

Font

  • font-family: "Open Sans" direct op .common-ground-theme gezet in β€” de CSS variable alleen was niet voldoende, de eigenschap moet ook daadwerkelijk worden toegepast.

#ID en t= boven de gele streep

  • In : compact #1.1 en zijn nu onderdeel van de cg-form-section__title div (= boven de gele border-bottom).
  • krijgt mee bij enkelvoudig, zodat het niet dubbel toont.

Suggesties geΓ―mplementeerd

  1. Grotere sectie-titels: 1rem β†’ 1.0625rem in
  2. Meer lucht: cards hebben nu , padding iets strakker (1.25rem), subtiele box-shadow voor diepte
  3. Scroll-knoppen: subtiele schaduw + hover-effect (lichte lift + diepere schaduw)

πŸ§‘ User

Een functie: hoe zouden we netjes de historische records die achter een kaart zitten kunnen tonen. A.h.w. naar voren halen?

Ik stel mij voor dat het oude 'kaartje' achter het nieuwe zit. Is dat te visualiseren? Is de data al in de frontend, of vergt dat een t=x call?


πŸ€– Assistant

Let me also check if returns historical records or only the active data: Now let me check what the full API actually returns β€” does it include the historical data-records (afgevoerde data-versies)? Good. Now I have sufficient understanding. Let me check what happens when no is set β€” are all child records (including afgevoerde data-records) loaded? The filter is only applied when . Without it, ALL records including historical ones are returned. Now let me verify this in β€” it only picks the active data-record per hub:

Looking at line 161 in schemaUtils.js: const actief = childArray.find((d) => !d.afvoer) || childArray[0]; β€” it picks the one without afvoer, ignoring older versions.

Conclusion: The historical data IS already in the frontend β€” in the raw response. The hub items contain all data-versies (including afgevoerde). just picks the active one for display. We can access the historical ones from the raw items without any additional API call.

Now let me think about the visualization. For enkelvoudige GEs (like Partnernaam), the hub contains multiple data-records with version history. For the "stacked cards" effect: we show the actuele card on top, with the historische kaart(en) slightly offset behind it, showing just the key changed values grayed out.

Let me look at how the raw items are structured to build this properly: Good. I need a helper that extracts all flattened versions (including historical) from a hub item. Let me design the approach:

Plan:

  1. Add a platSlaAlleVersies helper in that returns all data-versions per hub item (not just the active one)
  2. In , for enkelvoudige GEs with historical items, show stacked cards: the historical versions as slightly offset, faded background cards behind the active one
  3. Toggle with a small "β–Ύ N historisch" link


Now I need to build the stacked card component in EntiteitFormulier. First let me update the imports and then modify the rendering for enkelvoudige GEs with historical records:


Now I need to add state for toggling history visibility, and create the stacked cards rendering. Let me read the full return block to know exactly where to insert: Add toonHistorie state next to the other state declarations:


Now let me read the exact section where enkelvoudige GEs are rendered with RepresentatieFormulier, to add the stacked history cards: Now I'll replace the enkelvoudig rendering section to include stacked historical cards:


Goed nieuws: de historische data zit al in de frontend. De API retourneert alle data-versies per hub (inclusief afgevoerde). pakte er alleen de actieve uit β€” de rest was er al maar werd genegeerd.

Wat er nu is gebouwd

Gestapelde kaarten-visualisatie voor enkelvoudige GE's met versiegeschiedenis:

  1. Visuele stack-hint: Als er historische versies zijn, verschijnen er grijze "schaduwkaarten" achter het actuele formulier (1 extra kaart = 1 offset, 2+ = dubbele offset). Dit geeft het gevoel van een stapel.

  2. Toggle-link: Onder het actuele formulier staat "β–Ύ N historische versie(s) tonen" β€” klikken klapt de historie open.

  3. Historische versiekaarten: Elke oude versie wordt als een compact read-only blokje getoond met:

    • Versienummer links (monospace)
    • Symbolische formele tijd rechts:
    • De inhoudsvelden als op één regel
    • Gedempt: lichtgrijze achtergrond, dashed border, 75% opacity
  4. **Helper ** in : haalt alle data-versies op uit een hub-item en mergt ze met de hub-velden, gesorteerd met actueel bovenaan.

Geen extra API-call nodig β€” alles werkt op de bestaande data.


πŸ§‘ User

Ik zie het meer zo:

  • klikken op wat nu 1 hist heet (boven de streep) zorgt voor het tonen van de historie.
  • het grijs vind ik niet zo mooi
  • de extra +1 historische versie tonen neemt teveel ruimte in
  • het werkt nu alleen op Partnernaam en niet op de andere 2

Verder:

  • zou je in de overzichtstabel de data willen tonen bij de andere velden? Ik zal op elk GE nog wel een weergave afgeleid veld maken, maar voor nu mag het gewoon de velden (als het er meer zijn) achter elkaar met een | ertussen en afbreken indien te lang.

πŸ€– Assistant

Now let me also see the RepresentatieTabel to understand how the overview table works: Now I understand the full picture. Let me now implement all changes:

  1. Title area: Make "N hist." clickable (toggle), remove the shadow cards and separate link
  2. History for all types (both enkelvoudig and meervoudig): extract history from raw hub items
  3. Overview table: Show field values instead of counts for GE columns Now I have the full picture. Let me do a comprehensive rewrite of the GE section rendering. I'll replace the entire block from the return ( of the map:

Now I need to add the shared history rendering block after the enkelvoudig/meervoudig sections and before the "Lege GE" section. Let me read where null} closes the ternary: Now let me also read the title section to see the current state: Now I need to insert the history panel. The right spot is after the ternary null (line 464 } : null}) and before the "Lege GE" comment. Let me also read the schemaUtils to understand what fields returns: Good. Now I have all the context. I need to:

  1. Insert a history panel block after the ternary } : null} and before {/* Lege GE: ...
  2. This block renders when is true
  3. It shows each historical version as a compact card with version info and field values

Now let me look at the RepresentatieTabel to understand the current column generation for GE types: Now I see the GE columns section (lines ~113-128). Currently it shows a count. I need to replace this with field value display. The approach: use to extract field values and join them with |.

Let me check what does and what imports are already in this file: Good β€” is already imported. Now I need to modify the GE column generation to show field values instead of counts. For hub-type GEs, I'll flatten the hub items and show the content field values with | separator. For meervoudig, I'll show multiple items separated, with truncation.


Now let me verify the function signature to make sure the 3-argument call is correct: Good, the signature matches. Let me check for any errors: Both changes are in place:

  1. History panel in β€” when you click "N hist." above the yellow line, a left-bordered panel expands showing each historical version as a compact row with vN Β· t=N β†’ afgevoerd t=N and the field values. No gray shadow cards, no separate toggle link.

  2. Overview table in β€” GE columns now show actual field values (e.g. Vries | Joris) instead of just counts. Multiple hub items are separated with ;, and long text is truncated at 60 chars with … and a tooltip for the full text.


πŸ§‘ User

  • wil je als het enkelvoudig is (alleen 1 | ) de 1 | weglaten?
  • als het er meer zijn is het formaat : veld1 | veld2; : veld1 | veld 2 denk ik beter
  • dus 1 | Woud; 2 | op den Zee -> 1: Woud; 2: op den Zee

πŸ€– Assistant


Done. The format is now:

  • Enkelvoudig (1 hub item): just field values, e.g. Woud or NL | Nederlandse
  • Meervoudig (multiple hub items): 1: Woud; 2: op den Zee

πŸ§‘ User

  • ik zie de 1 | nog overal....
  • in de visualisatie rendert Burgerschap (afgeleid veld) niet. In de inhoud pagina wel...

πŸ€– Assistant

I'll fix both issues now: remove the visible 1 | prefixes in the overview and check why Burgerschap is not rendering in the visualisation.




I’ve applied the fixes; now I’m verifying the frontend build.## Aangepast

De oorzaak was dat / nog meekwamen in de compacte weergave.

  • Overzichtstabel in

    • enkelvoudig: nu zonder 1 |
    • meervoudig: nu als 1: Woud; 2: op den Zee
  • Visualisatie in

    • de afgeleide weergave voor Burgerschap is robuuster gemaakt, zodat die ook in de representatiekaart kan renderen
    • fallback-samenvatting negeert nu ook

Verifieerd

βœ… Frontend build opnieuw gedraaid via vite: build (v06)
Resultaat: vite v5.4.21 ... βœ“ built in 1.25s

Als de pagina al open stond: even hard refreshen (Ctrl+F5).


πŸ§‘ User

Is hier nog iets te doen aan dat het adres van het kaartje afloopt? Het kaartje breder maken als dat nodig is?


πŸ€– Assistant

I'll adjust the visualisation so cards can widen for longer labels and then verify the build.


The card now grows for longer labels; I’m validating the frontend build.## Ja β€” dat is nu aangepast

Ik heb de centrale kaart in dynamisch breder gemaakt voor langere teksten, zoals adressen.

Wat er nu gebeurt

  • korte labels blijven op de normale breedte
  • langere labels maken het kaartje automatisch breder
  • de opv-tekst, selectie-rand en datum-oortjes schuiven netjes mee

Verificatie

Ik heb de frontend opnieuw gebouwd:

vite v5.4.21 ... βœ“ built in 1.25s

Even Ctrl+F5 doen in de browser, dan zou je het direct moeten zien.