Leerlingen en niveau-autorisaties
Dit subdomein beschrijft hoe een docent binnen de eigen docentcontext gekoppelde leerlingen bekijkt en niveau-autorisaties beheert. De usecases gaan over de docentzijde van leerlingtoegang: welke leerlingen zichtbaar zijn, hoe hun autorisaties worden ingezien, hoe een leerling aan een niveau wordt gekoppeld of daarvan wordt ontkoppeld, hoe bulkbeheer werkt en hoe de leerling over zulke wijzigingen wordt geïnformeerd.
De bron voor relatievorming blijft het generieke relatiedomein. De bron voor de leerlingervaring na autorisatie blijft het leerlingdomein. Dit subdomein legt niet opnieuw vast hoe een leerling inlogt, een niveau kiest, een oefening start of een systeembericht opent. Het beschrijft uitsluitend de docentprocessen rond gekoppelde leerlingen en niveau-autorisaties.
Usecases
| Usecase-ID | Naam | Bestand |
|---|---|---|
| UC-DOC-LLN-001 | Leerlingenoverzicht bekijken | uc-doc-lln-001_leerlingenoverzicht-bekijken |
| UC-DOC-LLN-002 | Leerlingen zoeken en filteren | uc-doc-lln-002_leerlingen-zoeken-en-filteren |
| UC-DOC-LLN-003 | Leerlingdetails binnen docentcontext bekijken | uc-doc-lln-003_leerlingdetails-binnen-docentcontext-bekijken |
| UC-DOC-LLN-004 | Niveau-autorisaties van leerling bekijken | uc-doc-lln-004_niveau-autorisaties-van-leerling-bekijken |
| UC-DOC-LLN-005 | Leerling aan niveau koppelen | uc-doc-lln-005_leerling-aan-niveau-koppelen |
| UC-DOC-LLN-006 | Leerling van niveau ontkoppelen | uc-doc-lln-006_leerling-van-niveau-ontkoppelen |
| UC-DOC-LLN-007 | Bulk niveau-autorisaties beheren | uc-doc-lln-007_bulk-niveau-autorisaties-beheren |
| UC-DOC-LLN-008 | Autorisatiewijziging aan leerling communiceren | uc-doc-lln-008_autorisatiewijziging-aan-leerling-communiceren |
Relevante context
Dit subdomein hoort bij de docentnavigatie Leerlingen. De docent werkt vanuit de actieve docentcontext en ziet alleen leerlingen waarvoor een actieve docent-leerlingrelatie bestaat. Niveau-autorisaties bepalen vervolgens welke niveaus en bijbehorende toegankelijke oefeningen binnen die docentcontext voor de leerling beschikbaar zijn.
De pagina en vervolgschermen zijn geen relatiebeheer, geen profielbeheer en geen resultaatdetaildomein. Relatievorming blijft bij Generiek / Relaties, mailboxgedrag blijft bij Generiek / Berichten, leerlingtoegang bij Leerling / Oefenaanbod en toegang, en resultaatinzage bij Docent / Resultaten en geschiedenis.
Domeinafbakening
Dit subdomein omvat wel:
- leerlingenoverzicht binnen docentcontext;
- zoeken, filteren en pagineren van leerlingen;
- leerlingdetails binnen docentcontext;
- niveau-autorisaties bekijken;
- leerling aan niveau koppelen;
- leerling van niveau ontkoppelen;
- bulkbeheer voor niveau-autorisaties;
- communicatie over autorisatiewijzigingen via systeemberichten.
Dit subdomein omvat niet:
- uitnodigen of accepteren van docent-leerlingrelaties;
- profielgegevens van leerlingen wijzigen;
- resultaatdetails of volledige oefengeschiedenis tonen;
- live meekijken of online-status volgen;
- beheerderondersteuning of accountbeheer;
- inhoudelijke configuratie van niveaus, categorieën en oefeningen;
- algemene mailboxafhandeling of het openen van systeemberichten.
Hoofdobjecten en brondata
| Object | Rol binnen dit subdomein |
|---|---|
Users | Bevat docent- en leerlingaccounts die in de docentcontext worden gelezen. |
UserRoles / Roles | Bepalen of de gebruiker een actieve docentcontext heeft. |
UserRelationships | Levert de actieve docent-leerlingrelatie die zichtbaarheid en koppelbaarheid begrenst. |
TeacherLevels | Bepaalt welke niveaus binnen de docentcontext beheerd kunnen worden. |
TeacherStudentLevelAccess | Legt vast welke leerlingen voor welke niveaus binnen docentcontext geautoriseerd zijn. |
SystemMessages | Wordt gebruikt om leerlingen over autorisatiewijzigingen te informeren. |
Bijzondere regels
- Een docent ziet alleen leerlingen binnen de eigen actieve docent-leerlingrelaties.
- Een docent ziet geen andere docentrelaties van dezelfde leerling.
- Niveau-autorisaties zijn gescheiden van relaties, rollen en profielinstellingen.
- Een collaborator krijgt door samenwerking op niveau geen toegang tot leerlingen, resultaten, geschiedenis of live meekijken.
- Een leerling kan meerdere niveaus tegelijk geautoriseerd hebben.
- Nieuw toegevoegde actieve oefeningen binnen een geautoriseerd niveau worden automatisch beschikbaar voor de leerling.
- Intrekken van een niveau-autorisatie verwijdert geen afgeronde geschiedenis.
- Autorisatiewijzigingen wijzigen geen lopende of historische oefenruns.
- Communicatie over autorisatiewijzigingen verloopt via systeemberichten, niet via privéberichten.
- Alle muterende handelingen worden server-side opnieuw gevalideerd op docentrol, docent-leerlingrelatie en niveaucontext.
Popupverwijzingen
Voor dit subdomein worden geen domeinspecifieke popupregister-popups gebruikt. Validatiefouten, routeblokkades, lege toestanden, bulkresultaten en niet-toegestane acties worden afgehandeld via componentmeldingen, routeguardgedrag of bestaande generieke foutafhandeling.
| Usecase | PopupKey | Toelichting |
|---|---|---|
| UC-DOC-LLN-001 | Niet van toepassing | Leerlingenoverzicht bekijken gebruikt componentweergave, lege staten en routeguardgedrag. |
| UC-DOC-LLN-002 | Niet van toepassing | Zoeken en filteren gebruikt inline filter- en resultaatweergave. |
| UC-DOC-LLN-003 | Niet van toepassing | Leerlingdetails tonen gebruikt contextcontrole en veilige niet-beschikbaarafhandeling. |
| UC-DOC-LLN-004 | Niet van toepassing | Autorisaties bekijken gebruikt read-only contextweergave. |
| UC-DOC-LLN-005 | Niet van toepassing | Koppelen gebruikt server-side validatie en componentmelding. |
| UC-DOC-LLN-006 | Niet van toepassing | Ontkoppelen gebruikt server-side validatie en componentmelding. |
| UC-DOC-LLN-007 | Niet van toepassing | Bulkbeheer gebruikt componentmelding voor volledig of gedeeltelijk resultaat. |
| UC-DOC-LLN-008 | Niet van toepassing | Communicatie wordt als systeembericht aangemaakt en gebruikt geen popupregister-popup. |
Teller- en readmodelregels
| Regel-ID | Regel |
|---|---|
| TR-001 | Leerlingaantallen worden uitsluitend berekend binnen de actieve docentcontext. |
| TR-002 | Pending, afgewezen, verlopen of gedeactiveerde relaties tellen niet als actieve leerlingen. |
| TR-003 | Autorisatiestatussen worden afgeleid uit actuele TeacherStudentLevelAccess-records binnen de docentcontext. |
| TR-004 | Zoeken, filteren en pagineren wijzigen geen docent-, leerling-, relatie- of autorisatiedata. |
| TR-005 | Bulkresultaten tonen per geselecteerde leerling of de wijziging is uitgevoerd, overgeslagen of geweigerd. |
| TR-006 | Systeemberichtcommunicatie over autorisatiewijzigingen is geen auditlaag; formele herleidbaarheid blijft onderdeel van het autorisatie- of auditmodel. |
Diagramgebruik
De individuele usecases gebruiken vooral decision flows, data lifecycle diagrams en sequence diagrams om docentcontextcontrole, readmodelopbouw, autorisatiemutaties en communicatieafhandeling te verduidelijken. State diagrams worden alleen inhoudelijk gebruikt waar de functionele toestand van TeacherStudentLevelAccess verandert; read-only usecases benoemen expliciet dat zij geen persistent statusobject wijzigen.