Low-Code development for Law analysis #22

Open sgort opened 1 year ago

In GitLab by @datafluisteraar on Jul 7, 2022, 17:05

For regels.overheid.nl, we work with work packages, these are small jobs for a fixed fee to deliver part functionality (proof of concept), including minimal documentation and tests.

Introduction

Wetgeving is een belangrijk instrument om de samenleving in goede banen te leiden; het is geen doel op zich maar een middel om maatschappelijke doelen te realiseren. Om wetgeving op een effectieve, rechtmatige en uitlegbare manier te kunnen uitvoeren, moet het nodige gebeuren. Dat geldt nog sterker als in de uitvoering ICT-toepassingen worden ingezet. Uitvoeringsorganisaties van de rijksoverheid zoals het Uitvoeringsinstituut Werknemersverzekeringen, de Dienst Uitvoering Onderwijs en de Belastingdienst hebben inmiddels omvangrijke ICT-landschappen om de steeds groter wordende stroom aan beslissingen die zij nemen over burgers en bedrijven af te handelen.

Een goede vertaling van wetgeving naar de uitvoeringspraktijk vraagt om een aanpak waarbij alle stappen voor het interpreteren, preciseren en nader invullen van wetgeving expliciet en op een gestructureerde manier worden vastgelegd. Dat zorgt ervoor dat de keuzes die worden gemaakt bij het vertalen van wetgeving naar uitvoering helder zijn en dat besluiten die op grond van die keuzes worden gemaakt, uit te leggen en te verantwoorden zijn.

Bij Wetsanalyse wordt het juridisch analyseschema gebruikt waarin verschillende juridische elementen die in wetgeving voorkomen in samenhang gerangschikt zijn. Deze elementen vormen de klassen die bij Wetsanalyse aan formuleringen in de wetgeving worden toegekend. Het indelen van formuleringen in juridische klassen biedt ondersteuning bij het expliciet maken van de betekenis van die formuleringen.

User story

Als jurist wil ik een web app waarmee ik in multidisciplinaire samenwerking met andere juristen, informatieanalisten én ICT-ontwikkelaars het juridisch analyseschema kan vullen. De aanpak voor wetsanalyse adhv dit schema wordt in het boek Wetsanalyse, Voor een werkbare uitvoering van wetgeving met ICT, van de auteur(s): Anouschka Ausems, John Bulles en Mariette Lokin, uitgelegd en praktisch gemaakt met twee grote casus. Dit boek wordt uitgeven door Boom uitgevers Den Haag.

Outline subtasks or task

[ ] Importeren bronteksten op wetten.overheid.nl op artikel niveau, waarbij verwijzingen naar andere artikelen (die obv links voorkomen in het geselecteerde artikel) automatisch worden meegenomen.
[ ] Datamodel om bronteksten adhv het juridisch analyseschema te kunnen annoteren
[ ] Brontekst en datamodel tegelijkertijd zichtbaar tijdens analyse
[ ] Front end voor CRUD annotatie functies

Acceptance criteria

[ ] Gebruikers kunnen datamodel vullen via web app
[ ] Open standaard voor exporteren is mogelijk
[ ] Géén lock-in low code platform (ie datamodel én inhoud kennen geen IP restricties)

Proposed solution

Story points

The initial estimate of the size of this work package is:

[ ] 20 (ie €1000,=)
[ ] 40 (ie €2000,=)
[x] 100 (ie €5000,=)

Definition of “done”

[ ] Meets tests per acceptance criteria
[ ] Relevant documentation has been created and made available
[ ] Approved by Product Owner
[ ] Code has undergone a peer review

In GitLab by @datafluisteraar on Jul 7, 2022, 17:16

marked the checklist item 100 (ie €5000,=) as completed

In GitLab by @mariette.lokin on Jul 8, 2022, 09:32

Wat wordt bedoeld met 'het analyseschema vullen'? In mijn beleving is het omgekeerd: je annoteert de tekst in wetten.nl met de 'labels' uit het analyseschema. Daarnaast zou er een mogelijkheid moeten zijn om een begrip vast te leggen voor de geannoteerde tekst, en om meta-informatie (eigenschappen, relatie met andere klasse uit het schema ed.) vast te leggen.

In GitLab by @datafluisteraar on Jul 8, 2022, 09:44

Vullen =

Annoteren wetteksten met de labels obv kleurcodes juridisch analyseschema
(optioneel) commentaar toevoegen
(optioneel) relatie(s) met andere labels vastleggen
Begrippen definieren

In GitLab by @datafluisteraar on Jul 8, 2022, 09:56

Heb belangrijkste punt in de beschrijving aangepast naar: Datamodel om bronteksten adhv het juridisch analyseschema te kunnen annoteren

In GitLab by @datafluisteraar on Aug 2, 2022, 09:45

Wenselijk is om adhv de annotaties voorbeeld pagina('s) te bieden met designtokens van NL Design Systeem waarmee uitvoeringsorganisatie(s) en/of gemeente(n) met eigen huisstijl cf. voorbeeld hun producten / diensten pagina's aanbieden.

Requirement:

[ ] Wijzigt de annotatie en/of brontekst en/of beiden, dan wijzigt voorbeeld pagina('s) automatisch mee, waarmee óók de pagina('s) bij uitvoeringsorganisatie(s) en/of gemeente(n) wijzigen.

In GitLab by @diederikdulfer on Aug 3, 2022, 08:15

Je zou kunnen overwegen delen te realiseren met behulp van het open source tool Gate. Dit is zowel beschikbaar in een desktop variant als in een cloud versie. Hieronder een voorbeeld van een inrichting in Gate.

mainWindow

In GitLab by @datafluisteraar on Aug 5, 2022, 13:01

Nadere specificatie van de kleurcodes van het analyseschema, en ook relaties tussen alle onderdelen.Klassen_en_hun_relaties_JAS_WA_20220804.pptx

In GitLab by @datafluisteraar on Aug 26, 2022, 13:33

marked this issue as related to #31

In GitLab by @datafluisteraar on Aug 26, 2022, 13:42

marked this issue as related to #24

sgort / RON