Ontwerp: eLearning-vraag- en assessmentmodel #1998

New issue

Closed

opened 2026-09-06 08:23:38 +00:00 by brenno · 0 comments

brenno commented

2026-09-06 08:23:38 +00:00

Owner

Doel

Ontwerp het uitbreidbare model voor eLearning-vragen, toetsregels en leeractiviteiten. Dit is de inhoudelijke basis onder QTI/SCORM/OLX-import en de eLearning-slide-types.

Harde grens

Historische learnerresultaten vallen voorlopig buiten scope. We slaan nu niet op wie een vraag al goed of fout had, welke kennis iemand bezit, attempts uit eerdere sessies of persoonlijke voortgang. Dit ontwerp beschrijft alleen toetsinhoud en uitvoeringsregels: antwoordmodel, scoring, feedback, tijd, pogingen, slaaggrens en cursusstructuur.

Bestaande basis

Het huidige question-model ondersteunt meerkeuze, juist/onjuist, multiple-correct, ordering, image-pair en open text. Het ondersteunt al een begrensde antwoordpool, timeLimitSeconds, onWrong en similarityThreshold, maar niet de volledige eLearning-semantiek.

Ontwerpeisen

Kies leesbare Markdown/fenced JSON waar het om slide-inhoud gaat.
Zet bron-ID’s, complexe scoring, mappinginformatie en importwaarschuwingen in een sidecar.
Behoud onbekende velden en maak oudere decks niet onleesbaar.
Scheid question definition van assessment/test definition.
Definieer een gecontroleerde subset per bronformaat; unsupported semantics worden nooit stilzwijgend omgezet.
Beschrijf alle schemawijzigingen in docs/FILE_FORMAT.md, plus USER_GUIDE.md en SOURCE_MAP.md.

Deelissues

Werk de onderdelen uit in de kindissues voor matching, hotspot, fill-in, partial credit, feedback, attempts, assessment scoring, question groups, accessibility en question metadata.

Acceptatiecriteria

Eén ontwerpbesluit over het gedeelde data-model en de sidecargrens.
Per onderdeel een round-trip-formaat, validatie, UI-gedrag, presenter/exportgedrag en teststrategie.
Documentatie bijgewerkt vóór implementatie.
Historische resultaten expliciet als toekomstige uitbreiding genoemd en niet alvast in het formaat gereserveerd met betekenis die later kan botsen.

Afhankelijkheden: hoofdissue #1992 en QTI-issue #1994.

## Doel Ontwerp het uitbreidbare model voor eLearning-vragen, toetsregels en leeractiviteiten. Dit is de inhoudelijke basis onder QTI/SCORM/OLX-import en de eLearning-slide-types. ## Harde grens Historische learnerresultaten vallen voorlopig buiten scope. We slaan nu niet op wie een vraag al goed of fout had, welke kennis iemand bezit, attempts uit eerdere sessies of persoonlijke voortgang. Dit ontwerp beschrijft alleen toetsinhoud en uitvoeringsregels: antwoordmodel, scoring, feedback, tijd, pogingen, slaaggrens en cursusstructuur. ## Bestaande basis Het huidige question-model ondersteunt meerkeuze, juist/onjuist, multiple-correct, ordering, image-pair en open text. Het ondersteunt al een begrensde antwoordpool, timeLimitSeconds, onWrong en similarityThreshold, maar niet de volledige eLearning-semantiek. ## Ontwerpeisen - Kies leesbare Markdown/fenced JSON waar het om slide-inhoud gaat. - Zet bron-ID’s, complexe scoring, mappinginformatie en importwaarschuwingen in een sidecar. - Behoud onbekende velden en maak oudere decks niet onleesbaar. - Scheid question definition van assessment/test definition. - Definieer een gecontroleerde subset per bronformaat; unsupported semantics worden nooit stilzwijgend omgezet. - Beschrijf alle schemawijzigingen in docs/FILE_FORMAT.md, plus USER_GUIDE.md en SOURCE_MAP.md. ## Deelissues Werk de onderdelen uit in de kindissues voor matching, hotspot, fill-in, partial credit, feedback, attempts, assessment scoring, question groups, accessibility en question metadata. ## Acceptatiecriteria - Eén ontwerpbesluit over het gedeelde data-model en de sidecargrens. - Per onderdeel een round-trip-formaat, validatie, UI-gedrag, presenter/exportgedrag en teststrategie. - Documentatie bijgewerkt vóór implementatie. - Historische resultaten expliciet als toekomstige uitbreiding genoemd en niet alvast in het formaat gereserveerd met betekenis die later kan botsen. Afhankelijkheden: hoofdissue #1992 en QTI-issue #1994.

brenno added the

triage

enhancement

labels

2026-09-06 08:23:38 +00:00

brenno referenced this issue

2026-09-06 08:23:39 +00:00

Ontwerp en bouw: eLearning-slide-types #1999

brenno referenced this issue

2026-09-06 08:23:42 +00:00

Vraagmodel: matching-interactie #2000

brenno referenced this issue