Maintenance Mode

Maintenance mode is a vehicle status that removes a vehicle from customer availability while indicating it requires service, repair, or inspection. Vehicles in maintenance mode are hidden from the mobile app and cannot be unlocked by customers.

Overview

When a vehicle needs attention, setting it to "Maintenance" status ensures:

• Customers cannot see or unlock the vehicle
• Staff knows the vehicle requires service
• The vehicle is tracked separately in fleet reports
• Maintenance history is preserved for the vehicle

Vehicle Status Options

Setting Maintenance Mode

From Vehicle List

From Vehicle Detail Page

Bulk Status Update

For multiple vehicles needing maintenance:

1. Go to Dashboard → Vehicles
2. Select multiple vehicles using checkboxes
3. Click Bulk Actions → Change Status
4. Select Maintenance
5. Confirm the bulk update

What Happens in Maintenance Mode

Mobile App Behavior

• Vehicle disappears from the map
• Cannot be scanned or unlocked
• Not included in "nearby vehicles" list
• No QR code scanning possible

Dashboard Display

• Status shows as yellow "Maintenance" badge
• Vehicle appears in maintenance filter
• Counted in "Maintenance" status category
• Map marker shows maintenance indicator

IoT Commands

When setting a vehicle to maintenance:

• Lock command may be sent (if unlocked)
• Vehicle becomes non-operational
• IoT continues reporting location/battery

Tracking Maintenance

Vehicle Notes

Add notes to track maintenance details:

1. Open vehicle detail page
2. Find Notes section
3. Add maintenance reason and date
4. Save for maintenance history

Custom Fields

If configured, use custom fields for:

• Maintenance type (repair, inspection, cleaning)
• Technician assigned
• Parts needed
• Expected completion date

Returning to Service

Pre-Return Checklist

Before returning a vehicle to service:

• Repair complete and tested
• Battery sufficiently charged
• IoT device connected and reporting
• Vehicle clean and presentable
• Located in service area
• Notes updated with resolution

Common Maintenance Scenarios

Scheduled Servicing

Regular maintenance intervals:

1. Set vehicle to Maintenance before service appointment
2. Perform scheduled maintenance
3. Update notes with service completed
4. Return to Available when done

Emergency Repairs

Vehicle reported damaged or malfunctioning:

1. Immediately set to Maintenance
2. Investigate issue
3. Arrange repairs
4. Test thoroughly before returning to service

Battery Swap

When replacing or servicing batteries:

1. Set to Maintenance or Charging
2. Swap or charge batteries
3. Verify battery level reporting
4. Return to Available

Seasonal Preparation

Preparing fleet for season changes:

1. Bulk select vehicles for service
2. Set all to Maintenance
3. Perform seasonal prep (tire changes, inspections)
4. Return vehicles to service in batches

Email Alerts

Configure maintenance-related alerts in Settings:

Maintenance Reminders

Setting Up Alerts

1. Go to Dashboard → Settings
2. Find Email Notifications section
3. Enable Maintenance Reminders
4. Configure recipients and intervals

Best Practices

When to Use Maintenance Mode

Use maintenance for:

• Mechanical repairs needed
• Electrical issues
• Tire damage or wear
• Brake servicing
• Body damage repair
• IoT device issues
• Regular inspections

Consider other statuses for:

• Battery charging → Use "Charging"
• Long-term storage → Use "Storage"
• Moving between locations → Use "Transportation"
• Testing new features → Use "Available (Hidden)"

Documentation

1. Always add notes - Record why vehicle is in maintenance
2. Include dates - When maintenance started, expected end
3. Track patterns - Identify recurring issues
4. Update on completion - Note what was done

Response Times

Reporting

Maintenance Metrics

Track maintenance performance:

• Vehicles in maintenance - Current count
• Average maintenance duration - Time to resolution
• Maintenance frequency - Issues per vehicle
• Fleet availability - % available vs maintenance

Dashboard Views

Filter vehicle list by maintenance status:

1. Go to Vehicles page
2. Click Status filter
3. Select Maintenance
4. View all vehicles currently in maintenance

API Reference

Update Vehicle Status

PATCH /api/vehicles/{id}
{
  "status": "maintenance"
}

Partner API

PATCH /api/partner/v1/vehicles/{id}
{
  "status": "maintenance"
}

Response

{
  "data": {
    "id": "uuid",
    "vehicle_number": "V001",
    "status": "maintenance",
    "updated_at": "2025-01-15T10:30:00Z"
  },
  "iotCommand": {
    "attempted": true,
    "success": true
  }
}