This is the main application subrepository for the SimuBridge project. It contains the source code for the web application that is the heartpice of the project. Please refer to the root repository for overall project documentation.
This readme focusses on the technical details of the application and presents instructions how to run the application in isolation.
We recommend to start the SimuBridge application as part of the docker-compose of the SimuBridge root project. Please refer to the instructions there.
This way, the process miner(s) and simulator(s) SimuBridge interacts with are also running.
SimuBridge can also run standalone. This can be useful for development purposes, or if no integration with process miners or simulators is wanted.
First, clone this repository with
git clone git@github.com:INSM-TUM/SimuBridge--Main.gitTo run SimuBridge as standalone docker container, first build the container by navigáting to the repository folder and running
docker build -t simulation-bridge:1.0.0 .This builds the image which can then be instantiated using
docker run -it -p 3000:3000 simulation-bridge:1.0.0SimuBridge is then available under localhost:3000
To build SimBridge from source for development, first the dependency packages need to be installed. This needs node to be installed, and is done by navigating to the repository folder and running
npm install --legacy-peer-depsThe application can then be started via
npm run clientThe web application is split into multiple pages, each with dedicated purpose. Notably, the discovery and simulator views interact with the external process discovery and simulation tools, respectively.
We built the application using the Javascript library React, using the Chakra-UI design framework to ensure a modern look.
The application stores some information in the session storage, namely which projet is currently edited. Most persistence, however, happens using the browser IndexedDB API, to ensure also large data, such as event logs, can be handled.