diff --git a/README.md b/README.md index 3fd7aa1c..4ebfdf0e 100644 --- a/README.md +++ b/README.md @@ -1,23 +1,129 @@ - ![Last commit](https://img.shields.io/github/last-commit/H3LP3RS/HELP) -![Contributors](https://img.shields.io/github/contributors/H3LP3RS/HELP) -[![Build Status](https://api.cirrus-ci.com/github/H3LP3RS/HELP.svg)](https://cirrus-ci.com/github/H3LP3RS/HELP) -[![Maintainability](https://api.codeclimate.com/v1/badges/14ec7e18db1effc26145/maintainability)](https://codeclimate.com/github/H3LP3RS/HELP/maintainability) -[![Test Coverage](https://api.codeclimate.com/v1/badges/14ec7e18db1effc26145/test_coverage)](https://codeclimate.com/github/H3LP3RS/HELP/test_coverage) -# H3lp! +

+ H3LP! +
+ +
+

+ +

Anyone can be a hero.

+ +

+ + + Last commit + + + + Contributors + + + - This android application is developed for the project course [CS-306 Software Development Project ](https://dslab.epfl.ch/teaching/sweng/proj) at EPFL. + + Build Status + + + + Test coverage + + + + Mainttainability + + +

+ +

+ Key Features • + Presentation video • + How To Use • + Screenshots • + The team +

-## Description The purpose of this app is to offer emergency help by allowing willing users to register and enter their skills (e.g. have taken courses on first aid) and the first aid medicine they usually walk around with (eg. EpiPens for people with severe allergies, asthma inhalers for people with asthma, antihistamines for allergies…). When a user suddenly needs their medication (e.g. if they had an anaphylactic shock), after calling an ambulance, them (or the people they are with) can go on the app and ask for a certain medication or for someone with a particular first aid skill, the app will then notify any matching users in a certain radius so that they can come and help. +It was created as part of the Software Development Project [CS-306](https://edu.epfl.ch/coursebook/en/software-development-project-CS-306-1) +class at EPFL. + +## Key Features + +Once the app is downloaded the users can sign in and fill in their information: +- Sign in with Google or anonymously. +- Fill in their medical information, containing useful information in case of an emergency like blood type, allergy, or their current treatment. +- Add an emergency contact to call in case of emergency. +- Add their medical skills and the medicine they carry with them. + +That's it they are ready to save and be saved. + +In case of an emergency: +- tap the H3LP button and select what help you need +- can decide to call the emergency service or your emergency contact +- chat with the helpers that are coming to give them more information + + +## Other Features + +H3LP is a lot more than that and contains many features to keep you safe: +- A map to locate nearby hospitals, pharmacies and defibrillators +- Many tutorials to learn first aid tips with videos +- A simple tool that gives you the best tempo to perform CPR +- A forum where users can ask medical professionals tips and information by topic -## The Team +## Privacy Policy + +H3LP is concerned about privacy of its users, especially when it comes to sensitive information such as medical data. Therefore H3LP guarantees that all conversations are end-to-end encrypted and let every user choose what data should be synchronised online. + +## How To Use + +1. Clone this repository and open it in any IDE. (Recommended AndroidStudio) +2. Add your own API key for google map in values/google_maps_api.xml +3. Add your own Firebase URL in com/github/h3lp3rs/h3lp/model/database/FireDatabase.kt +4. If you want to reactivate the Animation for the CPR activity (removed because of continuous integration). To do so remove commented lines in com/github/h3lp3rs/h3lp/view/mainpage/CprRateActivity.kt + + + + +## The team - Wiam Eddahri (wiam.eddahri@epfl.ch) - Hind El Bouchrifi (hind.elbouchrifi@epfl.ch) - Adrien Nelson Rey (adrien.rey@epfl.ch) - Alexis Schlomer (alexis.schlomer@epfl.ch) -- Alexandre Michel Hayderi (alexandre.hayderi@epfl.ch) +- Alexandre Michael Hayderi (alexandre.hayderi@epfl.ch) - Emilien Duc (emilien.duc@epfl.ch) + + +## Screenshots + +

+ + + + + + +

+

+ + + + + + +

+ +

+ + + + +

+ diff --git a/screenshots/CPR.png b/screenshots/CPR.png new file mode 100644 index 00000000..5f367d16 Binary files /dev/null and b/screenshots/CPR.png differ diff --git a/screenshots/Forum.png b/screenshots/Forum.png new file mode 100644 index 00000000..a5fde748 Binary files /dev/null and b/screenshots/Forum.png differ diff --git a/screenshots/Helpee.png b/screenshots/Helpee.png new file mode 100644 index 00000000..9e8b6d86 Binary files /dev/null and b/screenshots/Helpee.png differ diff --git a/screenshots/Helper.png b/screenshots/Helper.png new file mode 100644 index 00000000..e5a946a8 Binary files /dev/null and b/screenshots/Helper.png differ diff --git a/screenshots/Intro.png b/screenshots/Intro.png new file mode 100644 index 00000000..474f567d Binary files /dev/null and b/screenshots/Intro.png differ diff --git a/screenshots/Professional.png b/screenshots/Professional.png new file mode 100644 index 00000000..472c851b Binary files /dev/null and b/screenshots/Professional.png differ diff --git a/screenshots/chat.png b/screenshots/chat.png new file mode 100644 index 00000000..7c2de992 Binary files /dev/null and b/screenshots/chat.png differ diff --git a/screenshots/help.png b/screenshots/help.png new file mode 100644 index 00000000..b3e55fe9 Binary files /dev/null and b/screenshots/help.png differ diff --git a/screenshots/home.png b/screenshots/home.png new file mode 100644 index 00000000..3c35e9c0 Binary files /dev/null and b/screenshots/home.png differ diff --git a/screenshots/skills.png b/screenshots/skills.png new file mode 100644 index 00000000..e6eb353c Binary files /dev/null and b/screenshots/skills.png differ diff --git a/screenshots/tuto.png b/screenshots/tuto.png new file mode 100644 index 00000000..54211c7d Binary files /dev/null and b/screenshots/tuto.png differ