mansiruhil13 / Bobble-AI

https://mansiruhil13.github.io/Bobble-AI/
MIT License
69 stars 276 forks source link
contribution girlscriptsummerofcode gssoc24extd hacktoberfest hacktoberfest-accepted hacktoberfest-approved hacktoberfest2024 open-source winterofblockchain

πŸš‘ AmbuFlow


πŸš‘ A Mobile Application built with HTML, CSS, JavaScript, and Google API, designed to notify patients of nearby hospitals and provide estimated ambulance arrival times. πŸ₯ It offers hospitals and ambulance drivers critical details like the patient’s location πŸ“ and enhances GPS route management with real-time traffic data 🚦 for scheduled routes, ensuring efficient navigation.

🌟 Stars 🍴 Forks πŸ› Issues πŸ”” Open PRs πŸ”• Close PRs
Stars Forks Issues Open Pull Requests Close Pull Requests

This project is now OFFICIALLY accepted for

GSSoC 2024 Extd
Hacktober fest 2024


DESCRIPTION πŸ“‘

A mobile app using HTML, CSS, JavaScript, and Google API that helps users find nearby hospitals and track ambulances in real-time. It shows hospital locations, provides directions, and helps manage ambulance routes based on traffic and distance.

Please check out the Screenshots.md for more clarity on the description of the project.

🌟 Why We Need This Application

  1. Quick Emergency Response: Ensures patients receive timely medical assistance by locating the nearest hospitals and ambulances.
  2. Real-Time Tracking: Provides real-time updates on ambulance locations and traffic conditions, optimizing route management.
  3. Enhanced Communication: Facilitates seamless communication between patients, hospitals, and ambulance drivers.
  4. Resource Management: Helps hospitals manage their resources efficiently by providing critical information and analytics.
  5. User-Friendly Interface: Designed for ease of use, ensuring that even in high-stress situations, users can navigate the app effortlessly.

πŸ›  Problem Statement

While having the name and address of a hospital is useful, visualizing it on a map with precise directions is even more effective. This app aims to bridge that gap by delivering real-time location data and navigation assistance, ensuring users find the nearest hospital quickly and with ease. πŸš‘

🌟 Quick Access to Hospitals

In emergencies, time is of the essence. Quickly identifying the nearest hospital can be life-saving. This app provides that immediate support.

πŸ—ΊοΈ Locate Hospitals on a Map

Visual information is key. Beyond just showing names and addresses, the app provides a map view with directions, offering users an intuitive way to locate nearby hospitals with ease.

πŸ’‘ Solution

πŸš‘ Quick Access to Hospitals

This app offers a comprehensive list of nearby hospitals with essential details such as addresses, contact numbers, and user ratings. Users can filter based on hospital specialties, helping them find the appropriate medical help efficiently.

πŸ—ΊοΈ Map-Based Hospital Location

The built-in map feature shows exact hospital locations, provides directions, and highlights landmarks and real-time traffic conditions. This ensures users can navigate unfamiliar areas and choose the fastest route to get the care they need, right when they need it.

πŸš€ Key Features

πŸš‘ Operator Interface

πŸ‘₯ User Interface

πŸ“ˆ Additional Features

  1. πŸ“‘ GPS-Enabled Tracking: Monitors ambulances in real-time for optimal tracking and coordination.
  2. πŸ”” Hospital Alerts: Sends patients notifications about nearby hospitals for quicker medical assistance.
  3. 🚦 Distance & Traffic Analysis: Calculates the fastest routes based on real-time traffic and distance.
  4. πŸ§‘β€πŸ’Ό Driver Management: Streamlines driver schedules and activities for efficient ambulance deployment.

✨ Contributing

We welcome all contributions from the open-source community! If you'd like to contribute, follow these steps:

  1. Fork the repository:

    git clone https://github.com/yourusername/AmbuFlow.git
  2. Create a new feature branch:

    git checkout -b feature/your-feature-name
  3. Commit your changes:

    git add .
    git commit -m "Add feature description"
  4. Push to the branch:

    git push origin feature/your-feature-name
  5. Open a Pull Request: Go to your forked repo on GitHub and click "New Pull Request."

How to run the project:

  1. Go to Backend folder and run command:

    npm install
  2. Make mongodb database.

  3. Go to server.js file and give your mongodb connection URL.

  4. Run command:

    node server.js
  5. Split terminal and go to index.html and open it with live server.

  6. make sure that both Backend and index.html file run togethere.

πŸ›  Contribution Guidelines:

We welcome all contributions to improve AmbuFlow! If you would like to contribute, please follow the Contributing.md to know how to get started.

To maintain quality and consistency, please follow these best practices:

  1. Code Style: Write clean, readable code following the project's coding style. Comments are highly appreciated.
  2. Commits: Use meaningful commit messages that clearly describe the purpose of the changes.
  3. Pull Requests: Keep PRs focused, well-explained, and reference any relevant issues.
  4. Testing: Ensure all changes are thoroughly tested locally and do not break existing functionality.

Refer to CODE_OF_CONDUCT.md for details on our community guidelines.

πŸ›  Tech Stack



πŸ“± User-Friendly Experience

This app is designed to be user-friendly, ensuring a seamless experience for both patients and ambulance drivers. The intuitive interface and real-time updates make it easy to navigate and use, even in high-stress situations.

πŸ“ˆ Future Enhancements

Our Valuable Contributors:

Contributors

πŸ‘₯ Team

Mansi Ruhil
Mansi Ruhil
Project Admin
LinkedIn

⭐️ Support the Project

If you find this project helpful, please consider giving it a star on GitHub! Your support helps the project grow and reach more contributors.

Keep learning πŸ“š, exploring 🌍, and contributing 🀝 to make a difference in the world!