1. The Two Communication Modes: Emergency Incident vs Vehicle Movement
Not all roadside scans are accidents. VaahanSafe differentiates between two distinct operational modes:
Mode A: Vehicle Movement Alert (Parking / Obstruction)
Designed for routine urban congestion, double-parking, or blocked driveways. The passerby selects 'Vehicle Moving Required'. The system immediately dispatches a high-priority push notification and SMS to the registered vehicle owner: 'Your vehicle [MH 12 AB 1234] is causing an obstruction at [Street Name]. Please move it.' No calls are placed to emergency family contacts in this mode.
Mode B: Roadside Emergency / Collision Alert
Triggered when the passerby selects 'Emergency Assistance / Collision'. This activates the high-urgency fallback telephony cascade, dialing pre-registered emergency contacts immediately.
2. The Fallback Escalation Cascade: Timer-Based Routing
In an emergency, if the primary contact is in a meeting, driving, or has their phone on silent, seconds matter. VaahanSafe executes an automated, timer-governed escalation cascade:
- 01
Primary Emergency Contact Dial (25-Second Window)
The edge gateway dials Priority Contact 1 via masked virtual DID with an automated IVR announcing: 'This is an urgent VaahanSafe emergency alert regarding vehicle [MH 12 AB 1234]. Press 1 to connect to the roadside responder.'
- 02
Secondary Contact Escalation (20-Second Window)
If Contact 1 does not answer or declines within 25 seconds, the system instantly switches to Priority Contact 2, placing a simultaneous voice call while logging the transition in the audit queue.
- 03
Multi-Channel Broadcast Burst (Instant Fallback)
If neither voice call is answered, the engine broadcasts an urgent WhatsApp notification and SMS to all registered contacts containing: 'EMERGENCY: Vehicle [MH 12 AB 1234] QR scanned at [Location]. Live GPS: [Maps Link]. Responder is attempting contact.'
3. Preventing Notification Storms: Edge Idempotency
At a major highway accident, ten different bystanders may attempt to scan the vehicle QR code within two minutes. Without rate-limiting, the victim's family would be overwhelmed by a paralyzing flood of simultaneous calls and SMS alerts.
VaahanSafe enforces an edge-backed deduplication window using Cloudflare Queues and D1. When a scan event occurs, an idempotency key `qr_{id}_incident_{window}` is locked for 8 minutes. Subsequent scans within this window are linked to the existing active incident session, allowing additional helpers to view status without triggering duplicate voice calls.