Vehicle Details
View and manage individual vehicle information, component lifecycle, and maintenance history.
Overview
The vehicle details page shows everything about a single piece of equipment: its identification, operational status, component lifecycle tracking, and recent activity. Navigate here by clicking any vehicle in the fleet list.
Breadcrumb and Navigation
A breadcrumb trail at the top shows Fleet / [Vehicle Name]. The vehicle name displays the unit number, fleet ID, or model name (whichever is available, in that priority). A Back to Fleet button returns you to the fleet list.
Machine Details Card
The header card displays the vehicle's core information in a dense grid layout:
| Field | Description |
|---|---|
| Unit Number | Internal identifier with a copy-to-clipboard button |
| Model | Equipment model display name from the OEM catalog |
| Serial Number | Manufacturer serial with copy-to-clipboard button |
| Profile | Linked lifecycle profile name (clickable to navigate to the profile) |
| Daily Utilization | Operating hours per day (e.g., "20 hrs/day") |
| LTD Frame Hours | Lifetime hours to date with comma formatting |
| Last Hour Submission | Date of the most recent meter reading |
| Status | Color-coded badge (Active, Inactive, Maintenance, Retired) |
Quick Action Buttons
Below the details grid, action buttons link to related pages filtered for this vehicle:
- Work Order Scheduler -- opens the scheduler with this vehicle pre-selected
- Forecast -- opens the forecast view filtered to this vehicle
- Work Orders -- opens work orders filtered to this vehicle
- Notifications -- opens notifications for this vehicle
Editing Machine Information
Click Machine Information to open a dialog showing all vehicle fields. The dialog has two modes:
View mode (default): Displays all fields as read-only text. Shows additional fields not visible in the header card:
- Commission Date
- Location (site name)
- Equipment Type
- Location Note
Edit mode: Click the Edit button in the dialog header to enable editing on these fields:
- Daily Utilization (hours)
- LTD Frame Hours
- Status (dropdown: Active, Inactive, Maintenance, Retired)
- Location Note
- Notes (free-text area)
Click Save Changes to persist edits, or Cancel to discard. All changes are audit-logged.
Deleting a Vehicle
In the Machine Information dialog (view mode), Admin users see a Delete Machine button. Clicking it shows a confirmation dialog. Deletion is a soft delete -- the vehicle is hidden from queries but its data is preserved.
Component Lifecycle Table
The Component Lifecycle section appears below the machine header. It shows all components defined in the vehicle's assigned lifecycle profile, with calculated lifecycle data.
If the vehicle has no profile assigned, a message explains that a profile is needed to display component tracking.
Searching Components
A search bar above the table filters components by name or position. A result count is shown when a search term is active.
Columns
| Column | Description |
|---|---|
| Component | The catalog component name (e.g., "Engine", "Final Drive LH") |
| Position | The machine position where the component is installed (e.g., "Front Left", "Rear Axle") |
| Target Life | The expected component life in hours before replacement |
| Last Change Out | Date of the most recent maintenance event for this component, or "Not recorded" |
| Percent Life | A progress bar showing component life consumed, color-coded: green (< 75%), yellow (75-89%), orange (90-99%), red (100%+). Shows hours remaining. |
| Projected Days | Estimated days until the component reaches its target life, based on daily utilization |
| Projected Date | The calendar date when the component is projected to need replacement |
| Scheduled Date | A date picker to set or update the planned maintenance date for this component's forecast event |
| Actions | Eye icon to open the component history dialog |
Sorting
All columns except Last Change Out, Scheduled Date, and Actions support sorting. Click a column header to cycle through ascending, descending, and no sort.
Setting a Scheduled Date
If a component has a forecast event, the Scheduled Date column shows a date picker button. Click it to open a calendar popover and select a date. The selected date is saved immediately. If no forecast event exists for the component, the column shows "No forecast".
Component History Dialog
Click the eye icon on any component row to open the Historical View dialog. This shows the complete maintenance and change-out history for that component on this vehicle.
History Table Columns
| Column | Description |
|---|---|
| WO Install | The work order associated with this component installation, linked to the work order detail page |
| WO Removal | The work order when this component was later removed (from the next maintenance event) |
| Change (Frame Hour) | The machine's frame hours at the time of this event |
| Component Life | Hours this component instance ran before being replaced. Shows "Current" for the currently installed component. |
| Root Cause | Editable dropdown: Wear, Damage, Preventive Maintenance, Failure, Upgrade, Other |
| Serial Number | The serial number of this specific component instance |
| Actions | Delete button to remove the maintenance record |
A synthetic Commission record is shown as the first entry (at 0 hours) if no explicit record exists at that point. Commission records cannot be deleted.
Adding a Historical Event
Click Add Event to record a past maintenance or change-out. The form requires:
- Date -- when the event occurred (calendar picker)
- Hours at Event -- the machine's frame hours at that time (required)
- Work Order -- optional; leave blank for auto-generated WOMS reference
- Root Cause -- optional dropdown
- Component Serial -- optional serial number of the component instance
- Notes -- optional free text
Deleting a Record
Click the trash icon on any non-commission row to delete that maintenance record. A confirmation dialog prevents accidental deletions.
Activity Feed
Below the component table, an Activity section shows recent changes to this vehicle from the audit log. This includes updates to vehicle fields, status changes, and other modifications. Entries are displayed in reverse chronological order.
Common Questions
Why is the Component Lifecycle table empty?
The vehicle either has no lifecycle profile assigned, or the assigned profile has no components defined. Assign a profile with components to see lifecycle tracking data.
How is Percent Life calculated?
Percent Life = (hours since last change-out / target hours) x 100. If no change-out has been recorded, hours since commission are used. Components at or above 100% are flagged as overdue (red).
How are Projected Days and Projected Date calculated?
Projected Days = hours remaining / daily utilization. Projected Date = today + projected days. If daily utilization is not set, projections may not be available.
Can I edit the component's target hours from this page?
No. Target hours are defined in the lifecycle profile. Navigate to the profile detail page (click the profile name in the machine header) to modify component target hours.