Overview

This project provides a webapp for reading and creating new cakes from a simple in memory database. It runs on Spring boot (webflux stack) and has an Angular front end.

The run script currently packages the static content within the resources of the java project purely to avoid requiring a separate standalone web server for demo purposes.

Running the project

To run this project, first install and setup any missing dependencies:

• Your favourite 8+ JDK e.g. Liberica

• Maven

• Node.js

• Angular CLI: npm install -g @angular/cli

• Checkout the and navigate to the source directory

• Running with the .bat script

  • run run.bat from a console

• Running directly

  • run npm install in webapp/cake-explorer
  • run ng build in webapp/cake-explorer
  • run mvn package in the top directory where your pom is stored
  • run java -jar cake-manager-1.0-SNAPSHOT.jar in the /target directory

• The cakes app is running on localhost:8080 with swagger available at http://localhost:8080/webjars/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/

This project uses lombok, so if running in your IDE you may need to add support for this. IntelliJ comes with bundles support.

*note that some of the example images are no longer available, so a resource file has been included: init.json where initialisation data can be added.

Logging in

The app will let you view the cakes unauthenticated, but to add a new one you'll need to log in.

The app uses OAuth2 with Auth0 to enable authentication. You can login with your google account, or there is also a local test user set up:

username: testuser@test.com

password: A-Value-To-Login

• Note that the initial load of the keys by spring can be pretty slow
• Subsequent adds should be quick