docs(guide): team race, race overview, archive, practice ranking, speaker panel, sponsor flow and simulator (1.69.1)

This commit is contained in:
larssand committed 2026-11-05 23:12:58 +01:00
1 parent eb4c472ef9
commit 2e3676d0cd
8 files changed
+112 -51

No files matched your search

+24 -8
View File
@@ -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/`.