Docent-frontpage en context
Dit subdomein beschrijft de usecases rond de docent-frontpage en de contextbepaling die nodig is om deze frontpage veilig en voorspelbaar samen te stellen.
De docent-frontpage is een overzichts- en oriëntatiepagina. De pagina toont compacte samenvattingsblokken en vaste routes, maar voert geen diepe beheeracties uit. Acties waarvoor eerst een leerling, niveau, categorie, oefening of live sessie gekozen moet worden, blijven onderdeel van de achterliggende usecases.
Usecases
| Usecase-ID | Naam | Bestand |
|---|---|---|
| UC-DOC-FP-001 | Docent-frontpage bekijken | uc-doc-fp-001_docent-frontpage-bekijken |
| UC-DOC-FP-002 | Docentcontext bepalen | uc-doc-fp-002_docentcontext-bepalen |
| UC-DOC-FP-003 | Leerlingenoverzichtsamenvatting tonen | uc-doc-fp-003_leerlingenoverzichtsamenvatting-tonen |
| UC-DOC-FP-004 | Niveaus- en inhoudsamenvatting tonen | uc-doc-fp-004_niveaus-en-inhoudsamenvatting-tonen |
| UC-DOC-FP-005 | Gecombineerde docent-ouder-frontpage tonen | uc-doc-fp-005_gecombineerde-docent-ouder-frontpage-tonen |
Relevante context
De docentnavigatie bevat onder meer Oefenaanbod, Leerlingen en Online. De frontpage vervangt deze routes niet, maar biedt een rustige startpagina met samenvattingen en oriëntatiepunten.
Voor gecombineerde rollen geldt dat Docent en Ouder/voogd samen in één account mogen voorkomen. In dat geval wordt één gecombineerde frontpage getoond met één gezamenlijk introblok. Binnen die gecombineerde frontpage worden eerst de docentblokken getoond en daarna de ouder-/voogdblokken. Wanneer ook een beheerderrol aanwezig is, gelden de bredere prioriteitsregels waarbij beheerderblokken voor docentblokken komen.
Domeinafbakening
Dit subdomein omvat wel:
- bepalen van de actieve docentcontext;
- tonen van de docent-frontpage;
- tonen van compacte samenvattingsblokken voor leerlingen en onderwijsinhoud;
- samenstellen van een gecombineerde docent-ouder-frontpage;
- veilig omgaan met lege of beperkte frontpagetoestanden;
- verwijzen naar achterliggende routes zonder die routes opnieuw uit te werken.
Dit subdomein omvat niet:
- aanmaken of wijzigen van niveaus, categorieën of oefeningen;
- configureren of testen van oefeningen;
- beheren van leerlingen of niveau-autorisaties;
- bekijken van resultaatdetails of geschiedenis;
- starten of volgen van live meekijken;
- beheren van ouder-/voogdfunctionaliteit;
- uitwerken van systeemnotificaties.
Hoofdobjecten en brondata
De frontpage gebruikt bestaande brondata, waaronder:
Users;UserRoles;Roles;UserSettings;UserRelationships;TeacherLevels;TeacherLevelCategories;Exercises;TeacherStudentAuthorizations;LevelCollaborators.
Er wordt geen aparte frontpage-entiteit of frontpagecache als bron van waarheid geïntroduceerd. De frontpageweergave is een afgeleid readmodel.
Bijzondere regels
- De docent-frontpage is read-only voor domeindata.
- Alle samenvattingswaarden moeten eenduidig gedefinieerd zijn.
- Contextafhankelijke acties starten via vaste routes en niet als directe frontpage-mutatie.
- Clientstate mag nooit bepalen welke docentcontext of rolcontext actief is.
- Inactieve rollen tellen niet mee voor contextbepaling.
- Docent- en ouder-/voogdcontext blijven bij gecombineerde frontpages functioneel gescheiden.
- Systeemnotificaties worden pas na normale frontpageload gecontroleerd.
Popupverwijzingen
Voor dit subdomein worden geen domeinspecifieke popupregister-popups gebruikt. Routeguardgedrag, lege toestanden en generieke foutafhandeling worden via componentgedrag of bestaande generieke flows verwerkt.
| Usecase | PopupKey | Toelichting |
|---|---|---|
| UC-DOC-FP-001 | Niet van toepassing | Frontpage bekijken gebruikt geen popupregister-popup. |
| UC-DOC-FP-002 | Niet van toepassing | Contextbepaling gebruikt routeguard- en toegangafhandeling. |
| UC-DOC-FP-003 | Niet van toepassing | Leerlingensamenvatting gebruikt componentweergave en lege staten. |
| UC-DOC-FP-004 | Niet van toepassing | Inhoudssamenvatting gebruikt componentweergave en lege staten. |
| UC-DOC-FP-005 | Niet van toepassing | Gecombineerde frontpage gebruikt runtime-samenstelling. |
Teller- en readmodelregels
| Regel-ID | Regel |
|---|---|
| TR-001 | Een frontpagewaarde mag alleen worden getoond wanneer de bronrecords, statusvoorwaarden en contextfilters eenduidig zijn vastgelegd. |
| TR-002 | Alle leerlinggerelateerde aantallen worden beperkt tot de actuele docentcontext. |
| TR-003 | Soft-deactivated relaties, inactieve roltoekenningen en verlopen of afgehandelde uitnodigingen tellen niet als actieve context. |
| TR-004 | Pending uitnodigingen tellen niet als actieve leerlingen. |
| TR-005 | Collaboratorcontext kan onderwijsinhoud zichtbaar maken, maar verruimt geen leerling-, resultaat-, geschiedenis- of live-meekijktoegang. |
| TR-006 | Inactieve oefeningen tellen alleen mee wanneer het frontpageblok expliciet een onderhouds- of beheercontext toont. |
| TR-007 | Een lege toestand is een geldige readmodeluitkomst en mag geen automatische herstel- of mutatieflow starten. |
| TR-008 | Een frontpage-readmodel is afgeleid en mag geen tweede bron van waarheid worden. |
Diagramgebruik
De individuele usecases gebruiken vooral decision flows, data lifecycle diagrams en sequence diagrams om contextcontrole, readmodelopbouw en routeguardgedrag te verduidelijken. State diagrams blijven beperkt tot de expliciete vaststelling dat deze frontpageflows geen persistent statusobject wijzigen.