UC-BEH-POP-005 — Popupgeschiedenis bekijken
1. Kerngegevens
| Veld | Waarde |
|---|---|
| Usecase-ID | UC-BEH-POP-005 |
| Naam | Popupgeschiedenis bekijken |
| 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-002, UC-BEH-POP-004 |
| Primaire entiteiten | PopupDetails, PopupDetailsHistory, PopupDetailsHistoryItems |
| 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 bekijkt de wijzigingsgeschiedenis van één bestaand popuprecord. Het systeem toont historymomenten met actor, UTC-tijdstip, soort wijziging en veldniveauverschillen waar beschikbaar.
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 de geschiedenis van één popuprecord.
- Lezen van historymomenten en veldverschillen.
- Tonen van oude en nieuwe waarden op beheerniveau.
- Ondersteunen van veilige lege staat wanneer nog geen wijzigingen zijn geregistreerd.
- Behouden van immutable history zonder bewerk- of verwijderactie.
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 popupgeschiedenis of een veilige lege staat. |
| POST-002 | Historyrecords zijn alleen geraadpleegd en niet gewijzigd. |
| POST-003 | Het popuprecord zelf is niet gewijzigd. |
| POST-004 | Actor, UTC-tijdstip en veldverschillen zijn zichtbaar voor zover geregistreerd. |
6. Trigger
De beheerder kiest bij een popuprecord de actie Geschiedenis.
7. Normale processtroom
| Stap | Actor | Scherm / component | Actie | Systeemrespons | Data / regel |
|---|---|---|---|---|---|
| 1 | Beheerder | Popupdetail of overzicht | Kiest Geschiedenis. | Frontend vraagt historyreadmodel op. | Recordselectie. |
| 2 | Backend | Autorisatiecomponent | Controleert beheerdercontext. | Zonder beheerderrol wordt geen history getoond. | Server-side. |
| 3 | Backend | Popupservice | Controleert dat het popuprecord bestaat. | Onbekend record wordt veilig afgehandeld. | PopupDetails. |
| 4 | Backend | Historyservice | Leest historymomenten. | History wordt aflopend of volgens vaste sortering geleverd. | PopupDetailsHistory. |
| 5 | Backend | Historyservice | Leest veldverschillen waar beschikbaar. | Oude en nieuwe waarden worden in beheercontext getoond. | PopupDetailsHistoryItems. |
| 6 | Frontend | Geschiedenispaneel | Rendert history. | Beheerder kan terug naar detail of overzicht. | Geen mutatie. |
8. Alternatieve en exceptionele processtromen
| ID | Vanaf stap | Situatie | Systeemgedrag | Popup / melding | Datamutatie |
|---|---|---|---|---|---|
| ALT-001 | 2 | Geen actieve beheerderrol. | Backend blokkeert historydata. | Inline toegang geweigerd of veilige redirect. | Geen. |
| ALT-002 | 3 | Popuprecord bestaat niet. | Het systeem toont een veilige niet-beschikbaarafhandeling. | Inline melding. | Geen. |
| ALT-003 | 4 | Geen historyrecords aanwezig. | Het systeem toont een neutrale lege history-staat. | Niet van toepassing. | Geen. |
| ALT-004 | 5 | Een oude waarde is niet meer volledig renderbaar. | Het systeem toont veilige tekstuele weergave of markering dat de waarde niet toonbaar is. | Inline toelichting. | Geen. |
9. Business rules
| ID | Regel |
|---|---|
| BR-UC-BEH-POP-005-001 | Popupgeschiedenis is read-only. |
| BR-UC-BEH-POP-005-002 | Historyrecords zijn immutable via de beheerinterface. |
| BR-UC-BEH-POP-005-003 | Geschiedenis toont beheerwijzigingen, niet runtimevertoningen van popups aan eindgebruikers. |
| BR-UC-BEH-POP-005-004 | Oude en nieuwe waarden worden veilig weergegeven zonder actieve inhoud. |
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 | Geschiedenis raadplegen 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. Geschiedenis raadplegen wijzigt geen popupstatus en geen historyrecord.
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-005-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-005-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-005-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-005-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-005-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-005-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-005-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-005-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-005-010 | SRS-ADM-001 SRS-POP-001 SRS-NFR-AUD-001 AC-ADM-001 AC-POP-001 AC-NFR-AUD-001 | De usecase Popupgeschiedenis bekijken uitvoeren binnen de afbakening van Beheerder / Popupbeheer |