diff --git a/CHANGELOG.md b/CHANGELOG.md index 90c2eeb..eb4b261 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,10 @@ The application version is maintained in `package.json` and displayed in the adm No changes recorded yet. +## 1.69.1 + +- Guide and README brought up to date: team race setup, race overview, the results archive per race, Open Practice settings and ranking, the speaker panel on Race Day and Judging, the sponsor event flow, practice and leader calls, and a new guide section "Testing without a decoder" for the simulator and the test-data/ files. + ## 1.69.0 - Speaker panel moved from Timing to Race Day (under the start controls) and Judging (on top), where the race is run: track call, track clear, red flag, pause, resume, false start and marshal warning. Under "Sound and calls" it also has quick switches that save at once: mute all sound, lap time calls, race leader calls, practice hype and the speaker cues. diff --git a/README.md b/README.md index f121a5d..00182d0 100644 --- a/README.md +++ b/README.md @@ -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/`. diff --git a/README.sv.md b/README.sv.md index 82cd4f2..d7ecd88 100644 --- a/README.sv.md +++ b/README.sv.md @@ -125,6 +125,8 @@ GrĂ€nssnittet finns pĂ„ svenska och engelska. - **Upprop:** nĂ€r ett heat har 10 minuter kvar (Ă€ndras under **Upprop**) frĂ„gar Race Day race controllern: **đą Ropa ut** lĂ€ser upp heatet och förarna i högtalarna och markerar det i förarvyn; **Senare** frĂ„gar igen om 2 minuter. NĂ€r automatiken Ă€r pĂ„ ropas heaten upp av sig sjĂ€lva. - **â¶ Kör dagen automatiskt** startar varje heats nedrĂ€kning sjĂ€lv nĂ€r schemat sĂ€ger det, och vĂ€ntar (och sĂ€ger varför) medan ett heat körs, decodern Ă€r frĂ„nkopplad eller ett heat inte Ă€r redo. Den körs bara i webblĂ€saren dĂ€r den slogs pĂ„. **â Stoppa automatiken** för att köra för hand; slĂ„r du pĂ„ den igen fortsĂ€tter den med nĂ€sta heat som inte Ă€r kört. **âž Pausa dagen** pausar heatet pĂ„ banan (eller hĂ„ller nedrĂ€kningen) och automatiken tills **FortsĂ€tt dagen**. - **Heat-kön** visar aktuellt, nĂ€sta och dĂ€rpĂ„ följande heat i körordning: trĂ€ning, kval omgĂ„ng för omgĂ„ng (Q1 H1, Q1 H2, Q2 H1 âŠ), sedan finaler frĂ„n lĂ€gsta (C, B, A). NĂ€r ett heat Ă€r klart vĂ€ljer **â¶ NĂ€sta** nĂ€sta heat med ett klick. Sessionslistorna i Race Setup och pĂ„ Race Day följer samma ordning, sĂ„ ett heat som tagits bort och skapats om hamnar pĂ„ rĂ€tt plats; **âČâŒ** pĂ„ en session i Race Setup flyttar den tidigare eller senare. +- **Race-översikt** (under heatkön): hela racet för det aktuella eventet pĂ„ ett stĂ€lle â pallen frĂ„n A-finalen, sedan trĂ€ning, kval och finaler som kan fĂ€llas ut, var och en med stĂ€llning och varje heats resultat (varv, resultat, bĂ€sta varv, och bilen i sponsorheat). **Skriv ut**, **PDF** och **CSV** exporterar hela racet med alla heat. +- **Speakerpanel** (under startknapparna): 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. - **Förkontrollen** kontrollerar decoder, deltagare, transpondrar (saknade eller dubbletter), varvtidsgrĂ€nser, grid och ljud. Blockerare visas först, var och en med en genvĂ€g till rĂ€tt instĂ€llning. Min/max-varvtid kan Ă€ndras direkt dĂ€r. - **En automatisk SQLite-backup** tas före varje start. @@ -147,9 +149,9 @@ GrĂ€nssnittet finns pĂ„ svenska och engelska. - **Transponderkontroll:** varje förare i heatet fĂ„r en grön bock nĂ€r transpondern passerar under nedrĂ€kningen. Saknas nĂ„gon kan transpondern bytas direkt i panelen, eller kopplas till en okĂ€nd transponder som just passerat. - **Paus, fortsĂ€tt och avsluta** fungerar under heatet. Follow-up-tid lĂ„ter sista varvet köras klart efter klockan. -**Tidtagning** visar livetopplistan (varv, gap till ledaren och framför, eget delta, bĂ€sta och senaste varv), senaste passeringar med ogiltiga korta varv markerade, grid vid positionsstart, repris av sessionen (1-10x) och speakerpanelen. +**Tidtagning** visar livetopplistan (varv, gap till ledaren och framför, eget delta, bĂ€sta och senaste varv), senaste passeringar med ogiltiga korta varv markerade, grid vid positionsstart, och repris av sessionen (1-10x). -**Domare** Ă€r platsen för korrigeringar i race: ±varv, ±sekunder och nollstĂ€ll, samt ta bort eller Ă„terstĂ€lla vilket varv som helst. Allt loggas med tid och kan Ă„ngras; loggen kan exporteras som JSON. I kval, heat och final Ă€r Domarvyn enda stĂ€llet för straff; Tidtagning visar korrigeringarna och har knappen **Ăppna i Domarvyn**. TrĂ€ning har inga straff, men varv kan stĂ€das direkt i Tidtagning (se [trĂ€ning](#trĂ€ning-och-trĂ€ningsstatistik)). +**Domare** har speakerpanelen överst och Ă€r platsen för korrigeringar i race: ±varv, ±sekunder och nollstĂ€ll, samt ta bort eller Ă„terstĂ€lla vilket varv som helst. Allt loggas med tid och kan Ă„ngras; loggen kan exporteras som JSON. I kval, heat och final Ă€r Domarvyn enda stĂ€llet för straff; Tidtagning visar korrigeringarna och har knappen **Ăppna i Domarvyn**. TrĂ€ning har inga straff, men varv kan stĂ€das direkt i Tidtagning (se [trĂ€ning](#trĂ€ning-och-trĂ€ningsstatistik)). Varvkontroll: - **Minsta varvtid** stoppar genvĂ€gar och falska trĂ€ffar. @@ -163,10 +165,15 @@ Varvkontroll: **Racelistan** Ă€r grupperad sĂ„ att den hĂ„lls kort: **Idag** (och det som pĂ„gĂ„r), **Kommande**, och **Körda** ihopfĂ€llt (race dĂ€r alla heat Ă€r körda eller datumet har passerat). Race samma datum ligger ihop, var och ett med hur lĂ„ngt det kommit (â pĂ„gĂ„ende heat, *NĂ€sta: Q2 H1*, *3/9 körda* eller â Klar). En sökruta hittar Ă€ldre race. -I **Hantera** Ă€r sessionerna grupperade per steg: trĂ€ning / seedning, varje kvalomgĂ„ng, finaler. Ett steg dĂ€r alla heat Ă€r körda fĂ€lls ihop till en rad (â Kval omgĂ„ng 1 · 3/3 körda) och öppnas med ett klick. Varje session visar âČâŒ, Ăndra och SĂ€tt aktiv; utskrift, export, grid och ta bort finns under **âŻ**. +I **Hantera** kommer den enkla setupen först (racets steg och flikar, eller sponsor-setupen), sedan listan med heat; **LĂ€gg till heat manuellt (avancerat)** och varumĂ€rket Ă€r hopfĂ€llda. Sessionerna Ă€r grupperade per steg: trĂ€ning / seedning, varje kvalomgĂ„ng, finaler. Ett steg dĂ€r alla heat Ă€r körda fĂ€lls ihop till en rad (â Kval omgĂ„ng 1 · 3/3 körda) och öppnas med ett klick. Varje session visar âČâŒ, Ăndra och SĂ€tt aktiv; utskrift, export, grid och ta bort finns under **âŻ**. Efter det hanteras racet i fyra flikar (Race Setup â Hantera): -- **Deltagare & lag:** bocka i vilka som kör, och hantera lag för endurance. +- **Deltagare & lag:** bocka i vilka som kör. För endurance finns panelen **Lagrace** (visas sĂ„ fort formatet Endurance Ă€r valt): + - **Fördela förarna** pĂ„ N lag med ett klick, lĂ€gg till lag, byt namn i lagkortet, lĂ€gg till förare frĂ„n en lista som sĂ€ger vilket lag de flyttas frĂ„n, ta bort med Ă; + - **en bil per lag** (förarna delar dess transponder) eller förarnas egna transpondrar; + - **lĂ€ngd** med snabbval 30 min till 24 h, och **Skapa lagrace**; + - **kontroll före start:** fĂ€rre Ă€n tvĂ„ lag, lag utan förare eller transponder, samma transponder i tvĂ„ lag, förare utan lag. + - Kör det pĂ„ Race Day. Förarna byter nĂ€r packet Ă€r slut â inga regler för förarbyten. Lag, bilar och lĂ€ngd kan Ă€ndras under racet (trasig bil, fel transponder): varven stannar hos laget. **Overlay â Team** visar topp 3 med aktiv förare och lagstĂ€llningen. - **Format:** - kvalomgĂ„ngar, bilar per heat, tid och starttyp (mass, position, staggered, flygande); - seedning (bĂ€sta N varv sammanlagt, snitt eller i följd); @@ -186,7 +193,7 @@ Efter det hanteras racet i fyra flikar (Race Setup â Hantera): - sammanfattning av split- och depĂ„tider. - **Schema & utskrift:** dagens körordning med planerade tider, och heatlistor. -**Ăversikt** visar schemaavvikelse (planerad mot faktisk tid). **Resultatarkivet** hittar avslutade race utan att gĂ„ via Race Setup. +**Ăversikt** visar schemaavvikelse (planerad mot faktisk tid). **Resultatarkivet** visar ett race per rad; vĂ€lj ett för att se race-översikten, dess heat och exporterna (utskrift, PDF, CSV, racepaket), och öppna ett heat för varv och straff. ### Serie / cup @@ -220,6 +227,7 @@ Menyn **Serier / cup** kör ett mĂ€sterskap över valfritt antal deltĂ€vlingar, **TrĂ€ningspass:** - Open Practice kan köras hela sĂ€songen; Free Practice rankar pĂ„ bĂ€sta varv. +- **InstĂ€llningar** pĂ„ Open Practice-raden i Race Setup: kortaste och lĂ€ngsta varv och **rankning** â bĂ€sta varv (standard), **bĂ€sta N varv i följd** (t.ex. 3) eller **bĂ€sta X minuter** (flest varv inom X minuter, sedan kortast tid, t.ex. 5). Tidtagning, overlayn, Race Day och resultaten visar t.ex. "3 varv 52.341" eller "17 varv / 5:00.3"; bĂ€sta varv har kvar sin egen kolumn. Ett stopp i depĂ„n bryter "i följd". - **Starta trĂ€ning** pĂ„ Ăversikten eller Race Day fortsĂ€tter pĂ„gĂ„ende Open Practice, eller skapar och startar en. **NollstĂ€ll â ny trĂ€ningsdag** pĂ„ Race Day nollstĂ€ller dagens varv inför en ny kvĂ€ll; alla varv finns kvar i trĂ€ningsstatistiken. **Banlayouter:** @@ -255,6 +263,9 @@ InstĂ€llningar â Ljud: - startljus, slumpad startfördröjning och passeringsljud (valfritt olika ton per förare/bil); - utrop pĂ„ svenska eller engelska för start, klocka (1 min, 30 s, 10 s), sista varv, mĂ„lgĂ„ng, vinnare och pall, depĂ„, straff och tĂ€vlingsledning (stopp pĂ„ banan, röd flagga, tjuvstart, marshal); - varje hĂ€ndelse kan slĂ„s pĂ„ eller av för effekt och röst. +- **TĂ€vlingsledningens utrop** finns pĂ„ speakerpanelen pĂ„ Race Day och i Domare, med snabbval för utropen nedan. +- **TrĂ€ning:** snabbt varvtidsutrop vid varje passering ("17 six", "18 flat", valfritt med namn), tempo- och pepputrop (slog förra gĂ„ngen, plats i klassen, varvjubileum, snabbare i rad, snittet ner, nĂ€ra bĂ€sta, dueller). Av i kval och finaler. +- **Ledarutrop i race:** vid bekrĂ€ftat ledarbyte och dĂ„ och dĂ„ (bĂ„da, bara byte eller av). - **Utrop under race:** "Bara passeringsljud" (standard, som tidtagningssystem) eller "Speaker" med namn, personbĂ€sta och ny ledare. TrĂ€ning fĂ„r alltid alla utrop. - **Lokal neural röst (Piper):** gratis och fungerar offline. Installera under InstĂ€llningar â Ljud â Röstmotor, eller med `npm run tts:install`. - Standardröster: svenska NST (man) och Lisa (kvinna), engelska Ryan (man) och Lessac (kvinna). @@ -274,9 +285,12 @@ Menyn **Overlay** har lĂ€gena leaderboard, speaker, resultat, TV och lag, plus e ### Sponsorevent med delade bilar -**Sponsor Event** lĂ„ter mĂ„nga förare dela pĂ„ nĂ„gra fĂ„ bilar och transpondrar, till exempel 10 förare och 4 bilar: -- omgĂ„ngar skapas automatiskt och förarna tilldelas bilar per session; -- inom en session mĂ„ste varje bil ha en unik transponder, men samma transponder kan anvĂ€ndas igen i nĂ€sta session. +**Sponsor Event** lĂ„ter gĂ€ster köra klubbens bilar, som hyrgokart â t.ex. 8 förare pĂ„ 4 bilar. Event â Hantera: +1. **Förare:** skriv namnen, ett per rad. De blir gĂ€ster i bara det hĂ€r eventet (aldrig i vanliga race eller trĂ€ning) och tas bort med det. +2. **Bilar:** bocka i bilarna, eller lĂ€gg till en med namn och transponder. +3. **Format:** trĂ€ning per grupp, kvalomgĂ„ngar, kvalstart (staggered, flygande, mass) och lĂ€ngder. 8 förare och 4 bilar ger 2 grupper, 1 trĂ€ning per grupp, 2 kvalomgĂ„ngar och A/B-final. **Skapa heat**: förarna byter bil varje omgĂ„ng. +4. Kör heaten pĂ„ **Race Day** som ett race (â¶ NĂ€sta, Start, Paus, Stopp, nedrĂ€kning, startsignal och utrop). Bilens transponder rĂ€knas för den som kör den i heatet. +5. **Skapa finaler** frĂ„n kvalet; bilarna lottas i finalerna. Race-översikten och resultatarkivet visar bilen per förare och heat. ### Data, backup och export/import @@ -446,6 +460,8 @@ AMMC skickar PASSING-meddelanden sĂ„ hĂ€r ([AMMC-dokumentation](https://www.ammc InstĂ€llningar â "Decoder-simulator" startar den frĂ„n UI (port 9099, appen ansluter sjĂ€lv). FrĂ„n en terminal startar `npm run sim` en decoder-simulator pĂ„ `ws://127.0.0.1:9000` (appens standardadress för decodern) som ersĂ€tter AMMC och decodern, sĂ„ den fungerar Ă€ven pĂ„ en laptop utan dem. Den skickar passeringar med realistiska varvtider (runt 18 s, en krasch ibland) för transpondrarna i det aktiva heatet (sponsorheat: bilarna) och följer med nĂ€r du byter heat. Starta heatet pĂ„ Race Day sĂ„ kommer varven. Val: `npm run sim -- --lap 15 --spread 2 --tp 1001,1002 --port 9000`. Ăr port 9000 upptagen (AMMC körs) stoppar du AMMC eller kör `--port 9100` och sĂ€tter decoderadressen till `ws://127.0.0.1:9100`. +**Testdata:** `test-data/` har 12 förare (`drivers.csv`), 4 hyrbilar (`cars.csv`) och 8 gĂ€stnamn (`sponsor-gaster.txt`). Importera CSV-filerna under InstĂ€llningar â System & backup (Importera förare CSV / Importera bilar CSV), klistra in namnen i ett sponsorevent och kör med simulatorn. + ## Utveckling och tester - **Enhets-, logik- och API-tester:** `npm test`. SQLite-integrationstesterna startar en egen server mot en tillfĂ€llig databas och rör aldrig `data/`. diff --git a/package-lock.json b/package-lock.json index 8028309..4793004 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "rc-racecore", - "version": "1.69.0", + "version": "1.69.1", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "rc-racecore", - "version": "1.69.0", + "version": "1.69.1", "hasInstallScript": true, "dependencies": { "better-sqlite3": "^12.11.1", diff --git a/package.json b/package.json index 42b4051..52fd55f 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "rc-racecore", - "version": "1.69.0", + "version": "1.69.1", "private": true, "description": "RC RaceCore live timing and race control with AMMC ingest and SQLite persistence", "engines": { diff --git a/src/app.js b/src/app.js index 574adc4..c899c90 100644 --- a/src/app.js +++ b/src/app.js @@ -2920,7 +2920,7 @@ const TRANSLATIONS = { "guide.intro": "HĂ€r finns steg-för-steg för sponsor-event, vanligt race, trĂ€ningsstatistik och Create Race Wizard i Race Setup. Guiden beskriver ocksĂ„ hur Hantera-flödet Ă€r uppdelat samt var AMMC faktiskt körs i Managed AMMC-lĂ€get.", "guide.card_sponsor_blurb": "Delade bilar, roterande förare och heat/finaler för sponsor- och prova-pĂ„-event.", "guide.card_race_blurb": "Personliga transpondrar, kval/finaler, raceformat och seedning för riktiga tĂ€vlingsrace.", - "guide.card_team_blurb": "Lagrace och endurance med team, stintlogg och summerade varv över lĂ„ng tid.", + "guide.card_team_blurb": "Lagrace och endurance: lag, bil per lag, lĂ€ngd i timmar, kontroll före start och lag-overlay.", "guide.card_training_blurb": "Förarutveckling, bestĂ€ndig varvhistorik, trĂ€ningsmĂ„l och belöningar i mobilvĂ€nlig vy.", "guide.card_decoder_blurb": "AMMC, backend, WebSocket, Windows/Linux och lokal SQLite-lagring.", "guide.audio_title": "Raceljud, startljus och race control", @@ -2928,12 +2928,17 @@ const TRANSLATIONS = { "guide.audio_2": "2. Aktivera effekt och röst separat för varje event. Testknappen pĂ„ raden provar exakt det eventet; saknade WAV-filer hoppas över eller anvĂ€nder passing-fallback.", "guide.audio_3": "3. VĂ€lj 0, 10, 30 eller 60 sekunders förstart. För race följer sedan Förare gör er redo, startfras, fem startljus, slumpad vĂ€ntan och startton.", "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. Under Tidtagning finns manuella knappar för Stopp pĂ„ banan, Banan fri, Röd flagg, felaktig start och banvaktsvarning. Kritiska utrop avbryter lĂ€gre prioriterat tal.", + "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.", "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_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.", + "guide.sim_2": "2. VĂ€lj ungefĂ€rlig varvtid och spridning mellan bilarna. Simulatorn kör transpondrarna i det aktiva heatet (i sponsorheat bilarna) med realistiska varv och en krasch ibland, och följer med nĂ€r du byter heat. Utan heat kör den klubbens förare eller 9001â9004.", + "guide.sim_3": "3. Starta heatet pĂ„ Race Day som vanligt â nedrĂ€kning, start, utrop, overlay och resultat fungerar som med en riktig decoder. Simulatorn startar om av sig sjĂ€lv nĂ€r servern startas om (npm restart).", + "guide.sim_4": "4. Testdata: mappen test-data/ har 12 förare, 4 hyrbilar och 8 gĂ€stnamn. Importera förare och bilar under InstĂ€llningar â System & backup, klistra in gĂ€stnamnen i ett sponsorevent, starta simulatorn och kör. FrĂ„n terminalen: npm run sim (port 9000, val --lap, --spread, --tp, --port).", "guide.sponsor_title": "Skapa Sponsor Event: 10 personer, 4 bilar", "guide.sponsor_1": "1. Skapa eventet under Event (Sponsor Event) och klicka Hantera.", "guide.sponsor_2": "2. Skriv in förarnas namn, ett per rad. De blir gĂ€ster som bara finns i det hĂ€r eventet och tas bort med det.", @@ -2941,6 +2946,7 @@ const TRANSLATIONS = { "guide.sponsor_4": "4. VĂ€lj format: practice per grupp, kvalomgĂ„ngar, starttyp i kvalet och lĂ€ngder. 8 förare och 4 bilar ger 2 grupper, A- och B-final. Klicka Skapa heat. Förarna byter bil varje omgĂ„ng.", "guide.sponsor_5": "5. Kör heaten pĂ„ Race Day med â¶ NĂ€sta, Start, Paus och Stopp, med nedrĂ€kning, startljud och utrop som i ett race.", "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.", "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_2": "2. Skapa event med lĂ€ge Race.", @@ -2980,13 +2986,14 @@ 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.team_title": "Lagrace / Endurance", - "guide.team_1": "GĂ„ till Race Setup och skapa ett race i rĂ€tt klass.", - "guide.team_2": "Ăppna Hantera och gĂ„ till sektionen Lag.", - "guide.team_3": "Skriv lagnamn och kryssa förare och/eller bilar i samma teamblock innan du klickar LĂ€gg till lag.", - "guide.team_4": "Efter att laget skapats kan du klicka Redigera lag för att Ă€ndra förare eller bilar.", - "guide.team_5": "Skapa en session med typ Team Race och sĂ€tt tiden, t.ex. 240 minuter för 4 timmar.", - "guide.team_6": "Starta sessionen i Tidtagning. Alla passeringar frĂ„n lagets medlemmar summeras till lagets totalvarv.", + "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 Ă.", + "guide.team_3": "3. VĂ€lj en bil per lag â lagets förare delar dess transponder â eller Förarnas egna transpondrar. Kortet visar vilka transpondrar som rĂ€knas för laget.", + "guide.team_4": "4. VĂ€lj lĂ€ngd: snabbval 30 min, 1, 2, 4, 6, 12 eller 24 h, eller skriv minuter. Tryck Skapa lagrace. Kontrollen nedanför varnar för fĂ€rre Ă€n tvĂ„ lag, lag utan förare eller transponder, samma transponder i tvĂ„ lag och förare som inte Ă€r med i nĂ„got lag.", + "guide.team_5": "5. Starta lagracet pĂ„ Race Day (Start, Paus, Avsluta). Förarna byter nĂ€r packet Ă€r slut â inga regler behövs. GĂ„r en bil sönder eller valdes fel transponder: byt bil eller förare i panelen medan racet pĂ„gĂ„r. Varven som körts stannar hos laget, Ă€ndringen gĂ€ller frĂ„n nĂ€sta passering. LĂ€ngden kan ocksĂ„ Ă€ndras under racet.", + "guide.team_6": "6. Overlay â Team visar lagen: topp 3 med aktiv förare, varv, snabbaste varv och lagstĂ€llningen â före start visas lagen med sina förare. Alla passeringar frĂ„n lagets bil och förare summeras till lagets varv.", "guide.validation_title": "Ogiltiga varv, follow-up och manuella korrigeringar", "guide.validation_1": "Senaste passeringar visar ogiltiga shortcuts som För kort varv. Passeringar över max markeras LĂ„ngt varv · rĂ€knat · ny stint och ligger kvar i raceresultatet.", "guide.validation_2": "Ogiltiga kortvarv under min-grĂ€nsen rĂ€knas inte alls i leaderboard eller statistik.", @@ -3017,6 +3024,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 och paus mellan heaten; âČâŒ Ă€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); â 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.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.", @@ -3055,11 +3063,11 @@ const TRANSLATIONS = { "guide.training_30": "30. Genomförda pass (timer, JĂ€mna varv och StegtrĂ€ning) sparas permanent under Genomförda trĂ€ningspass, bĂ„de pĂ„ förarens mobilprofil och hĂ€r i admin - sĂ„ gammal utveckling gĂ„r att titta tillbaka pĂ„. En genomförd session verifieras alltid mot förarens riktiga varvdata innan den sparas, den kan aldrig bara pĂ„stĂ„s av mobilsidan.", "guide.training_31": "31. DelmĂ„l och klubbmĂ„l kan vĂ€ljas som antingen antal varv eller antal genomförda pass av en viss övningstyp (t.ex. 10 genomförda StegtrĂ€ning-pass mot en belöning) - samma belöningsflöde funkar för bĂ„da typerna.", "guide.archive_title": "Resultatarkiv", - "guide.card_archive_blurb": "Sök och öppna avslutade race pĂ„ datum, klass eller förare utan att gĂ„ via Race Setup.", - "guide.archive_1": "1. Ăppna Resultatarkiv i menyn för att se alla avslutade sessioner samlade, oavsett vilket event de tillhör.", - "guide.archive_2": "2. Sök pĂ„ event- eller sessionsnamn, eller filtrera pĂ„ klass, förare och datumintervall.", - "guide.archive_3": "3. Klicka Visa pĂ„ en rad för att se resultat, straff/korrigeringar och varvhistorik per förare för den sessionen.", - "guide.archive_4": "4. Exportera samma PDF- och racepaket (JSON)-filer som redan finns i Manage Event, direkt frĂ„n arkivet.", + "guide.card_archive_blurb": "Ett race per rad: vĂ€lj racet och se hela översikten, alla heat och exportera.", + "guide.archive_1": "1. Ăppna Resultatarkiv i menyn. Varje race (event) Ă€r en rad med datum, klass, antal heat, förare och vinnare.", + "guide.archive_2": "2. Sök pĂ„ race- eller heatnamn, eller filtrera pĂ„ klass, förare och datumintervall.", + "guide.archive_3": "3. Klicka Visa pĂ„ ett race: Race-översikten visar pallen, och trĂ€ning, kval och finaler med stĂ€llning och varje heats resultat. Skriv ut, PDF och CSV exporterar hela racet. Under listan med heat öppnar Visa ett heat med varvhistorik och straff.", + "guide.archive_4": "4. Racepaket (JSON) exporteras frĂ„n racets rad i arkivet.", "guide.archive_5": "5. Att radera ett event eller en session tar bort racets data överallt, inklusive de rĂ„a varvraderna i databasen - men pĂ„verkar aldrig förarens bestĂ€ndiga trĂ€ningsstatistik, som redan sparas separat.", "guide.archive_6": "6. Kör klubben pĂ„ flera banlayouter (t.ex. inomhus i samma lokal) - tryck Ny layout (pĂ„ TrĂ€ningsstatistik, Race Day eller Ăversikt) nĂ€r banan byggts om; det gĂ„r Ă€ven mitt i ett pĂ„gĂ„ende Open Practice. Arkivet visar vilken layout varje session kördes pĂ„, och personbĂ€sta/banrekord jĂ€mförs bara mot samma layout. Under TrĂ€ningsstatistik och i förarens mobilprofil vĂ€ljer du Statistik för: aktiv layout, en Ă€ldre layout eller Alla layouter.", "overlay.title": "Overlay", @@ -5008,7 +5016,7 @@ const TRANSLATIONS = { "guide.intro": "Step-by-step setup for sponsor events, regular race mode, training statistics and the Create Race Wizard in Race Setup. The guide also explains how the Manage flow is split up and where Managed AMMC actually runs.", "guide.card_sponsor_blurb": "Shared cars, rotating drivers and heat/final flow for sponsor or try-out events.", "guide.card_race_blurb": "Personal transponders, qualifying/finals, race format and seeding for competition racing.", - "guide.card_team_blurb": "Team race and endurance with teams, stint logs and total laps over long sessions.", + "guide.card_team_blurb": "Team race and endurance: teams, a car per team, length in hours, checks before the start and the team overlay.", "guide.card_training_blurb": "Driver development, durable lap history, practice goals and rewards in a mobile-friendly view.", "guide.card_decoder_blurb": "AMMC, backend, WebSocket, Windows/Linux and local SQLite storage.", "guide.audio_title": "Race audio, start lights, and race control", @@ -5016,12 +5024,17 @@ const TRANSLATIONS = { "guide.audio_2": "2. Enable effect and voice separately for every event. Each row has an exact event test; missing WAV files are skipped or use the passing fallback.", "guide.audio_3": "3. Select a 0, 10, 30, or 60 second pre-start. A race then runs drivers stand by, the start phrase, five start lights, random wait, and start tone.", "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. Timing provides manual controls for Track call, Track clear, Red flag, False start, and Marshal warning. Critical announcements interrupt lower-priority speech.", + "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.", "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_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.", + "guide.sim_2": "2. Pick a rough lap time and the spread between the cars. The simulator drives the transponders of the active heat (the cars in sponsor heats) with realistic laps and a crash now and then, and follows when you switch heat. With no heat it drives the club's drivers or 9001-9004.", + "guide.sim_3": "3. Start the heat on Race Day as usual - count-down, start, calls, overlay and results work as with a real decoder. The simulator starts again by itself when the server restarts (npm restart).", + "guide.sim_4": "4. Test data: the test-data/ folder has 12 drivers, 4 rental cars and 8 guest names. Import drivers and cars under Settings â System & backup, paste the guest names into a sponsor event, start the simulator and run. From a terminal: npm run sim (port 9000, options --lap, --spread, --tp, --port).", "guide.sponsor_title": "Create Sponsor Event: 10 drivers, 4 cars", "guide.sponsor_1": "1. Create the event under Events (Sponsor Event) and click Manage.", "guide.sponsor_2": "2. Enter the drivers' names, one per line. They become guests that only exist in this event and are deleted with it.", @@ -5029,6 +5042,7 @@ const TRANSLATIONS = { "guide.sponsor_4": "4. Choose the format: practice per group, qualifying rounds, qualifying start and lengths. 8 drivers and 4 cars make 2 groups, A and B finals. Click Create heats. Drivers swap cars every round.", "guide.sponsor_5": "5. Run the heats on Race Day with â¶ Next, Start, Pause and Stop, with count-down, start signal and calls as in a race.", "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.", "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_2": "2. Create event in Race mode.", @@ -5068,13 +5082,14 @@ 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.team_title": "Team Race / Endurance", - "guide.team_1": "Go to Race Setup and create a race in the correct class.", - "guide.team_2": "Open Manage and go to the Teams section.", - "guide.team_3": "Enter the team name and tick drivers and/or cars in the same team block before you click Add team.", - "guide.team_4": "After the team is created, click Edit team to change drivers or cars.", - "guide.team_5": "Create a session with type Team Race and set the time, for example 240 minutes for 4 hours.", - "guide.team_6": "Start the session in Timing. All passings from the team's members are added to the team's total laps.", + "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 Ă.", + "guide.team_3": "3. Pick a car per team - the team's drivers share its transponder - or The drivers' own transponders. The card shows which transponders count for the team.", + "guide.team_4": "4. Pick the length: quick picks 30 min, 1, 2, 4, 6, 12 or 24 h, or type minutes. Press Create team race. The check below warns about fewer than two teams, a team without drivers or transponder, one transponder on two teams and drivers on no team.", + "guide.team_5": "5. Start the team race on Race Day (Start, Pause, Finish). Drivers change when the pack is flat - no rules needed. A car breaks or the wrong transponder was picked: change the car or driver in the panel while the race runs. The laps already done stay with the team; the change counts from the next passing. The length can be changed during the race too.", + "guide.team_6": "6. Overlay â Team shows the teams: the top 3 with the active driver, laps, the fastest lap and the team standings - before the start the teams with their drivers. Every passing of the team's car and drivers adds to the team's laps.", "guide.validation_title": "Invalid laps, follow-up and manual corrections", "guide.validation_1": "Recent Passings shows invalid shortcuts as Short lap. Passings over max are marked Long lap · counted · new stint and remain in the race result.", "guide.validation_2": "Invalid short laps under the minimum threshold do not count in the leaderboard or statistics.", @@ -5105,6 +5120,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 and the break between heats; âČ⌠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); â 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.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.", @@ -5143,11 +5159,11 @@ const TRANSLATIONS = { "guide.training_30": "30. Completed sessions (timer, Even laps and Step training) are saved permanently under Completed training sessions, both on the driver's mobile profile and here in admin - so past progress can be reviewed later. A completed session is always verified against the driver's real lap data before being saved, it can never simply be claimed by the mobile page.", "guide.training_31": "31. Milestones and the club goal can target either a number of laps or a number of completed sessions of a specific exercise (for example 10 completed Step training sessions towards a reward) - the same reward flow works for both.", "guide.archive_title": "Results archive", - "guide.card_archive_blurb": "Search and open completed races by date, class or driver without going through Race Setup.", - "guide.archive_1": "1. Open Results archive in the menu to see every completed session in one place, regardless of which event it belongs to.", - "guide.archive_2": "2. Search by event or session name, or filter by class, driver and date range.", - "guide.archive_3": "3. Click View on a row to see that session's results, penalties/corrections and per-driver lap history.", - "guide.archive_4": "4. Export the same PDF and race-package (JSON) files already available in Manage Event, directly from the archive.", + "guide.card_archive_blurb": "One race per row: pick the race to see the whole overview, every heat and export.", + "guide.archive_1": "1. Open Results archive in the menu. Each race (event) is one row with date, class, number of heats, drivers and winner.", + "guide.archive_2": "2. Search by race or heat name, or filter by class, driver and date range.", + "guide.archive_3": "3. Click View on a race: the Race overview shows the podium, then practice, qualifying and finals with the standings and every heat's result. Print, PDF and CSV export the whole race. In the list of heats, View opens one heat with its lap history and penalties.", + "guide.archive_4": "4. The race package (JSON) is exported from the race in the archive.", "guide.archive_5": "5. Deleting an event or session removes the race's data everywhere, including the raw lap rows in the database - but never affects a driver's durable training statistics, which are already stored separately.", "guide.archive_6": "6. Running your club across several track layouts (e.g. indoors in the same building) - press New layout (on Training stats, Race Day or the Dashboard) when the track has been rebuilt; it works even in the middle of a running Open Practice. The archive shows which layout each session ran on, and personal bests/track records only compare against the same layout. On Training stats and in the driver's mobile profile, pick Stats for: the current layout, an older layout, or All layouts.", "overlay.title": "Overlay", diff --git a/src/misc_views.js b/src/misc_views.js index 863e49f..cf3e0d2 100644 --- a/src/misc_views.js +++ b/src/misc_views.js @@ -62,6 +62,7 @@ export function renderGuideView({ dom, t }) {