Afsprakenstelsel Edu-V
Titel | Afsprakenstelsel Edu-V |
Status | In ontwikkeling BEsluitvorming in beheer |
Versie | 0.0.13 |
Auteur | Programmateam Edu-V |
Datum | 18 April 2024 |
Op deze omgeving worden alle (in ontwikkeling zijnde) afspraken 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 implementatie in de najaarsrelease. De status van iedere pagina en het stadium is aangegeven met een Label.
Op termijn wordt het afsprakenstelsel uitgebreid met specificaties voor alle 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 implementatie.
Iedere pagina in het Afsprakenstelsel heeft een label over de fase van het ontwikkelproces:
IN ONTWIKKELING : de pagina is ontwikkeling bij de werkgroep, wordt gereviewd door de klankbordgroep en/of de architectenraad.
ROSA-architectuurscan : de pagina is onderdeel van een ROSA-architectuurscan.
BESLUITVORMING : de pagina wordt ingebracht als voorstel tot besluit.
IN beheer : de pagina is gereed voor gebruik in de Implementatie.
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 Toetsen en Examineren
Werkgroep Combineren en arrangeren leermaterialen
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.
0.0.10: Labels aangepast en verwijzing naar POC’s verwijderd.
0.0.11: In deze versie zijn wijzigingen gedaan in het architectuurkader, is de herziening consent verwerkt, zijn de gegevensdiensten uitgewerkt en is functionele en technische documentatie voor de praktijksituaties toegevoegd. Dit heeft geleid tot de volgende wijzigingen:
In het Architectuurkader Edu-V:
Zijn de Architectuurprincipes in TOGAF formaat uitgewerkt.
Zijn de Business en ondersteunende rollen verwijderd en is de lijst met referentiecomponenten geactualiseerd en afgestemd op het ROSA begrippenkader.
Zijn de transactierollen specifiek uitgewerkt op de pagina Transactiepatronen.
Zijn de gegevensdefinities en is het gegevensmodel herzien op basis van de definities uit het ROSA begrippenkader.
Is de herziening Consent verwerkt in de pagina over M2M gegevensuitwisselingen.
Is het nieuwe patroon voor federatieve toegang toegevoegd aan H2M identificatie en authenticatie.
Zijn de primaire en secundaire identifiers voor onderwijsdeelnemers en onderwijsorganisaties uitgewerkt op de pagina Identiteiten.
Is de pagina gegevenssoorten geactualiseerd met de nieuwe gegevensdefinities en de toegevoegde APIs.
Er is een nieuwe sectie Regie op gegevens uitgewerkt waarin de herziening Consent is verwerkt:
Consent is volledig herzien op basis van feedback ontvangen vanuit leveranciers die zich ingeschreven hebben voor de POC’s. Er is een laagdrempelige variant van Consent ontwikkeld voor leveranciers die geen noodzaak hebben tot een eigen API. Ook is het verwerkersregister geen verplicht onderdeel meer van de Consent flow en leidt het niet aanwezig zijn van een verwerkersovereenkomst niet tot een operationele blokkade maar tot een notificatie aan de applicatiebeheerder.
De Consent API en de DPA (Data Processing Agreement) API zijn opnieuw gespecificeerd.
Er is een nieuwe sectie Edu-V gegevensdiensten uitgewerkt waarin de Edu-V gegevensdiensten zijn beschreven. Deze gegevensdiensten kunnen door referentiecomponenten worden uitgewisseld. In de sectie is voor iedere gegevensdienst de technische vereisten beschreven. Voor iedere referentiecomponent zijn de verplichte en optionele gegevensdiensten gespecificeerd.
De praktijksituatie Verwerven en in gebruik nemen is aangepast waarbij de documentatie is herschreven vanuit referentiecomponenten en gegevensdiensten. Daarnaast zijn de ontbrekende praktijksituaties functioneel gedocumenteerd. Dit heeft geleid tot een aantal nieuwe APIs:
De praktijksituatie Combineren en arrangeren leermiddelen is voorbereid met een draft uitwerking van de Course API.
De praktijksituatie Evalueren leervoortgang en -resultaten is voorbereid met een draft uitwerking van de Progress API.
0.0.12: De sectie Beheerprocessen en Privacy richtlijnen is toegevoegd vanuit de werkgroep Beheersing. Daarnaast is functionele documentatie toegevoegd van de werkgroepen:
0.0.13: De volgende wijzigingen zijn doorgevoerd:
De adviezen uit de ROSA-architectuurscan zijn verwerkt in het Architectuurkader.
Het wijzigingsverzoek op Regie op gegevens is verwerkt.
De feedback vanuit de werkgroep Verwerven en in gebruik nemen is verwerkt in de functionele en technische specificaties.
De praktijksituatie Doorgifte identiteiten is toegevoegd.
De gegevensdiensten uit de Administratiesystemen zijn functioneel en technisch uitgewerkt.
De verplichte en optionele gegevensdiensten zijn scherper geformuleerd voor alle referentiecomponenten.
De feedback vanuit de werkgroep Toetsen en examineren is verwerkt voor Administreren leerresultaten.
De waardelijst Onderwijsniveaus en leerjaren is toegevoegd.
De APIs zijn bijgewerkt met alle wijzigingen.
Inhoudsopgave
Het Afsprakenstelsel Edu-V bestaat uit de volgende pagina’s: