Merge pull request #344 from ConductionNL/main

Main to dev

README.md

@@ -2,22 +2,24 @@
 
 > **Ondersteuning en bijeenkomsten**
 >
-> 
+>
 > Meer weten over deze oplossing? Dat kan! Hiervoor hebben we een apart [Slack kanaal](https://samenorganiseren.slack.com/archives/C067Q3UE9F0) binnen Common Ground. We helpen je daar graag verder. Uiteraard kan je ook altijd mailen naar [[email protected]](mailto:[email protected])
 >
 > Tevens worden vanuit de aangesloten leveranciers worden regelmatig webinars georganiseerd.
-> 
-> - [8 Mei 13:00 | Community Meeting](https://www.linkedin.com/events/openwoo-appcommunitymeetingmei7184090446346768385/comments/).
-> 
+>
+> - [10 Juli 10:00 | Community Meeting](https://www.linkedin.com/events/7206649524776284161/comments/?originTrackingId=BVZjR39lT72%2BfNaik99cew%3D%3D).
+>
 > Terug kijken afgelopen webinars en meetings?
 >
+> - [12-06-2024 | Community Meeting](https://www.youtube.com/watch?v=ab_FEexYYMY).
+> - [09-05-2024 | Community Meeting](https://www.youtube.com/watch?v=Q0ElcTP-R4M).
 > - [10-04-2024 | Community Meeting](https://www.youtube.com/watch?v=zMqElLzy0BM).
-> - [25-03-2024 | Sim-Groep Webinar](https://www.simgroep.nl/toekomstbestendige-woo-oplossing)
+> - [25-03-2024 | SHIFT2](https://www.shift2.nl/een-toekomstbestendige-woo-oplossing)
 > - [13-03-2024 | Community Meeting](https://www.youtube.com/watch?v=TNZghskRu5c).
 > - [14-02-2024 | Community meeting](https://www.youtube.com/watch?v=ri5U8x-lsxo)
 > - [30-01-2024 | OpenGemeente Woobinar](https://vimeo.com/909134953)
-> - [19-12-2023 | xxllnc Demo ](https://www.youtube.com/watch?v=_FGpUYH1yd0)
-> - [17-11-2023 | xxllnc Woobinar ](https://www.youtube.com/watch?v=NCnLDEoPh5A)
+> - [19-12-2023 | xxllnc Demo](https://www.youtube.com/watch?v=_FGpUYH1yd0)
+> - [17-11-2023 | xxllnc Woobinar](https://www.youtube.com/watch?v=NCnLDEoPh5A)
 
 De Wet Open Overheid (Woo) is een initiatief gericht op het verbeteren van de openbaarheid van overheidsinformatie. Het doel is om overheidsinformatie beter toegankelijk te maken voor iedereen. Meer informatie over de Wet Open Overheid kan [hier](https://www.open-overheid.nl/onderwerpen/actieve-openbaarmaking) worden gevonden.
 
@@ -37,19 +39,20 @@ Deze uitdagingen kunnen niet effectief worden aangepakt met een enkel Content Ma
 |-----------------------------------------------------------------------------------------|----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------|--------------------------------------------------------------------------------|
 | [<img src="https://raw.githubusercontent.com/ConductionNL/woo-website-template/main//docs/logos/conduction_svg.svg" height="30" />](https://www.conduction.nl/) | [<img src="https://raw.githubusercontent.com/ConductionNL/woo-website-template/main//docs/logos/xxllnc_orgineel.svg" height="30" />](https://xxllnc.nl/) | [<img src="https://raw.githubusercontent.com/ConductionNL/woo-website-template/main//docs/logos/opengemeente_orgineel.svg" height="30" />](https://www.opengemeenten.nl/) | [<img src="https://raw.githubusercontent.com/ConductionNL/woo-website-template/main//docs/logos/sim_svg.svg" height="30" />](https://www.simgroep.nl/) | [<img src="https://raw.githubusercontent.com/ConductionNL/woo-website-template/main//docs/logos/acato_orgineel.svg" height="20" />](https://acato.nl/) | [<img src="https://raw.githubusercontent.com/ConductionNL/woo-website-template/main//docs/logos/notubiz_svg.svg" height="30" />](https://www.notubiz.nl/)| [<img src="https://raw.githubusercontent.com/ConductionNL/woo-website-template/main//docs/logos/io_orgineel.svg" height="30" />](https://www.drupalvoorgemeenten.nl/)|
 
-## Belangrijkste functionaliteiten en voordelen van OpenWoo.app:
+## Belangrijkste functionaliteiten en voordelen van OpenWoo.app
+
 - **Centrale Index Pagina:** Een overzichtelijke locatie voor alle openbare data van uw organisatie voor verbeterde vindbaarheid van informatie.
 - **Multibron Dataweergave:** Een naadloze integratie en presentatie van data uit diverse bronnen, zoals het zaaksysteem, websites, raadsinformatiesystemen en archieven.
 - **Keuze uit Publicatieplatformen:** Met opties zoals NL Design React en Open Gemeente Typo 3, biedt OpenWoo.app flexibiliteit in de manier waarop uw gegevens gepubliceerd worden, terwijl het tegelijkertijd eenvoudig integreerbaar is in uw huidige website.
 - **Automatische Data-aanlevering:** Efficiënte aanlevering bij landelijke indexen zoals KOOP en Woogle, door middel van sitemap.xml-bestanden en API's, vergroot het bereik en de zichtbaarheid van uw gegevens.
 - **Proactieve Publicatie:** Automatiseer het publicatieproces en verminder handmatige inspanningen met de slimme, proactieve publicatiefuncties van OpenWoo.app.
-- **Toekomstbestendig en Veilig:** Bereid uw organisatie voor op toekomstige ontwikkelingen met configureerbare publicatietypen en verhoog de veiligheid en efficiëntie door het verminderen van directe bevragingen op bronnen. 
+- **Toekomstbestendig en Veilig:** Bereid uw organisatie voor op toekomstige ontwikkelingen met configureerbare publicatietypen en verhoog de veiligheid en efficiëntie door het verminderen van directe bevragingen op bronnen.
 
 ![epe.png](https://raw.githubusercontent.com/ConductionNL/woo-website-template/main/docs/epe.png "Woo Website van de Gemeente Epe")
 
 Wil je meer weten over de functionaliteiten van de Open Woo-app? Kijk dan op de [architectuur pagina](/docs/product/Features.md).
 
-## Oplossing van OpenWoo.app:
+## Oplossing van OpenWoo.app
 
 OpenWoo.app gaat verder dan alleen deze basisfunctionaliteiten door een geïntegreerde oplossing aan te bieden die bestaat uit essentiële componenten:
 
@@ -58,12 +61,12 @@ OpenWoo.app gaat verder dan alleen deze basisfunctionaliteiten door een geïnteg
 - **Zoekpagina (Optioneel):** Een op NL Design gebaseerd publicatieplatform dat belanghebbenden in staat stelt om naar relevante informatie te zoeken.
 - **Open WooService:** Deze module verzamelt informatie uit verschillende bronnen, waardoor een gecentraliseerde toegang tot diverse categorieën van gegevens mogelijk wordt.
 - **Open Index:** Een opgebouwde index van openbare informatie die samen met andere zoekindexen een landelijke federatie vormt.
-- **Overige Bronnen (Optioneel):** Bronnen zoals het Zaaksysteem, Raadsinformatiesysteem en archief kunnen optioneel worden gekoppeld, met ondersteuning voor handmatige uploads via het CMS van uw huidige website. 
-
+- **Overige Bronnen (Optioneel):** Bronnen zoals het Zaaksysteem, Raadsinformatiesysteem en archief kunnen optioneel worden gekoppeld, met ondersteuning voor handmatige uploads via het CMS van uw huidige website.
 
 Deze geïntegreerde aanpak zorgt voor een naadloze, efficiënte en effectieve implementatie van de Wet Open Overheid (Woo), waardoor overheidsorganisaties hun informatie op een gebruiksvriendelijke en toegankelijke wijze kunnen delen. OpenWoo.app is niet alleen een tool om te voldoen aan de Wet open overheid (Woo), maar een strategische partner die handwerk vermindert, transparantie bevordert, en de toegankelijkheid van overheidsinformatie aanzienlijk verbetert.
 
 De OpenWoo.app architectuur is bewust ontworpen om gemeenten de keuze te geven in hoe zij willen omgaan met de Wet Open Overheid en KOOP
+
 - Wil je automatisch publiceren uit je huidige zaaksysteem? dat kan!
 - Liever publiceren uit je huidige website? dat kan ook!
 - Of wil je bij KOOP aanleveren vanuit een kleine openzaak installatie? dan kan dat natuurlijk ook.
@@ -80,6 +83,8 @@ Op dit moment wordt de OpenWoo.app al door een aantal organisaties gebruikt
 |-------------|------|------------|--------------|--------|
 | [Noordwijk](https://www.noordwijk.nl/) | Gemeente |  [Pagina](open.noordwijk.nl) | Zaaksysteem.nl  | Productie |
 | [Epe](https://www.epe.nl/) | Gemeente |[Pagina](https://open.epe.nl/) | Zaaksysteem | Productie  |
+| [Roosendaal](https://www.roosendaal.nl/) | Gemeente |[Pagina](https://open.roosendaal.nl/) | Zaaksysteem | Productie  |
+| [Zutphen](https://www.zutphen.nl/) | Gemeente |[Pagina](https://open.zutphen.nl/) | Zaaksysteem | Productie  |
 | [Tubbergen](https://www.tubbergen.nl/) | Gemeente |[Pagina](https://conductionnl.github.io/woo-website-tubbergen/) | Zaaksysteem.nl  | Acceptatie |
 | [Dinkelland](https://www.dinkelland.nl/) | Gemeente |[Pagina](https://conductionnl.github.io/woo-website-dinkelland/) | Zaaksysteem.nl | Acceptatie |
 | [Gouda](https://www.gouda.nl/) | Gemeente |[Pagina](https://conductionnl.github.io/woo-website-gouda/) | Zaaksysteem.nl | Acceptatie |

docs/Bronnen.puml

@@ -3,19 +3,16 @@ title Integratie op bronnen
 footer: OpenWoo.app
 header: OpenWoo.app
 
-' Publicatie platformen (Laag 5 UI)
-frame "Publicatie platformen " {
-    interface "Afnemer" as Searchsite #1abc9c
-}
 
-' Services(Laag 4)
-frame "Services" {
+
+' Services (Laag 4)
+frame "Services (Laag 4)" {
     process "OpenWoo Service"  as OWS #1abc9c
 }
 
 ' Integratie (Laag 3)
-frame "Integratie" {
-    database "Open Index"  as OI #1abc9c
+frame "API (Laag 3)" {
+    database "Open Index" as OI #1abc9c
 }
 
 ' Bronnen (Laag 2)
@@ -29,7 +26,6 @@ frame "Bronnen" {
 }
 
 ' Relationships
-Searchsite -down-> OI : Bevraagd (API)
 OWS ..> OI: Slaat op in
 
 OWS -down-> CMS : Scrapes periodically\nUses as source

docs/Componenten.puml

@@ -0,0 +1,83 @@
+@startuml
+title: Components
+footer: Open Catalogi | Components
+header: Open Catalogi | Components
+
+cloud "Identity & Access"{
+ [ADFS] as identity
+}
+
+cloud "Gebruikers"{
+actor "Burger" as burger
+actor "Ambtenaar" as medewerker
+actor "Beheerder" as adminUser
+}
+
+cloud "Externe Applicaties"{
+package "Bronnen" {
+ [Zaaksysteem] as ZGW
+ [Etc.] as ETC
+}
+package "Catalogi" {
+ [Externe Catalogus] as externalCatalogue
+}
+}
+
+cloud "Kubernetes"{
+
+package "Layer 5 (Interaction)" {
+package "React NL Design" {
+ [Zoeken UI] as ui
+}
+
+package "Vue NL Design" {
+ [Beheer UI] as admin
+}
+}
+
+package "Layer 4 (Logic)" as layer4 {
+ [Synchronisaties] as service
+}
+
+package "Layer 2 (API)" as layer2 {
+
+package "Open Index" {
+ [Zoeken API] as SearchAPI
+}
+package "Open Registers" {
+ [Beheer API] as ObjectsAPI
+}
+}
+
+package "Layer 1 (Data)" {
+
+package "Search Index" {
+ [Elastic Search] as search
+}
+
+package "Object Store" {
+ [ORC] as db
+}
+
+package "Document Store" {
+ [DRC] as drc
+}
+}
+
+externalCatalogue <..> SearchAPI: Search + Directory
+burger <..> ui: Zoeken via browser (ANONIEM)
+medewerker <..> ui: Zoeken via browser (ANONIEM)
+adminUser <..> admin: Beheren via browser (JWT Claim)
+
+ui <..> SearchAPI: Search + Directory
+admin <..> ObjectsAPI: Publicaties + Catalogi + Metadata
+ZGW <..> service: Synchronisatie
+ETC <..> service: Synchronisatie
+
+ObjectsAPI .down.> db: Persist
+ObjectsAPI .down.> drc: Persist
+SearchAPI <.down. search: Lookup
+SearchAPI <.down. drc: Lookup
+layer2 .down.> identity: AUTH
+service .down.> ObjectsAPI: In synchroniseren van publicaties
+@enduml

docs/GOVERNANCE.md

@@ -2,19 +2,27 @@
 
 Het succes en de continue verbetering van het OpenWoo.app project zijn afhankelijk van een effectieve governance-structuur. Een belangrijk onderdeel van deze structuur is de stuurgroep, die verantwoordelijk is voor het beoordelen en prioriteren van de issues die op GitHub worden ingediend, en voor het bepalen welke daarvan worden opgenomen in de roadmap van het project.
 
+## Open Webconcept
+
+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, 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.
+De community meetings worden aangekondigd via openwoo.app, LinkedIn en per mail aan de bekende leveranciers en afnemers.
 
 ## Stuurgroep
 
 De Stuurgroep is samengesteld uit verschillende leden die een breed scala aan perspectieven en expertise inbrengen in het project. De huidige deelnemende leden van de stuurgroep zijn:
 
 - **Conduction (Leverancier)**: Met een rijke ervaring in het leveren van technologische oplossingen, brengt Conduction waardevolle inzichten en technische expertise in het project.
 - **xxlnce (Leverancier)**: Als leverancier draagt xxlnce bij aan de technologische vooruitgang en zorgt ervoor dat het project blijft voldoen aan de behoeften van de gebruikers.
-- **Epe (Pilot Gemeente)**
+- **Epe ( Gemeente)**
 - **Noordwijk (Pilot Gemeente)**
 - **Noaberkracht (Pilot Samenwerkingsverband)**
 

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

docs/NavbarContent.json

@@ -70,6 +70,19 @@
           }
         }
       },
+      {
+        "label": "Community",
+        "type": "internalMarkdown",
+        "current": {
+          "pathname": "/GOVERNANCE"
+        },
+        "handleClick": {
+          "internalMarkdown": {
+            "directoryName": "/docs",
+            "fileName": "GOVERNANCE"
+          }
+        }
+      },
       {
         "label": "Veel gestelde vragen",
         "type": "internalMarkdown",

docs/OverigFlow.puml

@@ -0,0 +1,13 @@
+@startuml
+title Open Webconcept zonder integratie
+
+' User Interface Component
+interface "Open Webconcept Website" as Website
+
+' Backend Components
+component "Open Webconcept CMS" as CMS
+
+' Relationships
+Website -down-> CMS : Directly connected
+
+@enduml

docs/Publicatie.puml → docs/PublicatiePlatformen.puml

@@ -7,37 +7,25 @@ header: OpenWoo.app
 frame "Publicatie platformen " {
     actor "KOOP"  as KOOP #cce5ff
     actor   "WOOGLE" as WOOGLE #cce5ff
+    actor "Open Catalogi" AS OpenCatalogi #1abc9c
+    interface "KoopHulpje" AS KoopHulpje #1abc9c
     interface "Website" AS Website #1abc9c
     interface "Thema site" as Themasite #1abc9c
     interface "Zoek pagina" as Searchsite #1abc9c
 }
 
-' Services(Laag 4)
-frame "Services" {
-    process "OpenWoo Service"  as OWS #1abc9c
+' API's (Laag 2)
+frame "API's (Laag 2)" {
+    database "Search API"  as OI #1abc9c
 }
 
-' Integratie (Laag 3)
-frame "Integratie" {
-    database "Open Index"  as OI #1abc9c
-}
-
-' Bronnen (Laag 2)
-frame "API" {
-    component "Bronnen" as Bronnen  #cce5ff
-}
 
 ' Relationships
 KOOP -down-> OI : Indexeerd (XML Sitemap)
 WOOGLE -down-> OI : Indexeerd (API)
+OpenCatalogi -down-> OI : Bevraagd (API)
+KoopHulpje -down-> OI : Bevraagd (API)
 Website -down-> OI : Bevraagd (API)
 Themasite -down-> OI : Bevraagd (API)
 Searchsite -down-> OI : Bevraagd (API)
-OWS ..> OI: Slaat op in
-
-OWS -down-> Bronnen : Scrapes periodically\nUses as source
-
-' Notifications
-Bronnen -up-> OWS : Notifies of changes or deletes
-
 @enduml