docs: stint cards, Standard/Pro mobile view and overlay live marks
This commit is contained in:
1 parent
f1a80a0724
commit
3e78db9156
3 files changed
+33
-1
No files matched your search
@@ -243,6 +243,7 @@ Rookie gets its own standings with the series' points table, count rule and club
|
|||||||
- personal best, averages and consistency;
|
- personal best, averages and consistency;
|
||||||
- best 3 consecutive laps and the best 5-minute result;
|
- best 3 consecutive laps and the best 5-minute result;
|
||||||
- stint analysis, 30-minute pace blocks and setup markers with before/after comparison;
|
- stint analysis, 30-minute pace blocks and setup markers with before/after comparison;
|
||||||
|
- **practice stints that fold out** to every lap time: laps, best, average, total time and spread per stint; the stint's fastest lap green, the day's fastest purple, slow laps red and the out lap after a break marked;
|
||||||
- daily history and achievements;
|
- daily history and achievements;
|
||||||
- goals with rewards, daily challenges and a shared club goal.
|
- goals with rewards, daily challenges and a shared club goal.
|
||||||
- **Based on: Practice** (default), **Races** or **All.** Race laps are kept separate and marked 🏁 with race, session and series. Under Races they are listed per race session; a race never forms stints.
|
- **Based on: Practice** (default), **Races** or **All.** Race laps are kept separate and marked 🏁 with race, session and series. Under Races they are listed per race session; a race never forms stints.
|
||||||
@@ -250,6 +251,7 @@ Rookie gets its own standings with the series' points table, count rule and club
|
|||||||
|
|
||||||
**Mobile profile:**
|
**Mobile profile:**
|
||||||
- Each driver can get a personal link with a QR code. It shows their own statistics, a practice timer, setup markers and exercises (even laps, step training), and has a choice of practice or race laps.
|
- Each driver can get a personal link with a QR code. It shows their own statistics, a practice timer, setup markers and exercises (even laps, step training), and has a choice of practice or race laps.
|
||||||
|
- A **Standard / Pro** switch at the top. **Pro** is a clean practice view without goals or settings: today's laps, stints, driving time, best, average and personal best, then the stint cards that fold out to every lap. The choice is remembered on the phone and can be linked with `?mode=pro`.
|
||||||
- The link uses a random token; no transponders or other drivers are shown.
|
- The link uses a random token; no transponders or other drivers are shown.
|
||||||
- For use over the internet, set the **public address** once for everyone under Settings → System & backup → Public address (domain / DynDNS), e.g. `https://club.dyndns.org:8443`. Left empty, links use the local network address.
|
- For use over the internet, set the **public address** once for everyone under Settings → System & backup → Public address (domain / DynDNS), e.g. `https://club.dyndns.org:8443`. Left empty, links use the local network address.
|
||||||
- Proxy only these paths to the internet: `/public-training/*`, `/src/public_training.js` and `/src/public_training.css`. Ready-made Teltonika files are in `scripts/teltonika/`.
|
- Proxy only these paths to the internet: `/public-training/*`, `/src/public_training.js` and `/src/public_training.css`. Ready-made Teltonika files are in `scripts/teltonika/`.
|
||||||
@@ -277,6 +279,8 @@ Settings → Audio:
|
|||||||
The **Overlay** menu has leaderboard, speaker, results, TV and team modes, plus an OBS mode with layout (leaderboard, TV graphics, grid, lower third), theme (panel, transparent, chroma), rows and columns:
|
The **Overlay** menu has leaderboard, speaker, results, TV and team modes, plus an OBS mode with layout (leaderboard, TV graphics, grid, lower third), theme (panel, transparent, chroma), rows and columns:
|
||||||
- Columns: laps, result, best, gap, and **places since the start** (▲/▼ in heats and finals).
|
- Columns: laps, result, best, gap, and **places since the start** (▲/▼ in heats and finals).
|
||||||
- **TV graphics:** a title plate top left (event and heat) and a timing tower top right with the clock on top and real columns: place / **start position** (e.g. "2 / 3"), driver, laps, time, best and gap, in large bold type with podium colours for the top three. No backdrop of its own, so the camera image shows through. The start position can be turned off and is not shown in practice.
|
- **TV graphics:** a title plate top left (event and heat) and a timing tower top right with the clock on top and real columns: place / **start position** (e.g. "2 / 3"), driver, laps, time, best and gap, in large bold type with podium colours for the top three. No backdrop of its own, so the camera image shows through. The start position can be turned off and is not shown in practice.
|
||||||
|
- **Live marks** in the leaderboard and the TV tower: a driver's row flashes briefly on a new time, a fuel pump badge with a ticking clock shows while the car is in the pits (then the stop time for 5 s), and a new split shows for 4 s with ± against the previous one. They run on the overlay computer's clock, and a freshly opened overlay never flashes every row.
|
||||||
|
- The TV title plate has the RaceCore look: the club logo or a red RC mark, the event in small capitals and the heat in Orbitron.
|
||||||
- **Click a driver** in RaceCore's own overlay to open that driver's training stats (the stand-alone overlay window opens them in a new tab). The public overlay has no such links.
|
- **Click a driver** in RaceCore's own overlay to open that driver's training stats (the stand-alone overlay window opens them in a new tab). The public overlay has no such links.
|
||||||
- **Copy OBS URL** gives a browser-source link; the chosen columns are part of the link.
|
- **Copy OBS URL** gives a browser-source link; the chosen columns are part of the link.
|
||||||
- **Overlay windows are read-only:** they do not connect to the decoder and never save, so an overlay on another computer (or in OBS) cannot disturb the race run from Race Day. No admin PIN is needed for that. Run Race Day in one browser at a time.
|
- **Overlay windows are read-only:** they do not connect to the decoder and never save, so an overlay on another computer (or in OBS) cannot disturb the race run from Race Day. No admin PIN is needed for that. Run Race Day in one browser at a time.
|
||||||
|
|||||||
@@ -256,6 +256,7 @@ Rookie får en egen ställning med seriens poängtabell, räkneregel och klubbre
|
|||||||
- personbästa, snittider och jämnhet;
|
- personbästa, snittider och jämnhet;
|
||||||
- bästa 3 varv i följd och bästa 5-minutersresultat;
|
- 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;
|
- 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;
|
- dagshistorik och utmärkelser;
|
||||||
- mål med belöningar, dagliga utmaningar och ett gemensamt klubbmål.
|
- 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.
|
- **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.
|
||||||
@@ -263,6 +264,7 @@ Rookie får en egen ställning med seriens poängtabell, räkneregel och klubbre
|
|||||||
|
|
||||||
**Mobilprofil:**
|
**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.
|
- 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.
|
||||||
|
- 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.
|
- 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.
|
- 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/`.
|
- 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/`.
|
||||||
@@ -290,6 +292,8 @@ Inställningar → Ljud:
|
|||||||
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:
|
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).
|
- 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.
|
- **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.
|
||||||
|
- **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 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.
|
- **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.
|
- **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.
|
- **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.
|
||||||
|
|||||||
@@ -488,6 +488,28 @@ Owns:
|
|||||||
- side panels
|
- side panels
|
||||||
- overlay leaderboard rows
|
- overlay leaderboard rows
|
||||||
|
|
||||||
|
### `src/overlay_live_marks.js`
|
||||||
|
Type:
|
||||||
|
- pure overlay live-mark state and markup
|
||||||
|
|
||||||
|
Owns:
|
||||||
|
- detecting a new passing, split, pit entry and pit exit per row between renders, on the client clock
|
||||||
|
- passing flash class with a negative animation delay so re-renders continue the animation
|
||||||
|
- pit badge (fuel icon, ticking clock, then stop time for 5 s) and split chip (4 s, ± delta)
|
||||||
|
- `refreshLiveMarkNodes()` for the 250 ms overlay tick: updates pit clocks and removes expired marks without a re-render
|
||||||
|
- the shared `overlayLiveMarks` instance used by `src/overlays.js`
|
||||||
|
|
||||||
|
### `src/stint_laps_view.js`
|
||||||
|
Type:
|
||||||
|
- pure stint lap-card renderer
|
||||||
|
|
||||||
|
Owns:
|
||||||
|
- per-lap rows: stint best (green), day best (purple), slow (>115% of median), out lap after a break
|
||||||
|
- fold-out `<details>` cards with laps, best, average, total time and spread
|
||||||
|
- keeping open cards open across re-renders (`openStintLapCardIds`)
|
||||||
|
|
||||||
|
Used by `src/training_views.js`. `src/public_training.js` holds an inlined copy (the public page must load as one file through the router allowlist); `tests/stint_laps_view.test.js` checks that the two render identically.
|
||||||
|
|
||||||
### `src/session_replay.js`
|
### `src/session_replay.js`
|
||||||
Type:
|
Type:
|
||||||
- pure transient replay logic
|
- pure transient replay logic
|
||||||
@@ -747,11 +769,13 @@ Type:
|
|||||||
Owns:
|
Owns:
|
||||||
- fetching profile data from `GET /public-training/api/:shareToken`
|
- fetching profile data from `GET /public-training/api/:shareToken`
|
||||||
- posting only class-scoped setup markers to `POST /public-training/api/:shareToken/markers`
|
- posting only class-scoped setup markers to `POST /public-training/api/:shareToken/markers`
|
||||||
- rendering one person's sanitized statistics, pace chart, recent stints, goals, rewards, and daily history with a class selector
|
- rendering one person's sanitized statistics, pace chart, recent stints with per-lap times, goals, rewards, and daily history with a class selector
|
||||||
- hiding optional sections according to the server-provided share visibility map
|
- hiding optional sections according to the server-provided share visibility map
|
||||||
- switching between class-specific statistics without combining lap performance across classes
|
- switching between class-specific statistics without combining lap performance across classes
|
||||||
- local 20-minute practice timer with 10-minute push/control phases
|
- local 20-minute practice timer with 10-minute push/control phases
|
||||||
- token-scoped start-age and bounded-window polling for aggregate lap count, best lap, and average during the personal timer; using an age avoids mobile/server clock-skew errors and the bounded window freezes results after the timer finishes
|
- token-scoped start-age and bounded-window polling for aggregate lap count, best lap, and average during the personal timer; using an age avoids mobile/server clock-skew errors and the bounded window freezes results after the timer finishes
|
||||||
|
- Standard / Pro mode (`?mode=pro`, remembered in `localStorage` key `rcPublicTrainingMode`); Pro shows only today's practice numbers and the fold-out stint cards
|
||||||
|
- an inlined copy of `src/stint_laps_view.js` between the marked copy comments; the file must have no imports
|
||||||
- Swedish/English copy selected by `lang` query or browser locale
|
- Swedish/English copy selected by `lang` query or browser locale
|
||||||
|
|
||||||
Important isolation:
|
Important isolation:
|
||||||
|
|||||||
Reference in new issue
Block a user