On-Demand Truck & Pickup Booking Platform

Business Goals

• কয়েকটি ধাপে suitable vehicle booking ও pre-booking fare estimate.
• Verified drivers-এর জন্য nearby trip requests ও transparent earnings.
• Pricing, commission, driver approval ও dispute control.
• Google Play Store-compliant MVP এবং future iOS-ready Flutter base.

90-Day Targets

Repeat booking target: >25% in 30 days.

Rafik — Customer

ছোট দোকানের owner; দ্রুত, reliable ও predictable price চান.

Kamal — Driver

১ টনের pickup driver; nearby regular trips ও fast payment visibility চান.

Nasrin — Operations

Driver documents, live trips, fares, commission ও reports পরিচালনা করেন.

Driver Management

Review, approve/reject, suspend/reactivate.

Fare & Commission

Base, per-km, minimum fare and vehicle commission.

Reports & Disputes

Live monitoring, refunds, adjustments and CSV export.

Commission Calculator

Commission rules can be configured by vehicle/service type according to the agreed business model.

Business meaning

Customer sees an estimated fare before confirming. At trip completion, the system calculates final fare from actual distance. Platform commission is deducted; driver receives the remainder (subject to payment method).

Illustrative live-tracking prototype. Production uses Google Maps Platform for maps, routing and distance.

Customer

1. Login/OTP
2. Pickup + Drop-off
3. Vehicle + fare
4. Confirm booking
5. Searching
6. Driver assigned
7. Live tracking
8. Complete + payment + rating

Driver

1. OTP login
2. Document approval
3. Online
4. Trip request
5. Accept
6. Navigate
7. Arrived → Start
8. Complete + payment + earnings

Admin

1. Secure login
2. Dashboard
3. Driver review
4. Fare/commission
5. Live trip monitor
6. Dispute/refund
7. Reports
8. CSV export

Mobile

Flutter/Dart, shared design system, Android first and iOS-ready.

Backend

Firebase managed services; Cloud Functions for matching, fare, commission, notifications and jobs.

Maps

Maps SDK, Directions, Distance Matrix and Places APIs.

Firestore

users: uid, name, phone, email, addresses, rating, status, createdAt.

drivers: uid, NID, licence, vehicle, verificationStatus, isOnline, locationRef, rating, walletBalance, status.

trips: tripId, customerId, driverId, pickup, dropoff, vehicleType, distanceKm, estimatedFare, finalFare, commissionAmount, payment, status, timestamps.

Realtime Database

/driverLocations/{driverId}
{ lat, lng, heading,
  speed, updatedAt }

Active/online driver GPS কয়েক সেকেন্ড পরপর update করবে; customer active trip চলাকালীন assigned driver node subscribe করবে. Business meaning: customer screen shows the driver moving toward pickup and destination without delay.

Matching

1. Verified online drivers + requested vehicle type.
2. Initial radius 3 km.
3. FCM + in-app request; 15–20 sec accept window.
4. First acceptকারীকে Firestore transaction-এ atomically assign.
5. Unmatched হলে 6 km → 10 km expansion rounds.

Fare

Minimum fare-এর নিচে নয়। Completion-এর সময় Cloud Function actual route distance দিয়ে final fare এবং commission server-side হিসাব করবে.

Auth

Customer/Driver Firebase Phone + OTP. Admin email/password + mandatory 2-step verification.

Access

Custom claims, Firestore Security Rules, Cloud Functions and Firebase App Check.

Private Data

Driver documents private Storage-এ; time-limited signed URL. Fare/commission/verification direct client write নয়.

Customer — 22

Splash, Login/OTP, Home, Pickup, Drop-off, Vehicle Selection, Booking Confirmation, Searching, Live Tracking, Completed/Payment, Rate Driver, History, Trip Detail, Saved Addresses, Profile, Payment Methods, Notifications, Help, Support Chat/Ticket, Referral optional, Settings, About/Legal.

Driver — 15

Splash, Login/OTP, Registration, Document Upload, Verification Pending, Home/Online, Trip Request, Navigate, Active Trip, Summary, Earnings, History, Profile, Documents Status, Help & Support.

Admin — 12

Login, Dashboard, Driver Approvals, Driver Directory, Customer Directory, Fare Settings, Commission Settings, Live Trip Monitor, Trip Disputes, Reports & Export, Notifications, Admin Users & Roles.

Trip Functions

requestTrip, respondToTrip, updateTripStatus, completeTrip.

Operations

onDriverApproved, expandSearchRadius, nightlyReportRollup.

Notifications

New request, accepted, arriving, started, completed, document decision এবং dispute/refund events.

Environment

• Separate staging and production Firebase projects.
• Firebase App Distribution for QA.
• Crashlytics + Performance Monitoring.

Rollout

• Customer and Driver separate Play Store listings.
• Privacy policy + Data Safety + store assets.
• Staged rollout: 10% → 50% → 100%.
• Minimum 6 months technical support as specified.