Flex Forge - Your One-Stop Solution for Fitness and Wellness

Welcome to Flex Forge! This platform offers a range of fitness services, including customized workout plans, personal training, and nutrition guidance. Our goal is to make managing your fitness journey easy and accessible through a seamless, user-friendly interface.

Project Overview

Flex Forge is a web application designed to enhance the gym experience for both members and trainers. It allows gyms to showcase their services, helping potential members find the right fit and access key information. The platform simplifies gym membership management, workout planning, and nutrition guidance for a smooth fitness journey.

Purpose

1. Attract potential members by showcasing gym facilities and services.
2. Offer comprehensive features and workout plans to improve member experience.
3. Facilitate effective communication between members and trainers.

Goals

• Visibility: Increase the online presence of gyms to attract more members.
• Member Engagement: Provide valuable features that boost member satisfaction and retention.
• Streamlined Operations: Ensure efficient management of memberships and trainer assignments.

Static Version

Explore the static version of the Flexforge gym portal to get a preview of the user interface and features without backend functionality. This version highlights the design, structure, and layout of the platform, showcasing key sections such as the home page, membership plans, trainer profiles, and contact information.

Click here to view the static version

Video Demo

Watch the full walkthrough of the Flexforge gym portal in action! The video demo showcases key features such as member registration, trainer assignment, membership payment process, member progress tracking, and more. This demo provides a clear understanding of how to navigate the platform, highlighting the user experience for both gym members and trainers.

Medium Article

For a detailed overview of the development process and key insights from building the Flexforge gym portal, check out our in-depth article on Medium. The article covers the project’s architecture, technology stack, and design principles, offering valuable tips for developers interested in building similar platforms.

Read the full article on Medium

Project Structure

Here is an overview of the project structure with links to key files and directories:

static/

Contains static assets such as images used throughout the website.

• images/

  This folder holds images for various services, such as workout types, feedback emojis, and home page images, etc.

templates/

Contains the HTML templates for different pages of the web application.

• home.html

  The main landing page highlights key sections such as Contact, Blog, About, Trainer/Member, and Membership Plans, providing a seamless way to explore services and connect with the FlexForge community.

flaskCode.py

The main Python script is responsible for handling membership requests, trainer sessions, and the routing logic for managing trainers, members, and membership plans on the FlexForge gym portal.

Code Documentation.pdf

Documentation covering the routing and Flask backend implementation.

Database MySQL Queries.pdf

A PDF containing the MySQL queries used to set up and manage the database for members, trainers, progress reports, and membership plans.

Libraries and Modules.pdf

A PDF containing detailed descriptions and the purpose of libraries and modules used during the course of the project.

requirements.txt

A list of the Python dependencies needed to run the project locally.

LICENSE

The license under which this project is released.

README.md

The current project documentation.

Forms & Routing

1. Member Registration Form

The Member Registration Form collects essential details from gym members for registration. The form includes:

• Full Name
• Email (must be unique)
• Password
• Confirm Password
  This information is stored securely in the user table of the MySQL database.

Backend Logic:

1. Password Hashing: User passwords are hashed using the sha256 method before being stored.
2. Email Uniqueness: Duplicate email addresses are checked to ensure uniqueness.
3. Data Insertion: After validation, user details are saved in the database.

Trainer Assignment:

• The trainer_id in the user table is allocated after the user takes a membership plan and is assigned a personal trainer based on their membership tier.

User Flow:

1. User fills out the form with required details.
2. Password is hashed, and email uniqueness is validated.
3. User data is stored in the user table, and they are redirected to the login page.
4. The trainer_id will be assigned once the user completes membership registration.

---

2. Membership Payment Form

The Membership Payment Form is used to complete the purchase of a membership plan. It includes the following details:

• UPI ID
• Email (must match the registered email)
  The Training Type and Tier are pre-selected on the previous page. Payment information is stored securely in the payments table.

Database Table: payments

• id: Auto-incremented unique identifier for each payment.
• training_type: The type of training the member selected.
• tier: Membership tier (Basic, Advanced, Premium).
• amount: The amount paid for the membership.
• upi_id: The UPI ID used for the transaction.
• email: User's email for payment verification.
• payment_date: Timestamp of the payment.
• validation: Status of the payment (default is 'no').

Backend Logic:

1. Payment Information: The form submits the UPI ID and email, while the training type and tier are pre-selected.
2. Data Insertion: After payment, this information is stored in the payments table.
3. Validation: The validation column is set to 'no' by default. The admin reviews the payment and updates the validation to 'yes' upon approval.

User Flow:

1. User selects a membership plan and training type on the previous page.
2. User fills out the UPI ID and email and clicks the "Pay Now" button.
3. After payment, the user is directed to a Thank You page.
4. The admin reviews the payment details, updates the validation to 'yes', allowing the member to access the member dashboard.

---

3. Member Login Page

The Member Login Page allows gym members to securely log in to their accounts. It collects:

• Email
• Password

Login Process:

1. Email and Password Verification: The system checks if the email exists in the user table. The entered password is hashed and compared with the stored hashed password.
2. Trainer ID Check:
   • If trainer_id is null, the system checks the payments table to verify if the member has paid for their membership.
   • If validation is set to 'yes', a personal trainer is assigned.
   • If validation is not 'yes', the member is redirected to the Membership Plans page.
3. Subsequent Logins: If a trainer is already assigned, the member can log in without reassignment.

User Flow:

1. Member enters email and password and submits the form.
2. The system verifies credentials and checks for trainer assignment and payment status.
3. If valid, the member is logged in and a trainer is assigned.
4. If payment validation is not confirmed, the member is redirected to the Membership Plans page.

---

4. Trainer Registration Page

The Trainer Registration Page allows trainers to register and provide details for inclusion in the gym's trainer database. It collects:

• Full Name
• Email
• Password
• Confirm Password
• Expertise (Select from predefined options)
• Certifications

User Flow:

1. Trainer fills out the registration form.
2. The system validates the inputs and checks for duplicate emails.
3. If validated, the trainer's information is securely stored.
4. After registration, the trainer is redirected to the Trainer Login Page.

---

5. Trainer Login Page

The Trainer Login Page allows registered trainers to access their accounts by providing:

• Email
• Password

Login Process:

1. Trainers enter their email and password.
2. The system verifies the credentials against the trainers table.
3. Upon successful login, trainers are directed to their dashboard.
4. If the credentials are invalid, trainers are redirected to the Trainer Registration Page.

---

6. Member Progress Tracking Page

The Member Progress Tracking Page allows members to self-report their progress by providing:

• Date
• Workout Details
• Any Issues

Data Storage:

Information is stored in the progress_tracking table with the following fields:

• id (int, AI, PK)
• user_id (int)
• trainer_id (int)
• progress_date (date)
• workout_details (text)
• issues (text)
• created_at (timestamp)

Submission Process:

1. Members fill out the form with progress details.
2. Upon successful submission, they are redirected to the Member Dashboard Page.

Trainer Access:

Trainers can log in to view member progress via the progress_tracking table.

---

7. Feedback Form

The Feedback Form allows members to provide their feedback, which includes:

• Rating (1 to 5, represented through images)
• Category (Options: Suggestion, Issue, Compliment)
• Feedback Text

Data Storage:

Submitted feedback is stored in the feedback table with the following fields:

• id (int, AI, PK)
• user_id (int)
• rating (tinyint)
• category (varchar)
• feedback (text)
• created_at (timestamp)

Submission Process:

1. Members complete the feedback form.
2. The feedback is saved to the database for review.

Utilizing Feedback:

• Feedback is analyzed to calculate the average rating.
• This helps identify areas for improvement and boosts member satisfaction.

Installation

To run this project locally, follow these steps:

1. Clone the Repository:

   git clone https://github.com/yourusername/Flexforge-RealTime-Project.git

2. Navigate to the Project Directory:

   cd Flexforge

3. Install the Required Dependencies:

   pip install -r requirements.txt

4. Run the Python Backend:

   python flaskCode.py

5. Open Your Browser:

   • Go to http://localhost:5000 to view the application.

Technologies Used

• Frontend: HTML5, CSS3, JavaScript, Tailwind CSS for responsive and modern design.
• Backend: Python, Flask for routing and form handling.
• Database: Managed using MySQL queries, detailed in Flexforge Project Database MySQL Queries.pdf.
• Deployment: The project is hosted on GitHub for static files.

Code Documentation

1. Overview: For an in-depth understanding of the gym portal's code structure, refer to the accompanying code documentation PDF.
2. Module Explanations: This document provides detailed explanations of key modules, functions, and classes, outlining their specific purposes.
3. API Details: Includes information on public APIs with usage instructions, parameters, and return values.
4. Comments and Best Practices: The code is organized with clear comments and follows best practices for maintainability and ease of navigation.
5. Access: You can access the full documentation in the Code Documentation.pdf.

Documentation Validation

To ensure quality, accuracy, and reliability, we have implemented the following validation methods:

1. Peer Review:

   • Multiple team members reviewed the documentation, providing feedback on clarity and adherence to best practices. All feedback has been incorporated to enhance usability.

2. User Testing:

   • We tested the documentation with users unfamiliar with the gym portal, who followed it step-by-step to install and navigate the system. Their feedback helped improve clarity and ease of use.

3. Functional Testing:

   • Every step in the documentation has been validated through actual implementation. This includes:
     • Setting Up the Environment: Detailed guidance on configuring the development environment.
     • Installing Required Dependencies: Clear instructions for installing all libraries and packages.
     • Running the Project Locally: Step-by-step instructions to launch the gym portal on a local server, including troubleshooting tips.
     • Testing Forms and Routing: Comprehensive testing of all forms and routing functionalities to ensure they operate as expected.

These validation methods ensure the documentation is accurate and user-friendly.

License

This project is licensed under the MIT License. See the License file for details.

Contact

For further information or queries, please reach out via email at peralapranitha17@gmail.com.
Feel free to connect with me on LinkedIn - LinkedIn.