From 2bd53b7657ccda17b55a0a7f8d3d695d2f408050 Mon Sep 17 00:00:00 2001 From: Mwest2020 Date: Wed, 26 Jun 2024 22:46:16 +0200 Subject: [PATCH] all committed --- docs/GOVERNANCE.md | 10 ++++------ docs/KoopHulp.md | 4 ---- docs/partners/Datamask.md | 27 +++++++++++++++++---------- docs/partners/DeVault.md | 14 +++++--------- docs/partners/Dimpact.md | 34 +++++++++++++++++++--------------- docs/partners/Tilburg.md | 12 ++++++------ 6 files changed, 51 insertions(+), 50 deletions(-) diff --git a/docs/GOVERNANCE.md b/docs/GOVERNANCE.md index 5e5a1c8a..401a5c8d 100644 --- a/docs/GOVERNANCE.md +++ b/docs/GOVERNANCE.md @@ -4,19 +4,17 @@ Het succes en de continue verbetering van het OpenWoo.app project zijn afhankeli ## Open Webconcept -OpenWoo.app is een doorontwikkeling van de OpenWoo wordpress plugin uit OpenWebconcept. Vanuit die oorsprong is OpenWoo.app eigenlijk een subcommunity van OpenWebconcept. De community staat echter nadrukkenlijk open voor niet OWC afnemers en leveranciers. +OpenWoo.app is een doorontwikkeling van de OpenWoo WordPress-plugin uit Open Webconcept. Vanuit die oorsprong is OpenWoo.app eigenlijk een subcommunity van OpenWebconcept. De community staat echter nadrukkelijk open voor niet OWC-afnemers en leveranciers. De gemeente Gouda vormt hierin de linking pin - -Gemeenten zo als Noordwijk, Gouda, Barendrecht, Allbaserwaard, Ridderkerk en Hoeksewaard vormen met de deelname aan - +Gemeenten zo als Noordwijk, Gouda, Barendrecht, Alblasserwaard, Ridderkerk en Hoeksche Waard vormen met de deelname aan ## Community Meetings -Iedereen die actief gebruik maakt OpenWoo.app of intresse heeft in de ontwikkeling hiervan is welkom op de maandenlijke community meeting. De community meetings zijn de plek waar we de roadmap doornemen daar proberen gemeenchapenlijk beslutien op te nemen +Iedereen die actief gebruik maakt OpenWoo.app of interesse heeft in de ontwikkeling hiervan is welkom op de maandelijkse community meeting. De community meetings zijn de plek waar we de roadmap doornemen daar proberen gemeenschappelijk besluiten op te nemen -De community meetings worden aangekondigd via openwoo.app, linkedin en per mail aan de bekenende leveranciers en afnemeners. +De community meetings worden aangekondigd via openwoo.app, LinkedIn en per mail aan de bekende leveranciers en afnemers. ## Stuurgroep diff --git a/docs/KoopHulp.md b/docs/KoopHulp.md index b70102a1..14743d9c 100644 --- a/docs/KoopHulp.md +++ b/docs/KoopHulp.md @@ -2,10 +2,6 @@ Vanuit de gemeente Buren is Koophulpje.nl opgezet. Het doel van Koophulpje is het doen van een proof of concept (poc) met de OpenWoo.app en het stellen van integrale zoek vragen aan de hand van het federale data stelsel (FSC) en API's. -## Voorgeschiedenis - -asd - ## Voordelen - Het uitvragen van informatie via API's is gemakkelijker te integreren dan sitemap.xml diff --git a/docs/partners/Datamask.md b/docs/partners/Datamask.md index 4879d856..0af7ffee 100644 --- a/docs/partners/Datamask.md +++ b/docs/partners/Datamask.md @@ -1,37 +1,44 @@ # Datamask -OpenWoo.app en Datamask willen graag een gemeenschappenlijek propositie voeren voor de WOO + +OpenWoo.app en Datamask willen graag een gemeenschappelijke propositie voeren voor de WOO ## Product Datamask -Datamask zet de kracht van haar reeds bestaande koppelingen vanuit haar anonimiserings tool (en e.v.t. publicatie platform) in + +Datamask zet de kracht van haar reeds bestaande koppelingen vanuit haar anonimiseringstool (en e.v.t. publicatie platform) in Heeft wel -- Anonimesering + +- Anonimisering - Zoekindex a.h.v huidige koppelingen - Organisatie breder publicatie pagina - Beheerschermen en configuratie op de inrichting Heeft niet + - Federatief en organisatie overkoepelend zoeken ## Product OpenWoo.app + Datamask zet de kracht van haar data federalisatie en common ground netwerk in. Heeft wel + - Federaliseren van indexen - NL Design voorkant - Volledig open source - Koppeling met Koop -- Meezoeken in andere organisaties (samenwerkings verbanden, provincies etc) -- Ondersteuning vanuit het common ground programma +- Meezoeken in andere organisaties (samenwerkingsverbanden, provincies etc.) +- Ondersteuning vanuit het Common Ground programma -Heeft niet -- Anonimeseringstool -- Beheers interface op het koppelvlak +Heeft geen + +- Anonimiseringstool +- Beheerinterface op het koppelvlak ## Samenwerking -De samenwerking kan er redelijk simpel uitzien, Datamask kan als aditionele funtionaliteit publiceren richting OpenWoo.app (daarvoor moet de betreffende afnemer wel over het motorblok van OpenWoo.app en Datamask beschicken). Vervolgens kan OpenWoo.app deze data beschickbaar maken op haar federale netwerk en door publiceren naar KOOP en WOOGLE aanvullend kan Datamask ook gegevens ophalen vanuit OpenWoo.app en zo ook aanvullende catageorien naast verzoeken weergeven in haar publicatie platform. +De samenwerking kan er redelijk simpel uitzien, Datamask kan als additionele functionaliteit publiceren richting OpenWoo.app (daarvoor moet de betreffende afnemer wel over het motorblok van OpenWoo.app en Datamask beschikken). Vervolgens kan OpenWoo.app deze data beschikbaar maken op haar federale netwerk en door publiceren naar KOOP en WooGLe aanvullend kan Datamask ook gegevens ophalen vanuit OpenWoo.app en zo ook aanvullende categorieën naast verzoeken weergeven in haar publicatie platform. ## Architectuur -![OpenWeb Architecture](https://raw.githubusercontent.com/ConductionNL/woo-website-template/main/docs/Datamask.svg) \ No newline at end of file +![OpenWeb Architecture](https://raw.githubusercontent.com/ConductionNL/woo-website-template/main/docs/Datamask.svg) diff --git a/docs/partners/DeVault.md b/docs/partners/DeVault.md index b70102a1..7d0fc063 100644 --- a/docs/partners/DeVault.md +++ b/docs/partners/DeVault.md @@ -1,10 +1,6 @@ # Koop Hulp(je) -Vanuit de gemeente Buren is Koophulpje.nl opgezet. Het doel van Koophulpje is het doen van een proof of concept (poc) met de OpenWoo.app en het stellen van integrale zoek vragen aan de hand van het federale data stelsel (FSC) en API's. - -## Voorgeschiedenis - -asd +Vanuit de gemeente Buren is [Koophulpje.nl](koophulpje.nl) opgezet. Het doel van Koophulpje is het doen van een Proof-of-Concept (poc) met de OpenWoo.app en het stellen van integrale zoekvragen aan de hand van het federale datastelsel (FSC) en API's. ## Voordelen @@ -16,18 +12,18 @@ asd - Koophulpje.nl is een 'platte' React pagina, ze beschikt niet over een eigen server, maar maakt direct gebruikt van één API - Deze API bevat de gegevens van meerdere gemeenten aan de hand van federale bevraging -- Ter vergelijking creëren we ook sitemap en robot bestanden voor dezelfde gemeenten t.b.v van de door KOOP voorgestelde harverster +- Ter vergelijking creëren we ook sitemap en robot bestanden voor dezelfde gemeenten t.b.v van de door KOOP voorgestelde harverster. ## Bevindingen -Dataveiligheid: Tijdens vroege testen kwam snel naar voren dat het via API de bron bevragen in plaats van het opbouwen van een index een databeveiligheidsverbeteringen opleverde. Foutieve test data kon snel worden verwijderd en was na verwijdering in het bronsysteem geen onderdeel meer van het federale netwerk en daardoor niet meer vindbaar via Koophulpje. +Dataveiligheid: Tijdens vroege testen kwam snel naar voren dat het via API de bron bevragen in plaats van het opbouwen van een index een verbetering voor de databeveiliging opleverde. Foutieve test data kon snel worden verwijderd en was na verwijdering in het bronsysteem geen onderdeel meer van het federale netwerk en daardoor niet meer vindbaar via Koophulpje. Hoewel dit bij het testen vooral fijn was, levert het bij daadwerkelijke productie gang een sterk voordeel op. Het stelt organisaties in staat om gegevens terug te trekken. Bijvoorbeeld bij het per ongeluk publiceren van persoonsgegevens kunnen de gegevens onmiddellijk worden teruggetrokken (i.p.v. dat er moet worden gewacht op de volgende keer data de harvester langs komt). Schaalbaarheid: Het generen van sitemap.xml-bestanden aan de hand van grotere datasets (1000+) blijkt intensief te zijn -Belasting en kosten: Het genereren van grote sitemap bestanden is server intensief, het confronteert de publicerende overheid daarmee met relatief hoge kosten. We vermoeden dat dit ook geld aan de kant van de harvester. +Belasting en kosten: Het genereren van grote sitemap bestanden is server intensief, het confronteert de publicerende overheid daarmee met relatief hoge kosten. We vermoeden dat dit ook geld aan de kant van de harvester.   -Actualiteit: Doordat de sitemap xml bestanden groot zijn blijkt het niet uitvoerbaar om ze bij elke wijziging bij te werken (bijvoorbeeld toegekende vergunning of afgeronde zaak) ipv daarvan worden ze 's nachts gegenereerd. Dit betekent dat het koppelvlak per definitie achterloopt. +Actualiteit: Doordat de sitemap xml bestanden groot zijn blijkt het niet uitvoerbaar om ze bij elke wijziging bij te werken (bijvoorbeeld toegekende vergunning of afgeronde zaak) i.p.v. daarvan worden ze 's nachts gegenereerd. Dit betekent dat het koppelvlak per definitie achterloopt. We interpreteren de WOO als alle niet vertrouwelijke gegevens moeten pro-actief openbaar worden gemaakt. Door gebruik te maken van API's in plaats van sitemap xml bestanden zorgen we dat de gegevens alleen worden verstuurd op het moment dat ze worden opgevraagd. Dat vergroot het dataverkeer bij gebruik, maar voorkomt dataverkeer vooraf. diff --git a/docs/partners/Dimpact.md b/docs/partners/Dimpact.md index 13643e87..674d2c1b 100644 --- a/docs/partners/Dimpact.md +++ b/docs/partners/Dimpact.md @@ -1,32 +1,36 @@ # Dimpact -Dimpact heeft als samenwerkings en inkoop organisatie vanuit diverce van haar leden de vraag gekregen om te verkennen hoe een eventueele in het kader van de Wet open overheid zou kunnen worden vormgegeven. Dimpact heeft deze verkenning in eerste instantie gemeenschappenlijk met de gemeente Rotterdam uitgevoerd. +Dimpact heeft als samenwerkings- en inkooporganisatie vanuit diverse van haar leden de vraag gekregen om te verkennen hoe een eventuele in het kader van de Wet open overheid zou kunnen worden vormgegeven. Dimpact heeft deze verkenning in eerste instantie gemeenschappelijk met de gemeente Rotterdam uitgevoerd. -Tijdens deze verkenning is Dimpact de oplossing OpenWoo.app tegen gekomen voor het publiceren van Woo verzoeken naar een publicatie pagina én landelijke platformen zo als KOOP. Vanuit hergebruik heeft Dimpact de wens om deze oplossing in te zetten en zich eventueel aan te sluiten bij de OpenWoo.app community. +Tijdens deze verkenning is Dimpact de oplossing OpenWoo.app tegengekomen voor het publiceren van Woo verzoeken naar een publicatie pagina én landelijke platformen zo als KOOP. Vanuit hergebruik heeft Dimpact de wens om deze oplossing in te zetten en zich eventueel aan te sluiten bij de OpenWoo.app community. ## Overwegingen -- OpenWoo.app kent een community van actieve leden waaronder naast gemeentelijke overheden ook provincies, code for nl, open state foundation en het nationaal archief. + +- OpenWoo.app kent een community van actieve leden waaronder naast gemeentelijke overheden ook provincies, Code for NL, Open State foundation en het Nationaal Archief. - OpenWoo.app heeft een beproefde koppeling met KOOP - OpenWoo.app kan publiceren vanuit open zaak. -- OpenWoo.app maakt hergebruik van binnen Open Catalogi ontwikkelde componenten -- OpenWoo.app is onderdeel van het commonground portfolio met een rating van zilver +- OpenWoo.app maakt hergebruik van binnen OpenCatalogi ontwikkelde componenten +- OpenWoo.app is onderdeel van het Common Ground-portfolio met een rating van goud - OpenWoo.app bied naast het zaaksysteem ook werkende koppelingen met andere bronnen -- OpenWoo.app draaid reeds bij verscheidende overheden in productie -- OpenWoo.app heeft *geen* annonimiserings component -- OpenWoo.app heeft *geen* afhandel component voor Woo verzoeken +- OpenWoo.app draait reeds bij verscheidende overheden in productie +- OpenWoo.app heeft *geen* annonimiseringscomponent +- OpenWoo.app heeft *geen* afhandelcomponent voor Woo verzoeken ## Conclusie -De OpenWoo.app kan op een goede manier invulling geven aan de publicatie vraag van Dinpact. De reeds gekopelde bronnen geven invulling aan de behoefte van de Dimpact leden en daar waar nieuwe extra bronnen nodig zijn is er een actieve community waarin deze (ook buiten Dimpact om) ontwikkeld kunnen worden. Ook de samenwerking met IO bied Dimpact gemeente een snel implementeerbare route op Open Online richting productie. Het inzetten van de oplossing ligt dan ook voor de hand. -Echter, naar OpenWoo.app zal Dimpact echter wel zelf moeten faciliteren op het afhandelen en anonimiseren van Woo verzoeken. Dit zal seperaat moeten worden neergezet, zowel Datamask, Mylex als andere markt partijen bieden hier ook losse oplossingen voor aan. Als alternatief voor deze losse oplossingen zou Dimpact ook kunnen inzetten op afhandeling via haar eigen podium d componenten zo als open formulieren en zaak afhandel component. Voor het annonimiseren zou samenwekring kunnen worden gezocht met de gemeente Buren (OWC) die wil inzetten op een open source annonimiserings tool. + +De OpenWoo.app kan op een goede manier invulling geven aan de publicatie vraag van Dimpact. De reeds gekoppelde bronnen geven invulling aan de behoefte van de Dimpact leden en daar waar nieuwe extra bronnen nodig zijn is er een actieve community waarin deze (ook buiten Dimpact om) ontwikkeld kunnen worden. Ook de samenwerking met IO biedt Dimpact gemeente een snel implementeerbare route op Open Online richting productie. Het inzetten van de oplossing ligt dan ook voor de hand. +Echter, naar OpenWoo.app zal Dimpact echter wel zelf moeten faciliteren op het afhandelen en anonimiseren van Woo verzoeken. Dit zal separaat moeten worden neergezet, zowel Datamask, My-Lex als andere markt partijen bieden hier ook losse oplossingen voor aan.  Als alternatief voor deze losse oplossingen zou Dimpact ook kunnen inzetten op afhandeling via haar eigen Podium D-componenten zo als open formulieren en zaak afhandel component. Voor het annonimiseren zou samenwerking kunnen worden gezocht met de gemeente Buren (OWC) die wil inzetten op een open source annonimiseringstool. ## Werkzaamheden -Voor beheer, onderhoud en support kan Dimpact aansluiten bij de huidige community, dit heeft als voordeel dat Dimpact niet alleen minder verantwoordelijkheid naar zich toetrekt maar ook een reeds goedlopende community (financieel) ondersteund en beloond voor haar inspanningen. Dit aanhaken boven overnemen verstevigd het opensource ecosysteem zonder hogere kosten. + +Voor beheer, onderhoud en support kan Dimpact aansluiten bij de huidige community, dit heeft als voordeel dat Dimpact niet alleen minder verantwoordelijkheid naar zich toetrekt, maar ook een reeds goedlopende community (financieel) ondersteund en beloond voor haar inspanningen. Dit aanhaken boven overnemen verstevigt het open source ecosysteem zonder hogere kosten. Voor het traject tót publicatie staat Dimpact echter voor een meer ingewikkelde keuze, kort samengevat zijn er drie opties: -- De opensource keten overnemen zo als deze bij OWC staat (dat zou de introductie van xxllnc zaak registraties betekenen) -- Op haar eigen podium d componenten een oplossing vormgeven (dit zou werk voor eigen ontwikkelaars betekeken, en los hiervan een annonimiserings tool onboarden) -- Een commerciele woo verzoeken afhandelings flow inkopen + +- De open source keten overnemen zo als deze bij OWC staat (dat zou de introductie van xxllnc zaak registraties betekenen) +- Op haar eigen podium d componenten een oplossing vormgeven (dit zou werk voor eigen ontwikkelaars betekenen, en los hiervan een annonimiseringstool onboarden) +- Een commerciële Woo-verzoeken afhandelingsflow inkopen ## Opmerkingen -Het “gat” met betrekking tot de woo afhandeling bestaat alleen voor Woo verzoeken, voor de overige Woo categorieën kan direct worden gepubliceerd vanuit de huidig bronnen. Hier zal een voorziening voor moeten worden getroffen, maar het is goed om in het oog te houden dat deze per definitie tijdelijk is. Het einddoel van de Woo is dat alle relevante informatie pro-actief openbaar word gemaakt. In de context bestaat een verzoek tot openbaar making niet meer. +Het “gat” met betrekking tot de Woo-afhandeling bestaat alleen voor Woo-verzoeken, voor de overige Woo categorieën kan direct worden gepubliceerd vanuit de huidig bronnen. Hier zal een voorziening voor moeten worden getroffen, maar het is goed om in het oog te houden dat deze per definitie tijdelijk is. Het einddoel van de Woo is dat alle relevante informatie pro-actief openbaar wordt gemaakt. In de context bestaat een verzoek tot openbaarmaking niet meer. diff --git a/docs/partners/Tilburg.md b/docs/partners/Tilburg.md index 0b094c27..64b637dd 100644 --- a/docs/partners/Tilburg.md +++ b/docs/partners/Tilburg.md @@ -2,7 +2,7 @@ ## Context -De gemeente Tilburg wil graag een WOO publicatieplatform inrichten met daarbij een focus op zo min mogelijk handmatige acties. Zij heeft hiervoor de leverancier Acato aangetrokken. Zij heeft kennis genomen van OpenWoo.app en wil graag kijken of dit onderdeel kan zijn van haar oplossing. Acato en Conduction hebben hier al vaker contact over gehad en het lijkt ons inderdaad een reële oplossing. +De gemeente Tilburg wil graag een WOO-publicatieplatform inrichten met daarbij een focus op zo min mogelijk handmatige acties. Zij heeft hiervoor de leverancier Acato aangetrokken. Zij heeft kennis genomen van OpenWoo.app en wil graag kijken of dit onderdeel kan zijn van haar oplossing. Acato en Conduction hebben hier al vaker contact over gehad en het lijkt ons inderdaad een reële oplossing. We hebben hierbij gekeken naar wat er reeds beschikbaar is en zonder uitbreiding kan worden ingezet, welke componenten er nog uitgebreid zouden moeten worden en welke er überhaupt zouden moeten worden gebouwd. Dat brengt ons tot het volgende inzicht. @@ -19,18 +19,18 @@ Naast de standaard koppelingen (KOOP, WooGLe), heeft de gemeente een keuze te ma - **`OpenGemeente` Website (keuze / uitbreiden):** Vanuit Open Gemeenten is er een Typo3 plugin beschikbaar voor het integreren van OpenWoo.app in de bestaande site. - **`Acato/OpenGemeente` Themapagina (keuze / uitbreiden):** Vanuit Open Gemeenten wordt een losse TYPO3 themapagina aangeboden, maar er zou er ook een kunnen worden gebouwd door Acato. Een themapagina zou een mooie oplossing kunnen zijn voor Tilburg maar is naar waarschijnlijkheid niet direct herbruikbaar door andere gemeenten. - **`Acato` Zoekpagina (keuze / uitbreiden):** Er is momenteel reeds een zoekpagina beschikbaar, maar deze kan zeker nog wat doorontwikkeling aan de hand van gebruikersonderzoek gebruiken. Dit zou kunnen worden uitgevoerd door Acato, voordeel daarvan is dat de ontwikkeling direct bijdraagt aan de gemeenten die deze pagina reeds gebruiken. -- **`Acato` Woo Dashboard:** Op dit moment beschikt de OpenIndex nog niet over een beheersomgeving. Deze zal dus in zijn geheel ontwikkeld moeten worden. +- **`Acato` Woo Dashboard:** Op dit moment beschikt de OpenIndex nog niet over een beheeromgeving. Deze zal dus in zijn geheel ontwikkeld moeten worden. ### Services (laag 4) -- **Backend for frontend:** Op dit moment beschikt de OpenIndex nog niet over een beheersomgeving. Deze zal dus in zijn geheel ontwikkeld moeten worden. +- **Backend for frontend:** Op dit moment beschikt de Open Index nog niet over een beheeromgeving. Deze zal dus in zijn geheel ontwikkeld moeten worden. ### Integratie (laag 3) - **`Conduction`OpenWoo Service (Uitbreiden):** De OpenWoo service is reeds beschikbaar en in gebruik, toch verwachten wij dat er nog kleine aanpassingen nodig zijn voor het inlezen van nog niet ondersteunde bronnen (Notubiz, iBabs, SharePoint en DeVault) als het bevragen via de integratievoorziening. Wat in ieder geval positief is, is dat we momenteel reeds in gesprek zijn met Notubiz en DeVault over een koppeling. - **`n.v.t` Federatief Netwerk (Beschikbaar):** Het federatieve netwerk van OpenWoo (gebaseerd op FSC/NLX) is reeds beschikbaar en in gebruik. We verwachten niet dat hier aanpassingen op nodig zijn. - **`Tilburg` Integratieplatform (Beschikbaar):** De gemeente Tilburg heeft zelf reeds een integratieplatform beschikbaar, hiermee kunnen de in Tilburg reeds beschikbare bronnen worden benaderd door de OpenWoo-service. We verwachten niet dat er aanpassingen nodig zijn aan de integratievoorziening. -- **`Conduction` OpenIndex (Uitbreiden):** Voor het indexgedeelte van de OpenWoo.app geldt dat deze publicaties niet langer automatisch door moet zetten maar pas na een controle en aanvulling door een medewerker. Dat betekent een aantal zaken, om te beginnen zal de index een soort van buffer moeten kunnen zijn voor publicatieobjecten daarnaast zullen er API-endpoints en business logica moeten komen voor het beheer van publicaties. Hierbij doen zich ook een aantal vragen voor als een publicatie daadwerkelijk wordt aangepast (is dan de bron of index leidend). Met name het uitvogelen van de benodigde business logica zal nog flink wat uitwerking vragen. +- **`Conduction` OpenIndex (Uitbreiden):** Voor het indexgedeelte van de OpenWoo.app geldt dat deze publicaties niet langer automatisch door moet zetten, maar pas na een controle en aanvulling door een medewerker. Dat betekent een aantal zaken, om te beginnen zal de index een soort van buffer moeten kunnen zijn voor publicatieobjecten daarnaast zullen er API-endpoints en business logica moeten komen voor het beheer van publicaties. Hierbij doen zich ook een aantal vragen voor als een publicatie daadwerkelijk wordt aangepast (is dan de bron of index leidend). Met name het uitvogelen van de benodigde business logica zal nog flink wat uitwerking vragen. ### Bronnen (laag 2) @@ -45,9 +45,9 @@ Naast de standaard koppelingen (KOOP, WooGLe), heeft de gemeente een keuze te ma ![OpenWeb Architecture](https://raw.githubusercontent.com/ConductionNL/woo-website-template/main/docs/Tilburg.svg) -## Overige werksaamheden +## Overige werkzaamheden -- **`Acato` Project menagment:** +- **`Acato` Project management:** - **`Acato` Validatie:** - **`Acato` Design:** - **`Acato` Gebruikers Onderzoek:**