Training floor
An exercise video library where every exercise carries its own instructional video — browsable by exercise, opened in a focused view and played right inside the product.
gym-management is a single web product that combines two things a gym needs in one place: gym training content with an instructional video included for every exercise, and gym management features covering the full set of standard gym management capabilities. Members use the product to find and watch the exercise videos they need for their workouts; gym managers and staff use it to run the gym's day-to-day administration — keeping members, schedules, and gym records organized in one place.
The product is delivered as a first-party React web application backed by a shared FastAPI service and a MariaDB database. Identity is application-owned: members and staff enroll themselves, verify on return, and reach protected training or management state only after verification. Training destinations are for members; management destinations are restricted to staff.
Membership renewal is handled inside the product: a payment reminder begins when a membership has 7 days remaining before its end date, and a renewal notification is delivered daily until the member renews. Members can also see their own gym attendance.
Membership purchase is handled inside the product through a payment module. Members choose a plan from four categories — 1 month, 3 month, 6 month, and 12 month — and purchase it without leaving the product. Gym management maintains the plan catalog: staff can change plan prices and run offers on plans at any time, and the member-facing plan list reflects the current price and any active offer.
Target users. Two active human roles: Gym Member, who trains with the exercise video library, checks their own attendance, and receives membership renewal reminders, and Gym Manager / Staff, who runs gym administration. Both are self-service users of the same product.
Success criteria.
gym-management is a two-audience web application delivered as:
Actors.
Accepted behavior. The product provides (a) gym training content with an exercise video included for every exercise, browsable and watchable by members, (b) gym management features covering the full set of standard gym management capabilities, operated by staff, (c) a payment reminder that starts when a membership has 7 days remaining before its end and a daily renewal notification repeated until the member renews, (d) a member view of the member's own gym attendance, and (e) a payment module through which members purchase a membership plan from the 1 month, 3 month, 6 month, and 12 month categories, with staff able to change plan prices and run offers. Self-service enrollment, returning verification, and staff-role authorization for management destinations are the minimum identity mechanics that make these journeys executable.
Ownership. All current behavior is first-party: the application owns identity, the exercise catalog and its videos, membership records and their end dates, renewal reminders and notifications, attendance records, the membership plan catalog with its prices and offers, plan purchase records, and all management records. No provider-owned or external surfaces are part of current scope.
Narrow exclusions. No third-party video hosting provider is specified; video references are stored and served by the application. No external calendar integration is specified. No third-party payment gateway, card processor, or external billing provider is specified: the payment module is an in-product plan purchase flow that records the purchase and the resulting membership period, and it does not integrate an external payment processor. The renewal reminder and its daily notification remain in-product reminders. No mobile native application is specified.
Removed from scope
The product is one coherent instrument with two faces. The member face is video-first: a landing entry, then an exercise library where every exercise carries its own instructional video, a focused exercise view for watching, a membership view carrying the renewal reminder and its daily notification, a plans view where the member purchases a 1, 3, 6, or 12 month plan through the payment module, and an attendance view of the member's own gym visits. The staff face is a command surface: a management hub that summarizes gym state and routes into member records, plan management (prices and offers), and the other standard management operations.
Access is application-owned and self-service. Anyone can reach the public landing page and the enrollment and login surfaces. Training destinations require a verified member session; management destinations require a verified staff session. A member cannot reach management destinations, and a staff member's management work is kept separate from member training browsing by role. A member sees only their own attendance and their own membership reminders; no member sees another member's attendance or membership state.
Renewal reminders are time-driven, not user-driven: the backend evaluates membership end dates and, from the moment a membership has 7 days remaining, surfaces a payment reminder and repeats a renewal notification every day until the membership is renewed. Renewal itself is recorded by staff in the management area; the reminder stops once the membership end date moves forward. A member may also renew by purchasing a plan through the payment module, which records the purchase and moves the membership end date forward.
Plan pricing is staff-controlled: the plan catalog always offers exactly the four categories (1 month, 3 month, 6 month, 12 month), and staff can change the price of any category and run an offer on a plan. Members always see the current price and any active offer when choosing a plan.
Everything described here is current. No future-horizon features are committed in this document.
FR-1 — Exercise video library. As a Gym Member I should browse a library of gym exercises in which every exercise includes its own instructional video, so that I can find the exercise I need and watch how to perform it. (explicit)
FR-2 — Watch an exercise video. As a Gym Member I should open a single exercise and play its instructional video, so that I can follow the movement correctly. (explicit)
FR-3 — Gym management capabilities. As a Gym Manager / Staff I should use gym management features covering the full set of standard gym management capabilities, so that routine gym administration is handled in one place. (explicit)
FR-4 — Member records. As a Gym Manager / Staff I should browse, create, and edit member records, so that the gym's member information stays current. (explicit, via standard management capabilities)
FR-5 — Self-service enrollment. As a Gym Member or Gym Manager / Staff I should enroll myself and choose my role, so that I can begin using the product without waiting for an administrator. (required_inference)
FR-6 — Returning verification. As a Gym Member or Gym Manager / Staff I should verify my identity on return, so that I can reach my own protected training or management state. (required_inference)
FR-7 — Staff authorization for management. As the application I should restrict management destinations to verified staff sessions, so that member training and gym administration remain correctly separated. (required_inference)
FR-8 — Payment reminder before membership end. As a Gym Member I should see a payment reminder starting when my membership has 7 days remaining before its end, so that I have time to renew before it lapses. (explicit)
FR-9 — Daily renewal notification until renewal. As a Gym Member I should receive a renewal notification every day from the start of the reminder until I renew my membership, so that I do not let the membership lapse. (explicit)
FR-10 — Member views own gym attendance. As a Gym Member I should see the attendance of the gym for myself, so that I can track my visits. (explicit)
FR-11 — Renewal recorded by staff. As a Gym Manager / Staff I should record a member's renewal by setting a new membership end date, so that the reminder and daily notification stop once the member has renewed. (required_inference)
FR-12 — Membership plan categories. As a Gym Member I should choose from exactly four membership plan categories — 1 month, 3 month, 6 month, and 12 month — so that I can pick the commitment that suits me. (explicit)
FR-13 — Purchase a membership plan. As a Gym Member I should purchase a membership plan through the payment module, so that I can renew or extend my membership easily without leaving the product. (explicit)
FR-14 — Staff change plan prices. As a Gym Manager / Staff I should change the price of any membership plan category, so that the gym's pricing stays current. (explicit)
FR-15 — Staff run offers on plans. As a Gym Manager / Staff I should run offers on membership plans, so that the gym can promote plans without changing the base price. (explicit)
Muse: Gleb Kuznetsov. Headline direction: "TRAIN / LIKE THE / MACHINE" — cinematic future tech for the training floor.
Mode: dark only.
Colour tokens (exact hex, by role):
#07080D#10131C#F2F5FA#22E3C4#FF3D7F#8A93A6#22E3C4 at low opacity; faint inner border-light at panel top edge.Ratio: ~70% dark ground, 20% glass surface, 7% mint, 3% magenta. Never blue-indigo on white.
Typography:
clamp(40px, 9vw, 96px); section head 28→48px; card title 18→22px; body 15→17px; micro-label 11→12px uppercase.Shape language: thin luminous 1px strokes; 20–28px radii on glass panels; circular gauge bezels; radial progress rings; soft volumetric glows behind key objects; pill or rounded-rect capsule buttons with a single mint glow on hover. No hard drop shadows — use light, not shadow, to lift layers.
Layout: full-bleed dark canvas; floating glass navigation rail pinned left on desktop, collapsing to a bottom dock on mobile; 8-pt grid with a visible 12-column overlay feel; generous negative space between luminous clusters.
Imagery: abstract 3D gym-equipment forms (chrome-and-mint dumbbell, kettlebell, barbell plate) as luminous volumetric objects with rim light and particle dust; exercise videos treated as hero media with a mint HUD overlay of reps, sets, muscle group, and tempo. No stock photography of smiling people; no flat clip art.
Accessibility: all readable text and controls stay whole inside the viewport and their container at 375px, 768px, and 1280px, wrapping or scaling to fit; imagery and decoration may bleed and overlap but never cover readable text or controls.
The public entry is a full-bleed #07080D viewport. A single crafted 3D dumbbell/plate form in chrome with mint rim-light floats slightly right of centre, slowly orbiting, casting a soft magenta glow on its underside; behind it a faint radial grid and drifting particle field. On the left, an oversized Space Grotesk headline stacked in three lines — TRAIN / LIKE THE / MACHINE — with an uppercase mint micro-label above it (GYM OS · TRAINING + MANAGEMENT) and a single pill CTA Enter the floor beneath, leading to Sign Up. A thin HUD strip along the bottom edge shows live tabular numerals in JetBrains Mono (members online, exercises, sessions today). No centred headline, no blue button, no gradient blob. The same luminous system carries into the exercise library (radial orbit grid with a large featured video tile) and the management hub (circular gauge bezels with needle-sweep motion).
Interaction Model: Animated Motion Tempo: cinematic Hero Dimensionality: webgl
Landing Hero Motion Brief
Landing Hero 3D Scene Brief — DIRECTION-DERIVED
A single real-time WebGL/R3F object — a chrome dumbbell or barbell plate — with mint rim-light, magenta underglow, a faint radial grid, and a drifting particle field. It shows the product's defining state: physical training energy rendered as a luminous instrument. The scene must degrade to a static composed frame under prefers-reduced-motion.
prefers-reduced-motion by freezing to a static composed frame with the same layout and readable content. (explicit, from creative direction)
GYM OS · TRAINING + MANAGEMENT
An exercise video library where every exercise has its own instructional video, and the gym management deck in one place — member records, schedules, memberships and renewal reminders.
gym-management joins the member's exercise video library and the staff's gym operations in one place — the same dark instrument, two sets of controls.
An exercise video library where every exercise carries its own instructional video — browsable by exercise, opened in a focused view and played right inside the product.
The gym's day-to-day administration in one legible control surface: member records, schedules, memberships and their renewal reminders — plus a member's own attendance.
Members browse the exercise catalog, see which muscle group each exercise works, and open any exercise to watch its instructional video. No exercise is listed without one. Members can also check their own gym attendance from the member view.
Staff keep member records, schedules, memberships and gym records organized in the management area. When a membership has 7 days remaining, a payment reminder begins and a renewal notification is delivered daily until staff record the renewal.
Staff keep the plan catalog current — four categories from 1, 3, 6 and 12 months with the gym's prices and any active offer. Members purchase a plan through the payment module and their membership end date moves forward.

GYM OS · TRAINING + MANAGEMENT
An exercise video library where every exercise has its own instructional video, and the gym management deck in one place — member records, schedules, memberships and renewal reminders.
gym-management joins the member's exercise video library and the staff's gym operations in one place — the same dark instrument, two sets of controls.
An exercise video library where every exercise carries its own instructional video — browsable by exercise, opened in a focused view and played right inside the product.
The gym's day-to-day administration in one legible control surface: member records, schedules, memberships and their renewal reminders — plus a member's own attendance.
Members browse the exercise catalog, see which muscle group each exercise works, and open any exercise to watch its instructional video. No exercise is listed without one. Members can also check their own gym attendance from the member view.
Staff keep member records, schedules, memberships and gym records organized in the management area. When a membership has 7 days remaining, a payment reminder begins and a renewal notification is delivered daily until staff record the renewal.
Staff keep the plan catalog current — four categories from 1, 3, 6 and 12 months with the gym's prices and any active offer. Members purchase a plan through the payment module and their membership end date moves forward.
No comments yet. Be the first!