About this project

This project is a demo for Késmárki Szoftverfejlesztő Ltd.

Localhost quickstart

0. Please build this app first by using ./build-dev.sh
1. You have to start ./start-dc.sh in order to launch MSSQL database
2. This project will use the default master database. This application does not create any other db.
3. You can launch this application by using this command ./mvnw. This command will start the frontend as well.
4. Liquibase is used for creating DB scheme and load the default test data. No manual sql running is required.
5. Test data is loaded only in DEV profile
6. You can login as a user if you use this login/password user/user.
7. You can login as an admin if you use this login/password admin/admin

Restrictions

Because no SMTP server is configured in any application-*.yml the features depend on email sending won't send any mail. These features are the following:

• new user registration
• new user creation on the admin page
• forgotten password reset

Project Structure

• /src/* structure follows default Java structure.
• /src/main/docker - Docker configurations for the application and services that the application depends on
• /src/main/java - Java source folder
• /src/main/resources - Java resources folder
• /src/main/resources/config - Spring boot application configuration files
• /src/main/resources/liquibase/* - Folders for Liquibase changesets and data CSV files
• /src/main/webapp - React source folder
• /src/test/* - Folder for unit/IT/performance tests
• /sql_scripts - contains DDL and DML scripts (application won't use this scripts, liquibase is being used instead)

Development

Helper scripts

• ./build-dev.sh - starts a developer build
• ./build-prod.sh - starts a prod build
• ./start-dc.sh - starts the MS SQL Server and the Hazelcast Management Center for development using docker compose.
• ./stop-dc.sh - stops the docker compose process (and removes temporary orphan docker containers)

Basic maven operations

The build system will install automatically the recommended version of Node and npm.

Maven wrapper is provided to launch npm.

Run the following commands in two separate terminals to create a blissful development experience where your browser auto-refreshes when files change on your hard drive.

./mvnw
./npmw start

Testing

Spring Boot tests

To launch your application's tests, run:

./mvnw verify

Gatling

Performance tests are run by [Gatling][] and written in Scala. They're located in src/test/java/gatling/simulations.

You can execute all Gatling tests with

./mvnw gatling:test