Skip to content

Commit

Permalink
Merge pull request #307 from ConductionNL/main
Browse files Browse the repository at this point in the history
Main to development
  • Loading branch information
remko48 authored Apr 30, 2024
2 parents 9bcaca7 + e4ebe86 commit 6524e3c
Show file tree
Hide file tree
Showing 18 changed files with 362 additions and 66 deletions.
3 changes: 1 addition & 2 deletions .github/workflows/product-page-deploy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,11 @@ on:
permissions:
contents: write

# Lets cheat and use open catalogi for now
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Create an Open Catalogi page
- name: Create the Product Page
uses: OpenCatalogi/[email protected]
with:
github_repository_name_as_prefix: false
Expand Down
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,14 @@
>
> 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.
> - [10 April 10:00 | Community Meeting](https://www.linkedin.com/events/openwoo-appcommunitymeetingapri7173404269205770241/comments/).
> - [25 Maart 13:13 | Webinar Sim-Groep](https://www.simgroep.nl/toekomstbestendige-woo-oplossing)
> Tevens worden vanuit de aangesloten leveranciers worden regelmatig webinars georganiseerd.
>
> - [8 Mei 13:00 | Community Meeting](https://www.linkedin.com/events/openwoo-appcommunitymeetingmei7184090446346768385/comments/).
>
> Terug kijken afgelopen webinars en meetings?
>
> - [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)
> - [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)
Expand Down
Binary file added assets/PentTestSlack.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
43 changes: 43 additions & 0 deletions docs/CommonGround.puml
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
@startuml
title Commonground
footer: OpenWoo.app
header: OpenWoo.app

' Publicatie platformen (Laag 5 UI)
frame "Publicatie platformen " {
actor "KOOP" as KOOP #cce5ff
actor "WOOGLE" as WOOGLE #cce5ff
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
}

' 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)
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
47 changes: 47 additions & 0 deletions docs/Datamask.puml
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
@startuml
title Samenwerking OpenWoo.app en Datamask
footer: OpenWoo.app
header: OpenWoo.app


' Publicatie platformen (Laag 5 UI)
frame "Publicatie platformen " {
actor "KOOP" as KOOP #008b6C
actor "WOOGLE" as WOOGLE #008b6C
interface "Website" AS Website #008b6C
interface "Publicatie pagina" as PublicatiePagina #F16E06
}



' Integratie (Laag 3)
frame "Integratie" {
database "Open Index" as OI #008b6C
component "Federatieve Connectie" as FCS #008b6C
process "OpenWoo Service" as OWS #008b6C
}

' Bronnen (Laag 2)
frame "API" {
database "Datamask" as DatamaskDB #F16E06
}

frame "Legenda" {
component "OpenWoo.app" #008b6C
component "Datamask" #F16E06



}

OWS <-- DatamaskDB: Woo verzoeken
OWS ..> OI: Slaat op in

FCS --> OI : Bevraagd

KOOP -down-> FCS : Indexeerd (XML Sitemap)
WOOGLE -down-> FCS : Indexeerd (API)
Website -down-> OI : Bevraagd (API)
PublicatiePagina -down-> OI : Bevraagd (API)

@enduml
50 changes: 33 additions & 17 deletions docs/Federatie.puml
Original file line number Diff line number Diff line change
@@ -1,25 +1,41 @@
@startuml
title Federatie

' User Interface Component
interface "Landelijke API" as Api #1abc9c

' Backend Components
component "NLX/FSC/FDS" as NLX #cce5ff
component "Motorblok" as Org1 #1abc9c
component "Motorblok" as Org2 #1abc9c
component "Motorblok" as Org3 #1abc9c
component "Bronnen" as BronnenOrg1 #cce5ff
component "Bronnen" as BronnenOrg2 #cce5ff
component "Bronnen" as BronnenOrg3 #cce5ff
frame "Landelijke voorziening 1" {
interface "Koophulpje" as KOOP #1abc9c
component "Landelijke API" as Api #1abc9c
component "NLX Outway" as NLX #cce5ff
}

frame "Organisatie 1" {
component "NLX Inway" as Org1 #cce5ff
component "Open Index" as OI1 #1abc9c
component "Bronnen" as BronnenOrg1 #cce5ff
}

frame "Organisatie 2" {
component "NLX Inway" as Org2 #cce5ff
component "Open Index" as OI2 #1abc9c
component "Bronnen" as BronnenOrg2 #cce5ff
}

frame "Organisatie 3" {
component "Open Index" as OI3 #1abc9c
component "Bronnen" as BronnenOrg3 #cce5ff
}

' Relationships
Api -down-> NLX : Connected trough outway
NLX -down-> Org1 : org 1 Connected trough inway
NLX -down-> Org2 : org 2 Connected trough inway
NLX -down-> Org3 : org 3 Connected trough inway
Org1 -down-> BronnenOrg1 : Internal connection
Org2 -down-> BronnenOrg2 : Internal connection
Org3 -down-> BronnenOrg3 : Internal connection
KOOP -down-> Api : Ajax call
Api -down-> NLX : Bevragen via NLX

Api -down-> OI3 : Federatieve zoekvraag
NLX -down-> Org1 : Federatieve zoekvraag
NLX -down-> Org2 : Federatieve zoekvraag
Org1 -down-> OI1 : Bevragen bij de bron
Org2 -down-> OI2 : Bevragen bij de bron
OI1 -down-> BronnenOrg1 : Internal connection
OI1 --> OI2: Zoeken bij de buren
OI2 -down-> BronnenOrg2 : Bevragen bij de bron
OI3 -down-> BronnenOrg3 : Bevragen bij de bron
@enduml
6 changes: 6 additions & 0 deletions docs/GOVERNANCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@

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.

## 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

De community meetings worden aangekondigd via openwoo.app.

## 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:
Expand Down
68 changes: 68 additions & 0 deletions docs/KLPD.puml
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
@startuml
title Algemene Architectuur en keuze mogenlijkheden
footer: OpenWoo.app
header: OpenWoo.app


' Publicatie platformen (Laag 5 UI)
frame "Publicatie platformen " {
interface "Woo Dashboard" AS OiDashboard #e5352c
actor "KOOP" as KOOP #008b6C
actor "WOOGLE" as WOOGLE #008b6C
interface "Website" AS Website #F16E06
interface "Thema site" as Themasite #F16E06
interface "Zoek pagina" as Searchsite #F16E06
}

' Services(Laag 4)
frame "Services" {
process "Backend for frontend" as OiBF #e5352c
}

' Integratie (Laag 3)
frame "Integratie" {
database "Open Index" as OI #F16E06
component "Federatieve Connectie" as FCS #008b6C
process "OpenWoo Service" as OWS #F16E06
component "Integratie Platform" as IP #008b6C
}

' Bronnen (Laag 2)
frame "API" {
database "Zaaksysteem (XXllNC)" as ZRC #008b6C
database "Raadsinformatiesysteem (Notubiz)" as RIS #008b6C
database "Bestuursinformatiesysteem (iBabs)" as BIS #008b6C
database "Website (Typo3)" as CMS #008b6C
database "DMS (Sharepoint)" as SP #008b6C
database "Archief (DeVault)" as DEPOT #008b6C
}

frame "Legenda" {
component "Herbruikbaar" #008b6C
component "Uitbreiden (doorontwikkeling)" #F16E06
component "Te ontwikkelen (nieuw)" #e5352c



}

OiDashboard -down-> OiBF
OWS --> IP: Bevraagd via
IP -down-> ZRC: Woo verzoeken
IP -down-> SP: Convenanten
IP -down-> RIS: Raadsstukken
IP -down-> BIS: Bestuursstukken
IP -down-> CMS: Organisatie gegevens
IP -down-> DEPOT: Gearchiveerde gegevens
OWS ..> OI: Slaat op in
OiBF --> OI: Beheerd

FCS --> OI : Bevraagd

KOOP -down-> FCS : Indexeerd (XML Sitemap)
WOOGLE -down-> FCS : Indexeerd (API)
Website -down-> FCS : Bevraagd (API)
Themasite -down-> FCS : Bevraagd (API)
Searchsite -down-> FCS : Bevraagd (API)

@enduml
37 changes: 37 additions & 0 deletions docs/partners/Datamask.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Datamask
OpenWoo.app en Datamask willen graag een gemeenschappenlijek 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

Heeft wel
- Anonimesering
- 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

Heeft niet
- Anonimeseringstool
- Beheers interface 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.


## Architectuur

![OpenWeb Architecture](https://raw.githubusercontent.com/ConductionNL/woo-website-template/main/docs/Datamask.svg)
3 changes: 3 additions & 0 deletions docs/partners/KLPD.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# KLPD


17 changes: 10 additions & 7 deletions docs/product/Roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,17 @@

Organisaties kunnen bijdragen aan deze roadmap door items aan te dragen, deze zelf op te pakken en uit te voeren, of door de uitvoering ervan te financieren.

## Raadsinformatie Systemen (Medio December)
## Raadsinformatie Systemen (Word momenteel ontwikkeld)

**Inschatting: 40 uur per RIS**

Medio september gaat de gebruikersgroep verkennen of het mogelijk is om ook de Raadsinformatiesystemen te ontsluiten via Open WOO. Deze ontwikkeling zal de dienstverlening naar de inwoners verbeteren door de transparantie van de gemeente te vergroten. Het draagt ook bij aan de invulling van de Wet Open Overheid door overheidsinformatie beter toegankelijk te maken.

## Robot.txt en sitemap.xml (Medio December)
## Inlezen vanuit sharepoint (Word momenteel onderzocht)

**Inschatting: 20 uur**

Begin oktober wil KOOP graag de decentrale portalen harvesten om een centrale index op te bouwen. Dit zal de zoekbaarheid van overheidsinformatie verbeteren, wat de dienstverlening aan de inwoners ten goede komt. Het past ook binnen de kaders van de Wet Open Overheid door het vergroten van de toegankelijkheid van overheidsinformatie.
**Inschatting: 120 uur**

## Aanleveren DROP (Geen ontwikkeling gepland)
## Aanleveren DROP (Word momenteel onderzocht)

**Inschatting: 120 uur**

Expand Down Expand Up @@ -87,7 +85,11 @@ Het is mogelijk om de openwoo.app te installeren via een Helm Chart. Dit maakt h

De serverless Woo-pagina kan ook geinstalleerd worden via een GitHub Action. Door de installatie te automatiseren wordt het gemakkelijker om de website te installeren en te onderhouden, wat de operationele kosten verlaagt en de betrouwbaarheid verhoogt. Dit draagt bij aan de dienstverlening door de beschikbaarheid van de website te vergroten.

## Roadmap WOO KOOP
## Inmiddels afgerond

### Robot.txt en sitemap.xml (Medio December)

Begin oktober wil KOOP graag de decentrale portalen harvesten om een centrale index op te bouwen. Dit zal de zoekbaarheid van overheidsinformatie verbeteren, wat de dienstverlening aan de inwoners ten goede komt. Het past ook binnen de kaders van de Wet Open Overheid door het vergroten van de toegankelijkheid van overheidsinformatie.

### Woo 1.0

Expand All @@ -96,3 +98,4 @@ Voor de eerste opzet van de Woo-index van BZK is het belangrijk dat organisaties
### Woo 2.0

BZK heeft de ambitie om aan de hand van een harvester een eigen index op te bouwen op open.overheid.nl. Deze harvester maakt gebruik van `robots.txt` en `sitemap.xml`-bestanden om de verschillende pagina's en metadata van de organisatiespecifieke index te vinden en over te nemen. Dat betekent dat ook binnen de 2.0 variant van Woo een eigen indexpagina noodzakelijk blijft. Sterker nog, de kwaliteit van de ontsluiting wordt in grote mate afhankelijk van de kwaliteit van de index.

Loading

0 comments on commit 6524e3c

Please sign in to comment.