Afsprakenstelsel Edu-V
Titel | Afsprakenstelsel Edu-V |
Status | DRAFT WERKGROEP KLANKBORDgroep ARCHITECTenraad REDACTIE BEsluitvorming CONCEPT |
Stadium | POC PILOT BEHEER |
Versie | 0.0.9 |
Auteur | Programmateam Edu-V |
Datum | 14 Juli 2023 |
Op deze omgeving worden alle conceptafspraken van het Edu-V afsprakenstelsel gepubliceerd.
Disclaimer
Alle informatie op deze omgeving is tot nader orde illustratief en er kunnen geen rechten aan worden ontleend. De inhoud is publiek gedeeld ten behoeve van transparantie en om het gesprek over de totstandkoming van de afspraken te faciliteren.
Iedere pagina is volop in ontwikkeling en onderhanden werk voor de Werkgroepen of de Architectenraad Edu-V. We streven naar een volledige specificatie voor de Proof of Concepts in de werkgroep Verwerven en in gebruik nemen en Uitwisselen summatieve toetsresultaten. De status van iedere pagina en het stadium is aangegeven met een Label.
Op termijn wordt het afsprakenstelsel uitgebreid met specificaties voor de overige werkgroepen. Meer informatie over het programma Edu-V is te vinden op de website:
Missie
De kwaliteit van het onderwijs verhogen door het realiseren van een efficiënte, veilige, betrouwbare en toekomstbestendige infrastructuur en ecosysteem van digitale leer- en onderwijsmiddelen.
Doelstelling
Het realiseren van een efficiënte, veilige, betrouwbare en toekomstbestendige infrastructuur enecosysteem van digitale leer- onderwijsmiddelen, met werkende (open) standaarden, basisvoorzieningen en afspraken waar alle publieke en private partijen zich aan houden, zodat (open en gesloten) digitale leer- en onderwijsmiddelen probleemloos kunnen worden besteld, gebruikt en gecombineerd en zodat een gelijk speelveld ontstaat met voldoende ruimte voor keuzevrijheid en innovatie. Hiermee realiseert Edu-V de randvoorwaarden voor meer flexibiliteit, meer maatwerk en toekomstbestendig onderwijs.
Labels
Het afsprakenstelsel is volop in ontwikkeling. Dit betekent dat pagina’s in allerlei verschillende stadia kunnen zitten. Van de eerste fase van ideevorming tot aan gereed voor validatie tijdens een POC.
Iedere pagina in het Afsprakenstelsel heeft een label over de fase van het ontwikkelproces:
DRAFT : eerste schets van de pagina. Adviseurs en experts uit het programma Edu-V bereiden de inhoud van de afspraken voor.
WERKGROEP : de werkgroep bespreekt de draft pagina en toetst deze op volledigheid, consistentie, samenhang en beoogde werking.
KLANKBORDgroep : de klankbordgroep bespreekt de draft pagina en toetst deze op volledigheid, consistentie, samenhang en beoogde werking.
ARCHITECTenraad : de Architectenraad Edu-V bespreekt de draft pagina en toetst deze op volledigheid, consistentie, samenhang en beoogde werking. Tevens toetst de Architectenraad of de uitwerking voldoet aan het Architectuurkader.
REDACTIE : de pagina is gereed voor publicatie en wordt gecontroleerd op taalgebruik, formulering en consistentie en correcte werking van links.
BESLUITVORMING : de pagina wordt ingebracht als voorstel tot besluit.
CONCEPT : de pagina is gereed voor gebruik in POC, PILOT, Implementatie.
Iedere pagina in het afsprakenstelsel heeft een aanduiding voor de fase van de beoogde toepassing:
POC: pagina die gevalideerd wordt in een Proof of Concept.
PILOT : pagina die geïmplementeerd wordt in een Pilot.
BEHEER : pagina die geimplementeerd is en doorontwikkeld wordt in het Afsprakenstelsel.
Alle pagina’s van het Afsprakenstelsel hebben op dit moment de toepassing POC .
Werkgroepen
Het Edu-V afsprakenstelsel wordt ontwikkeld door leveranciers en scholen uit het primair onderwijs, voortgezet onderwijs, speciaal onderwijs en middelbaar beroepsonderwijs. De totstandkoming vindt plaats in werkgroepen gericht op specifieke onderdelen van het Afsprakenstelsel. Bij iedere pagina van het Afsprakenstelsel is aangegeven welke werkgroep de auteur is en verantwoordelijk is voor de inhoud.
De volgende werkgroepen zijn op dit moment actief:
Architectenraad Edu-V
Werkgroep Beheersing
Werkgroep Doorgifte identiteiten
Werkgroep Verwerven en in gebruik nemen
Werkgroep Uitwisselen summatieve toetsresultaten
Op termijn gaan de volgende werkgroepen starten:
Werkgroep Combineren en arrangeren leermaterialen
Werkgroep Plannen en afnemen van toetsen
Werkgroep Evalueren leervoortgang en -resultaten
De algemene pagina’s in het afsprakenstelsel worden geschreven door het Programmateam Edu-V.
Contactpersoon
Indien u vragen, opmerkingen of suggesties heeft over de inhoud van het Afsprakenstelsel dan kunt u contact opnemen met Koen Voermans, Product Owner Edu-V via zijn e-mailadres info@edu-v.org.
Release notes
Deze uitwerking is gebaseerd op basis van de volgende stappen:
0.0.1: De introductie en aanleiding is gebaseerd op het startdocument Edu-V.
0.0.2: De scope is gebaseerd op basis van werkconferenties van het Keten Beleidsoverleg Edu-K in de periode februari – maart 2023.
0.0.3: De architectuur is gebaseerd op bijeenkomsten van de Architectenraad Edu-V in de periode december tot en met april 2023.
0.0.4: Edu-V praktijksituaties toegevoegd en use cases voor praktijksituaties Verwerven en in gebruik nemen ter review gedeeld met de werkgroep Verwerven en in gebruik nemen.
0.0.5: De architectuur is op basis van de werkconferentie van de Architectenraad Edu-V verder uitgewerkt in:
0.0.6: Aanvullingen in Architectuur en werkgroepen:
De architectuur is op basis de feedback uit de bijeenkomsten van de Architectenraad Edu-V van 12 en 24 mei uitgewerkt voor:
Scenariobeschrijvingen Uitwisselen summatieve toetsresultaten
0.0.7: De draft versies voor de POC specificaties zijn toegevoegd. Het betreft de volgende pagina’s:
Uitwisselen summatieve toetsresultaten:
Verwerven en in gebruik nemen:
0.0.8: Er is een pagina toegevoegd waarin leveranciers die interesse hebben in de proof of concepts een overzicht hebben van de te ontwikkelen onderdelen uit het afsprakenstelsel: Proof of concept handreiking leveranciers.
0.0.9: Op basis van feedback uit de werkgroepen is de 80% specificatie voor de proof of concepts opgeleverd. Tegelijkertijd is gestart met het uitwerken van de 100% technische specificatie. Dit heeft tot de volgende wijzigingen geleid:
Architectuurkader
Mandatenregister is hernoemd naar Verwerkersregister
Bij de gegevensdefinities zijn de Engelse technical terms toegevoegd aan de Nederlandse benamingen
De pagina over de berichtenstructuur is aangepast naar het transactiepatroon Abonneren op wijzigingen middels notificaties
BasispoortId is toegevoegd als identifier voor onderwijsorganisaties voor de Proof of Concept in het primair onderwijs
Verwerven en in gebruik nemen leermiddelen
Nieuwe pagina Conceptueel model toegevoegd waarin het samenspel tussen alle referentiecomponenten inzichtelijk is.
Varianten van ketensamenwerkingen is aangepast. Bestellen van leermiddelen is in consistentie aangepast naar nieuwe varianten van ketensamenwerkingen
APIs
Events API is aangepast naar een abonneeservice en een notificatieservice voor het transactiepatroon Abonneren op wijzigingen middels notificaties.
Mandate API is nieuw gespecificeerd.
Consent API is aangepast naar het nieuwe model waarbij consent wordt gegeven op een gegevenssoort (dit was een API).
Catalogue API heeft een GET all products endpoint gekregen.
SIS API heeft GET all endpoints gekregen, teacher is hernoemd naar employee met een rol en class is een separaat object geworden.
Entitlement API, Usage API, Results API zijn voorzien van PUT endpoints om berichten direct te kunnen pushen naar de ontvangers.
SIS API, Entitlement API, Usage API, Results API bevatten persoonsgegevens. De edu_org_id is toegevoegd als query parameter aan de endpoints om zo te voldoen aan de M2M identificatie en authententicatie flow.
In de Results API is de nieuwe berichtdefinitie voor Result opgenomen.
Inhoudsopgave
Het Afsprakenstelsel Edu-V bestaat uit de volgende pagina’s: