Auto‐Notification System - aelassas/bookcars GitHub Wiki

Auto-Notification System

The auto-notification system in BookCars ensures timely communication between admins, suppliers, and drivers regarding important actions. Notifications are triggered automatically based on specific events, helping streamline operations and improve platform transparency.

Notifications Overview

1. Admin Notifications

Admins are automatically notified when:

  • A supplier adds a new car when "Notify Admin on New Car" option is enabled on supplier level.
  • A driver checks out a booking.
  • A driver cancels a booking.

This ensures that admins are aware of critical updates and can respond promptly when needed.

2. Supplier Notifications

Suppliers receive notifications when:

  • A driver checks out a booking for one of their cars.
  • A driver cancels a booking for one of their cars.

This keeps suppliers informed about activity related to their vehicles and helps them manage availability more effectively.

3. Driver Notifications

Drivers are notified when:

  • The status of their booking changes (e.g., confirmed, cancelled, or completed).

This ensures that drivers are always up to date on their bookings without needing to manually check the platform.

Push Notifications (Mobile App)

For users of the BookCars mobile app, push notifications are used to deliver real-time alerts directly to their devices. This ensures timely delivery of important updates, especially for drivers on the move.

Supported Notifications via Push

  • Booking status changes for drivers.

Requirements

  • Users must have the mobile app installed and notifications enabled at the system level.
  • A stable internet connection is required to receive notifications in real time.
  • Push notifications are powered by the platform’s backend and integrated with a cloud messaging service (Firebase Cloud Messaging).

Configuration

  • The "Notify Admin on New Car" option can be enabled or disabled for each supplier from the Create/Update Supplier page in the admin dashboard.
  • Only admins can modify this option.
  • Other notifications are built into the system and are triggered automatically when the corresponding actions occur.
  • Notifications may be delivered via email, in-app notifications, or both, depending on the platform configuration.