Corona-Shield

A Corona Tracking Mobile Application.

Corona Shield is an open sourced Corona Tracking Mobile Application with Back-end made by Amine Jafur with ❤️ using Flutter, PHP, JS.

After watching Najib El Mokhtari's video about the government's application project for COVID-19 tracking. And, since I had built a similar Bluetooth tracking application for the open-ended Hackathon 2015 by Screendy hosted @Casablanca, I decided to rebuilt the Application from scratch and this is what I came up with.

Table of Contents

• Versions
• How It Works
• Video
• Screenshots
• Quick Start
• Licensing
• Useful Links

Versions

First Verison of the APP : 1.0

How It Works

1. First of all, download the App.
2. Open the app and follow the steps.
3. Signup using your CIN + Phone ( Make sure to have internet ).
4. Activate the bluetooth so the application can get your mac Adresse else you can enter it by your own.
5. After the signing, you will be redirected to the main page of the application, where you will get the Statistics and your profile details as a card.
6. If you are deciding to go out, Click on the tracking button in the right bottom corner and start tracking any collisions arround you.
7. The app will keep tracking for any persones you meet out there and it will save them in your phone using a spesific encryption.
8. Let's say for example that you got the covid-19, the government will take your phone and it will be able to access the encrypted data from your phone using the List icon in the navigation Bar, they can also upload the decrypted data to ther servers to get stastics and find the persones you collided with in a very safe way.

That's All, Stay safe nd Stay #home

Video

Screenshots

Onboarding	Login	Mac Adresse	Main Screen	Radar

Quick start

git clone https://github.com/aminejafur/corona-shield.git

API

1 - Create a database.

2 - Go to the /api folder and rename the .env.example file to .env and fill it with the database info.

3 - Open CMD, type : composer install, wait until the install is done then type : php dbseed.php ( you should get 2 messages, Starting Seed + seeded).

4 - In the same CMD type : php -S YOUR-IP:portShoosedForAPI -t public.

5 - Make sure the API is working fine by visiting : YOUR-IP:portShoosedForAPI/users OR YOUR-IP:portShoosedForAPI/collisions.

STATISTICS

Go to Server file or wherever you moved the "Server/statistics.php" File and open CMD, type php -S your-IP:portShoosedForStatistics.

DASHBOARD

1 - Edit the "dashboard\assets\js\config.js" file ( export const apiUrl = 'http://your-IP:portShoosedForDashboard'; ).

2 - Go to dashboard folder and open CMD, type : php -S your-IP:portShoosedForDashboard.

3 - Now your dashboard can be accessed from your-IP:portShoosedForDashboard in your browser.

Mobile APP

1 - Edit the "mcovid_shield\lib\ui\globalVars.dart" file with :

- govPassword = the password that will be used to access the collected data, normal user should not access it!.

- statisticsUrl = your-IP:portShoosedForStatistics/statistics.php.

- apiUrl = your-IP:portShoosedForAPI.

- encKey = encryption Key Used for two ways encryption while showing/storing Data.

2 - Build the APK depending on your IDE.

HAPPY HACKING! ( N.B. When working with local IP's The app and API should be in safe Network )

Licensing

• Copyright 2020 Amine Jafur

Useful Links

• Flutter

• PHP

• JS

Star the repo to support the project ⭐

Feel free to fork, open pull requests and play around. Thanks! ❤️