/secretsanta-generator

Secret Santa Generator web application built with Spring Boot, Thymeleaf, H2 Database :santa:

Primary LanguageJava

Secret Santa Generator Application 🎅

A secret santa generator web application built using Spring Boot technologies, Thymeleaf views, JPA, H2 Database, and more. The project features Spring Model, View, and Controller (MVC) architecture and Service and Repository layers.

This project is based on the popular Christmas game Secret Santa where friends draw names from a hat to decide who they are required to give a present to. This project allows users to add names, and the project randomly generates secret santa matches (it isn't as simple as creating random pairs). There are different solutions to the "Secret Santa problem" as the problem essentially creates a directed graph.

Preview images 🔻

Some images of the application
  • Welcome Page

Welcome

  • Add People

Add

  • Generate "Matches"

Matches

Running the application locally

Secret Santa Generator is a Spring Boot application built using Maven. You can build a jar file and run it from the command line:

git clone https://github.com/NotTheBest/secretsanta-generator.git
cd secretsanta-generator
./mvnw package
java -jar target/*.jar

You can then access the application here: http://localhost:8080/

Welcome

Or you can run it from Maven directly using the Spring Boot Maven plugin.

./mvnw spring-boot:run

Database Configuration

This project uses an in-memory database (H2). If you would like to work on the project, enable the http://localhost:8080/h2-console via the property :

spring.h2.console.enabled=true

in application.properties.

The database url used is jdbc:h2:mem:testdb.

About

This project was a personal project to learn more about Spring development, database management, and industry application architecture.

A small summary of the skills showcased during this project: 🔻

  • Java Spring Core, HTML5, CSS and similar topics
  • Spring MVC Controller and View management & annotations
  • Spring Boot capabilities, annotations, usage, and deployment
  • Thymeleaf technology, syntax, usage, capabilities, more
  • Client/Server data transfer
  • JPA annotations and repository management
  • H2 in-memory database management
  • Software/web application development processes
  • MVC architecture along with DAO, model, service layers, and similar
  • Accessibility, web design
  • Web application debugging
  • Where Santa lives
  • More! :)