345 lines
15 KiB
Markdown
345 lines
15 KiB
Markdown
# 预警中心
|
||
|
||
## 1. 功能概述
|
||
|
||
预警中心属于 MES 系统数据中台的监控预警模块，用于实时监控生产设备的通道异常状态，帮助生产管理人员及时发现并处理设备点位问题。系统以设备类别（工作站）为组织维度，分别统计**连续异常**（同一通道连续 3 次及以上报错）和**累计异常**（同一通道累计 10 次及以上报错）两类预警数据，并提供详情查看和异常清除功能。
|
||
|
||
**核心功能：**
|
||
|
||
- 工作站总览：按设备类别（工作站）展示各工作站下的异常设备数量概览，包括连续异常设备数和累计异常设备数
|
||
- 设备异常明细：查看某个工作站下所有异常设备的详细数据，区分连续异常和累计异常两类
|
||
- 通道异常详情：查看每个异常通道的具体错误信息，包括错误代码、错误描述、发生时间
|
||
- 异常清除：支持设备级清除和单通道级清除，分为清零（重置计数）和标记已处理两种方式
|
||
- 条件筛选：按时间范围和具体设备进行筛选，支持导出异常数据
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
## 2. 术语说明
|
||
|
||
| 术语 | 定义 | 说明 |
|
||
|------|------|------|
|
||
| 预警中心 | Alert Center，设备点位异常监控与预警模块 | 实时展示生产设备通道异常状态，帮助快速定位问题设备 |
|
||
| 工作站 | Workstation，即设备类别（Device Category） | 按设备类型分组，如化成、分容、OCV、DCIR 等 |
|
||
| 连续异常 | Consecutive Error，同一通道连续 3 次及以上报错 | 表示该通道近期持续处于异常状态，需重点关注 |
|
||
| 累计异常 | Cumulative Error，同一通道累计 10 次及以上报错 | 表示该通道虽然可能不连续，但总体异常频率较高 |
|
||
| 通道 | Channel，设备上的数据采集点位 | 一个设备通常有多个通道，每个通道独立统计异常次数 |
|
||
| 点位 NG | Pin NG，设备通道上报的异常（不良）信息 | 设备通过 MES 接口上报，包含错误代码和错误描述 |
|
||
| 异常清除 | Clear Error，对异常计数进行清零操作 | 支持整体清除和单通道清除，清除后计数器重新开始统计 |
|
||
| 通道异常记录 | Channel Exception Record，工序中开启的通道异常监控配置 | 在工艺详情中为工序开启后，设备才会触发通道异常检测 |
|
||
|
||
**数据模型关系说明：**
|
||
|
||
```mermaid
|
||
flowchart TB
|
||
subgraph 筛选维度
|
||
DC[设备类别<br/>DeviceCategory]
|
||
DE[设备<br/>Device]
|
||
end
|
||
|
||
subgraph 异常统计
|
||
CES[设备通道异常统计<br/>DeviceChannerlExceptionStatistics]
|
||
end
|
||
|
||
subgraph 异常详情
|
||
PNR[点位NG记录<br/>PinNgRecord]
|
||
NI[不良信息<br/>NgInfo]
|
||
end
|
||
|
||
subgraph 触发来源
|
||
SPR[工序结果上报<br/>SetTrayProcessResult]
|
||
PCQ[点位检查队列<br/>hf_mes_queue_pincheck]
|
||
end
|
||
|
||
DC -->|1:N| DE
|
||
DE -->|1:1| CES
|
||
CES -->|关联查询| PNR
|
||
PNR -->|关联| NI
|
||
SPR -->|触发验证| PCQ
|
||
PCQ -->|异步更新| CES
|
||
```
|
||
|
||
**关系说明：**
|
||
|
||
| 关系类型 | 说明 |
|
||
|---------|------|
|
||
| 设备类别 → 设备 | **1 对 N**：一个设备类别下包含多台设备 |
|
||
| 设备 → 通道异常统计 | **1 对 1**：每台设备对应一条通道异常统计记录 |
|
||
| 通道异常统计 → 点位NG记录 | **1 对 N**：通过设备编码和通道号关联查询异常详情 |
|
||
| 点位NG记录 → 不良信息 | **N 对 1**：每条NG记录关联一个不良代码，获取不良描述 |
|
||
|
||
**简化关系图：**
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
A[设备类别] -->|1:N| B[设备]
|
||
B -->|1:1| C[通道异常统计]
|
||
C -->|关联| D[点位NG记录]
|
||
D -->|关联| E[不良信息]
|
||
```
|
||
|
||
## 3. 预警中心交互流程
|
||
|
||
### 3.1 工作站总览
|
||
|
||
#### 3.1.1 工作站总览说明
|
||
|
||
工作站总览页面以卡片形式展示所有设备类别（工作站），每个卡片显示该工作站名称以及两类异常设备数量：
|
||
- **连续异常设备数**：存在至少一个通道连续异常次数 ≥ 3 次的设备数量
|
||
- **累计异常设备数**：存在至少一个通道累计异常次数 ≥ 10 次的设备数量
|
||
|
||
用户可通过筛选条件按时间范围和具体设备进行过滤。
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
#### 3.1.2 查询条件
|
||
|
||
**查询条件：**
|
||
|
||
| 查询条件 | 说明 |
|
||
|---------|------|
|
||
| 时间范围 | 选择起始时间和结束时间，精确到秒 |
|
||
| 工作站 | 从下拉列表选择设备类别（工作站），如化成、分容、OCV等 |
|
||
| 设备 | 选择工作站后，进一步选择具体设备进行筛选（可选） |
|
||
|
||
**操作步骤：**
|
||
|
||
1. 进入【数据中台】→【预警中心】
|
||
2. 设置时间范围（必选）
|
||
3. 选择工作站（可选，默认展示全部工作站）
|
||
4. 如需查看特定设备，选择工作站后再选择设备
|
||
5. 点击【查询】按钮，系统展示符合条件的预警数据
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
#### 3.1.3 工作站卡片信息
|
||
|
||
每个工作站卡片包含以下信息：
|
||
|
||
| 显示字段 | 说明 |
|
||
|---------|------|
|
||
| 工作站名称 | 设备类别的名称，如"化成"、"分容" |
|
||
| 连续异常设备数 | 该工作站下存在连续异常通道（≥3次）的设备总数，以蓝色角标显示 |
|
||
| 累计异常设备数 | 该工作站下存在累计异常通道（≥10次）的设备总数，以橙色角标显示 |
|
||
| 查看数据 | 当连续异常设备数或累计异常设备数大于 0 时，可点击查看详情 |
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
### 3.2 设备异常明细
|
||
|
||
#### 3.2.1 设备异常明细说明
|
||
|
||
点击工作站卡片上的【查看数据】按钮，会打开全屏对话框，分为左右两栏：
|
||
- **左侧：连续异常列表** — 展示该工作站下存在连续异常的设备
|
||
- **右侧：累计异常列表** — 展示该工作站下存在累计异常的设备
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
#### 3.2.2 连续异常列表
|
||
|
||
连续异常列表展示该工作站下所有存在通道连续异常次数 ≥ 3 次的设备。
|
||
|
||
**列表字段：**
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| 设备名称 | 设备的显示名称 |
|
||
| 设备编码 | 设备的唯一标识代码 |
|
||
| 异常通道数 | 该设备中存在连续异常（≥3次）的通道总数 |
|
||
| 最后清零时间 | 最近一次清除连续异常计数的时间 |
|
||
| 更新时间 | 设备异常统计数据的最后更新时间 |
|
||
| 操作 | 包括【详情】和【清除】两个操作按钮 |
|
||
|
||
**展开行：** 点击行首展开按钮，可查看该设备每个通道的连续异常次数，每个通道以角标形式显示具体数值，支持点击单个通道进行单独清零。
|
||
|
||
#### 3.2.3 累计异常列表
|
||
|
||
累计异常列表展示该工作站下所有存在通道累计异常次数 ≥ 10 次的设备。
|
||
|
||
**列表字段：**
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| 设备名称 | 设备的显示名称 |
|
||
| 设备编码 | 设备的唯一标识代码 |
|
||
| 异常通道数 | 该设备中存在累计异常（≥10次）的通道总数 |
|
||
| 最后清零时间 | 最近一次清除累计异常计数的时间 |
|
||
| 更新时间 | 设备异常统计数据的最后更新时间 |
|
||
| 操作 | 包括【详情】和【清除】两个操作按钮 |
|
||
|
||
**展开行：** 点击行首展开按钮，可查看该设备每个通道的累计异常次数，每个通道以角标形式显示具体数值，支持点击单个通道进行单独清零。
|
||
|
||
### 3.3 通道异常详情
|
||
|
||
#### 3.3.1 通道异常详情说明
|
||
|
||
在连续异常列表或累计异常列表中，点击某个设备行的【详情】按钮，弹出通道异常详情对话框，展示该设备所有异常通道的具体错误信息。
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
#### 3.3.2 通道异常详情字段
|
||
|
||
**详情列表字段：**
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| 设备名称 | 设备的显示名称 |
|
||
| 设备编码 | 设备的唯一标识代码 |
|
||
| 通道编号 | 发生异常的通道号 |
|
||
| 错误代码 | 异常的错误代码 |
|
||
| 错误描述 | 异常的具体描述信息 |
|
||
| 异常时间 | 异常发生的具体时间 |
|
||
|
||
**【注意】** 查看详情时，系统会根据连续异常或累计异常的类型，分别展示对应类型的异常记录。如果该设备在最近一次清零后有新的异常记录，详情中只会展示清零之后产生的异常。
|
||
|
||
### 3.4 异常清除
|
||
|
||
#### 3.4.1 异常清除说明
|
||
|
||
预警中心支持两种粒度的异常清除方式，用户可根据实际情况灵活选择。
|
||
|
||
**清除方式：**
|
||
|
||
| 清除方式 | 说明 | 适用场景 |
|
||
|---------|------|---------|
|
||
| 设备级清除 | 清除该设备的所有异常通道计数 | 设备整体已恢复正常，所有通道问题已解决 |
|
||
| 单通道清除 | 仅清除指定通道的异常计数 | 仅个别通道问题已解决，其他通道仍需关注 |
|
||
|
||
**清除效果：**
|
||
|
||
| 清除类型 | 效果 |
|
||
|---------|------|
|
||
| 连续异常清除 | 将设备的连续异常计数全部重置为零/清空，记录最后清零时间 |
|
||
| 累计异常清除 | 将设备的累计异常计数全部重置为零/清空，记录最后清零时间 |
|
||
|
||
#### 3.4.2 设备级清除
|
||
|
||
**操作步骤：**
|
||
|
||
1. 在设备异常明细页面，找到需要清除的设备行
|
||
2. 点击【清除】按钮
|
||
3. 系统弹出确认对话框，确认后执行清除操作
|
||
4. 清除成功后，页面数据自动刷新，工作站总览同步更新
|
||
|
||
**【注意】** 设备级清除会将该设备所有通道的异常计数一次性清零，请谨慎操作。
|
||
**【重要】** 清除后，相关的点位 NG 记录也会被标记为已处理，便于后续追溯。
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
#### 3.4.3 单通道清除
|
||
|
||
**操作步骤：**
|
||
|
||
1. 在设备异常明细页面，点击设备行的展开按钮，显示各通道的异常次数
|
||
2. 点击需要清除的通道对应按钮
|
||
3. 系统弹出确认对话框，确认后执行单通道清除操作
|
||
4. 清除成功后，页面数据自动刷新
|
||
|
||
**【注意】** 单通道清除仅将该通道的异常计数置为零，不影响其他通道的异常计数。
|
||
**【注意】** 单通道清除不会标记点位 NG 记录为已处理，仅重置计数统计。
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
### 3.5 数据导出
|
||
|
||
#### 3.5.1 数据导出说明
|
||
|
||
系统支持将预警数据通过异步任务导出为文件，适用于大批量数据分析和存档。
|
||
|
||
**操作步骤：**
|
||
|
||
1. 在预警中心页面，设置时间范围和筛选条件
|
||
2. 点击【导出】按钮
|
||
3. 系统弹出确认对话框，确认后创建导出任务
|
||
4. 系统自动跳转到"系统下载任务"页面，可在该页面查看导出进度并下载文件
|
||
|
||
**【注意】** 导出任务采用异步处理机制，大数据量导出可能需要一定时间，请耐心等待。
|
||
**【注意】** 导出前必须选择时间范围和工作站，否则无法导出。
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
## 4. 预警触发机制
|
||
|
||
### 4.1 预警触发流程说明
|
||
|
||
预警中心的数据来源于生产执行过程中设备上报的工序结果数据。当设备调用 MES 接口上报工序结果时，系统会根据工序配置自动进行通道异常检测。
|
||
|
||
**触发流程：**
|
||
|
||
```mermaid
|
||
sequenceDiagram
|
||
participant 设备 as 设备
|
||
participant MES接口 as MES工序上报接口
|
||
participant 验证 as 通道异常验证
|
||
participant 队列 as 预警队列
|
||
participant 统计 as 异常统计表
|
||
|
||
设备->>MES接口: 1. 上报工序结果数据（含pin_check、NG信息）
|
||
MES接口->>MES接口: 2. 检查工序是否开启通道异常记录
|
||
MES接口->>验证: 3. 工序已开启通道异常记录，触发验证
|
||
验证->>验证: 4. 验证pin_check数组的有效性
|
||
验证->>队列: 5. 存在异常（pin_check=1），写入预警队列
|
||
队列->>统计: 6. 异步任务消费队列，更新异常统计数据
|
||
统计->>统计: 7. 累加通道的连续/累计异常计数
|
||
```
|
||
|
||
**流程说明：**
|
||
|
||
| 步骤 | 执行者 | 操作 | 说明 |
|
||
|------|--------|------|------|
|
||
| 1 | 设备 | 上报工序结果 | 设备调用 MES 接口提交工序完成数据，数据中包含 pin_check（点位检查）和 NG（不良代码）信息 |
|
||
| 2 | MES | 检查工序配置 | 判断该工序是否在工艺详情中开启了"通道异常记录"开关 |
|
||
| 3 | MES | 触发验证 | 工序已开启通道异常记录，触发点位检查验证逻辑 |
|
||
| 4 | MES | 验证数据 | 检查 pin_check 数组和 NG 数组的合法性（长度一致、值均为 0 或 1、pin_check=1 时 NG 必填） |
|
||
| 5 | MES | 写入队列 | 当 pin_check 数组中存在值为 1 的条目时，将异常数据写入预警缓存队列 |
|
||
| 6 | 后台任务 | 消费队列 | 异步任务读取预警队列中未处理的数据，按设备编码汇总异常计数 |
|
||
| 7 | 后台任务 | 更新统计 | 将通道异常次数累加到异常统计表，区分连续异常和累计异常 |
|
||
|
||
### 4.2 前置条件
|
||
|
||
预警功能需要以下前置配置：
|
||
|
||
| 前置条件 | 说明 | 配置位置 |
|
||
|---------|------|---------|
|
||
| 开启通道异常记录 | 在工艺详情中为工序开启"开启通道异常记录"开关 | 生产配置 → 工艺模型 → 工艺流程 → 设置工序 |
|
||
| 配置不良代码 | 在系统中维护不良代码及其描述 | 生产配置 → 产品管理 → 不良管理 |
|
||
| 设备品类配置 | 确保设备已绑定到正确的设备类别（工作站） | 设备模型 → 设备信息 |
|
||
|
||
**【重要】** 只有在工艺详情的工序配置中开启了"通道异常记录"，设备上报工序结果时才会触发通道异常检测，预警中心才会展示该工序相关的预警数据。
|
||
|
||
## 5. 常见问题
|
||
|
||
### 5.1 预警中心没有数据？
|
||
|
||
**可能原因：**
|
||
1. 工序未开启"通道异常记录"开关，请在【工艺详情】中检查工序配置
|
||
2. 设备尚未上报包含 pin_check 信息的工序结果数据
|
||
3. 选择的查询时间范围内没有异常数据产生
|
||
4. 设备类别（工作站）未正确配置
|
||
|
||
### 5.2 清除数据后为何又会重新出现？
|
||
|
||
清除操作仅重置异常计数，不会阻止设备继续上报异常数据。如果设备通道问题未从根本解决，设备继续上报异常后，计数会重新累加并再次达到预警阈值。建议：
|
||
- 定位并解决设备通道的根本问题后，再执行清除操作
|
||
- 清除后观察设备状态，确认异常不再复现
|
||
|
||
### 5.3 连续异常和累计异常有什么区别？
|
||
|
||
- **连续异常**：同一通道连续 3 次及以上报错，表示通道近期持续异常，是当前重点关注对象
|
||
- **累计异常**：同一通道累计 10 次及以上报错，表示通道虽然可能不连续但总体异常频率高，反映设备长期健康状态
|
||
|
||
### 5.4 导出数据失败怎么办？
|
||
|
||
导出功能依赖异步任务机制，请检查：
|
||
1. 是否选择了时间范围和工作站
|
||
2. 系统下载任务服务是否正常运行
|
||
3. 可在【系统下载任务】页面查看任务状态和失败原因
|