Overige Objecten API spike

[Robbert]

Context

• vac-schema.json
• kennisartikel-schema.json
• VNG Realisatie Objecten API

Acceptatie-criteria

• Er is een Node.js server met een REST API die de Overige Object API implementeert en de bovenstaande info teruggeeft
• De REST API is gegenereerd op basis van een Open API specificatie file

Stories bij deze Spike

• Integratie van kennisbank-api met Docker #914
• Create kennisbank-api #915
• API-validatie toevoegen aan kennisbank server #916
• Gebruik van OpenAPI YML-specificatie voor de API #917
• Genereer TypeScript-interfaces op basis van Kennisartikel- en VAC-schema's #918
• Werk het README-bestand en strapi.frameless.io bij met de nieuwe environment variables. #920
• Implementeren van CORS (Cross-origin resource sharing) #921
• Valideer elke kennisbank-api verzoek met kennisartikel- en VAC schema's #923
• Voeg ontbrekende velden toe aan Strapi ter ondersteuning van VAC informatiemodel #919

[Yolijn]

Plan van aanpak

1. Rest API met hardcoded JSON
2. Valideren of uitkomst is wat is verwacht
3. Koppelen aan Strapi data
4. Interne velden afschermen met token

[Yolijn]

Refinement 30 september

Aanwezig

Bart Warmenhoven, Laurens Hop, Charlotte Lubongan, Ralf Steenbeek (redacteur kennisbank en online loket), Jeroen du Chatinier, Pieter Valkenburg en Robbert, Yolijn en Ali van Frameless

---

Digitaal Loket - Product Diensten Catalogus, kennisartikelen toevoegen / samenvoegen.

Eerste applicatie voor kennisartikel is voor KISS.

Nog een uitbreiding is dan VAC's, daar moet beperkt gebruik van gemaakt worden, alleen als kennisartikelen geen uitkomst brengen.

Bestaande VAC informatie die niet gerelateerd is aan een product.

Informatie transparant conform Common Ground met abonnement, daarvoor Overige Objecten API

---

Welk contentblok hoort bij het kennisartikel, welk contentblok hoort bij de product dienstencatalogus. Als je toch van een veld kan aangeven of het wel/niet bij een product hoort of kennisartikel.

---

Aansluiting op KISS overige objecten API meest prangend. Wat er intern in het datamodel gebeurt kunnen we mee shuffle-en. Wat we dachten is eerst richten koppeling KISS met Overige Objecten API.

Firewall verbindingen, etc. gelijk achter komen. Dan weten we zo snel mogelijk.

---

Kennisartikel informatie

---

OTA straat inrichten voor KISS, OTA straat van Strapi moet daarop aangesloten worden. Vanuit Utrecht eerste sprint.

Liefst modern met JWT-token met oAuth vanuit Azure.

---

ICATT direct schakelen, Utrecht meer regie ipv vertragende factor.

Ergens iets met ICAT inplannen. Utrecht gaat dat voorstellen, Charlotte organiseert dit als vervanger van Justin

---

OTA straat van Strapi netjes aansluiten op OTA straat van KISS. Pieter neemt met Paulien contact op om de Common Ground team samenwerking zoeken. Er is nog geen functioneel beheerder van, handig om Raoul aan de schrijven.

---

Demo over ~2 weken. 9 oktober een demo hoever we zijn gekomen.

9 oktober ralf en bart laten zien hoe deze informatie het best kan werken.

---

huidige kennisbank heel veel informatie. Zijn een plan aan het maken hoe gaat het naar Strapi. Nu aanvulling bij producten en VAC's

---

OpenID omgeving waar het aan gekoppeld kan worden, Pieter gaat hier naar kijken.

---

Beschikbaar stellen van Strapi API, goed op Backlog zetten.

---

huidige kennisbank heel veel informatie. Zijn een plan aan het maken hoe gaat het naar Strapi. Nu aanvulling bij producten en VAC's

---

23 oktober refinement

---

Object types, Pieter heeft een definitie meegegeven hoe Object types worden aangemaakt.

Idee is dat er een centrale object type registratie is, die hangen nauw met elkaar samen. Hetzelfde als een zaaktype. Dan kun je zien hoe de PDC, VAC's en hoe KISS verwacht ze terug te krijgen.

---

Jeroen noemt dat er klantsenario situaties uitgewerkt moeten worden. Bart en Charlotte zijn daar ook al mee bezig. Mooi begin: Eerder onderzoek naar de huidige kennisbank, ik besef me dat de eindgebruiker nog een beetje ver weg lijkt, maar doe er vooral je voordeel mee over innzichten van wat belangrijk is vor de kcc-medewerker: https://miro.com/app/board/uXjVMJALGQU=/?moveToWidget=3458764560124118588&cot=14

(wachtwoord: kennisbank)

---

KISS webinar-20231116_103100-Opname van vergadering on Vimeo

[Robbert]

https://petstore.swagger.io/?url=https://raw.githubusercontent.com/maykinmedia/objects-api/master/src/objects/api/v2/openapi.yaml

https://raw.githubusercontent.com/maykinmedia/objects-api/master/src/objects/api/v2/openapi.yaml

Voorbeelden van object types: https://github.com/open-objecten/objecttypes/tree/main/community-concepts