1. Schermen - Leerling
Dit hoofdstuk bevat de schermdocumentatie voor de leerlingcontext. De documentatie wordt per view uitgewerkt. Generieke rol- en layoutaspecten die niet per view opnieuw beschreven hoeven te worden, kunnen hier éénmalig worden vastgelegd.
1.1 Afbakening en werkafspraken
- Per view wordt één afzonderlijk documentatieblok vastgelegd met een eigen scherm-ID.
- 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.
- De onderdelen hoofdmenu, berichteningang, gebruikersmenu en footer worden niet onnodig volledig per view herhaald wanneer zij generiek zijn beschreven.
- 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 |
|---|---|---|---|---|---|
| LLN-MENU-01 | Start | LearnerHomeNavigation | Hoofdmenu-item | Opent de leerling-frontpage voor de actieve leerlingcontext. | Verwijst naar 02_frontpage; bij ontbrekende oefentoegang kan de lege-toegangvariant worden getoond. |
| LLN-MENU-02 | Categorieën | LearnerCategoryNavigation | Hoofdmenu-item | Toont uitsluitend categorieën en oefeningen die binnen het actieve niveau toegankelijk zijn. | Zichtbaarheid en inhoud volgen uit leerlingcontext, niveauautorisatie en actieve oefenconfiguratie. |
| LLN-MENU-03 | Geschiedenis | LearnerHistoryNavigation | Profielmenu-item | Opent de brede geschiedenisweergave voor afgeronde leerlingruns. | Verwijst naar 08_geschiedenis_alles. |
| LLN-MENU-04 | Gedeelde oefeningen | LearnerSharedExercisesNavigation | Profielmenu-item | Opent het overzicht met ontvangen gedeelde oefeningen wanneer dit voor de leerling relevant is. | Verwijst naar 09_gedeelde_oefening_overzicht; zichtbaarheid is afhankelijk van ontvangen, zichtbare gedeelde oefeningen. |
1.3 Berichteningang en gebruikersmenu
| Element-ID | Zichtbaar label | Technische naam | Type | Doel / beschrijving | Navigatie / opmerking |
|---|---|---|---|---|---|
| LLN-HDR-01 | Berichten | LearnerMessagesNavigation | Headeractie / icoon | Opent het generieke berichtenoverzicht vanuit leerlingcontext. | Verwijst naar ../generiek/02_berichten_overzicht; badgegedrag kan tijdens actieve oefenruns visueel worden begrensd. |
| LLN-HDR-02 | Avatar / profielmenu | LearnerUserMenuTrigger | Headeractie | Opent het gebruikersmenu van de ingelogde leerling. | Biedt onder meer profiel, voorkeuren, geschiedenis, gedeelde oefeningen en uitloggen waar van toepassing. |
| LLN-HDR-03 | Actief niveau | LearnerActiveLevelDisplay | Contextweergave | Toont het actieve niveau of de toestand waarin nog geen oefentoegang beschikbaar is. | Waarde wordt afgeleid uit leerlingcontext en niveauautorisatie; niet handmatig invoerbaar op deze pagina. |
1.4 Footer en placeholderwaarden
| Placeholder-ID | Gebied | Placeholdernaam | Technische naam | Doel / beschrijving | Verwachte bron | Opmerking |
|---|---|---|---|---|---|---|
| LLN-FOOT-01 | Footer | OefenHub beschrijving | LearnerFooterBrandDescription | Korte uitleg over OefenHub binnen leerlingcontext. | Contentbeheer / vaste footercontent | Gedeeld met generieke paginaschil waar passend. |
| LLN-FOOT-02 | Footer | Leerling-snelkoppelingen | LearnerFooterQuickLinks | Snelle links naar leerlingstart, oefenen, geschiedenis of gedeelde oefeningen. | Routering en rolcontext | Alleen links tonen die binnen de actieve leerlingcontext bruikbaar zijn. |
| LLN-FOOT-03 | Footer | Copyrightjaar | LearnerFooterCopyrightYear | Toont het jaartal in de footer. | Systeemdatum of configuratie | Voor mockups is een jaartal voorbeelddata. |
1.5 Technische koppeling
Voor technische uitwerking van leerlingnavigatie, context en paginaschil zijn vooral relevant:
- 04 Identiteit, authenticatie en rolcontext voor leerlingcontext en rolactivatie.
- 05 Autorisatie, policies en server-side contextcontrole voor server-side begrenzing van routes, menu-items en zichtbare leerlingdata.
- 08 Oefencatalogus, niveaus, categorieën, oefeningen en modules voor toegankelijke categorieën, niveaus en actieve oefeningen.
- 10 Oefenruns, voortgang, resultaten, statistieken en PDF-brondata voor leerlingruns, hervatten, geschiedenis en statistieken.
- 17 Readmodels, tellers, badges, caching en materialisatie voor afgeleide leerlingoverzichten, badges en tellers.
- 24 Frontend, Blazor, routing, state en componentopbouw voor header, footer, routing, state en responsieve schermopbouw.