The Leave Management System is a web-based application developed using Spring Boot, Spring Security, and Thymeleaf. The system is integrated with AWS services and RDS MySQL for database management.
It allows employees to apply for leave and submit compensation claims, managers to generate reports, approve or reject leave applications and compensation claims, and administrators to manage employees, job designations, users and their roles, leave balances, public holidays, and the company hierarchy.
- Java Spring Boot
- Thymeleaf
- MySQL
- Docker
- Github Actions
- AWS Services (EC2, RDS, CloudFront, Route 53)
- Employee: Apply, update, and cancel leave,
- Manager: Generate reports and approve or reject leave applications and compensation claims.
- Admin: Manage employees, job designations, users, roles, leave balances, public holidays and approval hierarchy.
- Admin
admin | adminadmin - Manager
manager | manager - Employee
employee | employee
- Recommended: IntelliJ IDEA Ultimate
- SpringToolSuite4
- JDK 17
- Maven
- MySQL Server
- MySQL Username:
root - MySQL Password:
root
-
Create the Schema Start your MySQL server and Run the following SQL command to create the schema:
CREATE DATABASE leave_processing_system;
-
Build the Project
mvn clean install
-
Run the Application
mvn spring-boot:run
-
Seed Mock Data
The mock data will be seeded through the command-line runner. -
Access the Application
Open your browser and go to http://localhost:8080.
- Ensure MySQL server is running and accessible.
- Check for any port conflicts on
8080. - Verify the database credentials in
application.properties.
To add the navigation bar to your page, include the following line after the <body> tag in your HTML file:
<div th:replace="fragments/navbar :: menu"></div>Replace your <head></head> tag in your HTML file with:
<head th:replace="fragments/head :: html_head"></head>This will insert the navigation bar onto the top of your page, along with bootstrap and a title. Ignore the 'Missing required title element warning by Intellij'.
/home/admin will look like this with the navbar:
<!DOCTYPE html>
<html lang="en">
<head th:replace="fragments/head :: html_head"></head>
<body>
<div th:replace="fragments/navbar :: menu"></div>
Admin Home
</body>
</html>Customize the navigation bar by editing the navbar.html file located at:
src/main/resources/templates/fragments/navbar.html
This file contains the HTML and Bootstrap classes for the navigation bar.
To change or add more navigation items, edit / add to the relevant sections in the <ul class="navbar-nav"> tag.
<body>
<!-- Some code omitted -->
<ul class="navbar-nav">
<!-- Example of home/admin called Home for Admin Only -->
<li class="nav-item pt-2" th:if="${#authorization.expression('hasRole(''ADMIN'')')}">
<a class="nav-link" th:href="@{/home/admin}">Home</a>
</li>
<!-- Example of home/manager called Home 1 for Manager Only -->
<li class="nav-item pt-2" th:if="${#authorization.expression('hasRole(''MANAGER'')')}">
<a class="nav-link" th:href="@{/home/manager}">Home 1</a>
</li>
</ul>
</body>