• logo.png

icon search-mobile.svg

icon menu-mobile.svg

projecten/raadvanstate

From www.wikibase.nl
Revision as of 09:26, 5 January 2021 by Charlot (talk | contribs) (Undo revision 2900 by Automator (talk))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
rvs banner.jpg

Raad van State

De Raad van State is onafhankelijk adviseur van regering en parlement over wetgeving en bestuur en hoogste algemene bestuursrechter van Nederland.

De Raad van State behandelt duizenden zaken per jaar. Dit levert veel rechterlijke uitspraken en wetgevingsadviezen op, die gelden als jurisprudentie respectievelijk legisprudentie. Deze documenten worden door staatsraden en griffiers regelmatig geraadpleegd bij bijvoorbeeld een nieuwe uitspraak over een bepaald onderwerp. Daarnaast beschikt de Raad van State over handboeken, waarvan het de wens was deze eveneens via dezelfde oplossing te raadplegen als uitspraken en adviezen.

De documenten worden in een nieuw systeem ingebracht en daar beter doorzoekbaar gemaakt, waarbij automatisch links worden aangelegd naar documenten die aan elkaar gerelateerd zijn. Hierdoor kan men eenvoudig alle relevante informatie over een onderwerp, locatie of combinaties daarvan bij elkaar brengen.

In totaal ging het om meer dan 200.000 uitspraken, 12.000 adviezen en meer dan 5.000 pagina’s handboeken.

Aanbesteding Raad van State

De Raad van State heeft dit systeem, de toepassingen en wensen tot in detail beschreven en daarop Wikibase Solutions ingehuurd om de oplossing op het opensource MediaWiki framework in te richten. Na de gunning zijn we in overleg gegaan over de details en is additionele input van beide zijden verwerkt in een definitief ontwerp.

Omvang Raad van State

Na het voortraject zijn we op verschillende niveaus aan de slag gegaan. Designs voor de User Interface zijn ontwikkeld, structuur van het framework is opgezet en een importscript om alle verschillende documenten (xml, docx, pdf) te kunnen importeren in “de Raad van State Wiki”.

Korte opsomming van de opzet:

  • Conversietools schrijven voor de verschillende bestandstypes in de vorm van een maintenance script
  • Meta gegevens definiëren en importeren samen met de omgezette bestanden
  • Rechten bepalen voor alle verschillende typen documenten
  • Elasticsearch engine voor geavanceerd zoeken inrichten
  • Templates inrichten om interne documenten aan elkaar te verbinden met metagegevens
  • Maken user Interface ontwerp en implementatie met Chameleon skin (Bootstrap)
  • Opzetten developing-, acceptatie-, en productieomgeving
  • Azure omgevingen inrichten en Pipelines aanmaken
  • Met Docker containers opzetten en de pipeline instellen voor deployments
  • OAuth implementatie en koppeling met eigen koppeling naar Azure realiseren

Realisatie Raad van State

Tijdens de realisatie zijn de volgende zaken opgepakt:

  • Meerdere conversies van documenten en importeren hiervan
  • Linken aan bestaande Wiki documenten
  • Indexeren van content
  • Nieuwe documentenpagina’s in de Wiki maken middels implementatie van de TinyMCE mediawiki extensie, die is aangepast naar een volwaardige editor, waarbij WSForm is ingezet voor het aanmaken
  • Opzetten boekingssysteem, waar m.b.v. WSForm pagina’s kunnen worden ingedeeld en verplaatst
  • Extensies voor TinyMCE extensie opgezet om eenvoudig vanuit de editor te linken naar andere documenten in de Wiki
  • Specifieke Uitspraak nummering (ECLI), die in Europa voldoen aan bepaalde eisen, automatisch omzetten naar links naar rechtspraak.nl

In MediaWiki zijn de volgende specifieke tools en extensies gebruikt:

"De Raad van State is onafhankelijk adviseur van regering en parlement over wetgeving en bestuur en hoogste algemene bestuursrechter van Nederland. De Raad van State behandelt jaarlijkse duizenden zaken. Alle uitspraken en adviezen van de Raad dienen als jurisprudentie en legisprudentie en als kennis bij de behandeling van nieuwe zaken. In het verleden had de Raad van State daartoe verschillende systemen en handboeken. Deze systemen zijn aan het einde gekomen van hun levensduur en is besloten deze systemen te vervangen.

Het probleem dat de Raad hierbij wilde oplossen is het versnipperde karakter van de kennis, die verdeeld was over zeven verschillende collecties en bronnen. Tegelijk moest het beheerder eenvoudig zijn met de voor de handboeken een krachtige editor om teksten te kunnen bewerken. De gehele collectie moest integraal doorzocht kunnen worden en bepaalde handboeken moesten geëxporteerd kunnen worden naar derden, zodat kennis ook gedeeld zou kunnen worden.

Voorafgaand aan de selectie van een oplossing is een functioneel ontwerp opgesteld en zijn uitgangspunten bepaald. Een belangrijk uitgangspunt is dat werd gekozen voor een open source wiki oplossing. Na nader onderzoek is toen gekozen voor het MediaWiki platform. Uiteindelijk is uitgekomen bij WikiBase om het MediaWiki platform in te richten.

Ter voorbereiding op de daadwerkelijke inrichting zijn sessies gehouden met medewerkers uit veel verschillende doelgroepen en organisatieonderdelen om verwachtingen te managen en om functionaliteiten te bepalen. Er is een implementatieplan opgesteld en een technisch ontwerp gemaakt.

In de realisatiefase werden wekelijks een of meerdere stand-up gehouden om te verifiëren hoe het werken verliep. Gaandeweg bleken de eisen rondom de editor veeleisender dan gedacht, waarna is besloten een andere editor te nemen en die verder te ontwikkelen volgens het open source concept, waardoor nu de meest geavanceerde MediaWiki editor ter wereld is vormgegeven.

Tijdens de fase werd de MediaWiki geïnstalleerd in een container op een Azure platform en werd het systeem voor zoeken gecombineerd met een andere open source oplossing, Elasticsearch, die eveneens in een container werd geplaatst. De plaatsing op Azure had flink wat voeten in de aarde, maar uiteindelijk is het gelukt dit werkend te krijgen. Dit leverde initieel wat performance problemen op, maar ook dit is opgelost. Na een driekwart jaar ging de WIKI live. Hierbij werd nog niet alle functionaliteit vrijgegeven, maar werd opgevolgd door zes maanden van maandelijkse releases.

Het team waarmee gewerkt werd, was kundig en ook toegankelijk en vriendelijk. Er kon goed geschakeld worden met aandacht voor elkaars bedrijfscultuur en flexibel in het aanpassen van functionaliteit en goed in meedenken in oplossingen.

Met WikiBase wordt een SLA afgesproken. Deze SLA bestaat deels uit ondersteuning bij storingen en incidenten, maar dekt ook bugfixes en kleine wijzigingen doorvoeren."

R.J. Trügg Raad van State



icon puzzle.svg

Past perfect

Wij bouwen aan uw ambitie.

icon star.svg

State of the art

Met Gebruik van de modernste technologie.

icon rocket geel.svg

Snel in bedrijf

Basisversie binnen enkele weken.

icon grow groen.svg

Groeit mee

Groet mee met uw ambities.