Passenger Features

Dashboard Overview

The passenger dashboard provides a centralized view of all ride-related activities:

Ride Search & Booking

Advanced Search

The ride search system offers comprehensive filtering options:

// Location: src/pages/passenger/FindRide.tsx
const useRideSearch = (initialFrom, initialTo, driverParam) => {
  // Search functionality with real-time filtering
  const handleSearch = async () => {
    const response = await availableRidesService.getAvailableRides();
    // Apply location and driver filters
    // Transform data for display
  };
};

Search Features

• Location Autocomplete - Google Places integration for accurate location selection
• Date Selection - Calendar picker for departure date
• Seat Requirements - Specify number of passengers
• Driver Filtering - Search rides by specific drivers
• Real-time Results - Live updates from available rides API

Booking Process

Ride Management

Upcoming Rides

Passengers can view and manage their upcoming ride bookings:

// Location: src/pages/passenger/UpcomingRides.tsx
const UpcomingRides = () => {
  const { data: passengerRides } = useQuery({
    queryKey: ['rides', 'passenger', user?.id],
    queryFn: () => rideService.getPassengerRides()
  });
  
  // Display upcoming bookings with actions
};

Available Actions

• View Details - Complete ride information including driver contact
• Contact Driver - Direct messaging with the driver
• Trip Tracking - Real-time location updates (when available)
• Cancel Booking - Cancel rides with appropriate refund policies
• Rate Experience - Post-ride rating and feedback system

Ride History

Complete history of all past rides with filtering and search capabilities:

Communication Features

Driver Messaging

Built-in messaging system for communication with drivers:

// Location: src/pages/passenger/Chat.tsx
const Chat = () => {
  const { data: conversations } = useQuery({
    queryKey: ['conversations'],
    queryFn: () => chatService.getConversationList()
  });
  
  // Real-time messaging with drivers
};

Messaging Features

• Real-time Chat - Instant messaging with automatic updates
• Message Status - Read receipts and delivery confirmations
• Media Sharing - Share images and location information
• Chat History - Access to previous conversations
• Safety Features - Report inappropriate messages

Wallet & Payments

Digital Wallet

Integrated wallet system for seamless payments:

// Location: src/pages/passenger/Wallet.tsx
const Wallet = () => {
  const { data: walletData } = useQuery({
                            queryKey: ['wallet', user?.id],
    queryFn: () => walletService.getWalletBalance()
  });
  
  // Wallet management and transactions
};

Wallet Features

• Balance Management - Add funds and view current balance
• Transaction History - Complete record of all payments
• Multiple Payment Methods - Credit cards, digital wallets, bank transfers
• Auto-reload - Automatic balance top-up when low
• Refund Processing - Automatic refunds for cancelled rides

Rating & Feedback

Driver Rating System

Comprehensive rating system to maintain service quality:

// Location: src/pages/passenger/Ratings.tsx
const Ratings = () => {
  const submitRating = async (rideId, rating, feedback) => {
    await ratingService.submitDriverRating({
      ride_id: rideId,
      rating: rating,
      feedback: feedback
    });
  };
};

Rating Features

• 5-Star Rating - Rate drivers on overall experience
• Category Ratings - Rate punctuality, cleanliness, driving
• Written Feedback - Detailed comments and suggestions
• Anonymous Reviews - Privacy-protected feedback system
• Rating History - View all submitted ratings

Favorites & Preferences

Saved Locations

Quick access to frequently used locations:

Ride Preferences

Customize default settings for a personalized experience:

// Location: src/api/services/preferencesService.ts
export const preferencesService = {
  getTripPreferences: () => apiCall(AppConstants.getTripPreferences),
  saveTripPreferences: (preferences) => 
    apiCall(AppConstants.saveTripPreferences, preferences)
};

Preference Options

• Default Seat Count - Automatically set number of passengers
• Preferred Departure Times - Default time ranges for searches
• Maximum Distance - Set limits for pickup/dropoff walking distance
• Vehicle Preferences - Preferred car types and amenities
• Communication Preferences - How drivers can contact you

Safety Features

Mobile Experience

Progressive Web App

WI-CARPOOL is built as a PWA for optimal mobile experience:

• Offline Access - View bookings and history without internet
• Push Notifications - Ride updates and driver messages
• Home Screen Install - Add to device home screen like a native app
• Location Services - GPS integration for accurate pickup locations
• Camera Access - Photo sharing in chat conversations

Responsive Design

Optimized interface across all devices: