12. Over OefenHub
12.1 Schermafbeelding
12.2 Scherm meta data
| Veld | Waarde |
|---|---|
| Scherm-ID | SCH-GEN-12-01 |
| Schermnaam | Over OefenHub |
| Doelgroep / onderdeel | Generiek / publieke vaste pagina |
| Bronbestand | oefenhub_generiek_10_over_oefenhub_V1_8.html |
| Mockupversie | V1.8 |
| Screenshotbestand | oefenhub_generiek_10_over_oefenhub_V1_8.png |
| Processtap / context | Publieke informatiepagina waarop bezoekers en gebruikers kunnen lezen wat OefenHub is, voor wie de applicatie bedoeld is en welk uitgangspunt achter de leeromgeving ligt. |
| Documentatiestatus | Uitgewerkt op basis van HTML-mockup, PNG-screenshot, Functioneel Ontwerp, Technisch Ontwerp, Software Requirements Specification en ondersteunende documentatie. |
| Opmerkingen | Header, hamburgermenu, inlog-/registratie-ingangen en footer vallen buiten de inhoudelijke scope van dit schermdocument. De zichtbare paginablokken zijn publieke vaste-pagina-inhoud; de tekstinhoud is beheerbaar, terwijl structuur, volgorde en layout codegedreven blijven. |
| Route / URL-patroon | Publieke vaste-paginaroute voor Over OefenHub, bijvoorbeeld /over-oefenhub binnen de vaste-pagina-routering. |
| Autorisatie / vereiste rol-context | Publiek toegankelijk; geen ingelogde gebruiker of actieve rolcontext vereist om de pagina te bekijken. Beheer van de tekstinhoud is uitsluitend toegestaan voor bevoegde beheerders via Site Instellingen / Handige links & pagina’s. |
| Primair domeinobject / hoofdentiteit | ContentBlocks met DomainType = StaticPage, ContextType = Public en codevaste ReferenceKey-waarden voor de zichtbare paginablokken. |
| Gerelateerde schermen / navigatie | 13_privacybeleid, 14_contact, beheerderpagina Handige links & pagina’s. |
| Data-karakter | Publieke, tekstuele contentweergave; inhoud beheerbaar via contentblokmodel, geen gebruikersspecifieke of sessieafhankelijke data. |
12.3 Functionele beschrijving
De pagina Over OefenHub is een publieke vaste informatiepagina. De pagina legt in begrijpelijke taal uit wat OefenHub doet, voor welke doelgroepen de applicatie bedoeld is en waarom de applicatie is opgezet rond oefenen, herhalen, voortgang en rolgerichte ondersteuning.
De pagina is bedoeld voor bezoekers die nog niet zijn ingelogd én voor gebruikers die later vanuit footer- of navigatielinks terug willen lezen wat OefenHub inhoudelijk beoogt. Het scherm bevat geen formulieren, geen persoonlijke gegevens, geen accountacties en geen rolgebonden interacties.
12.3.1 Interpretatie van mockupwaarden
De mockup toont concrete tekstblokken zoals Oefenen, herhalen en begrijpen op één plek, Voor leerlingen, Voor docenten, Voor ouders en verzorgers, Waarom OefenHub bestaat en Voor wie OefenHub bedoeld is. Deze teksten beschrijven de functionele inhoudsplekken van de pagina.
De zichtbare tekst mag niet als onveranderlijke hardcoded productie-inhoud worden behandeld. Voor vaste publieke pagina’s is alle zichtbare tekstuele inhoud beheerbaar via het contentblokmodel. De structuur van de pagina, de volgorde van de blokken, de kaartlayout, de rolpunten en de visuele plaatsing blijven codegedreven.
12.3.2 Hoofdopbouw
De inhoud van de pagina bestaat uit de volgende hoofdonderdelen:
- een breadcrumb binnen de hoofdinhoud;
- een groot hero-/introblok met titel en toelichtende tekst;
- drie compacte doelgroepkaarten binnen het hero-blok;
- een inhoudskaart Waarom OefenHub bestaat;
- een inhoudskaart Voor wie OefenHub bedoeld is.
Header, hamburgermenu en footer worden niet als onderdeel van dit schermdocument uitgewerkt. De breadcrumb wordt wel uitgewerkt, omdat deze binnen de hoofdinhoud van de vaste pagina staat.
12.3.3 Publieke vaste pagina
De pagina is publiek zichtbaar. Het systeem mag voor het lezen van deze pagina geen login, rolselectie of gebruikersrelatie vereisen. De pagina bevat ook geen gegevens die afhankelijk zijn van de ingelogde gebruiker.
Omdat de pagina publiek is, moet de tekst zorgvuldig en algemeen blijven. Er worden geen leerlingnamen, docentnamen, voortgangswaarden, relatiegegevens of andere persoonlijke gegevens getoond.
12.3.4 Beheerbaarheid van inhoud
De inhoud van Over OefenHub wordt functioneel gezien als vaste pagina-inhoud. Beheer vindt niet op deze publieke pagina zelf plaats, maar via de beheerpagina Handige links & pagina’s. Daar kan een beheerder de tekstuele inhoud van de bestaande blokken aanpassen.
Het beheer is beperkt tot zichtbare tekstuele velden zoals titels en teksten. Het toevoegen, verwijderen, verplaatsen of structureel aan-/uitzetten van blokken is geen functie van deze publieke pagina en valt ook niet onder de beheerbaarheid van de tekstinhoud. De code bepaalt welke blokken op de pagina bestaan en op welke plek zij worden gerenderd.
12.3.5 Contentblokken en fallbackgedrag
Per zichtbaar tekstblok wordt een codevaste contentreferentie gebruikt. De combinatie DomainType, ContextType en ReferenceKey bepaalt welk contentblok op welke plek in de pagina hoort.
Wanneer een verwacht contentblok niet beschikbaar is, mag de pagina geen technische fout of ontbrekende sleutel tonen. Het blok wordt dan niet geladen of wordt via de applicatielogica op een veilige, gebruikersvriendelijke manier afgehandeld. De gebruiker ziet nooit technische referenties zoals ReferenceKey, GUID’s of databasewaarden.
12.3.6 Veiligheid en rendering
Alle beheerde tekstinhoud wordt veilig gerenderd. Vrije HTML, JavaScript of actieve inhoud uit beheerbare tekstvelden mag niet ongefilterd in de publieke pagina verschijnen. Tekst wordt veilig geëncodeerd of gesanitized volgens de centrale contentrenderingregels.
12.3.7 Responsief gedrag
De pagina ondersteunt desktop- en tabletweergave. De drie doelgroepkaarten staan bij voldoende breedte naast elkaar en stapelen bij smallere breedtes onder elkaar. De twee inhoudskaarten worden bij voldoende breedte naast elkaar getoond en bij minder ruimte onder elkaar geplaatst. De inhoudsvolgorde blijft daarbij gelijk.
12.4 UI-elementen en velddefinities
| Element-ID | Type | GUI-verwijzing | Omschrijving | Zichtbaar label | Opmerking | Technische naam |
|---|---|---|---|---|---|---|
| SCH-GEN-12-01-N01 | A | Breadcrumb | Navigatiepad binnen de publieke vaste pagina. | Home > Over OefenHub | Headernavigatie valt buiten scope; deze breadcrumb staat in de hoofdinhoud. | AboutPageBreadcrumb |
| SCH-GEN-12-01-S01 | S | Hoofdinhoud | Codegedreven hoofdcontainer voor de publieke pagina-inhoud. | Over OefenHub | Bevat alleen de pagina-inhoud; header en footer vallen buiten scope. | AboutPageContentShell |
| SCH-GEN-12-01-S02 | S | Hero-blok | Groot introductieblok bovenaan de pagina. | Oefenen, herhalen en begrijpen op één plek | Titel en tekst zijn beheerbare content; positie en layout zijn codegedreven. | AboutHeroSection |
| SCH-GEN-12-01-F01 | F | Hero-blok — titel | Hoofdtitel van de pagina. | Oefenen, herhalen en begrijpen op één plek | Beheerbaar als tekstueel contentblok. | AboutHeroTitle |
| SCH-GEN-12-01-F02 | F | Hero-blok — introductietekst | Korte uitleg over het doel van OefenHub. | OefenHub helpt kinderen om schoolvakken spelenderwijs te oefenen... | Beheerbare tekst; geen gebruikersspecifieke data. | AboutHeroText |
| SCH-GEN-12-01-S03 | S | Hero-blok — doelgroepkaarten | Groep met drie compacte doelgroepkaarten. | Voor leerlingen / Voor docenten / Voor ouders en verzorgers | Kaartenstructuur is codegedreven; teksten zijn beheerbaar. | AboutAudienceCardsSection |
| SCH-GEN-12-01-F03 | F | Doelgroepkaart leerlingen — titel | Titel van de leerlingkaart. | Voor leerlingen | Beheerbare titel binnen vaste kaartpositie. | AboutStudentCardTitle |
| SCH-GEN-12-01-F04 | F | Doelgroepkaart leerlingen — tekst | Uitleg voor leerlingen. | Oefeningen sluiten aan op niveau, categorie en technische oefenvorm... | Beheerbare tekst. | AboutStudentCardText |
| SCH-GEN-12-01-F05 | F | Doelgroepkaart docenten — titel | Titel van de docentenkaart. | Voor docenten | Beheerbare titel binnen vaste kaartpositie. | AboutTeacherCardTitle |
| SCH-GEN-12-01-F06 | F | Doelgroepkaart docenten — tekst | Uitleg voor docenten. | Docenten richten niveaus en inhoud in... | Beheerbare tekst. | AboutTeacherCardText |
| SCH-GEN-12-01-F07 | F | Doelgroepkaart ouders/verzorgers — titel | Titel van de ouder-/voogdkaart. | Voor ouders en verzorgers | Gebruikerslabel in de mockup gebruikt “verzorgers”; functioneel domein gebruikt ook ouder/voogd. | AboutGuardianCardTitle |
| SCH-GEN-12-01-F08 | F | Doelgroepkaart ouders/verzorgers — tekst | Uitleg voor ouders en voogden. | Ouders en voogden kunnen betrokken blijven via resultaten... | Beheerbare tekst. | AboutGuardianCardText |
| SCH-GEN-12-01-S04 | S | Inhoudskaart links | Kaart met uitleg over de aanleiding en bestaansreden van OefenHub. | Waarom OefenHub bestaat | Beheerbaar tekstblok binnen vaste kaartpositie. | AboutWhySection |
| SCH-GEN-12-01-F09 | F | Inhoudskaart links — titel | Titel van de uitlegkaart. | Waarom OefenHub bestaat | Beheerbare titel. | AboutWhyTitle |
| SCH-GEN-12-01-F10 | F | Inhoudskaart links — tekst | Inhoudelijke uitleg over herhaling, structuur, feedback en rolcontexten. | Leren vraagt om herhaling, structuur en duidelijke feedback... | Beheerbare tekst; meerdere alinea’s mogelijk. | AboutWhyText |
| SCH-GEN-12-01-S05 | S | Inhoudskaart rechts | Kaart met uitleg over de doelgroepen van OefenHub. | Voor wie OefenHub bedoeld is | Beheerbaar tekstblok binnen vaste kaartpositie. | AboutAudienceSection |
| SCH-GEN-12-01-F11 | F | Inhoudskaart rechts — titel | Titel van de doelgroepkaart. | Voor wie OefenHub bedoeld is | Beheerbare titel. | AboutAudienceTitle |
| SCH-GEN-12-01-F12 | F | Inhoudskaart rechts — tekst | Uitleg over leerlingen, docenten, ouders/verzorgers en publieke informatie. | OefenHub is gemaakt voor kinderen die leerstof willen oefenen... | Beheerbare tekst; meerdere alinea’s mogelijk. | AboutAudienceText |
12.5 Waardelagen
| Element-ID | GUI-verwijzing | Zichtbaar label | Technische naam | Databron | Waardebron | Datatype | Bewerkbaar | Validatie / regel |
|---|---|---|---|---|---|---|---|---|
| SCH-GEN-12-01-N01 | Breadcrumb | Home > Over OefenHub | AboutPageBreadcrumb | Routeconfiguratie vaste pagina’s | Afgeleid uit publieke route | Navigation label | Nee | Mag geen technische route-id of GUID tonen. |
| SCH-GEN-12-01-S01 | Hoofdinhoud | Over OefenHub | AboutPageContentShell | Codegedreven vaste-pagina-renderer | Runtime samenstelling van vaste pagina | Composite | Nee | Publiek renderbaar zonder login of rolcontext. |
| SCH-GEN-12-01-F01 | Hero-blok — titel | Oefenen, herhalen en begrijpen op één plek | AboutHeroTitle | ContentBlocks met DomainType = StaticPage, ContextType = Public, ReferenceKey = AboutOefenHub.Hero | Database / beheerbare tekstinhoud | String | Ja, via beheer | Titel veilig encoden; layout blijft codegedreven. |
| SCH-GEN-12-01-F02 | Hero-blok — introductietekst | OefenHub helpt kinderen om schoolvakken spelenderwijs te oefenen... | AboutHeroText | ContentBlocks met DomainType = StaticPage, ContextType = Public, ReferenceKey = AboutOefenHub.Hero | Database / beheerbare tekstinhoud | Rich text light / tekst | Ja, via beheer | Geen actieve HTML of JavaScript renderen; tekst mag geen persoonsgegevens bevatten. |
| SCH-GEN-12-01-F03 | Doelgroepkaart leerlingen — titel | Voor leerlingen | AboutStudentCardTitle | ContentBlocks, ReferenceKey = AboutOefenHub.StudentCard | Database / beheerbare tekstinhoud | String | Ja, via beheer | Titel hoort bij vaste kaartpositie. |
| SCH-GEN-12-01-F04 | Doelgroepkaart leerlingen — tekst | Oefeningen sluiten aan op niveau, categorie en technische oefenvorm... | AboutStudentCardText | ContentBlocks, ReferenceKey = AboutOefenHub.StudentCard | Database / beheerbare tekstinhoud | Rich text light / tekst | Ja, via beheer | Tekst veilig renderen; geen leerlingcontext of actuele voortgang tonen. |
| SCH-GEN-12-01-F05 | Doelgroepkaart docenten — titel | Voor docenten | AboutTeacherCardTitle | ContentBlocks, ReferenceKey = AboutOefenHub.TeacherCard | Database / beheerbare tekstinhoud | String | Ja, via beheer | Titel hoort bij vaste kaartpositie. |
| SCH-GEN-12-01-F06 | Doelgroepkaart docenten — tekst | Docenten richten niveaus en inhoud in... | AboutTeacherCardText | ContentBlocks, ReferenceKey = AboutOefenHub.TeacherCard | Database / beheerbare tekstinhoud | Rich text light / tekst | Ja, via beheer | Tekst algemeen houden; geen docentdata of beheerdata tonen. |
| SCH-GEN-12-01-F07 | Doelgroepkaart ouders/verzorgers — titel | Voor ouders en verzorgers | AboutGuardianCardTitle | ContentBlocks, ReferenceKey = AboutOefenHub.GuardianCard | Database / beheerbare tekstinhoud | String | Ja, via beheer | Label is publieke tekst; domeinrelaties worden hier niet geladen. |
| SCH-GEN-12-01-F08 | Doelgroepkaart ouders/verzorgers — tekst | Ouders en voogden kunnen betrokken blijven via resultaten... | AboutGuardianCardText | ContentBlocks, ReferenceKey = AboutOefenHub.GuardianCard | Database / beheerbare tekstinhoud | Rich text light / tekst | Ja, via beheer | Tekst algemeen houden; geen kind- of oudergegevens tonen. |
| SCH-GEN-12-01-F09 | Waarom-kaart — titel | Waarom OefenHub bestaat | AboutWhyTitle | ContentBlocks, ReferenceKey = AboutOefenHub.Why | Database / beheerbare tekstinhoud | String | Ja, via beheer | Titel veilig renderen. |
| SCH-GEN-12-01-F10 | Waarom-kaart — tekst | Leren vraagt om herhaling, structuur en duidelijke feedback... | AboutWhyText | ContentBlocks, ReferenceKey = AboutOefenHub.Why | Database / beheerbare tekstinhoud | Rich text light / tekst | Ja, via beheer | Meerdere alinea’s toegestaan; geen actieve inhoud renderen. |
| SCH-GEN-12-01-F11 | Doelgroepen-kaart — titel | Voor wie OefenHub bedoeld is | AboutAudienceTitle | ContentBlocks, ReferenceKey = AboutOefenHub.Audience | Database / beheerbare tekstinhoud | String | Ja, via beheer | Titel veilig renderen. |
| SCH-GEN-12-01-F12 | Doelgroepen-kaart — tekst | OefenHub is gemaakt voor kinderen die leerstof willen oefenen... | AboutAudienceText | ContentBlocks, ReferenceKey = AboutOefenHub.Audience | Database / beheerbare tekstinhoud | Rich text light / tekst | Ja, via beheer | Meerdere alinea’s toegestaan; geen gebruikersspecifieke gegevens tonen. |
12.6 Schermtrace naar SRS en acceptatiecriteria
De onderstaande tabel legt per schermrequirement de koppeling naar het centrale schermrequirements-trace-register, SRS-requirements en acceptatiecriteria vast. De normatieve requirementtekst staat in de SRS; dit schermdocument beschrijft alleen de lokale schermcontext.
Deze tabel bevat alleen schermtraceability. De normatieve requirementtekst en acceptatiecriteria staan centraal in de SRS.
| Schermrequirement | Dekt | Schermcontext |
|---|---|---|
REQ-SCH-GEN-12-01-01 | SRS-CNT-003 AC-CNT-003 | De publieke vaste pagina Over OefenHub kunnen tonen zonder dat de bezoeker hoeft in te loggen |
REQ-SCH-GEN-12-01-02 | SRS-CNT-003 AC-CNT-003 | De pagina Over OefenHub mag geen gebruikersspecifieke, rolgebonden, relatiegebonden of voortgangsgegevens tonen |
REQ-SCH-GEN-12-01-03 | SRS-CNT-003 AC-CNT-003 | Binnen de hoofdinhoud een breadcrumb tonen waarmee duidelijk is dat de gebruiker zich op Over OefenHub bevindt |
REQ-SCH-GEN-12-01-04 | SRS-CNT-003 AC-CNT-003 | Een hero-/introblok tonen met een beheerbare titel en beheerbare introductietekst |
REQ-SCH-GEN-12-01-05 | SRS-CNT-003 AC-CNT-003 | Binnen het hero-blok drie vaste doelgroepkaarten kunnen tonen voor leerlingen, docenten en ouders/voogden of verzorgers |
REQ-SCH-GEN-12-01-06 | SRS-CNT-003 AC-CNT-003 | Een inhoudskaart Waarom OefenHub bestaat kunnen tonen met beheerbare titel en beheerbare tekst |
REQ-SCH-GEN-12-01-07 | SRS-CNT-003 AC-CNT-003 | Een inhoudskaart Voor wie OefenHub bedoeld is kunnen tonen met beheerbare titel en beheerbare tekst |
REQ-SCH-GEN-12-01-08 | SRS-CNT-003 AC-CNT-003 | De tekstuele inhoud van de vaste pagina Over OefenHub via het uniforme contentblokmodel beheerbaar zijn met DomainType = StaticPage en ContextType = Public |
REQ-SCH-GEN-12-01-09 | SRS-CNT-003 AC-CNT-003 | De structurele blokopbouw, volgorde, plaatsing en styling van Over OefenHub codegedreven blijven en geen door de publieke gebruiker worden aangepast |
REQ-SCH-GEN-12-01-10 | SRS-CNT-003 AC-CNT-003 | Beheer van titels en teksten voor Over OefenHub mag alleen plaatsvinden via de bevoegde beheerfunctie voor vaste pagina’s |
REQ-SCH-GEN-12-01-11 | SRS-CNT-003 AC-CNT-003 | Beheerbare tekstinhoud veilig renderen en mag geen vrije actieve HTML, JavaScript of vergelijkbare uitvoerbare inhoud tonen |
REQ-SCH-GEN-12-01-12 | SRS-AUTH-004 SRS-CNT-003 AC-AUTH-004 AC-CNT-003 | Het systeem mag ontbrekende contentblokrecords niet als technische fout, sleutelnaam, GUID of databasewaarde aan de publieke gebruiker tonen |
REQ-SCH-GEN-12-01-13 | SRS-CNT-003 AC-CNT-003 | Responsief blijven: doelgroepkaarten en inhoudskaarten mogen bij smallere breedtes onder elkaar stapelen zonder inhoud te verbergen |
REQ-SCH-GEN-12-01-14 | SRS-CNT-003 AC-CNT-003 | Header, hamburgermenu, inlog-/registratie-ingangen en footer geen als inhoudelijke onderdelen van deze schermdocumentatie worden beschouwd; zij worden via algemene layout- en navigatiedocumentatie of footerbeheer beschreven |
12.7 Technische koppeling
Voor technische uitwerking zijn vooral relevant:
- 04 Identiteit, authenticatie en rolcontext voor publieke toegang zonder ingelogde rolcontext.
- 06 Domeinmodel en datamodel-overzicht voor de positionering van beheerbare vaste-pagina-content binnen het admin-domein.
- 07 Databaseontwerp, migraties, seeddata en constraints voor contentblokken, seeddata en het niet stilzwijgend overschrijven van beheerbare content.
- 11 Rolflows technisch voor beheerflows rond vaste pagina's, footercontent en handige links.
- 24 Frontend, Blazor, routing, state en componentopbouw voor publieke routing, footerlinks en veilige contentrendering.