Project THEA Server

Project-THEA aims to deliver an open-access digital contact tracing system tailored to the haulage industry. The tool is designed to combine anonymized time-stamped geo-location information relative to the road infrastructure with COVID-19 test results to support public health efforts to limit transmission and the safe reopening of economies. Critically the efficiency in contact tracing enhances the flow of the regional supply chain and strategic allocation of public health surveillance resources.

REQUIREMENTS

The minimum requirement for this project is your Web server supports PHP 7.3.0 and you have Node.js a javascript runtime environment installed locally on your computer.

INSTALLATION

Install via Git

Clone the repo locally:

git clone https://github.com/project-thea/project-thea-server.git

cd project-thea-api

Install PHP dependencies:

composer install

Install NPM dependencies:

npm install

Build assets:

npm run dev

CONFIGURATION

Setup configuration:

cp .env.example .env

Generate application key:

php artisan key:generate

Create a database:

CREATE DATABASE DB_DATABASE;

Update .env with database details:

DB_CONNECTION=<DB_CONNECTION>
DB_HOST=<DB_HOST>
DB_PORT=<DB_PORT>
DB_DATABASE=<DB_DATABASE>
DB_USERNAME=<DB_USERNAME>
DB_PASSWORD=<DB_PASSWORD>

Run database migrations:

php artisan migrate

Run database seeders:

php artisan db:seed

Start instance of Valhalla

Start an instance of the Valhalla service and update the VALHALLA_HOST environment variable in the .env file

Run development server:

php artisan serve

Documentation

Find the THEA-C19 documentation in the docs folder

Notes on demo mode

Add DEMO_MODE = true in .env files run run the application in demo mode.

CONTRIBUTION

The Contributor Guide provides detailed instructions on how to get your ideas and bug fixes seen and accepted, including:

1. How to open a pull request