Retail online web shopping cart example, the Cool Store demo leverages JBoss BRMS, JBoss Developer Studio, and Vaadin UI framework.
Java PowerShell Shell CSS Visual Basic
Clone or download

README.md

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:

  • v3.8 JBoss BRMS 6.4.0.GA on JBoss EAP 7.0.0.GA with cool store installed and RH CDK on OSE Cloud install option.

  • v3.7 JBoss BRMS 6.3.0 on JBoss EAP 6.4.7 with cool store installed and RH CDK on OSE Cloud install option.

  • v3.6 JBoss BRMS 6.2.0-BZ-1299002 on JBoss EAP 6.4.4 with cool store installed and RH CDK on OSE Cloud install option.

  • v3.5 JBoss BRMS 6.2.0-BZ-1299002 on JBoss EAP 6.4.4 with cool store installed.

  • v3.4 JBoss BRMS 6.2.0, JBoss EAP 6.4.4 and OSE aligned containerization.

  • v3.3 JBoss BRMS 6.2.0, JBoss EAP 6.4.4 and cool store installed, UI updated to Vaadin 7.6.0.

  • v3.2 JBoss BRMS 6.2.0, JBoss EAP 6.4.4 and cool store installed, UI updated to Vaadin 7.

  • v3.1 JBoss BRMS 6.2.0, JBoss EAP 6.4.4 and cool store installed.

  • v3.0 JBoss BRMS 6.1.1 (patch update applied) with cool store installed and Albert Wong updates for JBDS project importing.

  • v2.9 JBoss BRMS 6.1.1 (patch update applied) with cool store installed.

  • v2.8 JBoss BRMS 6.1 with cool store installed.

  • v2.7 JBoss BRMS 6.0.3 installer with cool store configured to scan external maven repository.

  • v2.6 JBoss BRMS 6.0.3 installer with cool store updated so that project unit tests running again.

  • v2.5 JBoss BRMS 6.0.3 with optional containerized installation.

  • v2.4 moved to JBoss Demo Central, with updated windows init.bat support and one click install button.

  • v2.3 JBoss BRMS 6.0.3 installer with cool store demo installed.

  • v2.2 JBoss BPM Suite 6.0.2, JBoss EAP 6.1.1, cool store demo installed.

  • v2.1 JBoss BPM Suite 6.0.1, JBoss EAP 6.1.1, cool store demo installed.

  • v2.0 JBoss BPM Suite 6.0.0, JBoss EAP 6.1.1, cool store demo installed.

  • v1.4 is BRMS 5.3.1 deployable, running on JBoss EAP 6.1.1, integrated BRMS maven repo into project so no longer need to add to personal settings configuration which fully automates project build.

  • v1.3 is BRMS 5.3.1 deployable, running on JBoss EAP 6.1.1, and added Forge Laptop Sticker to store.

  • v1.2 is BRMS 5.3.1 deployable, running on JBoss EAP 6.1, mavenized using JBoss repo.

  • v1.1 new welcome screen and doc fixes.

  • v1.0 is BRMS 5.3.1 deployable, running on JBoss EAP 6.

Announcement Sign

Video bpmPaaS CoolStore

Video bpmPaaS CoolStore

Decision Table

Domain Model