GDSC-HSU / gateway

[Top 3] 2022 Solution Challenge an IoT apporch include Flutter & embedded devices, network protocol, solving/helping covid-19 situation
MIT License
23 stars 9 forks source link
arduino ble bluetooth bluetooth-low-energy covid covid-19 esp32 firebase flutter gdsc iot

Gateway

Coronavirus can cause more severe symptoms in people with weakened immune systems, older people and those with long-term conditions like diabetes, cancer and chronic lung disease.

Gateway is an open-source solution for covid 19 situation. Ours goal is provide solution for those 4 major pillar recommended by WHO.

WHO #include 4 major pillar

SOLUTION IN ACTION

We submit our solution in GDSC Solution challenge 2022 base on 17 Sustainable Development Goals of the United Nations more info could be found here

Youtube : https://www.youtube.com/watch?v=Kp13HX58oo4

<img src="http://img.youtube.com/vi/Kp13HX58oo4/0.jpg" alt="Gateway - GDSC Solution Challenge 2022"/>

An quick introduce of ours scope - TLDRpictureis worth a thousand words ⬇️


aaa


bb


We've been in those situation and manual "Guidance & Prevenence" of coronavirus and "Back to office" or coming back to normal. Manual we mean by we still have security

Within ours scope we define an "cost effected" "self-hostable" solution, ours goal is widespread this solution - with that in mind. We're aim to support this solution Documentation, [Wiki](https://github.com/GDSC-HSU/gateway/wiki/TEAM-DEVELOPMENT-SETUP) and configuration by doing so we could encourage learner in high school, collages students build up this solution by their own. further detail are covered in this issue ref [link](https://github.com/GDSC-HSU/gateway/issues/11) --- ![aa](./docs/img/gateway_hmw_desgin_selft_host.jpeg) --- Gateway in an application running in yours device (ours supported architecture). It will communicate with gateway-devices with it wireless sensor over Bluetooth connection protocol. By combining application and IoT devices, we’re able enable an solution for covid-19 control and prevention. --- ![aa](./docs/img/gateway_techology_stack.jpeg) --- We also `encourage undergraduate, learner, students` who might found interesting about “technical” aspect of the project, they could find by themselves having a `“proof of concept”` of how those technology work together in an ecosystem and better or `excel their STEM innovation`. ##### Supported architecture : - Gateway : Mobile (Android, IOS), Web (coming soon), Google Cloud Platform. - Gateway-devices: ESP32 BLE, Arduino framework. - Google Cloud Platform : Infrastructure as code provisioning (backend, firebase) via [`terraform`](./gateway-core/tf/) --- ##### Project structure module Project compose 4 git submodule 1. Mobile Application [current directory](./) 2. IoT Embedded device [./ble_devices/](https://github.com/GDSC-HSU/gateway-devices) 3. Backend Infrastructure [./gateway-core](https://github.com/GDSC-HSU/gateway-core) 4. Web Configuration – Management Dashboard [./gateway-dashboard](https://github.com/GDSC-HSU/gateway-dashboard) README.MD : are covered in each module for clearer explanation + installation + self-host solution --- #### How to run this project **Bellow steps are required** to run fully gateway application which include Flutter - IOT - Web dashboard. - Clone project to local machine: ```git clone https://github.com/GDSC-HSU/gateway``` - Open your terminal and run: ```flutter pub get``` - Connect real device (this app using camera and bluetooth so you should connect to real device) Follow this for connect your real device [Android](https://developer.android.com/studio/run/device) or [IOS](https://developer.apple.com/documentation/xcode/running-your-app-in-the-simulator-or-on-a-device) We tested on: Iphone 6s (IOS 15.2) and Niko C20 (Android 10) - Finally run command and enjoy 🎉✨🎉✨: ```flutter run``` - `Web dashboard` you need to sign-up and create organization for device configuration our public domain https://gdsc-gateway.web.app/ that will be required in Flutter for QRScan - `IoT device` you need an device for the application, detail how the device installation will be found [here](https://github.com/GDSC-HSU/gateway-devices#installation) device also required sensor if don't have those part please refer to our docs [how to mock BLE data over serial](https://github.com/GDSC-HSU/gateway-devices#dont-have-board-sensor-problem-solved) - More document run project with [Flutter](https://docs.flutter.dev/) #### Gateway(main) UI tour

Minimal ui-flow
1. Mobile required permission (BLE, camera)
2. IoT Device Scanning
3. Config Mobile device link to an organization via QR configure code
4. Main page (gateway check) detail here
https://user-images.githubusercontent.com/42218324/161300916-a2926435-dd75-46ed-95bf-829e779f6ab0.mp4 #### Contributor: Made with [contrib.rocks](https://contrib.rocks).