Skip to content

paumateo/bitsxmarato

 
 

Repository files navigation

La Lluita Continua - Bits x La Marató (Winner Project)

Respiratory illness outbreaks in schools can escalate quickly, affecting students and the community. Our app tracks symptoms, offering actionable insights to improve prevention and response.

Inspiration

Our project is inspired by the challenges faced during the COVID-19 pandemic, particularly in schools. The rapid spread of respiratory illnesses highlighted the need for effective tracking, early detection, and prompt response. With this in mind, we created an app that empowers health professionals to monitor symptoms in real time, enabling quicker interventions and reducing the risk of outbreaks.

What it does

Our platform is designed to transform how schools and communities monitor and respond to health trends. It offers the following features:

  • Symptom Tracking Interface: A user-friendly interface enabling students to log their symptoms easily, fostering real-time data collection.

  • Regional Insights: Provides an overview of health trends across different sanitary regions of Catalonia, aiding targeted interventions and policymaking.

  • Environmental and Climate Data Integration: Incorporates external data sources to explore correlations between environmental factors and epidemic patterns.

  • Spread of Epidemic Visualization Tool: Displays the geographical spread of outbreaks.

How it works

The following are some of the main screens of the application:

Inici

Students can Register and Login...

Register Alumne Login Alumne

...to complete a short quiz everyday to collect syntoms data:

Enquesta Alumne

We store all the responses among other data in a self hosted MongoDB database:

Mongo DB

Doctors can also Register and Login to view various graphs and insights obtained in real time from the data collected through the application as well as other souces:

Register Metge

General overview line chart of the evolution of all registered symptoms:

General

Correlation between our collected data and public data of the main deseases:

Correlació

Monitoring of various relevant environment variables:

Entorn

Desease occurrency over time by "Regions Sanitàries":

Regions Sanitàries

Desease spread map animation:

Mapa

How we built it

We combined powerful backend and frontend technologies to create a robust, yet intuitive system:

  • Python Backend: Our backend processes data to generate the required plots, connecting seamlessly with a MongoDB database for storage and retrieval.

  • MongoDB Database: This database provides a scalable and flexible foundation for handling real-time data inputs from schools.

  • Streamlit Dashboard: The frontend was built using Streamlit, offering an intuitive interface to view plots, trends, and key metrics. The dashboard makes health data accessible and actionable, without the need for technical expertise.

  • Docker Deployment: We leveraged Docker to containerize and seamlessly deploy both our application and database to our own cloud server. Thanks to a custom automatic deployment pipeline powered by webhooks triggered by GitHub on every commit in the main branch, we were able to significantly reduce our CI/CD times, enabling our team to iterate faster while investing more resources on developing the core functionality of the application.

What's next

The application is designed to be easily scalable. With more data of the schools, the plots would be more insightful. Additionally, the map can be extended to incorporate SEIR models to predict epidemic expansion.

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Jupyter Notebook 89.0%
  • Python 10.9%
  • Dockerfile 0.1%