🚨 ROADSoS - Global Emergency Rescue Network

Empowering the Golden Hour: High-Reliability Emergency Assistance & Global Rescue Coordination.

ROADSoS is a high-performance, location-based platform designed to provide immediate access to life-saving services during road accidents. By integrating trauma centers, ambulances, police, and vehicle rescue into a single interface, it supports both victims and bystanders in taking rapid, effective action.

---

✨ Latest Updates (May 2026)

📳 1. Shake to Activate SOS

• Gesture-Based Triggers: Added support for motion-activated SOS calls. Users can firmly shake their device to trigger an emergency session.
• 3-Second Safety Window: To prevent false alarms, a high-priority countdown overlay appears with haptic feedback, allowing users to cancel accidental triggers.
• Cross-Platform Compatibility: Optimized for both Android and iOS devices using the DeviceMotionEvent API.

🛡️ 2. "Instant Access" Security Model

• Zero-Friction Emergency Use: Removed user authentication/login requirements. Victims can access all life-saving features instantly without remembering passwords.
• Backend Rate Limiting: Integrated SlowApi with Redis to protect the infrastructure from abuse while maintaining open access for legitimate users.
• Enhanced Privacy: User profile data (Name, Blood Group, Medical Notes) is stored strictly on the local device, ensuring absolute privacy.

🌍 3. Regional Language "Scan"

• GPS-Based Localization: The app now detects the user's specific state (e.g., Tamil Nadu, Maharashtra) and automatically suggests or switches to the primary regional language.
• Scheduled Languages Support: Full support for Indian Scheduled Languages (Hindi, Tamil, Telugu, Marathi, etc.) to assist non-English speakers during crises.

🛠️ 4. Advanced Mirror Reliability

• Smart Failover Tracking: Backend now tracks the health of multiple global Overpass API mirrors. If one provider fails, the system automatically redirects to a stable mirror in real-time.
• Detailed Error Logging: Improved diagnostics to capture specific mirror failure types (Timeouts, Connection Errors) for better maintenance.

---

✨ Core Features

🚑 Golden Hour Rescue Coordination

• Trauma Center Prioritization: Specialized accident care facilities are prioritized and highlighted with pulsing "Trauma Center" badges.
• High-Efficiency Parallel Search: Backend splits queries into specific categories and executes them concurrently across multiple global mirrors.
• Real-time Tracking: WebSocket-powered live location sharing allows victims to broadcast their movements to rescue teams via Redis Pub/Sub.

📋 Proactive Bystander Support

• Bystander Emergency Protocol: A standalone, proactive 3-step checklist (Secure Scene, Assess, Coordinate) to guide first responders.
• GPS Coordination: One-tap location copying to accurately relay coordinates to emergency dispatchers.

📶 Robust Offline Functionality

• Map Tile Caching: PWA implementation pre-caches OpenStreetMap tiles, ensuring the map remains functional even in zero-network zones.
• Geospatial Cache Headers: Redis caching with rounded coordinate grids (~110m) to ensure nearby users share the same ultra-fast responses.

---

📚 Documentation

For a deep dive into the system's inner workings, refer to our end-to-end documentation:

• 🏗️ System Architecture: Detailed breakdown of the decoupled frontend/backend, data flow, failover systems, and deployment strategy.
• 📡 API Reference: Comprehensive documentation of the FastAPI REST endpoints, WebSocket connections, rate limits, and expected payloads.

---

🚀 Tech Stack

Frontend

• Framework: React 18 with TypeScript
• State/Animation: Framer Motion & Lucide Icons
• Mapping: Leaflet with Workbox-powered Tile Caching
• PWA: Fully installable as a mobile app with offline support

Backend

• Engine: FastAPI (Python 3.11+)
• Security: SlowApi Rate Limiting (Redis-backed)
• Real-time: WebSockets with Redis Pub/Sub
• Cache: Redis (Geospatial-hashed transient storage)

---

🛠️ Local Development

Prerequisites

• Docker & Docker Compose

Quick Start

1. Clone the Repo:

   git clone https://github.com/LEVELING2108/RoadSoS.git
   cd RoadSoS

2. Launch the Stack:

   docker-compose up --build

3. Access the App:

   • Frontend: http://localhost:5173
   • Backend API: http://localhost:8000

---

📈 Evaluation Criteria Alignment

• Reliability: Multi-source backend failover and Redis-backed caching.
• Accuracy: Specialized OSM tagging for Trauma and Rescue identification.
• Offline: PWA map tile caching for "no-signal" scenarios.
• Innovation: Gesture-based SOS triggers, regional language scanning, and parallel search architecture.

---

© 2026 ROADSoS Global Network. Built for safety.