COVID Modelling Web UI

This is a Next.js application that serves the GitHub COVID modelling web interface. It is hosted on Vercel.

The needs of the unified modelling project are changing rapidly, and so we do not have a set-in-stone development roadmap. This application is built with the goal of it hopefully being not too difficult to alter or even rewrite parts of it as requirements change.

To learn more about this project's goals, please see PROJECT-INTENT.md

Local Development

This app has two development modes: "local" and "advanced" mode. The "local" mode is a much easier development setup, but does not actually queue simulation runs with the development control plane. Instead, it uses a stubbed result. The "advanced" mode is for maintainers only—it requires access to some shared credentials and accounts.

Shared Setup (for both local and advanced modes)

Install and start Docker.
Get the OAuth development app client ID and secret. You'll be prompted for them shortly.

Clone this repository:

> git clone https://github.com/covid-modeling/web-ui
> cd web

Install dependencies:
```
> npm install
```

Local Mode Setup

Run the environment setup script:
```
> script/setup
```
This script will ask you a series of questions—you'll want to answer that yes, you do want to run in local mode.
Start the server:
```
> script/server
```
Fetch case data:

This script requires some environment variables (see script/fetch-recorded-data --help), but if you've already got your .env set up, you can run the script with foreman to avoid manually setting them:
```
> npx foreman run script/fetch-recorded-data
```

Authorize your local user to log in:

> script/authorize-local-user $my_github_username

Advanced Mode Setup (Maintainers Only)

Advanced mode requires a number of secrets documented in env.yml, whose development values can be accessed by following instructions in the private maintainers-only documentation.

Start an HTTP ngrok proxy pointing to port 3000 and note its URL (such as "https://e028f3f1.ngrok.io"):
```
> ngrok http 3000
```
Run the environment setup script:
```
> script/setup
```
This script will ask you a series of questions—you'll want to answer that no, you don't want to run in local mode.

This script will now ask for a number of environment variables, each of which can be accessed by following instructions in the maintainer docs.

It'll also ask you for a RUNNER_CALLBACK_URL, which should be the value of your ngrok proxy.
Start the server:
```
> script/server
```
Fetch case data:

This script requires some environment variables (see script/fetch-recorded-data --help), but if you've already got your .env set up, you can run the script with foreman to avoid manually setting them:
```
> npx foreman run script/fetch-recorded-data
```

Authorize your local user to log in:

> script/authorize-local-user $my_github_username

Database & Migrations

In development, database migrations are run automatically when the web container starts.

To create a database migration:

# Create a migration
> script/db-migrate create name-of-migration --sql-file

We pass the --sql-file here because we write migrations in plain SQL in this project.

Environment Variables

Environment variables are documented in env.yml.

Architecture

Pages are in pages/{route}.tsx.
Components are in components/{Component}.tsx.
API functions are in pages/api/{route}.tsx.

Useful Documentation

Updating Case Data and Intervention Data

The case_data and intervention_data tables are populated by the fetch-recorded-data script. This is run nightly on staging and production.

Contributing

We welcome contributions to this project from the community. See CONTRIBUTING.md.

License

This project is licensed under the MIT license. See LICENSE.

andy-ganchrow/web-ui