🚗 Roadside Assistance Platform

A location-aware web application that connects users in emergency situations (mechanical or medical) with nearby help providers and peers in real-time. Built for a 24-hour hackathon, this project secured a Top 6 position for its innovation, impact, and technical execution.

---

🏆 Achievements

• 🥇 Secured Top 6 place in a national-level hackathon.

---

📌 Problem Statement

During mechanical or medical emergencies on the road, finding immediate help can be a challenge—especially in remote areas or late hours. Traditional assistance services may not always respond quickly or be accessible.

---

💡 Solution

Our platform offers:

• 🚨 Instant Emergency Triggers: Users can request help via a single tap or automatically via IoT-based triggers during accidents.
• 📍 Real-Time Location Tracking: Find and connect with the nearest verified helpers (mechanics, medics, or peers).
• 🔗 Peer-Based Assistance: Chrome extension to alert nearby peers for quicker human response before official help arrives.
• 📊 Help Provider Dashboard: Real-time dashboard for registered helpers to receive, accept, and navigate to requests.

---

🛠️ Tech Stack

• Frontend: React.js, Tailwind CSS
• Backend: Node.js, Express.js
• Database: MongoDB with GeoJSON & 2dsphere indexing
• Extension: JavaScript-based Chrome Extension
• Others: Mapbox APIs for mapping and directions

🚀 Local Setup

Backend Setup

1. Navigate to the backend directory:

   cd odoo_hack/backend

2. Install dependencies:

   npm install

3. Create a .env file with the following variables:

   MONGODB_URI=your_mongodb_connection_string
   PORT=5000
   JWT_SECRET=your_jwt_secret
   

4. Start the server:

   npm start

Frontend Setup

1. Navigate to the frontend directory:

   cd odoo_hack/frontend

2. Install dependencies:

   npm install

3. Create a .env file with:

   VITE_API_URL=http://localhost:5000
   VITE_MAPBOX_TOKEN=your_mapbox_token
   

4. Start the development server:

   npm run dev

Chrome Extension Setup

1. Open Chrome and navigate to chrome://extensions/
2. Enable "Developer mode" in the top right
3. Click "Load unpacked" and select the Chrome_Extension/Extension directory
4. The extension should now be installed and visible in your Chrome toolbar

Note: Make sure both backend and frontend servers are running for the extension to work properly.

---

📱 Key Features

Feature	Description
🆘 Emergency Trigger	One-tap SOS or automated trigger from IoT devices
🗺️ Nearby Helpers	Location-based discovery of medical/mechanical help
🤝 Peer Connect	Notify nearby users via Chrome Extension
📍 Geo-Based Queries	MongoDB 2dsphere for efficient spatial search
🔒 Secure Access	Auth system for users and service providers

---

📸 Screenshots

Home Page SignUp Page User Dashboard Service Request form Service Provider Dashboard Alert Email Extension

---

🧠 Learnings

• Implemented real-time spatial queries using MongoDB's 2dsphere index.
• Learned rapid prototyping of Chrome Extensions for real-world use cases.
• Designed an end-to-end location-aware system under tight deadlines.

---