Base PRD + Phase 1 Add-Ons (★ New Features)
Flutter-based mobile app for customers
Login, registration, and user management
| Feature | Technical Details | Plain English |
|---|---|---|
| Phone OTP LoginBase | Firebase Phone Auth with MSG91 fallback. 6-digit OTP, 3 attempts, 5-min expiry. | Login with mobile number. App sends code to your phone. |
| Social LoginBase | Google & Apple Sign-In via Firebase Auth. Token exchange with backend JWT. | Quick login with Google or Apple. One-tap sign-in. |
| Profile ManagementBase | Name, email, photo (200KB), home/work address with Google Places API. | Edit name, photo. Save home/office addresses for quick booking. |
Core ride booking and management
| Feature | Technical Details | Plain English |
|---|---|---|
| Live BookingBase | Real-time matching via Socket.io. Nearest 5 drivers notified, first-accept wins. | Book now. App finds nearest drivers, assigns first acceptor. |
| Scheduled RidesBase | Redis job queue for future rides. 15-min pre-notification to driver. | Book for later. Driver gets reminder 15 minutes before. |
| Fare EstimationBase | Distance matrix + base fare + per-km + time charges + surge multiplier. | See price before booking based on distance, time, demand. |
| Multiple Vehicle CategoriesBase | Dynamic config: Mini, Sedan, SUV with icons and pricing. | Choose vehicle: Mini (cheap), Sedan (comfort), SUV (space). |
| Bike as Vehicle Category★ New | NEW: Bike category with fare rules, bike documents, icon assets. | NEW: Choose Bike for quick solo travel. Lower cost than cars. |
| Multiple StopsBase | Up to 3 waypoints with route optimization via Google Directions API. | Add up to 3 stops — pick up friend, drop laundry, then destination. |
| Trip OTP VerificationBase | 4-digit OTP at ride start. Driver enters to confirm pickup. | Driver asks for 4-digit code at pickup for safety. |
| Live Driver TrackingBase | WebSocket real-time location every 3 seconds. Mapbox/Google Maps with ETA. | Watch driver moving on map. See exact arrival time. |
| Book for Someone Else + SMS★ New | NEW: Enter another person's phone. SMS sent with ride details and tracking link. | NEW: Book for family/friend. They get SMS with driver info and tracking. |
| Duplicate Location Validation★ New | NEW: Reject booking if pickup/drop within 50m radius. | NEW: Prevents accidental same-location bookings. |
Long-distance and hourly bookings
| Feature | Technical Details | Plain English |
|---|---|---|
| Outstation BookingBase | Round-trip and one-way. Driver return fare calculation. | Book rides to other cities. Includes driver's return cost. |
| Outstation PauseBase | Trip pause/resume with timer. Per-hour waiting charges. | Pause trip for stops. Driver waits, charges apply after free time. |
| Car Rental (Hourly)Base | 4/8/12-hour packages with km limits. Overtime and extra km charges. | Rent car with driver: 4hr shopping, 8hr meetings, 12hr events. |
| Return Trip SchedulingBase | Book return within 7 days. Same driver preference if available. | Book return journey upfront. Get same driver if available. |
Multiple payment methods and financial management
| Feature | Technical Details | Plain English |
|---|---|---|
| Multiple Payment OptionsBase | Cash, Card (Razorpay), UPI, In-app Wallet. | Pay cash to driver, card via app, UPI, or wallet. |
| In-App WalletBase | Top-up via Razorpay. Auto-deduct for rides. Transaction history. | Add money to wallet. Auto-used for rides. Full history. |
| Saved Payment MethodsBase | Tokenized card storage (PCI-DSS). UPI ID save. One-tap payment. | Save cards and UPI. Pay with one tap next time. |
| Coupons & Promo CodesBase | Percentage and flat discounts. Expiry dates, usage limits. Auto-apply best coupon. | Apply discount codes. App uses best coupon automatically. |
| Post-Trip TipBase | Optional tip after ride. Fixed (20/50/100) or custom amounts. | Tip driver after ride if service was good. |
| Fare BreakdownBase | Itemized: base fare, distance, time, tolls, taxes, discounts, surge. | Clear receipt: base + distance + waiting + tolls - discounts. |
| Meterless/Walk-in RideBase | Street hail converted to app ride. Driver code to link trip. | Hail cab on street, enter driver's code to track and get receipt. |
Emergency features and customer assistance
| Feature | Technical Details | Plain English |
|---|---|---|
| SOS Emergency ButtonBase | One-tap alert to emergency contacts with live location. | Red button for emergencies. Alerts contacts with location. |
| Share Live TripBase | Shareable link with live tracking. Expires 30 min after trip. | Share trip with family. They see your location without app. |
| Call MaskingBase | Virtual numbers via Exotel/Twillio. Proxy routing, real numbers hidden. | Call driver without sharing real phone. Both see proxy number. |
| In-App ChatBase | Pre-set messages, image sharing for location confirmation. | Quick messages to driver. Send "I'm here" or share photo. |
| Rider Support ChatBase | Live chat with support agents. Auto-routing by issue type. | Chat with customer support in app. Get help with issues. |
| Ride History & ReceiptsBase | Past rides with details. PDF receipt download. Email option. | See past rides. Download receipts for expense reports. |
| Rate & Review DriverBase | 1-5 stars with tags (Clean car, Good driving). Anonymous. | Rate driver 1-5 stars. Tags for specific feedback. |
| Investigation Access★ New | NEW: Support sees full ride timeline, payments, location, chat for disputes. | NEW: When you report issue, support sees complete trip details. |
Flutter-based app for drivers
Driver registration and verification
| Feature | Technical Details | Plain English |
|---|---|---|
| Driver RegistrationBase | Phone OTP + progressive onboarding: personal, vehicle, documents, bank. | Sign up step by step: info, vehicle, documents, bank. |
| Document UploadBase | License, RC, Insurance, Permit, PUC. OCR expiry extraction. | Upload documents. App checks quality and reads expiry dates. |
| Bike Document Support★ New | NEW: Bike RC, Insurance, PUC. Separate validation for two-wheelers. | NEW: Bike-specific document flow. Different rules than cars. |
| Background VerificationBase | Manual admin approval. Document validity check. | Company verifies documents before you can start driving. |
| Bank Account SetupBase | Account number, IFSC validation. Penny drop verification. | Add bank for weekly payouts. Test transfer confirms account. |
Accepting and completing trips
| Feature | Technical Details | Plain English |
|---|---|---|
| Online/Offline ToggleBase | Controls availability. Location broadcast when online. | Go online to receive rides. Offline when done or on break. |
| Ride Request PopupBase | 15-second countdown. Shows pickup, drop, fare estimate. | Pop-up with ride details. 15 seconds to accept or decline. |
| In-App NavigationBase | Google Maps/Mapbox with turn-by-turn. Traffic-aware routes. | Built-in navigation to pickup and destination. Shows traffic. |
| Trip Stage ManagementBase | Arrived → Start → End flow. GPS validates location. | Tap Arrived at pickup, Start when rider boards, End at destination. |
| Trip OTP VerificationBase | Driver enters rider's 4-digit OTP to confirm pickup. | Ask rider for code before starting. Ensures correct pickup. |
| Battery % at Ride End★ New | NEW: Input battery percentage before marking complete. Shown in admin dashboard. | NEW: Enter battery % when ending ride. For EV fleet tracking. |
| Vehicle Backside Photo★ New | NEW: Capture rear vehicle photo before End Ride. Stored with trip ID. | NEW: Take photo of vehicle back before ending ride. For damage proof. |
Income tracking and cash management
| Feature | Technical Details | Plain English |
|---|---|---|
| Earnings DashboardBase | Daily, weekly, monthly breakdown. Trip count, online hours. | See earnings today, this week, this month. Charts and graphs. |
| Trip HistoryBase | All completed trips with route, fare, rider rating. | Review past trips. See route taken and what rider rated you. |
| Cash Collection TrackingBase | Log of cash rides. Pending submission amount. | Track cash payments from riders. See amount to deposit. |
| Cash Limit Enforcement★ New | NEW: Max ₹2,000 (local) / ₹5,000 (outstation). Deposit within 24hrs or blocked. | NEW: Keep up to ₹2k/₅k cash. Deposit excess in 24hrs or blocked from new rides. |
| Weekly PayoutBase | Auto bank transfer every Tuesday. Trip-wise statement. | Earnings sent to bank every Tuesday. Detailed statement. |
| Instant PayoutBase | Request early payout with small fee. RazorpayX instant transfer. | Need money early? Request instant payout for small fee. |
Attendance and compliance tracking
| Feature | Technical Details | Plain English |
|---|---|---|
| Attendance Clock-In/Out★ New | NEW: Clock in at shift start, out at end. Tracks hours and breaks. Admin dashboard reports. | NEW: Tap Start/End Shift. Company tracks your working hours. |
| Rating & PerformanceBase | Overall rating, category breakdown. Low rating alerts. | See your average rating. Breakdown of what riders liked. |
| Completion RateBase | Accepted vs completed ratio. Cancellation tracking. | Track completed vs cancelled rides. High cancellation affects priority. |
| Document Expiry AlertsBase | 30/7/1 day warnings. Upload new docs in app. | Get alerts before documents expire. Upload new ones directly. |
| Driver Support ChatBase | Live chat with fleet manager. Quick issue selection. | Chat with company for help. Quick options for common problems. |
NestJS-based backend infrastructure
Authentication and user management
| Feature | Technical Details | Plain English |
|---|---|---|
| Authentication ServiceBase | JWT auth with refresh tokens. Role-based access. Phone OTP via Firebase + MSG91. | Secure login for all users. Different permissions for riders, drivers, staff. |
| Rider Management APIBase | Profile CRUD, address management, favorites. GDPR-compliant. | Store rider info securely. Handle saved addresses and preferences. |
| Driver Management APIBase | Onboarding, documents, status tracking. Payout accounts. | Complete driver lifecycle: signup, documents, verification, payments. |
| Bike Category Management★ New | NEW: Separate bike category with distinct fare rules and validation. | NEW: Manage bike type with its own pricing and requirements. |
Matching, pricing, and tracking
| Feature | Technical Details | Plain English |
|---|---|---|
| Ride Matching EngineBase | Redis + Socket.io real-time matching. Nearest driver algorithm. 60-sec timeout. | Find nearest driver in real-time. Notify closest drivers, first-accept wins. |
| Dynamic Pricing (Surge)Base | Demand-based multiplier. Factors: availability, requests, weather, events. | Higher prices when busy. Considers driver count, demand, weather. |
| Scheduled Ride QueueBase | Redis job queue for future rides. 15-min driver notification. | Store advance bookings. Remind drivers before scheduled time. |
| Live Location TrackingBase | WebSocket GPS updates every 3 seconds. Geospatial indexing. | Track driver location real-time. Store 30-day history. |
| Duplicate Location Validation★ New | NEW: Reject if pickup/drop within 50m. Haversine distance calculation. | NEW: Prevent bookings where pickup and drop are too close together. |
| Book-for-Someone SMS★ New | NEW: Trigger SMS to alternative number on booking with ride details and tracking link. | NEW: When booking for another person, they get SMS with all details. |
Payment processing and financial operations
| Feature | Technical Details | Plain English |
|---|---|---|
| Razorpay IntegrationBase | Card, UPI, wallets, net banking. Webhook handling. Refund processing. | Process all digital payments securely. Handle cards, UPI, refunds. |
| In-App Wallet SystemBase | Wallet top-up, auto-deduct, transaction history. Ledger accounting. | Digital wallet for riders. Add money, auto-payment, full history. |
| Cash Payment LoggingBase | Mark rides as cash-paid. Track driver's cash collection liability. | Track cash payments to drivers. Monitor how much each driver owes. |
| Cash Limit Tracking★ New | NEW: Track cumulative cash per driver. Enforce limits. Soft-block if deadline missed. Admin override API. | NEW: Monitor driver cash holdings. Block new rides if over limit and not deposited. |
| Driver Payout SystemBase | Weekly automated payout. RazorpayX bulk transfer. Failed payout retry. | Calculate and send weekly earnings to driver banks. Handle failed transfers. |
| Coupon & Promo SystemBase | Create promo codes with expiry, usage limits. Auto-apply logic. | Create and manage discount codes. Set expiry dates and usage limits. |
React-based web dashboard for operations and fleet management
Real-time tracking and dispute resolution
| Feature | Technical Details | Plain English |
|---|---|---|
| Live Tracking DashboardBase | Real-time map showing all active drivers and rides. Filter by city, status, vehicle type. | See all drivers and rides happening now on a map. Filter by city. |
| Active Drivers ListBase | Tabular view with location, status (idle/on-ride), current ride, earnings today. | List view of working drivers. See who's busy, who's free, daily earnings. |
| EV Battery Monitoring★ New | NEW: Display battery % from last ride. Color-coded: Green (>50%), Yellow (20-50%), Red (<20%). | NEW: See electric vehicle battery levels. Identify which drivers need charging. |
| Driver Attendance Dashboard★ New | NEW: View clock-in/out times. Online hours with break deductions. Daily/weekly/monthly reports. | NEW: Track when drivers start and end shifts. See total working hours, breaks. |
| Ride Status MonitorBase | List of all rides with status, driver, rider, fare. Search by ID, phone, date. | Monitor every ride. Search by phone or ride ID. Cancel problem rides. |
| Issue & ComplaintsBase | List of complaints categorized by type. Assignment to agents. Status tracking. | Track all complaints. Assign to staff, monitor resolution, see history. |
| Investigation Drilldown★ New | NEW: Deep-dive for disputes. Timeline of all events, payments, GPS trail, chat history. Export PDF. | NEW: Investigate thoroughly. See complete ride story: every stop, payment, message. Export report. |
| SOS Alert MonitorBase | Real-time SOS alerts with location. Auto-notification to emergency contacts. | Immediate alert when rider presses emergency button. See location, call rider. |
Driver onboarding and performance tracking
| Feature | Technical Details | Plain English |
|---|---|---|
| Driver Approval WorkflowBase | Queue of pending applications. Document viewer. Approve/Reject with reason. | Review new driver applications. Check documents, approve or reject. |
| Document VerificationBase | View uploaded documents. OCR-extracted expiry dates. Expiry alerts dashboard. | Verify driver documents. See expiry dates, send renewal reminders. |
| Driver Performance MetricsBase | Rating trends, completion rate, cancellation rate, earnings. Compare time periods. | See driver performance. Who's highly rated, who cancels too much. |
| Driver BlockingBase | Soft block (no new rides) vs hard block (account disabled). Reason logging. | Block problematic drivers temporarily or permanently. Log reasons. |
| Cash Limit Override★ New | NEW: View drivers exceeding limits. Manual unblock after deposit. Trusted driver whitelist. | NEW: Unlock drivers who deposited late. Mark trusted drivers for auto-approve. |
| Payout ManagementBase | Weekly batch processing. Failed payout retry. Instant payout approval. | Process weekly payments. Handle failed transfers, approve early payouts. |
Service configuration and pricing
| Feature | Technical Details | Plain English |
|---|---|---|
| City & Zone ManagementBase | Add/edit cities. Define service zones with geo-fencing. Operating hours per zone. | Manage cities where you operate. Draw service boundaries. Set operating hours. |
| Vehicle Category ConfigBase | Create/edit vehicle types. Upload icons, set base fare, per-km rate, min/max fare. | Configure vehicle types. Set prices for Mini, Sedan, SUV, Bike. Upload icons. |
| Surge Pricing RulesBase | Create surge zones on map. Set multiplier thresholds. Time-based rules. Manual override. | Set high-demand zones. Increase prices when busy. Override manually. |
| Fare & Commission RulesBase | Platform fee, booking fee, tax settings. Commission % per category. City-wise config. | Set company fees and driver commission. Different rates for cities and vehicle types. |
| Coupon ManagementBase | Create promo codes. Set discount type, value, min ride value, max discount, usage limits. | Create discount codes. Set how much off, minimum order, who can use, expiry. |
| CMS & AnnouncementsBase | Edit help articles, FAQs, Terms. Announcement banners. Push notification composer. | Edit app content. Send announcements to all users. Compose push notifications. |