Files
Live_RC/README.sv.md
T

536 lines
55 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 (typsnitt, flaggor och ljud ligger i repot).
English version: [README.md](README.md) · Ändringar: [CHANGELOG.md](CHANGELOG.md) · Planer: [ROADMAP.md](ROADMAP.md) · Licens: [AGPL-3.0](LICENSE) · 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)
- [Förarregister](#förarregister)
- [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)
- [Licens](#licens)
## 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.
<table>
<tr>
<td width="50%"><a href="docs/screenshots/overview-active-session.jpg"><img src="docs/screenshots/overview-active-session.jpg" alt="Översikt med aktiv session" /></a><br><strong>Översikt med aktiv session</strong></td>
<td width="50%"><a href="docs/screenshots/race-setup-wizard.jpg"><img src="docs/screenshots/race-setup-wizard.jpg" alt="Race Setup-guiden" /></a><br><strong>Race Setup-guiden</strong></td>
</tr>
<tr>
<td width="50%"><a href="docs/screenshots/overlay.jpg"><img src="docs/screenshots/overlay.jpg" alt="Fullständig liveoverlay" /></a><br><strong>Fullständig liveoverlay</strong></td>
<td width="50%"><a href="docs/screenshots/leaderboard-overlay.jpg"><img src="docs/screenshots/leaderboard-overlay.jpg" alt="Leaderboard-overlay" /></a><br><strong>Leaderboard-overlay</strong></td>
</tr>
<tr>
<td width="50%"><a href="docs/screenshots/training-overview.jpg"><img src="docs/screenshots/training-overview.jpg" alt="Översikt över träningsstatistik" /></a><br><strong>Träningsstatistik, översikt</strong></td>
<td width="50%"><a href="docs/screenshots/training-extra-stats.jpg"><img src="docs/screenshots/training-extra-stats.jpg" alt="Detaljerad träningsstatistik med tempokarta och stintanalys" /></a><br><strong>Detaljerad träningsstatistik</strong></td>
</tr>
<tr>
<td width="50%"><a href="docs/screenshots/series.jpg"><img src="docs/screenshots/series.jpg" alt="Serie / cup med numrerade steg" /></a><br><strong>Serie / cup</strong></td>
<td width="50%"><a href="docs/screenshots/judging-current.jpg"><img src="docs/screenshots/judging-current.jpg" alt="Domarvy och racekorrigeringar" /></a><br><strong>Domarvy och korrigeringar</strong></td>
</tr>
<tr>
<td width="50%"><a href="docs/screenshots/race-audio-settings.jpg"><img src="docs/screenshots/race-audio-settings.jpg" alt="Raceljud och utrop" /></a><br><strong>Raceljud och utrop</strong></td>
<td width="50%"><a href="docs/screenshots/race-manage-tabs.jpg"><img src="docs/screenshots/race-manage-tabs.jpg" alt="Event Managers flik Live & resultat" /></a><br><strong>Event Managers flik Live & resultat</strong></td>
</tr>
<tr>
<td width="50%"><a href="docs/screenshots/decoder-settings.jpg"><img src="docs/screenshots/decoder-settings.jpg" alt="Decoderinställningar" /></a><br><strong>Decoderinställningar</strong></td>
<td width="50%"><a href="docs/screenshots/managed-ammc.jpg"><img src="docs/screenshots/managed-ammc.jpg" alt="Hanterad AMMC" /></a><br><strong>Hanterad AMMC</strong></td>
</tr>
<tr>
<td width="50%"><a href="docs/screenshots/guide.jpg"><img src="docs/screenshots/guide.jpg" alt="Inbyggd guide" /></a><br><strong>Inbyggd guide</strong></td>
<td width="50%"><a href="docs/screenshots/race-day.jpg"><img src="docs/screenshots/race-day.jpg" alt="Race Day med snabbval under en pågående träning" /></a><br><strong>Race Day</strong></td>
</tr>
</table>
## 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://<serverns-ip>: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, paus mellan heaten, en längre **paus mellan omgångar** (träning → kval, omgång 1 → omgång 2) och **paus före finaler** (lunch, räknas från att kvalet tog slut, så finalerna inte startar direkt när de skapas). **☕** på ett heat lägger in en extra paus före det. **Fasta pauser** med klockslag (t.ex. Lunch 12:00–13:00 och Prisutdelning 16:00–16:30; **+ Lägg till paus** för fler, ✕ tar bort) håller alla heat utanför de tiderna: ett heat som skulle starta i eller gå in i en paus startar när den är slut, och utskriften av körordningen och förartavlan visar pausen. Tomma fält för omgångar/finaler använder pausen mellan heat. **Marshals** (Av / Förra heatets förare / Nästa heats förare) visar vilka som ska marshala varje heat i schemat, på utskriften och förartavlan ("🦺 Marshals: …"), och uppropet läser upp dem efter förarna; den som själv kör heatet blir aldrig marshal i det. **▲▼** ä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. Med flera klasser samma dag körs alla klassernas heat i samma ordning. Finaler skapas aldrig automatiskt: när kvalet är klart i en klass står det "Väntar: kontrollera kvalet och tryck 🏁 Skapa finaler för …" med klassernas namn, så att kvalet kan korrigeras först. Sedan kör automatiken finalerna. 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, finalerna överst (A-finalen först), sedan kval och sist träning. Ett avslutat heat eller en final har egna knappar **🖨** och **PDF** för bara det heatet, t.ex. till tavlan i depån.
- **📈 Varvdiagram:** varje kvalheat och final har ett utfällbart varvdiagram – varje förares placering efter varje varv som en färgad linje, 1:a överst, namnen vid den officiella placeringen. Räknas från passeringarna, inget att ställa in. Det kommer med i utskrift och PDF av ett enskilt heat, och med finalerna i hela resultatet.
- **⏱ Varvtider:** utskrift och PDF av ett enskilt heat listar också alla varv, en kolumn per förare i placeringsordning; förarens bästa varv är fett på grönt och heatets snabbaste varv lila.
- **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.
- **Incheckning (frivilligt):** Hantera racet → **Incheckning** bockar av ✓ Närvarande och 💰 Betalt per förare, med sökning och räknare ("12 av 15 incheckade"). 📡 blir grön när förarens transponder passerat decodern i dag (på datorn som kör decodern). **Ta bort de som inte kommit** tar ut förare som inte är incheckade ur racet och heat som inte körts, efter en fråga och bara innan kvalet startat; de finns kvar i förarregistret. **Skriv ut lista** ger ett papper att bocka av vid grinden. Används inte incheckningen räknas alla som närvarande, och inget annat i racet påverkas.
- **Decoderlarm:** tappar decodern anslutningen medan ett heat pågår (eller under nedräkningen) visas en röd banner överst på alla sidor, "Decodern tappade anslutningen 12:03 – varv registreras inte", med **Anslut igen** och **Tysta**, och ett varningsljud hörs var 30:e sekund. I kval, heat och finaler larmar det också när decodern är ansluten men ingen passering kommit på 30 s (eller tre av de snabbaste varven), till exempel när decoderboxen eller slingan slutat fungera. Träning larmar bara vid tappad anslutning. När decodern fungerar igen visas i 10 s hur länge tidtagningen var borta, så att varven kan kontrolleras i Domarvyn. Gäller datorn som är Race Controller Master och kan stängas av under Inställningar → Ljud → **Decoderlarm under heat**.
- **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). Ändras den i efterhand, t.ex. från bästa 3 varv till varv och tid, räknas även körda kval om (resultaten räknas fram från varven); en ändrad heattid gäller bara heat som inte körts. Redan skapade finaler lottas inte om;
- 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, ÖRC Winter, endurance, och hela racedagar i förbundsstil – **EFRA 1/10 Off-road**, **EFRA 1/10 Touring / On-road**, **EFRA/SBF 1/8 Nitro** (bump-up, lång final), **IFMAR VM**, **ROAR** (tidskval, bump-up, en A-final), **Klubbdag snabb**, **Rookie / Junior** och **Poängrace utan finaler** – eller egna sparade klubbförval. Ett förbundsförval sätter även antal träningar (med seeding på bästa 3 varv i följd), och beskrivningen visas under valet. Värdena följer handböckerna i stil; reglerna ändras mellan årgångar, så allt går att justera;
- **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;
- efter practice: **Skapa kval från practice** och vid behov **Kvalet startar kl** (en tid) för en paus att skriva ut och sätta upp heaten; automatiken väntar in båda;
- träningen (practice) delas i heat på samma sätt och rankas enligt **Practice-seedning** överst i Format (0 = bästa enskilda varv; EFRA-förvalen: 3 snabbaste varv i rad). Listor och overlay visar seedningstiden, och en bättre seedningstid ropas ut ("ny seedningstid, 0,40 snabbare"). Open Practice påverkas inte;
- ändrar du bilar per heat eller antal kvalomgångar under Format byggs de practice- och kvalheat som inte har körts om;
- Hantera → Race actions visar knapparna i dagens ordning: 1. efter practice, **Skapa kval från practice**; 2. mellan kvalomgångarna (valfritt), **Dela om kvalheat som inte körts**; 3. efter kvalet, **Skapa finaler från kval** och bump-up. Tills kvalet är skapat från practice står det i heatlistan att kvalheaten är preliminära; 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. Starttid och paus här är samma inställning som Första start och Paus mellan heat i Race Day för racets datum, och tiderna som visas är Race Days (pauser och lunch inräknade).
**Ö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.
- **🔗 Koppla till förare:** står samma förare på två rader (resultat kvar på en borttagen dubblett) får raden en väljare - välj rätt förare så slås raderna ihop.
- **📄** på en körd deltävling laddar ner dagens CSV för den klassen (se Data, backup och export/import).
- 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. Förarlistan är grupperad per klass (Rookie 2WD, Rookie 4WD, Junior 4WD …): varje klass har **Alla** och **Ingen**, sökrutan hittar en förare på namn eller transponder, **Visa bara valda** kontrollerar listan och **Samma förare som…** kopierar startfältet från ett tidigare race (seriens egna deltävlingar först). **Markera alla** tar bara racets egen klass (eller det sökningen visar), aldrig hela klubben.
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 klass för klass (samma grupperade lista). Kopiera från förra tar samma rookies nästa gång, från alla klasser.
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.
**Klubbens träningsöversikt** (längst ner på Träningsstatistik): sök förare, välj en klass, **Bara förare som tränat** (på som standard) och **Gruppera per klass**. Klicka på en kolumnrubrik för att sortera.
**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;
- **träningsstintar som fälls ut** till alla varvtider: varv, bästa, snitt, totaltid och spridning per stint; stintens snabbaste varv grönt, dagens snabbaste lila, långsamma varv röda och utvarvet efter en paus markerat;
- 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.
- **🏁 Mitt race idag:** en tävlingsdag visar profilen överst förarens kommande heat med tid (som i Race Day, med pauser och förseningar) och startplats i finaler, marshal-pass och resultat från dagens körda heat. Race Controller-datorn skickar dagens schema till servern var 15:e sekund (bara förar-id, inga namn), så det kräver ingen ny länk eller ändring i routern. Dagar utan race syns inget kort.
- Ett reglage **Standard / Pro** högst upp. **Pro** är en ren träningsvy utan mål och inställningar: dagens varv, stintar, körtid, bästa, snitt och personbästa, sedan stintkorten som fälls ut till alla varv. Valet sparas i telefonen och kan länkas med `?mode=pro`.
- 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. Varvtidsutropet kan slås på även i race: **Varvtid vid passering → Träning och race** under Inställningar → Ljud eller på speakerpanelen.
- **Tider i utropen** (personbästa, snabbaste varv, banrekord) sägs som en speaker: sekunder och hundradelar, "18 sextiotre" / "18 sixty-three", och "18 jämnt" på ,00.
- **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; bara **Ny ledare i träning** kan slås av (under Inställningar och i ljudpanelen på Race Day), eftersom ingen kör mot någon där.
- **Upprop och förskjuten start:** Auto (standard) ropar bilnummer i finaler ("Bil 1, 2, 3") och namn annars; eller välj Namn, Bilnummer eller Bilnummer + namn ("bil 5 Anders"). Bilnumret är startplatsen. Förskjuten start ropar ut varje bil med 3 s mellanrum.
- **Lokal neural röst (Piper, rekommenderas):** 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.
- Tryck **Förgenerera fraser och förarnamn** före racedagen, och igen när du har lagt till nya förare eller ändrat uttalsnamn, röst eller hastighet. Det som redan finns hoppas över. Ett namn som inte är förgenererat skapas första gången det sägs, och tar det för lång tid läser webbläsarens röst det just den gången.
- 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, **senaste varv**, resultat, bästa, gap och **placering sedan start** (▲/▼ i heat och finaler).
- **Senaste varv** byts vid varje passering. I Open Practice, där resultatet bara är bästa varvet, visar leaderboarden senaste varv i stället för resultat.
- En session som rankas på **bästa N varv** (Open Practice på N varv i rad eller X minuter, eller träning eller kval med seeding på bästa N varv) visar bara det regeln rankar på, likadant i alla sessionstyper: placering, förare, resultat (t.ex. "3 varv 55,123"), gap och bästa varv (stapeln för nästa varv finns kvar). Heat på varv och tid, som de flesta kval och alla finaler, behåller alla kolumner.
- **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 tydlig 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.
- **Livemarkeringar** i leaderboard och TV-topplistan: förarens rad blinkar kort vid en ny tid, en bränslepump med tickande klocka visas medan bilen är i depå (sedan stopptiden i 5 s), och en ny mellantid visas i 4 s med ± mot förra. De går på overlay-datorns klocka, och en nyöppnad overlay blinkar aldrig alla rader.
- TV-rubrikskylten har RaceCore-utseende: klubbens logga eller ett rött RC-märke, eventet i små versaler och heatet i Barlow (ett mjukt typsnitt; overlayerna använder det i stället för appens kantiga Orbitron).
- **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.
- **Storlek** (50–150 %) gör OBS-grafiken mindre eller större så att den passar streamen; TV-topplistan, skylten och alla OBS-layouter skalas tillsammans.
- **Kopiera OBS-URL** ger en länk för browser source; valda kolumner och storleken ingår i länken (`?scale=80`), så två streams kan ha olika storlek.
- **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/<läge>` 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.
### Förarregister
- **Förare** listar alla förare grupperade per klass (grupperna fälls ut och ihop; bocka ur **Gruppera per klass** för en lista).
- **Sök** på namn, transponder, märke, klubb eller land, **Klass** för att bara visa en klass och **Sortera på** namn, klass, klubb, transponder eller märke (↑/↓ vänder). Sortering och gruppering sparas i webbläsaren.
- **Land** (valfritt): välj i listan eller skriv ("Sverige", "SE" och "SWE" fungerar också). Föraren får då en liten flagga före namnet i tidtagning, Race Day, overlay och OBS, startlistor, resultat, utskrifter och PDF. Inget land, ingen flagga. Flaggorna ligger i repot (`src/flags`), så de fungerar utan internet. OBS kan stänga av dem med **Visa flaggor**.
- **Markera** förare med rutorna (eller **Markera alla som visas**) och **Radera markerade**; en bekräftelse visar namnen först. Radering, en eller flera, tar också bort förarna från alla heat, deltagarlistor och team.
- **Slå ihop med en annan förare** (redigera föraren): samma person inlagd två gånger. Alla heat, varv, resultat, anmälningar, incheckning, seriepoäng och träningsvarv flyttas till den förare du behåller, och dubbletten tas bort. Bara Race Controller Master kan slå ihop.
- **Samma transponder två gånger i en klass** stoppas (decodern kan inte skilja varven åt). Samma person i en annan klass går bra - varvet går då till den förare som är med i heatet som körs.
### 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)).
- **Resultat som PDF automatiskt** (Inställningar → Utseende & overlay → **Spara resultat automatiskt som PDF**: Av / Varje heat / Bara slutresultatet):
- Race Controller-datorn sparar resultatet 10 s efter målgång i `data/results/<datum>/`. Efter sista finalen sparas även hela slutresultatet. En rättning i Domarvyn sparar om filen.
- Race Day visar "📄 Resultat sparat", och Resultatarkivet har listan **📄 Sparade PDF:er**. Filerna ingår inte i serverbackupen (den gäller databasen), så kopiera mappen om de ska sparas länge.
- **Fråga om utskrift när finalerna är klara** visar knappen **🖨 Skriv ut resultat** när sista finalen är klar. En webbläsare kan inte skriva ut utan klick; vill du ha helt automatisk utskrift kan Chrome startas med `--kiosk-printing`, då skrivs det ut direkt på standardskrivaren när du trycker på knappen.
- **Export/import** (Inställningar → Lagring):
- **📄 CSV för racedagen** (Resultatarkivet: välj samma datum i Från och Till, och en klass eller alla): först en sammanfattning per heat (placering, varv, totaltid, bästa och snittvarv), sedan varje varv i körordning med transponder, varvtid, klockslag och om varvet räknades. Semikolon och UTF-8 med BOM, så Excel öppnar den i kolumner. Varje körd seriedeltävling har en 📄-genväg.
- 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. Andra datorer kan inte ändra racet av misstag: sparar de (byter heat att titta på, eller har en gammal kopia öppen) behåller servern masterns aktiva heat, heatens status och klocka, varven och heat som körts. Ett kört heat går bara tillbaka till Redo via Nollställ. Körda kval och finaler skapas aldrig om av misstag - Rensa genererade ... namnger de körda heaten och frågar först.
- **House of RC:** under Inställningar → System → 🏠 House of RC sparar du klubbens API-nyckel en gång (bara på servern, visas aldrig igen) och trycker **Testa anslutning**. Förare → **🏠 Hämta från House of RC** fyller i namn och märke utifrån transpondrarna (bara det du bockar i), och en känd transponder fyller i en ny förare. Med nyckeln för klubben som arrangerar tävlingen listar Race-guidens **🏠 Hämta från House of RC** klubbens tävlingar; välj tävling och en av dess klasser så fylls namn, datum, klass och anmälda förare med transpondrar i. Senare lägger Hantera → Deltagare → **🔄 Hämta ändringar från House of RC** till sena anmälningar och tar bort avanmälda. **📤 Skicka resultat till House of RC** förhandsgranskar och skickar resultatet till anmälningarna: heat och kval under dagen, slutplaceringen när finalerna är körda. Bara förare som är anmälda på House of RC (med eget konto) får resultat där; övriga listas som inte skickade. Bocka i **Skicka heat automatiskt** så skickar race controller-datorn heat och kval efter varje heat av sig själv (halvlive) och försöker igen utan internet; slutplaceringen skickas alltid för hand.
- **`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)
- **House of RC:** [Hämta anmälda, efteranmälda och skicka resultat](docs/videos/house-of-rc.mkv)
- **Tävlingsdag och mobil:** [En cupdag - incheckning, kval, finaler, rätta en dubblett och dagens CSV](docs/videos/cup-day.mkv) · [Träningsstatistik, Standard/Pro och nästa heat i mobilen](docs/videos/driver-page.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://<ipconfig-adressen>: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://<hostname -I-adressen>: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 -- <backupfil>.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 <port> <decoder-ip>` per decoder. Sätt WebSocket-URL i Inställningar (t.ex. `ws://<serverns-ip>: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. Inga riktiga transpondrar behövs: lägg upp några förare under Register → Förare med påhittade transpondernummer (till exempel 2001, 2002, 2003) och lägg dem i ett heat. Riktiga namn och transpondernummer fungerar lika bra, och då är allt klart till tävlingen. 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.
## Licens
Copyright (C) 2026 RC RaceCore
RC RaceCore är fri programvara: du får använda, ändra och dela den enligt [GNU Affero General Public License v3.0](LICENSE) eller (om du vill) en senare version. Delar du en ändrad version, eller kör en som tjänst som andra använder över nätet, måste du göra din källkod tillgänglig under samma licens. Klubbar som kör RaceCore för sin egen racing, med eller utan egna ändringar, behöver inte göra något. RaceCore levereras utan garanti.
Delar från andra har kvar sina egna licenser: AMMC (`AMMC/LICENCE`, MIT), landsflaggorna från flag-icons (MIT, se `src/flags/`), typsnitten Barlow, Barlow Condensed och Orbitron (SIL Open Font License) och npm-paketen (se respektive paket). Piper-rösterna laddas ner vid installationen och har egna licenser.