Skip to main content

Setups

A Setup is the mechanical configuration of a car for a given moment in the event — springs, dampers, ride height, anti-roll bars, alignment, aero, brake bias, etc.

Find the view at Event → Setups. Route: /events/:eventId/setups.

How it's modelled​

A Setup row stores:

  • The standard provenance metadata (createdAt, createdBy, name, parentSetupId for derivations)
  • A parameters JSONB driven by the Setup Definition

The Baseline GT3 seeded Definition has 14 parameters plus a WeightDistribution math parameter as a worked example.

Where setups appear​

  • The Setups screen itself — full CRUD list (column profile-aware via Custom Columns Editor)
  • The Run Sheet Setup tab — read-only view of the setup attached to the active run, with a CID/Form toggle
  • The Setup Comparison screen — side-by-side diff of any two setups
  • The (forthcoming) Setup Assembly Tree — HH-DM has it; ours is roadmap

Setup Comparison​

The Setup Comparison screen lives at /events/:eventId/setups/compare and is mounted from the Setups screen. Pick two setups (A vs B), pick an optional Change Formatter, and see a side-by-side Parameter | A | B diff with diff highlighting and group headings driven by the formatter's groupedParameters spec. A Set as Reference action on each setup swaps it into the A slot, mirroring HH-DM's "Reference Mode — Selected setup".

See Setup Comparison for the full reference.

Change Formatters​

A Change Formatter is a reusable grouping spec for setup parameters — the rules that decide how the diff is laid out. Author formatters under Admin → Change Formatters (/admin/change-formatters); the same formatter is consumed by the Run Sheet's Setup Change tab and the Setup Comparison screen.

What you can do today​

  • Create / patch / delete setups via the screen and /setups
  • Author a Setup Definition under Admin → Definitions and see the new parameters appear immediately in the form
  • Compare any two setups via the Comparison screen (with optional Change Formatter for grouping)
  • Reference setup parameters from math expressions

What's coming​

  • Setup Assembly Tree — visualise the part-and-assembly composition of a setup (depends on Parts/Assemblies, which is a Phase 4 work item)
  • Setup history per car — a timeline of changes across the event
  • Copy setup across cars / events with parameter mapping