HELIX → Winnovatie: automatische projectfeed

Doel & aanleiding

Brabantse Delta onderhoudt al zijn innovatie- en onderzoeksprojecten in HELIX (de bron-van-waarheid). In plaats van die projecten met de hand op winnovatie.nl in te voeren, stelt HELIX ze beschikbaar als een gestructureerde feed. Een afnemer haalt die feed periodiek op en plaatst of werkt de bijbehorende initiatieven op Winnovatie bij. De feed bevat uitsluitend informatie die nu ook al openbaar op HELIX staat — nooit budgetten of besparingen.

De feed & methode

Het koppelvlak is één publieke, ongeauthenticeerde JSON-endpoint die live uit de HELIX-database leest.^[1] Een afnemer hoeft niets te pushen: hij haalt periodiek op en vergelijkt tijdstempels.

De respons is zelf-documenterend: naast projects[] bevat hij source ("HELIX"), origin, generatedAt, count en een phaseLegend die de fase-semantiek uitlegt — een afnemer heeft geen losse specificatie nodig om de feed te begrijpen.

Wat komt er in de feed — en wat niet

De opnameregel is bewust simpel en daarmee sluitend: elk project dat op HELIX de status "gepubliceerd" heeft en niet gearchiveerd is, zit in de feed. Dat omvat:

• beide portfolio's: het R&D-lab (portfolio:"rnd") én het innovatieportfolio (portfolio:"innovation");
• zowel sporen (hoofdtrajecten, parentSlug:null) als hun deelprojecten (parentSlug verwijst naar het spoor);
• zowel lopende hoofdtrajecten (stage:"main") als de pijplijn van toekomstige ideeën (stage:"future").

Wordt op HELIX een nieuw spoor of deelproject gepubliceerd, dan staat het bij de eerstvolgende ophaalronde automatisch in de feed — er is geen registratie- of exportstap. Wat er niet in komt: concepten (nog niet gepubliceerd), gearchiveerde sporen, budgetten/besparingen (staan nergens publiek), en interne research-artifacts die als privé zijn gemarkeerd — die worden uit links[] gefilterd voordat de feed de deur uit gaat.

Identiteit & URL's: id is de sleutel

Elk project draagt een permanent id (bv. prj_evolv, inv_…, invtrk_…). Gebruik dat id als synchronisatiesleutel aan HWH-zijde. De url in de feed is de canonieke, id-gebaseerde HELIX-pagina en blijft geldig als een titel wijzigt; daarnaast bestaat voor elk project de permanente korte vorm https://lab.wbd-rd.nl/p/<id>. De slug (leesbare naam) reist mee als weergaveveld, maar kan wijzigen — sleutel er niet op.

Wat zit er per project in?

Elk item in projects[] bevat:

Nieuwe of gewijzigde projecten ophalen

De feed is altijd actueel. Een afnemer hoeft alleen periodiek te pollen en te vergelijken op tijdstempel:

1. Haal de feed op (bijv. dagelijks of per uur).
2. Bewaar per project het laatst geziene updatedAt, gesleuteld op id.
3. Alles met een nieuwere updatedAt (of een onbekende id) is nieuw of gewijzigd → aanmaken/bijwerken op Winnovatie. Een id die uit de feed verdwijnt, is op HELIX gedepubliceerd of gearchiveerd → op Winnovatie verbergen of laten staan, naar afspraak.

Voorbeeld

curl -s "https://lab.wbd-rd.nl/api/winnovatie/feed?stage=main" \
  | jq '.projects[] | {id, title, fase: .phase.key, spoor: (.parentSlug // "— is zelf een spoor"), updatedAt}'

Veldmapping

Naar het formulier "Initiatief toevoegen" op winnovatie.nl:

Fasemapping (1-op-1)

Elk project draagt phase.source: tag betekent dat de fase door een mens is bevestigd (via een fase:<…>-label in HELIX); inferred is een veilige automatische inschatting die overschreven mag worden. Peildatum 2026-07-20: 5 van de 105 projecten dragen een mens-bevestigde fase; de rest is afgeleid uit levenscyclus, stage en strand.

Wat we van Het Waterschapshuis vragen

Winnovatie/METT kan zelf geen externe feed inlezen.^[2] Om dit te automatiseren is één van beide nodig:

• Een kleine importer aan HWH-zijde die deze feed periodiek ophaalt en de initiatieven aanmaakt/bijwerkt — de robuuste, gedragen route.
• Of Brabantse Delta draait een geplande taak die de feed ophaalt en op Winnovatie plaatst — dan volstaat een afspraak over een vaste accounttoegang.

Praktische keuze voor de importer: wie álle trajecten wil tonen neemt de hele feed; wie alleen de hoofdtrajecten wil, filtert op parentSlug == null (de sporen) — deelprojecten kunnen dan als beschrijving of link onder het spoor mee.

aanname Welke van de twee routes haalbaar is, hangt af van wat HWH aan hun kant kan bouwen of onderhouden; dit document doet geen voorkeursuitspraak en is nog niet met HWH afgestemd op implementatiedetails. Wij denken graag mee over de eenvoudigste vorm. De feed blijft in beide gevallen het vaste, stabiele koppelvlak.