Alert Types

{
  "id": "alt_hos001",
  "type": "HOS_APPROACHING_DRIVE_LIMIT",
  "category": "HOS_VIOLATION",
  "priority": "HIGH",
  "title": "Driver approaching 11-hour drive limit",
  "message": "Mike Johnson (TRK-4821) has 45 minutes of drive time remaining. Current route segment requires 1.2 hours. Route re-plan recommended.",
  "driverId": "drv_a1b2c3d4",
  "routePlanId": "rte_f8e7d6c5",
  "metadata": {
    "currentHoursDriven": 10.25,
    "driveTimeRemaining": 0.75,
    "nextSegmentDriveTime": 1.2,
    "recommendedAction": "PLAN_REST_STOP"
  }
}

{
  "id": "alt_hos002",
  "type": "HOS_APPROACHING_DUTY_LIMIT",
  "category": "HOS_VIOLATION",
  "priority": "HIGH",
  "title": "Driver approaching 14-hour duty limit",
  "message": "Sarah Chen (TRK-7710) has 50 minutes of on-duty time remaining. A 10-hour off-duty period is required before driving again.",
  "metadata": {
    "currentOnDutyTime": 13.17,
    "dutyTimeRemaining": 0.83,
    "recommendedAction": "PLAN_FULL_REST"
  }
}

{
  "id": "alt_hos003",
  "type": "HOS_BREAK_REQUIRED",
  "category": "HOS_VIOLATION",
  "priority": "MEDIUM",
  "title": "30-minute break required soon",
  "message": "Mike Johnson (TRK-4821) has been driving for 7.5 hours since last break. A 30-minute break must be taken before 8 hours.",
  "metadata": {
    "hoursSinceBreak": 7.5,
    "breakRequiredWithin": 0.5,
    "recommendedAction": "TAKE_30_MIN_BREAK"
  }
}

{
  "id": "alt_hos004",
  "type": "HOS_VIOLATION_ACTIVE",
  "category": "HOS_VIOLATION",
  "priority": "CRITICAL",
  "title": "HOS VIOLATION: Drive time limit exceeded",
  "message": "VIOLATION: Mike Johnson (TRK-4821) has driven 11.3 hours, exceeding the 11-hour limit by 18 minutes. Driver must stop immediately.",
  "metadata": {
    "violationType": "DRIVE_TIME_EXCEEDED",
    "currentHoursDriven": 11.3,
    "exceededBy": 0.3,
    "recommendedAction": "STOP_IMMEDIATELY"
  }
}

{
  "id": "alt_hos005",
  "type": "HOS_CYCLE_APPROACHING",
  "category": "HOS_VIOLATION",
  "priority": "MEDIUM",
  "title": "70-hour cycle limit approaching",
  "message": "Sarah Chen (TRK-7710) has used 66.5 of 70 available cycle hours. A 34-hour restart may be needed soon.",
  "metadata": {
    "currentCycleUsed": 66.5,
    "cycleTimeRemaining": 3.5,
    "recommendedAction": "PLAN_34_HOUR_RESTART"
  }
}

{
  "id": "alt_dev001",
  "type": "ROUTE_DEVIATION_DETECTED",
  "category": "ROUTE_DEVIATION",
  "priority": "MEDIUM",
  "title": "Route deviation detected",
  "message": "Mike Johnson (TRK-4821) has deviated from the planned route on I-65 S near Lebanon, IN. Driver is 3.2 miles off route.",
  "metadata": {
    "deviationDistanceMiles": 3.2,
    "lastKnownLocation": { "lat": 40.0417, "lon": -86.4612 },
    "plannedRouteSegment": "I-65 S toward Indianapolis",
    "durationMinutes": 8,
    "recommendedAction": "CONTACT_DRIVER"
  }
}

{
  "id": "alt_dev002",
  "type": "UNPLANNED_STOP",
  "category": "ROUTE_DEVIATION",
  "priority": "LOW",
  "title": "Unplanned stop detected",
  "message": "Mike Johnson (TRK-4821) has been stopped at an unplanned location near Zionsville, IN for 22 minutes.",
  "metadata": {
    "stopLocation": { "lat": 39.9509, "lon": -86.2619 },
    "stopDurationMinutes": 22,
    "nearestKnownLocation": "Pilot Travel Center - Zionsville",
    "recommendedAction": "MONITOR"
  }
}

{
  "id": "alt_wx001",
  "type": "SEVERE_WEATHER_WARNING",
  "category": "WEATHER",
  "priority": "HIGH",
  "title": "Winter storm warning on route",
  "message": "A winter storm warning is in effect along I-70 between Dayton, OH and Columbus, OH from 18:00 to 06:00 UTC. Expected: 4-6 inches of snow, reduced visibility, icy roads.",
  "metadata": {
    "weatherType": "WINTER_STORM_WARNING",
    "affectedSegments": [5, 6],
    "affectedMiles": 72.4,
    "startTime": "2026-02-10T18:00:00Z",
    "endTime": "2026-02-11T06:00:00Z",
    "source": "NWS",
    "recommendedAction": "CONSIDER_DELAY_OR_REROUTE"
  }
}

{
  "id": "alt_wx002",
  "type": "WEATHER_ADVISORY",
  "category": "WEATHER",
  "priority": "LOW",
  "title": "Wind advisory on route",
  "message": "A wind advisory is in effect along I-65 in central Indiana. Gusts up to 45 mph expected. Use caution with empty or light trailers.",
  "metadata": {
    "weatherType": "WIND_ADVISORY",
    "windSpeedMph": 45,
    "affectedSegments": [2],
    "recommendedAction": "PROCEED_WITH_CAUTION"
  }
}

{
  "id": "alt_mech001",
  "type": "ENGINE_FAULT",
  "category": "MECHANICAL",
  "priority": "HIGH",
  "title": "Engine fault code detected",
  "message": "TRK-4821 reported engine fault code P0087 (fuel rail pressure too low). Driver Mike Johnson should reduce speed and plan to stop for service.",
  "metadata": {
    "faultCode": "P0087",
    "faultDescription": "Fuel rail pressure too low",
    "vehicleId": "veh_e5f6g7h8",
    "severity": "HIGH",
    "recommendedAction": "SERVICE_REQUIRED"
  }
}

{
  "id": "alt_mech002",
  "type": "TIRE_PRESSURE_WARNING",
  "category": "MECHANICAL",
  "priority": "MEDIUM",
  "title": "Low tire pressure detected",
  "message": "TRK-4821 right rear outer tire pressure at 72 PSI (threshold: 95 PSI). Possible slow leak.",
  "metadata": {
    "tirePosition": "RIGHT_REAR_OUTER",
    "currentPressurePsi": 72,
    "thresholdPsi": 95,
    "recommendedAction": "INSPECT_AT_NEXT_STOP"
  }
}

{
  "id": "alt_sched001",
  "type": "LATE_TO_APPOINTMENT",
  "category": "SCHEDULING",
  "priority": "MEDIUM",
  "title": "Late arrival expected at Midwest Auto Parts",
  "message": "Mike Johnson (TRK-4821) is estimated to arrive at Midwest Auto Parts - Indianapolis at 15:45 UTC, 45 minutes after the scheduled 15:00 appointment.",
  "metadata": {
    "stopName": "Midwest Auto Parts - Indianapolis",
    "scheduledArrival": "2026-02-10T15:00:00Z",
    "estimatedArrival": "2026-02-10T15:45:00Z",
    "delayMinutes": 45,
    "cause": "TRAFFIC_DELAY",
    "recommendedAction": "NOTIFY_CUSTOMER"
  }
}

{
  "id": "alt_sched002",
  "type": "DOCK_DELAY",
  "category": "SCHEDULING",
  "priority": "MEDIUM",
  "title": "Dock delay at Midwest Auto Parts",
  "message": "Mike Johnson (TRK-4821) has been at dock for 2.5 hours (estimated: 1.5 hours). The 1-hour delay may impact the next stop's appointment.",
  "metadata": {
    "stopName": "Midwest Auto Parts - Indianapolis",
    "estimatedDockHours": 1.5,
    "actualDockHours": 2.5,
    "delayHours": 1.0,
    "impactsNextStop": true,
    "recommendedAction": "EVALUATE_ROUTE_REPLAN"
  }
}

{
  "id": "alt_sched003",
  "type": "DELIVERY_WINDOW_MISSED",
  "category": "SCHEDULING",
  "priority": "HIGH",
  "title": "Delivery window missed at Central Ohio Distribution",
  "message": "The delivery window for Central Ohio Distribution (21:00 UTC) has passed. Mike Johnson (TRK-4821) is still 48 miles away with an ETA of 22:15 UTC.",
  "metadata": {
    "stopName": "Central Ohio Distribution Center",
    "deliveryWindowEnd": "2026-02-10T21:00:00Z",
    "estimatedArrival": "2026-02-10T22:15:00Z",
    "distanceRemainingMiles": 48,
    "recommendedAction": "CONTACT_CUSTOMER_FOR_RESCHEDULE"
  }
}