CovidReportMZ

Platform that help people get realiable information about Covid-19 on Mozambique. The user can recieve daily sms with statistics or from whatsapp get statistics and faq's.

The data come from the Mozambique Health Institute website (https://covid19.ins.gov.mz) using web scraping technique build by myself.

ℹ️ This project is for Twilio Hackaton + DEV submission. You can find the announcement post.

Built with

• Backend: Node.js web server using Express + web scrapping using cheerio + Parse
• Frontend: Nuxt + Buefy + Javascript
• Integration: Programmable SMS Twilio API + Twilio API for WhatsApp + Twilio Autopilot API + Back4app Parse Server
• Deployed with Heroku. You can check out the live application here or the live API here

Features

• Recieve statistics related to COVID-19 on Mozambique via SMS (Mozambique only) (Language: Portuguese)
• Recieve statistics related to COVID-19 on Mozambique via WhatsApp (Worldwide) (Language: Portuguese)
• Recieve FAQ's related to COVID-19 via WhatsApp (WorldWide) (Language: Portuguese)

Set up

Requirements

• Node.js
• A Twilio account - sign up
• A Parse Server account - I'm using Back4app

Enviroment Variables

This application uses the dotenv module to read the environement variables configuration. So in order to run the server, you must create a .env file and set the appropriate values to each variable. Below is a table with the variables you need to set, or check the file .env.sample (optional values aren't on the table):

Env Variable	Description
TWILIO_ACCOUNT_SID	Your primary Twilio account identifier - find this in the Console.
TWILIO_AUTH_TOKEN	Used to authenticate - just like the above, you'll find this here.
TWILIO_NUMBER	A Twilio phone number in E.164 format - you can get one here
PARSE_APP_ID	A Parse App Id - you can get one here
PARSE_JS_KEY	A Parse Javascript Key - you can get one here
PARSE_SERVER_URL	A Parse API Address - you can get one here

Local development

After the above requirements have been met:

1. Clone this repository and cd into it

git clone https://github.com/kradnoel/CovidReportMZ.git
cd CovidReportMZ

For the backend:

2. cd into api and install dependencies

cd api
npm install

2.1. Modify the .env file and change the following values:

TWILIO_ACCOUNT_SID=...
TWILIO_AUTH_TOKEN=...
TWILIO_NUMBER=...
PARSE_APP_ID=...
PARSE_JS_KEY=...
PARSE_SERVER_URL=...

2.2. Run the application

npm start

For the frontend:

3. cd into api and install dependencies

cd web
npm install

3.1.cd into web and install dependencies

cd web
npm install

3.2. Modify the .env file and change the API_URL with the api , PORT and HOST

API_URL=localhost:4000
PORT=4001
HOST=localhost

4. Run the application

npm start

5. Navigate to http://localhost:4001

License

MIT