search

jbossdemocentral / brms-coolstore-demo

Retail online web shopping cart example, the Cool Store demo leverages JBoss BRMS, JBoss Developer Studio, and Vaadin UI framework.
60 stars 64 forks source link

readme

JBoss BRMS Suite Cool Store Demo

This is a retail web store demo where you will find rules, decision tables, events, and a ruleflow that is leveraged by a web application. The web application is a WAR built using the JBoss BRMS generated project as a dependency, providing an example project showing how developers can focus on the application code while the business analysts can focus on rules, events, and ruleflows in the JBoss BRMS product web based dashboard.

This demo is self contained, it uses a custom maven settings to deploy all built JBoss BRMS knowledge artifacts into an external maven repository (not your local repository), in /tmp/maven-repo.

There are four options available to you for using this demo; local, Docker, Openshift Online and Red Hat CDK OpenShift Enterprise.

Software

The following software is required to run this demo:

Option 1 - Install on your machine

  1. Download and unzip.

  2. Add products to installs directory.

  3. Run 'init.sh' or 'init.bat' file. 'init.bat' must be run with Administrative privileges.

  4. Start JBoss BRMS Server by running ./target/jboss-eap-7.0/bin/standalone.sh

  5. Login to http://localhost:8080/business-central

    - login for admin and analyst roles (u:brmsAdmin / p:jbossbrms1!)

  6. Build and deploy project. To do this, click on 'Authoring -> Project Authoring', this will open the 'Project Authoring' view. Click on the 'Open Project Editor' button, which opens the project editor. Now, click on the 'Build -> Build & Deploy' button, which can be found on the right-hand side of the project editor window.

  7. Open shopping cart and demo away (http://localhost:8080/brms-coolstore-demo)

Option 2 - Install on OpenShift

Running this demo in a container on any OpenShift Container Platform is available at Red Hat Demo Central.

Option 3 - Run in Docker

The following steps can be used to configure and run the demo in a container

  1. Download and unzip.

  2. Add the EAP installer and BPM Suite deployable to installs directory.

  3. Run the 'init-docker.sh' or 'init-docker.ps1' file.

  4. Start the container: docker run -it -p 8080:8080 -p 9990:9990 jbossdemocentral/brms-coolstore-demo

  5. Login to http://<DOCKER_HOST>:8080/business-central

    - login for admin and analyst roles (u:brmsAdmin / p:jbossbrms1!)

  6. Open shopping cart and demo away (http://<DOCKER_HOST>:8080/brms-coolstore-demo)

Additional information can be found in the jbossdemocentral container developer repository

Notes

The web application (shopping cart) is built during demo installation with a provided coolstore project jar version 2.0.0. When you open the project you will find the version is also set to 2.0.0. You can run the web application as is, but if you build and deploy a new version of 2.0.0 to your maven repository it will find duplicate rules. To demo you deploy a new version of the coolstore project by bumping the version number on each build and deploy, noting the KieScanner picking up the new version within 10 seconds of a new deployment. For example, initially start project, bump the version to 3.0.0, build and deploy, open web application and watch KieScanner in server logs pick up the 3.0.0 version. Now change a shipping rule value in decision table, save, bump project version to 4.0.0, build and deploy, watch for KieScanner picking up new 4.0.0 version, now web application on next run will use new shipping values.

Supporting Articles

Released versions

See the tagged releases for the following versions of the product:

Announcement Sign

Video bpmPaaS CoolStore

Video bpmPaaS CoolStore

Decision Table

Domain Model