TrueVote.Api

🌈 Overview

TrueVote.Api is the core backend for TrueVote.

The main technology stack platform is .NET Core 8.0.

🛠 Prerequisites

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

⌨️ Install, Build, and Serve the Site

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

{
"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"
}
}
},
"SystemAdminNsecs": [
"<nsec>"
],
"ServiceNsecs": [
"<nsec>"
],
"AllowedHosts": "*",
"WEBSITE_CONTENTAZUREFILESCOMPATIBILITYOVERRIDE": 1,
"AzureWebJobsStorage": "UseDevelopmentStorage=true",
"ServiceBusCommsQueueName": "comms-dev",
"ServiceBusHealthCheckQueueName": "healthcheck-dev",
"JWTSecret": "<JWTBase64Key>",
"ConnectionStrings": {
"DefaultConnection": "AccountEndpoint=https://localhost:8081/;AccountKey=<AccountKeyFromCosmosDBEmulator>",
"CosmosDbConnectionString": "AccountEndpoint=https://localhost:8081/;AccountKey=<AccountKeyFromCosmosDBEmulator>",
"ServiceBusConnectionString": "<ServiceBusConnectionString>"
}
}

Replace the names:

1. <AccountKeyFromCosmosDBEmulator> Retrieve the actual account key from the CosmosDB Emulator start page.

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

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

Install the packages

$ dotnet restore
$ dotnet tool restore

Open TrueVote.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:7253/swagger/index.html

GraphQL root https://localhost:7253/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 TrueVote.Api.Tests/coverage-html. Open index.html to view the report.

📮 Making requests via Postman

Postman is a useful tool for testing Apis. TrueVote has a hosted workspace containing a collection of useful example endpoints and their usage.

Sign in with Nostr is supported via a locally running sign-in service.

🎁 Versioning

TrueVote.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/truevote-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

TrueVote.Api is licensed under the MIT license.

truevote.org