TurnoGym - Python Script

TurnoGYM is a complete, production-ready PWA booking system designed for gyms, CrossFit boxes, boutique studios, and personal trainers. Built with a robust backend in Python, PostgreSQL, and containerized with Docker, it is optimized to run smoothly under high-concurrency peak booking hours.

This script eliminates manual WhatsApp and spreadsheet management, offering an automated self-service experience for members and full oversight for administrators.

🔥 Key Features

📱 Member PWA (Progressive Web App)

• Instant Access: Works directly in any mobile browser with an "Add to Home Screen" option (no App Store or Google Play downloads required).
• Quick Booking: Members reserve classes in just 2 clicks.
• Automated Notifications: Integrated Web Push and Email confirmations and alerts.
• Real-Time Schedule: Live view of available spots, instructor details, and session times.

🛠️ Admin Dashboard

• Capacity & Aforo Control: Strict automated limit per class to avoid overbooking.
• Live Attendance List: Real-time overview of bookings and cancellations.
• Member Management: Search, filter, and manage member profiles.
• Schedule Management: Easy setup of recurring classes, time slots, and coaches.

⚡ Production & Technical Highlights

• High Concurrency: Tested and optimized to handle 50+ simultaneous connections during peak opening minutes.
• Proven in Production: Currently running in a live gym with 180+ active members and 110+ daily bookings.
• One-Command Deployment: Ships with a docker-compose.yml file for instant setup on any Linux VPS.
• Clean Stack: Python backend, HTML5/CSS3 frontend, and PostgreSQL database.

📦 What’s Included in the Download?

• Full, unencrypted Source Code (Python, HTML, CSS, JavaScript).
• docker-compose.yml & Dockerfile configurations.
• .env.example file with all necessary configuration variables.
• Initial database schema and seeds.
• Comprehensive README.md deployment and setup guide.

⚙️ Server Requirements

• Linux VPS (Ubuntu 20.04/22.04 recommended) with at least 1 GB RAM.
• Docker & Docker Compose installed.
• Domain or subdomain with SSL (Nginx / Caddy recommended as reverse proxy).
• SMTP credentials (for transactional emails) & VAPID keys (for Web Push).

Features

• Progressive Web App (PWA): Fast mobile experience with "Add to Home Screen" support (no app store downloads needed).
• Self-Service Booking: 2-click class reservations and cancellations for members.
• Automated Notifications: Integrated Web Push notifications and transactional email confirmations.
• Real-Time Capacity Control: Automated limits per session to completely eliminate overbooking.
• Comprehensive Admin Panel: Full control over daily schedules, active members, instructor assignment, and attendance lists.
• Live Attendance Tracking: Real-time overview of bookings, open spots, and member check-ins.
• High-Concurrency Ready: Stress-tested and architected to support 50+ simultaneous connections during peak reservation drops.
• Production-Tested: Real-world track record handling 180+ active members and 110+ bookings per day.
• Turnkey Docker Deployment: Pre-configured docker-compose.yml file to spin up the app and PostgreSQL database with one command.
• Clean & Maintainable Stack: Python backend paired with pure HTML5/CSS3 and PostgreSQL (no bloated node build steps).
• White-Label Ready: Easily customize branding, gym naming, and styling via configuration and template files.

Requirements

• Operating System: Linux VPS (Ubuntu 20.04 / 22.04 LTS or Debian 11+ recommended).
• Server Resources: Minimum 1 vCPU and 1 GB RAM (2 GB RAM recommended for optimal peak performance).
• Docker Engine: Docker 20.10+ and Docker Compose v2+ installed on the host machine.
• Reverse Proxy & SSL: Nginx, Caddy, or Traefik with an active SSL certificate (HTTPS is strictly required for PWA installation and Web Push notifications).
• Email Service (SMTP): Any transactional email provider credentials (e.g., SendGrid, Mailgun, Amazon SES, Brevo, or custom SMTP) for reservation alerts.
• Web Push Keys: VAPID key pair (public and private keys, generated via standard web-push tools) for browser push alerts.
• Domain Name: A configured domain or subdomain pointing to your server's public IP address.