Fleet and Vehicles

Overview

The Vehicles module (section I) maintains the operator's fleet inventory. Vehicle records are the physical-resource layer of the dispatch and pricing engines: a vehicle's category, capacity, and operational base feed directly into cost calculations and route filtering.

Vehicle List (I-01)

The vehicle list displays every registered vehicle with:

• Registration plate (immatriculation)
• Category (Berline, Van, Minibus, Luxury, etc.)
• Make and model (e.g. Mercedes-Benz E-Class)
• Mileage (current odometer reading in km)
• Assigned driver (primary driver name or "Unassigned")
• Status: Operational, In maintenance, Inactive

Use the filter bar to narrow by category, status, or assigned driver. Click any row to open the vehicle detail.

Vehicle Detail (I-02)

The vehicle detail view contains:

Identification

• Registration plate
• VTC registration number (numéro d'immatriculation VTC)
• Make, model, year
• Colour
• Number of passenger seats
• Vehicle category (linked to the pricing engine)

Operational Data

• Current mileage: updated automatically when drivers submit end-of-mission reports via the driver app.
• Fuel consumption (fuelConsumption): litres per 100 km, used by the shadow cost calculator when estimating approach (Segment A) and return (Segment C) leg costs. See Operational Base below.
• Periodic inspection dates (contrôle technique) and expiry
• Insurance certificate expiry

Operational Base

The operational base is the habitual starting location of the vehicle — the depot or parking spot where the vehicle rests between missions. It is used by the pricing engine when calculating the shadow cost of a trip:

• Segment A (approach leg): distance from the operational base to the mission pickup point — this is an unladen journey that has a fuel cost but generates no revenue.
• Segment C (return leg): distance from the mission drop-off point back to the operational base — same logic.

Setting an accurate operational base for each vehicle ensures that the shadow cost model correctly accounts for deadhead mileage when computing the true profitability of a mission.

To set or update the operational base, click Edit base and enter an address or drop a pin on the map.

Driver Assignment History

Chronological log of all primary driver assignments for this vehicle, with start and end dates.

Mission History

Paginated list of missions completed in this vehicle. Each row shows the mission date, driver name, pickup, drop-off, distance, and revenue generated.

Vehicle Categories (I-03)

Vehicle categories are the pricing-engine identifiers that link fleet vehicles to pricing rules and dispatch filters. The category list shows:

Standard category codes defined in the VehicleCategory enum:

Operators can create custom categories or edit the capacity and code of existing ones. Category changes take effect immediately in dispatch filters and quote line suggestions, but do not retroactively modify existing quote lines.

Adding a New Vehicle

1. Click + New vehicle from the vehicle list.
2. Enter the registration plate — the system checks for duplicates.
3. Select the vehicle category.
4. Fill in make, model, year, and mileage.
5. Set the operational base (address or map pin).
6. Enter fuel consumption (L/100km).
7. Assign a primary driver (optional at creation).
8. Click Save.

Taking a Vehicle Out of Service

To temporarily exclude a vehicle from dispatch (e.g. during scheduled maintenance):

1. Open the vehicle detail.
2. Click Status → Set to maintenance.
3. Optionally set an estimated return-to-service date.

The vehicle disappears from the dispatch assignment panel until its status is set back to Operational. Any existing confirmed missions for this vehicle are not automatically reassigned — you must do so manually from the Dispatch board.