FIRST Tech Challenge Live v1.3.2

Our apologies for releasing several weeks in a row. This is not a required update but contains a few useful bug fixes. Along with a few others, this version fixes a bug that has been present since the beginning of the season that would cause an event to load improperly after it had been completed. If you have an event that has been completed that you cannot access, you can import it into v1.3.2. If you cannot access the event by booting the old copy of the scoring software, you can find the database file in the libs/db/ folder and import that into v1.3.2.

LEAGUE MEETS: if you manually take the database from libs/db/, once you have imported into v1.3.2, you must export it from v1.3.2 for it to import properly into future meets/league tournaments.

Copied from v1.3.0 Release Notes

Upgrading to v1.3.0 or higher is required for League Tournaments, as this fixes a bug with the uploading of League Tournament rankings after the event. This update adds a new step in the event setup process, and a change to editing team info:

During event setup, after the Region Key has been entered or skipped, the software now displays a "Select Event" page. This page shows a list of events the system knows about. They are sorted by country, then state. Find your event in the list and click it. This will bring up a popup with details about the event. In the popup click "Setup" to play that event, which will bring up the previous "Create Event" page with the fields populated, where you can proceed as before. If you cannot find your event in the list, you can use the "Create New Event" link in the top right of the page to reach a blank create form. It is important to note you cannot edit event information in that popup, but can in the form. The info in the popup is displayed to help ensure you select the correct event. If you do not see your event listed, but it is on ftc-events.firstinspires.org, you may need to do a Data Download through "Admin Menu" -> "Manage Server".

When editing team info on the "Add/Edit Teams" page, the data is no longer edited inline, but in a popup. This freed up some extra space on the table and allows some extra functionality. The page will also now show icons next to the team numbers to indicate the registration status of the team. If these icons appear, it will not prevent or hinder the event in any way, but results will likely be delayed in publishing on ftc-events.firstinspires.org. If you edit a team's info, a red sync icon will appear to indicate it is different. If a team is not registered with FIRST, they will appear with a yellow triangle. If a team registered after being added to the event, it will be a red triangle. If there is a red sync or triangle, there will be a "synchronize" button in the edit popup that will replace the contents of the editor with the data from FIRST's master team list. Clicking "save" completes the synchronization operation.

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

Added features

• Added a printable page for all inspection forms that aggregates the notes entered by Inspectors.

Bug Fixes

• Fixes the bug that would cause completed events to throw errors after rebooting the scoring system.

FIRST Tech Challenge Live v1.3.1

This is not a required update but contains a few useful bug fixes. Along with a few others, this version fixes a bug in v1.3.0 that would in some scenarios cause the Match Control Page to erroneously claim that the user was trying to commit invalid match data.

Copied from v1.3.0 Release Notes

Upgrading to v1.3.0 or higher is required for League Tournaments, as this fixes a bug with the uploading of League Tournament rankings after the event. This update adds a new step in the event setup process, and a change to editing team info:

During event setup, after the Region Key has been entered or skipped, the software now displays a "Select Event" page. This page shows a list of events the system knows about. They are sorted by country, then state. Find your event in the list and click it. This will bring up a popup with details about the event. In the popup click "Setup" to play that event, which will bring up the previous "Create Event" page with the fields populated, where you can proceed as before. If you cannot find your event in the list, you can use the "Create New Event" link in the top right of the page to reach a blank create form. It is important to note you cannot edit event information in that popup, but can in the form. The info in the popup is displayed to help ensure you select the correct event. If you do not see your event listed, but it is on ftc-events.firstinspires.org, you may need to do a Data Download through "Admin Menu" -> "Manage Server".

When editing team info on the "Add/Edit Teams" page, the data is no longer edited inline, but in a popup. This freed up some extra space on the table and allows some extra functionality. The page will also now show icons next to the team numbers to indicate the registration status of the team. If these icons appear, it will not prevent or hinder the event in any way, but results will likely be delayed in publishing on ftc-events.firstinspires.org. If you edit a team's info, a red sync icon will appear to indicate it is different. If a team is not registered with FIRST, they will appear with a yellow triangle. If a team registered after being added to the event, it will be a red triangle. If there is a red sync or triangle, there will be a "synchronize" button in the edit popup that will replace the contents of the editor with the data from FIRST's master team list. Clicking "save" completes the synchronization operation.

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

Added features

• The Advancement Report now has an option to show the team name as well as a condensed version for printing.
• Adds a link to the schedule page for printing on the schedule generation page.

Bug Fixes

• Fixes the erroneous "Invalid Data" when committing from the schedule tab.
• Fixes the macOS Catalina printing issue.

FIRST Tech Challenge Live v1.3.0

This release is a required update for League Tournaments, as this fixes a bug with the uploading of League Tournament rankings after the event. This update adds a new step in the event setup process, and a change to editing team info:

During event setup, after the Region Key has been entered or skipped, the software now displays a "Select Event" page. This page shows a list of events the system knows about. They are sorted by country, then state. Find your event in the list and click it. This will bring up a popup with details about the event. In the popup click "Setup" to play that event, which will bring up the previous "Create Event" page with the fields populated, where you can proceed as before. If you cannot find your event in the list, you can use the "Create New Event" link in the top right of the page to reach a blank create form. It is important to note you cannot edit event information in that popup, but can in the form. The info in the popup is displayed to help ensure you select the correct event. If you do not see your event listed, but it is on ftc-events.firstinspires.org, you may need to do a Data Download through "Admin Menu" -> "Manage Server".

When editing team info on the "Add/Edit Teams" page, the data is no longer edited inline, but in a popup. This freed up some extra space on the table and allows some extra functionality. The page will also now show icons next to the team numbers to indicate the registration status of the team. If these icons appear, it will not prevent or hinder the event in any way, but results will likely be delayed in publishing on ftc-events.firstinspires.org. If you edit a team's info, a red sync icon will appear to indicate it is different. If a team is not registered with FIRST, they will appear with a yellow triangle. If a team registered after being added to the event, it will be a red triangle. If there is a red sync or triangle, there will be a "synchronize" button in the edit popup that will replace the contents of the editor with the data from FIRST's master team list. Clicking "save" completes the synchronization operation.

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

Select Event

• A list of events is shown after region key which will pre-populate event data.
• Only shows current week. Use the links above the top left and top right corners of the list to change week.
• The Data Download operation now also updates the list of Events.
• Select Event stage is skippable

Add/Edit Teams

• Icons indicate differences with FIRST registration data as of the last Data Download
• Edit is done in a popup
• Can synchronize data in event of mismatch

Illegal Scoring Protections

• If a robot is marked as no-show, the control page now enforces only one robot can be marked scored for the robot scoring achievements.

Other

• Fix League Tournament rankings upload
• No-show team in elims is no longer struck-through on results page
• Teams that play in an elims match are bolded on results page
• Added third team to scoresheet in elims
• Added button in Display Settings to show in-match view for video calibration
• Additional bug fixes

FIRST Tech Challenge Live v1.2.1

This is a patch for v1.2.0. DO NOT USE v1.2.0. If you have already started your event using v1.2.0, it is strongly recommended that you pause your event, SAVE any match edits, and import into this version (or v1.1.2 if you have it locally). If you are running a Qualifier, DO NOT START ALLIANCE SELECTION BEFORE CORRECTING & COMMITTING ALL MATCHES!

Steps:

1. Finish any in progress matches/actions
2. SAVE any edits, even if you cannot commit the match.
3. Download Event Archive from the Event Dashboard.
4. Shut down v1.2.0 of scoring software
5. Boot this version
6. Use Server Management page to import the downloaded archive.
7. You will need to use the Match History scoresheet to repair any matches. Go to Match Results, then click "View Match History". Select the most recent scoresheet.
8. On the match control page, click the "Enter Scores" or "Edit" button on Control Page's Schedule tab for to corresponding match above, and copy the data from the scoresheet. See this issue for details on these steps.

We are very sorry for this inconvenience. Please post a new issue if you have any additional questions. We are happy to help repair databases posted there.

FIRST Tech Challenge Live v1.2.0

DO NOT USE

FIRST Tech Challenge Live v1.1.2

This is a mandatory update for Qualifiers and League Tournaments. This release is not required for League Meets, but it does fix the edit bug, so we recommend updating. This is NOT approved for Dual-Division or FIRST Championship-advancing events.

This release fixes several bugs, the most notable of which is editing a match no longer clears the scores if the next match has been started.

Known UI issue affecting Google Chrome on macOS and iOS devices

We have received reports that Google Chrome on macOS and iOS devices are rendering some buttons incorrectly by not showing the border (see image below). The buttons still function correctly, and we still recommend using Google Chrome over Safari, etc. because we have observed better connection stability using Google Chrome.

Above, the buttons for Undo and Delivered/Returned and +/- are missing their gray background that indicates that it is a button. The button is still functional.

Important note copied from previous release

A major change we want to highlight for this season:
Built-in upload of event results to FIRST. This requires a Region Token, which Affiliate Partners will receive shortly. As a reminder, please do not share these tokens beyond the people that need them, and please do not post them publicly, including on this GitHub repository - please do not post a full zip of the scoring system as this will contain your key - the log files will not contain your key, and the db file using the "Download Event Archive" button on the dashboard will not contain your key. These tokens are for official events only. Please do not use them for testing or scrimmages (an exception being a scrimmage that is listed on the public Event Search). Now that upload is built in to the scoring software, we are asking for all events to upload data. This includes league meets, which previously did not upload to Schoology.

In addition, now that we are releasing less frequently and are collecting event results in a more centralized manner, it is more important that you utilize the Data Download feature before setting up your event ("Admin Menu" -> "Manage Server"). If you upload an event with any non-registered teams, the results for that event may not appear in the public result set when it is available later this season. (A team is likely not registered if the team info fields appear empty when you add them to an event).

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

UI Changes

• Added Team City and State/Province to awards script.
• Reworked Awards presentation on displays.

Bug Fixes

• Fixed bug where the edit tab on the Match Control Page could show 0-0.
• Fixed bug where TBP showed as "--" on first load of the scoring system.

API Fixes

• Fixed WLT reported on first load of scoring system

Other

• Updated the manuals, etc. shipped with the system on the resources page.

FIRST Tech Challenge Live v1.1.1

This version of the FIRST Tech Challenge Live software fixes several bugs found in v1.1.0. The most important of these being the improper error displayed on upload. Several other issues were fixed, see below for details. The other important part of this release is an update to the league data export format to include Win-Loss-Tie information. To ensure this information gets propagated properly through the rest of the season, please upgrade before your league meets. If you have a league export with no meet data, it is fine to import. If you have previous league meet data from before v1.1.1, the software will upgrade those files appropriately on import. However, if there were any DQs or No-Shows, the automatic upgrade of the export file will not properly reconstruct WLT data. Here are the steps necessary to fix that:

• Import the event into a v1.1.1 system using "Server Management", then go to the event's dashboard and re-download the archive. It is now upgraded and that version can be imported to the next meet via the league import process.

This version is NOT approved FIRST Championship-advancing events nor Dual-Division Events.

Known issue for rankings display on system boot

This will be fixed next release. Issue #428 - When the system reboots, TBP information within the ranking list is not properly restored and will display as "--". The ranking order is correct even though the TBP does not display properly. As soon as a Qualification Match is committed or Alliance Selection starts, another ranking calculation will be performed and the TBP will display properly.

Known UI issue affecting Google Chrome on macOS and iOS devices

We have received reports that Google Chrome on macOS and iOS devices are rendering some buttons incorrectly by not showing the border (see image below). The buttons still function correctly, and we still recommend using Google Chrome over Safari, etc. because we have observed better connection stability using Google Chrome.

Above, the buttons for Undo and Delivered/Returned and +/- are missing their gray background that indicates that it is a button. The button is still functional.

Important note copied from previous release

A major change we want to highlight for this season:
Built-in upload of event results to FIRST. This requires a Region Token, which Affiliate Partners will receive shortly. As a reminder, please do not share these tokens beyond the people that need them, and please do not post them publicly, including on this GitHub repository - please do not post a full zip of the scoring system as this will contain your key - the log files will not contain your key, and the db file using the "Download Event Archive" button on the dashboard will not contain your key. These tokens are for official events only. Please do not use them for testing or scrimmages (an exception being a scrimmage that is listed on the public Event Search). Now that upload is built in to the scoring software, we are asking for all events to upload data. This includes league meets, which previously did not upload to Schoology.

In addition, now that we are releasing less frequently and are collecting event results in a more centralized manner, it is more important that you utilize the Data Download feature before setting up your event ("Admin Menu" -> "Manage Server"). If you upload an event with any non-registered teams, the results for that event may not appear in the public result set when it is available later this season. (A team is likely not registered if the team info fields appear empty when you add them to an event).

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

UI Changes

• Added ability to mute randomization sound and results video
• The randomization sound is now one sound for all randomization values.

Bug Fixes

• Fixed bug where system would report that an upload had failed when it had succeeded
• Fixed missing randomization sound
• Other small bugs

API Changes

• Win-Loss-Tie has been added to the API and are reported in the rankings list
  • Because WLT was not stored before v1.1.1, League/League Tournament Rankings may not be accurate. See notes in the swagger documentation for more information.

Other

• Updated the manuals shipped with the system on the resources page.

FIRST Tech Challenge Live v1.1.0

This is the first official version of the FIRST Tech Challenge Live software for the 2019-2020 SKYSTONE season. If you are running an official event, you MUST upgrade from v1.0.0 BEFORE CREATING YOUR EVENT. This version is NOT backwards compatible. We are sorry for any inconvenience this may cause. This version is NOT approved for FIRST Championship-advancing events.
A detailed change log can be found below. A major change we want to highlight for this release:

• Built-in upload of event results to FIRST. This requires a Region Token, which Affiliate Partners will receive shortly. As a reminder, please do not share these tokens beyond the people that need them, and please do not post them publicly, including on this GitHub repository - please do not post a full zip of the scoring system as this will contain your key - the log files will not contain your key, and the db file using the "Download Event Archive" button on the dashboard will not contain your key. These tokens are for official events only. Please do not use them for testing or scrimmages (an exception being a scrimmage that is listed on the public Event Search). Now that upload is built in to the scoring software, we are asking for all events to upload data. This includes league meets, which previously did not upload to Schoology.

In addition, now that we are releasing less frequently and are collecting event results in a more centralized manner, it is more important that you utilize the Data Download feature before setting up your event ("Admin Menu" -> "Manage Server"). If you upload an event with any non-registered teams, the results for that event may not appear in the public result set when it is available later this season. (A team is likely not registered if the team info fields appear empty when you add them to an event).

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

Event Uploading & Region Keys

• Affiliate Partners will receive a Region Key that will be used to authenticate the scoring software to upload event results. This replaces the previous Schoology system.
• "Create Event" has been replaced with "Setup Event" The setup event screen prompts you for a Region Key. If you are testing the scoring software or do not have a key at the time, you may skip this step. If you skip,you will still need to enter the key before uploading results.
• After entering a key or skipping that step, it will bring up the familiar event creation form. This form now has a "Region" field. If you entered a key, it will auto-fill to the proper region.
• The event dashboard now has a "Submit Results to FIRST" step. When your event is complete, use that page to submit results. If you do not have internet access at your event, you can still do it later when you do.
• See the documentation for more details on how to use this feature.

Test Mode

• We revamped the Test Match system with what is called "Test Mode"
• Test Mode is entered and exited through a button on the Settings Tab of the Control Page.
• When in Test Mode, only Test Matches can be run. They no longer linger if not completed, and can go through the full match life cycle.
• You can create Test Matches from a button on the Schedule Tab. It brings up a popup, where you can enter any teams and select a field. It defaults to negative test team numbers, but you may set it to any teams at the event.
• Exit Test Mode to return to normal functionality. Swapping to or from Test Mode will lockout referees, so make sure they have submitted results before changing mode.

Other New Features

• Match Control Page Schedule Tab shows field number. Note: Finals Matches are played on field 0 (zero), which means that it will be appear on every field. This is the same behavior as prior versions.
• Cycle Time Report Graphs - The cycle time report shows histograms of the match cycle times.
• Referee Submit Indicator - The control page indicates when a referee submits review. The alliance list in the "active" match bar at the top will turn green when that referee has submitted review. It will also list who has not submitted in the yellow lockout bar on the score edit page.
• Cache-Control Header - This header has been added to all resources, which should help load time if a display is reloaded.
• 3rd Party API CORS has been added

Bug Fixes

• Re-randomization warning updated for SKYSTONE
• Post Match video is muted if the display is muted
• The Rankings & Results screen has been repaired
• Editing teams has been repaired
• Display field binding has been fixed
• Field displays don't show results & rankings and only show the key when idle.
• URL for websocket apiv2 endpoint has been corrected.
• Other small bugs

FIRST Tech Challenge Live PREVIEW v1.0.0

Scoring System PREVIEW v1.0.0

This version of the scoring system is intended as a preview for the SKYSTONE season. Please do not run official events with this version of the scoring system. Consider this version an open beta for the community to work with ahead of a formal release, including a user-guide, in early October. Please continue to report any bugs/enhancement requests to the GitHub Issue Tracker. We have included a detailed change list below.

Documentation (not updated)

  FTC Scorekeeper Manual v0.5.1.1
  Reference Documentation for Scorekeeping Software (Google Drive)

SKYSTONE Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Display Improvements:

• Updated graphics to be 42% prettier than last year

• Many behind the scenes structural changes to improve the stability of displays and ref page connections and timing

• Added graphic to the scoring display that explains the live scoring graphics (Audience Key)

  • On the Match Control Page, on the Video Switch tab, under “Other Displays” there is a button for “Show Audience Key”. The key will be show on any display that is not running a match, etc.
    

• Many display settings

  • Checkboxes are now larger
  • Can swap alliances to be red on left (in case camera/display is on the opposite side, etc)
  • Can move the scoring/timing bar to the top (in case the camera feed is centered down)
  • New Alliance Selection option (Hybrid) for overlay - allows camera feed with alliance info
    

• Improved Randomization Screens

  • Each of the 6 dice rolls has a distinct and consistent sound effect
  • Randomization screens contain markers pointing to the alliances and field walls to make clearer what the orientation is
    

• Improved Timeout visualization across all screens

• Added current phase indicator to the Audience Display

• Pit displays now highlight changes in real time and scroll continuously without jumps

• Displays now show a warning if they have lost connection to the scoring system.

• Displays that are logged in with an account that only has access to displays (such as the default display accounts) will automatically sign themselves back in if the system is rebooted.

• Displays can log themselves in by appending “?username=&pw=” to the URL. Useful for logging in when interacting with the display is difficult. Only works for accounts whose only permission is Display.

• Can now display blank/splash screen. From Video Switch tab select “Show Blank Screen”

• Can show Wi-Fi reminder. From Video Switch tab select “Show Wifi Reminder”
  

Inspection Improvements

• Added custom inspection-like tracking
  • From the Event Dashboard->”Configure Inspection/Judging Tracking” you can add new activities to be tracked. For example, Team Photo, etc.
  • The custom items can be included in the schedule
• Inspection Schedule can be printed

Awards Improvements:

• Dean’s List now shows properly and allows submitting multiple names
• Custom awards can have as many winner/runner-up as desired
• Award entry page saves in real time (no need to press “Edit” and “Save” as last year)
• There is now a judge role that allows the user to edit, but not present, awards.
• System now alerts the user to teams that have been assigned multiple awards by highlighting the awards orange.

Referee Improvements

• Added ability to edit pre-match info (no show vs present) once submitted
• Added “Submit Review” button at the top of the page - use if you know everything is correct
• When a match is aborted, ref pages are taken back to the initialization phase
• Ref pages now show a warning if they have been disconnected from the scoring system.
• Added the option to require Referees to actively confirm all choices
  • By default this is disabled. To enable, on the Match Control Page on the settings tab under the “Live Scoring” options check the box for “Require Referee Active Confirmation”.
  • Referee will not be able to submit autonomous and review until all fields have been entered. This means selecting “None” if nothing happens, or decrementing the counter so that it goes from blank to 0.
    

Misc.

• The control page now updates when the match schedule is generated
• Sponsor changes:
  • Custom sponsors no longer have images
  • All regional sponsors show together then all event sponsors show together
  • Sponsors can be imported using the db file from a previous event. All old sponsors will be added. Only works with db files from this year (SKYSTONE)
• Added ability to download all scoresheets as a zip file.
  • From the match results page, users logged in as an event admin can now download a zip of the scoresheets.
• The default/generated accounts only have access to the event they were created for
• Updated to new rankings system (See game manual part 1)
  • Now display average Ranking/TieBreaker points
• Improved memory usage in some settings
• Bug fixes. Lots and lots of bug fixes.

Third-party API improvements (see documentation for more info)

• The api now contains detailed documentation at <ip>/swagger-docs/api.html
  • Includes interactive “Try it out” feature that lets you interact with the API from the browser.
• Api has been refactored from /apiv1/ to /api/v1/ but maintains backward compatibility. V2 routes are at /api/v2/ only.
• Added rate limiting to preserve the rest of the system
• Added API key request system
• Added websocket route for receiving match state change information (match start, match commit, match abort)
  • Known bug: the websocket route was intended to be at /api/v2/stream/ but due to a type is located at /apiv2/stream/ this will be corrected in a later release.
• Added match times to the API
• Added inspection status to API
• Important Changes:
  • Fixed match breakdown penalty scores. Previously they were shown for the alliance that committed the penalty. This has been changed to show them for the alliance that received the points.
  • Api v1 awards has been deprecated. We encourage you to use the v2 version.

FIRST Tech Challenge Live v0.8.3

This release adds new infrastructure for the control page, displays, and referee pages to communicate with the server that should reduce latency and overhead as well as remove the limit on numbers of these pages on the same device. Previously, you could not run 2 displays and a control page from the same browser, but this update should allow this operation. This also fixes a sessions-related memory leak in the api.