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
First Verison of the APP : 1.0
How It Works
- First of all, download the App.
- Open the app and follow the steps.
- Signup using your CIN + Phone ( Make sure to have internet ).
- Activate the bluetooth so the application can get your mac Adresse else you can enter it by your own.
- 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.
- If you are deciding to go out, Click on the tracking button in the right bottom corner and start tracking any collisions arround you.
- The app will keep tracking for any persones you meet out there and it will save them in your phone using a spesific encryption.
- 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 : 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
Star the repo to support the project
Feel free to fork, open pull requests and play around. Thanks!
Download Corona Shield App Source Code on GitHub
https://github.com/aminejafur/corona-shield
Provides the list of the opensource Flutter apps collection with GitHub repository.