Comp OS Add-On Management
Comp OS (Competition Operating System) is a paid add-on that can be enabled for any gym on a Lite or Core subscription tier. It is managed from Gyms → [Gym Name] → Billing & Subscription → Comp OS Add-On card.
Pricing Models
| Type | Price | Billing | Contract Term |
|---|---|---|---|
| Monthly (Unlimited) | £50/month | Recurring, added as a line item on the gym's existing Stripe subscription | 12-month rolling contract |
| Single Event | £300 one-time | One-off Stripe invoice, auto-finalised | Per-event, no recurring commitment |
Pricing is managed in Platform → Pricing Schedules → Competition (Comp OS) Pricing, which is versioned and effective-dated. Both the monthly add-on price and the single-event price live in platform_comp_os_pricing_versions.
Enabling Comp OS for a Gym
- Navigate to Gyms → [Gym Name] → Billing & Subscription
- Locate the Comp OS Add-On card and toggle the switch to ON
- A dialog appears — select the subscription type (Monthly or Single Event)
- Enter the gym admin's email address (pre-filled from the gym's admin record)
- Click Enable & Send Contract
This triggers three actions:
- The
comp_osfeature flag is enabled for the gym - A subscription record is created with status pending_contract
- A secure 7-day signing link is emailed to the gym admin
Contract Signing Flow
The gym admin receives an email with a branded signing link. This public page:
- Validates the token (checks expiry and usage)
- Displays a Review step with subscription details (gym name, type, pricing)
- Shows the BLIPLY PLATFORM - COMP OS SUBSCRIPTION AGREEMENT contract with variable injection (gym name, date, subscription type, pricing)
- Requires the gym admin to initial all marked sections and provide a signature
- On completion, creates a contract acceptance record, triggers PDF generation, and activates the subscription
Billing Integration
Comp OS billing is integrated as an additional line item on the gym's existing Stripe subscription. This means:
- Failed payments on the gym's subscription trigger the existing platform-level "Payment Failed Notice" automation — no separate handling needed
- Subscription cancellation via Stripe automatically cancels the Comp OS add-on
- If no existing subscription exists, a standalone Stripe subscription is created for Comp OS
Contract & Subscription Status
The Comp OS card in the Billing tab displays:
| Field | Description |
|---|---|
| Subscription Type | Monthly (12-month term) or Single Event |
| Contract Status | Pending Contract, Active, Cancelled, or Expired |
| Contract Dates | Start → End dates (set upon signing; monthly = 12 months from signing) |
| Signed Contract PDF | View link available once the PDF has been generated |
Resending the Contract
If the gym admin hasn't signed yet (status: Pending Contract), click Resend Contract to generate a new 7-day token and email it. The previous token is not invalidated but will expire naturally.
Auto-Renewal
Monthly Comp OS contracts auto-renew for another 12 months when the contract end date is reached. This is handled by the daily billing sync job. A platform activity log entry is created on each renewal.
Feature Gating
Access to the Comp OS module is controlled by the comp_os feature flag. When enabled, the gym sees the full Competition OS workspace in their sidebar. When disabled or cancelled, the menu item and all Comp OS routes are hidden.