https://github.com/sgort/linked-data-explorer

Explore TriplyDB regels.overheid.nl services
https://github.com/sgort/linked-data-explorer

Last synced: 20 days ago
JSON representation

Explore TriplyDB regels.overheid.nl services

• Host: GitHub
• URL: https://github.com/sgort/linked-data-explorer
• Owner: sgort
• License: eupl-1.2
• Created: 2025-12-16T12:10:51.000Z (6 months ago)
• Default Branch: acc
• Last Pushed: 2026-05-12T10:46:21.000Z (about 1 month ago)
• Last Synced: 2026-05-12T12:31:37.402Z (about 1 month ago)
• Language: TypeScript
• Size: 1.34 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Linked Data Explorer

This repository contains the **source code** for the Linked Data Explorer. Full documentation is maintained separately in the [iou-architectuur](https://git.open-regels.nl/showcases/iou-architectuur) repository and published at **[iou-architectuur.open-regels.nl/linked-data-explorer](https://iou-architectuur.open-regels.nl/linked-data-explorer/)**.

---

[![Deployed on Azure Static Web Apps](https://img.shields.io/badge/Azure-Static_Web_Apps-blue?logo=microsoft-azure)](https://linkeddata.open-regels.nl)

[![TypeScript](https://img.shields.io/badge/TypeScript-5.8-blue?logo=typescript)](https://www.typescriptlang.org/)

[![React](https://img.shields.io/badge/React-19.2-61dafb?logo=react)](https://react.dev/)

[![Vite](https://img.shields.io/badge/Vite-6.2-646cff?logo=vite)](https://vitejs.dev/)

[![Node.js](https://img.shields.io/badge/Node.js-22-339933?logo=node.js)](https://nodejs.org/)

[![Express](https://img.shields.io/badge/Express-4.18-000000?logo=express)](https://expressjs.com/)

![License](https://img.shields.io/badge/License-EUPL--1.2-yellow.svg)

🌐 **Production:** [linkeddata.open-regels.nl](https://linkeddata.open-regels.nl)  

🧪 **Acceptance:** [acc.linkeddata.open-regels.nl](https://acc.linkeddata.open-regels.nl)

---

## What is the Linked Data Explorer?

The **Linked Data Explorer** is a web application for discovering, composing, and executing DMN decision model chains from Dutch government knowledge graphs. It is built as part of the **Regels Overheid Nederland (RONL)** initiative and connects directly to TriplyDB knowledge graphs and the Operaton DMN execution engine.

---

## What it does

The Linked Data Explorer lets you work with government decision models end-to-end — from discovery to execution:

- **Discover** available DMN decision models published to TriplyDB by government agencies

- **Build chains** by drag-and-drop, connecting DMN outputs to DMN inputs across agency boundaries

- **Execute chains** sequentially or as unified DRDs, with automatic variable orchestration

- **Query** any SPARQL endpoint with syntax highlighting and interactive graph visualisation

- **Model processes** with a BPMN 2.0 editor that links directly to DMN decision models

- **Track governance** status: see which DMNs have been validated by competent authorities

- **Discover vendor implementations** of reference decision models

---

## Ecosystem position

The Linked Data Explorer is one of three components in the RONL ecosystem:

```mermaid

graph TB

    CPSV[CPSV Editor
cpsv-editor.open-regels.nl]

    LDE[Linked Data Explorer
linkeddata.open-regels.nl]

    BACKEND[Shared Backend
backend.linkeddata.open-regels.nl]

    TRIPLY[TriplyDB
Knowledge Graph]

    OPERATON[Operaton
DMN Engine]

    CPSV -->|publishes TTL + DMN| TRIPLY

    LDE -->|discovers DMNs via SPARQL| TRIPLY

    LDE -->|executes decisions via REST| OPERATON

    LDE -->|API calls| BACKEND

    BACKEND -->|SPARQL| TRIPLY

    BACKEND -->|REST| OPERATON

```

The **CPSV Editor** produces the data — government service definitions and DMN decision models published as Linked Data to TriplyDB. The **Linked Data Explorer** consumes that data — discovering, chaining, and executing those decisions. The **Shared Backend** handles orchestration logic that both applications depend on.

---

## Environments and deployment

| | Frontend | Backend |

|---|---|---|

| **Production** | [linkeddata.open-regels.nl](https://linkeddata.open-regels.nl) | [backend.linkeddata.open-regels.nl](https://backend.linkeddata.open-regels.nl) |

| **Acceptance** | [acc.linkeddata.open-regels.nl](https://acc.linkeddata.open-regels.nl) | [acc.backend.linkeddata.open-regels.nl](https://acc.backend.linkeddata.open-regels.nl) |

| **Branch** | `main` / `acc` | `main` / `acc` |

| **Platform** | Azure Static Web Apps | Azure App Service (Linux, Node.js 22) |

---

## Technology stack

| Layer | Technology | Version |

|---|---|---|

| Frontend framework | React | 19.2.3 |

| Language | TypeScript | 5.8.x |

| Build tool | Vite | 6.2.x |

| Graph visualisation | D3.js | 7.9.x |

| BPMN editor | bpmn-js | 18.12.0 |

| Drag-and-drop | dnd-kit | 6.x / 10.x |

| Backend framework | Node.js + Express | 22 / 4.18.x |

| DMN engine | Operaton | — |

| Knowledge graph | TriplyDB | — |

| Package structure | npm workspaces | monorepo |

---

## Repository structure

```

linked-data-explorer/

├── packages/

│   ├── frontend/                   # React TypeScript SPA

│   │   ├── src/

│   │   │   ├── components/

│   │   │   │   ├── ChainBuilder/   # DMN chain builder (main feature)

│   │   │   │   ├── BpmnModeler/    # BPMN 2.0 process editor

│   │   │   │   ├── GraphView.tsx   # D3.js SPARQL graph visualisation

│   │   │   │   ├── ResultsTable.tsx

│   │   │   │   └── Changelog.tsx

│   │   │   ├── services/

│   │   │   │   ├── sparqlService.ts

│   │   │   │   └── templateService.ts

│   │   │   ├── utils/

│   │   │   │   └── exportService.ts

│   │   │   ├── types/

│   │   │   ├── changelog.json

│   │   │   └── tutorial.json

│   │   ├── .env.development

│   │   ├── .env.acceptance

│   │   └── .env.production

│   │

│   └── backend/                    # Node.js/Express orchestration API

│       ├── src/

│       │   ├── routes/             # /v1/dmns, /v1/chains, /v1/health

│       │   ├── services/           # SPARQL, Operaton, orchestration

│       │   ├── middleware/

│       │   └── utils/

│       └── .env.example

│

├── examples/ttl/                   # Test DMN data (6 models)

├── .github/workflows/              # CI/CD pipelines (acc + production)

└── package.json                    # Workspace root

```

---

## Documentation

Full documentation is at [iou-architectuur.open-regels.nl/linked-data-explorer](https://iou-architectuur.open-regels.nl/linked-data-explorer/).

| Section | URL |

|---|---|

| Getting started | [/linked-data-explorer/user-guide/getting-started/](https://iou-architectuur.open-regels.nl/linked-data-explorer/user-guide/getting-started/) |

| Local development | [/linked-data-explorer/developer/local-development/](https://iou-architectuur.open-regels.nl/linked-data-explorer/developer/local-development/) |

| Architecture | [/linked-data-explorer/developer/architecture/](https://iou-architectuur.open-regels.nl/linked-data-explorer/developer/architecture/) |

| API reference | [/linked-data-explorer/reference/api-reference/](https://iou-architectuur.open-regels.nl/linked-data-explorer/reference/api-reference/) |

| Changelog & roadmap | [/linked-data-explorer/developer/changelog-roadmap/](https://iou-architectuur.open-regels.nl/linked-data-explorer/developer/changelog-roadmap/) |

---

## Licence

[EUPL-1.2](./LICENSE)