Tournament Module

This module is used as an API that handles all the tournament specific data. Data like teams, matches, table names and more.

The API

The API is REST based, And those are the available models.

• team

  {
      number: number,
      name: string,
      affiliation: string, // optional
      cityState: string, // optional
      country: string, // optional
      coach1: string, // optional
      coach2: string, // optional
      judgingGroup: number // optional
      pitNumber: number, // optional
      pitLocation: number, // optional
      translationNeeded: boolean // optional
  }

• match

  {
   matchId: number,
   startTime: date,
   endTime: date,
   stage: string,
   matchTeams: [
     {
       teamNumber: number,
       tableId: number
     }
   ]
  }

• table

  {
   tableId: number,
   tableName: string
  }

And this are the available endpoints for those models:

• GET /model/all - return all the objects
• GET /model/:id - return the object with that id
• POST /model - add a new object (as described later)
• PUT /model/:id - edit the object with that id
• DELETE /model/:id - delete the object with that id

There are 2 more APIs available, the Images API and the Tournament Settings API

The Images API

Used to retrieve images for the Display. Please be noted that the images are retrieved and sent with Base64 encoding.

The endpoint is /image and the available options are:

• GET /all - returns an array of all the images.
• GET /:imageName - returns the image with the specified name The response structure:

  {
     imageName: image-name,
    image: base64 encoding image 
  }

• POST / - Used to add a new image. Body with that structure:

  {
    imageName: image-name,
    image: 
  }

• DELETE /:imageName - Used to delete an image

The Tournament Settings API

There is no option to add a setting with this api. This API is for reading and updating the settings.

• GET /settings/:settingName - Returns the setting with settingName
• PUT /settings/:settingName - Updates the setting with settingName, The body of the request:

  {
     setting: settingContent
  }

Be aware that reading the data is available for all, but updating/deleting/inserting only for certain users.

Publishing to NPM

When you are ready to publish to npm

• run the command yarn publish from the repo root directory.
• You will be asked to update the version number.
• Following that the script will run the build ng build --prod and publish the artifacts to @first-lego-league/tournament.

Notes:

• You must be a member of the npm first-lego-league organization to publish the package.
• Verify version in npm [@first-lego-league/tournament] after the publish has completed (https://www.npmjs.com/package/@first-lego-league/tournament)
• Remember to push package.xml (containing the updated version).

Adding new version to the launcher

Please see the Launcher README for instructions on how to include your update in the launcher build.

Contributing

To contribute to this repository, please make a fork, make your changes and submit a pull request.

This way of work allows us to maintain proper code quality, which is important when working with a large amount of people on the same project.

The best way to work on a feature or a bug is to follow these steps:

• fork the repository to your own github account
• if already forked, make sure your fork is up to date with the base repo
• create a new branch for your feature or bugfix
• work
• test
• create a pull request to merge your development branch into a branch in the base repo
• we will review your pull request, when ok, we will merge it into master