# RC RaceCore Tidtagning och tävlingsledning för RC-klubbar. Systemet har livetidtagning från AMB/MyLaps-decoders via AMMC och en Race Day-sida med startförfarande som i EFRA/IFMAR. Det har också: - kval och finaler, serier och cuper; - träningsstatistik med personliga mobilprofiler; - utrop med offlineröst; - overlays för skärmar och OBS. Allt körs lokalt på en dator (Windows eller Linux) med en SQLite-databas. Ingen molntjänst och inget internet behövs på banan. English version: [README.md](README.md) · Ändringar: [CHANGELOG.md](CHANGELOG.md) · Planer: [ROADMAP.md](ROADMAP.md) · Versionen som körs visas längst ner i menyn. ## Innehåll - [Höjdpunkter](#höjdpunkter) - [Skärmbilder](#skärmbilder) - [Snabbstart](#snabbstart) - [Använda RaceCore](#använda-racecore) - [Race day](#race-day) - [Skapa race](#skapa-race) - [Serie / cup](#serie--cup) - [Träning och träningsstatistik](#träning-och-träningsstatistik) - [Ljud och utrop](#ljud-och-utrop) - [Overlays och OBS](#overlays-och-obs) - [Sponsorevent med delade bilar](#sponsorevent-med-delade-bilar) - [Data, backup och export/import](#data-backup-och-exportimport) - [Säkerhet](#säkerhet) - [Videoguider](#videoguider) - [Installation](#installation) - [Decoders och AMMC](#decoders-och-ammc) - [Utveckling och tester](#utveckling-och-tester) ## Höjdpunkter - **Race Day-sida** med heat-kö, förkontroll och start med ett klick. - **Startförfarande som i EFRA/IFMAR:** nedräkning med utrop (2 min, 1 min, 30 s, 10, 9 … 3), paus medan bilarna ställs upp, flygande start för kval och gridstart för finaler: efter "3" säger speakern "Start på tonen" och starttonen kommer 1-3 s senare. Start och målgång signaleras som standard med en ton och en stoppsignal; trumpet, tryckluftstuta eller de klassiska ljuden kan väljas under Inställningar → Ljud. - **Transponderkontroll** under nedräkningen: grön bock för varje förare som passerat, och fel transponder rättas med ett klick. - **Kval och finaler:** skapas från deltagarlistan med jämnt fördelade heat, A/B/C-finaler, bump-up, poängtabeller, tie-break och grid med dra-och-släpp. - **Serie / cup:** poängtabell, bästa N eller stryk X, val för endast klubbmedlemmar, ställning per klass och varje deltävling sköts från seriesidan. - **Domarvy:** straff och varvändringar, allt loggat och ångringsbart. - **Träningsstatistik** per förare, klass och banlayout: stints, jämnhet, utmärkelser, mål och en personlig mobilprofil med QR-kod. - **Ren statistik:** misstänkt korta träningsvarv (genvägar) flaggas automatiskt och tas bort med ett klick. - **Utrop** på svenska eller engelska med lokal neural röst (Piper, offline). Under race spelas bara passeringsljud, som i tidtagningssystem. - **Overlays** för skärmar och OBS, med placeringar vunna/förlorade sedan start. - **Säker data:** SQLite, automatisk backup före varje start, full export/import och valfri admin-PIN. ## Skärmbilder Klicka på en bild för full upplösning.
Översikt med aktiv session
Översikt med aktiv session
Race Setup-guiden
Race Setup-guiden
Fullständig liveoverlay
Fullständig liveoverlay
Leaderboard-overlay
Leaderboard-overlay
Översikt över träningsstatistik
Träningsstatistik, översikt
Detaljerad träningsstatistik med tempokarta och stintanalys
Detaljerad träningsstatistik
Serie / cup med numrerade steg
Serie / cup
Domarvy och racekorrigeringar
Domarvy och korrigeringar
Raceljud och utrop
Raceljud och utrop
Event Managers flik Live & resultat
Event Managers flik Live & resultat
Decoderinställningar
Decoderinställningar
Hanterad AMMC
Hanterad AMMC
Inbyggd guide
Inbyggd guide
Race Day med snabbval under en pågående träning
Race Day
## Snabbstart **Windows 11** (PowerShell): ```powershell winget install --id Git.Git --exact --source winget # bara om "git --version" inte fungerar Set-Location $HOME git clone https://git.dio.nu/Public/Live_RC.git Live_RC Set-Location .\Live_RC .\windows\install.bat ``` **Linux (Ubuntu/Debian)** med Node.js 22 eller 24: ```bash git clone https://git.dio.nu/Public/Live_RC.git Live_RC cd Live_RC npm ci && npm run verify npm start ``` Öppna sedan `http://localhost:8081`, eller `http://:8081` från en annan dator i racenätverket. **Guiden** i menyn och [videoguiderna](#videoguider) visar hur man ansluter decodern, lägger in förare och skapar första racet. Alla steg: [Installation](#installation). ## Använda RaceCore Menyn följer hur en tävlingsdag går till: - **Start:** Översikt, Race Day. - **Skapa:** Race Setup, Sponsor Event, Serier / cup. - **Kör och följ:** Tidtagning, Domare, Overlay, Träningsstatistik, Resultatarkiv. - **Register:** Klasser, Förare, Bilar. - **System och hjälp:** Inställningar, Guide. Gränssnittet finns på svenska och engelska. ### Race day **Race Day** är operatörens sida; allt som *kör* en session görs här, medan Tidtagning är till för att *följa*: - **Snabbval** överst: **Starta träning** (fortsätt eller starta en Open Practice), **Ny banlayout** (under träning) och **Skapa race**. Översikten har samma tre vanliga uppgifter. - **En sessionsväljare** och de knappar som gäller just nu: Start, Pausa, Fortsätt, Avsluta, **↻ Kör om** för ett avbrutet eller klart heat, kval eller final (varv, resultat och klocka nollställs), och för träning **Nollställ – ny träningsdag**. Träning använder vanliga ord och har inga startljus. Väljaren visar dagens race grupperade per race (plus det som pågår); äldre race och andra dagars deltävlingar finns under **Visa alla sessioner**. - **Live-race** för race controllern, direkt under klockan medan ett heat, kval eller final pågår: ordningen med varv, senaste varv, bästa varv, avstånd till bilen före och till ledaren, och beräknat slut (varv och tid när tiden går ut). Heatets snabbaste varv är lila, personbästa på senaste varvet grönt, och en stapel visar hur långt in på varvet varje bil är (röd = sen). Efter heatet visas resultatet. - **Dagens schema** (längst ned) lägger alla klasser som körs den dagen i en körordning med tider: träning, sedan varje kvalomgång där klasserna turas om, sist finalerna. Ange första start och paus mellan heaten; **▲▼** ändrar ordningen. Ett heat som startar sent, drar ut på tiden eller pausas flyttar resten av dagen. Körda heat fälls ihop till en rad (✓ 6 heat körda – visa), och nästa heat är markerat. - **🖨 Skriv ut körordning** ger tider, klasser, heat och förare att sätta upp på tavlan i depån. - **📺 Förarvy** (`/public-overlay/schedule`, finns även under Overlay) visar vad som körs, de tre nästa heaten med förare, sedan resten av dagen. Ett uppropat heat markeras "Uppropad – gör dig redo". Den fungerar på mobilen eller en TV i depån. - **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. **Startförfarande (EFRA/IFMAR):** Start kör först en nedräkning. Välj Go, 30 s, 1, 1:30, 2, 3 eller 5 min; standard sätts per tävling för kval och final. - **Under nedräkningen:** - Banan är öppen. - Speakern ropar "Heat 3 startar om 2 minuter", sedan varje minut, 30 s och 10 s. - Vid gridstart ropar den dessutom "bilarna till startplatsen" vid 30 s och räknar "10, 9 … 3" sekund för sekund. - **Knappar:** - **Pausa** (medan bilarna ställs upp) och **Fortsätt**. - **+1 min**. - **Till 30 s** (omstart av gridet). - **Till 10 s**. - **Go nu**, som varnar om förare som inte setts. - **Avbryt**. - **När tiden går ut startar heatet av sig självt.** - **Gridstart** (mass/position): efter "3" är det tyst; startljusen tänds och tutan går 1-3 s senare (IFMAR 4.2.6). - **Flygande start** (standard för kval): signalen och "Klockan går". Varje bils tid startar vid dess första passering, och en sen bil får klockan startad senast efter 150 % av ett varv (EFRA 9.3). - **Staggered start:** bilarna ropas ut en och en. - **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, och repris av sessionen (1-10x). **Domare** har speakerpanelen överst och är platsen för korrigeringar i race – även efter att ett heat, kval eller final är klart (protest, ej godkänd bil): välj heatet under **Heat att döma**. Straff får en **orsak** som loggas; det finns egen tid (t.ex. +10 s), **DSQ** (placeras sist; i kval poäng som sista plats, enligt EFRA) och **DNF**. Medan heatet pågår finns **Utrop till föraren** – Observera (blå flagg), Officiell varning, Stop & go, Drive through – som speakern ropar ut och som loggas; två officiella varningar ger förslag på DSQ (EFRA). Resultat, ställning, race-översikt och arkiv räknas om direkt; är finalerna redan skapade från kvalet varnar Domarvyn. Dessutom: ±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. - **Längsta varvtid** startar en ny statistik-stint efter en paus; det långa varvet räknas ändå i racet. ### Skapa race **Race Setup** har två ingångar: - **Snabbstart Open Practice:** bara ett namn. Den skapar en otidsatt session för alla transpondrar och går direkt till Tidtagning; ingen klass, förare eller format behövs. - **Skapa race-guiden:** Grunder → Deltagare → Sessionsplan → Bekräfta. Välj klass och förval, bocka i förarna, och träning, kval (eller lagrace) skapas. **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** 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. 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); - poängtabell för kval (placering, efter fältstorlek, 10-9-8...) och tie-break; - finaler: antal finalheat, räknade finalheat, bump-up och reserverade bump-platser; - nedräkningens längd, follow-up-tid och min/max-varvtid; - förval: kort teknisk bana, klubbrace, IFMAR-stil, endurance, eller egna sparade klubbförval; - **Race actions** längst ner i fliken: - skapa kval från träningen (eller deltagarlistan); heaten delas så jämnt som möjligt, till exempel 9 förare och max 8 per heat → 5 + 4; - omseeda kommande heat; låsta manuella grid respekteras; - skapa A/B/C-finaler och bump-up; - exportera racet som ett paket. - **Live & resultat:** - grid-redigerare (dra och släpp) och låsning; - ställning för träning, kval och final samt finalmatris; - utskrift och PDF med klubbens profil; - sammanfattning av split- och depåtider. - **Schema & utskrift:** dagens körordning med planerade tider, och heatlistor. **Ö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 Menyn **Serier / cup** kör ett mästerskap över valfritt antal deltävlingar, med fritt valda klasser. Varje klass får en egen ställning. 1. **Namn och klasser.** 2. **Poäng:** - **Vem får poäng:** alla förare (öppen serie), eller endast klubbmedlemmar. Med endast medlemmar kör förare från andra klubbar och syns i dagens resultat men får inga seriepoäng, och medlemmarna rangordnas om utan dem. - **Poängtabell:** ÖRC-tabellen (100, 90, 82, 75, 69 … sedan −4 per plats, lägst 10), 100-80-70, F1, eller en egen lista. - **Räknade resultat:** bästa N (t.ex. 9 av 12), eller alla körda utom X sämsta. Då minskar antalet automatiskt om en deltävling ställs in. 3. **Deltävlingar:** klistra in datumen, så skapas ett race per datum och klass. Knappen talar om hur många race som skapades. - **Format:** till exempel **ÖRC Winter** (3 × 5 min kval med staggered start där flest varv på tiden vinner och bästa 2 rundorna jämförs, max 6 per heat och final, 3 finaler där 2 räknas). Formatet fyller i antal kvalomgångar, finaler och max bilar per heat, som går att ändra. - **Seedningsträning före kval** (standard: på, 5 min, bästa 3 varv): varje race börjar med en träning, och kvalheaten delas efter den så att lika snabba kör tillsammans. **Max förare per seedningsgrupp** (standard 6, kolumnen Max förare/seedgrupp per deltävling, 0 = alla samtidigt) delar träningen i jämna grupper efter serieställningen när du trycker ▶ Seedningsträning, t.ex. 10 förare med max 5 → 2 grupper om 5. - **Heatordning:** snabbaste heatet sist (standard) eller först. Finns också per race i Race Setup. Varje deltävling sköts sedan från sin rad: - välj förare, **Kopiera från förra** deltävlingen, eller **Ny förare** för en efteranmälan; - ändra formatet för just den deltävlingen (det kan skilja mellan deltävlingar och klasser); - **en knapp för nästa steg:** ▶ Seedningsträning → Skapa kval → ▶ Kör Q1 H1, Q1 H2 … → Skapa finaler → ▶ Kör C Final 1, B Final 1, A Final 1 …. En ▶-knapp väljer sessionen och öppnar Race Day, där bara Starta återstår; - **Status** och **Öppna**. Tar du bort en serie får du frågan om dess race också ska tas bort från Race Setup, eller sparas. 4. **Ställning:** - Dagens placering kommer från slutresultatet (A före B), sedan kvalordningen. - Inget registrerat varv ger 0. Frånvaro räknas som 0 och kan strykas. - **✎ Resultat** på en deltävling sätter dagens ordning för hand (▲▼, lägg till, ta bort), t.ex. när kvalet blev fel. Den ersätter appens uträkning i ställningen, och deltävlingen märks Rättat resultat. Använd appens resultat går tillbaka. - Lika poäng avgörs av flest segrar, sedan andraplatser, sedan senaste gemensamma deltävling. - Skriv ut eller exportera som PDF (breda tabeller blir liggande A4). #### Rookie-klass (förare från 2WD/4WD i eget race) Rookies läggs inte upp igen: de kör med samma förare och transponder som de redan har i 2WD eller 4WD, och 2WD och 4WD kan blandas. 1. **Klasser:** skapa en klass som heter Rookie, utan egna förare. 2. **Eget race:** i Race Setup, skapa racet med klass Rookie och bocka i rookies under Deltagare → **Förare från andra klasser**. 3. **Serie:** bocka i Rookie bland seriens klasser. Är serien redan igång: klistra in samma datum igen och tryck Skapa deltävlingar, bara de saknade Rookie-deltävlingarna skapas. 4. **Varje deltävling:** öppna förarlistan på Rookie-raden och bocka i rookies under **Förare från andra klasser**. Kopiera från förra tar samma rookies nästa gång. Rookie får en egen ställning med seriens poängtabell, räkneregel och klubbregel; poängen blandas aldrig med förarens 2WD/4WD-ställning. Racets format, open practice och varvtidsgränser påverkas inte. ### Träning och träningsstatistik **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:** - Tryck **Ny layout** (på Träningsstatistik, Race Day eller Översikt) när banan byggs om. Ett pågående träningspass flyttas till den nya layouten, och bästa varven börjar om. - Varje layout kan ha egen **min/max-varvtid** för träning. Race använder alltid tävlingens värden. - Statistiken visas per layout, med en översikt för alla layouter. **Misstänkt korta varv** (bara träning): - Ett varv som är mycket snabbare än förarens egen nivå (under 85 % av medianen, efter 5 varv) flaggas ⚠, oftast en genväg av en nybörjare eller ett barn. - Det räknas som ett varv men inte som bästa varv, rekord eller i statistiken förrän någon **Godkänner** det. - **Ta bort** görs med ett klick, i panelen på Tidtagning och Race Day eller i förarens varvlista. **Träningsstatistik** (menyn): - Klubböversikten och en sida per förare och klass visar: - personbästa, snittider och jämnhet; - bästa 3 varv i följd och bästa 5-minutersresultat; - stintanalys, 30-minuters tempoblock och setup-markeringar med före/efter-jämförelse; - dagshistorik och utmärkelser; - mål med belöningar, dagliga utmaningar och ett gemensamt klubbmål. - **Underlag: Träning** (standard), **Race** eller **Alla.** Racevarv hålls separat och märks 🏁 med tävling, pass och serie. Under Race visas de per racepass; ett race delas aldrig upp i stints. - En person kan köra flera klasser. Koppla klassposterna till samma träningsprofil under Förare; statistiken hålls per klass. **Mobilprofil:** - Varje förare kan få en personlig länk med QR-kod. Den visar förarens egen statistik, en träningstimer, setup-markeringar och övningar (jämna varv, stegträning), och har val för tränings- eller racevarv. - Länken använder en slumpad nyckel; inga transpondrar eller andra förare visas. - För användning via internet, ange **den publika adressen** en gång för alla under Inställningar → System & backup → Publik adress (domän / DynDNS), till exempel `https://klubben.dyndns.org:8443`. Lämnas den tom används den lokala nätverksadressen. - Publicera bara de här sökvägarna mot internet: `/public-training/*`, `/src/public_training.js` och `/src/public_training.css`. Färdiga Teltonika-filer finns i `scripts/teltonika/`. ### Ljud och utrop Inställningar → Ljud: - **Raceljud:** - 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). - Under **Fler röster**, en i taget (ca 63 MB var): svenska Alma; brittiska Alan, Northern English, Cori och Alba (skotsk); amerikanska Joe, John och Norman. - Förgenerera fraser och förarnamn före racedagen. - Saknas Piper tar webbläsarens röst över. - **Uttalsnamn per förare:** skriv ett uttal eller smeknamn under Förare och tryck **🔊 Testa uttal** för att höra det i riktiga utrop. ### Overlays och OBS Menyn **Overlay** har lägena leaderboard, speaker, resultat, TV och lag, plus ett OBS-läge med layout (leaderboard, TV-grafik, grid, lower third), tema (panel, transparent, chroma), rader och kolumner: - Kolumner: varv, resultat, bästa, gap och **placering sedan start** (▲/▼ i heat och finaler). - **TV-grafik:** rubrikskylt uppe till vänster (event och heat) och en topplista uppe till höger med klockan överst och raka kolumner: placering / **startplats** (t.ex. "2 / 3"), förare, varv, tid, bästa och gap, i stor fet text och medaljfärger för topp 3. Ingen egen bakgrund, så kamerabilden syns igenom. Startplatsen kan stängas av och visas inte i träning. - **Klicka på en förare** i RaceCores egen overlay för att öppna förarens träningsstatistik (det fristående overlay-fönstret öppnar den i en ny flik). Den publika overlayn har inga sådana länkar. - **Kopiera OBS-URL** ger en länk för browser source; valda kolumner ingår i länken. - **Overlay-fönster är skrivskyddade:** de kopplar inte upp sig mot decodern och sparar aldrig, så en overlay på en annan dator (eller i OBS) kan inte störa racet som körs från Race Day. Ingen admin-PIN behövs för det. Kör bara Race Day i en webbläsare åt gången. - Publika overlays finns på `/public-overlay/` och kan kräva en nyckel: sätt `PUBLIC_OVERLAY_TOKEN` och lägg till `?token=...`. Publicera bara `/public-overlay/*` via din reverse proxy. - Klubbprofilen (namn, logga, PDF-tema) används i menyn, overlays, mobilprofiler och PDF; den kan även sättas per tävling. ### Sponsorevent med delade bilar **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, och bilen visas bredvid förarens namn (🚗 Hyrbil 2) i overlayn, OBS-overlayn och Race Days live-lista. 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 - **Lagring:** - Allt sparas i `data/rc_timing.sqlite`; webbläsaren håller en lokal kopia och synkar. - Menyn visar sparstatus (sparat, väntar, misslyckades, med **Försök igen**). - Domarkorrigeringar skickas direkt till servern. - **Backup:** - automatisk före varje sessionsstart, plus manuella; - de senaste 30 listas under Inställningar; - återställ med `npm run backup:restore` (se [Installation](#återställ-en-serverbackup)). - **Export/import** (Inställningar → Lagring): - full JSON, eller bara registret (klasser, förare, bilar); - CSV för förare och bilar (Excel/LibreOffice; komma, semikolon eller tab). CSV-importen slår ihop: den matchar på id, sedan transponder, sedan namn + klass. - ett enskilt racepaket från Race Setup; - klubbförval. - **Rensning:** förare, bilar, klasser, race eller träningsstatistik kan rensas var för sig, var och en med egen bekräftelse. Exportera först. Exempel på förar-CSV (bara `name` krävs): ```csv name;transponder;class;brand;club;country Anna Andersson;123456;2WD;;JMK;SE Erik Eriksson;654321;4WD;Associated;; ``` ### Säkerhet RaceCore är tänkt för ett betrott racenätverk: - **Admin-PIN** (Inställningar → System & backup, av som standard) skyddar alla ändringar via API:t. Inloggningen gäller i 30 dagar och är skyddad mot gissning. - **Race Controller Master:** bara en dator åt gången kör racet (decodern, start, paus, fortsätt, stopp, tjuvstart, nollställ heat och autopiloten, även från speakerpanelen). Domarvyns korrigeringar och övriga utrop fungerar från alla datorer. Datorn som kör servern (sidan öppnad på `localhost`) blir master av sig själv och visar en grön rad "🎙 Du är Race Controller Master" med **Släpp master**. Mobiler och andra datorer följer racet live (uppdateras varje sekund), visar "Du följer racet …" och blir master bara när någon trycker på knappen; den datorn minns sedan rollen. De kan också förbereda förare och race. Den som jobbar som race controller trycker **Ta över som master**, och den förra mastern släpper decodern inom några sekunder. Med admin-PIN krävs inloggning för att ta över. Ge datorn ett namn under Inställningar → System, t.ex. "Speakerbåset". Overlays och OBS är alltid bara visning. - **House of RC:** under Inställningar → System → 🏠 House of RC sparar du klubbens API-nyckel en gång (bara på servern, visas aldrig igen) och trycker **Testa anslutning**. Förare → **🏠 Hämta från House of RC** fyller i namn och märke utifrån transpondrarna (bara det du bockar i), och en känd transponder fyller i en ny förare. Med nyckeln för klubben som arrangerar tävlingen listar Race-guidens **🏠 Hämta från House of RC** klubbens tävlingar; välj tävling och en av dess klasser så fylls namn, datum, klass och anmälda förare med transpondrar i. Senare lägger Hantera → Deltagare → **🔄 Hämta ändringar från House of RC** till sena anmälningar och tar bort avanmälda. **📤 Skicka resultat till House of RC** förhandsgranskar och skickar resultatet till anmälningarna: heat och kval under dagen, slutplaceringen när finalerna är körda. - **`RC_ADMIN_ALLOWED_CIDRS`** begränsar adminändringar till vissa adresser eller nät, till exempel `192.168.1.0/24`. - **`RC_ALLOWED_ORIGINS`** används för ett gränssnitt som medvetet körs från en annan adress. - **Exponera inte port 8081 mot internet.** Läsningar skyddas inte av PIN. Publicera bara sökvägarna för publik overlay och mobilprofil via reverse proxy eller VPN. Se [docs/security-performance-audit.md](docs/security-performance-audit.md). ## Videoguider Korta inspelningar med berättarröst (`.mkv`, H.264/AAC), även länkade från Guiden i appen: - **Kom igång:** [Anslut en decoder](docs/videos/connect-decoder.mkv) · [Lägg till förare och bilar](docs/videos/add-drivers-cars.mkv) · [Skapa ett race](docs/videos/create-race.mkv) · [Kör en session](docs/videos/run-a-session.mkv) - **Rundtur i gränssnittet:** [Inställningsflikar](docs/videos/settings-tabs.mkv) · [Event Managers flikar](docs/videos/event-manager-tabs.mkv) · [Dagens schema](docs/videos/event-schedule.mkv) - **Tävlingsdag och efteråt:** [Sponsorevent](docs/videos/sponsor-event.mkv) · [Lagrace](docs/videos/team-race.mkv) · [Ranking i öppen träning](docs/videos/practice-ranking.mkv) · [Race-översikt och arkiv](docs/videos/race-overview.mkv) · [Domare: utrop, straff och DSQ](docs/videos/judging.mkv) Spelas in med `node scripts/record-video-guides.mjs`, mot en isolerad testserver. ## Installation RaceCore körs på 64-bitars Windows 11 och Linux med Node.js 22 eller 24 LTS och npm 10+. Använd `npm ci` (repot har en `package-lock.json`). ### Windows 11 1. **Git:** kör `git --version`. Saknas det, kör `winget install --id Git.Git --exact --source winget` och öppna PowerShell igen, eller använd [Git for Windows](https://git-scm.com/download/win). Utan Git: ladda ner zip-filen från [repot](https://git.dio.nu/Public/Live_RC) och packa upp allt. 2. **Ladda ner:** ```powershell Set-Location $HOME git clone https://git.dio.nu/Public/Live_RC.git Live_RC Set-Location .\Live_RC ``` 3. **Installera:** kör `.\windows\install.bat` (eller dubbelklicka). Den gör följande: - installerar Node.js LTS vid behov, plus Visual C++-runtime som AMMC behöver; - kör `npm.cmd ci`; - verifierar Express, SQLite och AMMC; - skapar `data\` och `logs\`; - startar RaceCore i bakgrunden. 4. **Kontrollera:** ```powershell npm.cmd run status Invoke-RestMethod -Uri "http://127.0.0.1:8081/api/health" ``` Öppna sedan `http://localhost:8081`, eller `http://:8081` från en annan dator. Använd `npm.cmd` i PowerShell; då slipper du felet "running scripts is disabled". Manuell installation utan skriptet: `npm.cmd ci`, `npm.cmd run verify`, `npm.cmd start`. Använd inte `--ignore-scripts`, eftersom SQLite behöver sitt installationsskript. ### Linux (Ubuntu/Debian) ```bash sudo apt update && sudo apt install -y git curl build-essential # Node.js 22 om "node --version" saknas eller är äldre: curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs git clone https://git.dio.nu/Public/Live_RC.git Live_RC cd Live_RC npm ci npm run verify chmod +x AMMC/linux_x86-64/ammc-* npm start npm run status ``` Öppna `http://localhost:8081` eller `http://:8081`. Den medföljande Linux-AMMC kräver **GLIBC 2.39+** (`ldd --version`). På äldre system: använd en AMMC-version byggd för ditt system eller kör AMMC på en annan dator. Byt aldrig systemets GLIBC. ### Driftkommandon | Kommando (Windows: `npm.cmd ...`) | Gör | |---|---| | `npm start` | Startar i bakgrunden | | `npm run status` | Körs den? (PID i `data/server.pid`) | | `npm restart` | Startar om efter en uppdatering | | `npm stop` | Stoppar | | `npm run start:fg` | Kör i terminalen och visar fel direkt | | `npm run tts:install` | Installerar Piper och standardrösterna | Loggar hamnar i `logs/server.out.log` och `logs/server.err.log`; data ligger i `data/`. Hjälpskript i `windows\`: - `install.bat`: installerar, verifierar och startar om. - `start_backend.bat` och `restart_backend.bat`: startar eller startar om servern. - `start_ammc.bat`: startar AMMC. - `start_all.bat`: startar AMMC och servern och öppnar webbläsaren. - `stop_all.bat`: stoppar servern och AMMC. ### Uppdatera utan att tappa data Radera aldrig `data/`. Så här uppdaterar du: ```bash npm stop git pull --ff-only npm ci npm run verify npm restart ``` På Windows används samma kommandon med `npm.cmd`. Menyn visar när en uppdatering finns, och uppdateringen kan också köras från Inställningar → System & backup. Vid zip-installation: behåll `data/`, och kopiera aldrig `node_modules/` mellan Windows och Linux. ### Återställ en serverbackup Backuper ligger i `data/backups/`. Återställning görs med ett lokalt kommando, med avsikt: ```bash npm stop npm run backup:restore -- .sqlite --confirm npm start ``` På Windows hittar du senaste filen med `Get-ChildItem .\data\backups\*.sqlite | Sort-Object LastWriteTime -Descending | Select-Object -First 1`. Återställningen kontrollerar filen och tar först en `pre_restore`-backup av den nuvarande databasen. ## Decoders och AMMC Den fullständiga guiden, med nätverksskiss, exempel med 1-4 decoders, brandvägg och felsökning, finns i [docs/decoder-setup.sv.md](docs/decoder-setup.sv.md) (engelska: [docs/decoder-setup.md](docs/decoder-setup.md)). | Roll | Placering | Exempel decoder-IP | AMMC WS-port | Effekt | |---|---|---:|---:|---| | Main | Start/mål-slinga | `192.168.1.10` | `9000` | Räknar varv | | Split | Mellanslinga | `192.168.1.11` | `9001` | Mellantid, aldrig ett varv | | Depå in | Depåinfart | `192.168.1.12` | `9002` | Öppnar ett depåstopp | | Depå ut | Depåutfart | `192.168.1.13` | `9003` | Stänger och tar tid | **Hanterad AMMC** (Inställningar): 1. Slå på Hanterad AMMC. 2. Ange decoderns IP för varje kanal. 3. Klicka **Starta AMMC**, sedan **Använd serverns WS-url**. AMMC körs på serverdatorn, inte i webbläsaren. De medföljande programmen ligger i `AMMC/windows64`, `AMMC/linux_x86-64` och `AMMC/apple_m`. **Manuell start:** kör en `ammc-amb -w ` per decoder. Sätt WebSocket-URL i Inställningar (t.ex. `ws://:9000`) och tryck **Anslut decoder**. Webbläsaren ansluter till AMMC-datorn, inte till decodern. På Linux med UFW: `sudo ufw allow 8081/tcp` och `sudo ufw allow 9000:9003/tcp`. **Diagnostik:** Inställningar → Decoder / socket-diagnostik visar varje kanals anslutning, meddelanden och passeringar, senaste råmeddelandet och 50 händelser. **`ammc-sim`** emulerar en decoder med valda transpondrar, för träning och test utan hårdvara. AMMC skickar PASSING-meddelanden så här ([AMMC-dokumentation](https://www.ammconverter.eu/docs/intro/quick-start/)): ```json { "msg": "PASSING", "passing_number": 1, "transponder": 232323, "rtc_time": "2022-10-11T22:57:36.099+02:00", "strength": 0.0, "resend": false, "loop_id": "55" } ``` ### Testa utan decoder 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/`. - **Webbläsartester:** `npm run test:browser`. De kräver Chrome, Chromium eller Edge (sätt `CHROME_PATH` om den inte hittas) och körs mot en isolerad server med fejkad decoder. - **Skärmbilder och videoguider:** `node scripts/capture-screenshots.mjs [namn]` och `node scripts/record-video-guides.mjs`. - **Dokumentation:** modulöversikten finns i [docs/javascript-architecture.md](docs/javascript-architecture.md), och planerat och klart arbete i [ROADMAP.md](ROADMAP.md). - **Automatisk omladdning:** klienten laddas om när `index.html` eller frontendfiler ändras. Kör `npm restart` efter ändringar i backend. - **Rådata:** `/api/passings` (senaste passeringar) och `/api/state` (appens data), bara i det lokala nätverket.