a light-weight extensible workflow based on Nodejs which is built with Typescript
# Flowooh Flowooh does not rely on any service framework and can easily be integrated into different Node server applications such as Express, Koa, NestJs, etc. This makes Flowooh very flexible and easy to use. Flowooh provides rich features and APIs to help developers quickly build workflow engines and workflow applications. Additionally, Flowooh supports plugins and extensions, allowing developers to customize and extend functionality based on their needs. # Ongoing... This repository is just getting started and is not ready for use. I plan to implement the involved elements according to the specification of BPMN, and now I am in the process of implementing the BPMN Core Structure. Then I will refactor the XML-to-object transformation so that the implementation classes conform to the BPMN specification. Here is the document I referred to: https://www.omg.org/spec/BPMN/2.0.2/PDF Wishlist: 1. refactor BPMN element implementations 2. build a designer for Flowooh([bpmnjs](https://github.com/bpmn-io/bpmn-js), [lowcode-engine](https://github.com/alibaba/lowcode-engine)) 3. build a approval workflow implementation demo based on Flowooh 4. build a project management system implementation demo based on Flowooh # Vision and purpose Workflow engines are commonly used in development, and there are already excellent workflow projects such as Activiti, Flowable, Camunda, etc. However, there is a lack of similar tools or projects on Node.js. I hope to build a workflow engine based on Node.js to help developers better integrate and implement workflow applications on the Node.js server. # Getting Started Clone the repo to your local machine ```bash $ git clone https://github.com/flowooh/flowooh.git ``` Switch current directory to `samples/flowooh-demo-simple` and install dependencies ```bash $ cd samples/flowooh-demo-simple $ npm i ``` Create a file `.env` and configure it ```.dosini DEBUG=* FLOWOOH_DATA_DB_CLIENT=sqlite3 FLOWOOH_DATA_DB_CONNECTION=.db/test.sqlite ``` Init Database(Sqlite3), run script to launch server. then open `http://localhost:5173/` in Browser ```bash $ npm run init-db $ npm run dev ``` # Pulling and Submitting Code If you have any comment or advice, please report your [issue](https://github.com/flowooh/flowooh/issues), or make any change as you wish and submit a [PR](https://github.com/flowooh/flowooh/pulls). ## Pulling Code Please click the "[Fork](https://github.com/flowooh/flowooh/fork)" button in the main page of Flowooh to fork the latest code into your own repository. Then clone yours to your local machine. ## Install Dependencies You can install all the dependencies listed in package.json with npm: ```bash $ npm i ``` ## Link to Global You can link flowooh to global of your local machine, so you can use it in developing locally. ```bash $ npm run build $ npm run link:data ``` 1. Before you link flowooh to global, you should build it by using `npm run build`. 2. Since Flowooh is a Monorepo built by [Lerna](https://lerna.js.org/), it is not recommend to using `npm link` directly. you can use `npm run link: