Hotel Reservation and Guest Services Management System (HRGSMS) System

Description

SkyNest Hotels is a regional hotel chain in Sri Lanka, offering premium accommodation and services across its branches in Colombo, Kandy, and Galle. To address operational inefficiencies caused by an outdated desktop-based system including overbookings, billing delays, and manual errors the management has initiated the development of a unified Hotel Reservation and Guest Services Management System (HRGSMS). This modern solution aims to streamline bookings, automate service tracking, and enhance the overall guest experience through a centralized, scalable platform.

Project Structure

-FRONTEND

• guest: Frontend interface for hotel guests to search and book rooms,request services, view bills and many more functions .
• frontdeskoffice-end: Portal for front desk staff to manage check-ins, check-outs, guest bookings and handle payments.
• serviceoffice-end: Interface for managing guest service requests, updates, and service billing.
• admin-end: Admin dashboard for managing users, roles, and system configurations for app-wide tax and discounts.
• management-end: Management dashboard for generating reports, monitoring performance, and viewing analytics.

-BACKEND: Node.js/Express-based server handling APIs, jwt authentication, and database interactions.

-DATABASE-FILES: SQL files for creating schemas, inserting initial data, and defining functions, triggers, views, procedures, and indexes.

Built With

Installation

Before running the project, ensure all required dependencies are installed in the appropriate directories.

Steps to Install:

1. Install Root Dependencies:

   npm install

2. Install Frontend Dependencies: Navigate to the frontend directory and install dependencies:

   cd frontend
   npm install
   cd ..

3. Install Backend Dependencies: Navigate to the backend directory and install dependencies:

   cd backend
   npm install
   cd ..

4. Set up .env environment:
   Navigate to the backend/ directory and create an .env like .env.example and insert your database credentials as well as jwt secret there.

Running the Application

Frontend

To start the React frontend server for Guest End on localhost:5173, use the following command from the root directory:

cd frontend
npm run dev

Backend

To start the backend server on localhost:5000, use the following command from the root directory:

cd backend
npm run dev

All

To start the all servers concurrently at once, use the following command from the root directory:

npm start

Contributors

• Dinura Ginige
• Sanjuna Rathnamalala
• Pamoth Kumarasinghe
• Yohan Jayasinghe
• Thilakshan Balakrishnan