docs(videos): re-record video guides, add House of RC guide, refresh screenshots (1.84.2)

This commit is contained in:
larssand committed 2026-11-08 21:42:23 +01:00
1 parent f14cdb8c97
commit c5addf5b41
29 files changed
+123 -12

No files matched your search

+5
View File
@@ -8,6 +8,11 @@ The application version is maintained in `package.json` and displayed in the adm
No changes recorded yet.
## 1.84.2
- **Video guides re-recorded** for the current interface, plus a new one: **House of RC – fetch entries, late entries and send results** (Guide → Videos and README). README screenshots refreshed.
- **Send results to House of RC:** the two modes sit side by side and the preview table uses the full width.
## 1.84.1
- **House of RC:** a driver you added to the race by hand who later enters on House of RC is now linked to that entry by **🔄 Fetch changes from House of RC** ("Already racing – linked to the entry"), so their results are sent too. Before, they were skipped and their results never reached House of RC.
+2 -1
View File
@@ -322,7 +322,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.
- **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.
- **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.
- **`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.
- **Don't expose port 8081 to the internet.** Reads are not PIN protected. Publish only the public overlay and mobile profile paths through a reverse proxy or VPN.
@@ -336,6 +336,7 @@ Short narrated recordings (`.mkv`, H.264/AAC), also linked from the in-app Guide
- **Getting started:** [Connect a decoder](docs/videos/connect-decoder.mkv) · [Add drivers and cars](docs/videos/add-drivers-cars.mkv) · [Create a race](docs/videos/create-race.mkv) · [Run a session](docs/videos/run-a-session.mkv)
- **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)
Recorded with `node scripts/record-video-guides.mjs`, against an isolated test server.
+2 -1
View File
@@ -335,7 +335,7 @@ Erik Eriksson;654321;4WD;Associated;;
RaceCore är tänkt för ett betrott racenätverk:
- **Admin-PIN** (Inställningar → System & backup, av som standard) skyddar alla ändringar via API:t. Inloggningen gäller i 30 dagar och är skyddad mot gissning.
- **Race Controller Master:** bara en dator åt gången kör racet (decodern, start, paus, fortsätt, stopp, tjuvstart, nollställ heat och autopiloten, även från speakerpanelen). Domarvyns korrigeringar och övriga utrop fungerar från alla datorer. Datorn som kör servern (sidan öppnad på `localhost`) blir master av sig själv och visar en grön rad "🎙 Du är Race Controller Master" med **Släpp master**. Mobiler och andra datorer följer racet live (uppdateras varje sekund), visar "Du följer racet …" och blir master bara när någon trycker på knappen; den datorn minns sedan rollen. De kan också förbereda förare och race. Den som jobbar som race controller trycker **Ta över som master**, och den förra mastern släpper decodern inom några sekunder. Med admin-PIN krävs inloggning för att ta över. Ge datorn ett namn under Inställningar → System, t.ex. "Speakerbåset". Overlays och OBS är alltid bara visning.
- **House of RC:** under Inställningar → System → 🏠 House of RC sparar du klubbens API-nyckel en gång (bara på servern, visas aldrig igen) och trycker **Testa anslutning**. Förare → **🏠 Hämta från House of RC** fyller i namn och märke utifrån transpondrarna (bara det du bockar i), och en känd transponder fyller i en ny förare. Med nyckeln för klubben som arrangerar tävlingen listar Race-guidens **🏠 Hämta från House of RC** klubbens tävlingar; välj tävling och en av dess klasser så fylls namn, datum, klass och anmälda förare med transpondrar i. Senare lägger Hantera → Deltagare → **🔄 Hämta ändringar från House of RC** till sena anmälningar och tar bort avanmälda. **📤 Skicka resultat till House of RC** förhandsgranskar och skickar resultatet till anmälningarna: heat och kval under dagen, slutplaceringen när finalerna är körda.
- **House of RC:** under Inställningar → System → 🏠 House of RC sparar du klubbens API-nyckel en gång (bara på servern, visas aldrig igen) och trycker **Testa anslutning**. Förare → **🏠 Hämta från House of RC** fyller i namn och märke utifrån transpondrarna (bara det du bockar i), och en känd transponder fyller i en ny förare. Med nyckeln för klubben som arrangerar tävlingen listar Race-guidens **🏠 Hämta från House of RC** klubbens tävlingar; välj tävling och en av dess klasser så fylls namn, datum, klass och anmälda förare med transpondrar i. Senare lägger Hantera → Deltagare → **🔄 Hämta ändringar från House of RC** till sena anmälningar och tar bort avanmälda. **📤 Skicka resultat till House of RC** förhandsgranskar och skickar resultatet till anmälningarna: heat och kval under dagen, slutplaceringen när finalerna är körda. Bara förare som är anmälda på House of RC (med eget konto) får resultat där; övriga listas som inte skickade.
- **`RC_ADMIN_ALLOWED_CIDRS`** begränsar adminändringar till vissa adresser eller nät, till exempel `192.168.1.0/24`.
- **`RC_ALLOWED_ORIGINS`** används för ett gränssnitt som medvetet körs från en annan adress.
- **Exponera inte port 8081 mot internet.** Läsningar skyddas inte av PIN. Publicera bara sökvägarna för publik overlay och mobilprofil via reverse proxy eller VPN.
@@ -349,6 +349,7 @@ Korta inspelningar med berättarröst (`.mkv`, H.264/AAC), även länkade från
- **Kom igång:** [Anslut en decoder](docs/videos/connect-decoder.mkv) · [Lägg till förare och bilar](docs/videos/add-drivers-cars.mkv) · [Skapa ett race](docs/videos/create-race.mkv) · [Kör en session](docs/videos/run-a-session.mkv)
- **Rundtur i gränssnittet:** [Inställningsflikar](docs/videos/settings-tabs.mkv) · [Event Managers flikar](docs/videos/event-manager-tabs.mkv) · [Dagens schema](docs/videos/event-schedule.mkv)
- **Tävlingsdag och efteråt:** [Sponsorevent](docs/videos/sponsor-event.mkv) · [Lagrace](docs/videos/team-race.mkv) · [Ranking i öppen träning](docs/videos/practice-ranking.mkv) · [Race-översikt och arkiv](docs/videos/race-overview.mkv) · [Domare: utrop, straff och DSQ](docs/videos/judging.mkv)
- **House of RC:** [Hämta anmälda, efteranmälda och skicka resultat](docs/videos/house-of-rc.mkv)
Spelas in med `node scripts/record-video-guides.mjs`, mot en isolerad testserver.
Binary file not shown.

Before

Width:  |  Height:  |  Size: 593 KiB

After

Width:  |  Height:  |  Size: 648 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 449 KiB

After

Width:  |  Height:  |  Size: 466 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 369 KiB

After

Width:  |  Height:  |  Size: 386 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 310 KiB

After

Width:  |  Height:  |  Size: 309 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 458 KiB

After

Width:  |  Height:  |  Size: 432 KiB

Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
+2 -2
View File
@@ -1,12 +1,12 @@
{
"name": "rc-racecore",
"version": "1.84.1",
"version": "1.84.2",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "rc-racecore",
"version": "1.84.1",
"version": "1.84.2",
"hasInstallScript": true,
"dependencies": {
"better-sqlite3": "^12.11.1",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "rc-racecore",
"version": "1.84.1",
"version": "1.84.2",
"private": true,
"description": "RC RaceCore live timing and race control with AMMC ingest and SQLite persistence",
"engines": {
+1 -1
View File
@@ -137,7 +137,7 @@ async function captureShot(name, { setup }) {
// save the connection triggers finish so the sidebar doesn't show a stray "Changes
// waiting to save" banner in the capture.
await waitFor(async () => await evaluate('document.getElementById("connectionBadge")?.classList.contains("badge-online")'), "decoder connected");
await waitFor(async () => (await evaluate('document.getElementById("syncStatus")?.dataset.state')) === "saved", "settings saved");
await waitFor(async () => ["saved", "connected"].includes(await evaluate('document.getElementById("syncStatus")?.dataset.state')), "settings saved");
}
const click = (selector) => evaluate(`document.querySelector(${JSON.stringify(selector)}).click()`);
const scrollTo = (selector, block = "start") => evaluate(`document.querySelector(${JSON.stringify(selector)})?.scrollIntoView({block: ${JSON.stringify(block)}})`);
+99 -3
View File
@@ -199,7 +199,7 @@ async function recordClip(name, { prepare, seedState, setup, steps }) {
await send("Page.enable");
await send("Emulation.setDeviceMetricsOverride", { width: 1600, height: 900, deviceScaleFactor: 1, mobile: false });
const ctx = { evaluate, navigate, fill, click, scrollTo, clickNav, state, pause, ...(prepared?.extra || {}) };
const ctx = { evaluate, navigate, fill, click, scrollTo, clickNav, state, pause, send, ...(prepared?.extra || {}) };
// Setup (navigation, opening the right event, scrolling to the starting point) happens
// before the screencast starts, so the recording opens already on the right view
@@ -261,11 +261,107 @@ const clips = {
{ text: "This is the Settings page, split into four tabs: Connection, Audio, Appearance, and System." },
{ text: "Audio controls race sound announcements, volume, and which events get a spoken callout.", async action({ click }) { await click('[data-settings-tab="audio"]'); } },
{ text: "Appearance and Overlay covers club branding, track layouts, and the OBS overlay setup.", async action({ click }) { await click('[data-settings-tab="appearance"]'); } },
{ text: "System and Backup handles software updates, backups, and race presets.", async action({ click }) { await click('[data-settings-tab="system"]'); } },
{ text: "System and Backup handles software updates, backups, race presets, and the club's House of RC key.", async action({ click }) { await click('[data-settings-tab="system"]'); } },
{ text: "And Connection, where we started, is where you link up the decoder.", async action({ click }) { await click('[data-settings-tab="connection"]'); } },
],
},
// House of RC: the page talks to a stand-in for the House of RC routes (installed before
// every page load), so no key, club or real event is ever used or shown.
"house-of-rc": {
seedState(state) {
const classId = "vid_hor_class";
state.classes.push({ id: classId, name: "2WD Buggy" });
state.drivers.push({ id: "vid_hor_alex", name: "Alex Karlsson", classId, transponder: "7970001", houseOfRcId: "501" });
},
async setup({ send, navigate, click, scrollTo }) {
await send("Page.addScriptToEvaluateOnNewDocument", { source: `(() => {
const realFetch = window.fetch;
const json = (data) => new Response(JSON.stringify(data), { status: 200, headers: { "Content-Type": "application/json" } });
const event = { id: 9001, name: "Club Cup Round 3", start: "2026-12-05T08:00:00Z", city: "Hometown", country: "SE", url: "https://houseofrc.com/events/9001" };
const first = [
{ entryId: 1, classId: 71, houseOfRcId: 501, name: "Alex Karlsson", number: 7, transponders: ["7970001"], club: "Hometown RC", car: "Xray XB2" },
{ entryId: 2, classId: 71, houseOfRcId: 502, name: "Sam Nilsson", number: 12, transponders: ["7970002"], club: "Hometown RC", car: "Associated B7" },
{ entryId: 3, classId: 71, houseOfRcId: 503, name: "Jamie Lee", number: 3, transponders: ["7970003"], club: "Lakeside RC", car: "Schumacher Cougar" },
{ entryId: 4, classId: 72, houseOfRcId: 504, name: "Robin Berg", number: 9, transponders: ["7970004"], club: "Lakeside RC", car: "Mugen MSB1" },
];
const later = [first[0], first[1], { entryId: 5, classId: 71, houseOfRcId: 505, name: "Kim Holm", number: 21, transponders: ["7970005"], club: "Hometown RC", car: "TLR 22 5.0" }];
window.fetch = async (url, options) => {
const path = String(url);
if (path.includes("/api/houseofrc/status")) return json({ configured: true, source: "file", keyHint: "…demo" });
if (path.includes("/api/houseofrc/test")) return json({ ok: true, organization: { id: 1, name: "Hometown RC" }, rateLimit: 60 });
if (path.includes("/api/houseofrc/events")) return json({ ok: true, organizationId: 1, events: [event, { id: 9002, name: "Winter Indoor", start: "2027-01-16T08:00:00Z", city: "Hometown", country: "SE" }] });
if (path.includes("/api/houseofrc/entries")) return json({ ok: true, event, classes: [{ id: 71, name: "2wd" }, { id: 72, name: "4wd" }], entries: sessionStorage.getItem("vidHorLater") ? later : first });
if (path.includes("/api/houseofrc/results")) return json({ ok: true, updated: JSON.parse(options.body).entries.length, entries: [] });
return realFetch(url, options);
};
})();` });
await navigate("settings", "settingsForm");
await click('[data-settings-tab="system"]');
await waitFor(async () => true, "settings");
await pause(400);
await scrollTo("#houseOfRcSettings", "center");
},
steps: [
{ text: "RaceCore works with House of RC. Under Settings, System, the club saves its House of RC key once. It stays on the server and is never shown again." },
{
text: "Test connection shows which club the key belongs to.",
async action({ click }) { await click("#houseOfRcTest"); },
},
{
text: "In Race Setup, the race wizard can fetch an event from House of RC. Drivers sign up there, with their transponders.",
async action({ navigate, click, evaluate }) {
await navigate("race_setup", "raceWizardStepForm");
await click("#raceWizardHouseOfRc");
await waitFor(async () => Boolean(await evaluate(`document.querySelector('[data-hor-event="9001"]')`)), "event list");
},
},
{
text: "Pick the event and one of its classes, and say which of our classes it is. Drivers we already have are linked, new ones are added.",
async action({ click, evaluate }) {
await click('[data-hor-event="9001"]');
await waitFor(async () => Boolean(await evaluate(`document.querySelector("[data-hor-apply]")`)), "entries");
await evaluate(`(() => { const select = document.querySelector("[data-hor-class]"); select.value = "vid_hor_class"; select.dispatchEvent(new Event("change", { bubbles: true })); })()`);
},
},
{
text: "One click fills the wizard: name, date, class, and the entered drivers. Then choose the format and create the race as usual.",
async action({ click, evaluate }) {
await click("[data-hor-apply]");
await waitFor(async () => Boolean(await evaluate(`document.querySelector(".wizard-participant:checked")`)), "wizard filled");
},
},
{
text: "The race keeps the event and each driver's entry. Late entries or a withdrawal? Fetch changes from House of RC under Manage, Participants. Only heats that haven't run are changed.",
async action({ click, evaluate }) {
await click("#raceWizardNext");
await click("#raceWizardNext");
await click("#raceWizardCreate");
await waitFor(async () => Boolean(await evaluate(`document.getElementById("houseOfRcRefreshEntries")`)), "manage view");
await evaluate(`document.getElementById("houseOfRcRefreshEntries").scrollIntoView({ block: "center" })`);
await pause(1200);
await evaluate(`sessionStorage.setItem("vidHorLater", "1")`);
await click("#houseOfRcRefreshEntries");
await waitFor(async () => Boolean(await evaluate(`document.querySelector("#houseOfRcRefreshOverlay [data-hor-apply]")`)), "changes");
},
},
{
text: "During the day, Send results shows what goes to each entry: qualifying, every heat, and once the finals have run, the final placings.",
async action({ click, evaluate }) {
await click("#houseOfRcRefreshOverlay [data-hor-apply]");
await waitFor(async () => Boolean(await evaluate(`document.getElementById("houseOfRcSendResults")`)), "manage again");
await pause(800);
await click("#houseOfRcSendResults");
await waitFor(async () => Boolean(await evaluate(`document.querySelector("#houseOfRcResultsOverlay [data-hor-send]")`)), "results preview");
},
},
{
text: "Send, and the results are on House of RC. Drivers only sign up in one place.",
async action({ click }) { await click("#houseOfRcResultsOverlay [data-hor-send]"); },
},
],
},
"event-manager-tabs": {
seedState(state) {
const classId = "vid_class";
@@ -450,7 +546,7 @@ const clips = {
await navigate("race_setup", "raceWizardStepForm");
},
steps: [
{ text: "Creating a race has four steps. Let's start with the basics: name, date, and class." },
{ text: "Creating a race has four steps. Let's start with the basics: name, date, and class. A race can also be fetched from House of RC with the house button." },
{
text: "Give the race a name, pick a class and format, then continue.",
async action({ fill, click }) {
+2
View File
@@ -2083,6 +2083,7 @@ const TRANSLATIONS = {
"guide.video_practice_ranking": "Öppen träning – ranking på varv i rad",
"guide.video_race_overview": "Race-översikt och resultatarkiv",
"guide.video_judging": "Domare – utrop, straff och DSQ",
"guide.video_house_of_rc": "House of RC – hämta anmälda, efteranmälda och skicka resultat",
"guide.tab_start": "Kom igång",
"guide.tab_create": "Skapa ett race",
"guide.tab_run": "Köra ett race",
@@ -4326,6 +4327,7 @@ const TRANSLATIONS = {
"guide.video_practice_ranking": "Open practice – ranking by laps in a row",
"guide.video_race_overview": "Race overview and results archive",
"guide.video_judging": "Judging – calls, penalties and DSQ",
"guide.video_house_of_rc": "House of RC – fetch entries, late entries and send results",
"guide.tab_start": "Getting started",
"guide.tab_create": "Create a race",
"guide.tab_run": "Run a race",
+3 -3
View File
@@ -363,9 +363,9 @@ export function openHouseOfRcResultsPost({ event, overview, state, t, escapeHtml
const where = [event.houseOfRc.name, event.houseOfRc.className].filter(Boolean).join(" – ");
body.innerHTML = `
<p><strong>${escapeHtml(where)}</strong>${event.houseOfRc.resultsSentAt ? ` <span class="hint">· ${escapeHtml(t("houseofrc.results_last", { time: new Date(event.houseOfRc.resultsSentAt).toLocaleString() }))}</span>` : ""}</p>
<div class="hor-choice">
<label><input type="radio" name="horResultsMode" value="heats" ${final ? "" : "checked"} /> ${escapeHtml(t("houseofrc.results_mode_heats"))}</label>
<label><input type="radio" name="horResultsMode" value="final" ${final ? "checked" : ""} ${hasFinals ? "" : "disabled"} /> ${escapeHtml(t("houseofrc.results_mode_final"))}</label>
<div class="hor-modes">
<label class="hor-choice"><input type="radio" name="horResultsMode" value="heats" ${final ? "" : "checked"} /> ${escapeHtml(t("houseofrc.results_mode_heats"))}</label>
<label class="hor-choice"><input type="radio" name="horResultsMode" value="final" ${final ? "checked" : ""} ${hasFinals ? "" : "disabled"} /> ${escapeHtml(t("houseofrc.results_mode_final"))}</label>
</div>
<p class="hint">${escapeHtml(t(final ? "houseofrc.results_final_hint" : "houseofrc.results_heats_hint"))}</p>
<div class="table-wrap"><table class="hor-import-table">
+1
View File
@@ -143,6 +143,7 @@ export function renderGuideView({ dom, t }) {
<li><a href="/docs/videos/practice-ranking.mkv" target="_blank" rel="noopener">${t("guide.video_practice_ranking")}</a></li>
<li><a href="/docs/videos/race-overview.mkv" target="_blank" rel="noopener">${t("guide.video_race_overview")}</a></li>
<li><a href="/docs/videos/judging.mkv" target="_blank" rel="noopener">${t("guide.video_judging")}</a></li>
<li><a href="/docs/videos/house-of-rc.mkv" target="_blank" rel="noopener">${t("guide.video_house_of_rc")}</a></li>
</ul>
</div>
</section>
+5
View File
@@ -4944,7 +4944,12 @@ tr:has(> td > .medal-3) { background: linear-gradient(90deg, rgba(205, 127, 60,
/* House of RC driver import */
.hor-import { width: min(900px, 100%); }
.hor-import-table { width: 100%; }
.hor-import-table th { text-align: left; }
.hor-import-table td { vertical-align: middle; }
.hor-modes { display: flex; flex-wrap: wrap; gap: 8px 20px; margin: 8px 0; }
.hor-modes .hor-choice { flex-direction: row; white-space: nowrap; }
.hor-modes .hor-choice input { width: auto; min-height: 0; margin: 0; }
.hor-choice { display: inline-flex; align-items: center; gap: 6px; cursor: pointer; }
.hor-choice s { opacity: 0.6; }
.hor-link-row { display: flex; gap: 8px; }