stkostas/Full_Stack_Gym_App

This is a course work for my 7th semester.

Gym Management System

Overview

This project is a web-based information system designed to manage users and bookings for a gym. It includes two subsystems: one for gym staff (administrators) and one for gym users (members).

Table of Contents

1. Introduction
2. System Description
   • Administrative Subsystem
   • User Subsystem
3. Implementation
   • Technologies
   • Database
   • Web Services
4. Installation Guide
5. Usage Guide
   • Admin Usage
   • User Usage
6. Gantt Chart
7. Sources
8. Contributors
9. License

Introduction

The goal of this project is to create a network-centric information system for managing users and bookings at a gym. It provides efficient and effective management of gym activities, ensuring a pleasant user experience for all interested parties.

System Description

The system consists of two main subsystems:

Administrative Subsystem

• User Registration Management: Approve or reject user registration requests.
• User Management: CRUD operations on user data including name, surname, country, city, address, email, username, and password.
• Gym Components Management: Manage gym trainers and available programs (e.g., pilates, crossfit, pool).
• Announcements/Offers Management: Post and manage announcements and offers visible to registered users.
• Program Schedule Management: Configure the schedule for each exercise including day, time, trainer, and available spots.

User Subsystem

• News/Announcements: View gym announcements and offers.
• Gym Services Navigation: Browse and book gym services and view booking history.
• User Registration: Register by filling out a form with basic personal details and wait for admin approval.

Implementation

Technologies

The system is developed using JavaScript with Node.js. The main components include:

• Express: Web application framework for Node.js.
• Express-Session: Middleware for session management.
• MongoDB Atlas: Cloud-based NoSQL database service.
• EJS: View engine for generating dynamic HTML pages.
• CSS: Used for styling and layout.

Database

The database is hosted on MongoDB Atlas and includes collections such as 'users', 'trainers', and 'programs'. The database can be accessed via the following link: MongoDB Atlas.

Web Services

• Login Service:

  • Endpoint: /login
  • Method: HTTP POST
  • Parameters: username, password

• Registration Service:

  • Endpoint: /signup
  • Method: HTTP POST
  • Parameters: username, password, email, fullname, etc.

• Dashboard Service:

  • Endpoint: /dashboard
  • Method: HTTP GET
  • Parameters: Uses session object to retrieve user information

• Admin Actions:

  • Endpoint: /admin-action
  • Method: HTTP POST
  • Parameters: userId, action

• User Deletion:

  • Endpoint: /admin-dashboard/delete-user
  • Method: HTTP POST
  • Parameters: userId

• Add Announcement:

  • Endpoint: /admin-dashboard/add-announcement
  • Method: HTTP POST
  • Parameters: announcement-text

• Reservation Management:

  • Endpoint: /make-reservation
  • Method: HTTP POST
  • Parameters: scheduleId, userId

• Logout Service:

  • Endpoint: /logout
  • Method: HTTP POST
  • Parameters: None

Installation Guide

System Requirements

• Operating System: Windows, Linux, or macOS
• Python: Download Python
• Node.js: Download Node.js

Steps

1. Navigate to the project directory:

   cd <project-directory>

2. Install the required dependencies:

   npm install

3. Run the application:

   node app.js

The application will be accessible at http://localhost:5500.

Usage Guide

Admin Usage

1. Login:
   • Navigate to http://localhost:5500.
   • Login with admin credentials:
     • Username: mixalis
     • Password: mixalis123
2. Manage Users:
   • Approve or reject registration requests.
   • Edit or delete user details.
3. Manage Announcements:
   • Post, edit, or delete announcements.
4. Manage Programs:
   • Configure the schedule for each exercise.
   • Edit or delete program details.

User Usage

1. Registration:
   • Navigate to http://localhost:5500.
   • Click on "Sign Up" and fill in the registration form.
   • Wait for admin approval.
2. Booking Services:
   • Once logged in, browse available services and schedule.
   • Book services and view your booking history.
3. Logout:
   • Click the logout button located at the top left of the webpage to log out.

Sources

1. Color Hunt
2. W3Schools
3. MongoDB Login
4. Mozilla Developer Network - HTML
5. Full Stack CRUD Operations | React, Node, Express & MongoDB
6. Full Stack Web Development for Beginners