UC-DOC-RES-001 - Leerlinggeschiedenis binnen docentcontext openen
1. Kerngegevens
| Veld | Waarde |
|---|---|
| Usecase-ID | UC-DOC-RES-001 |
| Naam | Leerlinggeschiedenis binnen docentcontext openen |
| Domein | Docent |
| Subdomein | Resultaten en geschiedenis binnen docentcontext |
| Primaire actor | Docent |
| Secundaire actor(en) | Systeem, Leerling |
| Rolcontext | Actieve docentcontext met geldige docentrol en resultaatinzage binnen eigen geautoriseerde niveaucontext |
| Betrokken schermen | Docent - Leerlingen, Docent - Leerlingdetails, Docent - Geschiedenis |
| Gerelateerde usecases | UC-DOC-LLN-001, UC-DOC-LLN-003, UC-DOC-LLN-004, UC-DOC-RES-002, UC-DOC-RES-003, UC-DOC-RES-006, UC-LLN-HIS-001, UC-LLN-HIS-004 |
| Primaire entiteiten | Users, UserRoles, Roles, UserRelationships, TeacherStudentLevelAccess, TeacherLevels, ExerciseRuns |
| Secundaire entiteiten / events | Categories, Exercises, ExerciseModules, leerlinggeschiedenis-readmodel, autorisatiecontrole |
| Gerelateerde popups | Niet van toepassing |
| Popupregister | Niet van toepassing |
| MoSCoW | Must |
2. Omschrijving
Deze usecase beschrijft hoe een docent de oefengeschiedenis van een gekoppelde leerling opent binnen de eigen docentcontext.
De geschiedenis is nadrukkelijk geen algemene leerlinggeschiedenis over alle docenten heen. De docent ziet alleen resultaten en afgeronde oefenruns die binnen de eigen geautoriseerde niveaucontext vallen.
De usecase is read-only. Het openen van de geschiedenis wijzigt geen oefenrun, geen autorisatie en geen leerlingprofiel.
3. Scope
3.1 Binnen scope
- Openen van de geschiedenisroute vanuit een leerling binnen de docentcontext.
- Server-side controleren van docentrol, docent-leerlingrelatie en relevante niveauautorisatiecontext.
- Samenstellen van een readmodel met afgeronde oefenruns binnen de toegestane docentcontext.
- Uitsluiten van testruns, open runs en resultaten buiten de eigen docentcontext.
- Tonen van betekenisvolle contextgegevens zoals niveau, categorie, oefening en afrondmoment.
3.2 Buiten scope
- Wijzigen van leerlingautorisaties.
- Starten of hervatten van oefeningen namens de leerling.
- Bekijken van resultaten buiten de eigen docentcontext.
- Ouder-/voogdgeschiedenis over alle niveaus.
- PDF-export van een concreet resultaat; dat valt onder UC-DOC-RES-005.
3.3 DRY-afbakening
- Leerlingresultaten en statistiekdefinities blijven inhoudelijk bronhoudend in de leerlingresultaat- en centrale FO/TO/SRS-regels.
- Docentniveau-autorisaties worden hier toegepast, maar het wijzigen ervan blijft bronhoudend in het subdomein Leerlingen en niveau-autorisaties.
- Relatievorming en relatieontkoppeling blijven bronhoudend in het generieke relatiedomein.
- PDF-layoutregels worden niet per usecase als nieuwe bronwaarheid herhaald, maar verwijzen naar de centrale resultaat- en PDF-afspraken.
- Deze usecases maken geen eigen kopie van oefenruns, statistieken of histories voor docenten.
- Directe toegang via URL, filter of exportverzoek blijft altijd onder dezelfde autorisatiegrens vallen.
- Systeemberichten, privéberichten en meldingen worden niet aangemaakt door het bekijken van resultaten.
- Module-specifieke payload blijft eigendom van de technische module; de docentweergave gebruikt veilige representaties.
4. Pre-condities
| ID | Voorwaarde |
|---|---|
| PRE-001 | De gebruiker is succesvol ingelogd. |
| PRE-002 | De gebruiker heeft een actieve docentrol. |
| PRE-003 | De OefenHub-sessiecontext is server-side opgebouwd. |
| PRE-004 | De betrokken leerling, run of resultatenlijst valt potentieel binnen de docentcontext. |
| PRE-005 | De backend kan actuele autorisatie-, relatie- en resultaatgegevens ophalen. |
| PRE-006 | De relevante resultaatdata is beschikbaar in de persistente run- en voortgangsopslag. |
5. Post-condities
| ID | Resultaat |
|---|---|
| POST-001 | De docent ziet uitsluitend resultaten die binnen de eigen docentcontext vallen. |
| POST-002 | Geen resultaat, oefenrun, autorisatie of profielgegeven is gewijzigd door deze read-only flow. |
| POST-003 | Een verboden of verouderd verzoek is veilig geblokkeerd zonder contextlek. |
| POST-004 | De frontend toont een actuele lijst, detailweergave, export of veilige afwijzing. |
| POST-005 | Fout- en blokkadesituaties worden veilig afgehandeld zonder nieuwe domeinentiteiten te introduceren. |
| POST-006 | Vervolgacties blijven binnen de daarvoor bedoelde usecases. |
6. Trigger
De docent kiest bij een gekoppelde leerling voor de actie Geschiedenis of opent de leerlinggeschiedenis via een docentcontext-route.
7. Normale processtroom
| Stap | Actor | Scherm / component | Actie | Systeemrespons | Data / regel |
|---|---|---|---|---|---|
| 1 | Docent | Leerlingdetails | Kiest Geschiedenis | Frontend opent de geschiedenisroute voor de gekozen leerling | StudentUserId |
| 2 | Frontend | Routeguard | Stuurt context naar backend | Backend start server-side autorisatiecontrole | Clientstate is niet leidend |
| 3 | Systeem | Sessieservice | Controleert actieve docentrol | Blokkeert zonder docentrol | UserRoles, Roles |
| 4 | Systeem | Relatieservice | Controleert actieve of historisch geldige docent-leerlingcontext voor resultaatinzage | Bepaalt of leerling in context bekeken mag worden | UserRelationships |
| 5 | Systeem | Autorisatieservice | Bepaalt toegestane niveaucontexten van deze docent voor deze leerling | Maakt contextfilter | TeacherStudentLevelAccess |
| 6 | Systeem | Resultatenservice | Haalt afgeronde oefenruns op binnen contextfilter | Sluit niet-afgeronde runs en testruns uit | ExerciseRuns.IsCompleted = true, IsTestRun = false |
| 7 | Systeem | Readmodel | Verrijkt regels met niveau, categorie en oefening | Bouwt compacte geschiedenisregels | TeacherLevels, Categories, Exercises |
| 8 | Systeem | Readmodel | Sorteert standaard op afrondmoment aflopend | Levert eerste pagina terug | CompletedAtUtc desc |
| 9 | Frontend | Geschiedenispagina | Toont geschiedenisregels | Docent ziet alleen toegestane resultaten | Geen technische GUIDs |
| 10 | Docent | Geschiedenispagina | Kan filteren of een regel openen | Vervolg naar UC-DOC-RES-002 of UC-DOC-RES-003 | Read-only vervolg |
8. Alternatieve en exceptionele processtromen
| ID | Vanaf stap | Situatie | Systeemgedrag | Popup / melding | Datamutatie |
|---|---|---|---|---|---|
| ALT-001 | 3 | Geen actieve docentrol | Systeem blokkeert de route en toont geen leerlinggegevens. | Niet van toepassing | Geen |
| ALT-002 | 4 | Leerling valt niet binnen docentcontext | Systeem retourneert geen geschiedenis en voorkomt dat bestaan van gegevens wordt bevestigd. | Niet van toepassing | Geen |
| ALT-003 | 5 | Er zijn geen geautoriseerde niveaus voor deze leerling binnen docentcontext | Systeem toont een lege geschiedenis met neutrale toelichting. | Niet van toepassing | Geen |
| ALT-004 | 6 | Alle beschikbare runs zijn niet-afgerond of testruns | Systeem toont geen geschiedenisregels. | Niet van toepassing | Geen |
| ALT-005 | 7 | Een historische categorie- of oefennaam is gewijzigd | Systeem toont de historisch opgeslagen of functioneel geldige contextweergave. | Niet van toepassing | Geen |
| ALT-006 | 8 | Paginering vraagt een lege pagina op | Systeem valt terug op de dichtstbijzijnde geldige pagina of toont lege lijst. | Niet van toepassing | Geen |
9. Business rules
| ID | Regel |
|---|---|
| BR-001 | Een docent ziet alleen resultaten en geschiedenis binnen de eigen geautoriseerde niveaucontext. |
| BR-002 | Ouder-/voogdregels voor volledige kindgeschiedenis zijn niet van toepassing op docentcontext. |
| BR-003 | Alle autorisatiecontrole gebeurt server-side op basis van actuele context en niet op basis van routeparameters alleen. |
| BR-004 | Alleen afgeronde reguliere oefenruns worden in de docentgeschiedenis getoond. |
| BR-005 | Testruns van docenten worden niet als leerlinggeschiedenis getoond. |
| BR-006 | Niet-afgeronde runs blijven buiten de geschiedenislijst. |
| BR-007 | Technische identifiers zoals GUIDs worden niet als herkenningsmiddel aan de docent getoond. |
| BR-008 | Geschiedenis openen wijzigt geen oefenrun, geen autorisatie en geen profielgegeven. |
| BR-009 | De geschiedenisweergave is een afgeleid readmodel en geen aparte bron van waarheid. |
| BR-010 | Wanneer een resultaat buiten de docentcontext valt, mag de frontend dit resultaat niet alsnog via directe URL openen. |
| BR-011 | Categorie-, oefening- en niveaunamen worden betekenisvol getoond; technische modulegegevens zijn alleen zichtbaar waar functioneel nodig. |
| BR-012 | Lege resultaten moeten neutraal worden afgehandeld zonder informatie buiten context prijs te geven. |
10. Datavalidatie
| Veld / object | Validatie |
|---|---|
| DocentUserId | Moet overeenkomen met de server-side ingelogde gebruiker en mag niet uit formulierinvoer worden vertrouwd. |
| StudentUserId | Moet binnen de toegestane docentcontext vallen voordat resultaten worden gelezen. |
| ExerciseRunId | Moet bestaan, afgerond zijn en binnen de toegestane context vallen. |
| TeacherLevelId | Moet onderdeel zijn van de eigen docentcontext of historische resultaatcontext waar de docent recht op heeft. |
| CategoryId | Mag alleen als filter worden toegepast binnen de reeds toegestane dataset. |
| ExerciseId | Mag alleen als filter of context worden gebruikt binnen de toegestane dataset. |
| Periodefilter | Moet geldige datums bevatten en mag niet leiden tot datasetuitbreiding buiten autorisatie. |
| Paginering | Moet worden begrensd op toegestane waarden en bij lege pagina veilig terugvallen. |
| PDF-bestandsnaam | Moet worden opgeschoond van ongeldige tekens en lengtebeperkingen respecteren. |
| Modulepayload | Mag alleen via veilige render- of exportrepresentatie worden gebruikt. |
11. Datamutaties en events
| Stap | Type | Entiteit / readmodel | Gedrag |
|---|---|---|---|
| 1 | Query | Docentcontext-readmodel | Leest actieve docentrol, docent-leerlingrelatie en toegestane niveaucontext. |
| 2 | Query | ExerciseRuns | Leest alleen afgeronde reguliere runs binnen de toegestane docentcontext. |
| 3 | Query | Geschiedenis-readmodel | Verrijkt de lijst met betekenisvolle niveau-, categorie- en oefeningcontext. |
| 4 | Geen domeinmutatie | ExerciseRuns / ExerciseRunProgress | De geschiedenisweergave wijzigt geen run, voortgang, antwoord of statistiek. |
| 5 | Geen domeinmutatie | TeacherStudentLevelAccess | Autorisaties worden toegepast, niet gewijzigd. |
| 6 | Geen domeinmutatie | SystemMessages / PrivateMessages / Tickets | Resultaatinzage maakt geen communicatie- of meldingsrecords aan. |
12. Geen datamutaties
| Entiteit | Reden |
|---|---|
| Users | Resultaat- en geschiedenisweergave wijzigt geen gebruikersaccount. |
| UserRoles / Roles | Bekijken of exporteren van resultaten wijzigt geen rollen. |
| UserRelationships | Docent-leerlingrelaties worden alleen gecontroleerd, niet gewijzigd. |
| TeacherStudentLevelAccess | Autorisaties worden gecontroleerd, niet aangepast. |
| TeacherLevels | Niveaucontext wordt gelezen en niet gewijzigd. |
| Categories | Categoriecontext wordt gelezen en niet gewijzigd. |
| Exercises | Oefeningcontext wordt gelezen en niet gewijzigd. |
| ExerciseRuns | Bekijken, filteren of exporteren wijzigt de run niet. |
| ExerciseRunProgress | Vraagdetails worden gelezen en niet aangepast. |
| SystemMessages | Resultaatinzage maakt geen systeemberichten aan. |
| PrivateMessages | Resultaatinzage maakt geen privéberichten aan. |
| Tickets | Resultaatinzage maakt geen melding aan. |
13. State diagram
Niet van toepassing als persistent statusmodel. De usecase leest bestaande oefenrunstatussen en autorisatiecontext, maar introduceert geen nieuwe status voor docentresultaatinzage.
14. Decision flow
15. Data lifecycle diagram
Deze usecase maakt geen nieuwe resultaatdata aan. Het lifecyclebeeld toont dat bestaande runs alleen worden gelezen.
16. Sequence diagrammen
16.1 Geschiedenis openen binnen docentcontext
16.2 Directe route of verouderde clientstate blokkeren
17. Popupverwijzingen
| PopupKey | Moment | Doel |
|---|---|---|
| Niet van toepassing | Alle momenten | Resultaatinzage, filtering, export en blokkades gebruiken geen nieuwe domeinspecifieke popupregister-popup. |
| Niet van toepassing | PDF-downloadfout | Een exportfout wordt via generieke foutafhandeling verwerkt zonder popupteksten in de usecase te dupliceren. |
18. Afleiding naar Functioneel Ontwerp / Technisch Ontwerp / Software Requirements Specification
| Doeldocument | Afleiding |
|---|---|
| Functioneel Ontwerp | Docentresultaten moeten expliciet contextgebonden worden beschreven: alleen resultaten van niveaus die de docent zelf aan de leerling heeft geautoriseerd of waarvoor de docent volgens de geldende docentcontext inzagerecht heeft. |
| Technisch Ontwerp | Technisch Ontwerp: oefenruns, resultaten en PDF-brondata, PDF-export, readmodels en resultaatlezers en autorisatie beschrijven de technische uitwerking. Backendqueries voor geschiedenis, filters, resultaatdetails en PDF-export moeten altijd eerst autorisatiecontext toepassen en daarna pas filters, sortering of exportlogica. |
| Software Requirements Specification | Requirements moeten vastleggen dat directe URL-toegang, filterparameters en exportverzoeken geen toegang buiten docentcontext mogen opleveren. |
| Database-informatie | ExerciseRuns en gerelateerde resultaatdata blijven bronhoudend; er is geen aparte docentresultatentabel nodig. |
| Ontwerpbronnen | Autorisatiematrix, business rules en usecase-matrices moeten docentresultaatinzage en blokkades buiten context opnemen. Read-only resultaatinzage vraagt geen nieuw domeinevent. |
| Privacy/AVG | Resultaatinzage door docenten moet dataminimalisatie respecteren en geen resultaten buiten onderwijscontext zichtbaar maken. |
19. SRS-trace
Deze usecase bevat geen normatieve requirementtekst. De centrale eis en acceptatiecriteria staan in de SRS; onderstaande tabel koppelt de usecase-afleiding alleen aan centrale SRS-*- en AC-*-items.
| Usecase-afleiding | Dekt | Usecasecontext |
|---|---|---|
REQ-UC-DOC-RES-001-001 | SRS-LRN-010 SRS-TCH-004 SRS-NFR-AUD-001 AC-LRN-010 AC-TCH-004 AC-NFR-AUD-001 | De docent moet leerlinggeschiedenis binnen de eigen docentcontext kunnen openen |
REQ-UC-DOC-RES-001-002 | SRS-TCH-001 AC-TCH-001 | Resultaten buiten de docentcontext uitsluiten |
REQ-UC-DOC-RES-001-003 | SRS-LRN-009 SRS-TCH-001 AC-LRN-009 AC-TCH-001 | Alleen afgeronde reguliere oefenruns tonen |
REQ-UC-DOC-RES-001-004 | SRS-LRN-010 SRS-TCH-004 SRS-NFR-AUD-001 AC-LRN-010 AC-TCH-004 AC-NFR-AUD-001 | Testruns en open runs uit de docentgeschiedenis weren |
REQ-UC-DOC-RES-001-005 | SRS-AUTH-001 SRS-AUTH-004 SRS-LRN-010 SRS-TCH-004 SRS-NFR-AUD-001 AC-AUTH-001 AC-AUTH-004 AC-LRN-010 AC-TCH-004 AC-NFR-AUD-001 | Directe routes naar leerlinggeschiedenis server-side controleren |
REQ-UC-DOC-RES-001-006 | SRS-TCH-001 AC-TCH-001 | Betekenisvolle contextgegevens tonen zonder technische identifiers |
REQ-UC-DOC-RES-001-007 | SRS-AUTH-001 SRS-LRN-009 SRS-TCH-001 AC-AUTH-001 AC-LRN-009 AC-TCH-001 | Toegang tot leerlingresultaten altijd server-side valideren |
REQ-UC-DOC-RES-001-008 | SRS-LRN-009 SRS-TCH-005 AC-LRN-009 AC-TCH-005 | Testruns uitsluiten van docentresultaten |
REQ-UC-DOC-RES-001-009 | SRS-LRN-006 SRS-TCH-004 SRS-NFR-AUD-001 AC-LRN-006 AC-TCH-004 AC-NFR-AUD-001 | Niet-afgeronde runs buiten resultaatgeschiedenis houden |
REQ-UC-DOC-RES-001-010 | SRS-TCH-001 AC-TCH-001 | Technische identifiers niet als gebruikersgerichte herkenningsgegevens tonen |
REQ-UC-DOC-RES-001-011 | SRS-TCH-004 AC-TCH-004 | Resultaatinzage zonder domeinmutatie verwerken |