/bluezone

An example application implementing Hexagonal Architecture

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

BlueZone

An example application implementing Hexagonal Architecture

See the article series: [https://jmgarridopaz.github.io/content/hexagonalarchitecture-ig/intro.html]

BlueZone: Hexagonal Application Figure

BlueZone allows car drivers to pay remotely for parking cars at zones in a city, instead of paying with coins using parking meters.

  • Users (driver actors) of the application are car drivers and parking inspectors.

    • Car drivers will access the application using a Web UI (User Interface), and they can do the following:

      • Query all the available rates in the city, in order to choose the one of the zone he wants to park the at.
      • Purchase a parking ticket, paying an amount of money for parking a car at a zone, during a period of time. This period starts at current date-time. The ending date-time is calculated from the paid amount, according to the rate of the zone.
    • Parking inspectors will access the application using a terminal with a CLI (Command Line Interface), and they can do the following:

      • Check whether a car is illegally parked at a zone. This will happen if there is no valid ticket for the car and the rate of the zone. A ticket is valid if current date-time is between the starting and ending date-time of the ticket period.
  • Driven actors needed by the application are: a rate repository, a ticket repository, and a payment service.

Development environment:

  • Java 11 (version "11.0.15.1" 2022-04-22 LTS)

  • Maven 3.8.6

  • IntelliJ IDEA 2021.3.3 (Community Edition)

  • Ubuntu 20.04.4 LTS (Linux 5.13.0-40-generic)

Instructions:

  • Download and extract this github repo to a local directory on your computer ( <bluezone_dir> )

  • Compile all modules (you need to do this just the first time before running):

    cd <bluezone_dir>
    ./scripts/build.sh
    
  • Select the adapters to be plugged-in at each port, editing the "ports-adapters.properties" file, located in the "<bluezone_dir>/scripts" directory.

  • Run the entry point to the app:

    cd <bluezone_dir>
    ./scripts/run_bluezone.sh