User Documentation

Complete guide to the Predictive Maintenance Dashboard

Advanced Features

Clickable KPI Cards

All seven header KPI cards are interactive filters. Clicking a card instantly filters the alarm table to show only relevant items:

  • Active Alarms → Critical + Unacknowledged
  • Devices Online → Offline devices
  • Action Queue → Assigned + Actioned items
  • Fleet Health → Escalating alarms
  • Data Quality → Stale data alarms
  • Unassigned Critical → Critical alarms without owners
  • Overdue Actions → Assigned/Actioned items past due time

Click the same card again to clear the filter and return to the full alarm list.

Priority Sorting

The alarm table uses intelligent priority sorting that considers multiple factors:

  1. Critical severity — Critical alarms sort above warnings
  2. Unacknowledged state — Unacknowledged alarms sort above acknowledged
  3. Unassigned owner — Unassigned alarms sort above assigned
  4. Longest persistence — Older alarms sort above newer

The top 3 alarms meeting all criteria (Critical + Unacknowledged + Unassigned) are automatically pinned to the top with a visual separator.

Action History Audit Trail

Every alarm maintains a complete audit trail of all actions taken. The Action History section in the context panel displays:

  • Timestamp — When the action occurred
  • Actor — Who performed the action (operator name)
  • Action — What was done (Acknowledged, Assigned to X, Marked as Actioned, Resolved, Escalated)
  • Notes — Any additional details provided

This provides full accountability and traceability for compliance and post-incident analysis.

Resolution Workflow

The context panel displays state-aware action buttons based on the current lifecycle state:

Current StateAvailable Actions
NEW / UNACKNOWLEDGEDAcknowledge Alarm, Assign to Operator, Escalate to Supervisor
ACKNOWLEDGEDMark as Actioned, Assign to Operator, Escalate to Supervisor
ASSIGNEDMark as Actioned, Escalate to Supervisor
ACTIONEDResolve & Close Loop
RESOLVED(No actions available)

The Resolve & Close Loop button opens a resolution form prompting for:

  • Resolution Reason — Dropdown with predefined options
  • Notes — Free-text field for additional details
  • Follow-up Task — Optional task description

All actions are recorded in the action history audit trail.

Mobile Bottom Sheet

On mobile devices (smartphones and tablets), tapping an alarm row opens a full-screen bottom sheet instead of a side panel. The bottom sheet provides the same comprehensive context information available on desktop:

  • Operational Status (lifecycle state, owner, next action)
  • Why Flagged (pattern detection and narrative)
  • Sensor Readings (current value, thresholds, delta, trend)
  • Action History (complete audit trail)
  • Resolve Workflow (state-aware action buttons)

Swipe down or tap the X button to close the bottom sheet.