docs(guide): race day, series fixes and driver page in guide and READMEs; two new video guides, all clips re-recorded in sync (1.89.41)

This commit is contained in:
larssand committed 2026-11-15 22:32:03 +01:00
1 parent 7af4a81aaa
commit 8d7d4d33e6
29 files changed
+404 -36

No files matched your search

+7 -1
View File
@@ -211,6 +211,8 @@ Menu **Series / cup** runs a championship over any number of rounds, with freely
- The day placing comes from the final standings (A before B), then qualifying order.
- No registered lap gives 0. Absence counts as 0 and can be dropped.
- **✎ Result** on a round sets the day's order by hand (▲▼, add, remove), e.g. when the qualifying went wrong. It replaces the calculated result in the standings, and the round is marked Corrected result. Use the calculated result goes back.
- **🔗 Link to driver:** when one driver shows on two rows (results left on a deleted duplicate) the row gets a picker - choose the right driver and the rows are merged.
- **📄** on a round that has run downloads the day's CSV for that class (see Data, backups and import/export).
- Ties go to most wins, then 2nd places, then the latest common round.
- Print, or export as PDF (wide tables switch to landscape).
@@ -314,6 +316,8 @@ The **Overlay** menu has leaderboard, speaker, results, TV and team modes, plus
- **Search** on name, transponder, brand, club or country, **Class** to show just one class, and **Sort by** name, class, club, transponder or brand (↑/↓ reverses). Sort and grouping are remembered in the browser.
- **Country** (optional): pick from the list or type it ("Sweden", "SE" and "SWE" work too). The driver then gets a small flag before the name in timing, Race Day, the overlay and OBS, start lists, results, printouts and PDFs. No country, no flag. The flags are in the repo (`src/flags`), so they work offline. OBS can turn them off under **Show flags**.
- **Select** drivers with the boxes (or **Select all shown**) and **Delete selected**; a confirm names them first. Deleting, one or many, also removes the drivers from every heat, participant list and team.
- **Merge with another driver** (edit the driver): the same person entered twice. Every heat, lap, result, entry, check-in, series point and training lap moves to the driver you keep, and the duplicate is removed. Only the Race Controller Master can merge.
- **The same transponder twice in one class** is refused (the decoder can't tell the laps apart). The same person in another class is fine - the lap goes to the driver who is in the running heat.
### Data, backups and import/export
@@ -330,6 +334,7 @@ The **Overlay** menu has leaderboard, speaker, results, TV and team modes, plus
- Race Day shows "📄 Result saved", and the Results archive has the list **📄 Saved PDFs**. The files are not part of the server backup (that covers the database), so copy the folder to keep them long term.
- **Ask to print when the finals are done** shows a **🖨 Print results** button when the last final is done. A browser cannot print without a click; for fully automatic printing start Chrome with `--kiosk-printing`, which prints straight to the default printer when the button is pressed.
- **Export/import** (Settings → Storage):
- **📄 CSV for the race day** (Results archive: pick the same date in From and To, and a class or all): first a summary per heat (place, laps, total time, best and average lap), then every lap in running order with transponder, lap time, time of day and whether the lap counted. Semicolons and UTF-8 with BOM, so Excel opens it in columns. Every series round that has run has a 📄 shortcut.
- full JSON, or the directory only (classes, drivers, cars);
- CSV for drivers and cars (Excel/LibreOffice; comma, semicolon or tab). The CSV import merges: it matches on ID, then transponder, then name + class.
- a single race package from Race Setup;
@@ -348,7 +353,7 @@ Erik Eriksson;654321;4WD;Associated;;
RaceCore is meant for a trusted race network:
- **Admin PIN** (Settings → System & backup, off by default) protects every change through the API. The login lasts 30 days and is throttled against guessing.
- **Race Controller Master:** one computer at a time runs the race (the decoder, start, pause, resume, stop, false start, resetting a heat and the autopilot, also from the speaker panel). Judging corrections and the other calls work from any computer. The computer running the server (page opened on `localhost`) becomes master on its own and shows a green line "🎙 You are the Race Controller Master" with **Release master**. Phones and other computers follow the race live (updated every second), show "You are following the race …" and become master only when someone presses the button; that computer then remembers the role. They can also prepare drivers and races. Whoever works as race controller presses **Take over as master**, and the previous master lets go of the decoder within seconds. With the admin PIN on, taking over needs a login. Name the computer under Settings → System, e.g. "Speaker booth". Overlays and OBS are always view-only.
- **Race Controller Master:** one computer at a time runs the race (the decoder, start, pause, resume, stop, false start, resetting a heat and the autopilot, also from the speaker panel). Judging corrections and the other calls work from any computer. The computer running the server (page opened on `localhost`) becomes master on its own and shows a green line "🎙 You are the Race Controller Master" with **Release master**. Phones and other computers follow the race live (updated every second), show "You are following the race …" and become master only when someone presses the button; that computer then remembers the role. They can also prepare drivers and races. Whoever works as race controller presses **Take over as master**, and the previous master lets go of the decoder within seconds. With the admin PIN on, taking over needs a login. Name the computer under Settings → System, e.g. "Speaker booth". Overlays and OBS are always view-only. Other computers can't change the race by mistake: when they save (pick a heat to look at, or hold an old copy) the server keeps the master's active heat, each heat's status and clock, the laps and the heats that have run. A run heat only goes back to Ready through Reset. Qualifying and finals that have run are never made again by mistake - Clear generated ... names the run heats and asks first.
- **House of RC:** under Settings → System → 🏠 House of RC you save the club's API key once (stored on the server only, never shown again) and press **Test connection**. Drivers → **🏠 Fetch from House of RC** fills in names and brands from the transponders (only what you tick), and a known transponder fills in a new driver. With the key of the club running the event, the race wizard's **🏠 Fetch from House of RC** lists the club's events; pick an event and one of its classes, and the name, date, class and entered drivers with their transponders are filled in. Later, Manage → Participants → **🔄 Fetch changes from House of RC** adds late entries and takes out withdrawals. **📤 Send results to House of RC** previews and sends the results to the entries: heats and qualifying during the day, the final placings when the finals are run. Only drivers entered on House of RC (with their own account) get results there; others are listed as not sent. Tick **Send heats automatically** and the race controller sends heats and qualifying after every heat by itself (semi-live), retrying without internet; the final placings are always sent by hand.
- **`RC_ADMIN_ALLOWED_CIDRS`** restricts admin changes to certain addresses or networks, e.g. `192.168.1.0/24`.
- **`RC_ALLOWED_ORIGINS`** is for a UI deliberately served from another address.
@@ -364,6 +369,7 @@ Short narrated recordings (`.mkv`, H.264/AAC), also linked from the in-app Guide
- **Interface tour:** [Settings tabs](docs/videos/settings-tabs.mkv) · [Event Manager tabs](docs/videos/event-manager-tabs.mkv) · [Race day schedule](docs/videos/event-schedule.mkv)
- **Race day and after:** [Sponsor event](docs/videos/sponsor-event.mkv) · [Team race](docs/videos/team-race.mkv) · [Open practice ranking](docs/videos/practice-ranking.mkv) · [Race overview and archive](docs/videos/race-overview.mkv) · [Judging: calls, penalties and DSQ](docs/videos/judging.mkv)
- **House of RC:** [Fetch entries, late entries and send results](docs/videos/house-of-rc.mkv)
- **Race day and phone:** [A cup day - check-in, qualifying, finals, fixing a duplicate and the day's CSV](docs/videos/cup-day.mkv) · [Training stats, Standard/Pro and the next heat on the phone](docs/videos/driver-page.mkv)
Recorded with `node scripts/record-video-guides.mjs`, against an isolated test server.