Finitequiz-Backend

This repository contains the backend for the Finitequiz minigame.

It persists the game data (configurations, game results, etc.) in a database and communicates with other backend services.

Table of contents

• Links
• REST API
  • Swagger-Ui
• Getting started
  • Run
    • Docker-compose
    • Project build
    • With Docker
  • Testing Database
• Class Diagrams
• Constants

Links

• User documentation for the minigame can be found here.
• For the frontend, see the Gamify-IT/finitequiz repository.
• The installation manual and setup instructions can be found here.

REST API

Rest mappings are defined in

• Game result controller: src/main/java/de/unistuttgart/finitequizbackend/controller/GameResultController.java
• Config controller: src/main/java/de/unistuttgart/finitequizbackend/controller/ConfigController.java

Swagger-Ui

When the service is started (see Getting started), you can access the API documentation:

Open http://localhost/minigames/finitequiz/api/v1/swagger-ui/index.html#/ and fill http://localhost/minigames/finitequiz/api/v1/v3/api-docs into the input field in the navbar.

Development

Getting started

Beginning of additions (that work)

Make sure you have the following installed:

• Java: JDK 1.17 or higher
• Maven: Maven 3.6.3
• Docker: Docker
• PostgreSQL: PostgreSQL

Run

Project build

To build the project, run:

mvn install

in the project folder. Then go to the target folder:

cd target

and run:

java -jar finitequiz-backend-0.0.1-SNAPSHOT.jar

to start the application.

Build with docker

To run your local changes as a docker container, with all necessary dependencies, build the Docker container with:

docker compose up --build

You can remove the containers with:

docker compose down

Run local with dependencies

To run your local build within your IDE, but also have the dependencies running in docker, follow the steps to build the project, then run the dependencies in docker with the following:

docker compose -f docker-compose-dev.yaml up 

You can remove the containers with:

docker compose -f docker-compose-dev.yaml down

End of additions

Testing Database

to setup a database with docker for testing you can use

docker run -d -p 5432:5432 -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=postgres  --rm --name finitequiz-database postgres

To stop and remove it simply type

docker stop finitequiz-database

Class Diagrams

Constants

To prevent incorrect or cheated data, all important values are checked for logic. The field borders are configured in src/main/java/de/unistuttgart/finitequizbackend/Constants.java.

1. MIN_QUESTION_COUNT minimal number of questions a player can answer correctly
2. MAX_QUESTION_COUNT maximal number of questions a player can answer correctly
3. MIN/MAX_SCORE should not be changed