DCR-js: an open-source process modelling and mining environment for DCR graphs

Try it live!

What are DCR Graphs? A novel Business Process Management notation is ideal for flexible processes, such as those in healthcare, municipal administration, or knowledge-intensive processes in general. The notation allows you to describe processes like a game, focusing on the rules.

For a formal definition of DCR graphs, please read this paper.

This tool supports a wide range of process mining activities for DCR graphs:

• Modeling, automatic layout, and nesting, and open test cases to support Test Driven Modeling.

• Discovery with automatic layouting and nesting.

• Conformance checking, both rule-based and alignment-based, with an additional heatmap feature to highlight both activations and violations, both log-based and trace-based.

• Simulation and manual event log generation with both conforming and non-conforming traces.

• Automatic event log generation by sampling models.

User Manual

The user manual for DCR-js can be found in the docs folder (Document version June 27, 2025) A video walk-through explaining the main functionalities of the tool can be watched here

Development information

This project is organized into three separate modules.

• App: The main react application. Visit here for information on UI development and extension, as well as information on running the application locally.

• Modeler: The DCR graph editor. The editor is based on the popular Diagram-js web editor. Visit here for information about editor development as well an how the editor is encapsulated for use in the application.

• DCR-engine: The underlying DCR engine. This module contains a typescript implementation of DCR graphs, all process mining algorithms, as well as all types used for these.

Citing DCR-js

We are happy that you are using our project for research purposes. We would appreciate it if you cite our project in case you decide to use the models in your publication:

If you use only the editor capabilities:

@inproceedings{dcrjs,
  title={An open-source modeling editor for declarative process models},
  author={Tamo, Lucien Kiven and Abbad-Andaloussi, Amine and Trinh, Dung My Thi and L{\'o}pez, Hugo A.},
  booktitle={International Conference on Cooperative Information Systems 2023},
  Volume={3552},
  pages={1--5},
  year={2023},
  organization={CEUR-WS}
}

If you use the process mining or simulation capabilities:

@inproceedings{christfort2025dcr,
  title={DCR-JS: An Online Environment for Declarative Process Mining},
  author={Christfort, Axel KF and L{\'o}pez, Hugo A.},
  booktitle={23rd International Conference on Business Process Management},
  Volume={4032},
  pages={1--5},
  year={2025}
}

License

This package is published using an MIT license