mirror of
https://github.com/MinBZK/regelrecht.git
synced 2026-05-05 23:42:17 +00:00
RegelRecht
https://regelrecht.rijks.app
- Rust 66.4%
- JavaScript 14%
- Vue 11.1%
- Gherkin 2.6%
- CSS 1.9%
- Other 3.9%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
The Prins/Wolswinkel WRR factsheet (23 jan 2025) linked to a PDF that actually contains the Lokin/Passchier factsheet (29 nov 2024). Both documents share the same theme and live on eerstekamer.nl, which made the swap easy to miss. Fixes: - Point Prins/Wolswinkel reference to the WRR landing page - Add Wolswinkel's Tilburg University affiliation - Add Lokin/Passchier factsheet as a separate reference (the original PDF link is preserved here, where it belongs) - Canonicalize the Raad van State URL (/actueel/nieuws/ prefix) Reported by Arjan Widlak. |
||
| .claude | ||
| .github | ||
| conformance/v0.5.0 | ||
| corpus | ||
| dev | ||
| docs | ||
| features | ||
| frontend | ||
| frontend-lawmaking | ||
| landing | ||
| packages | ||
| schema | ||
| script | ||
| tests/fixtures/federation | ||
| .dockerignore | ||
| .env.example | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| .yamllint | ||
| CLAUDE.md | ||
| corpus-registry.yaml | ||
| deny.toml | ||
| docker-compose.dev.yml | ||
| Justfile | ||
| LICENSE | ||
| README.md | ||
| REVIEW.md | ||
| rust-toolchain.toml | ||
regelrecht
Machine-readable Dutch law execution. regelrecht takes legal texts, encodes them as structured YAML, and runs them as deterministic decision logic.
What does it do
- The engine takes a regulation and a set of inputs, evaluates the decision logic, and returns a result with a full explanation trail
- Laws are tested against real-world scenarios using BDD (Gherkin) tests, many derived from legislative explanatory memoranda
- A harvester downloads and tracks Dutch legislation from the official BWB repository
- Regulations can be edited through a web UI with live execution preview
Components
Rust packages
| Package | Description |
|---|---|
| packages/engine/ | Law execution engine (also compiles to WASM) |
| packages/harvester/ | Downloads Dutch legislation from BWB |
| packages/pipeline/ | PostgreSQL job queue for law processing |
| packages/admin/ | Admin dashboard API (Axum) |
| packages/editor-api/ | Backend API for the law editor |
| packages/corpus/ | Git integration for the regulation corpus |
| packages/shared/ | Shared domain types across crates |
| packages/tui/ | Terminal dashboard (Ratatui) |
Frontends and sites
| Directory | Description |
|---|---|
| frontend/ | Law editor UI (Vue 3 + Vite) |
| frontend-lawmaking/ | Law-making process visualization (Vue 3 + Vite) |
| landing/ | Landing page |
| docs/ | Documentation site (VitePress) |
Data and testing
| Directory | Description |
|---|---|
| corpus/regulation/ | Dutch regulations in machine-readable YAML |
| schema/ | Versioned JSON schema for the law format (current: v0.5.1) |
| features/ | Gherkin BDD scenarios for law execution |
| packages/grafana/ | Grafana monitoring dashboards |
Deployed services
| Service | URL |
|---|---|
| Editor | https://editor.regelrecht.rijks.app |
| Landing page | https://regelrecht.rijks.app |
| Documentation | https://docs.regelrecht.rijks.app |
| Law-making | https://lawmaking.regelrecht.rijks.app |
| Harvester admin | https://harvester-admin.regelrecht.rijks.app |
| Grafana | https://grafana.regelrecht.rijks.app |
PR preview environments are deployed automatically and cleaned up when the PR is closed.
Getting started
Prerequisites: Rust (stable) and just.
just check # run all quality checks (format, lint, build, validate, tests)
just test # unit tests only
just bdd # BDD tests only
See the docs site for full development instructions.