🛺 ShirdiRide — Production-Ready Auto Rickshaw Booking Platform

ShirdiRide is an enterprise-grade, mobile-first Auto Rickshaw booking platform designed for seamless mobility in pilgrimage and urban environments (specifically tailored for Shirdi, Maharashtra & beyond). It features instant ride matching, dynamic fare estimation, live GPS tracking simulation, multi-role dashboards (Customer, Driver, Admin), AI dynamic surge & demand prediction, wallet & Razorpay payments, and multi-language support (English, Hindi, Marathi).

---

🌟 Key Features

👤 Customer Features

• Hero & Live Fare Calculator: Instant fare estimates between Shirdi Railway Station, Sai Baba Mandir, Airport, and Shani Shingnapur.
• Vehicle Tiers: Standard Auto, Eco EV Auto, Shared Temple Rickshaw, and Premium XL Rickshaw.
• Live GPS Tracking: Interactive map displaying real-time driver coordinates and route polyline.
• OTP Verification: Secure 4-digit verification code display for trip start validation.
• 1-Tap SOS Button: Emergency dispatch integration with Shirdi Police & support lines.
• ShirdiRide Pay Wallet: Instant wallet top-up via UPI/Razorpay, transaction logs, and promo coupons (SAIBABA100).
• Multilingual Support: Switch seamlessly between English (EN), Hindi (HI), and Marathi (MR).

🏎️ Driver Console

• Duty Toggle: Instant Online / Offline availability switch.
• Dispatch Alert Console: Incoming ride request popups with ride distance, estimated net payout, and accept/decline countdown timer.
• Active Navigation: Turn-by-turn route map, customer OTP entry, and trip completion controls.
• Earnings Analytics: Daily, weekly, and monthly net earnings with rating tracking.

🛡️ Admin Command Center

• Executive Metrics: Gross booking volume, net 15% platform commission, live active rides count.
• Active Ride Radar: Live stream monitor of all active bookings across Shirdi.
• Driver KYC Approval Queue: Document and vehicle registration verification tools.
• Report Exporter: Downloadable CSV audit reports.

🤖 AI Capabilities

• RickshawBuddy AI: Travel & booking assistant answering queries on Mandir timings, fare rules, and safety tips.
• Demand Zone Radar: Dynamic surge calculation based on high pilgrim traffic zones.

---

🏗️ Architecture & Technical Stack

graph TD
    Client[Next.js 15 App Router / React 19] --> API[Next.js 15 API Routes /api/v1/*]
    API --> Prisma[Prisma ORM]
    API --> Auth[JWT + bcrypt Auth Engine]
    Prisma --> DB[(SQLite / PostgreSQL Database)]
    Client --> Map[Leaflet Live GPS Interactive Radar]
    Client --> AI[RickshawBuddy AI Assistant Engine]

Loading

Database ER Diagram

erDiagram
    USER ||--o{ BOOKING : "places"
    USER ||--o| DRIVER_PROFILE : "has"
    USER ||--o| WALLET : "owns"
    DRIVER_PROFILE ||--o| VEHICLE : "operates"
    DRIVER_PROFILE ||--o{ BOOKING : "fulfills"
    BOOKING ||--o| PAYMENT : "generates"
    BOOKING ||--o| REVIEW : "receives"
    WALLET ||--o{ WALLET_TRANSACTION : "contains"

Loading

---

🔑 Demo Access Credentials

Role	Phone Number	Password	Notes
Super Admin	9900000000	password123	Full control panel access
Customer (Pilgrim)	9876543210	password123	Pre-funded with ₹500 wallet balance
Driver (Vijay)	9123456781	password123	Stationed near Sai Baba Temple
Driver (Ganesh)	9123456782	password123	Stationed near Railway Station

Note: You can also sign in via Phone OTP using any 10-digit number and entering 1234!

---

🚀 Quickstart Guide

1. Clone & Install Dependencies

cd ShirdiRide
npm install

2. Database Sync & Seed

npx prisma db push
node prisma/seed.js

3. Launch Development Server

npm run dev

Open http://localhost:3000 in your browser.

---

🐳 Docker Deployment

To build and launch the production container:

docker-compose up --build -d

---

📄 License

Copyright © 2026 ShirdiRide Technologies Inc. Released under the MIT License.