Rush2U — On-Demand Delivery Platform

Laravel customer-facing application for on-demand delivery services. Users place delivery orders, track drivers in real time on a live map, and receive instant push notifications on status updates.

---

Overview

Rush2U connects customers with nearby delivery drivers for same-day, on-demand courier services. The platform is split across two applications:

rush2u       — THIS REPO — Customer-facing web/mobile app
rush2uAdmin  — Dispatch and operations management panel

---

Features

Order Placement & Management

• Multi-step order creation: pickup address, delivery address, package details
• Estimated cost calculation before order confirmation
• Order history with full status timeline

Real-Time Driver Tracking

• Live GPS driver location updates via Pusher WebSockets
• Interactive map showing driver position and estimated arrival time
• Laravel Echo client subscribes to driver location broadcast channel

Secure In-App Payments

• Online payment processing at checkout
• Saved payment method support
• Cash on delivery option

Order Status Notifications

• Push notifications at each status change: confirmed, driver assigned, picked up, en route, delivered
• In-app notification center with read/unread state

Driver Rating System

• Post-delivery rating and review submission
• 5-star rating with optional written review
• Rating history visible on driver profile

---

Architecture

Customer places order
    |
    v
Order assigned to nearby driver (by rush2uAdmin dispatcher)
    |
    v
Driver app broadcasts GPS location
    |
    v
Pusher -> Laravel Echo -> Customer browser/app
(live tracking map updates every N seconds)
    |
    v
Driver marks delivery complete
    |
    v
Customer receives completion notification + rating prompt

---

Database Schema

Table	Key Columns
users	id, name, email, phone, address
orders	id, customer_id, driver_id, pickup_address, delivery_address, status, total_price
order_items	order_id, description, weight, dimensions
drivers	id, user_id, vehicle_type, license_plate, is_available, current_lat, current_lng
order_tracking	order_id, lat, lng, status, recorded_at
payments	order_id, amount, method, status, transaction_id
ratings	order_id, customer_id, driver_id, score, review
notifications	user_id, type, data, read_at

---

Getting Started

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan serve

Required environment variables:

PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_APP_CLUSTER=
BROADCAST_DRIVER=pusher

Related Repositories

Repo	Purpose
rush2uAdmin	Operations and dispatch management panel