6. Leerlingen
6.1 Schermafbeelding
6.2 Scherm meta data
| Veld | Waarde |
|---|---|
| Scherm-ID | SCH-DOC-04-01 |
| Schermnaam | Leerlingen — Overzichtsview |
| Doelgroep / onderdeel | Docent |
| Bronbestand | oefenhub_docent_04_leerlingen_v1_9.html |
| Mockupversie | V1.9 |
| Screenshotbestand | oefenhub_docent_04_leerlingen_v1_9.png |
| Processtap / context | Overzicht van actieve docent-leerlingrelaties binnen de actieve docentcontext, inclusief zoeken, filteren, contextsamenvatting, geschiedenisroute en autorisatieroute. |
| Documentatiestatus | Uitgewerkt op basis van HTML-mockup, PNG-screenshot, Functioneel Ontwerp, Technisch Ontwerp, Software Requirements Specification en ondersteunende documentatie. |
| Opmerkingen | Generieke header, profielmenu, berichtenknop en footer worden niet opnieuw functioneel uitgewerkt op dit scherm. Deze pagina beschrijft alleen de schermspecifieke docentfunctionaliteit voor leerlingenbeheer. |
| Route / URL-patroon | Functioneel routepatroon: docentnavigatie > Leerlingen. |
| Autorisatie / vereiste rol-context | Ingelogde gebruiker met actieve rolcontext Teacher. De zichtbare gegevens worden beperkt tot actieve docent-leerlingrelaties van de huidige docent. |
| Primair domeinobject / hoofdentiteit | Actieve docent-leerlingrelatie (UserRelationships met relatietype TeacherStudent) en bijbehorende niveau-autorisaties (TeacherStudentLevelAccess). |
| Gerelateerde schermen / navigatie | 07_bekijk_geschiedenis, 08_online_overzicht, 10_autoriseer_leerling, 11_autoriseer_niveau, docent-oefenaanbod. |
6.3 Functionele beschrijving
Dit scherm toont het leerlingenoverzicht voor een docent. De pagina is bedoeld als compacte werkview om gekoppelde leerlingen terug te vinden, hun autorisatiestatus te beoordelen en door te klikken naar vervolgacties die altijd vanuit één geselecteerde leerling plaatsvinden.
De pagina toont uitsluitend leerlingen waarmee de ingelogde gebruiker zelf een actieve docent-leerlingrelatie heeft. Collaborators die op een niveau mogen meewerken, krijgen door die collaboratorstatus niet automatisch toegang tot deze leerlinglijst, leerlinggeschiedenis of autorisaties. Hiervoor blijft altijd een eigen actieve docent-leerlingrelatie nodig.
Bovenaan staat een introductieblok met uitleg over het doel van de pagina. Daaronder staat het blok Mijn leerlingen met zoek- en filtervelden. De lijst bestaat uit compacte leerlingkaarten. In de gesloten toestand zijn minimaal de naam van de leerling, een autorisatiebadge en de acties Geschiedenis en Autorisaties zichtbaar. Via de uitklapknop wordt aanvullende context getoond, zoals Laatst gezien en Actieve niveaus door jou. De leerlingenlijst mag visueel binnen het lijstblok scrollbaar zijn, zoals in de mockup, maar functioneel blijft paginering de primaire techniek voor grotere aantallen leerlingen.
De rechterkolom toont een samenvattingskaart met aantallen voor gekoppelde leerlingen, leerlingen die nog geen actieve niveau-autorisatie hebben en leerlingen met minimaal één actieve niveau-autorisatie. Deze samenvatting geeft standaard contexttotalen over de volledige actieve docentcontext; zoeken en filteren beïnvloeden primair de lijst en de paginering, niet deze contextsamenvatting. Daarnaast bevat de rechterkolom korte routes naar verwante docenttaken en informatieve aandachtspunten over geschiedenis, live meekijken en relatiebeheer.
Procesverloop
- De docent opent de pagina vanuit de docentnavigatie via Leerlingen.
- Het systeem bepaalt de actieve docentcontext van de ingelogde gebruiker.
- Het systeem haalt actieve docent-leerlingrelaties op waarbij de huidige gebruiker als docent betrokken is.
- Per leerling wordt de actieve niveau-autorisatie binnen deze docentcontext afgeleid.
- De docent kan de lijst verfijnen met zoeken, filteren op niveau en filteren op autorisatiestatus.
- De lijstresultaten worden na zoeken en filteren verdeeld over pagina's; visueel scrollen binnen het lijstblok is alleen een presentatiedetail.
- De docent kiest per leerling voor Geschiedenis of Autorisaties.
- Het vervolggescherm ontvangt de geselecteerde leerling en de actieve docentcontext, zodat daar opnieuw dezelfde autorisatiegrenzen kunnen worden afgedwongen.
Autorisatie- en privacyregels
- Alleen actieve docent-leerlingrelaties van de huidige docent worden getoond.
- Leerlingen van andere docenten worden niet getoond.
- Docent-docentrelaties en collaboratorrechten geven geen toegang tot leerlingen, geschiedenis of live meekijken.
- De docent ziet op dit scherm geen informatie over andere docenten die mogelijk ook aan dezelfde leerling gekoppeld zijn.
- E-mailadres hoeft niet zichtbaar te zijn in de leerlingkaart. Het mag wel als zoekbron worden gebruikt zolang de leerling via een actieve docent-leerlingrelatie binnen de eigen docentcontext valt. Deze zoekmogelijkheid volgt uit de mockup-placeholder Zoek op leerlingnaam of e-mailadres, maar maakt het e-mailadres geen standaard zichtbaar veld.
- Ontkoppelen of een ontkoppelverzoek starten gebeurt niet op deze pagina, maar via de relatieflow.
- Live meekijken wordt niet op deze pagina gestart. Daarvoor bestaat het aparte scherm Online overzicht.
Leegstaten en foutscenario's
- Wanneer de docent geen actieve docent-leerlingrelaties heeft, toont het scherm een lege lijst met een korte uitleg dat er nog geen gekoppelde leerlingen zijn.
- Wanneer zoeken of filteren geen resultaten oplevert, toont het scherm een lege resultaatmelding binnen Mijn leerlingen en blijven de filtervelden beschikbaar.
- Wanneer een leerling wel gekoppeld is maar nog geen actieve niveau-autorisatie heeft, blijft de leerling zichtbaar met badge Te autoriseren.
- Wanneer de docent op Geschiedenis klikt voor een leerling zonder afgeronde resultaten binnen de eigen docentcontext, opent de geschiedenisview met een lege, maar geldige resultaatset.
- Wanneer de relatie of autorisatie tussen laden en klikken is ingetrokken, moet het vervolggescherm de actuele autorisatie opnieuw controleren en zo nodig een gebruikersvriendelijke melding tonen.
6.4 UI-elementen en velddefinities
| Element-ID | Type | GUI-verwijzing | Omschrijving | Zichtbaar label | Opmerking | Technische naam |
|---|---|---|---|---|---|---|
| SCH-DOC-04-01-S01 | Section | Kruimelpad boven de pagina | Toont de functionele positie van de gebruiker binnen de docentomgeving. | Home > Leerlingen | Navigatiecomponent is generiek, maar de huidige paginawaarde is schermspecifiek. | TeacherStudentsBreadcrumbSection |
| SCH-DOC-04-01-S02 | Section | Introblok bovenaan | Legt uit dat de pagina bedoeld is voor actieve docent-leerlingrelaties, zoeken, filteren en vervolgacties. | Leerlingen | Tekst is informatief; geen mutatie. | TeacherStudentsIntroSection |
| SCH-DOC-04-01-S03 | Section | Hoofdblok met leerlingenlijst | Container voor zoekveld, filters, leerlingkaarten en paginering. | Mijn leerlingen | Primaire werksectie van het scherm. | TeacherStudentsListSection |
| SCH-DOC-04-01-M01 | Message | Intro onder Mijn leerlingen | Waarschuwt dat alleen de eigen docentcontext zichtbaar is en collaborators geen automatische leerlingtoegang krijgen. | Je ziet hier alleen jouw eigen docentcontext. | Ondersteunt privacy- en autorisatieverwachting van de docent. | TeacherContextNoticeMessage |
| SCH-DOC-04-01-F01 | Field | Zoekveld in toolbar | Vrij zoekveld om leerlingen binnen de eigen docentcontext te filteren op naam en eventueel e-mailadres. | Zoek op leerlingnaam of e-mailadres | Zoeken op e-mailadres volgt uit de mockup; het e-mailadres hoeft niet zichtbaar te worden in de leerlingkaart. | StudentSearchQuery |
| SCH-DOC-04-01-F02 | Field | Eerste select in toolbar | Filtert de lijst op een specifiek docentniveau of toont alle niveaus. | Alle niveaus | Opties komen uit actieve niveaus van de huidige docentcontext. | TeacherLevelFilter |
| SCH-DOC-04-01-F03 | Field | Tweede select in toolbar | Filtert de lijst op autorisatiestatus. | Alle autorisaties | Minimale waarden: Alle autorisaties, Nog te autoriseren, Met actieve niveau(s). | AuthorizationStatusFilter |
| SCH-DOC-04-01-T01 | Table/Card list | Lijst met leerlingkaarten | Toont per leerling een compacte kaart met naam, statusbadge, acties en uitklapbare details. | Leerlingenlijst | Visueel kaartmodel; het blok mag scrollbaar zijn, maar functioneel blijft dit een gepagineerde lijst. | TeacherStudentCardList |
| SCH-DOC-04-01-F04 | Field | Initiaal/avatar links in leerlingkaart | Visuele herkenning van de leerling op basis van profiel- of naamgegevens. | Initiaal, bijvoorbeeld E | Vrije upload is niet van toepassing; profielafbeeldingen zijn elders geregeld. | StudentAvatarPresentation |
| SCH-DOC-04-01-F05 | Field | Leerlingnaam in leerlingkaart | Toont de naam van de gekoppelde leerling volgens de ingestelde naamweergave. | Bijvoorbeeld Emma Jansen | Naamweergave kan door persoonlijke voorkeur beïnvloed worden. | StudentDisplayName |
| SCH-DOC-04-01-F06 | Field | Badge naast leerlingnaam | Toont of de leerling nog geautoriseerd moet worden of hoeveel actieve niveaus door deze docent zijn toegekend. | Te autoriseren / 1 niveau / 2 niveaus | Enkelvoud en meervoud moeten correct worden weergegeven. | StudentAuthorizationBadge |
| SCH-DOC-04-01-B01 | Button/Action | Actie in leerlingkaart | Opent de geschiedenis van de geselecteerde leerling binnen de eigen docentcontext. | Geschiedenis | Toont alleen resultaten binnen niveaus die bij deze docentcontext horen. | OpenTeacherStudentHistoryAction |
| SCH-DOC-04-01-B02 | Button/Action | Actie in leerlingkaart | Opent het individuele autorisatiescherm voor de geselecteerde leerling. | Autorisaties | Gebruikt de geselecteerde leerling en huidige docentcontext als routecontext. | OpenStudentAuthorizationsAction |
| SCH-DOC-04-01-B03 | Button | Pijlknop rechts in leerlingkaart | Klapt aanvullende leerlinginformatie open of dicht. | Meer informatie | Wijzigt alleen de presentatie op deze pagina. | ToggleStudentCardDetailsAction |
| SCH-DOC-04-01-S04 | Section | Uitklapdetail leerlingkaart | Toont aanvullende contextgegevens die relevant zijn voor deze docent. | Aanvullende leerlinginformatie | Wordt alleen zichtbaar na openen van de leerlingkaart. | StudentCardDetailsSection |
| SCH-DOC-04-01-F07 | Field | Uitklapdetail: Laatst gezien | Toont het laatst bekende activiteitsmoment van de leerling. | Laatst gezien | Informatief; geen live-statusvervanger. | StudentLastSeenDisplay |
| SCH-DOC-04-01-F08 | Field | Uitklapdetail: Actieve niveaus door jou | Toont welke niveaus door de huidige docent actief aan deze leerling zijn toegekend. | Actieve niveaus door jou | Bevat geen niveaus of autorisaties van andere docenten. | ActiveTeacherLevelNamesForStudent |
| SCH-DOC-04-01-S05 | Section | Paginering onder lijst | Toont huidige pagina, totaal aantal pagina's, zichtbare leerlingen en totaal aantal leerlingen. | Pagina 1 van 2 · 10 leerlingen zichtbaar · 18 totaal | Filters en zoekopdracht worden toegepast vóór paginering; visueel scrollen binnen het lijstblok vervangt paginering niet. | TeacherStudentsPaginationSection |
| SCH-DOC-04-01-B04 | Button | Paginering | Navigeert naar de vorige pagina met resultaten. | Vorige | Uitgeschakeld op de eerste pagina. | PreviousStudentPageAction |
| SCH-DOC-04-01-F09 | Field | Paginering | Toont de actieve pagina en beschikbare paginanummers. | 1 / 2 | Read-only statusweergave met klikbare paginanummers waar van toepassing. | StudentPageIndicator |
| SCH-DOC-04-01-B05 | Button | Paginering | Navigeert naar de volgende pagina met resultaten. | Volgende | Alleen actief wanneer er een volgende pagina bestaat. | NextStudentPageAction |
| SCH-DOC-04-01-S06 | Section | Samenvattingskaart rechts | Toont kerncijfers over de volledige actieve docentcontext. | Samenvatting leerlingenbeheer | Read-only contextsamenvatting; standaard niet bedoeld als telling van de actuele zoek- of filterresultaten. | TeacherStudentsSummarySection |
| SCH-DOC-04-01-F10 | Field | Samenvatting rechts | Aantal actieve leerlingen met een actieve docent-leerlingrelatie met de huidige docent. | Gekoppelde leerlingen | Teller telt de volledige actieve docentcontext, niet alle leerlingen in het systeem en niet standaard de actuele filterresultaten. | LinkedStudentsCount |
| SCH-DOC-04-01-F11 | Field | Samenvatting rechts | Aantal actieve gekoppelde leerlingen zonder actieve niveau-autorisatie binnen deze docentcontext. | Nog te autoriseren | Dit zijn leerlingen die wel gekoppeld zijn, maar nog geen oefentoegang via deze docent hebben. | StudentsPendingAuthorizationCount |
| SCH-DOC-04-01-F12 | Field | Samenvatting rechts | Aantal actieve gekoppelde leerlingen met minimaal één actieve niveau-autorisatie binnen deze docentcontext. | Met actieve niveau(s) | Een leerling telt één keer mee, ook bij meerdere niveaus. | StudentsWithActiveLevelsCount |
| SCH-DOC-04-01-S07 | Section | Rechterkolom: Snel naar | Toont korte navigatieroutes naar verwante docentfuncties. | Snel naar | Navigatiehulp; geen datawijziging. | TeacherStudentsQuickLinksSection |
| SCH-DOC-04-01-A01 | Action/link | Rechterkolom | Navigeert naar het online-overzicht voor actuele online- en live-meekijkfunctionaliteit. | Online bekijken | Start zelf geen live-meekijksessie. | OpenTeacherOnlineOverviewAction |
| SCH-DOC-04-01-A02 | Action/link | Rechterkolom | Navigeert naar het oefenaanbod van de docent. | Oefenaanbod beheren | Geen geselecteerde leerling nodig. | OpenTeacherExerciseOfferAction |
| SCH-DOC-04-01-S08 | Section | Rechterkolom: Goed om te weten | Toont informatieve aandachtspunten over de afbakening van dit scherm. | Goed om te weten | Visueel eigen informatieblok; geen mutatie. | TeacherStudentsInfoSection |
| SCH-DOC-04-01-M02 | Message | Goed om te weten | Maakt duidelijk dat geschiedenis docentgebonden is. | Historie is docentgebonden | Verwijst naar beperking van resultaten tot eigen geautoriseerde niveaus. | TeacherHistoryScopeInfoMessage |
| SCH-DOC-04-01-M03 | Message | Goed om te weten | Maakt duidelijk dat live meekijken via het online-overzicht loopt. | Live meekijken is tijdelijk | Voorkomt dat deze pagina als live-statusscherm wordt gezien. | LiveViewSeparationInfoMessage |
| SCH-DOC-04-01-M04 | Message | Goed om te weten | Maakt duidelijk dat relatie beëindigen buiten deze pagina valt. | Relatie beëindigen staat elders | Relatiebeheer blijft gescheiden van autorisatiebeheer. | RelationshipManagementSeparationInfoMessage |
6.5 Waardelagen
| Element-ID | GUI-verwijzing | Zichtbaar label | Technische naam | Databron | Waardebron | Datatype | Bewerkbaar | Validatie / regel |
|---|---|---|---|---|---|---|---|---|
| SCH-DOC-04-01-S02 | Introblok | Leerlingen | TeacherStudentsIntroSection | ContentBlocks of applicatie-resource met context Teacher en sleutel voor leerlingenintro | Database of codegedreven tekst | string/html-safe | Nee op dit scherm | Tekst mag alleen veilig gerenderde content bevatten; inhoudsbeheer loopt buiten dit scherm. |
| SCH-DOC-04-01-M01 | Intro onder Mijn leerlingen | Je ziet hier alleen jouw eigen docentcontext. | TeacherContextNoticeMessage | Applicatie-resource of ContentBlocks | Codegedreven tekst | string | Nee | Tekst moet aansluiten op server-side autorisatie: collaborators krijgen geen leerlingtoegang. |
| SCH-DOC-04-01-F01 | Zoekveld | Zoek op leerlingnaam of e-mailadres | StudentSearchQuery | Users.DisplayName, Users.FirstName, Users.MiddleName, Users.LastName, Users.Email, beperkt via UserRelationships met RelationshipTypes.Code = TeacherStudent | User input | string | Ja, filterwaarde | Zoeken werkt alleen binnen actieve relaties van de huidige docent. Zoeken op e-mailadres volgt uit de mockup, maar mag het e-mailadres niet automatisch zichtbaar maken in de kaart. |
| SCH-DOC-04-01-F02 | Niveaufilter | Alle niveaus | TeacherLevelFilter | TeacherLevels.Id, TeacherLevels.Name, TeacherLevels.IsActive, gekoppeld aan TeacherStudentLevelAccess.TeacherLevelId | Database | guid/string selectie | Ja, filterwaarde | Optielijst bevat alleen actieve docentniveaus die voor de huidige docentcontext relevant zijn. Filter wordt toegepast vóór paginering. |
| SCH-DOC-04-01-F03 | Autorisatiefilter | Alle autorisaties | AuthorizationStatusFilter | Afleiding op TeacherStudentLevelAccess.IsActive per actieve docent-leerlingrelatie | User input op berekende status | enum/string | Ja, filterwaarde | Toegestane waarden: Alle autorisaties, Nog te autoriseren, Met actieve niveau(s). Filter wordt toegepast vóór paginering. |
| SCH-DOC-04-01-T01 | Leerlingenlijst | Leerlingenlijst | TeacherStudentCardList | UserRelationships, RelationshipTypes, Users, Roles, TeacherStudentLevelAccess, TeacherLevels, UserSettings | Database + afgeleid | list/collection | Nee | Alleen actieve TeacherStudent-relaties van de huidige docent worden getoond. Uitgeschakelde of geanonimiseerde accounts mogen niet als normale actieve leerlingkaart verschijnen. Visueel scrollen binnen het blok is toegestaan, maar de functionele verdeling blijft paginering. |
| SCH-DOC-04-01-F04 | Leerlingkaart | Initiaal | StudentAvatarPresentation | Users.FirstName, Users.DisplayName, eventueel profielafbeeldingreferentie uit profielinstellingen | Afgeleid uit database | string/image ref | Nee | Als geen profielafbeelding beschikbaar is, mag een initiaal worden afgeleid uit de naam. |
| SCH-DOC-04-01-F05 | Leerlingkaart | Leerlingnaam | StudentDisplayName | Users.FirstName, Users.MiddleName, Users.LastName, eventuele naamweergavevoorkeur in UserSettings | Database + afgeleid | string | Nee | Naamweergave mag door voorkeur worden beïnvloed, maar mag geen extra leerlinggegevens ontsluiten. |
| SCH-DOC-04-01-F06 | Leerlingkaart | Te autoriseren / x niveaus | StudentAuthorizationBadge | TeacherStudentLevelAccess.IsActive = true voor de actieve docent-leerlingrelatie en relevante TeacherLevels | Berekend uit database | string/int | Nee | Count = 0 toont Te autoriseren. Count = 1 toont 1 niveau. Count > 1 toont x niveaus. |
| SCH-DOC-04-01-B01 | Leerlingkaart | Geschiedenis | OpenTeacherStudentHistoryAction | Routecontext met StudentUserId, huidige TeacherUserId, UserRelationship.Id en toegestane TeacherLevelId waarden; vervolgview leest ExerciseRuns | Afgeleid uit selectie | action | Ja, navigatie | Voor vervolgscherm moet server-side opnieuw worden gecontroleerd dat de docent geschiedenis mag zien binnen de eigen niveaucontext. |
| SCH-DOC-04-01-B02 | Leerlingkaart | Autorisaties | OpenStudentAuthorizationsAction | Routecontext met StudentUserId, huidige TeacherUserId, UserRelationship.Id, TeacherLevels, TeacherStudentLevelAccess | Afgeleid uit selectie | action | Ja, navigatie | Opent het individuele autorisatiescherm voor de geselecteerde leerling; autorisaties wijzigen niet op dit overzichtsscherm. |
| SCH-DOC-04-01-B03 | Leerlingkaart | Meer informatie | ToggleStudentCardDetailsAction | Clientstate van de geopende kaart; onderliggende detaildata uit Users en TeacherStudentLevelAccess | User input | boolean/presentation state | Ja, presentatie | Uitklappen mag geen data wijzigen en moet aria-expanded correct bijwerken. |
| SCH-DOC-04-01-F07 | Uitklapdetail | Laatst gezien | StudentLastSeenDisplay | Users.LastSeenAtUtc | Database | datetime/string | Nee | Weergave in lokale tijdzone of relatieve tekst. Dit veld is informatief en geen live-aanwezigheidsindicator. |
| SCH-DOC-04-01-F08 | Uitklapdetail | Actieve niveaus door jou | ActiveTeacherLevelNamesForStudent | TeacherStudentLevelAccess, TeacherLevels.Name, TeacherLevels.IsActive | Database + afgeleid | string/list | Nee | Toont alleen actieve niveau-autorisaties die door of binnen de huidige docentcontext gelden; andere docentniveaus blijven buiten beeld. |
| SCH-DOC-04-01-S05 | Paginering | Pagina x van y | TeacherStudentsPaginationSection | Gefilterde resultaatset uit UserRelationships en Users | Berekend | int/string | Nee | Standaardweergave ondersteunt 10 leerlingen per pagina. Totaal en paginanummering worden na zoeken en filteren herberekend; scrollgedrag binnen het lijstblok vervangt deze paginering niet. |
| SCH-DOC-04-01-B04 | Paginering | Vorige | PreviousStudentPageAction | Gefilterde resultaatset en actuele pagina-index | Berekend | action | Ja, navigatie binnen lijst | Uitgeschakeld wanneer CurrentPage = 1. |
| SCH-DOC-04-01-F09 | Paginering | 1 / 2 | StudentPageIndicator | Gefilterde resultaatset, PageSize, CurrentPage | Berekend | int/string | Nee | Actieve pagina is visueel herkenbaar en niet als gewone link noodzakelijk. |
| SCH-DOC-04-01-B05 | Paginering | Volgende | NextStudentPageAction | Gefilterde resultaatset en actuele pagina-index | Berekend | action | Ja, navigatie binnen lijst | Uitgeschakeld wanneer CurrentPage = TotalPages. |
| SCH-DOC-04-01-F10 | Samenvatting | Gekoppelde leerlingen | LinkedStudentsCount | UserRelationships + RelationshipTypes.Code = TeacherStudent + Users.IsActive | Berekend uit database | int | Nee | Telt actieve leerlingen binnen de volledige actieve docentcontext. De teller is niet globaal over alle docenten en standaard niet afhankelijk van de actuele zoek- of filterresultaten. |
| SCH-DOC-04-01-F11 | Samenvatting | Nog te autoriseren | StudentsPendingAuthorizationCount | Actieve TeacherStudent-relaties zonder actief TeacherStudentLevelAccess record | Berekend uit database | int | Nee | Alleen leerlingen met nul actieve niveau-autorisaties binnen de volledige actieve docentcontext tellen mee; standaard niet beperkt door de actuele zoek- of filterresultaten. |
| SCH-DOC-04-01-F12 | Samenvatting | Met actieve niveau(s) | StudentsWithActiveLevelsCount | Actieve TeacherStudent-relaties met minimaal één actief TeacherStudentLevelAccess record | Berekend uit database | int | Nee | Leerling telt één keer mee binnen de volledige actieve docentcontext, ook wanneer meerdere niveaus actief zijn; standaard niet beperkt door de actuele zoek- of filterresultaten. |
| SCH-DOC-04-01-A01 | Snel naar | Online bekijken | OpenTeacherOnlineOverviewAction | Route naar docent-online-overzicht; daar worden actuele online- en oefenstatussen via de online/live domeinlogica bepaald | Afgeleid uit navigatie | action | Ja, navigatie | Start geen live meekijksessie op dit scherm. |
| SCH-DOC-04-01-A02 | Snel naar | Oefenaanbod beheren | OpenTeacherExerciseOfferAction | Route naar docent-oefenaanbod; onderliggende data uit TeacherLevels, TeacherLevelCategories, TeacherLevelCategoryExercises, Exercises | Afgeleid uit navigatie | action | Ja, navigatie | Geen geselecteerde leerling nodig. |
| SCH-DOC-04-01-M02 | Goed om te weten | Historie is docentgebonden | TeacherHistoryScopeInfoMessage | Applicatie-resource of ContentBlocks; functionele regel steunt op TeacherStudentLevelAccess en ExerciseRuns.LevelId | Codegedreven tekst + business rule | string | Nee | Tekst moet aansluiten op server-side autorisatie: docent ziet alleen geschiedenis binnen eigen docentcontext. |
| SCH-DOC-04-01-M03 | Goed om te weten | Live meekijken is tijdelijk | LiveViewSeparationInfoMessage | Applicatie-resource of ContentBlocks; inhoudelijke verwijzing naar online/live-meekijkdomein | Codegedreven tekst | string | Nee | Deze pagina toont geen continue live-status en start geen live meekijksessie. |
| SCH-DOC-04-01-M04 | Goed om te weten | Relatie beëindigen staat elders | RelationshipManagementSeparationInfoMessage | Applicatie-resource of ContentBlocks; relatieacties via UserRelationships en RelationshipEvents in relatieflow | Codegedreven tekst + business rule | string | Nee | Ontkoppelen mag niet als verborgen actie op dit overzichtsscherm worden uitgevoerd. |
6.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-DOC-04-01-01 | SRS-TCH-008 AC-TCH-008 | De pagina Leerlingen alleen tonen aan gebruikers met een actieve docentcontext |
REQ-SCH-DOC-04-01-02 | SRS-TCH-008 AC-TCH-008 | In het leerlingenoverzicht uitsluitend actieve docent-leerlingrelaties tonen waarbij de ingelogde docent zelf partij is in de relatie |
REQ-SCH-DOC-04-01-03 | SRS-AUTH-001 SRS-TCH-008 AC-AUTH-001 AC-TCH-008 | Het systeem mag leerlingen, resultaten of autorisaties van andere docenten niet tonen op basis van collaboratorrechten of docent-docentrelaties |
REQ-SCH-DOC-04-01-04 | SRS-AUTH-001 SRS-TCH-008 AC-AUTH-001 AC-TCH-008 | Per leerling minimaal de naam, de autorisatiestatus en de acties Geschiedenis en Autorisaties tonen |
REQ-SCH-DOC-04-01-05 | SRS-RDM-005 SRS-RDM-002 SRS-RDM-001 SRS-AUTH-001 SRS-TCH-008 AC-RDM-005 AC-RDM-002 AC-RDM-001 AC-AUTH-001 AC-TCH-008 | Per leerling een badge tonen die bij nul actieve niveau-autorisaties Te autoriseren weergeeft en bij één of meer autorisaties het juiste aantal niveaus met correct enkelvoud/meervoud toont |
REQ-SCH-DOC-04-01-06 | SRS-TCH-008 AC-TCH-008 | Zoeken op leerlingnaam ondersteunen binnen de actieve docentcontext |
REQ-SCH-DOC-04-01-07 | SRS-TCH-008 AC-TCH-008 | Het systeem mag zoeken op e-mailadres ondersteunen, omdat de mockup dit als zoekplaceholder toont, maar mag daardoor geen leerlingen buiten de eigen docentcontext tonen en hoeft e-mailadres niet zichtbaar te maken in de leerlingkaart |
REQ-SCH-DOC-04-01-08 | SRS-TCH-008 AC-TCH-008 | Filtering op niveau ondersteunen op basis van niveaus die relevant zijn binnen de huidige docentcontext |
REQ-SCH-DOC-04-01-09 | SRS-AUTH-001 SRS-TCH-008 AC-AUTH-001 AC-TCH-008 | Filtering op autorisatiestatus ondersteunen met minimaal Alle autorisaties, Nog te autoriseren en Met actieve niveau(s) |
REQ-SCH-DOC-04-01-10 | SRS-TCH-001 AC-TCH-001 | Zoeken en filters toepassen vóór paginering, zodat de zichtbare lijst, paginatotalen en pagina-indicatoren aansluiten op de actuele selectie |
REQ-SCH-DOC-04-01-11 | SRS-RDM-005 SRS-RDM-008 SRS-RDM-002 SRS-RDM-001 SRS-TCH-008 AC-RDM-005 AC-RDM-008 AC-RDM-002 AC-RDM-001 AC-TCH-008 | Bij grotere aantallen leerlingen paginering ondersteunen en minimaal een paginaweergave met 10 leerlingen netjes kunnen tonen; eventueel scrollgedrag binnen het lijstblok mag deze paginering niet vervangen |
REQ-SCH-DOC-04-01-12 | SRS-AUTH-001 SRS-TCH-008 AC-AUTH-001 AC-TCH-008 | Aanvullende leerlinginformatie uitklapbaar tonen zonder dat dit server-side mutaties uitvoert |
REQ-SCH-DOC-04-01-13 | SRS-TCH-008 AC-TCH-008 | In het uitklapdetail alleen docentcontext-relevante gegevens tonen, waaronder laatst gezien en actieve niveaus door de huidige docent |
REQ-SCH-DOC-04-01-14 | SRS-TCH-008 AC-TCH-008 | Bij de actie Geschiedenis de geselecteerde leerling en de huidige docentcontext doorgeven aan de geschiedenisview |
REQ-SCH-DOC-04-01-15 | SRS-AUTH-001 SRS-TCH-008 AC-AUTH-001 AC-TCH-008 | In de geschiedenisview opnieuw server-side afdwingen dat de docent alleen resultaten ziet binnen de eigen geautoriseerde niveaucontext |
REQ-SCH-DOC-04-01-16 | SRS-AUTH-001 SRS-TCH-008 AC-AUTH-001 AC-TCH-008 | Bij de actie Autorisaties het individuele autorisatiescherm openen voor de geselecteerde leerling binnen de huidige docentcontext |
REQ-SCH-DOC-04-01-17 | SRS-TCH-001 AC-TCH-001 | Op deze overzichtspagina geen directe relatie-ontkoppelactie aanbieden; ontkoppelen of ontkoppelverzoeken verlopen via relatiebeheer |
REQ-SCH-DOC-04-01-18 | SRS-LIVE-002 AC-LIVE-002 | Op deze pagina geen live meekijksessie starten; actuele aanwezigheid en live meekijken verlopen via het aparte online-overzicht |
REQ-SCH-DOC-04-01-19 | SRS-RDM-005 SRS-RDM-002 SRS-RDM-001 SRS-AUTH-001 SRS-TCH-008 AC-RDM-005 AC-RDM-002 AC-RDM-001 AC-AUTH-001 AC-TCH-008 | De samenvattingswaarden Gekoppelde leerlingen, Nog te autoriseren en Met actieve niveau(s) standaard berekenen op basis van de volledige actieve docentcontext en de actuele niveau-autorisaties, onafhankelijk van zoek- en filterwaarden tenzij in het Functioneel Ontwerp en de Software Requirements Specification expliciet anders is gespecificeerd |
REQ-SCH-DOC-04-01-20 | SRS-AUTH-001 SRS-TCH-008 AC-AUTH-001 AC-TCH-008 | Voorkomen dat een leerling dubbel wordt meegeteld in Met actieve niveau(s) wanneer dezelfde leerling meerdere actieve niveau-autorisaties binnen dezelfde docentcontext heeft |
REQ-SCH-DOC-04-01-21 | SRS-TCH-008 AC-TCH-008 | Een lege toestand tonen wanneer de docent geen actieve docent-leerlingrelaties heeft |
REQ-SCH-DOC-04-01-22 | SRS-TCH-008 AC-TCH-008 | Een lege resultaatmelding tonen wanneer zoeken of filteren geen leerlingen oplevert, zonder de filter- en zoekmogelijkheden te verbergen |
REQ-SCH-DOC-04-01-23 | SRS-AUTH-001 SRS-TCH-008 AC-AUTH-001 AC-TCH-008 | Bij navigatie naar vervolgschermen controleren of de onderliggende relatie of autorisatie nog geldig is, ook wanneer deze na het laden van de lijst is gewijzigd |
REQ-SCH-DOC-04-01-24 | SRS-AUTH-001 SRS-TCH-008 AC-AUTH-001 AC-TCH-008 | Persoonlijke docentvoorkeuren voor naamweergave en sortering toepassen waar deze voor de leerlinglijst beschikbaar zijn, zonder de zichtbare gegevensset of autorisaties te wijzigen |
REQ-SCH-DOC-04-01-25 | SRS-NFR-AUD-001 SRS-LIVE-002 AC-NFR-AUD-001 AC-LIVE-002 | Informatieve schermteksten tonen die duidelijk maken dat historie docentgebonden is, live meekijken via Online verloopt en relatiebeëindiging elders plaatsvindt |
6.7 Technische koppeling
Voor technische uitwerking zijn vooral relevant:
- 05 Autorisatie, policies en server-side contextcontrole voor server-side begrenzing van leerlinglijsten, detailacties en autorisatieknoppen.
- 08 Oefencatalogus, niveaus, categorieën, oefeningen en modules voor niveaucontext en beschikbare oefentoegang per leerling.
- 11 Rolflows technisch voor docentflows rond leerlingbeheer en niveaucontext.
- 12 Relatiebeheer, uitnodigingen en gedeelde oefeningen voor docent-leerlingrelaties en uitnodigingsstatussen.
- 17 Readmodels, tellers, badges, caching en materialisatie voor leerlingoverzichten, statusbadges en afgeleide aantallen.
- 24 Frontend, Blazor, routing, state en componentopbouw voor tabelgedrag, filters en navigatie naar leerlingacties.
- 25 Privacy, retentie, anonimisering en gegevensbescherming voor minimale weergave van leerlinggegevens in docentcontext.