- Description
- User Story
- Features of the Application
- Preview of Return Safe
- Contributors
- Links
- Installation
- Usage
- Built Using
- License
In order to relax social-distancing measures - like school closures and "stay at home" orders - our public health officials need a way to intensify their contact-tracing efforts. Contact tracing, which entails identifying people who have an infectious disease and those they have been in contact with, works to interrupt disease transmission, but, unfortunately, there is still much concern about the preventative measures being taken to avoid transmission.
Due to this high level of concern, especially of community members contracting the virus, our team created Return Safe, a contact-tracing application. Return Safe works to put the user's mind at ease by preventing the spread of disease and transmission through a user's self-report of symptoms, using geolocation tracking to notify the user of their whereabouts (monitoring where/who the user has been in contact with, from what distance, and for how long), and by estimating the probability of contagion based on their interaction in their community.
Return Safe is a MERN-stack, Single Page Application (SPA) that utilizes Passport and JWT for encrypted user authentication, Redux to manage the application state of the user interface, react-calendar as a form component to select and navigate between dates, and the Geolocation API to track and return the user's location based on cell phone towers and WiFi nodes.
AS A user
I WANT to track my symptoms and my whereabouts in my community
SO THAT I can interrupt disease transmission and make a safe return home.
GIVEN a contact tracing application
WHEN I sign in and load the page
THEN a dashboard will render with a check-in form and a dynamic calendar.
WHEN I fill out a check-in form with my self-reported symptoms and observations and click the Submit button
THEN I will have saved my form and will be able to view the data.
WHEN I click on the Data or Show Data button
THEN I will access the check-in logs with the times of my check-ins and my reported symptoms for the current day.
WHEN I click on the Calendar or Calendar button
THEN I will access my check-in logs, see reported symptoms, and see the pin(s) for my location for that selected day.
WHEN I click on the toggle button on the header
THEN I will enable a geolocation tracker that will record my location when I have been in a location for more than ten minutes.
The following images display the login and registration components for the user:
The following animation demonstrates the complete application functionality:
To download the above video file of the application functionality, you may do so here.
The application requires the following dependencies and/or package managers:
$ npm install axios bcryptjs body-parser classnames concurrently dotenv express if-env is-empty google-map-react jsonwebtoken jwt-decode materialize-css mongoose nodemon passport passport-jwt react react-dom react-calendar react-materialize react-redux react-router-dom react-scripts redux redux-thunk validator
When downloaded, the application requires the input of npm install into the command line interface in order to download the contents of the package.json.
The application can be initiated by inputting npm start into the command line interface and running the application on localhost: 3000.
Listed below are the frameworks, libraries, and guides that made building this application possible:
- Express.js
- Google-Maps-React
- HTML Geolocation API
- JSON Web Token
- Material
- Materialize
- MongoDB
- Node.js
- Passport
- React
- React-Calendar
- Redux
This application does not currently hold any licenses.