IOU Architecture Documentation¶

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

🆕 What's New¶

⚙️ RONL Business API — v3.0.7 · May 2026

V2 caseworker dashboard live in production

The redesigned V2 caseworker dashboard is now the available at /dashboard/caseworker/v2; the V1 shell will be retired. A three-mode information architecture (Werk · Zoeken · Beheer) replaces the flat 25-item nav, with a ⌘K command palette and a toggleable AI assistant dock. Production brought to full parity with acceptance.

Full changelog
🖍️ Norm Editor — v2026.07.0 · July 2026

First tagged release: SSR removed, SPA routing

The Norm Editor now cuts version-tagged releases with a generated changelog. This first tag removes the Quasar SSR server in favour of a plain SPA with client-side routing across six pages, restyles the in-app changelog viewer, and backports graph-processing internals, wrap-up-api updates, and UI styling from the TNO mirror.

Full changelog
✏️ CPSV Editor — v1.10.6 · July 2026

CPRMV version selector & verified DMN test cases

Preview, export and publish now target a selectable CPRMV vocabulary version — 0.4.1 (cprmv:RuleSet) or 0.3.2 (cprmv:Dataset) — with consolidation dates derived from the rules and collision-free rule URIs. DMN test cases are now functionally verified: PASS/FAIL/ERROR/OK-unchecked verdicts with Expected-vs-Actual diffs, per-decision routing, and empty-result checks.

Full changelog
🔍 Linked Data Explorer — v1.9.11 · July 2026

Board-owner deploys & a negotiable /v1/norms CPRMV version

The BPMN deploy modal now requires a board owner — auto-detected from candidate groups, stamped as camunda:property boardOwner, and exposed via /bundles/public. The /v1/norms endpoint gained a ?cprmv_version= selector (0.3.0 default, 0.3.2/0.4.1 experimental) matching the CPSV Editor's export targets, and the CPRMV SHACL layer added the ParameterWaarde/TemporalRule shapes.

Full changelog
📜 CPRMV API — v0.4.1 · June 2026

CPRMV 0.4.1 conformance & reference resolution

RuleSets are now FRBR Works (frbroo:F1_Work); /ref auto-detects Juriconnect, ELI (to EU CELLAR), and CPRMV-API references; new /cellar-by-celex and /cellar-by-eli redirects; unformat works across all output formats; and the API now exposes a basic MCP server at /mcp.

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 →

🖍️ Norm Editor¶

Vue/Quasar application for creating FLINT interpretations of legal sources: load a normative text, annotate fragments, and build Fact, Act, and Claim-duty frames that export to RDF in TriplyDB. Backed by NLP, unwrap, and wrap-up services.

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…

Quick Links¶

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