Back to Projects
REGISTRY / olympusfitness-lk-gym-saas
● ARCHIVED Lead Full-Stack Engineer & System ArchitectClient: Olympus Fitness Developed by iamkavinayan.com

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.

Olympus Fitness - Gym Saas showcase - Developed by Kavinayan
GATEKEEPER SCAN LATENCY
< 200ms
Sub-second QR check-in & debt validation
RENEWAL CONVERSION
+34%
Automated SMS expiry alerts & retention
UNIFIED POS & TREASURY
100%
Digital receipts & automated inventory deduction

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

Frontend Engine

Next.js 16 App Router + React 19

Server Components & Server Actions with Tailwind CSS v4 and Framer Motion micro-interactions.

Database & ORM

MySQL 8.0 + Drizzle ORM

Relational schema with cascade referential integrity, indexed sessions, and ACID transactions.

Infrastructure

Contabo VPS / Ubuntu 24.04 / PM2

Nginx reverse proxy, PM2 process management (Port 3013), automated SSL/TLS, and daily DB backup cron.

Security Protocols

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
Olympus Fitness - Gym Saas screenshot 1
Expand Fullscreen
Olympus Fitness - Gym Saas screenshot 2
Expand Fullscreen
Olympus Fitness - Gym Saas screenshot 3
Expand Fullscreen
Olympus Fitness - Gym Saas screenshot 4
Expand Fullscreen
Olympus Fitness - Gym Saas screenshot 5
Expand Fullscreen
Olympus Fitness - Gym Saas screenshot 6
Expand Fullscreen
Olympus Fitness - Gym Saas screenshot 7
Expand Fullscreen

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

Status
archived
Verified Views
212
Host Deployment
Ubuntu VPS / aaPanel

Technology Taxonomy

TypeScriptTailwind CSS v4Next.js 16React 19Framer MotionDrizzle ORMPM2NginxMySQL 8.0Ubuntu VPSLucide ReactOpenRouter AINotify.lk SMS GatewayRecharts
Engineering Attribution

Architected, engineered, and maintained by Kavinayan. Discover all digital systems at iamkavinayan.com.

Commission Similar System

Looking to architect an enterprise web platform or custom client software?

Initialize Contact Relay →