UC-BEH-POP-002 — Popupdetail openen
1. Kerngegevens
| Veld | Waarde |
|---|---|
| Usecase-ID | UC-BEH-POP-002 |
| Naam | Popupdetail openen |
| Domein | Beheerder / Popupbeheer |
| Primaire actor | Beheerder |
| Secundaire actor(en) | Frontend, backend, autorisatiecomponent, database |
| Rolcontext | Actieve beheerdercontext; combinatierollen geven geen extra rechten binnen popupbeheer |
| Betrokken schermen | Site Instellingen > Popups beheren |
| Gerelateerde usecases | UC-BEH-POP-001, UC-BEH-POP-003, UC-BEH-POP-004, UC-BEH-POP-005, UC-BEH-POP-006 |
| Primaire entiteiten | PopupDetails, PopupDetailsHistory |
| Secundaire entiteiten / events | PopupType, PopupVariant, PopupInputType, ButtonTheme, Users, popup-register, popup-themes |
| Gerelateerde popups | Niet van toepassing |
| Popupregister | Ontwerpbronnen — Popup-register |
| MoSCoW | Must |
2. Omschrijving
De beheerder opent het detail van één bestaand popuprecord. Het systeem toont beheerbare tekstvelden en technische read-only velden duidelijk gescheiden, zodat de beheerder ziet wat kan worden aangepast en wat codegedreven blijft.
Popupbeheer is geen vrije popupbuilder. Het beheer werkt binnen bestaande popuprecords en respecteert de scheiding tussen beheerbare inhoud en codegedreven structuur. Popupteksten, knopteksten, acties, inputvelden en themekeuzes worden niet in usecases gedupliceerd.
3. Scope
Deze usecase beschrijft:
- Openen van één bestaand popuprecord vanuit het overzicht.
- Tonen van
PopupKey, domein,Variant,ThemeKey, knopacties en eventueleCustomRendererKeyals read-only gegevens. - Tonen van beheerbare velden zoals titel, tekst, knopteksten en inputlabel wanneer de bestaande popupdefinitie dit ondersteunt.
- Tonen van variantbeperkingen en custom-beperkingen zonder rendererlogica te wijzigen.
- Startpunt bieden voor bewerken, opslaan of geschiedenis raadplegen.
Deze usecase beschrijft niet:
- Nieuwe popuprecords aanmaken via de GUI.
- Popuprecords verwijderen of deactiveren via de GUI.
PopupKey,Variant,ThemeKey, knopacties ofCustomRendererKeywijzigen.- Popup-themes beheren.
- Runtime bepalen wanneer popups in gebruikersflows verschijnen.
- Popupteksten of knopteksten buiten het popupregister dupliceren.
- Onderliggende code, migraties of seeddefinities wijzigen via de beheerinterface.
4. Pre-condities
| ID | Voorwaarde |
|---|---|
| PRE-001 | De gebruiker is ingelogd en heeft een actief intern OefenHub-account. |
| PRE-002 | De gebruiker heeft server-side een actieve beheerderrol. |
| PRE-003 | De route of actie ligt binnen Site Instellingen > Popups beheren. |
| PRE-004 | De frontend gebruikt actuele serverrespons en vertrouwt niet op oude clientstate. |
| PRE-005 | Popupregister en popup-themes zijn als bronafspraak beschikbaar voor interpretatie van popuprecords. |
5. Post-condities
| ID | Resultaat |
|---|---|
| POST-001 | De beheerder ziet het popupdetail of een veilige niet-beschikbaarafhandeling. |
| POST-002 | Beheerbare en read-only velden zijn functioneel gescheiden. |
| POST-003 | Het openen van het detail heeft geen popuprecord of historyrecord gewijzigd. |
| POST-004 | Vervolgacties starten de daarvoor bedoelde usecases. |
6. Trigger
De beheerder kiest in het popupoverzicht de actie Open detail bij één popuprecord.
7. Normale processtroom
| Stap | Actor | Scherm / component | Actie | Systeemrespons | Data / regel |
|---|---|---|---|---|---|
| 1 | Beheerder | Popupoverzicht | Selecteert één bestaand popuprecord. | Frontend vraagt het detail op. | Record-id of sleutel. |
| 2 | Backend | Autorisatiecomponent | Controleert beheerdercontext. | Zonder beheerderrol wordt geen detaildata getoond. | Server-side. |
| 3 | Backend | Popupservice | Laadt het actuele popuprecord. | Onbekend record wordt veilig afgehandeld. | PopupDetails. |
| 4 | Backend | Readmodel | Scheidt beheerbare en read-only velden. | UI ontvangt veldmetadata. | Popupregister en popup-themes. |
| 5 | Frontend | Detailpaneel | Toont technische sleutel, variant, theme en acties read-only. | Beheerder kan technische ankers niet wijzigen. | DRY-regel. |
| 6 | Frontend | Detailpaneel | Toont beheerbare velden. | Bewerken start UC-BEH-POP-003. | Geen mutatie. |
| 7 | Frontend | Detailpaneel | Toont eventuele custombeperking. | Afwijkende renderer blijft codegedreven. | UC-BEH-POP-006. |
8. Alternatieve en exceptionele processtromen
| ID | Vanaf stap | Situatie | Systeemgedrag | Popup / melding | Datamutatie |
|---|---|---|---|---|---|
| ALT-001 | 2 | Geen actieve beheerderrol. | Backend blokkeert detaildata. | Inline toegang geweigerd of veilige redirect. | Geen. |
| ALT-002 | 3 | Record bestaat niet. | Het systeem toont een veilige niet-beschikbaarafhandeling. | Inline melding. | Geen. |
| ALT-003 | 3 | Record is intussen gewijzigd. | Het detail toont de actuele serverversie. | Niet van toepassing. | Geen. |
| ALT-004 | 4 | Popupvariant ondersteunt geen input. | Inputlabel wordt niet als beheerbaar veld getoond. | Niet van toepassing. | Geen. |
| ALT-005 | 7 | CustomRendererKey is onbekend voor de UI. | Detail blijft veilig raadpleegbaar; rendererlogica wordt niet via beheer aangepast. | Inline technische beperking zonder stacktrace. | Geen. |
9. Business rules
| ID | Regel |
|---|---|
| BR-UC-BEH-POP-002-001 | Popupdetail openen is read-only. |
| BR-UC-BEH-POP-002-002 | Technische velden zijn altijd zichtbaar als read-only wanneer zij functioneel relevant zijn voor beheer. |
| BR-UC-BEH-POP-002-003 | De UI mag niet suggereren dat Variant, ThemeKey, knopacties of rendererkeys bewerkbaar zijn. |
| BR-UC-BEH-POP-002-004 | Vervolgacties voor bewerken, opslaan en geschiedenis zijn afzonderlijke usecases. |
10. Datavalidatie
| Veld / object | Validatie |
|---|---|
| Beheerdercontext | Server-side actieve beheerderrol verplicht. |
| Popuprecord | Het record moet bestaan en als bestaand popuprecord bekend zijn. |
| PopupKey | Moet bestaan en blijft read-only. |
| Variant | Moet een bekende PopupVariant zijn en blijft read-only. |
| ThemeKey | Blijft read-only en moet verwijzen naar een bestaande themedefinitie. |
| Knopacties | ActionCallMethod en technische actie-identifiers zijn read-only. |
| CustomRendererKey | Alleen relevant bij Custom-popups en blijft read-only. |
| Titel | Maximaal 50 tekens wanneer beheerbaar. |
| Tekst | Maximaal 1000 tekens wanneer beheerbaar. |
| Knoptekst | Maximaal 20 tekens per zichtbare knop wanneer beheerbaar. |
| Inputlabel | Alleen beheerbaar wanneer de bestaande variant een inputveld ondersteunt. |
| Rendering | Beheerbare tekst mag geen actieve of onveilige inhoud veroorzaken. |
| Tijdstip | Wijzigingsmomenten worden in UTC vastgelegd. |
11. Datamutaties en events
| Stap | Type | Entiteit / event | Mutatie |
|---|---|---|---|
| Alle stappen | Database | Niet van toepassing | Het openen van popupdetail is read-only. |
12. Geen datamutaties
| Entiteit | Reden |
|---|---|
| PopupDetails | Alleen gelezen; de usecase wijzigt geen popuprecord. |
| PopupDetailsHistory en PopupDetailsHistoryItems | Alleen gelezen wanneer geschiedenisindicaties of historydetails nodig zijn. |
| Users, Roles en UserRoles | Alleen gebruikt voor autorisatiecontrole. |
| PopupKey, Variant, ThemeKey, ActionCallMethod en CustomRendererKey | Technische ankers blijven read-only en codegedreven. |
| Popupregister en popup-themes | Ontwerpbronnen blijven bronhoudend en worden niet door de beheer-UI gewijzigd. |
| Runtime gebruikersdata | Leerling-, docent-, ouder-/voogddata, oefenruns, meldingen, relaties en berichten worden niet gewijzigd. |
13. State diagram
Deze usecase heeft geen persistent state diagram. Popupdetail openen wijzigt geen popupstatus of brondomeinrecord.
14. Decision flow
15. Data lifecycle diagram
16. Sequence diagrammen
17. Popupverwijzingen
Usecases verwijzen alleen naar PopupKey. Popupteksten, knopteksten, acties, inputvelden en themakeuzes worden centraal beheerd in het popupregister en de popup-themes.
| PopupKey | Moment | Doel |
|---|---|---|
| Niet van toepassing | Geen bevestigings- of invoerpopup in de normale processtroom. | Inline meldingen, lege staten of veilige redirects volstaan. |
18. Afleiding naar Functioneel Ontwerp / Technisch Ontwerp / Software Requirements Specification
| Doeldocument | Afleiding |
|---|---|
| Functioneel Ontwerp | Beschrijft welke popupvelden beheerbaar zijn, welke velden read-only blijven en hoe de beheerder bestaande popuprecords raadpleegt of wijzigt. |
| Technisch Ontwerp | Technisch Ontwerp: domeinmodel en admin-eigenaarschap, databaseontwerp en frontendcompositie beschrijven de technische uitwerking. Beschrijf server-side autorisatie, readmodelopbouw en geen command- of eventregisteruitbreiding voor read-only raadpleegacties, inclusief bescherming van technische sleutels en codegedreven velden. |
| Software Requirements Specificatie | Beschrijft requirements voor toegangscontrole, validatiegrenzen, veilige foutafhandeling, immutable history en de scheiding tussen beheerbare tekst en technische popupdefinities. |
| Database-informatie | Controleer aansluiting van PopupDetails, PopupDetailsHistory en PopupDetailsHistoryItems, inclusief veldlengtes, concurrency en auditvelden. |
| Ontwerpbronnen en registers | Houd popupregister, popup-themes, autorisatiematrix, usecase-popup-matrix en usecase-requirement-matrix consistent met deze usecase. |
19. SRS-trace
Deze usecase bevat geen normatieve requirementtekst. De centrale eis en acceptatiecriteria staan in de SRS; onderstaande tabel koppelt de usecase-afleiding alleen aan centrale SRS-*- en AC-*-items.
| Usecase-afleiding | Dekt | Usecasecontext |
|---|---|---|
REQ-UC-BEH-POP-002-001 | SRS-ADM-002 SRS-ADM-001 AC-ADM-002 AC-ADM-001 | De actie uitsluitend toestaan aan gebruikers met een actieve beheerderrol |
REQ-UC-BEH-POP-002-002 | SRS-AUTH-001 SRS-AUTH-002 SRS-ADM-002 SRS-ADM-001 AC-AUTH-001 AC-AUTH-002 AC-ADM-002 AC-ADM-001 | Alle beheerautorisatie server-side controleren en mag niet vertrouwen op clientstate of routeparameters |
REQ-UC-BEH-POP-002-003 | SRS-AUTH-004 SRS-ACC-003 SRS-ACC-005 SRS-ADM-001 SRS-POP-001 SRS-NFR-SEC-001 AC-AUTH-004 AC-ACC-003 AC-ACC-005 AC-ADM-001 AC-POP-001 AC-NFR-SEC-001 | Onbekende, ontbrekende of niet-toegankelijke popuprecords veilig afhandelen zonder technische details te tonen |
REQ-UC-BEH-POP-002-004 | SRS-ADM-001 SRS-POP-001 AC-ADM-001 AC-POP-001 | PopupKey, Variant, ThemeKey, knopacties en CustomRendererKey read-only houden in de beheerinterface |
REQ-UC-BEH-POP-002-005 | SRS-ADM-001 SRS-POP-001 AC-ADM-001 AC-POP-001 | Popupteksten, knopteksten, inputlabels en themekeuzes niet dupliceren buiten het centrale popupregister en popup-themes |
REQ-UC-BEH-POP-002-006 | SRS-ADM-002 SRS-ADM-001 SRS-POP-001 SRS-NFR-AUD-001 AC-ADM-002 AC-ADM-001 AC-POP-001 AC-NFR-AUD-001 | Deze raadpleeg- of controleflow uitvoeren zonder PopupDetails of historyrecords te wijzigen |
REQ-UC-BEH-POP-002-007 | SRS-RDM-001 SRS-ADM-001 AC-RDM-001 AC-ADM-001 | Zoek-, filter-, selectie- en detailacties behandelen als read-only readmodelgedrag |
REQ-UC-BEH-POP-002-009 | SRS-ADM-001 AC-ADM-001 | Titel, tekst, knopteksten en inputlabels valideren op de vastgestelde maximale lengtes wanneer deze velden beheerbaar zijn |
REQ-UC-BEH-POP-002-010 | SRS-ADM-001 SRS-POP-001 AC-ADM-001 AC-POP-001 | De usecase Popupdetail openen uitvoeren binnen de afbakening van Beheerder / Popupbeheer |