System Overview
RegelRecht is built on two pillars: the Corpus Juris (a git-versioned body of all Dutch law) and the Execution Engine (a runtime that evaluates laws deterministically).
System Context
Container Diagram
Data Flow
- Harvesting: The harvester downloads laws from BWB (wetten.nl) and converts XML to YAML
- Enrichment: Laws are enriched with machine-readable interpretations (currently manual + AI-assisted)
- Storage: All laws live in the Corpus Juris (git repository) as versioned YAML files
- Execution: The engine loads laws from the corpus and evaluates them given inputs
- Cross-references: When a law references another, the engine resolves the dependency chain automatically
Design Principles
The YAML format stays close to the original legal text structure. Same inputs always produce the same outputs. Every computed value traces back to a specific article and paragraph. Text interpretation is separate from execution. And all laws, tooling, and decisions are publicly auditable.
Further Reading
- Methodology - the execution-first validation approach
- Engine - execution engine architecture
- RFC Index - all design decisions