🎯 Epic: Publicaties aan elkaar koppelen

[MarcoKlerks]

🎯 Epic: Publicaties aan elkaar koppelen

Stakeholders

• Product Owner: Marco Klerks
• Lead Designer:
• Tech Lead:

---

Bounded Context

Primair de Publicatiebank-context (GPP-publicatiebank), die koppelingen tussen publicaties (incl. koppelingstype) als source of truth beheert — vergelijkbaar met hoe Onderwerp en Informatiecategorie nu al beheerd worden. Raakvlakken:

• GPP-app (redactie/backoffice): een Redacteur koppelt publicaties aan elkaar en kiest het koppelingstype.
• GPP-burgerportaal (burgerportaal): een Burger ziet gekoppelde publicaties op het detailscherm en kan ernaartoe navigeren (incl. de automatisch afgeleide omgekeerde koppeling).
• Koppelingen kunnen gemeentegrenzen overschrijden: een publicatie van de ene gemeente kan gekoppeld worden aan een publicatie van een andere gemeente op hetzelfde platform.

---

Context

Gemeente Groningen wil publicaties aan elkaar kunnen koppelen, zodat de samenhang tussen documenten zichtbaar wordt voor de burger — bijvoorbeeld een besluit dat volgt op een eerdere aanvraag, of een publicatie die een oudere publicatie vervangt.

Vandaag bestaat er geen manier om publicaties onderling te koppelen: Onderwerp groepeert weliswaar publicaties rond een thema, maar legt geen expliciete, betekenisvolle relatie tussen twee specifieke publicaties vast (zoals "vervolg op" of "vervangt"). De bestaande koppeling van Document aan Publicatie is bovendien een ouder-kindrelatie, geen koppeling tussen gelijkwaardige publicaties.

Goal

Een Redacteur kan in GPP-app twee publicaties aan elkaar koppelen met een koppelingstype. De omgekeerde koppeling wordt automatisch afgeleid en getoond op de andere publicatie. Een Burger ziet gekoppelde publicaties op het detailscherm in GPP-burgerportaal en kan er direct naartoe navigeren. Koppelingen zijn niet beperkt tot publicaties van dezelfde gemeente.

Success Metrics

• Een Redacteur kan in GPP-app een publicatie koppelen aan een of meer andere publicaties, met een koppelingstype.
• De omgekeerde koppeling wordt automatisch getoond op de gekoppelde publicatie, zonder dat de Redacteur dit apart hoeft in te voeren.
• Een Redacteur kan een publicatie koppelen aan een publicatie van een andere gemeente op het platform.
• Een Burger kan op het detailscherm van een publicatie in GPP-burgerportaal de gekoppelde publicaties zien en ernaartoe navigeren.

---

Design Artifacts

• Aanvraag van gemeente Groningen (via Product Owner) — koppelingstypen zoals "vervolg op", "vervangt", "hoort bij" zijn voorbeelden en nog niet definitief; de exacte lijst wordt bepaald bij het uitwerken van de Features.
• Vergelijkbare bestaande koppel-functionaliteit ter referentie: Onderwerp aan Publicatie (GPP-publicatiebank#206, GPP-app#57/#130), Document↔Publicatie-navigatie (GPP-burgerportaal#42/Update gppwoo.nl with test-releases plateau 3 #81, .github#71).

Out of Scope

• Doorzoekbaarheid/filterbaarheid van gekoppelde publicaties in GPP-Zoeken — mogelijk vervolgwerk, geen onderdeel van de succescriteria van deze Epic.
• Het definitief vaststellen van de complete lijst koppelingstypen — wordt op Feature-niveau uitgewerkt.

Risks

• Cross-gemeente koppelen vraagt om zorgvuldige omgang met zichtbaarheid: een koppeling naar een concept- of ingetrokken publicatie van een andere gemeente mag niet per ongeluk zichtbaar worden voor de burger.
• Er bestaat al een impliciete groepering via Onderwerp; Redacteuren kunnen in verwarring raken over wanneer ze Onderwerp gebruiken versus een directe koppeling tussen publicaties — hier moet in de UX (GPP-app) rekening mee gehouden worden.
• (technisch) Automatisch afleiden van de omgekeerde koppeling vereist een nieuw datamodel-concept: elk koppelingstype heeft een inverse tegenhanger (bijv. "vervolg op" ↔ "voorganger van") die nog niet bestaat.
• Eerdere navigatie tussen gekoppelde items heeft al tot verwarring geleid bij gebruikers (zie .github#71, over document↔publicatie-navigatie) — de UX voor publicatie-publicatie-koppelingen moet dit voorkomen.

Feature Breakdown

• Koppelingen tussen publicaties (incl. koppelingstype en automatisch afgeleide omgekeerde koppeling) ondersteunen in GPP-publicatiebank
• Publicaties aan elkaar koppelen in GPP-app (redactie), incl. keuze van koppelingstype
• Gekoppelde publicaties tonen en doornavigeerbaar maken op het detailscherm in GPP-burgerportaal