During this workshop we will create a software system for a startup travel agency called Kogito Travel Agency. The first iteration of the system will consist of a set of services that are able to deal with travel requests and the booking of hotels and flights.

You will need:

• Java 1.8.0+ installed
• Environment variable JAVA_HOME set accordingly
• Maven 3.5.4+ installed
• Visual Studio Code

To install the Kogito extension type in your terminal :

$ curl -L http://bit.ly/get-kogito-ext | sh     

or download and install it manually

Optionally, for native compilation, you will also need:

• GraalVM installed
• Environment variable GRAALVM_HOME set accordingly
• Note that GraalVM native image compilation typically requires other packages (glibc-devel, zlib-devel and gcc) to be installed too, please refer to GraalVM installation documentation for more details.

mvn clean package quarkus:dev    

NOTE: With dev mode of Quarkus you can take advantage of hot reload for business assets like processes, rules and decision tables and java code. No need to redeploy or restart your running application.

Note that this requires GRAALVM_HOME to point to a valid GraalVM installation

mvn clean package -Pnative

To run the generated native executable, generated in target/, execute

./target/kogito-travel-agency-{version}-runner

• Create project using Quarkus Maven plugin with following extensions
  • Kogito
  • OpenApi
• Import project into Visual Studio Code IDE - requires BPMN modeller plugin installed
• Create data model
  • Traveller
  • Hotel
  • Flight
  • Address
  • Trip
• Create service classes
  • HotelBookingService
  • FlightBookingService
• Create decision logic
  • Visa check
• Create business logic
  • Public business process to deal with complete travel request
  • Private business process to deal with hotel booking
  • Private business process to deal with flight booking
• Create a test case that makes use of processes and decisions
• Create or import UI components
• Add metrics support for processes and decisions
• Create dashboard based on metrics

Kogito Travel Agency booking system will be based on following data model

Traveller

A person who requests a new travel

Trip

Place/Location where the traveller wants to go and dates

Flight

Flight that has been booked for the traveller to take him/her to the destination

Hotel

Place/Location where the traveller will stay during his/her travel

Address

Location that is associated with either traveller or hotel

The decision logic will be implemented as DRL rules. The logic will be responsible for verifying whether a given traveller requires a visa to enter a given country or not. The decision logic reason over the following data/facts

• Destination that the traveller wants to go - country
• Nationality of the traveller
• Length of the stay

e.g.:

rule "Polish citizens do not require visa to US"
	when
		$trip: /trips[ $trip.country == "US" ]
		$traveller: /travellers[ $traveller.nationality == "Polish" ]
	then
		$trip.setVisaRequired( true );
end

Business logic will be based on business processes

Public process that will be responsible for orchestrating complete travel request

Private process that will be responsible for booking a hotel.

Private process that will be responsible for booking a flight.

There will be services implemented to carry on the hotel and flight booking. Implementation will be a CDI beans that will have hard coded logic to return a booked flight or hotel.

• org.acme.travels.service.HotelBookingService
• org.acme.travels.service.FlightBookingService

Kogito Travel Agency comes with basic UI that allows to

To start Kogito Travel Agency UI just point your browser to http://localhost:8080

Once the service is up and running, you can use the following examples to interact with the service.

Send travel that requires does not require visa

curl -H "Content-Type: application/json" -H "Accept: application/json" -X POST http://localhost:8080/travels -d @- << EOF
{
	"traveller" : {
		"firstName" : "John",
		"lastName" : "Doe",
		"email" : "[email protected]",
		"nationality" : "American",
		"address" : {
			"street" : "main street",
			"city" : "Boston",
			"zipCode" : "10005",
			"country" : "US"
		}
	},
	"trip" : {
		"city" : "New York",
		"country" : "US",
		"begin" : "2019-12-10T00:00:00.000+02:00",
		"end" : "2019-12-15T00:00:00.000+02:00"
	}
}
EOF

This will directly go to 'ConfirmTravel' user task.

Send travel request that requires does require visa

curl -H "Content-Type: application/json" -H "Accept: application/json" -X POST http://localhost:8080/travels -d @- << EOF
{
	"traveller" : {
		"firstName" : "Jan",
		"lastName" : "Kowalski",
		"email" : "[email protected]",
		"nationality" : "Polish",
		"address" : {
			"street" : "polna",
			"city" : "Krakow",
			"zipCode" : "32000",
			"country" : "Poland"
		}
	},
	"trip" : {
		"city" : "New York",
		"country" : "US",
		"begin" : "2019-12-10T00:00:00.000+02:00",
		"end" : "2019-12-15T00:00:00.000+02:00"
	}
}
EOF

This will stop at 'VisaApplication' user task.

Returns list of travel requests currently active:

curl -X GET http://localhost:8080/travels

As response an array of travels is returned.

Returns travel request with given id (if active):

curl -X GET http://localhost:8080/travels/{uuid}

As response a single travel request is returned if found, otherwise no content (204) is returned.

Cancels travel request with given id

curl -X DELETE http://localhost:8080/travels/{uuid}

Returns currently assigned user tasks for give travel request:

curl -X GET http://localhost:8080/travels/{uuid}/tasks

Returns visa application task information:

curl -X GET http://localhost:8080/travels/{uuid}/VisaApplication/{task-uuid}

Completes visa application task

curl -H "Content-Type: application/json" -H "Accept: application/json" -X POST http://localhost:8080/travels/{uuid}/VisaApplication/{task-uuid} -d '{}'

Returns travel (hotel, flight) task information required for confirmation:

curl -X GET http://localhost:8080/travels/{uuid}/ConfirmTravel/{task-uuid}

Completes confirms travel task - meaning confirms (and completes) the travel request

curl -H "Content-Type: application/json" -H "Accept: application/json" -X POST http://localhost:8080/travels/{uuid}/ConfirmTravel/{task-uuid} -d '{}'