System Requirements Document (SRD)

Project Name: Wild-Ambulance

1. Introduction

The Wild-Ambulance project aims to revolutionize emergency medical response systems by creating a production-ready, web and mobile-compatible application. This system will enable real-time ambulance booking, intelligent traffic clearance, and live tracking to drastically reduce emergency response times. By leveraging AI-based signal control and backend traffic simulations, the project will provide a scalable and efficient solution for managing medical emergencies in urban and rural areas.

This document outlines the system requirements for the Wild-Ambulance project, tailored to the needs of Shivakumar Patil and the Indian context. The system will incorporate locale-specific defaults, such as time zones (IST), currency (INR), and region-specific traffic patterns.

2. System Overview

The Wild-Ambulance system is designed to address the critical need for faster emergency response times. The system will:

• Allow users to book ambulances in real-time via a web or mobile app.
• Automatically assign the nearest available ambulance based on location, availability, and type (e.g., ICU-equipped).
• Provide live tracking of ambulances and dynamic route optimization using traffic data.
• Simulate intelligent traffic signal clearance at three levels to ensure ambulances reach their destinations without delays.
• Notify hospitals of incoming patients with estimated time of arrival (ETA) and patient details.
• Offer an admin dashboard for monitoring ambulances, controlling traffic signals, and viewing analytics.

The system will also include a backend simulation of traffic signals with the capability to integrate real-world traffic systems in the future.

3. Functional Requirements

User Side

• As a User, I should be able to log in or sign up using JWT-based authentication.
• As a User, I should be able to view my location, nearby hospitals, and available ambulances on a live map.
• As a User, I should be able to book the nearest available ambulance with a single click.

Ambulance Tracking

• As a User, I should be able to track the real-time movement of the assigned ambulance on a live map.
• As a System, I should automatically assign the nearest available ambulance based on location, availability, and type.

Smart Traffic Clearance System

• As a System, I should simulate traffic signals and store their states in the database.
• As a System, I should implement three levels of intelligent traffic clearance:
  • Level 1 (1000 meters away): Identify signals on the route and turn them green sequentially.
  • Level 2 (500 meters away): Override nearby traffic lights and sync adjacent signals to prevent congestion.
  • Level 3 (50 meters away): Enable full priority mode by turning all signals green in the ambulance path and blocking other lanes.

Route Optimization

• As a System, I should calculate the fastest route using real-time traffic data.
• As a System, I should dynamically re-route ambulances if congestion occurs.

Hospital Integration

• As a System, I should notify the hospital when an ambulance is booked.
• As a System, I should send the hospital the ETA and patient details.

Admin Dashboard

• As an Admin, I should be able to monitor all ambulances in real-time.
• As an Admin, I should be able to control traffic signals manually if needed.
• As an Admin, I should be able to view analytics, such as response times, distances, and usage statistics.

4. User Personas

1. User:

   • Role: General public who needs to book ambulances.
   • Needs: Quick access to emergency medical transport.

2. Admin:

   • Role: System administrator managing ambulances and traffic signals.
   • Needs: Real-time monitoring, manual control, and analytics.

3. Hospital Staff:

   • Role: Medical personnel receiving patients.
   • Needs: Notifications about incoming ambulances, ETAs, and patient details.

5. Visuals Colors and Theme

Color Palette

• Background: #F5F9FF (Soft Sky Blue)
• Surface: #FFFFFF (Pure White)
• Text: #1A1A1A (Deep Charcoal)
• Accent: #FF6F61 (Emergency Red)
• Muted: #A3B4C4 (Calm Gray-Blue)

Theme

The theme will reflect urgency and clarity, with a modern and professional design. The use of emergency red for accents will draw attention to critical actions, while soft blues and whites will create a calming user experience.

6. Signature Design Concept

The Wild-Ambulance homepage will feature an interactive 3D cityscape map. Users will see a bird’s-eye view of their city, with ambulances represented as glowing, animated icons moving along the streets.

Key Features:

• Dynamic Map Animations: The map will highlight the user's location with a pulsating marker and show nearby ambulances and hospitals with distinct icons.
• Traffic Signal Simulation: Traffic lights on the map will change colors in real-time to reflect the intelligent clearance system.
• Micro-Interactions: Hovering over an ambulance icon will display its details (e.g., type, ETA).
• Ambient Effects: A subtle gradient background will shift colors based on the time of day (e.g., sunrise, daylight, sunset).

This design will create a visually engaging and intuitive experience, making the system feel alive and responsive.

7. Non-Functional Requirements

• Performance: The system should handle up to 10,000 concurrent users with minimal latency.
• Scalability: The architecture should support future integration with real-world traffic systems.
• Security: All user data must be encrypted, and the system should comply with GDPR and HIPAA standards.
• Availability: The system should have 99.9% uptime.

8. Tech Stack

Frontend

• React.js (Web)
• React Native (Mobile)
• Leaflet.js (Map Integration)

Backend

• Python
• FastAPI
• WebSockets for real-time updates

Database

• MongoDB (Primary)
• MySQL (Signal State Storage)

AI Tools

• GPT 5.4 for user-friendly responses
• Litellm for LLM routing

Deployment

• Docker
• Kubernetes

9. Assumptions and Constraints

• The system assumes access to accurate traffic data for route optimization.
• The backend simulation will model traffic signals but will not initially integrate with real-world systems.
• The system will prioritize ambulances based on proximity, availability, and type.

10. Glossary

• JWT: JSON Web Token, used for secure authentication.
• ETA: Estimated Time of Arrival.
• HIPAA: Health Insurance Portability and Accountability Act, a US standard for medical data security.
• GDPR: General Data Protection Regulation, a European standard for data protection.
• WebSockets: A protocol for real-time, two-way communication between a client and server.