UC-DOC-LIVE-007 — Live-meekijksessie beëindigen
1. Kerngegevens
| Veld | Waarde |
|---|---|
| Usecase-ID | UC-DOC-LIVE-007 |
| Naam | Live-meekijksessie beëindigen |
| Domein | Docent |
| Subdomein | Online leerlingen en live meekijken |
| Primaire actor | Docent |
| Secundaire actor(en) | Leerling, OefenHub-systeem, realtime-kanaal |
| Rolcontext | Docentcontext met actieve docent-leerlingrelatie en geldige niveauautorisatie |
| Betrokken schermen | SCH-DOC-07-01 — Meekijken — Live meekijkweergave, live-meekijkweergave |
| Gerelateerde usecases | UC-DOC-LIVE-001, UC-DOC-LIVE-002, UC-DOC-LIVE-003, UC-DOC-LIVE-007, UC-LLN-OEF-004, UC-LLN-OEF-007, UC-LLN-OEF-008 |
| Primaire entiteiten | LiveViewAudit, ExerciseRuns, ExerciseRunProgress, UserRelationships, StudentLevelAuthorizations |
| Secundaire entiteiten / events | SignalR-verbinding, realtime voortgangsevent, sessie-einde-event, verbindingsfout |
| Gerelateerde popups | Niet van toepassing voor normale route; technische verbindingsmelding bij foutafhandeling |
| Popupregister | Niet van toepassing |
| MoSCoW | Must |
2. Omschrijving
Deze usecase beschrijft hoe een docent de eigen live-meekijksessie beëindigt. De docent stopt met kijken en ontvangt geen realtime updates meer, terwijl de oefening van de leerling ongewijzigd doorgaat of volgens de leerlingflow verder wordt afgehandeld.
De usecase beschrijft uitsluitend het docentgedrag binnen een reeds toegestane live-meekijkcontext. Het starten van de oefening door de leerling, het beantwoorden van vragen en het opslaan van voortgang blijven bronhoudend in de leerling-oefenusecases. De docentweergave is alleen-lezen en mag nooit leiden tot antwoordmutaties of correcties in de lopende run.
3. Scope
Binnen scope:
- Afsluiten van de live-meekijkweergave.
- Verbreken van het realtime-abonnement.
- Auditbaar afsluiten van LiveViewAudit.
- Navigeren naar een veilige docentcontext.
Buiten scope:
- Beëindigen van de leerlingrun.
- Resultaten berekenen.
- Autorisaties wijzigen.
- Meldingen of berichten aanmaken.
4. Pre-condities
| ID | Voorwaarde |
|---|---|
| PRE-001 | De docent is succesvol ingelogd en handelt binnen een actieve docentcontext. |
| PRE-002 | Er bestaat een actieve docent-leerlingrelatie tussen de docent en de leerling. |
| PRE-003 | De leerling heeft een actieve of recent live beschikbare exercise run die binnen de docentcontext valt. |
| PRE-004 | De docent heeft via niveauautorisatie recht op inzage in de oefencontext van de leerling. |
| PRE-005 | De live-meekijkfeature is sitebreed beschikbaar. |
| PRE-006 | De leerlingrun levert server-side voortgangsinformatie die via het realtime-kanaal kan worden getoond. |
5. Post-condities
| ID | Resultaat |
|---|---|
| POST-001 | De docent heeft de live-meekijkweergave volgens de toegestane context gebruikt. |
| POST-002 | De leerlingrun is inhoudelijk niet gewijzigd door de docent. |
| POST-003 | Eventuele live-meekijk-audit blijft herleidbaar via LiveViewAudit waar de flow dat vereist. |
| POST-004 | Niet-geautoriseerde voortgang of resultaten zijn niet zichtbaar gemaakt. |
| POST-005 | De applicatiecontext blijft consistent bij realtime updates, sessie-einde of verbindingsproblemen. |
6. Trigger
De usecase start wanneer de docent binnen een bestaande live-meekijkweergave een live handeling uitvoert of wanneer het systeem een relevante realtime wijziging ontvangt.
7. Normale processtroom
| Stap | Actor | Scherm / component | Actie | Systeemrespons | Data / regel |
|---|---|---|---|---|---|
| 1 | Docent | Live-meekijkweergave | Kiest voor sluiten, terug naar overzicht of verlaat de liveweergave. | Systeem start beëindiging van de live-meekijksessie. | BR-001 |
| 2 | Systeem | Frontend | Verbreekt realtime-abonnement voor de run. | De docent ontvangt geen verdere updates voor deze sessie. | SignalR subscription eindigt. |
| 3 | Systeem | Backend | Registreert het einde van de meekijksessie waar een LiveViewAudit-record actief is. | EndedAtUtc wordt gevuld wanneer nog leeg. | LiveViewAudit. |
| 4 | Systeem | Frontend | Navigeert terug naar online-overzicht of veilige vorige context. | Docent ziet geen liveweergave meer. | Geen oefenrunmutatie. |
| 5 | Systeem | Backend | Laat leerlingrun ongemoeid. | Leerling kan ongestoord verder oefenen. | BR-003 |
8. Alternatieve en exceptionele processtromen
| ID | Vanaf stap | Situatie | Systeemgedrag | Popup / melding | Datamutatie |
|---|---|---|---|---|---|
| ALT-001 | 1 | Docent sluit browser/tab zonder expliciete actie. | Systeem beëindigt realtimeverbinding via disconnect-afhandeling. | Geen popup. | EndedAtUtc vullen zodra disconnect verwerkt is. |
| ALT-002 | 2 | Realtimeverbinding was al verbroken. | Systeem rondt audit alsnog veilig af als dat nog niet is gebeurd. | Geen popup. | EndedAtUtc vullen indien nodig. |
| ALT-003 | 3 | EndedAtUtc is al gevuld. | Systeem voert geen tweede afsluitmutatie uit. | Geen popup. | Idempotent; geen dubbele mutatie. |
| ALT-004 | 4 | Vorige route is niet meer toegestaan. | Systeem navigeert naar online-overzicht of docent-frontpage. | Generieke routeguardafhandeling. | Geen mutatie. |
| ALT-005 | 5 | Leerlingrun is tegelijk afgerond. | Systeem laat leerlingafronding door leerlingflow verwerken en sluit alleen meekijkcontext af. | Geen popup. | Geen runmutatie door docentflow. |
9. Business rules
| ID | Regel |
|---|---|
| BR-001 | Een docent mag een eigen live-meekijksessie altijd beëindigen. |
| BR-002 | Beëindiging van meekijken beëindigt de oefening van de leerling niet. |
| BR-003 | De leerlingrun, antwoorden, scores en voortgang blijven onaangetast. |
| BR-004 | LiveViewAudit registreert sessieniveau; EndedAtUtc wordt maximaal één keer functioneel gevuld. |
| BR-005 | Na beëindiging ontvangt de docent geen realtime updates meer voor die sessie. |
| BR-006 | Bij browserdisconnect moet auditafsluiting best-effort en idempotent gebeuren. |
10. Datavalidatie
| Veld / object | Validatie |
|---|---|
| LiveViewAudit.Id | Moet horen bij de actieve meekijksessie van de docent. |
| EndedAtUtc | Wordt alleen gevuld wanneer deze nog leeg is. |
| Realtime subscription | Moet horen bij de betreffende run en gebruiker. |
| Terugkeerroute | Moet na routeguardcontrole toegestaan zijn. |
11. Datamutaties en events
| Stap | Type | Entiteit / event | Mutatie |
|---|---|---|---|
| 2 | Technisch | Realtime subscription | Abonnement op de live voortgangsstroom wordt beëindigd. |
| 3 | Update | LiveViewAudit.EndedAtUtc | Eindmoment wordt gevuld wanneer dit nog niet eerder is vastgelegd. |
| 4 | Presentatie | Navigatiecontext | Docent keert terug naar een veilige docentroute; geen domeinmutatie. |
12. Geen datamutaties
| Entiteit | Reden |
|---|---|
| ExerciseRuns | De docent wijzigt geen runinhoud, afronding of resultaat. |
| ExerciseRunProgress | De docentweergave leest voortgang, maar corrigeert geen antwoorden en markeert geen vragen. |
| UserRelationships | Relaties worden niet aangemaakt, gewijzigd of beëindigd binnen live meekijken. |
| StudentLevelAuthorizations | Autorisaties worden uitsluitend gelezen; beheer hoort in docent-autorisatieusecases. |
| SystemMessages | Live meekijken maakt geen systeemberichten aan. |
| PrivateMessageThreads | Live meekijken start geen privébericht en voegt geen thread-event toe. |
| Tickets | Verbindings- of livefouten worden niet automatisch als melding geregistreerd. |
13. State diagram
De usecase raakt geen persistent statusobject met eigen statusmodel. De live-meekijktoestand is een afgeleide sessie- en realtimecontext. Waar LiveViewAudit.EndedAtUtc wordt gevuld, betreft dit auditafronding en geen zelfstandige functionele statusmachine.
14. Decision flow
15. Data lifecycle diagram
16. Sequence diagrammen
17. Popupverwijzingen
| PopupKey | Moment | Doel |
|---|---|---|
| Niet van toepassing | Normale beëindiging | Geen popup; beëindiging verloopt als navigatie- of sluitactie. |
18. Afleiding naar Functioneel Ontwerp / Technisch Ontwerp / Software Requirements Specification
| Doeldocument | Afleiding |
|---|---|
| Functioneel Ontwerp | Beschrijft de live-meekijkinteractie binnen een geautoriseerde docentcontext en bevestigt het alleen-lezen karakter van de docentweergave. |
| Technisch Ontwerp | Technisch Ontwerp: live meekijken met SignalR, oefenruns en voortgang en readmodels en livebeschikbaarheid beschrijven de technische uitwerking. Werkt realtime-verwerking, SignalR-abonnementen, routeguardcontrole, LiveViewAudit-grenzen en foutafhandeling technisch uit. |
| Software Requirements Specification | Borgt autorisatie, alleen-lezen gedrag, realtime updates, veilige foutafhandeling en het ontbreken van onbedoelde runmutaties. |
| Database-informatie | Gebruikt LiveViewAudit, ExerciseRuns en voortgangsopslag als bestaande bronnen; er ontstaat geen aparte live-weergavetabel. |
| Ontwerpbronnen | Autorisatiematrix en business rules beschrijven de live-meekijkgrenzen binnen docentcontext. |
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-LIVE-007-001 | SRS-TCH-001 SRS-LIVE-001 AC-TCH-001 AC-LIVE-001 | Een docent toestaan een eigen live-meekijksessie te beëindigen |
REQ-UC-DOC-LIVE-007-002 | SRS-TCH-001 SRS-ARCH-003 AC-TCH-001 AC-ARCH-003 | Bij beëindiging het realtime-abonnement voor die sessie verbreken |
REQ-UC-DOC-LIVE-007-003 | SRS-TCH-001 SRS-LIVE-003 SRS-NFR-AUD-001 AC-TCH-001 AC-LIVE-003 AC-NFR-AUD-001 | LiveViewAudit.EndedAtUtc vullen wanneer de sessie eindigt en het veld nog leeg is |
REQ-UC-DOC-LIVE-007-004 | SRS-TCH-001 SRS-ARCH-004 AC-TCH-001 AC-ARCH-004 | Beëindiging idempotent verwerken wanneer dezelfde sessie meerdere afsluitsignalen oplevert |
REQ-UC-DOC-LIVE-007-005 | SRS-LRN-009 SRS-TCH-001 SRS-LIVE-001 AC-LRN-009 AC-TCH-001 AC-LIVE-001 | Door beëindiging van meekijken de leerlingrun niet beëindigen |
REQ-UC-DOC-LIVE-007-006 | SRS-LRN-003 SRS-TCH-001 AC-LRN-003 AC-TCH-001 | Door beëindiging geen antwoorden, scores of voortgang wijzigen |
REQ-UC-DOC-LIVE-007-007 | SRS-TCH-001 AC-TCH-001 | Browser- of verbindingsdisconnects best-effort verwerken als sessie-einde |
REQ-UC-DOC-LIVE-007-008 | SRS-TCH-001 SRS-NFR-SEC-001 AC-TCH-001 AC-NFR-SEC-001 | Na beëindiging naar een veilige docentroute navigeren |
REQ-UC-DOC-LIVE-007-009 | SRS-TCH-001 AC-TCH-001 | Voorkomen dat na beëindiging nog updates aan de docent worden geleverd |
REQ-UC-DOC-LIVE-007-010 | SRS-LRN-006 SRS-TCH-001 SRS-LIVE-001 AC-LRN-006 AC-TCH-001 AC-LIVE-001 | Beëindiging van live meekijken onderscheiden van afronding of onderbreking door de leerling |