Skip to content

IOU Architecture Documentation

Welcome to the comprehensive documentation for the IOU Architecture Framework and the RONL ecosystem.

🆕 What's New

  • ⚙️ RONL Business API — v2.9.7 · April 2026

    AI Assistant — MCP providers & multi-model LLM registry

    AI Assistant extended with three independent MCP providers — CPRMV legislation (Dutch & EU law), LDE Process Library (deployed BPMN bundles, forms, document templates), and a multi-model LLM registry supporting both Claude and GPT-4o. New Procesbibliotheek section on the Home tab lets caseworkers browse deployed processes without login. IOU tab for Flevoland: use-case submission with file attachments, feedback with screenshot upload, and read-only GitLab issue lists.

    Full changelog

  • ✏️ CPSV Editor — v1.9.3 · February 2026

    DMN Syntactic Validation

    Inline DMN validation immediately after upload: five-layer syntactic checks with severity-coded results (error / warning / info), element references, and line numbers — directly in the DMN file card.

    Full changelog

  • 🔍 Linked Data Explorer — v1.4.0 · March 2026

    RoPA Records — GDPR Article 30 Compliance

    v1.4.0 introduces a full Record of Processing Activities (RoPA) framework. The LDE RoPA Editor lets Product Owners author GDPR Art. 30 records per process bundle — with a legal basis SPARQL lookup, form-hydrated personal data field classification, and a BPMN link written as ronl:ropaRef on the process element. Active records are served from a CORS-open public endpoint and rendered on a dedicated static site (ropa.open-regels.nl) deployed separately from the LDE stack.

    Full changelog

  • 📜 CPRMV API — v0.4.0 · February 2026

    On-the-fly Rule Retrieval

    Live retrieval and CPRMV transformation of Dutch and EU legislation from BWB, CVDR, and EU CELLAR repositories. Automatic latest-version resolution, seven output formats, definition extraction with parse patterns, and Juriconnect reference resolution.

    Full changelog

What is IOU Architecture?

The Information Architecture Framework for IOU integrates semantic web technologies, decision models, and Dutch government standards into a unified system for managing regulatory compliance and spatial planning.

IOU Architecture — interactive overview of the ecosystem components and their relationships

Architecture Overview

graph TB
    subgraph "IOU Architecture Ecosystem"
        A[Municipality Portal<br/>React] -->|OIDC/JWT| B[Keycloak IAM]
        B -->|Validated Token| C[Business API<br/>Node.js]
        C -->|REST| D[Operaton BPMN<br/>Business Rules]

        E[CPSV Editor<br/>React] -->|TTL| F[TriplyDB<br/>Knowledge Graph]
        E -->|DMN Files| D

        F -->|SPARQL| G[Orchestration Service<br/>Node.js]
        G -->|Deploy BPMN+DMN| D
        G -->|asset storage| K[PostgreSQL<br/>lde_assets]

        H[Linked Data Explorer<br/>React] -->|API Calls| G
        H -->|Direct SPARQL| F

        I[CPRMV API<br/>Python/FastAPI] -->|XML download| J[BWB / CVDR / CELLAR]
        I -->|cprmv-json / RDF| F
        I -->|cprmv-json / RDF| H
    end

Ecosystem Components

⚙️ RONL Business API

The core business API layer that provides secure authentication and process orchestration for Dutch government services.

Live App: mijn.open-regels.nl

View Documentation →

✏️ CPSV Editor

React-based application for creating CPSV-AP 3.2.0 compliant RDF/Turtle files for Dutch government services.

Live App: cpsv-editor.open-regels.nl

View Documentation →

🔍 Linked Data Explorer

Web application for SPARQL queries and BPMN & DMN orchestration with TriplyDB integration.

Live App: linkeddata.open-regels.nl

View Documentation →

📜 CPRMV API

Python/FastAPI service that fetches individual rules from Dutch and European legal publications on the fly, transforming them to CPRMV-structured RDF. Implements the Core Public Rule Management Vocabulary standard and hosts the CPRMV specification.

Live App: cprmv.open-regels.nl/docs

View Documentation →

Documentation Status

Loading documentation status…

Resource Link
CPSV Editor cpsv-editor.open-regels.nl
Linked Data Explorer linkeddata.open-regels.nl
Backend API backend.linkeddata.open-regels.nl
Keycloak IAM keycloak.open-regels.nl
Custom Business API api.open-regels.nl
Operaton operaton.open-regels.nl
CPRMV API cprmv.open-regels.nl/docs

Technology Stack

The IOU Architecture ecosystem is - apart from TriplyDB and eDOCS - built entirely on open source technologies:

Component Technology License
IAM Keycloak Apache 2.0
BPMN Engine Operaton Apache 2.0
Backend Node.js + Express MIT
Frontend React MIT
Database PostgreSQL PostgreSQL License
Cache Redis BSD 3-Clause
Reverse Proxy Caddy Apache 2.0
Knowledge Graph TriplyDB -
Document Mngmnt eDOCS -
Rule API Python / FastAPI EUPL-1.2

Standards Compliance

  • CPSV-AP 3.2.0 - EU Public Service Vocabulary
  • CPRMV - Core Public Rule Management Vocabulary
  • RONL - Dutch Rules Vocabulary
  • BIO - Baseline Informatiebeveiliging Overheid
  • NEN 7510 - Healthcare information security
  • AVG/GDPR - Data protection

Contributing

We welcome contributions! See the Contributing Guide for details.

Documentation Version: 1.0
Last Updated: February 2026
License: EUPL v1.2