Skip to content

Glossary

Domain terms used throughout the requirements. Cross-cuts: client identity & sharing, data model, use cases.

Term Definition
BYO "Bring Your Own (string)." A flag on each side (Main / Cross) of an Order. When set, the player supplied that string themselves and the corresponding string price is excluded from the order subtotal. In V1: ~48% of client orders are full-BYO; cross-only BYO is rare (0.9%); main-only is unobserved.
Cross (string) The set of strings running across the racket frame, perpendicular to the Mains. Often the same model and tension as the main; sometimes a different model (a "hybrid").
Dynamic Tension (DT) A measured value (typically by an external device like a Racket Tune app or ERT diagnostic) representing the racket's actual stringbed stiffness after stringing. In V1 captured in the self sheet, empty in client samples. In V2 it is an optional field on every Order.
Gauge The thickness of a string, expressed in mm (e.g. 1.25, 1.30) or in U.S. gauge numbers (e.g. 16, 17). Catalogue entries pin a (manufacturer, model, gauge) tuple.
Head size The area enclosed by the racket frame, expressed in square inches (e.g. 98 sq in). A property of the racket model.
Hybrid A stringing setup where the Main side and the Cross side use different strings. The 10–11% minority — see V1 baseline data findings.
Instance ID / Serial number An optional per-racket identifier (V1: PA98_2023_45, B98_V8_NS_43). Disambiguates two same-model rackets owned by the same player.
Labor The stringer's service fee on an Order, separate from the cost of strings themselves. Editable; defaults to the stringer's standard rate (Stefan's V1 norm: 25 CHF).
Lifecycle dates The four dates on an Order: Ordered → Strung → Returned → Paid. Required in causal order where present. On self-orders, typically only Strung is filled (locked decision 3).
Main (string) The set of strings running along the long axis of the racket (head to throat). Tensioned first during stringing. Default reference for the cross-side (89% of V1 orders match main on mfr/model/gauge).
Method The stringing pattern / technique used (e.g. "Standard," "Around-The-World"). Currently a free-text field; primarily used on self-orders. Optional on every order in V2 (locked decision 2).
Person (Re-shape, 2026-05-02.) The platform-level identity primitive. One Person row per real human, identified for matching by verified email only. Cross-stringer-visible insofar as sharing grants exist. See client identity & sharing.
ClientProfile (Re-shape, 2026-05-02.) A stringer-scoped record about a Person. One per (Person, Stringer) pair. Carries the stringer's private notes, locale, notification overrides for that client. The new name for what the older docs call "Player" in the per-stringer sense.
Player (Legacy term, partially superseded.) Originally: a person whose racket gets strung, stored per-stringer. In the 2026-05-02 re-shape, "Player" splits into Person (platform-level identity) + ClientProfile (stringer-scoped record). The is_stringer_self flag still exists on the stringer's self-ClientProfile.
Sharing rule (Re-shape, 2026-05-02.) One of the three explicit grant types for cross-stringer visibility of stringing-job data: Rule 1 (stringer-initiated, per-job, past only, redacted), Rule 2 (client-initiated, per-job, past only, full identity), Rule 3 (client global preference, past + future, full identity). All grants are read-only. See client identity & sharing.
Grant (Re-shape, 2026-05-02.) An instance of one of the three sharing rules. Per-job (Rules 1 & 2) or per-(client, stringer) pair (Rule 3). Revocable by either side, audit-logged.
Racket pattern / string pattern The grid layout of a racket: number of mains × number of crosses (e.g. 16x19, 18x20). A property of the racket model.
Self-order An Order where the Player's is_stringer_self is true. Stringer stringing for themselves. No client invoice; lifecycle dates typically blank except Strung.
Self-Player The single Player record per stringer with is_stringer_self = true. Each stringer has 0..1 of these — zero before they record their first self-job, exactly one after.
Share player (Legacy term — superseded 2026-05-02.) Originally: the explicit, manual action of pushing a read-only snapshot of one stringer's client (and history) to another stringer (M18). Now interpreted as Sharing Rule 1 — per-job, redacted, live (not snapshot), revocable, audit-logged grants. See client identity & sharing — Rule 1.
Shared catalogue The pool of String + Racket entries with visibility = catalogue-shared. Visible to all stringers. Entries get there only via the moderation queue.
Stringer A registered user of the platform who records orders. Admin-onboarded only. The "tenant" in the multi-tenant sense.
Tension The pull force used during stringing, in kg (V1 norm) or sometimes lb. Recorded per side. V1 finding: cross tension defaults to main, occasionally main − 1 kg.
Turnaround The elapsed time from Ordered to Strung. V2 reports the mean turnaround as a stringer-level metric (M16).