Core Public Service Editor

Generate CPSV-AP 3.2.0 compliant RDF/Turtle files for Dutch government services

🌐 Live Application: cpsv.open-regels.nl
🧪 Acceptance Environment: acc.cpsv.open-regels.nl

📋 Table of Contents

Overview
Features
Standards Compliance
Architecture
Getting Started
Usage Guide
Development
Deployment
Roadmap
Documentation

🎯 Overview

The Core Public Service Editor is a React-based web application that simplifies the creation and management of RDF/Turtle files for government services in the Netherlands. It provides an intuitive interface for creating service definitions that comply with EU CPSV-AP 3.2.0 and Dutch RONL/CPRMV standards.

Key Features:

✅ CPSV-AP 3.2.0 compliant TTL generation
✅ DMN integration with Operaton rule engine
✅ RPP Architecture (Rules--Policy--Parameters separation)
✅ iKnow integration for legislative analysis import
✅ Import/Export with perfect round-trip fidelity
✅ Live preview panel with real-time TTL generation

✨ Features

Core Functionality

📝 Service Definition

Public service metadata (title, description, keywords)
Thematic areas and sector classification
Cost and output specification
Legal resource linking

🏛️ Organization Management

Public organization details
Geographic jurisdiction (mandatory)
Homepage and contact information
URI support (short IDs or full URIs)

⚖️ Legal Resource Integration

BWB ID support for Dutch legislation
Version and consolidation tracking
Direct linking to wetten.overheid.nl
Validation of BWB formats

🔵 Rules (Decision Logic) - RPP Layer

Temporal rules with validity periods
Rule versioning and inheritance chains
Confidence level tracking (high/medium/low)
Rule-to-policy traceability

🟢 Parameters (Configuration) - RPP Layer

Configurable values for rule behavior
Multiple unit types (EUR, PCT, NUM, DAYS, MONTHS, YEARS)
Temporal validity per parameter
Regional variation support

🟣 CPRMV (Policy/Norms) - RPP Layer

Normative values from legislation
CPRMV Rules API integration
JSON import from normenbrief format
Policy-to-legal-source traceability

🎯 DMN (Decision Models)

Upload and deploy DMN files to Operaton
Test decision evaluations with live data
Automatic input variable extraction
Rule extraction with CPRMV attributes
Import preservation for existing DMN

📊 iKnow Integration

Parse iKnow XML exports
Configurable field mappings
Import legislative analysis data
Support for multiple legal concept types

🏗️ Architecture

Rules--Policy--Parameters (RPP) Separation

The editor implements the RPP architectural pattern for Business Rule Management:

Layer	Color	Description	Examples
Rules 🔵	Blue	Executable decision logic that operationalizes policies	Eligibility checks, calculations
Policy 🟣	Purple	Normative values derived from laws	Legal thresholds, mandated rates
Parameters 🟢	Green	Configurable values that tune rules	Regional rates, pilot adjustments

Benefits:

Legal Traceability: Law → Policy → Rule → Parameter → Decision
Organizational Agility: Adjust parameters without changing rules or laws
Governance: Clear ownership and approval workflows per layer

Documentation: See docs/RULES-POLICY-PARAMETERS-SEPARATION.md

Code Architecture (v1.5.1)

Modularization Journey:

v1.0: Monolithic App.js
v1.3: Component extraction
v1.5.1: Full modularization

Key Modules:

useEditorState.js - State management hook
ttlGenerator.js - TTL generation class
importHandler.js - Import logic
useArrayHandlers.js - DRY array operations

Documentation: See docs/PROJECT-STRUCTURE.md

📚 Standards Compliance

CPSV-AP 3.2.0 ✅

The editor generates TTL files compliant with the Core Public Service Vocabulary Application Profile 3.2.0.

Compliance Status:

✅ All mandatory properties implemented
✅ Correct class types (cv:PublicOrganisation, cpsv:PublicService)
✅ Proper relationships (cv:hasLegalResource, cv:hasCompetentAuthority)
✅ Mandatory identifiers for all entities

Documentation: See docs/FIELD-MAPPING-CPSV-AP-3_2_0.md

Dutch Extensions

RONL (Regels Overheid Nederland):

ronl:TemporalRule - Time-bounded rules
ronl:ParameterWaarde - Configuration parameters
ronl:validFrom / ronl:validUntil - Temporal validity
ronl:confidenceLevel - Rule confidence tracking
ronl:extends - Rule versioning chains

CPRMV (Core Public Rule Management Vocabulary):

cprmv:Rule - Normative rules from legislation
cprmv:definition - Full legal text
cprmv:situatie - Situational context
cprmv:norm - Normative value
cprmv:ruleIdPath - Legal source path
cprmv:DecisionModel - DMN model linking

Documentation: See docs/NAMESPACE-PROPERTIES.md

🚀 Getting Started

Prerequisites

Node.js 14+ and npm
Modern web browser (Chrome, Firefox, Edge, Safari)

Installation

# Clone the repository
git clone https://github.com/your-org/ttl-editor.git
cd ttl-editor

# Install dependencies
npm install

# Start development server
npm start

The application will open at http://localhost:3000

Build for Production

# Create optimized production build
npm run build

# The build folder contains the static files

📖 Usage Guide

Quick Start

Fill in Service Details - Basic service metadata
Add Organization - Competent authority information
Link Legal Resource - BWB ID or legal document
Define Rules - Decision logic (optional)
Add Parameters - Configuration values (optional)
Add Policy - CPRMV normative rules (optional)
Validate - Check for errors
Download TTL - Export compliant RDF/Turtle file

Import Existing Files

Click "Import TTL File" button
Select a .ttl file
All fields populate automatically
Edit and re-export for round-trip editing

DMN Integration

DMN Tab - Upload .dmn file
Deploy - Send to Operaton rule engine
Test - Evaluate with sample data
Export - TTL includes DMN metadata and rules

iKnow Integration

iKnow Tab - Upload iKnow XML export
Configure Mapping - Map XML fields to CPSV-AP
Preview - Review mapped data
Import - Populate editor tabs

🛠️ Development

Project Structure

ttl-editor/
├── public/                 # Static assets
├── src/
│   ├── components/        # React components
│   │   └── tabs/         # Tab components
│   ├── hooks/            # Custom React hooks
│   ├── utils/            # Business logic
│   ├── data/             # Configuration data
│   └── config/           # App configuration
├── docs/                  # Documentation
└── package.json

Key Technologies

React 18.3.1 - UI framework
Tailwind CSS 3 - Styling
Lucide React - Icons
RDF/Turtle - Semantic web standards

Code Style

ESLint for code quality
Prettier for formatting
Functional components with hooks
Modular architecture

🚢 Deployment

Production Deployment

The application is deployed to:

Production: https://cpsv.open-regels.nl
Acceptance: https://acc.cpsv.open-regels.nl

Manual Deployment

# Build
npm run build

# Deploy build/ folder to your hosting provider

Environment Variables

No environment variables required - fully client-side application.

🗺️ Roadmap

Completed Features ✅

✅ CPSV-AP 3.2.0 compliance (v1.4.0)
✅ DMN integration (v1.5.0)
✅ iKnow integration (v1.5.0)
✅ Full modularization (v1.5.1)
✅ RPP architecture visualization (v1.5.1)

Planned Features 🔜

Phase B: RPP Deep Integration

Cross-references between layers
"This rule implements Policy X" indicators
"This parameter is used by Rules Y, Z" tracking
Traceability visualization
Impact analysis

Phase C - Governance Features (Optional)

Add approval workflows
Layer-specific validation
Separate exports

Phase 2: Extended CPSV-AP

Channel support (cv:Channel)
Contact points (cv:ContactPoint)
Criteria requirements
Evidence requirements
Agent relationships

Phase 3: Advanced Features

Multi-language support
Collaboration features
Version control integration
Automated testing
Quality metrics

See src/data/roadmap.json for detailed roadmap.

📚 Documentation

User Documentation

README.md - This file, project overview

Technical Documentation

FIELD-MAPPING-CPSV-AP-3_2_0.md - UI field to TTL property mapping
NAMESPACE-PROPERTIES.md - RDF namespace reference
PROJECT-STRUCTURE.md - Code organization
VOCABULARY-INSTRUCTIONS.md - Vocabulary usage guide
RULES-POLICY-PARAMETERS-SEPARATION.md - RPP architecture pattern

Architecture Documentation

ARCHITECTURE-VISUAL.md - Visual architecture diagrams
REFERENCE-ARCHITECTURE-SEMANTIC-MEDIATION.md - Semantic mediation patterns

🤝 Contributing

This is a Dutch government project. For contributions or questions:

Check existing issues
Create detailed bug reports or feature requests
Follow the code style guidelines
Submit pull requests to acc branch

📄 License

EUPL v. 1.2 License - See LICENSE file for details

🔗 Links

Live Application: https://cpsv.open-regels.nl
Acceptance Environment: https://acc.cpsv.open-regels.nl
CPSV-AP Specification: https://semiceu.github.io/CPSV-AP/
Wetten Overheid: https://wetten.overheid.nl
CPRMV Documentation: https://cprmv.open-regels.nl/docs
Operaton Engine: https://operaton-doc.open-regels.nl

📞 Support

For support or questions about this project, please create an issue in the repository.

Built with ❤️ for Dutch Government Services

Version 1.5.1 - January 2026

Name		Name	Last commit message	Last commit date
Latest commit History 158 Commits
.github/workflows		.github/workflows
.husky		.husky
docs		docs
examples		examples
public		public
src		src
tooling		tooling
.env.acceptance		.env.acceptance
.env.development		.env.development
.env.example		.env.example
.env.production		.env.production
.eslintignore		.eslintignore
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
.prettierignore		.prettierignore
.prettierrc		.prettierrc
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js

License

sgort/ttl-editor

Folders and files

Latest commit

History

Repository files navigation