Olympus Fitness - Gym Saas
Full-stack fitness ERP and member portal featuring automated QR gatekeeper access control, integrated inventory POS, debt tracking, and AI-assisted biometric coaching.

The Challenge & Objectives
Commercial gym operations were previously burdened by manual front-desk friction, paper ledgers, and revenue leakage caused by members accessing facilities despite expired memberships or uncollected dues. • Front-desk staff spent excessive time manually validating member cards and recording merchandise purchases during peak morning and evening rushes. • The primary objective was to engineer a unified, zero-friction operating platform that automates member check-ins, eliminates paper logs, enforces strict real-time payment reconciliation at entry points, and gives gym members a native-feeling mobile portal for tracking personal records (PRs), nutrition, and habit streaks.
Architecture & Engineering Decisions
Engineered as an end-to-end full-stack web application using the Next.js 16 App Router and React 19, backed by MySQL 8.0 through Drizzle ORM for type-safe, sub-millisecond database queries. • Dual-Portal Architecture & Cryptographic Session Security: Architected a split role-based ecosystem separating the staff "War Room" admin console from the mobile-first Member Experience. Authentication utilizes cryptographically secure tokens stored in HttpOnly cookies, backed by an in-database sessions table featuring automatic garbage collection of expired tokens and bcrypt hashing. • Automated Check-In Gatekeeper Engine: Developed a centralized validation pipeline (`validateCheckIn`) executed via Next.js Server Actions. When a member scans their unique QR badge, the system evaluates their membership expiration date against gym calendar closures and compares outstanding accounts receivable against a strict threshold limit. If access is denied, entrance is halted instantly and an automated SMS alert is dispatched via the Notify.lk gateway. • Point-of-Sale (POS) & Treasury Ledger: Built a real-time inventory and billing subsystem supporting multi-item checkouts, variant management, stock quantity decrementing, low-inventory alert thresholds, and printable thermal receipt generation. Every transaction simultaneously writes to the payments ledger, tracking paid balances and accounts due atomically. • Biometric Tracking & Zyra AI Engine: Built member habit tracking, PR leaderboard indexing, and weight progression telemetry. Integrated 'Zyra', a hybrid fitness engine combining a deterministic instant response core for biometric metrics with OpenRouter LLM capabilities for contextual workout and nutritional guidance.
System Architecture Blueprint
Next.js 16 App Router + React 19
Server Components & Server Actions with Tailwind CSS v4 and Framer Motion micro-interactions.
MySQL 8.0 + Drizzle ORM
Relational schema with cascade referential integrity, indexed sessions, and ACID transactions.
Contabo VPS / Ubuntu 24.04 / PM2
Nginx reverse proxy, PM2 process management (Port 3013), automated SSL/TLS, and daily DB backup cron.
HttpOnly Session Auth + Zod Validation
Bcrypt hash verification, automated session garbage collection, and strict server-side schema guards.
Production Interface Gallery
Click any photo to expand






Business Impact & Results
• 100% Elimination of Entry Revenue Leakage: Real-time debt and membership expiry verification completely stopped unauthorized gym floor access. • Sub-Second Peak Check-Ins: Replaced front-desk physical sign-in queues with instant QR scans, reducing reception bottleneck time from ~45 seconds per member to under 2 seconds. • Unified Financial Intelligence: Automated daily transaction reconciliations between membership plans and merchandise POS, saving management 10+ hours of manual bookkeeping each week. • Increased Member Retention: Dynamic streak tracking, PR leaderboards, and automated SMS renewal alerts significantly boosted on-time membership renewals.
System Telemetry
Technology Taxonomy
Architected, engineered, and maintained by Kavinayan. Discover all digital systems at iamkavinayan.com.
Looking to architect an enterprise web platform or custom client software?
Initialize Contact Relay →Explore Systems
Create Academy of English Language
Custom PHP/MySQL web platform and administrative CMS built for an IELTS institute to automate student inquiries, showcase verified band scores, and let staff manage courses and media without code.
Shalom POS — ERP & Retail Billing System
Enterprise POS and financial ledger engineered for digital printing and custom framing businesses, featuring dynamic square-footage pricing calculations, cash drawer session reconciliation, dual-direction cheque tracking, and hardware-accelerated 80mm thermal receipt generation.