Skip to content

maubertin/nl-covid19-notification-app-backend

 
 

Repository files navigation

Covid19 Notification App Backend

Introduction

This repository contains the backend code for the Proof of Concept for the Dutch exposure notification app. We provide this code in an early stage so that everyone can follow along as we develop the app, and to solicit feedback. Note that due to the early stage in which we are sharing this code, significant portions of the code might still change. We might add or remove features and code as needed, based on validation and user tests that are conducted partially in parallel to the development.

Development & Contribution process

The core team works on the repository in a private fork (for reasons of compliance with existing processes) and will share its work as often as possible.

If you plan to make non-trivial changes, we recommend to open an issue beforehand where we can discuss your planned changes. This increases the chance that we might be able to use your contribution (or it avoids doing work if there are reasons why we wouldn't be able to use it).

Running a standalone server

Local development support is provided for all platforms - Windows, macOS, Linux - by ServerStandAlone - a .NET Core MVC Web App, and the command line apps in the Data Utilities folder.

Development Tools

  • Visual Studio 2019 (or Rider)
  • Your choice of SQL Server instances

Supporting local mobile app development

First make sure that you have the following installed:

  1. Dotnet Core 3.1 SDK: https://dotnet.microsoft.com/download/dotnet-core/3.1
  2. Node JS 12.18.1+ with NPM: https://nodejs.org/en/
  3. Yarn: https://yarnpkg.com/
  4. Angular CLI: https://angular.io/guide/setup-local
  5. Optionally either Visual Studio or Rider.
  6. A terminal is recommended, if you're running an older windows then https://cmder.net/ is useful. You need gitbash.

Then clone this repo.

Standalone

  1. Setup a database instance. Windows users can use a local SQL Server.
  2. Add an appsettings.Development.json file. This overrides the settings in appsettings.json. And add a value for the MSS connection string.
  3. Go to the ServerStandAlone folder and run it with 'dotnet run'.

Docker

To quickly start a Standalone development environment you can use of the docker-compose file:

# Solution root
cd docker
docker-compose up --build

ICC Portal

The ICC Portal consists of a .Net Core backend found under ICCBackend and an Angular / ASP.Net MVC Core frontend found under ICCPortal

ICC Portal backend

  1. Setup a database instance. Windows users can use a local SQL Server.
  2. Add an appsettings.Development.json file to the folder ICCBackend. This overrides the settings in appsettings.json. And add a value for the MSS connection string.
  3. Go to the \ICCBackend folder and run it with dotnet run, this will start the backend in Kestrel.
  4. Access the APIs here: http://localhost:5000/swagger/index.html.
  5. To provision the database you must execute ​/devops​/nukeandpavedb in Swagger.
  6. Done :)

ICC Portal frontend

  1. Clone this repo
  2. Open a terminal and go to \ICCPortal\ClientApp.
  3. Run yarn to install all of the dependencies.
  4. Run the frontend with ng serve.
  5. The server API url can be configured in ICCPortal\ClientApp\src\environments\environment.ts
  6. Done :)

Attribution

Some parts of this application are inspired by the work on Private Tracer. You can find their license here.

About

No description, website, or topics provided.

Resources

License

EUPL-1.2, Unknown licenses found

Licenses found

EUPL-1.2
LICENSE.txt
Unknown
LICENSE.pdf

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 93.7%
  • TypeScript 3.1%
  • HTML 2.3%
  • CSS 0.4%
  • JavaScript 0.4%
  • Dockerfile 0.1%