Task organizer

Description

This application allows you to track and manage software development projects.

Personal goals

• To keep getting familiar with Spring Boot framework and learn how to perform basic CRUD operations
• To acquire experience with ORM (Object-Relational Mapping) and JPA (Java Persistence API). Specifically, One-to-Many and Many-to-One relationships
• To start using Thymeleaf as a front-end template engine and dive into layouts and decorators.
• To implement custom model validations
• To start using Spring Security in order to perform common user management operations such as Sign up, Log in and Role definition
• To implement unit tests by using JUnit

Stack

Front-end

• Thymeleaf
• Bootwatch (as a layer on top of Bootstrap)

Back-end

• Spring Boot
• Hibernate (as a JPA framework)

Database

• MySQL

Server

• Apache Tomcat (default embedded server provided by Spring Boot)

Dependency management tool

• Gradle

Containerization

• Docker-compose

Build setup

With Docker

• Clone this repo to your local machine.Docker-compose version must above 1.18 (Upgrade docker-compose to the latest version)[https://stackoverflow.com/questions/49839028/how-to-upgrade-docker-compose-to-latest-version]. Don't forget to restart your shell after performing all the steps.

# Start docker-compose

$ docker-compose up

This command creates the three docker containers detailed below:

• task-organizer_app_1: Main container of the Spring Boot application

• task-organizer_mysql_1: DB container

• task-organizer_adminer_1: DB management tool to interact with the MySQL DB

Adminer's credentials are the ones defined in .env file.

• Open your browser and test the application on localhost:8086

Without Docker

• Clone this repo to your local machine. If you use IntelliJ as IDE, open this project there.

• MySQL and MySQL Workbench must be already installed in your machine. Otherwise, you will have to install them. Please notice that the default parameters (port, username and password) to enable the MySQL connection are defined on application.properties file. So, feel free to edit them in order to match one of your MySQL connections.

# Create the db

CREATE SCHEMA `app_db` ;

• Run the project as Spring Boot App

• Open your browser and test the application on localhost:8080

References

I have accomplished the aforementioned goals thanks to the following course:

• Springboot+Spring-Security |Full-Stack web-app