From 10a0dd49bdf6298b9a01146924cffb9f766282da Mon Sep 17 00:00:00 2001 From: larssand Date: Thu, 12 Nov 2026 22:58:19 +0100 Subject: [PATCH] docs: guide and architecture notes for tonight's race day, audio, results and driver list changes --- docs/javascript-architecture.md | 10 ++++++++++ src/app.js | 24 ++++++++++++------------ 2 files changed, 22 insertions(+), 12 deletions(-) diff --git a/docs/javascript-architecture.md b/docs/javascript-architecture.md index b84c192..cd28555 100644 --- a/docs/javascript-architecture.md +++ b/docs/javascript-architecture.md @@ -510,6 +510,16 @@ Owns: Used by `src/training_views.js`. `src/public_training.js` holds an inlined copy (the public page must load as one file through the router allowlist); `tests/stint_laps_view.test.js` checks that the two render identically. +### `src/driver_list_logic.js` +Type: +- pure driver-register list logic + +Owns: +- search (`filterDrivers`), sorting with empty values last (`sortDrivers`) and grouping per class (`groupDriversByClass`) +- `removeDrivers()`: deletes drivers from the register and from every heat, participant list and team (single and bulk delete) + +Used by `renderDriversView` in `src/core_views.js`, which keeps the list's view settings (sort and grouping in localStorage, class filter and selection for the open page). + ### `src/session_replay.js` Type: - pure transient replay logic diff --git a/src/app.js b/src/app.js index 3c9e6fd..842c754 100644 --- a/src/app.js +++ b/src/app.js @@ -3280,9 +3280,9 @@ const TRANSLATIONS = { "guide.audio_4": "4. Den officiella raceklockan startar i samma callback som starttonen. Bara Quick Open Practice och fri träning startar direkt utan race-sekvens - en schemalagd \"Practice\"-session i ett race/sponsor-event får samma nedräkning, ljus och startton som kval/heat/final.", "guide.audio_5": "5. Speakerpanelen finns på Race Day (under startknapparna) och i Domare: Stopp på banan, Banan fri, Röd flagg, Paus, Fortsätt, Tjuvstart och Banvaktsvarning. Under Ljud och utrop finns snabbval som sparas direkt: tysta allt, varvtidsutrop, ledarutrop, pepp under träning och speaker-utropen. Kritiska utrop avbryter lägre prioriterat tal.", "guide.audio_6": "6. Under Förare och Bilar kan du välja pass_01.wav till pass_08.wav. Om filen saknas används standardljudet; lägg egna korta filer i rc-race-sound-pack/sounds/effects/.", - "guide.audio_7": "7. Personbästa, snabbaste varv, banrekord, ledarbyte, tidsvarningar, depå in/ut, finish och podium hämtas från befintliga timinghändelser. Tiden sägs som sekunder och hundradelar, till exempel 18 sextiotre. Varvtid vid passering (17 sex, 18 jämnt) gäller bara träning tills du väljer Träning och race.", + "guide.audio_7": "7. Personbästa, snabbaste varv, banrekord, ledarbyte, tidsvarningar, depå in/ut, finish och podium hämtas från befintliga timinghändelser. Tiden sägs som sekunder och hundradelar, till exempel 18 sextiotre. Varvtid vid passering (17 sex, 18 jämnt) gäller bara träning tills du väljer Träning och race. Ny ledare i träning kan slås av (Inställningar eller ljudpanelen på Race Day) eftersom ingen kör mot någon där; övriga träningsutrop är kvar.", "guide.audio_8": "8. Ljudet spelas i operatörens webbläsare. Klicka Testa före racet, kontrollera ljudutgången och håll Tidtagning-fliken öppen.", - "guide.audio_9": "9. Staggered start i ett kvalheat läser upp varje bils transpondernummer i startordning, cirka 3 sekunder mellan varje bil, direkt efter den vanliga starten - mass/position-start läser aldrig upp enskilda bilar.", + "guide.audio_9": "9. Upprop och förskjuten start: Auto (standard) ropar bilnummer i finaler (Bil 1, 2, 3) och namn annars; välj annars Namn, Bilnummer eller Bilnummer + namn (bil 5 Anders) under Inställningar eller i ljudpanelen på Race Day. Bilnumret är startplatsen. Förskjuten start ropar ut varje bil i startordning, cirka 3 sekunder mellan varje, direkt efter starten - mass/position-start ropar aldrig ut enskilda bilar.", "guide.audio_10": "10. Bättre röst utan internet: under Inställningar -> Ljud -> Röstmotor, klicka Installera en gång (hämtar Piper och svenska + engelska röster, kräver internet just då) och välj Lokal röst. Välj manlig eller kvinnlig röst per språk under Svensk röst / Engelsk röst och lyssna med Testa rösten. Klicka sedan Förgenerera fraser och förarnamn före racedagen. Allt körs sedan lokalt; saknas Piper eller dröjer den används webbläsarens röst automatiskt.", "guide.sim_title": "Testa utan decoder (simulator)", "guide.sim_1": "1. Inställningar → Anslutning → Decoder-simulator → Starta. Den ersätter AMMC och MyLaps-decodern (fungerar på Linux, Windows och en laptop utan decoder). Appen byter själv till simulatorns adress (port 9099) och ansluter; Stoppa sätter tillbaka den riktiga decoderadressen.", @@ -3298,7 +3298,7 @@ const TRANSLATIONS = { "guide.sponsor_6": "6. När kvalet är kört: Skapa finaler från kvalet. Bilarna lottas i finalerna.", "guide.sponsor_7": "7. I Hantera ligger sponsor-setupen överst och heatlistan under. Lägg till heat manuellt finns hopfällt längre ner. Testa utan klubbregister: test-data/ i RaceCore har förare, bilar och gästnamn att importera. Under heatet visas bilen bredvid varje förare (🚗) i overlayn och på Race Day.", "guide.race_title": "Skapa vanligt race (förare har egna transpondrar)", - "guide.race_1": "1. Lägg in förare med personlig transponder. Brandfältet kan användas för team, sponsor eller bilmärke.", + "guide.race_1": "1. Lägg in förare med personlig transponder. Brandfältet kan användas för team, sponsor eller bilmärke. Förarlistan grupperas per klass och kan filtreras på en klass, sökas och sorteras (namn, klass, klubb, transponder, märke). Markera flera förare och tryck Radera markerade för att ta bort dem på en gång, efter en bekräftelse.", "guide.race_2": "2. Skapa event med läge Race.", "guide.race_3": "3. Klicka Hantera på racet och markera exakt vilka förare som ska få vara med i just detta race.", "guide.race_4": "4. Gå igenom Raceformat och välj antal kvalrundor, förare per heat, tider, starttyp och hur finaler ska seedas.", @@ -3336,7 +3336,7 @@ const TRANSLATIONS = { "guide.open_practice_3": "Open Practice påverkar inte seedning, kval eller finaler.", "guide.open_practice_4": "Gå till Race Setup och använd Snabbstart Open Practice. Du behöver bara ange ett namn; klass, deltagare, preset och racetid behövs inte.", "guide.open_practice_5": "Enklast: tryck Starta träning på Översikten eller Race Day - då fortsätter en pågående Open Practice eller så skapas och startas en ny. Nollställ – ny träningsdag på Race Day nollställer dagens varv utan att statistiken försvinner, och Ny banlayout finns bland snabbvalen.", - "guide.open_practice_6": "Inställningar på Open Practice-raden i Race Setup: kortaste och längsta varv samt rankning – bästa varv, bästa N varv i följd (t.ex. 3) eller bästa X minuter (flest varv inom X minuter, t.ex. 5). Listan, overlayn, Race Day och resultaten visar t.ex. \"3 varv 52.341\" eller \"17 varv / 5:00.3\". Ett stopp i depån bryter \"i följd\".", + "guide.open_practice_6": "Inställningar på Open Practice-raden i Race Setup: kortaste och längsta varv samt rankning – bästa varv, bästa N varv i följd (t.ex. 3) eller bästa X minuter (flest varv inom X minuter, t.ex. 5). Listan, overlayn, Race Day och resultaten visar t.ex. \"3 varv 52.341\" eller \"17 varv / 5:00.3\". Ett stopp i depån bryter \"i följd\". Med bästa N varv eller X minuter visar overlayn bara placering, förare, stapeln för nästa varv, resultat, gap och bästa varv - samma korta vy som kval med seedning på bästa N varv.", "guide.team_title": "Lagrace / Endurance", "guide.team_1": "1. Skapa ett race i Race Setup med formatet Endurance (eller öppna ett befintligt race och välj Endurance under Format). Klicka Hantera.", "guide.team_2": "2. Panelen Lagrace: ange antal lag och tryck Fördela förarna – de valda förarna delas jämnt på lagen. Lägg till lag, byt namn direkt i lagkortet, lägg till förare från listan (den säger om föraren flyttas från ett annat lag) och ta bort med ×.", @@ -3355,7 +3355,7 @@ const TRANSLATIONS = { "guide.validation_8": "Domarvyn kan filtrera på ogiltiga rader, korrigerade rader eller teamrace, exportera domarloggen och ångra flera senaste manuella åtgärder via undo-knappar.", "guide.qualifying_title": "Seedning, poängtabeller och tie-break", "guide.qualifying_1": "Practice och kval kan nu använda tre seedmetoder: bästa N varv som summa, bästa N varv som snitt eller bästa N konsekutiva varv.", - "guide.qualifying_2": "Raceformat styr både Kval seedvarv och Kval seedmetod när nya kvalheat skapas från practice eller deltagarlistan.", + "guide.qualifying_2": "Raceformat styr både Kval seedvarv och Kval seedmetod när nya kvalheat skapas från practice eller deltagarlistan. Råkade du välja fel, t.ex. bästa 3 varv i stället för varv och tid: ändra i Raceformat så räknas även körda kval om (resultaten räknas från varven). Redan skapade finaler lottas inte om.", "guide.qualifying_3": "Kval-scoring kan kombinera poängläge med poängtabell: placeringstal, fallande efter fältstorlek eller IFMAR 10-9-8-7-6-5-4-3-2-1.", "guide.qualifying_4": "Tie-break i kvalrankingen kan avgöras på räknade rundor, bästa enskilda varv eller bästa runda/heatresultat.", "guide.qualifying_5": "Leaderboarden visar seedningsresultat i rätt format, till exempel 3/00:48.321, 3 avg 16.107 eller 3 con 00:49.005.", @@ -3374,7 +3374,7 @@ const TRANSLATIONS = { "guide.race_day_9": "9. Kör ni på ett nät där fler har åtkomst (t.ex. arenans WiFi)? Slå på Admin-PIN under Inställningar -> System & backup. Då kräver alla ändringar PIN - resultat, inställningar och uppdatering - medan visning och publika overlay-/träningslänkar fungerar som vanligt. Varje webbläsare loggar in en gång och kommer ihåg det i 30 dagar.", "guide.race_day_10": "10. Start med nedräkning (som EFRA/IFMAR): välj längd (Go, 30 s, 1, 1:30, 2, 3 eller 5 min - standard per tävling under Race Setup) och tryck Starta. Banan är öppen, speakern ropar ut tiden (varje minut, 30 s, 10 s; vid gridstart även \"bilarna till startplatsen\" vid 30 s och 10, 9 … 3). Pausa medan bilarna ställs upp, +1 min, Till 30 s (omstart av gridet), Till 10 s, Go nu eller Avbryt. När tiden går ut startar heatet av sig själv: gridstart får tystnad efter \"3\", startljus och tutan 1-3 s senare, flygande start ger signalen och \"Klockan går\". Transponderkontrollen visar grön bock för alla som passerat sedan nedräkningen började - saknas någon, byt transponder direkt i panelen eller välj en okänd transponder som passerat. Go nu varnar om någon inte setts.", "guide.race_day_11": "11. Dagens schema (längst ned på Race Day) visar alla klasser den dagen i en körordning med tider. Ange första start, paus mellan heaten, paus mellan omgångar (träning → kval, omgång → omgång) och paus före finaler (t.ex. lunch, räknas från att kvalet tog slut). ☕ på ett heat lägger in en extra paus före just det. ▲▼ ändrar ordningen. Ett heat som startar sent eller pausas flyttar resten av dagen. 🖨 Skriv ut körordning ger en lista med tider och förare att sätta upp på tavlan, och 📺 Förarvy (/public-overlay/schedule) visar förarna nästa heat och vilka som kör. Upprop: när ett heat har 10 minuter kvar (ändras under Upprop) frågar Race Day om du vill ropa upp det – 📢 Ropa ut läser upp heatet och förarna i högtalarna och markerar det Uppropad i förarvyn; Senare frågar igen om 2 minuter. ▶ Kör dagen automatiskt startar varje heats nedräkning själv när det är dags och ropar då upp heaten själv (den här webbläsaren måste vara öppen). Alla klasser samma dag körs i samma ordning: träning, kvalomgång för kvalomgång, sist finalerna. När kvalet är klart i en klass väntar den tills du har tryckt 🏁 Skapa finaler; ■ Stoppa automatiken låter dig köra för hand och sedan slå på den igen; ⏸ Pausa dagen pausar heatet på banan och automatiken tills du fortsätter.", - "guide.race_day_12": "12. Race-översikt (under heatkön): hela racet på ett ställe – pallen från A-finalen, sedan träning, kval och finaler med ställning och varje heats resultat (i sponsorheat även bilen). Skriv ut, PDF och CSV exporterar hela racet. Samma översikt finns i Resultatarkivet.", + "guide.race_day_12": "12. Race-översikt (under heatkön): hela racet på ett ställe – pallen från A-finalen, sedan träning, kval och finaler med ställning och varje heats resultat (i sponsorheat även bilen). Skriv ut, PDF och CSV exporterar hela racet med finalerna överst (A-finalen först), sedan kval och sist träning. Ett avslutat heat eller en final har egna knappar 🖨 och PDF för bara det heatet, t.ex. till tavlan i depån. Samma översikt finns i Resultatarkivet.", "guide.dashboard_title": "Schemaavvikelse på Översikt", "guide.dashboard_1": "Översikt visar nu skillnaden mellan planerad tid och faktisk körtid för alla startade sessioner.", "guide.dashboard_2": "Planerad tid räknar sessionstid plus follow-up. Faktisk tid räknar verklig tid från start till stopp eller nuvarande tid om heatet fortfarande kör.", @@ -5576,9 +5576,9 @@ const TRANSLATIONS = { "guide.audio_4": "4. The official race clock starts in the same callback as the start tone. Only Quick Open Practice and free practice start immediately without the race sequence - a scheduled \"Practice\" session inside a race/sponsor event gets the same countdown, lights, and start tone as qualifying/heat/final.", "guide.audio_5": "5. The speaker panel is on Race Day (under the start buttons) and in Judging: 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, leader calls, practice hype and the speaker cues. Critical announcements interrupt lower-priority speech.", "guide.audio_6": "6. Drivers and Cars can select pass_01.wav through pass_08.wav. A missing file uses the default; add short custom files under rc-race-sound-pack/sounds/effects/.", - "guide.audio_7": "7. Personal best, fastest lap, track record, leader changes, time warnings, pit entry/exit, finish, and podium reuse existing timing events. The time is said as seconds and hundredths, for example 18 sixty-three. Lap time at each passing (17 six, 18 flat) is practice only until you choose Practice and races.", + "guide.audio_7": "7. Personal best, fastest lap, track record, leader changes, time warnings, pit entry/exit, finish, and podium reuse existing timing events. The time is said as seconds and hundredths, for example 18 sixty-three. Lap time at each passing (17 six, 18 flat) is practice only until you choose Practice and races. New leader in practice can be turned off (Settings or the Race Day sound panel), since nobody races anyone there; the other practice calls stay.", "guide.audio_8": "8. Audio plays in the operator browser. Use Test before racing, verify the audio output, and keep the Timing tab open.", - "guide.audio_9": "9. A staggered start in a qualifying heat calls out each car's transponder number in grid order, about 3 seconds apart, right after the official start - a mass/position start never calls out individual cars.", + "guide.audio_9": "9. Heat call and staggered start: Auto (default) calls car numbers in finals (Car 1, 2, 3) and names otherwise; or choose Names, Car numbers or Car number + name (car 5 Anders) in Settings or the Race Day sound panel. The car number is the grid slot. A staggered start calls each car in grid order, about 3 seconds apart, right after the start - a mass/position start never calls out individual cars.", "guide.audio_10": "10. Better voice without internet: under Settings -> Audio -> Voice engine, click Install once (downloads Piper plus Swedish and English voices, needs internet just then) and choose Local voice. Pick a male or female voice per language under Swedish voice / English voice and listen with Test the voice. Then click Pre-generate phrases and driver names before race day. Everything then runs locally; if Piper is missing or slow the browser voice is used automatically.", "guide.sim_title": "Testing without a decoder (simulator)", "guide.sim_1": "1. Settings → Connection → Decoder simulator → Start. It replaces AMMC and the MyLaps decoder (works on Linux, Windows and a laptop without a decoder). The app switches to the simulator's address (port 9099) and connects; Stop puts the real decoder address back.", @@ -5594,7 +5594,7 @@ const TRANSLATIONS = { "guide.sponsor_6": "6. When qualifying is done: Create finals from qualifying. Cars are drawn for the finals.", "guide.sponsor_7": "7. In Manage the sponsor setup comes first and the list of heats below. Adding a heat by hand is folded further down. To try it without a club register: test-data/ in RaceCore has drivers, cars and guest names to import. During the heat the car is shown next to each driver (🚗) on the overlay and on Race Day.", "guide.race_title": "Create regular race (driver transponders)", - "guide.race_1": "1. Add drivers with personal transponder IDs. The brand field can be used for team, sponsor or car brand.", + "guide.race_1": "1. Add drivers with personal transponder IDs. The brand field can be used for team, sponsor or car brand. The driver list is grouped per class and can be filtered to one class, searched and sorted (name, class, club, transponder, brand). Tick several drivers and press Delete selected to remove them in one go, after a confirm.", "guide.race_2": "2. Create event in Race mode.", "guide.race_3": "3. Click Manage on the race and select exactly which drivers should be valid for this race.", "guide.race_4": "4. Go through Race Format and choose qualifying rounds, drivers per heat, times, start mode and how finals should be seeded.", @@ -5632,7 +5632,7 @@ const TRANSLATIONS = { "guide.open_practice_3": "Open Practice does not affect seeding, qualifying or finals.", "guide.open_practice_4": "Go to Race Setup and use Quick Open Practice. Only a name is required; class, participants, preset and race duration are not needed.", "guide.open_practice_5": "Easiest: press Start practice on the Dashboard or Race Day - it continues a running Open Practice or creates and starts a new one. Reset – new practice day on Race Day clears the day's laps without losing statistics, and New track layout is among the quick actions.", - "guide.open_practice_6": "Settings on the Open Practice row in Race Setup: shortest and longest lap and the ranking - best lap, best N laps in a row (e.g. 3) or best X minutes (most laps inside X minutes, e.g. 5). The list, the overlay, Race Day and the results show e.g. \"3 laps 52.341\" or \"17 laps / 5:00.3\". A stop in the pits breaks \"in a row\".", + "guide.open_practice_6": "Settings on the Open Practice row in Race Setup: shortest and longest lap and the ranking - best lap, best N laps in a row (e.g. 3) or best X minutes (most laps inside X minutes, e.g. 5). The list, the overlay, Race Day and the results show e.g. \"3 laps 52.341\" or \"17 laps / 5:00.3\". A stop in the pits breaks \"in a row\". With best N laps or X minutes the overlay shows only position, driver, the next-lap bar, result, gap and best lap - the same short view as a qualifier seeded on the best N laps.", "guide.team_title": "Team Race / Endurance", "guide.team_1": "1. Create a race in Race Setup with the Endurance format (or open a race and pick Endurance under Format). Click Manage.", "guide.team_2": "2. The Team race panel: set the number of teams and press Split the drivers - the chosen drivers are shared evenly over the teams. Add a team, rename it right in its card, add drivers from the list (it says when a driver moves from another team) and remove with ×.", @@ -5651,7 +5651,7 @@ const TRANSLATIONS = { "guide.validation_8": "The Judging view can filter invalid rows, corrected rows or team race rows, export the judging log and undo multiple recent manual actions via undo buttons.", "guide.qualifying_title": "Seeding, points tables and tie-break", "guide.qualifying_1": "Practice and qualifying can now use three seed methods: best N laps as total, best N laps as average or best N consecutive laps.", - "guide.qualifying_2": "Race format controls both Qualifying seed laps and Qualifying seed method when new qualifying heats are generated from practice or the participant list.", + "guide.qualifying_2": "Race format controls both Qualifying seed laps and Qualifying seed method when new qualifying heats are generated from practice or the participant list. Picked the wrong one, e.g. best 3 laps instead of laps and time? Change it in Race format and the qualifiers already run are re-ranked too (results are worked out from the laps). Finals already created are not redrawn.", "guide.qualifying_3": "Qualifying scoring can combine points mode with a points table: placement values, descending by field size or IFMAR 10-9-8-7-6-5-4-3-2-1.", "guide.qualifying_4": "Qualifying tie-break can now be resolved by counted rounds, best single lap or best round / heat result.", "guide.qualifying_5": "The leaderboard now shows seeded results in the correct format, for example 3/00:48.321, 3 avg 16.107 or 3 con 00:49.005.", @@ -5670,7 +5670,7 @@ const TRANSLATIONS = { "guide.race_day_9": "9. Running on a network others can reach (e.g. the venue WiFi)? Turn on the Admin PIN under Settings -> System & backup. Every change then needs the PIN - results, settings and updates - while viewing and public overlay/training links work as usual. Each browser logs in once and is remembered for 30 days.", "guide.race_day_10": "10. Start with a count-down (as EFRA/IFMAR): pick a length (Go, 30 s, 1, 1:30, 2, 3 or 5 min - the default per event is set in Race Setup) and press Start. The track is open and the announcer calls the time (every minute, 30 s, 10 s; for a grid start also \"cars to the grid\" at 30 s and 10, 9 … 3). Hold while cars are placed on the grid, +1 min, To 30 s (grid restart), To 10 s, Go now or Cancel. When the time runs out the heat starts by itself: a grid start gets quiet after \"3\", the start lights and the horn 1-3 s later, a flying start gets the signal and \"Clock is running\". The transponder check shows a green tick for everyone who has crossed since the count-down began - if someone is missing, change their transponder right in the panel or pick an unknown transponder that crossed. Go now warns if someone wasn't seen.", "guide.race_day_11": "11. Today's schedule (at the bottom of Race Day) shows every class that day in one running order with times. Set the first start, the break between heats, the break between rounds (practice → qualifying, round → round) and the break before the finals (e.g. lunch, counted from the end of qualifying). ☕ on a heat adds an extra break before just that heat. ▲▼ change the order. A heat that starts late or is paused moves the rest of the day. 🖨 Print running order gives a list with times and drivers for the board in the pits, and 📺 Drivers' board (/public-overlay/schedule) shows drivers the next heats and who drives them. Calls: when a heat is 10 minutes away (set under Call), Race Day asks whether to call it – 📢 Call now reads the heat and its drivers over the speakers and marks it Called on the drivers' board; Later asks again in 2 minutes. ▶ Run the day automatically starts each heat's count-down on its own when it is due and then calls the heats itself (keep this browser open). Every class on the day runs in the same order: practice, qualifying round by round, finals last. When a class's qualifying is done it waits until you press 🏁 Create finals; ■ Stop autopilot lets you run heats by hand and turn it back on later; ⏸ Pause the day pauses the heat on track and the autopilot until you resume.", - "guide.race_day_12": "12. Race overview (under the heat queue): the whole race in one place - the podium from the A final, then practice, qualifying and finals with the standings and every heat's result (with the car in sponsor heats). Print, PDF and CSV export the whole race. The same overview is in the Results archive.", + "guide.race_day_12": "12. Race overview (under the heat queue): the whole race in one place - the podium from the A final, then practice, qualifying and finals with the standings and every heat's result (with the car in sponsor heats). Print, PDF and CSV export the whole race with the finals on top (A final first), then qualifying, then practice. A finished heat or final has its own 🖨 and PDF buttons for just that heat, e.g. for the board in the pits. The same overview is in the Results archive.", "guide.dashboard_title": "Schedule drift on overview", "guide.dashboard_1": "Overview now shows the difference between planned time and actual elapsed time for all started sessions.", "guide.dashboard_2": "Planned time includes session duration plus follow-up. Actual time uses real time from start to stop, or the current time if the heat is still running.",