simple-timekeeping

Simple time keeping to be used on two computers

Intro

This application is used to measure times of a race, where start and finish is not at the same location. There is no network connection required between the start and finish. Best is if the race has interval starts. E.g. a cycling hill climb. The application has a German UI.

Build

1. Run npm i to install dependencies
2. Run npm run bundle to build and bundle the scripts (or npm run bundle:win on windows)
3. Find the bundled script ./dist/Zeitmessung.html

Test

Use npm run test to run the tests. Code coverage reports are directed to ./coverage.

How to use

The resulting scripts are located in ./dist-directory. Start Zeitmessung.html (can be on different computers, due to start and finish not at the same location)

Register participants

1. Select "Startliste" from the top menu
2. Click "Neue Liste" to start a new list. Any previous list will be exported as backup
3. Click "Laden" if you need to reload from local storage (e.g. if the browser was closed). The storage is updated after each manipulation
4. Export once finished, or to make a backup
5. Select a file to continue on an existing list

At the end of an export, there are 20 spare places to be used for late registrations. They can be edited at the start.

Measure times

1. Select "Zeitmessung" from the top menu
   1. once for the starting times: select "Start" in the dropdown
   2. once for the finishing times: select "Finish" in the dropdown
2. Select the participant list which was exported in the previous section
3. Click to capture start/finish time for the given number plate. If there is a mistake, times can be edited manually
4. Click export to safe the results to a .json-file once done, or to make a backup

• Click "Laden" if you need to reload from local storage (e.g. if the browser was closed). The storage is updated after each manipulation
• With the file selection it is also possible to load a backup of already registered times instead of the participant list
• Spare participants can be edited at the start (name and category).

Evaluate results

Once all participants are registered at the start and finished and both files are present. Proceed like this:

1. Correct the category in the "Start" file if some of the spares were female (set category: "Female")
2. Select "Auswertung" from the top menu
3. Import start- and finishing time files (the ones generated above)
4. Click "Auswerten" ("Evaluate")
5. See the result table as well the exported results as .json and .csv

Possible improvements

• Export results in more file formats
• Save to (cloud) database instead of files
• Increase test coverage
• Make categories configurable
• Register more data at the start list (e.g. team name)