🏒 HockeyPickup.Api

🌈 Overview

HockeyPickup.Api is the core backend for HockeyPickup.

The main technology stack platform is .NET Core 9.0.

🛠 Prerequisites

• Install Visual Studio 2022 (preview) or later, or Visual Studio Code. Ensure that $ dotnet --version is at least 9.0.

⌨️ Install, Build, and Serve the Site

Create a new file at the root of the HockeyPickup.Api project named appsettings.json with the following contents:

1. Get the <DatabaseConnectionString> from a local instance of SQL Server.

2. Get the <ServiceBusConnectionString> from Azure portal. Currently Service Bus is not available to run locally.

3. <InviteCode> can be any string, required to register a new account.

4. Create a <JWTBase64Key>: $ openssl rand -base64 32

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information",
      "Microsoft.AspNetCore.Mvc.ApiExplorer": "Debug"
    },
    "Console": {
      "IncludeScopes": true,
      "LogLevel": {
        "Default": "Debug",
        "System": "Information",
        "Microsoft": "Information",
        "Microsoft.AspNetCore.Mvc.ApiExplorer": "Debug"
      }
    }
  },
  "AllowedHosts": "*",
  "WEBSITE_CONTENTAZUREFILESCOMPATIBILITYOVERRIDE": 1,
  "ConnectionStrings": {
    "DefaultConnection": "<DatabaseConnectionString>",
    "ServiceBusConnectionString": "<ServiceBusConnectionString>"
  },
  "JwtSecretKey": "<JWTSecretKey>",
  "JwtIssuer": "HockeyPickupApi",
  "JwtAudience": "https://api.hockeypickup.com/api/",
  "ServiceBusCommsQueueName": "comms-dev",
  "ServiceBusHealthCheckQueueName": "health-dev",
  "RegistrationInviteCode": "<InviteCode>"
  }
}

Install the packages

$ dotnet restore
$ dotnet tool restore

Open HockeyPickup.Api.sln solution in Visual Studio, and build the solution.

You'll see output in the console showing the various local URL access points.

Swagger root https://localhost:7042/index.html

GraphQL root https://localhost:7042/api/graphql

🧪 Unit Testing

Unit testing and code coverage are setup and must be maintained. To run the tests and generate a coverage report, run the Powershell script from the command line.

$ powershell ./scripts/RunTests.ps1

This generates a coverage report in HockeyPickup.Api.Tests/coverage-html. Open index.html to view the report.

📮 Making requests via Postman

Postman is a useful tool for testing Apis.

🎁 Versioning

HockeyPickup.Api uses sementic versioning, starting with 1.0.0.

The patch (last segment of the 3 segments) is auto-incremented via a GitHub action when a pull request is merged to master. The GitHub action is configured in .github/workflows/hockeypickup-api-version.yml. To update the major or minor version, follow the instructions specified in the bumping section of the action - use #major or #minor in the commit message to auto-increment the version.

❤️ Contributing

We welcome useful contributions. Please read our contributing guidelines before submitting a pull request.

📜 License

HockeyPickup.Api is licensed under the MIT license.

hockeypickup.com