1. Schermen - Generiek
Dit hoofdstuk bevat de overkoepelende schermdocumentatie voor generieke OefenHub-schermen. Generieke schermen zijn rol-overstijgende schermen of publieke schermen die niet specifiek bij leerling, docent, ouder/voogd of beheerder horen. Per view wordt de detaildocumentatie apart uitgewerkt; afspraken die voor meerdere generieke views gelden, worden hier éénmalig vastgelegd.
1.1 Afbakening en werkafspraken
- Per generieke view wordt één afzonderlijk documentatieblok vastgelegd met een eigen scherm-ID.
- De niet-ingelogde publieke frontpage is vastgelegd in
00_niet-ingelogden vormt de publieke/-ingang zonder breadcrumb, demo-context of no-role-tekst. - De afbakening van een view loopt in beginsel van header tot footer. Wanneer een scherm aanvullend een breadcrumb bevat, valt die breadcrumb binnen dezelfde view-afbakening.
- Frontpages van specifieke rollen vallen niet onder deze generieke map, maar onder de betreffende rolcontext.
- Publieke pagina's zoals
Over OefenHub,PrivacybeleidenContactgebruiken een afwijkende niet-ingelogde headercontext. Die afwijking is bewust en hoeft niet gelijkgetrokken te worden met ingelogde profiel- of berichtenschermen. - Profielgerelateerde generieke schermen zoals
Profiel,Voorkeuren,Toegankelijkheid,RelatiesenMeld een probleemzijn beschikbaar vanuit het gebruikersmenu, maar kunnen per rol inhoudelijk andere data tonen. - Mockups worden gebruikt voor structuur, zichtbare opbouw en viewvarianten. Technische elementnamen worden functiegedreven en consistent bepaald, niet letterlijk uit de mockupnaamgeving overgenomen.
- Zichtbare voorbeeldwaarden uit mockups worden beschouwd als dynamische voorbeelddata, tenzij in de latere schermuitwerking expliciet anders is vastgelegd.
1.2 Menu-items
| Element-ID | Zichtbaar label | Technische naam | Type | Doel / verantwoordelijkheid | Navigatie / opmerking |
|---|---|---|---|---|---|
| GEN-MENU-01 | Berichten | MessagesNavigation | Headeractie / icoon | Opent het generieke berichtenoverzicht. | Verwijst naar 02_berichten_overzicht. |
| GEN-MENU-02 | Profiel | ProfileNavigation | Gebruikersmenu-item | Opent de profielpagina van de ingelogde gebruiker. | Verwijst naar 10_profiel. |
| GEN-MENU-03 | Voorkeuren | PreferencesNavigation | Gebruikersmenu-item | Opent algemene gebruikersvoorkeuren. | Verwijst naar 09_voorkeuren. |
| GEN-MENU-04 | Toegankelijkheid | AccessibilityNavigation | Gebruikersmenu-item | Opent weergave- en toegankelijkheidsinstellingen. | Verwijst naar 08_toegankelijk. |
| GEN-MENU-05 | Relaties | RelationsNavigation | Gebruikersmenu-item | Opent het relatieoverzicht van de gebruiker. | Verwijst naar 07_relaties; inhoud is afhankelijk van rol en relaties. |
| GEN-MENU-06 | Meld een probleem | ReportProblemNavigation | Gebruikersmenu-item | Opent het generieke scherm om een probleem te melden. | Verwijst naar 06_meld_een_probleem. |
| GEN-MENU-07 | Uitloggen | LogoutAction | Gebruikersmenu-actie | Meldt de gebruiker af. | Wordt alleen getoond in ingelogde context. |
| GEN-MENU-08 | Inloggen | LoginNavigation | Publiek menu-item | Start het inlogproces. | Alleen op publieke/niet-ingelogde pagina's; moet volledige documentnavigatie naar de authroute starten. |
| GEN-MENU-09 | Registreren | RegisterNavigation | Publiek menu-item | Start het registratieproces. | Alleen op publieke/niet-ingelogde pagina's wanneer registratie beschikbaar is; mag geen dode route tonen. |
| GEN-MENU-10 | Over OefenHub | AboutNavigation | Footerlink / publieke navigatie | Opent de publieke uitlegpagina over OefenHub. | Verwijst naar 11_over_oefenhub. |
| GEN-MENU-11 | Privacybeleid | PrivacyNavigation | Footerlink / publieke navigatie | Opent de publieke privacyinformatie. | Verwijst naar 12_privacybeleid. |
| GEN-MENU-12 | Contact | ContactNavigation | Footerlink / publieke navigatie | Opent de contactpagina. | Verwijst naar 13_contact. |
1.3 Berichteningang en gebruikersmenu
| Element-ID | Zichtbaar label | Technische naam | Type | Doel / beschrijving | Navigatie / opmerking |
|---|---|---|---|---|---|
| GEN-HDR-01 | ✉️ / berichtenbadge | MessageInboxButton | Headeractie | Toont de ingang naar berichten en kan een badge met ongelezen aantal tonen. | Verwijst naar 02_berichten_overzicht; badgewaarde is dynamisch. |
| GEN-HDR-02 | Avatar / initialen | UserMenuTrigger | Headeractie | Opent het gebruikersmenu van de ingelogde gebruiker. | Menu start standaard gesloten. |
| GEN-HDR-03 | Gebruikersmenu | UserProfileMenu | Dropdownmenu | Bundelt profiel, voorkeuren, toegankelijkheid, relaties, probleem melden en uitloggen. | Menu-inhoud is generiek, maar zichtbaarheid kan per rol of context verschillen. |
| GEN-HDR-04 | ☰ | PublicMenuTrigger | Headeractie | Opent het publieke menu op niet-ingelogde pagina's. | Alleen op publieke pagina's zoals Over OefenHub, Privacybeleid en Contact. |
| GEN-HDR-05 | Inloggen / Registreren | PublicAccountMenu | Dropdownmenu | Biedt publieke accountacties aan. | Geen rolcontext aanwezig. |
1.4 Footer en placeholderwaarden
| Placeholder-ID | Gebied | Placeholdernaam | Technische naam | Doel / beschrijving | Verwachte bron | Opmerking |
|---|---|---|---|---|---|---|
| GEN-FOOT-01 | Footer | OefenHub beschrijving | FooterBrandDescription | Korte uitleg over OefenHub. | Contentbeheer / vaste footercontent | Tekst kan per publieke of ingelogde context licht verschillen. |
| GEN-FOOT-02 | Footer | Handige links | FooterUtilityLinks | Verwijzingen naar algemene informatiepagina's. | Routering / contentconfiguratie | Bijvoorbeeld Over OefenHub, Contact, Privacybeleid. |
| GEN-FOOT-03 | Footer | Snel naar | FooterQuickLinks | Snelle links naar veelgebruikte ingelogde functies. | Rol- en contextconfiguratie | Alleen tonen wanneer de gebruiker is ingelogd of wanneer de link relevant is. |
| GEN-FOOT-04 | Footer | Starten | FooterPublicStartLinks | Links naar inloggen en registreren. | Publieke navigatieconfiguratie | Alleen relevant op niet-ingelogde pagina's. |
| GEN-FOOT-05 | Footer | Copyrightjaar | FooterCopyrightYear | Toont het jaartal in de footer. | Systeemdatum of configuratie | Voor mockups is 2026 voorbeelddata. |
1.5 Technische koppeling
Voor technische uitwerking van generieke navigatie, publieke pagina's en gebruikersmenu's zijn vooral relevant:
- 04 Identiteit, authenticatie en rolcontext voor het onderscheid tussen publieke, ingelogde en rolgebonden context.
- 05 Autorisatie, policies en server-side contextcontrole voor server-side begrenzing van profielmenu-items, routes en gebruikersacties.
- 13 Berichten, systeemberichten, notificaties en privéberichten voor de berichteningang en ongelezenindicatoren.
- 14 Meldingen, tickets en beheerafhandeling voor meldingenroutes en actie-indicatoren in het gebruikersmenu.
- 24 Frontend, Blazor, routing, state en componentopbouw voor header, footer, routering, profielmenu en responsieve paginaschil.