🚗 Real-Time Ride Dispatch Simulation

A high-performance ride dispatch and pooling simulation.

✨ Features

• Real-time vehicle simulation
• Intelligent ride assignment
• Dynamic route optimization
• Ride pooling with constraints:
  • vehicle capacity
  • maximum detour
  • pickup distance limits
• Live visualization via Server-Sent Events (SSE)
• Smooth vehicle movement with interpolation
• Interactive debug UI (vehicle inspection)

---

🧠 Core Concepts

This project explores key backend and system design topics:

• Dispatch algorithms
• Route optimization
• Stop-based routing model
• Constraint-based ride pooling
• Real-time state streaming
• Simulation systems

---

🏗️ Architecture

Rust Backend

• Simulation Engine (tick loop)
• Dispatch System
• Routing / Stop Insertion
• SSE Stream

Frontend (Vanilla JS)

• Canvas Rendering
• Animation Interpolation
• Debug UI

---

🚀 How to run

1. Start backend

cargo run

2. Open frontend

Open index.html in your browser.

The frontend connects to:

http://127.0.0.1:3000/events