Taxi operations platform system description

The Taxi operations platform is an integrated, multi-portal system for managing end-to-end ride-hailing operations: customer booking, driver dispatch, fleet management, payments, settlements, compliance, and backoffice administration. The platform supports the full operational lifecycle from onboarding and booking to trip completion, payout, and reporting.

Key features

1. System access and identity
   • Login, registration (passenger/driver/fleet), email/OTP verification, JWT sessions, refresh tokens, Google login, role-based access.
2. Multi-portal experience
   • Public website, admin backoffice, passenger portal, driver portal, taxi company portal, and public ride-tracking page.
3. Ride lifecycle management
   • Immediate and scheduled rides, offer/accept flow, arrival/start/complete/cancel states, reassignment, no-driver handling.
4. Dispatch and matching
   • Tiered dispatch radius strategy with background processing, timeout handling, and driver availability controls.
5. Pricing and fare calculation
   • Fare estimation with map distance/time, vehicle category pricing, location rules, airport surcharge rules, and promo discounts.
6. Driver and fleet operations
   • Driver onboarding, online/offline status, vehicle assignment, fleet company roster management, settlements.
7. Passenger management
   • Passenger profiles, booking history, wallet usage, notifications, support and safety workflows.
8. Financial operations
   • Ride transactions, commissions/VAT/tips, wallets, top-ups, manual adjustments, withdrawals, invoices, settlement tracking.
9. KYC and compliance
   • KYC submission/review flows, insurance document expiration workflows, account deletion requests, full audit trail.
10. Reports and analytics
    • Trips, referrals, bank-fee, and ledger reports with export capabilities; operational dashboards for admin/fleet/driver.
11. Communications
    • SignalR real-time events, push notifications, SMS/email templates and logs, contact message handling.
12. Content and platform control
    • CMS for static pages, FAQ, banners, news, mobile app settings, and general system configuration.

System modules

1) Identity and user management module

Manages authentication and user lifecycle across all roles:

• Roles: admin, passenger, driver, fleet company
• OTP/2FA and password reset flows
• Account status checks (active/suspended), KYC state awareness
• Role-aware portal routing after login

2) Public website and onboarding module

Handles public-facing acquisition and registration:

• Homepage with fare estimation
• About/contact/legal/FAQ pages
• Registration for passenger, driver, and fleet company

3) Ride booking and dispatch module

Core operational engine for booking and assignment:

• Manual and scheduled booking
• Driver offer and acceptance logic
• Real-time ride state transitions
• Dispatch rule configuration (radius tiers/time windows)

4) Ride operations and tracking module

Supports monitoring and control across the full ride lifecycle:

• Ride list/detail views per role
• Public token-based trip tracking
• Admin override actions (cancel/reassign)
• Route and status timeline visibility

5) Driver management module

Controls individual driver operational capability:

• Driver registration and profile management
• Vehicle assignment and insurance tracking
• Earnings, transaction history, withdrawals
• Driver-side booking workspace with real-time updates

6) Fleet company management module

Supports B2B/fleet operations:

• Fleet profile and compliance workflows
• Driver roster and company vehicles
• Company transaction and settlement views
• Fleet dashboard and invoicing

7) Passenger management module

Supports customer profile and self-service:

• Passenger admin CRUD
• Passenger portal for bookings, rides, wallet, transactions
• Help/support, notifications, and profile updates

8) Pricing and service configuration module

Centralized control of commercial logic:

• Vehicle type and category pricing
• Geographical/location fare rules
• Airport surcharges
• Promo codes and referral-linked discounts

9) Payments, wallet, and transaction module

Handles monetary events around rides:

• Payment methods: cash/card/wallet/manual/bank transfer
• Wallet balance and top-up sessions
• Transaction details and ledger consistency
• Card payment retry and reconciliation support

10) Invoicing and settlement module

Provides accounting outputs and payout controls:

• Automated and manual invoice workflows
• Driver/fleet settlement screens
• Withdrawal request and approval workflow
• Exportable financial records

11) KYC, compliance, and safety module

Ensures operational trust and controls:

• KYC submissions and admin review
• Vehicle insurance compliance reminders and status updates
• SOS/emergency contact features
• Account deletion request and purge workflow

12) Reporting and dashboard module

Provides operational and financial intelligence:

• KPI dashboards by role
• Trips report, referral report, bank fee report, general ledger report
• Excel/PDF exports for review and reconciliation

13) Communications and notifications module

Coordinates outbound and in-app communications:

• SignalR real-time notifications
• Push notifications (event-based)
• SMS/email templating and delivery logs
• Contact message intake and admin response workflows

14) Content and CMS module

Supports controlled platform content operations:

• Static pages and footer management
• FAQs, banners, and news management
• Mobile settings/onboarding content blocks

15) Platform settings and administration module

Governs global platform behavior:

• General app/ride/price settings
• Dispatch and referral configuration
• Region/city master data and service zones
• Audit trail and error log access