docs(guide): team race, race overview, archive, practice ranking, speaker panel, sponsor flow and simulator (1.69.1)
This commit is contained in:
1 parent
eb4c472ef9
commit
2e3676d0cd
8 files changed
+112
-51
No files matched your search
@@ -112,6 +112,8 @@ The menu follows how a race day works: **Start** (Dashboard, Race Day), **Create
|
||||
- **📺 Drivers' board** (`/public-overlay/schedule`, also under Overlay) shows what is on track, the next three heats with their drivers, then the rest of the day. A heat that has been called is highlighted "Called – get ready". It works on a phone or a TV in the pits.
|
||||
- **Calling a heat:** when a heat is 10 minutes away (set under **Call**), Race Day asks the race controller: **📢 Call now** reads the heat and its drivers over the speakers and highlights it on the drivers' board; **Later** asks again in 2 minutes. With the autopilot on, heats are called on their own.
|
||||
- **▶ Run the day automatically** starts each heat's count-down on its own when the schedule says so, and waits (saying why) while a heat runs, the decoder is offline or a heat is not ready. It runs only in the browser where it was turned on. **■ Stop autopilot** to run heats by hand; turning it on again carries on with the next heat not yet run. **⏸ Pause the day** pauses the heat on track (or holds the count-down) and the autopilot until **Resume the day**.
|
||||
- **Race overview** (under the heat queue): the whole race of the current event in one place - the podium from the A final, then practice, qualifying and finals that open and close, each with the standings and every heat's result (laps, result, best lap, and the car in sponsor heats). **Print**, **PDF** and **CSV** export the whole race with every heat.
|
||||
- **Speaker panel** (under the start buttons): track call, track clear, red flag, pause, resume, false start and marshal warning. Under **Sound and calls** are quick switches that save at once: mute all, lap time calls, race leader calls, practice hype and the speaker cues.
|
||||
- **Preflight** checks the decoder, participants, transponders (missing or duplicated), the lap window, the grid and audio. Blockers come first, each with a shortcut to the right setting. The min/max lap time can be edited right there.
|
||||
- **An automatic SQLite backup** is taken before every start.
|
||||
|
||||
@@ -134,9 +136,9 @@ The menu follows how a race day works: **Start** (Dashboard, Race Day), **Create
|
||||
- **Transponder check:** every driver in the heat gets a green tick when their transponder crosses during the count-down. A missing driver's transponder can be changed in the panel, or linked to an unknown transponder that just crossed.
|
||||
- **Pause, resume and finish** work during the heat. Follow-up time lets the last lap finish after the clock.
|
||||
|
||||
**Timing** shows the live leaderboard (laps, gap to leader and ahead, own delta, best and last lap), recent passings with invalid short laps marked, the grid for position starts, a session replay (1-10x), and the speaker panel.
|
||||
**Timing** shows the live leaderboard (laps, gap to leader and ahead, own delta, best and last lap), recent passings with invalid short laps marked, the grid for position starts, and a session replay (1-10x).
|
||||
|
||||
**Judging** is where race corrections are made: ±laps, ±seconds and reset, plus removing or restoring any lap. Everything is logged with time and can be undone; the log exports as JSON. In qualifying, heats and finals this is the only place for penalties; Timing shows the corrections and has an **Open in Judging** button. Practice has no penalties, but laps can be cleaned up right on Timing (see [practice](#practice-and-training-statistics)).
|
||||
**Judging** has the speaker panel on top and is where race corrections are made: ±laps, ±seconds and reset, plus removing or restoring any lap. Everything is logged with time and can be undone; the log exports as JSON. In qualifying, heats and finals this is the only place for penalties; Timing shows the corrections and has an **Open in Judging** button. Practice has no penalties, but laps can be cleaned up right on Timing (see [practice](#practice-and-training-statistics)).
|
||||
|
||||
Lap validation:
|
||||
- **Min lap time** rejects shortcuts and false hits.
|
||||
@@ -150,10 +152,15 @@ Lap validation:
|
||||
|
||||
The **race list** is grouped so it stays short: **Today** (and anything running), **Upcoming**, and **Done** folded away (races whose heats are all run or whose date has passed). Races on the same date are listed together, each with how far it has come (● running heat, *Next: Q2 H1*, *3/9 run* or ✓ Done). A search box finds older races.
|
||||
|
||||
In **Manage**, the sessions are grouped per step: practice / seeding, each qualifying round, finals. A step whose heats are all run is folded to one line (✓ Qualifying round 1 · 3/3 run) and opens with a click. Each session shows ▲▼, Edit and Set active; printing, export, the grid and delete are under **⋯**.
|
||||
In **Manage** the easy setup comes first (the race steps and tabs, or the sponsor setup), then the list of heats; **Add a heat by hand (advanced)** and the branding are folded away. The sessions are grouped per step: practice / seeding, each qualifying round, finals. A step whose heats are all run is folded to one line (✓ Qualifying round 1 · 3/3 run) and opens with a click. Each session shows ▲▼, Edit and Set active; printing, export, the grid and delete are under **⋯**.
|
||||
|
||||
After creation the race is managed in four tabs (Race Setup → Manage):
|
||||
- **Participants & teams:** tick who races, and manage teams for endurance.
|
||||
- **Participants & teams:** tick who races. For endurance the **Team race** panel (shown as soon as the Endurance format is picked):
|
||||
- **Split the drivers** over N teams in one click, add a team, rename it in its card, add a driver from a list that says which team they move from, remove with ×;
|
||||
- a **car per team** (the drivers share its transponder) or the drivers' own transponders;
|
||||
- the **length** with quick picks 30 min to 24 h, and **Create team race**;
|
||||
- **checks before the start:** fewer than two teams, a team without drivers or transponder, a transponder on two teams, drivers on no team.
|
||||
- Run it on Race Day. Drivers change when the pack is flat - no driver-change rules. Teams, cars and the length can be changed while it runs (a broken car, a wrong transponder): the laps stay with the team. **Overlay → Team** shows the top 3 with the active driver and the team standings.
|
||||
- **Format:**
|
||||
- qualifying rounds, cars per heat, duration and start mode (mass, position, staggered, flying);
|
||||
- seeding (best N laps total, average, or consecutive);
|
||||
@@ -173,7 +180,7 @@ After creation the race is managed in four tabs (Race Setup → Manage):
|
||||
- split and pit summaries.
|
||||
- **Schedule & print:** the day's running order with planned times, and heat sheets.
|
||||
|
||||
The **Dashboard** shows schedule drift (planned vs actual). The **Results archive** finds finished races without going through Race Setup.
|
||||
The **Dashboard** shows schedule drift (planned vs actual). The **Results archive** lists one row per race; pick one to see its race overview, its heats and the exports (print, PDF, CSV, race package), and open a heat for its laps and penalties.
|
||||
|
||||
### Series / cup
|
||||
|
||||
@@ -207,6 +214,7 @@ Menu **Series / cup** runs a championship over any number of rounds, with freely
|
||||
|
||||
**Practice sessions:**
|
||||
- Open Practice can run all season; Free Practice is a rolling best-lap session.
|
||||
- **Settings** on the Open Practice row in Race Setup: the shortest and longest lap and the **ranking** - best lap (default), **best N laps in a row** (e.g. 3) or **best X minutes** (most laps inside X minutes, then the shorter time, e.g. 5). Timing, the overlay, Race Day and the results show e.g. "3 laps 52.341" or "17 laps / 5:00.3"; the best lap keeps its own column. A stop in the pits breaks "in a row".
|
||||
- **Start practice** on the Dashboard or Race Day continues the running Open Practice, or creates and starts one. **Reset – new practice day** on Race Day clears the day's laps for a new evening; every lap stays in the training statistics.
|
||||
|
||||
**Track layouts:**
|
||||
@@ -242,6 +250,9 @@ Settings → Audio:
|
||||
- start lights, random start delay and passing tones (optionally a different tone per driver/car);
|
||||
- announcements in Swedish or English for the start, the clock (1 min, 30 s, 10 s), final lap, finish, winner and podium, pit, penalties and race control (track call, red flag, false start, marshal);
|
||||
- each event can be switched on or off for effect and voice.
|
||||
- **Race control calls** are on the speaker panel on Race Day and Judging, with quick switches for the calls below.
|
||||
- **Practice:** a quick lap time call at each passing ("17 six", "18 flat", optionally with the name), pace and hype calls (beat last time, class rank, lap milestones, faster streaks, average down, close to best, duels). Off in qualifying and finals.
|
||||
- **Race leader calls:** on a confirmed change of leader and now and then (both, change only, or off).
|
||||
- **Calls during a race:** "Passing tone only" (default, like timing systems) or "Speaker" with names, personal bests and new leaders. Practice always gets the full calls.
|
||||
- **Local neural voice (Piper):** free and works offline. Install from Settings → Audio → Voice engine, or with `npm run tts:install`.
|
||||
- Standard voices: Swedish NST (male) and Lisa (female), English Ryan (male) and Lessac (female).
|
||||
@@ -261,9 +272,12 @@ The **Overlay** menu has leaderboard, speaker, results, TV and team modes, plus
|
||||
|
||||
### Sponsor events with shared cars
|
||||
|
||||
**Sponsor events** (track events) let many drivers share a few cars and transponders, e.g. 10 drivers and 4 cars:
|
||||
- rounds are created automatically and drivers are assigned to cars per session;
|
||||
- within one session every car needs a unique transponder, but the same transponder can be used again in the next session.
|
||||
**Sponsor events** let guests drive the club's cars, rental-kart style - e.g. 8 drivers on 4 cars. Events → Manage:
|
||||
1. **Drivers:** type the names, one per line. They become guests of this event only (never in normal races or practice) and are deleted with it.
|
||||
2. **Cars:** tick the cars, or add one with name and transponder.
|
||||
3. **Format:** practice per group, qualifying rounds, qualifying start (staggered, flying, mass) and lengths. 8 drivers and 4 cars give 2 groups, 1 practice per group, 2 qualifying rounds and A/B finals. **Create heats**: drivers rotate cars every round.
|
||||
4. Run the heats on **Race Day** like a race (▶ Next, Start, Pause, Stop, count-down, start signal and calls). The car's transponder counts for whoever drives it in that heat.
|
||||
5. **Create finals** from qualifying; cars are drawn for the finals. The race overview and the results archive show the car per driver and heat.
|
||||
|
||||
### Data, backups and import/export
|
||||
|
||||
@@ -433,6 +447,8 @@ AMMC sends PASSING messages like this ([AMMC docs](https://www.ammconverter.eu/d
|
||||
|
||||
Settings → "Decoder simulator" starts it from the UI (port 9099, the app connects by itself). From a terminal, `npm run sim` starts a decoder simulator on `ws://127.0.0.1:9000` (the app's default decoder address) that replaces AMMC and the decoder, so it also runs on a laptop without either. It sends passings with realistic lap times (about 18 s, a crash now and then) for the transponders in the active heat (sponsor heats: the cars), and follows when you switch heat. Start the heat on Race Day and the laps come in. Options: `npm run sim -- --lap 15 --spread 2 --tp 1001,1002 --port 9000`. If port 9000 is busy (AMMC running), stop AMMC or use `--port 9100` and set the decoder address to `ws://127.0.0.1:9100`.
|
||||
|
||||
**Test data:** `test-data/` has 12 drivers (`drivers.csv`), 4 rental cars (`cars.csv`) and 8 guest names (`sponsor-gaster.txt`). Import the CSVs under Settings → System & backup (Import drivers CSV / Import cars CSV), paste the names into a sponsor event, and run it with the simulator.
|
||||
|
||||
## Development and tests
|
||||
|
||||
- **Unit, logic and API tests:** `npm test`. The SQLite integration tests start their own server against a temporary database and never touch `data/`.
|
||||
|
||||
Reference in new issue
Block a user