Resultaten en geschiedenis binnen docentcontext
Dit subdomein beschrijft hoe een docent resultaten en oefengeschiedenis van leerlingen raadpleegt binnen de eigen docentcontext.
De kernregel is dat een docent alleen resultaten en geschiedenis ziet van niveaus die hij of zij zelf aan de leerling heeft geautoriseerd of waarvoor de docent volgens de geldende docentcontext inzagerecht heeft. De ouder-/voogdweergave, leerlinggeschiedenis en beheerderanalyse hebben eigen contextregels en worden hier niet als bronwaarheid uitgewerkt.
Usecase-overzicht
| Usecase-ID | Naam | Beschrijving |
|---|---|---|
| UC-DOC-RES-001 | Leerlinggeschiedenis binnen docentcontext openen | Opent de geschiedenis van een gekoppelde leerling binnen de eigen docentcontext en toont alleen toegestane afgeronde runs. |
| UC-DOC-RES-002 | Resultaten filteren op niveau, categorie en oefening | Past niveau-, categorie-, oefening- en periodefilters toe binnen de al geautoriseerde dataset. |
| UC-DOC-RES-003 | Afgeronde oefenrun van leerling bekijken | Opent een concreet afgerond resultaat vanuit de docentgeschiedenis. |
| UC-DOC-RES-004 | Resultaatdetails en statistieken bekijken | Toont vraagdetails en uniforme statistiekvelden van een toegestaan resultaat. |
| UC-DOC-RES-005 | Resultaat als PDF downloaden binnen docentcontext | Genereert een PDF van een toegestaan resultaat zonder resultaatdata te wijzigen. |
| UC-DOC-RES-006 | Geen toegang tot resultaten buiten docentcontext | Blokkeert directe routes, filters of exports die buiten de docentcontext vallen. |
Domeinafbakening
Binnen dit subdomein vallen:
- openen van leerlinggeschiedenis vanuit docentcontext;
- filteren en pagineren van resultaten binnen de toegestane dataset;
- openen van afgeronde oefenruns;
- bekijken van resultaatdetails en statistieken;
- downloaden van een resultaat als PDF;
- blokkeren van resultaattoegang buiten de docentcontext.
Buiten dit subdomein vallen:
- aanmaken of wijzigen van niveau-autorisaties;
- relatievorming tussen docent en leerling;
- leerlingzijde van geschiedenis en resultaatweergave;
- ouder-/voogdgeschiedenis over alle niveaus;
- beheerderanalyse buiten docentcontext;
- live meekijken met lopende oefeningen.
Belangrijke ontwerpregels
- Resultaatinzage door een docent is altijd docentcontextgebonden.
- Autorisatie wordt server-side gecontroleerd vóór filtering, detailweergave of PDF-export.
- Alleen afgeronde reguliere oefenruns worden in docentgeschiedenis getoond.
- Testruns en niet-afgeronde runs blijven buiten deze geschiedenis.
- Directe URL's, oude clientstate en filterparameters geven nooit zelfstandig recht op resultaatinzage.
- Resultaatweergave en PDF-export zijn read-only en wijzigen geen oefenrun.
- Er wordt geen aparte docentresultatentabel geïntroduceerd.
- Technische modulepayload blijft achter een veilige render- of exportrepresentatie.
Relatie met andere subdomeinen
| Domein / subdomein | Relatie |
|---|---|
| Docent - Leerlingen en niveau-autorisaties | Bepaalt welke leerlingen en niveaus binnen de docentcontext vallen. |
| Docent - Online en live meekijken | Gaat over actieve lopende oefenruns; dit subdomein gaat over afgeronde resultaten. |
| Leerling - Resultaten en geschiedenis | Beschrijft de leerlingzijde van resultaat, geschiedenis en PDF-export. |
| Generiek - Relaties | Is bronhoudend voor de docent-leerlingrelatie. |
| Generiek - Berichten | Wordt niet geraakt door resultaatinzage; er ontstaan geen berichten door bekijken of exporteren. |
Diagramgebruik
De usecases gebruiken vooral decision flows en sequence diagrams voor autorisatiecontrole, readmodelopbouw en exportafhandeling. State diagrams blijven expliciet niet van toepassing als persistent statusmodel, omdat docentresultaatinzage geen eigen resultaatstatus introduceert.