SupervisorAlert (v1.0.0)

Final alert sent to supervisors

The final alert message sent to factory floor supervisors when an alarm rule is triggered. Contains the alarm context, production metrics, and an LLM-generated (or fallback template) message with corrective action guidance.

Key Fields

FieldTypeDescription
alertIdstringUUID for this alert
severityenumWARNING or CRITICAL
messagestringLLM-generated or fallback template message
generatedByenumLLM or FALLBACK_TEMPLATE
rawMetricstringMetric name that triggered the alarm
rawCurrentValuedoubleCurrent metric value
rawThresholddoubleThreshold that was breached
reasonCodestring (nullable)Scrap reason code if applicable

Example

{
"alertId": "alert-20260403-084512-a7f3",
"lineId": "LINE-A",
"factoryId": "FACTORY-01",
"operationArea": "CNC-MACHINING",
"processLine": "CNC-LATHE-01",
"severity": "CRITICAL",
"ruleId": "rule-scrap-rate-critical",
"ruleName": "High Scrap Rate (Critical)",
"message": "CRITICAL: Scrap rate on CNC-LATHE-01 (Line A) has reached 7.7%, exceeding the 5.0% threshold. 11 of 19 scrapped parts are due to DIM_OUT_OF_SPEC. Check CNC tool wear offsets and verify fixture alignment.",
"rawMetric": "SCRAP_RATE",
"rawCurrentValue": 0.0769,
"rawThreshold": 0.05,
"reasonCode": "DIM_OUT_OF_SPEC",
"shiftProduced": 247,
"shiftScrapped": 19,
"shiftReworked": 5,
"shiftTargetPieces": 500,
"hoursRemaining": 4.0,
"generatedBy": "LLM"
}