Learn

Glossary (public-safe)

Status: first-draft Audience: public Last-reviewed: 2026-04-29 Sources: docs/Blueprint.md, marketing/brand-marketing.ts, marketing/sports-marketing.ts, marketing/lib/cook/system-prompt.ts

A short index of READYPLAY-specific terms. Use these names, not synonyms.

Product / sport vocabulary

Run — a single pickup outing. "Got a run at the park tonight." Sport-agnostic; works for hoops, pickleball, golf rounds, fishing trips. The narrative word for what got played.

Game — a structured session with rules, score, and a winner. Sometimes interchangeable with "run"; "game" implies the full structured session, "run" implies the act of playing.

Game session — internal name for the data record of a single game. Includes rosters, rules, score events, timer, and outcome.

Sport shell — the shared multi-sport spine: identity, Play Sites, calendar, rosters, reviews, leaderboards. Every supported sport rides this; sport-specific live depth ramps individually.

Play Sites — where games happen. Real parks, real courts, real lanes, real diamonds, real spots — anchored to a pin, not a vague thread. The sites screen title is literally "Play Sites."

MVP coming soon banner — the honest in-app surface (SportMVPComingSoonBanner) that shows on a sport when its primary live experience isn't fully wired yet. We don't pretend.

Live experience — a sport with full live scoring, Achievement Hall depth, Watch + Live Activity, CloudKit broadcast, and league standings on the same engine. Today: basketball only.

Identity / reputation

OVR — overall rating (2K-style). Composed from blended attributes (speed, awareness, inside shooting, three-point, defense, steals, blocks, screens, morale, team play). Earned through verified gameplay; not assignable.

Verified reputation — a player's profile, history, and grades attached to a single identity that travels across devices and (eventually) leagues. Built by peer review, not by an algorithm.

Portable profile — same identity used in pickup, league play, marketplace, and bowling-league seasons. One record, many surfaces.

Verified opponent — someone whose record is on the platform; head-to-head wins/losses against verified opponents are recorded with provenance.

Identity verification — the system that matches Apple ID, email, and phone signals to a player record (with the partial-U.S.-phone pattern protecting guest privacy at pickup).

Player attributes — speed, awareness, inside shooting, three-point, defense, steals, blocks, screens, morale, team play. Self-rated initially; blended attributes update through review and play history.

Fairness engine

Consensus gap — for a given game, a reviewer's grade for a player minus the team-average grade for that player. Accumulates into the reviewer's rolling fairness profile.

Outlier rate — how often a reviewer's grade lands ≥1.5 letter grades from the team consensus.

Reviewer weight — max(0.35, 1.0 - (avgConsensusGap × 0.18) - (outlierRate × 0.25)). Floor of 0.35 keeps every voice in the room.

Harshness index — how far below platform norms and team consensus a reviewer's average given grade sits.

Favoritism index — how much higher than consensus a reviewer rates a repeated friend across many games.

Fairness score — composite per-player number reflecting the player's history of fair, consensus-aligned reviewing behavior.

Reviewer reputation score — a player's score as a reviewer (composite signal including consensus alignment, outlier rate, and favoritism / harshness behavior).

Roles & marketplace

General Manager (GM) — a role that assembles a full squad — picks players and a coach, handles payment to each individual through in-app Apple Pay + escrow. Marketplace concept (roadmap).

Scorekeeper / scorekeeper sacred — the neutral party who keeps an honest book during a game. The platform deliberately gives this role recognition (in-app credits, future pay) because honest scorekeeping is the spine of the trust graph.

Credits — in-app points earned through roles like scorekeeping. StoreKit bundles on deck for purchase. Currency for paid play, marketplace fees, and trust-gated features.

Trust-gated RSVP — a confirmation flow that uses fairness / reputation signal to enforce no-show accountability when money is on the line.

League (B2B)

Commissioner — a league operator who registers their league on the platform, enrolls coaches, and approves rosters. The B2B onboarding lead.

League — a registered competitive series (bowling first; other sports follow). Aggregates per-player stats — high game, averages, strike rate (bowling), points/conduct (other) — into the same verified profile.

Standings — local league table for a registered league. Finished games count toward standings under documented rules.

Apple platform terms (in product context)

Sign in with Apple (SIWA) — primary identity. Works on iOS, watchOS, and the web. One account across surfaces.

Live Activity — Lock-Screen + Dynamic Island score strip for an in-progress game. ActivityKit-powered.

App Intents — system-level actions: Start Pickup Game, Open Current Scoreboard, Submit Quick Score. Surfaced through Siri and Shortcuts.

Apple Wallet pass — player card in Wallet (passkit-generator on the backend). Roadmap.

mdoc / Identity Document Services — iOS 26+ digital credential pathway. The RedEPlayMdocKit framework + RedEPlayIdentityDocumentProvider ExtensionKit extension handle web presentment and credential registration. Roadmap-aligned, not in V1 critical path.

HealthKit — used for HR zones in-game and post-game wellness context. Optional / opt-in.

CloudKit — direction for shared multi-device game state. Currently local/mock; full sync is roadmap.

Game mechanics

3v3 / 4v4 — the supported pickup formats in V1.

1s and 2s / 2s and 3s — the two scoring modes.

Take-back / clear-after-steal / win-by-2 — common pickup rules toggled per game.

Target score — the configured points target (commonly 11, 15, 21).

Shot spot picker — half-court tap-to-place that auto-detects zone (paint, mid-range, three) and assigns default points and shot style.

Shot styles — Layup, Dunk, Floater, Put-Back, Jumpshot, Fade-Away.

Foul switchboard — the foul button on every player tile. "Called by" attribution stored per foul; player tile turns fully red at 5 fouls (foul-out warning).

Merged history — the game-level history feed merging score events and foul events with swipe-to-delete and running snapshots.

Acronyms / quick refs

READYPLAY — the brand name; one word, all caps in body when emphasized.
Red-E Play — internal Xcode project name; legacy artifact, not a brand spelling.
OVR — overall rating.
GM — General Manager.
SIWA — Sign in with Apple.
mdoc — mobile document (ISO 18013), the digital credential standard.
TestFlight — Apple's beta-distribution channel.
VPS — virtual private server (where backend, admin, marketing, Postgres run).
SSE — Server-Sent Events (the live leaderboard transport).

← All Learn pagesLast updated 5/6/2026