covid19zim Information Hub is a web application for accessing near-real time statistics and information about the COVID-19 in Zimbabwe. Official statistics are gathered from the Ministry of Health and Child Care (MoHCC) in Zimbabwe. Other data sources such as WHO are also considered. This application is independently developed and not affiliated with any government organisation.

Online version available at https://covid19zim.herokuapp.com

covid19zim Information Hub use cases:

• Confirm official cases, deaths and recoveries.
• Display contact details for the MoHCC in Zimbabwe
• Display Health Tips
• List COVID-19 resources for Zimbabwe
• Display contact details for Hospitals in Zimbabwe

In order to run covid19zim Dashboard, an environment with the following is required:

• Node.js
• Express Framework
• Bootstrap

1. Install node dependencies.

$npm install

2. Create a Firebase Cloud Firestore DB.

• Create a collection called stats
• Create a document called stats
• Add the following fields to the stats document - const_lockdown_active,lockdown_status,lockdown_current_day,total_negative,total_recovered,total_tested,total_deaths,total_confirmed,last_updated, response_status_flag,data_date,lockdown_total_days

3. Create .env file and add the following variables (Firebase from Firebase Service Account, smtpServer from your email server, and ADMIN for the user logging in via magic link).

FIREBASE_TYPE=
FIREBASE_PROJECT_ID=
FIREBASE_PRIVATE_KEY_ID=
FIREBASE_PRIVATE_KEY=
FIREBASE_CLIENT_EMAIL=
FIREBASE_CLIENT_ID=
FIREBASE_AUTH_URI=
FIREBASE_TOKEN_URI=
FIREBASE_AUTH_PROVIDER_X509_CERT_URL=
FIREBASE_CLIENT_X509_CERT_URL=
smtpServerFrom=
smtpServerUser=
smtpServerPassword=
smtpServerHost= #for gmail should be smtp.gmail.com
smtpServerPort= #for gmail should be 465
ADMIN_USERNAME=
ADMIN_EMAIL=
PASSPORT_ZERO_SECRET=
NODE_ENV="development"

4. Start the web server (Express) and navigate to http://localhost:3000/ in your browser.

$npm run dev

5. Update Cloud Firestore and flush cache for latest stats to show on dashboard.

localhost:3000/caches/delete

1. To deploy to a production server (e.g. heroku) - create project, configure env variables and push.

If on a different server, after deploy, run the start command.

$npm run start

curl -k https://covid19zim.site/api/v1/fetch_stats
{"const_lockdown_active":false,"lockdown_status":"Started","lockdown_current_day":8,"total_negative":349,"total_recovered":-1,"total_tested":358,"total_deaths":1,"total_confirmed":9,"last_updated":"06 April 2020","response_status_flag":true,"data_date":"05 April 2020","lockdown_total_days":21}

curl -k https://covid19zim.site/api/v1/fetch_all_stats
{"stats":{"lockdown_total_days":21,"const_lockdown_active":false,"lockdown_status":"Started","lockdown_current_day":8,"total_negative":349,"total_recovered":-1,"total_tested":358,"total_deaths":1,"total_confirmed":9,"last_updated":"06 April 2020","response_status_flag":true,"data_date":"05 April 2020"}}

The web app uses server side caching as the stats are updated once a day. The cache routes can only be access by a logged in user.

Check cache keys: /caches/view
Check cache json: /caches/json
Flush cache: /caches/delete
Get cache size:  /caches/size
Test cache: /caches/test/

The web app uses magic link authentication. Only the user with ADMIN_EMAIL set in env variables can login. After entering the valid login email, an email with magic link is sent, which when clicked gives access.

Login: /login
User Profile: /profile
Logout: /logout

IE / Edge	Firefox	Chrome	Safari	iOS Safari	Samsung	Opera
IE11, Edge	Supported	Supported	Supported	Supported	Supported	Supported

Feedback form

Blog Post about COVID19ZIM Aggregator