Ubiquitous Language & Terminology

In fitness operations, business terms must carry identical, unambiguous meanings for club managers, front desk staff, personal trainers, group instructors, membership consultants, and software systems. This glossary formalizes the ubiquitous language governing the Fitness (GYM) bounded context.

---

1. Comprehensive Terminology Glossary

Term	Category	Business Definition
Member	Membership & Subscription	An individual holding a current or historical membership agreement with the club, identified by a unique member identifier and entitled to services according to their plan.
Prospective Member (Lead)	Membership & Subscription	An individual who has expressed interest in joining but has not yet activated a membership agreement; owned by CRM and referenced during onboarding.
Membership Plan	Membership & Subscription	A sellable commercial product defining price, billing frequency, commitment period, access tier, freeze quota, and advance booking window (e.g., “Premium All-Access Annual”).
Membership Tier	Membership & Subscription	The entitlement level embedded in a plan that determines which zones, class categories, and time periods a member may access (e.g., Standard, Premium, Off-Peak).
Membership Agreement (Subscription)	Membership & Subscription	The formal, state-driven contract binding one member to one plan for a defined period, governing billing cycles, freezes, renewals, and cancellation.
Billing Cycle Anchor	Membership & Subscription	The fixed calendar day on which each recurring billing period starts (e.g., the 1st of each month), established at activation and preserved across renewals.
Joining Fee (Enrollment Fee)	Membership & Subscription	A one-time charge collected at membership activation covering onboarding, access credential issuance, and administrative setup.
Commitment Period	Membership & Subscription	The minimum contractual duration during which a member cannot cancel without penalty (e.g., 12 months on an annual plan).
Auto-Renewal	Membership & Subscription	The contractual mechanism by which an agreement automatically extends into a new billing period at expiry unless the member cancels within the notice window.
Renewal	Membership & Subscription	The successful extension of an agreement into a new billing period, confirmed by a settled payment.
Freeze (Suspension)	Membership & Subscription	A member-initiated, time-bounded suspension of an active membership that blocks access, pauses value consumption, and extends the expiry date day-for-day.
Freeze Quota	Membership & Subscription	The maximum number of freeze days a plan permits per contract year (e.g., 30 days), enforced at freeze request time.
Payment Suspension	Membership & Subscription	An involuntary suspension state entered when a recurring payment fails, blocking access until the outstanding balance is cured.
Cancellation Notice Period	Membership & Subscription	The contractual advance warning required before voluntary cancellation takes effect (e.g., 30 days), during which the membership remains active and billable.
Proration	Membership & Subscription	The proportional calculation of charges or credits when a plan changes or an agreement ends mid-cycle.
Day Pass	Access & Attendance	A single-day access right sold or granted to a non-member, valid for one calendar date and a defined set of zones.
Guest Pass	Access & Attendance	An access right granted to a visitor accompanying a member, limited by plan-specific guest quotas per period.
Check-in	Access & Attendance	The recorded event of a credential presentation evaluated at an access point, resulting in a granted or denied entry decision.
Check-out	Access & Attendance	The recorded exit event closing a visit, used for occupancy metrics and visit duration analysis.
Access Point	Access & Attendance	A physical entry or exit device (turnstile, gate, or desk terminal) where credentials are presented and decisions are enforced.
Access Credential	Access & Attendance	The member-bound token presented at an access point: a QR code, RFID/NFC card, or biometric template reference.
Access Decision	Access & Attendance	The deterministic outcome of evaluating a credential presentation: Granted or Denied with an explicit reason code.
Denial Reason	Access & Attendance	The machine-readable and display-friendly explanation attached to a denied access decision (e.g., MembershipExpired, MembershipFrozen, ZoneNotEntitled).
Access Zone	Facility & Topology	A controlled physical area within a club (gym floor, studio, pool, recovery zone) with its own entitlement requirements.
Peak / Off-Peak Hours	Facility & Topology	Published time windows during which access demand is highest; off-peak plans are denied entry during peak windows.
Attendance Ledger	Access & Attendance	The append-only, immutable record of all check-in and check-out events used for occupancy, safety manifests, and billing verification.
Group Fitness Class	Classes & Booking	A coached, capacity-bound group training format (e.g., cycling, yoga, HIIT) delivered in a studio at scheduled times.
Class Template	Classes & Booking	The reusable definition of a class format: category, duration, difficulty level, default capacity, and required equipment.
Scheduled Class Session	Classes & Booking	A concrete, dated occurrence of a class template bound to a studio, an instructor, and a start time, open for booking.
Capacity	Classes & Booking	The maximum number of confirmed attendees a session may hold, derived from studio equipment count and safety limits.
Booking	Classes & Booking	A member’s reservation of one seat in a scheduled class session, subject to booking window and capacity rules.
Confirmed Booking	Classes & Booking	A booking holding a guaranteed seat in the session, counted against capacity.
Waitlist Entry	Classes & Booking	An ordered placeholder recording unmet demand for a full session, positioned by request arrival time.
Promotion Offer	Classes & Booking	A time-boxed invitation extended to the first waitlist entry when a seat becomes available; expires if not accepted.
Advance Booking Window	Classes & Booking	The maximum time before session start at which a member may book, varying by membership tier (e.g., 7 days for Premium, 3 days for Standard).
Cancellation Cutoff	Classes & Booking	The deadline before session start separating free early cancellation from penalized late cancellation (e.g., 4 hours).
Early Cancellation	Classes & Booking	A booking cancelled before the cancellation cutoff, releasing the seat without penalty.
Late Cancellation	Classes & Booking	A booking cancelled after the cancellation cutoff but before session start, releasing the seat and accruing one strike.
No-Show	Classes & Booking	A confirmed booking whose member neither attended nor cancelled before session start, wasting the seat and accruing one strike.
Strike	Classes & Booking	A penalty point recorded against a member for a late cancellation or no-show, expiring after a rolling policy window.
Booking Privilege Suspension	Classes & Booking	The temporary loss of class booking rights triggered when strikes cross the policy threshold within the rolling window.
Instructor	Classes & Booking	The certified staff member delivering a group class session, assigned per session and substitutable under club control.
Personal Trainer	Personal Training	A certified professional delivering one-to-one coaching sessions, with published availability windows and specialty tags.
PT Session	Personal Training	A scheduled one-to-one appointment between a member and a personal trainer, consuming one session credit upon confirmation.
PT Credit Package	Personal Training	A pre-paid bundle of personal training session credits (e.g., 10 sessions) with a defined purchase price and validity period.
Session Credit	Personal Training	The unit of entitlement for one PT session; consumed at confirmation, restored on early cancellation, forfeited on late cancellation or no-show.
Credit Expiry	Personal Training	The date after which unused session credits in a package lapse, defined by the package validity period.
Induction Session	Personal Training	A mandatory or optional onboarding appointment covering equipment orientation, safety rules, and goal assessment for new members.
Workout Program	Engagement & Progress	A structured multi-week training plan composed of exercises, sets, and progression rules, assigned to a member.
Program Assignment	Engagement & Progress	The binding of a workout program to a member with a start date, target duration, and optional supervising trainer.
Progress Record	Engagement & Progress	A dated measurement capturing member advancement: completed sessions, lifted loads, attendance streaks, or body composition metrics.
Body Composition Assessment	Engagement & Progress	A periodic measurement of weight, body fat percentage, and circumferences used to track transformation goals.
Attendance Streak	Engagement & Progress	The count of consecutive weeks meeting a member’s visit frequency target, used for retention and gamification.

---

2. Conceptual Distinctions

Membership Plan vs. Membership Agreement vs. Access Credential

Dimension	Membership Plan	Membership Agreement	Access Credential
Definition	The commercial product template offered for sale.	The live contract binding one member to one plan over time.	The physical or digital token presented at the door.
Cardinality	One plan serves many members.	Exactly one active agreement per member at any moment.	One or more credentials per member (QR, card, biometric).
Mutability	Editable by management; changes never rewrite existing agreements.	State-driven lifecycle; terms snapshotted at activation.	Issued, revoked, and replaced without touching contract state.
Owns	Price, tier, freeze quota, booking window, commitment period.	Status, billing anchor, freeze periods, renewal and cancellation dates.	Token value, issuance date, revocation status.

---

Early Cancellation vs. Late Cancellation vs. No-Show

flowchart LR
    subgraph Timeline["Session Timeline (e.g., Cycling 18:00)"]
        Book["Booking Confirmed<br/>T-3 days"] --> Cutoff["Cancellation Cutoff<br/>T-4 hours"]
        Cutoff --> Start["Session Start<br/>18:00"]
        Start --> End["Session End<br/>18:45"]
    end

    Book -.->|Cancel before cutoff| Early["Early Cancellation<br/>Seat released, zero penalty"]
    Cutoff -.->|Cancel after cutoff| Late["Late Cancellation<br/>Seat released, one strike"]
    Start -.->|Neither attend nor cancel| NoShow["No-Show<br/>Seat wasted, one strike"]

Dimension	Early Cancellation	Late Cancellation	No-Show
Timing	Before the cancellation cutoff.	After the cutoff, before session start.	Session started; member absent.
Seat Outcome	Released in time for waitlist promotion.	Released late; promotion attempted if time allows.	Wasted; no recovery possible.
Penalty	None.	One strike.	One strike.
Waitlist Impact	Full promotion cycle executes.	Shortened promotion cycle with reduced offer window.	None.

---

Freeze vs. Payment Suspension vs. Cancellation

Dimension	Freeze (Voluntary)	Payment Suspension (Involuntary)	Cancellation (Terminal)
Initiated By	Member request.	Billing failure signal.	Member notice or club termination.
Access	Blocked for the freeze window.	Blocked until balance cured.	Blocked permanently from effective date.
Expiry Date	Extended day-for-day by freeze duration.	Unchanged; time continues to elapse.	Ends at the effective cancellation date.
Billing	Paused or reduced per plan terms.	Dunning retries continue.	Final settlement and proration.
Reversibility	Scheduled end or early resume.	Automatic cure on successful payment.	Irreversible; rejoining requires a new agreement.