Organisatie aanvullen met code, organisatiecode

[alextreme]

Gebruikersverhaal

Als gemeentelijke ontwikkelaar
wil ik dat elke Organisatie in de Open Producten API een unieke organisatiecode heeft
zodat deze organisaties eenduidig kunnen worden geïdentificeerd en gekoppeld aan processen, producten, en andere systemen binnen de gemeentelijke infrastructuur. Dit voorkomt ambiguïteit en maakt efficiënte integraties mogelijk.

---

Acceptatiecriteria

Organisatiecode veld

• Het datamodel van de Organisatie-entiteit bevat een nieuw veld organisatiecode.
• De organisatiecode is een verplicht veld en bestaat uit een unieke, alfanumerieke string (bijv. "ORG-001", "UTR-GM-2024").
• De organisatiecode wordt consistent toegepast in alle relevante API-endpoints en responses.

Uniciteit en validatie

• De organisatiecode moet uniek zijn binnen de dataset van alle organisaties.
• Bij een invoer van een duplicaat of een ontbrekende organisatiecode geeft de API een duidelijke foutmelding in het Nederlands, zoals:
  • "Organisatiecode is al in gebruik."
  • "Organisatiecode is verplicht."

Gebruik en filtering

• De Open Producten API ondersteunt filtering op organisatiecode bij het opvragen van gegevens.

Documentatie

• De API-documentatie bevat een beschrijving van het gebruik van de organisatiecode en een toelichting op de structuur en validatieregels.

---

Definition of Done (DoD)

• Het organisatiecode-veld is toegevoegd aan het datamodel en geïmplementeerd in de API.
• Unit tests en integratietests controleren de validatie van unieke en verplichte organisatiecodes.
• Documentatie is bijgewerkt met uitleg, voorbeelden, en validatieregels.
• Filtering op organisatiecode werkt zoals beschreven en wordt getest in relevante API-endpoints.