Documentation

Knowledge Base

Managing Maintenance

The Maintenance page helps you track service schedules for your vehicles. You can set up maintenance reminders based on various metrics including distance traveled, engine hours, fuel consumption, and many other vehicle parameters.

Viewing Maintenance Records

The Maintenance table displays the following columns:

  • ID: Unique identifier (hidden by default)
  • Name: Maintenance task name (e.g., "Oil Change", "Tire Rotation")
  • Type: How the maintenance is tracked (Total Distance, Engine Hours, etc.)
  • Vehicle: Which vehicle this maintenance applies to
  • Start: The initial reading when maintenance was last performed
  • Period: How often the maintenance should be done
  • Sync Status: Real-time connection status with visual indicators
  • Actions: Edit and Delete options

On mobile devices, columns like Type, Vehicle, Start, Period, and Sync Status are automatically hidden for better readability.

Maintenance Types

NexaBus supports over 40 maintenance tracking types organized by category:

Distance-Based

  • Total Distance: Overall kilometers traveled
  • Odometer: Vehicle odometer reading
  • Service Odometer: Service-specific odometer
  • Trip Odometer: Trip distance

Time-Based

  • Engine Hours: Engine running time
  • Driving Time: Active driving duration

Fuel Metrics

  • Fuel: Fuel level monitoring
  • Fuel Used: Total fuel consumed
  • Fuel Consumption: Consumption rate

Engine Parameters

  • RPM: Engine revolutions
  • Coolant Temperature: Engine coolant temp
  • Engine Temperature: Engine temp sensor
  • Throttle: Throttle position

Battery & Power

  • Power: Voltage reading
  • Battery: Battery voltage
  • Battery Level: Battery percentage

And Many More

Including speed, altitude, GPS accuracy, humidity, device temperature, and various OBD parameters.

Understanding Type, Start, and Period

The Type determines what units are used, and values are automatically formatted:

Distance Types (stored in meters, displayed in km):

  • Start = Odometer at last service (e.g., 50,000 km)
  • Period = Service interval (e.g., 10,000 km)
  • Next service due at 60,000 km

Hour Types (stored in milliseconds, displayed in hours):

  • Start = Engine hours at last service (e.g., 500 hours)
  • Period = Service interval (e.g., 100 hours)
  • Next service due at 600 hours

Other Types display with appropriate units (°C for temperature, V for voltage, L for fuel, etc.)

Searching for Maintenance

Use the search field to find maintenance records. The search works across name, type, sync status, and vehicle name. Results update as you type.

Customizing Columns

  1. Click the Columns button above the table.
  2. Check or uncheck columns to show or hide them.

Adding a Maintenance Record

  1. Click the Add Maintenance button.
  2. Fill in the maintenance details:

Form Fields

  • Name (Required): Describe the maintenance task (e.g., "Oil Change", "Brake Inspection")
  • Type (Required): Select how to track this maintenance from over 40 available types
  • Start (Required): Enter the reading when maintenance was last performed. A hint shows the expected unit format.
  • Period (Required): Enter the interval between services
  • Vehicle (Optional): Select which vehicle this maintenance applies to
  1. Click Create Maintenance.

Example Maintenance Records

  • Oil Change: Type = Total Distance, Start = 45,000 km, Period = 5,000 km
  • Air Filter: Type = Total Distance, Start = 40,000 km, Period = 20,000 km
  • Engine Service: Type = Engine Hours, Start = 1,000 hours, Period = 500 hours
  • Coolant Check: Type = Coolant Temperature, monitors temperature thresholds

Editing a Maintenance Record

  1. Find the maintenance record in the table.
  2. Click the actions menu (three dots) in that row.
  3. Select Edit.
  4. Update the details as needed.
  5. Click Update Maintenance.

Tip: After completing a service, update the Start value to the current reading (odometer, engine hours, etc.).

Deleting a Maintenance Record

  1. Find the maintenance record in the table.
  2. Click the actions menu (three dots) in that row.
  3. Select Delete.
  4. Confirm the deletion.

Understanding Sync Status

Maintenance records sync with the NexaBus tracking server in real-time:

  • Syncing: Spinning icon indicates sync in progress (yellow)
  • Synced: Check icon confirms successful synchronization (green)
  • Failed: Error icon indicates sync failed - click to retry (red)

Sync status updates automatically without refreshing the page.

Retry Sync

If a maintenance record shows "Failed" status:

  1. Click the sync status button to retry

The record will attempt to sync again with the tracking server.

Pagination

The table displays 10 maintenance records per page. Use the pagination controls at the bottom to navigate:

  • First and Last page buttons
  • Previous and Next page buttons
  • Current page indicator showing "Showing X to Y of Z"

Permissions

You need the appropriate permissions to add, edit, or delete maintenance records:

  • Create: Requires maintenance:create permission
  • Edit: Requires maintenance:update permission
  • Delete: Requires maintenance:delete permission

If these options are not visible, contact your administrator to request access.

Ready to Transform Your Fleet Operations?