Popupbeheer
Popupbeheer beschrijft het beheer van bestaande systeem-popups binnen Site Instellingen. De beheerder kan alleen inhoudelijke velden aanpassen die door de bestaande popupdefinitie beheerbaar zijn, zoals titel, tekst, zichtbare knopteksten en waar van toepassing een inputlabel. Technische ankers zoals PopupKey, Variant, ThemeKey, knopacties en CustomRendererKey blijven read-only en code- of migratiegedreven.
Het subdomein sluit direct aan op het centrale popupregister en de popup-themes. Usecases verwijzen daarom alleen naar PopupKey en dupliceren geen popupteksten, knopteksten, inputlabels, actiecodes of themekeuzes.
Usecases
| Usecase | Bestand | Omschrijving |
|---|---|---|
| UC-BEH-POP-001 | uc-beh-pop-001_popupoverzicht-bekijken.md | De beheerder opent het overzicht met bestaande popuprecords en zoekt of filtert binnen sleutel, domein, titel en tekst. |
| UC-BEH-POP-002 | uc-beh-pop-002_popupdetail-openen.md | De beheerder opent het detail van één bestaand popuprecord en ziet beheerbare velden gescheiden van technische read-only velden. |
| UC-BEH-POP-003 | uc-beh-pop-003_popupvelden-wijzigen.md | De beheerder past beheerbare velden in de editor aan zonder dat dit al een databasewijziging veroorzaakt. |
| UC-BEH-POP-004 | uc-beh-pop-004_popupwijziging-valideren-en-opslaan.md | Het systeem valideert een popupwijziging server-side, slaat toegestane wijzigingen atomair op en registreert history. |
| UC-BEH-POP-005 | uc-beh-pop-005_popupgeschiedenis-bekijken.md | De beheerder bekijkt de wijzigingsgeschiedenis van één popuprecord met actor, tijdstip en veldverschillen. |
| UC-BEH-POP-006 | uc-beh-pop-006_custom-popup-beperking-toepassen.md | Het systeem bewaakt dat afwijkende renderers en layouts alleen via bestaande Variant = Custom-records en codegedreven renderers worden gebruikt. |
Relevante schermdocumentatie
| Scherm | Relevantie |
|---|---|
| Site Instellingen | Ingang naar Popups beheren. |
| Popups beheren | Overzicht, detail, editor en geschiedenis voor bestaande popuprecords. |
| Popupregister | Centrale bron voor PopupKey, functionele bedoeling en popupverwijzingen vanuit usecases. |
| Popup-themes | Centrale bron voor herbruikbare themakeuzes, varianten, knopgedrag en visuele standaardinstellingen. |
Domeinafbakening
Popupbeheer valt binnen Beheerder / Site Instellingen en is beperkt tot bestaande popuprecords. De beheerder beheert geen nieuwe popupdefinities, geen runtimeflow waarin popups worden getoond en geen technische rendererlogica.
Binnen scope:
- raadplegen van bestaande popuprecords;
- zoeken en filteren op technische sleutel, domein, titel en tekst;
- openen van popupdetails;
- wijzigen van beheerbare tekstvelden;
- server-side valideren en opslaan van toegestane wijzigingen;
- raadplegen van wijzigingsgeschiedenis;
- toepassen van de beperking dat afwijkende layouts en meerdere inputvelden alleen via bestaande Custom-popups mogelijk zijn.
Buiten scope:
- aanmaken van nieuwe popupdefinities via de GUI;
- verwijderen of deactiveren van popupdefinities via de GUI;
- wijzigen van
PopupKey,Variant,ThemeKey, knopacties ofCustomRendererKey; - beheren van popup-themes zelf;
- runtimebeslissingen over wanneer een popup in een gebruikersflow verschijnt;
- dupliceren van popupteksten of knopteksten buiten het popupregister;
- genereren van seeddata of database-migraties vanuit deze beheerinterface.
Beheerbare, read-only en codegedreven velden
| Veldgroep | Gedrag |
|---|---|
| Titel | Beheerbaar binnen de vastgestelde lengte. |
| Tekst | Beheerbaar binnen de vastgestelde lengte en veilige rendering. |
| Zichtbare knoptekst | Beheerbaar wanneer de bestaande popupdefinitie die knop ondersteunt. |
| Inputlabel | Beheerbaar wanneer de bestaande variant precies het ondersteunde inputveld bevat. |
Technische sleutel / PopupKey | Read-only; stabiel anker voor code, usecases en registerverwijzingen. |
Variant en ThemeKey | Read-only; bepalen technische en visuele basisgedrag via code en register. |
Knopactie / ActionCallMethod | Read-only; runtime-actie blijft codegedreven. |
CustomRendererKey | Read-only; alleen relevant voor bestaande Custom-popups. |
Business rules
| ID | Regel |
|---|---|
| BR-BEH-POP-001 | Popupbeheer werkt uitsluitend op bestaande popuprecords. |
| BR-BEH-POP-002 | De beheerinterface is geen vrije popupbuilder. |
| BR-BEH-POP-003 | PopupKey, Variant, ThemeKey, knopacties en CustomRendererKey zijn read-only. |
| BR-BEH-POP-004 | Niet-custom popups ondersteunen maximaal één invoerveld binnen de normale dynamische popupstructuur. |
| BR-BEH-POP-005 | Meer dan één invoerveld of een afwijkende layout vereist een bestaande Custom-popup met codegedreven renderer. |
| BR-BEH-POP-006 | Iedere opgeslagen wijziging aan beheerbare popupvelden wordt auditbaar vastgelegd met actor, UTC-tijdstip en veldverschillen. |
| BR-BEH-POP-007 | Popupteksten en knopteksten worden niet in usecases herhaald; usecases verwijzen alleen naar PopupKey. |
Validatiegrenzen
| Veld | Grens / regel |
|---|---|
| Titel | Maximaal 50 tekens. |
| Popuptekst | Maximaal 1000 tekens. |
| Knoptekst | Maximaal 20 tekens per zichtbare knop. |
| Inputlabel | Alleen toegestaan wanneer de bestaande popupvariant een beheerbaar inputlabel ondersteunt. |
| Variabelengebruik | Alleen door expliciet ondersteunde en veilig te vullen variabelen. |
| HTML / actieve inhoud | Niet toegestaan; tekst wordt veilig opgeslagen en gerenderd. |
Diagramgebruik
Read-only usecases gebruiken geen persistent state diagram. Muterende usecases tonen uitsluitend lifecycle- en sequence-diagrammen die de opslag, server-side validatie en historyregistratie functioneel verduidelijken. Er worden geen ERD's in usecases opgenomen.