5.0 KiB
GB/T 32960 原生告警进入事件中心
车辆的 0x07 报警单元直接生成安全事件，不需要建立、启用自动化规则，也不主动发送通知。事件中心桌面列表和移动卡片使用具体告警名称作为标题，来源标明“车辆原生告警”；详情逐项显示告警名称，并保留最高报警等级、通用报警标志原值，以及储能装置、驱动电机、发动机、其他四类故障码。厂商故障码保留原值，不推断其含义。
接入使用现有 GB32960 FIELDS Kafka 消费链路，支持网关以 JSON 字符串承载的故障码数组。最高等级 1–3、2016版标准定义的报警位（bit0–18）非零、非空故障码任一项成立即创建事件；等级对应 minor / major / critical，只有位图或故障码时默认 minor。连续活动告警合并为一次告警过程，详情保留首次触发证据。只有完整有效的六个字段都报告无告警时，才自动恢复未处理/处理中的事件。已手动完成或忽略的事件保留处置状态；解除后再次出现告警会创建新事件。
缺失或无效的报警单元不参与开关判断，迟到上报及时间不递增的上报不更新告警状态。VIN 状态行锁负责并发保护，事件、证据、告警状态和 Kafka 数据库消费位点在同一事务提交。查询沿用现有事件中心权限、车辆范围与处置接口。
发布
- 应用
deploy/migrations/047_native_gb32960_alarms.sql，创建原生告警状态和证据表。 - 发布 API、Web 和
alert-stream-evaluator。 - 确认消费者配置
ALERT_STREAM_MODE=active，订阅vehicle.fields.go.gb32960.v1。disabled/shadow 模式不会写事件。 - 用完整告警报文验证事件创建；重复上报不新增；完整无告警报文使事件恢复。检查原始来源 ID、字段和发生时间可追溯。
本次不自动回填历史报文，也不修改运行环境配置。
2026-09-17 生产发布
已发布版本 native-alarms-202609171723，保留上一版 daily-geography-202609101620。迁移 047 成功，API 和流式消费者均 active；沿用原有消费组 vehicle-alert-stream-shadow-v1 及 active 模式，无消费位点重置。
上线前完整 API 模块测试、Web 生产构建、发布脚本测试通过；候选 API 与原版固定历史窗口的事件、里程结果逐项一致。上线后正式 HTTPS 接口确认运行版本；验收时已记录 24 条原生告警，抽查 20 条事件详情的事件类型、来源 ID 和六个告警字段全部通过。消费者观察窗口内 225 批完成、失败 0 次，已出现 2 次自动恢复。当前及三代兼容静态资源检查通过。
发布产物 SHA-256、迁移、候选比较和生产检查记录位于 outputs/native-alarms-202609171723/。仅新增两张数据库表；回滚程序可保留这两张表及已写入的告警证据。
2026-09-17 具体告警解释与历史纠正
版本 native-alarm-details-202609171739 已上线。按 GB/T 32960.3-2016 表18解析 bit0–18，事件名称直接显示“绝缘报警”“SOC低报警”等；多个位或故障码同时发生时，详情列出全部项目。厂商故障码显示故障类别、代码和“厂商定义”，不推断没有字典的含义。仅报告非零等级但没有具体项目时，明确说明车辆未上报具体故障项。
2016版 bit19–31 是预留位：不再单独触发原生事件，也不阻止已解除的标准告警恢复；存在其他有效告警时，预留位置位信息仍在详情及原始证据中保留。新入库证据同时保留存在的 gb32960.header.version。V2025扩展位暂按待匹配定义的扩展位展示，不套用2016版预留位清理规则。
生产核对中，涉及的车辆原始报文使用 V2016。修复时共检查37条原生事件：24条有效记录原位修正名称（23条绝缘报警、1条SOC低报警），保留 ID、发生时间、状态、处置记录和原始证据；13条等级为0、无故障码且仅有预留位的记录删除，并清理其事件动作、证据和活动状态引用。原始车端报文不受影响。完整修改前备份在服务器 /opt/lingniu-vehicle-platform/backups/native-alarms/before-details-202609171739.json，权限0600。
修复命令 cmd/native-alarm-repair 默认只预演；--apply --backup <新文件> 在事务内修复、写审计记录，备份成功落盘后才执行变更。拒绝覆盖备份或自动删除已有通知关联的事件。执行写入时停止流式消费者，随后与新版程序一同启动。
正式HTTPS接口逐项核验25条详情和列表标题通过（包括发布后新建事件），再次预演无需重命名或删除。相关后端测试、修复工具备份/删除边界测试、前端56项测试、生产构建和84个当前/108个兼容静态资源检查通过。发布证据：outputs/native-alarm-details-20260917/。
位定义依据：GB/T 32960.3-2016，表18。