/spring-scorekeep

Spring Boot ScoreKeep Application by Jonathan Saddler

Primary LanguageJava

Spring Boot ScoreKeep Application by Jonathan Saddler

spring-scorekeep

A Scorekeeper application written in Spring Boot for web access of scores from tabletop games.

Language: Java 11

Technologies used in this application:

Application Framework Technologies:

  • Spring Boot 2.5.4
  • Spring Thymeleaf
  • Apache Maven

Database Technologies

  • Docker Desktop
  • (On the desktop) PostgresQL 14.3 (latest) running on Docker.
  • Redgate Flyway Community 7.7.3

Snapshots

*** Here is how this app used to look before June 19, 2022 ***

New Look

*** Here is how it looks now ***

New Look

Status

Currently (as of Tuesday June 21, 2022): This application contains a viewer at endpoint "/" that shows the list of all scores logged in the database "jonnyscorekeep".

This application when complete will keep a table of scores earned in tabletop games.

This application is part of a series of breakneck, two-week projects. Each project is completed and posted to GitHub in a span of two weeks to briefly and quickly demonstrate programming concepts.

Supported Applications

We support the games of "Scrabble", and "Pounce".

Configuration and Running

An out of the box command that can be used to download and run a docker database environment that will run compatible with this image is provided below with a few instructions.

  • Create a space to host a docker volume on your hard drive, I created a directory at this path on my machine C:\Users\<my_username>\srv\pg3

  • run this command

docker run --name java-postgres -e POSTGRES_PASSWORD=password -d -v "C:\Users\<username>\srv\pg3":/var/lib/postgresql/data -p 5432:5432 postgres

  • Clone this project and then run a Spring Boot task using Maven at the root of the repository clone where your pom.xml resides.

mvn spring-boot:run

I'm running this command on Windows. Once you have this, all the settings in the configuration of the spring boot project should run to connect to this database, and start this application to be served on a page you can get to from your browser:

  • Navigate to http://localhost:8080 to see a sample scores page.