🏋️‍♂️ IronGate Gym Management System

A modern, full-stack gym management application designed with a unique, consumer-friendly membership model: Visit-Based Tracking. Instead of a membership expiring on a strict calendar date, days are only deducted from a user's account when they actually check into the gym.

This system features role-based access for both Gym Administrators and Gym Members, complete with real-time attendance tracking and a hardware-ready fingerprint scanner simulation.

✨ Key Features

🛡️ Admin Dashboard

• Live Attendance Tracking: See exactly who is in the gym right now and view daily activity logs.
• Member Management: Add new members, assign packages, generate 4-digit PINs, and simulate fingerprint registration.
• Dynamic Packages: Create, edit, and soft-delete membership packages (e.g., Premium, Standard, Basic). Core packages are protected from deletion to maintain database integrity.
• Status Monitoring: Automatically track which members are Active, Expiring (<= 5 days left), or Expired.

📱 Member Dashboard

• Usage Analytics: Visual progress bar showing total days, days attended, and days remaining.
• Digital Check-In/Out: Simulated biometric check-in system that automatically logs time and deducts a day from the membership on the first scan of the day.
• Attendance History: Filtered historical view of all gym sessions.
• Self-Service Renewal: Members can select a package, choose a duration (1 to 12 months), and renew expired memberships directly from their portal.

🛠️ Tech Stack

• Frontend: React.js (Vite), React Router DOM, Custom CSS (CSS Variables, Responsive Design)
• Backend: Python, Flask, Flask-CORS
• Database: MySQL (mysql-connector-python)

🚀 Installation & Setup

Prerequisites

Make sure you have the following installed on your machine:

• Node.js
• Python 3.x
• MySQL Server

1. Database Setup

1. Open your MySQL terminal or GUI (like MySQL Workbench).
2. Execute the provided schema.sql file to create the irongate_gym database and tables.
3. Ensure the is_active column is added to the packages table for soft-delete functionality.

2. Backend Setup (Python/Flask)

1. Open a terminal and navigate to the backend directory.
2. Create a virtual environment (optional but recommended):

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install the required dependencies:

pip install flask mysql-connector-python flask-cors

4. Open app.py and update the MySQL connection string with your local database credentials (username and password).

5. Start the server:

python app.py

3. Frontend Setup (React/Vite)

1. Open a new terminal and navigate to the Frontend directory.
2. Install the Node modules:

   npm install
   

3. Start the Vite development server:

   npm run dev
   

🔌 Hardware Integration (Future Scope)

Currently, the application simulates a fingerprint scanner via the web UI. To implement a physical biometric scanner:

1. Currently, the application simulates a fingerprint scanner via the web UI. To implement a physical biometric scanner:
2. Install the manufacturer's Python SDK.
3. Hook the SDK's match event to trigger an HTTP POST request to the /api/user/<user_id>/checkin endpoint.