Hotel Management System
The Hotel Management System is designed to streamline operations for both hotel employees and guests. It offers functionalities for customers to search available rooms, make reservations, check-in, check-out, and generate invoices. Employees can manage room availability, maintain customer profiles, oversee housekeeping schedules, and manage billing. The system uses Spring Boot to provide a set of RESTful APIs to support web and mobile interfaces.
Resources:
Customer Management
Register: Allows new users to register.
Login: Authenticates users and provides a JWT for secure access.
Profile Management: Enables users to view and update their profiles and change passwords.
Employee Management:
Admin Functions: Admins can manage hotel employees and staff.
Search Functionality
Reservations: Search for reservations by customer name, ID, and date.
Customer Info: Search for customer information.
Room Availability: Check room availability with details like price, facilities, capacity, size, and features.
Reservation Management
Booking: Allows customers to book rooms.
Modification and Cancellation: Customers can modify and request cancellations (admin approval required).
Room Management:
Room Types and Status: Admins can manage room types, availability, and status.
Check-In/Check-Out
Customer Management: Admins manage the arrival and departure processes.
Housekeeping Management:
Scheduling and Tracking: Manage housekeeping tasks and schedules.
Billing Functionality:
Invoice Management: Generate and manage invoices for customer reservations.
Class Diadram:
ER Diagram:
How to Build, Package, and Run the Application:
Prerequisites
Java SDK 17
Maven
Docker (for building Docker images)
Building the Application
- Clone the repository:
git clone https://github.com/saeedmosaffer/project2-hotel-management-system.git
cd hotel-management-system
- Build with Maven:
mvn clean install
- Run the Application:
java -jar target/project2-hotel-management-system-0.0.1-SNAPSHOT.jar
Docker Image: https://hub.docker.com/repository/docker/saeedmosaffer/project2hotel-management-system/general
Build Docker Image: docker build -t saeedmosaffer/project2-hotel-management-system
Run Docker Container: docker run -p 8080:8080 saeedmosaffer/project2-hotel-management-system
DockerHub Repository:
What I Learned:
Spring Boot: Understanding the fundamentals of Spring Boot for building RESTful APIs.
JWT Authentication: Implementing JWT for secure API access.
API Versioning: Utilizing different strategies for API versioning (URI, Request Parameter, Accept Header).
Database Management: Designing and implementing entity relationships using JPA.
Docker: Containerizing the application for consistent deployment.
Exception Handling and Validation: Ensuring robust API responses and input validation.
OAS 3.1.0: Documenting APIs using OpenAPI Specification for clarity and maintainability.
Role-Based Access Control: Differentiating access levels for admin and customer roles.
Contributor: Saeed Mosaffer - 1202254