signalk-race-control 0.6.0 → 0.8.0

package/README.md

@@ -87,7 +87,10 @@ and a live projected finishing order — during and after the race.
   ended up as the name.
 - **Editable finish times** — click **Now** to record a finish as it happens, type a
   specific `HH:MM:SS` into the finish-time field to correct a mistimed click, or
-  **Clear** to undo. Handles races that cross midnight.
+  **Clear** to undo. Handles races that cross midnight. **DNS** marks a boat as never
+  having started at all, distinct from **DNF** (started but didn't finish) — both show
+  up as their own status in the Excel export and rank last, and either one can be
+  undone the same way. Recording a real finish time clears either.
 - **Start timer** — once a start line is set and a start is scheduled, an expandable
   **Start timer** panel shows a countdown to the gun alongside three live numbers for
   this vessel specifically (from its own SignalK GPS/speed, not any other tracked
@@ -99,9 +102,15 @@ and a live projected finishing order — during and after the race.
 - **Course & chart** — enter lat/lon for the start line, an ordered list of rounding
   marks, and the finish line (or click **Use my position** if you're sitting at that
   spot, or type a name to autocomplete against existing SignalK waypoints — e.g. ones
-  already placed from a chart plotter — and pick one to fill in its position). The
-  webapp draws them on a built-in chart, overlaid with each AIS-tracked boat's
-  recorded track for the current race — drag the **replay** slider to step back
+  already placed from a chart plotter — and pick one to fill in its position; typing
+  lat/lon directly works just as well). Every other known waypoint (not part of this
+  race's own course) shows on the chart too, as a small dim pin with its name, so it's
+  there to reference — or type into a mark's name field — even before it's used.
+  The chart itself is a real background map, like freeboard-sk's: it uses whatever
+  tile-based chart resource this SignalK server has registered, or falls back to public
+  OpenStreetMap + OpenSeaMap tiles when none is configured (same fallback freeboard-sk
+  itself uses). Overlaid on it is each AIS-tracked boat's recorded track for the current
+  race — drag the **replay** slider to step back
   through it, or leave it on **Live**. Click **Play** to have it step through on its own
   instead, at whatever speed the adjoining slider is set to (1x-60x); it starts over
   from the earliest recorded position when played from Live (there's nothing to play
@@ -115,7 +124,10 @@ and a live projected finishing order — during and after the race.
   back to just the last real position (no ring) instead of interpolating across a gap
   longer than 5 minutes — AIS dropping out, or a mark rounding recorded far from any
   real fix — since a straight line across a gap that long would be a guess, not an
-  estimate. The course is also published as SignalK
+  estimate. A notable pickup in speed between two consecutive samples (a gust, better
+  trim, planing) is marked right on the track as a ring in that boat's own colour, sized
+  a bit larger for a bigger jump — hover it for the exact speed reached. The course is
+  also published as SignalK
   waypoint/route resources for any chart plotter (e.g. freeboard-sk) that reads the
   standard resources API — both directions (reading existing waypoints for the
   autocomplete, and publishing the saved course) only do anything if your server has a
@@ -140,13 +152,17 @@ and a live projected finishing order — during and after the race.
   rounding.
 - **Stop / call off the race** — freezes elapsed/corrected time for everyone without
   touching boats, finish times, or the course (unlike Reset, which clears the race
-  back to not-started), and marks every boat that hadn't finished as **DNF**,
-  capturing its last known AIS position if one's available. You can also schedule a
-  call-off for a future time (mirrors Schedule Start), and mark or un-mark an
-  individual boat DNF by hand at any point, independent of the whole race. There's no
+  back to not-started), and marks every boat that hadn't finished or already been
+  marked DNS as **DNF**, capturing its last known AIS position if one's available. You
+  can also schedule a call-off for a future time (mirrors Schedule Start), and mark or
+  un-mark an individual boat DNF or DNS by hand at any point, independent of the whole
+  race. There's no
   true pause: **Resume** discards the stop, un-DNFs everyone it DNF'd, and the clock
   jumps straight back to real elapsed time — the time spent stopped isn't excluded
   from anyone's result. Recording a real finish time on a DNF'd boat clears its DNF.
+  Also happens automatically the moment every boat has either finished or been marked
+  DNF — nothing left to time, so the race calls itself off rather than sitting there
+  with an idle clock until someone remembers to click Stop.
 - **Compare to a "self" boat** — click the star next to a boat's name to mark it as
   self. Every other boat then shows, in the **vs Self** column: a live-ticking
   countdown to the moment self would tie them on corrected time if that boat has
@@ -155,10 +171,15 @@ and a live projected finishing order — during and after the race.
   both have finished. With no boat marked self, the column instead compares everyone
   against the current **leader** (tagged accordingly), so it's never just blank.
 - **Export to Excel** — a genuine `.xlsx` snapshot of the current standings (same
-  ranking, same rows as the on-screen table: rank, boat, sail number, MMSI, TCF,
-  start time, elapsed, corrected, finish time, status), with the time columns
-  rendered in your browser's own timezone rather than the server's (and with the
-  date included, for a multi-day race).
+  ranking, same rows as the on-screen table: rank, boat, sail number, MMSI, TCF, start
+  time, finish time, elapsed, corrected, status), with the time columns rendered in
+  your browser's own timezone rather than the server's (and with the date included,
+  for a multi-day race). Start/finish are real date-time cells, and Elapsed/Corrected
+  are live formulas from them (elapsed × TCF), not numbers baked in at export time —
+  correct a start or finish time directly in the spreadsheet afterward and the rest
+  recalculates. Left blank for a boat with no finish time (DNF, DNS, or still racing)
+  rather than a snapshot of elapsed-so-far that would go stale the moment the file is
+  reopened later.
 - **Download Offline Timer** — a single self-contained `.html` file, seeded with the
   current race's boats, TCF, and multi-day setting, that runs the core of race timing
   (start/stop/resume/reset, add/remove boats, edit TCF, individual start times,