UC-BEH-SITE-001 — Site Instellingen-hub openen
1. Kerngegevens
| Veld | Waarde |
|---|---|
| Usecase-ID | UC-BEH-SITE-001 |
| Naam | Site Instellingen-hub openen |
| Domein | Beheerder / Site Instellingen-hub |
| Primaire actor | Beheerder |
| Secundaire actor(en) | Frontend, backend, autorisatiecomponent, routering |
| Rolcontext | Actieve beheerdercontext |
| Betrokken schermen | Site Instellingen-hub, beheerdernavigatie, onderliggende beheerpagina’s |
| Gerelateerde usecases | UC-BEH-FP-001, UC-BEH-SITE-002, UC-BEH-SITE-003 |
| Primaire entiteiten | Users, Roles, UserRoles, SiteSettings, ContentBlocks |
| Secundaire entiteiten / events | PopupDefinitions, SystemMessageTemplates, SiteFeatureToggles, SiteNotifications, FooterSections, StaticPageBlocks |
| Gerelateerde popups | Niet van toepassing |
| Popupregister | Ontwerpbronnen — Popup-register |
| MoSCoW | Must |
2. Omschrijving
Deze usecase beschrijft het openen van de Site Instellingen-hub door een beheerder. De hubpagina is het centrale startpunt voor inhoudelijke en configuratieve beheerpagina’s, maar is zelf geen lange formulierpagina waarop alle instellingen direct gewijzigd worden.
De hub gebruikt minimaal de breadcrumb Home > Site Instellingen en toont duidelijke tegels naar Frontpage, Popups beheren, Systeemberichten, Handige links & pagina’s, Features en Technische instellingen. Iedere tegel is een route-ingang naar een onderliggende beheerpagina met eigen autorisatie, validatie, geschiedenis en eventuele mutaties.
De hub is bewust afgebakend van de beheerder-frontpage. De frontpage geeft oriëntatie en samenvattingen; de Site Instellingen-hub groepeert beheergebieden. De hub is ook afgebakend van de onderliggende beheerpagina’s: op de hub zelf worden geen popupteksten, systeemberichttemplates, featuretoggles of systeeminstellingen aangepast.
Uitgangspunten
- De hub is bereikbaar vanuit beheerdernavigatie.
- Elke tegel opent een onderliggende beheerpagina en voert zelf geen domeinmutatie uit.
- De hub toont alleen beheergebieden waarvoor de beheerder functioneel toegang heeft.
- Onderliggende pagina’s blijven bronhoudend voor hun eigen beheerprocessen.
3. Scope
Deze usecase beschrijft:
- Openen van de Site Instellingen-hub.
- Tonen van breadcrumb en beheergebieden als tegels.
- Afbakening tussen hub, frontpage en onderliggende beheerpagina’s.
- Server-side toegangcontrole voor de hub.
- Veilige weergave wanneer een onderliggende route niet beschikbaar is.
Deze usecase beschrijft niet:
- Wijzigen van frontpagecontent, popups, systeemberichten, links, features of technische instellingen.
- Beheer van Content-submenu’s zoals Categorieën, Modules en Docent ondersteuning.
- Accountbeheer en rolbeheer.
- Volledige beheerlogging of auditexport.
- Vrij toevoegen of verwijderen van hubtegels via de GUI.
3.1 Afbakening met aangrenzende usecases
| Onderdeel | Afbakening |
|---|---|
| UC-BEH-FP-001 | De frontpage toont oriëntatie; de hub groepeert beheergebieden. |
| UC-BEH-SITE-002 | Behandelt de keuze voor een specifieke tegel. |
| UC-BEH-SITE-003 | Behandelt de server-side toegang tot de hub. |
| Onderliggende beheerpagina’s | Zijn bronhoudend voor velden, validaties, mutaties en geschiedenis. |
| Content-menu | Categorieën, Modules en Docent ondersteuning vallen onder Content en niet onder deze hub. |
4. Pre-condities
| ID | Voorwaarde |
|---|---|
| PRE-001 | De gebruiker heeft een geldige beheerdercontext. |
| PRE-002 | De route Site Instellingen is beschikbaar in de beheerdernavigatie. |
| PRE-003 | De backend kan bepalen welke hubtegels zichtbaar zijn. |
| PRE-004 | De breadcrumbstructuur voor Site Instellingen is bekend. |
| PRE-005 | Onderliggende beheerpagina’s voeren eigen autorisatie uit. |
| PRE-006 | De hubpagina kan een veilige lege of beperkte staat tonen wanneer een onderdeel niet beschikbaar is. |
5. Post-condities
| ID | Resultaat |
|---|---|
| POST-001 | De beheerder ziet de Site Instellingen-hub. |
| POST-002 | De breadcrumb Home > Site Instellingen is zichtbaar. |
| POST-003 | De tegels naar beheergebieden zijn zichtbaar volgens autorisatie en beschikbaarheid. |
| POST-004 | Er is geen beheerinstelling gewijzigd. |
| POST-005 | Doorklikken naar een tegel verloopt via UC-BEH-SITE-002. |
| POST-006 | De hubweergave kan als input dienen voor FO, TO en SRS-afbakening van sitebeheer. |
6. Trigger
De usecase start wanneer een beheerder in de beheerdernavigatie het item Site Instellingen kiest of direct de geautoriseerde route voor de Site Instellingen-hub opent.
7. Normale processtroom
| Stap | Actor | Scherm / component | Actie | Systeemrespons | Data / regel |
|---|---|---|---|---|---|
| 1 | Beheerder | Beheerdernavigatie | Kiest Site Instellingen. | De frontend opent de hubroute. | Geen mutatie. |
| 2 | Frontend | Routering | Vraagt de hubpagina server-side op. | De backend controleert de beheerdercontext. | UC-BEH-SITE-003. |
| 3 | Backend | Autorisatiecomponent | Bevestigt toegang tot de hub. | Bij geldige toegang wordt het hubreadmodel opgebouwd. | Users, UserRoles. |
| 4 | Backend | Hubservice | Bepaalt vaste hubtegels. | Minimaal Frontpage, Popups beheren, Systeemberichten, Handige links & pagina’s, Features en Technische instellingen. | Codegedreven hubstructuur. |
| 5 | Backend | Routecomponent | Controleert beschikbaarheid van onderliggende routes. | Niet-beschikbare onderdelen worden veilig verborgen of uitgeschakeld volgens definitie. | Geen autorisatieovername. |
| 6 | Backend | Breadcrumbcomponent | Stelt breadcrumb samen. | Home > Site Instellingen wordt meegegeven. | Vaste navigatiecontext. |
| 7 | Backend | Frontend | Levert hubreadmodel. | Frontend ontvangt breadcrumb, tegels, labels en routeverwijzingen. | Read-only. |
| 8 | Frontend | Site Instellingen-hub | Rendert de hub. | Beheerder ziet duidelijke tegels naar onderliggende beheerpagina’s. | Geen formulierhub. |
| 9 | Beheerder | Hubpagina | Oriënteert zich of kiest een tegel. | Tegelkeuze wordt afgehandeld door UC-BEH-SITE-002. | Geen mutatie in deze usecase. |
8. Alternatieve en exceptionele processtromen
| ID | Vanaf stap | Situatie | Systeemgedrag | Popup / melding | Datamutatie |
|---|---|---|---|---|---|
| ALT-001 | 2 | De gebruiker heeft geen beheerdercontext. | De hub wordt niet getoond; toegang wordt veilig geweigerd. | Inline of veilige redirect. | Geen. |
| ALT-002 | 4 | Een hubtegel is technisch niet beschikbaar. | De tegel wordt verborgen of uitgeschakeld met beheerbare toelichting volgens schermconventie. | Inline status. | Geen. |
| ALT-003 | 4 | Een beheergebied is nog niet geautoriseerd voor deze beheerderrolvariant. | De tegel wordt niet getoond of leidt tot veilige blokkade bij doelroute. | Inline toegang geweigerd. | Geen. |
| ALT-004 | 6 | Breadcrumbcontext ontbreekt. | De hub toont de vaste fallbackbreadcrumb Home > Site Instellingen. | Niet van toepassing. | Geen. |
| ALT-005 | 8 | Er zijn geen zichtbare hubtegels door configuratiefout. | De pagina toont een veilige foutstaat en geen technische details. | Inline melding. | Geen. |
| ALT-006 | 9 | De beheerder gebruikt een directe URL naar een onderliggende pagina. | De onderliggende pagina voert eigen autorisatie uit; de hub wordt niet als autorisatiebron gebruikt. | Afhankelijk van doelpagina. | Geen vanuit deze usecase. |
9. Business rules
| ID | Regel |
|---|---|
| BR-UC-BEH-SITE-001-001 | De Site Instellingen-hub is een startpunt voor beheergebieden en geen gecombineerde formulierpagina. |
| BR-UC-BEH-SITE-001-002 | De hub toont minimaal tegels naar Frontpage, Popups beheren, Systeemberichten, Handige links & pagina’s, Features en Technische instellingen. |
| BR-UC-BEH-SITE-001-003 | De breadcrumb bevat minimaal Home > Site Instellingen. |
| BR-UC-BEH-SITE-001-004 | De hub voert geen directe mutatie uit in site-instellingen, contentblokken, popups, templates, features of notificaties. |
| BR-UC-BEH-SITE-001-005 | Elke onderliggende beheerpagina blijft verantwoordelijk voor eigen autorisatie, validatie, mutaties en geschiedenis. |
| BR-UC-BEH-SITE-001-006 | Hubtegels zijn codegedreven beheergebieden en worden niet vrij door beheerders aangemaakt. |
| BR-UC-BEH-SITE-001-007 | De hub moet duidelijk gescheiden blijven van de beheerder-frontpage. |
| BR-UC-BEH-SITE-001-008 | Niet-beschikbare beheergebieden mogen geen technische details lekken. |
10. Datavalidatie
| Veld / object | Validatie |
|---|---|
| Beheerdercontext | Moet server-side actief zijn. |
| Hubroute | Moet verwijzen naar de Site Instellingen-hub. |
| Breadcrumb | Moet Home en Site Instellingen bevatten. |
| Tegelset | Moet minimaal de zes vastgelegde beheergebieden bevatten wanneer beschikbaar. |
| Tegelroute | Moet een interne beheerroute zijn en geen losse externe URL. |
| Tegelstatus | Moet zichtbaar, verborgen of uitgeschakeld kunnen zijn volgens autorisatie en beschikbaarheid. |
| Hubreadmodel | Mag geen bewerkbare formulierwaarden voor onderliggende domeinen bevatten. |
| Foutweergave | Mag geen stacktraces of configuratiesleutels tonen. |
10.1 Autorisatie en server-side controles
| Controle | Uitwerking |
|---|---|
| Accountstatus | Controleer dat het interne account actief is voordat beheerdata wordt geladen. |
| Rolstatus | Controleer dat de beheerderrol actief is op het moment van het verzoek. |
| Clientstate | Gebruik browserstate uitsluitend als UI-hint en nooit als autorisatiebron. |
| Directe URL | Voer dezelfde controle uit bij directe routes als bij navigatie via menu of tegel. |
| Veilige response | Geef bij blokkade geen beheerdata, technische sleutels of querydetails terug. |
| Tegelset | Bepaal de vaste hubtegels server-side. |
| Breadcrumb | Lever Home en Site Instellingen als minimale breadcrumbcontext. |
| Geen formulierdata | Geef op de hub geen bewerkbare domeinvelden terug. |
11. Datamutaties en events
| Stap | Type | Entiteit / event | Mutatie |
|---|---|---|---|
| 1-9 | Database | Niet van toepassing | De hub wordt gelezen en opgebouwd zonder mutaties. |
| 1-9 | Audit | Niet van toepassing | Alleen openen van de hub is geen beheerwijziging. |
| 1-9 | Event | Niet van toepassing | Er wordt geen domeinevent gepubliceerd. |
12. Geen datamutaties
| Entiteit | Reden |
|---|---|
| SiteSettings | Instellingen worden niet gewijzigd op de hub. |
| ContentBlocks en StaticPageBlocks | Teksten worden niet bewerkt op de hub. |
| PopupDefinitions en SystemMessageTemplates | Templates worden niet bewerkt op de hub. |
| SiteFeatureToggles en SiteNotifications | Features en notificaties worden niet gewijzigd op de hub. |
| AdminAuditLog | Er ontstaat geen beheerwijziging door hubweergave. |
13. State diagram
Niet van toepassing. Het openen van de Site Instellingen-hub wijzigt geen persistent statusobject. De hub wordt read-only samengesteld op basis van beheerdercontext, codegedreven tegelset en routebeschikbaarheid.
14. Decision flow
15. Data lifecycle diagram
16. Sequence diagrammen
Hub openen
Hub zonder toegang
17. Popupverwijzingen
Deze usecase gebruikt geen popupregister-popup. Eventuele fout-, blokkade- of niet-beschikbaarmeldingen worden als inline melding, veilige redirect of statusweergave afgehandeld.
| PopupKey | Moment | Doel |
|---|---|---|
| Niet van toepassing | Geen bevestigings- of invoerpopup in deze usecase. | De flow bevat alleen route-, hub- of autorisatiegedrag. |
18. Afleiding naar Functioneel Ontwerp / Technisch Ontwerp / Software Requirements Specification
| Doeldocument | Afleiding |
|---|---|
| Functioneel Ontwerp | Beschrijft Site Instellingen als hubpagina met breadcrumb, vaste beheergebieden en duidelijke afbakening ten opzichte van frontpage en onderliggende beheerpagina’s. |
| Technisch Ontwerp | Technisch Ontwerp: domeinmodel en admin-eigenaarschap, security en configuratie, beheer en operatie en frontendcompositie beschrijven de technische uitwerking. Leg hubroute, server-side autorisatie, codegedreven tegelset, routebeschikbaarheid en read-only hubreadmodel vast. |
| Software Requirements Specification | Neem eisen op voor minimale tegels, breadcrumb, geen directe mutaties op de hub, autorisatiecontrole en veilige foutweergave. |
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-SITE-001-001 | SRS-RDM-001 SRS-RDM-004 SRS-ADM-001 AC-RDM-001 AC-RDM-004 AC-ADM-001 | Site Instellingen als hubpagina beschikbaar maken voor beheerders |
REQ-UC-BEH-SITE-001-002 | SRS-AUTH-001 SRS-ADM-001 AC-AUTH-001 AC-ADM-001 | De hub alleen tonen na server-side beheerderautorisatie |
REQ-UC-BEH-SITE-001-003 | SRS-RDM-001 SRS-RDM-003 SRS-RDM-007 SRS-MSG-001 SRS-ADM-001 SRS-POP-001 AC-RDM-001 AC-RDM-003 AC-RDM-007 AC-MSG-001 AC-ADM-001 AC-POP-001 | Op de hub minimaal tegels tonen naar Frontpage, Popups beheren, Systeemberichten, Handige links & pagina’s, Features en Technische instellingen |
REQ-UC-BEH-SITE-001-004 | SRS-ADM-001 AC-ADM-001 | Op de hub de breadcrumb Home > Site Instellingen tonen |
REQ-UC-BEH-SITE-001-005 | SRS-ADM-001 AC-ADM-001 | Op de hub geen onderliggende beheerinstellingen direct wijzigen |
REQ-UC-BEH-SITE-001-006 | SRS-ADM-001 AC-ADM-001 | De hub duidelijk afbakenen van de beheerder-frontpage |
REQ-UC-BEH-SITE-001-007 | SRS-AUTH-001 SRS-RDM-001 SRS-RDM-004 SRS-RDM-005 SRS-ADM-001 AC-AUTH-001 AC-RDM-001 AC-RDM-004 AC-RDM-005 AC-ADM-001 | Onderliggende beheerpagina’s eigen autorisatie laten uitvoeren |
REQ-UC-BEH-SITE-001-008 | SRS-ADM-001 SRS-NFR-SEC-001 AC-ADM-001 AC-NFR-SEC-001 | Niet-beschikbare hubtegels veilig verborgen of uitgeschakeld kunnen tonen |