James/HF-MES-manual
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs(数据中台): 新增电池曲线、正向追溯、反向追溯、设备履历报表、托盘追溯、鹰眼、电池详情报表、预警中心等模块文档

Browse Source 
新增多个功能模块的详细文档，包括功能概述、术语说明、操作流程和截图等。完善数据中台相关功能文档，覆盖基础追溯、报表分析和监控预警等模块
This commit is contained in:
sheng
2026-05-07 16:14:26 +08:00
parent d43ffb110d
commit 425dea327e
10 changed files with 1786 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

136
data_middleground/battery_curve.md Normal file
View File

@@ -0,0 +1,136 @@
# 电池曲线
## 1. 功能概述
电池曲线属于 MES 系统数据中台的基础追溯模块，用于查询电池在各个工序中的充放电曲线数据，以可视化图表形式展示电压、电流、容量随时间的变化趋势，帮助工艺和品质人员分析电池性能。
**核心功能：**
- 电池工序查询：按电池编码查询该电池经历的所有工序记录
- 曲线图表展示：以多轴折线图/柱状图展示电压、电流、容量变化曲线
- 图表交互操作：支持区域缩放、图表保存为图片等交互功能
- 整盘曲线查看：支持跳转到外部曲线查看器查看整盘托盘的曲线数据
- 数据导出：支持将当前工序的全部曲线数据文件导出为 ZIP 压缩包
**功能对应截图** ：
![图片：电池曲线功能截图](/public/image/battery_curve/图片：电池曲线功能截图.png)
## 2. 术语说明
| 术语 | 定义 | 说明 |
|------|------|------|
| 电池曲线 | Battery Curve，电池在工序中的充放电数据曲线 | 包含电压、电流、容量三条变化曲线 |
| 电池编码 | Battery ID，电池在系统中的唯一标识 | 查询电池曲线数据的入口 |
| 电压曲线 | Voltage Curve，电池两端电压随时间变化的曲线 | 纵轴单位为毫伏（mV） |
| 电流曲线 | Current Curve，电池充放电电流随时间变化的曲线 | 纵轴单位为毫安（mA） |
| 容量曲线 | Capacity Curve，电池充放电容量随时间累积的曲线 | 纵轴单位为毫安时（mAH），以柱状图展示 |
| 托盘曲线 | Tray Curve，同一托盘内所有电池的曲线数据 | 通过外部曲线查看器打开 |
## 3. 电池曲线查询
### 3.1 查询说明
通过输入电池编码，系统查询该电池在所有工序中的充放电记录，以左侧工序列表 + 右侧曲线图表的形式呈现。
**查询条件：**
| 查询条件 | 说明 | 必填 |
|---------|------|------|
| 电池编码 | 输入需要查询曲线的电池编码 | 是 |
### 3.2 查询操作步骤
1. 进入【数据中台】→【基础追溯】→【电池曲线】
2. 在搜索框中输入电池编码
3. 点击【查询】按钮
4. 左侧出现该电池的工序记录列表，每项显示批次名称、工序名称和上传时间
5. 点击左侧某条工序记录，右侧展示对应的充放电曲线图表
**功能对应截图** ：
![图片：电池曲线查询条件截图](/public/image/battery_curve/图片：电池曲线查询条件截图.png)
### 3.3 工序记录列表
查询成功后，左侧以菜单列表形式展示该电池经历的所有工序记录。
**列表字段：**
| 字段 | 说明 |
|------|------|
| 批次名称 | 该电池所属的生产批次 |
| 工序名称 | 该条记录对应的工序名称 |
| 上传时间 | 该工序数据的上传时间 |
**功能对应截图** ：
![图片：电池曲线工序列表截图](/public/image/battery_curve/图片：电池曲线工序列表截图.png)
## 4. 曲线图表展示
### 4.1 图表说明
点击左侧某条工序记录后，右侧展示该工序的充放电曲线图表。图表上方显示该记录的基本信息。
**基本信息：**
| 字段 | 说明 |
|------|------|
| 设备编码 | 执行该工序的设备编码 |
| 电池序号 | 电池在该设备通道中的序号 |
### 4.2 曲线数据说明
曲线图表同时展示三条数据曲线，每条曲线使用独立的纵轴刻度：
| 曲线 | 展示形式 | 纵轴单位 | 说明 |
|------|---------|---------|------|
| 电流曲线 | 折线图，绿色 | mA（毫安） | 左侧第一纵轴，反映充放电电流的变化 |
| 电压曲线 | 折线图，蓝色 | mV（毫伏） | 左侧第二纵轴，反映电池电压的变化 |
| 容量曲线 | 柱状图，橙色 | mAH（毫安时） | 右侧纵轴，反映容量累积过程 |
**功能对应截图** ：
![图片：电池曲线图表截图](/public/image/battery_curve/图片：电池曲线图表截图.png)
### 4.3 图表交互操作
| 操作 | 说明 |
|------|------|
| 图例切换 | 点击图例可显示/隐藏对应的曲线（容量曲线默认隐藏） |
| 区域缩放 | 在图表上鼠标滚轮缩放或拖拽选择区域放大查看细节 |
| 数据悬停 | 鼠标悬停在曲线上可查看具体数值 |
| 保存图片 | 点击右上角工具箱的保存按钮，将当前图表保存为图片 |
## 5. 整盘托盘曲线
### 5.1 功能说明
除了查看单个电池的曲线数据，还支持查看同一工序中整盘托盘所有电池的曲线数据，通过调用外部曲线查看器程序打开。
### 5.2 操作步骤
1. 在左侧工序列表中，点击选择需要查看的工序记录
2. 点击右侧上方的【查看整盘托盘曲线】按钮
3. 系统调用外部曲线查看器（Curve Viewer），展示整盘托盘的完整曲线数据
**【注意】** 此功能需要本地安装曲线查看器程序。
**功能对应截图** ：
![图片：电池曲线整盘查看截图](/public/image/battery_curve/图片：电池曲线整盘查看截图.png)
## 6. 数据导出
### 6.1 导出说明
支持将当前选中工序的全部曲线原始数据文件导出为 ZIP 压缩包，包含该工序下所有设备的 `.dat` 和 `.kdat` 数据文件，便于离线分析。
### 6.2 导出操作步骤
1. 在左侧工序列表中，点击选择需要导出数据的工序记录
2. 点击右侧上方的【导出全部数据】按钮
3. 系统自动打包并下载 ZIP 文件
**【注意】** 导出前必须先在左侧列表中选中一条工序记录，否则会提示"请先查询电池信息"。
**功能对应截图** ：
![图片：电池曲线数据导出截图](/public/image/battery_curve/图片：电池曲线数据导出截图.png)

322
data_middleground/battery_detail_report.md Normal file
View File

@@ -0,0 +1,322 @@
# 电池详情报表
## 1. 功能概述
电池详情报表属于 MES 系统数据中台的报表分析模块，用于按**工艺流程 + 批次 + 工序**的维度查询电池在各工序中的详细结果参数数据。系统根据用户选择的工序，动态生成多级表头，将各工序的设定值参数和实际结果参数以表格形式展示，支持灵活筛选工序结果参数、按工序结束时间过滤，以及大批量数据导出为 CSV 文件。
**核心功能：**
- 工艺流程联动筛选：按工艺流程类别 → 工艺流程 → 批次 → 工序的层级联动选择，快速定位目标数据范围
- 工序参数动态选择：根据选中的工序，动态加载各工序的结果参数树，用户可自由勾选需要展示的参数列
- 多级表头展示：系统根据工序类型（常规工序 / 化成-分容多工步工序）自动生成多级嵌套表头，清晰展示工序 → 工步 → 结果参数的层级关系
- 时间范围过滤：以所选最后一个工序的完成时间作为筛选条件，精准定位时间段内的生产数据
- 数据导出：支持将查询条件下的全量数据通过异步任务导出为 CSV 文件，适用于大批量数据分析
**功能对应截图** ：
![图片：电池详情报表功能截图](/public/image/battery_detail_report/图片：电池详情报表功能截图.png)
## 2. 术语说明
| 术语 | 定义 | 说明 |
|------|------|------|
| 电池详情报表 | Battery Detail Report，按批次和工序维度查询电池结果参数的报表 | 数据中台报表分析模块的核心功能之一 |
| 工艺流程 | Process Flow，定义产品从原材料到成品的完整加工顺序 | 筛选条件的一级维度，按工艺流程类别分组展示 |
| 批次 | Batch，生产计划中的最小执行单元 | 筛选条件的二级维度，一个批次关联一个工艺流程 |
| 工序 | Process，工艺流程中的一个加工环节 | 筛选条件的三级维度，支持多选 |
| 工序参数 | Process Result Param，工序作业完成后记录的实际结果数据 | 如电压、电流、容量、内阻等，用户可选择性展示 |
| 多工步工序 | Multi-Step Process，一个工序内包含多个工步（如化成、分容） | 结果参数会按工步拆分，如电压01、电压02 |
| 单工步结果参数 | 不随工步变化的工序结果参数 | 如进站时间、出站时间、设备编码等 |
| 工序结束时间 | 工序的完成时间（finish_time） | 时间范围的筛选依据，以所选最后一个工序的完成时间为准 |
| 档位/档位类别 | Classification，电池按容量等级划分的档位 | 如 K1、K2、F1 等 |
| 导出任务 | Export Task，异步大数据导出的任务机制 | 在系统顶部"系统下载任务"中查看进度并下载 |
**数据模型关系说明：**
```mermaid
flowchart TB
subgraph 筛选维度
FC[工艺流程类别]
TF[工艺流程]
BA[批次]
PR[工序]
end
subgraph 数据来源
BPL[电池工序聚合日志<br/>hf_mes_bkv_batch_process_log]
BKV[电池结果数据分表<br/>hf_mes_tmp_bkv_subbatch]
end
subgraph 工序相关
WS[工序单元<br/>ProcessWorkingsubclass]
RP[工序结果参数<br/>TechnologyProcessResultParam]
DP[默认结果参数<br/>DefaultResultParam]
PS[工序设定值<br/>setting字段]
end
FC -->|1:N| TF
TF -->|1:N| BA
TF -->|1:N| PR
PR -->|关联| WS
PR -->|拥有| RP
WS -->|预设| DP
PR -->|配置| PS
BA -->|产出| BPL
BPL -->|关联查询| BKV
```
**关系说明：**
| 关系类型 | 说明 |
|---------|------|
| 工艺流程类别 → 工艺流程 | **1 对 N**：一个工艺流程类别包含多个工艺流程 |
| 工艺流程 → 批次 | **1 对 N**：一个工艺流程可被多个批次引用 |
| 工艺流程 → 工序 | **1 对 N**：一个工艺流程包含多个工序 |
| 工序 → 工序单元 | **N 对 1**：每个工序关联一个工序单元 |
| 工序 → 工序结果参数 | **1 对 N**：每个工序可配置多个结果参数 |
| 工序单元 → 默认结果参数 | **1 对 N**：每个工序单元可预设多个默认结果参数 |
| 批次 → 电池工序日志 | **1 对 N**：一个批次下包含多条电池工序日志记录 |
| 电池工序日志 → 电池结果数据 | **1 对 1**：每条日志关联一条电池结果数据（按 subbatch 路由分表） |
**简化关系图：**
```mermaid
flowchart LR
A[工艺流程类别] -->|1:N| B[工艺流程]
B -->|1:N| C[批次]
B -->|1:N| D[工序]
D -->|关联| E[工序单元]
E -->|预设| F[默认结果参数]
C -->|查询| G[电池工序日志]
G -->|关联| H[电池结果数据]
```
## 3. 电池详情报表交互流程
### 3.1 筛选条件设置
#### 3.1.1 筛选条件说明
左侧面板提供层级联动的筛选条件，用户需按"流程 → 批次 → 工序"的顺序逐级选择，系统会根据上一级选择动态加载下一级的选项。
**筛选面板截图** ：
![图片：筛选条件面板截图](/public/image/battery_detail_report/图片：筛选条件面板截图.png)
#### 3.1.2 工艺流程选择
工艺流程按**工艺流程类别**分组展示，便于用户快速定位。
**操作步骤：**
1. 进入【数据中台】→【报表分析】→【电池详情报表】
2. 在左侧【筛选条件】面板的【流程】下拉框中，按工艺流程类别分组浏览
3. 选择目标工艺流程
**字段说明：**
| 字段 | 说明 | 必填 |
|------|------|------|
| 流程 | 按工艺流程类别分组的工艺流程列表，选中后联动加载批次和工序 | 是 |
**【注意】** 切换工艺流程后，已选的批次和工序将被清空，需重新选择。
#### 3.1.3 批次选择
**操作步骤：**
1. 完成工艺流程选择后，【批次】下拉框自动加载该工艺流程下的所有批次
2. 从下拉列表中选择目标批次，支持输入关键字过滤
**字段说明：**
| 字段 | 说明 | 必填 |
|------|------|------|
| 批次 | 所选工艺流程下的生产批次列表 | 是 |
#### 3.1.4 工序选择
**操作步骤：**
1. 完成工艺流程选择后，【工序】下拉框自动加载该工艺流程下的所有工序
2. 支持多选（可勾选多个工序），选中后右侧工序参数树将动态更新
**字段说明：**
| 字段 | 说明 | 必填 |
|------|------|------|
| 工序 | 所选工艺流程下的工序列表，支持多选 | 是（查询时必选） |
**【注意】** NG 判定工序（NG01~NG05）和分选工序（SELECTION）不在筛选列表中显示。
### 3.2 工序参数选择
#### 3.2.1 工序参数说明
工序参数是各工序在作业过程中记录的实际结果数据。系统根据用户在筛选条件中选择的工序，动态加载对应工序的结果参数，以树形结构展示。用户可以自由勾选需要在报表中展示的参数列。
**功能对应截图** ：
![图片：工序参数树截图](/public/image/battery_detail_report/图片：工序参数树截图.png)
#### 3.2.2 工序参数树操作
**操作步骤：**
1. 在筛选条件中勾选目标工序
2. 左侧【工序参数】区域自动加载所选工序的结果参数树
3. 勾选需要展示的参数项，支持父子级联勾选
4. 使用搜索框可按关键字快速定位参数
**字段说明：**
| 字段 | 说明 |
|------|------|
| 工序名称（父节点） | 工序的名称，如"OCV1"、"分容" |
| 结果参数（子节点） | 该工序下的结果参数，如电压、电流、内阻等 |
**【重要】** 如果未勾选任何工序参数，查询时将不显示该工序的结果参数列。
### 3.3 查询结果展示
#### 3.3.1 查询操作步骤
1. 完成筛选条件设置（流程、批次、工序）和工序参数勾选
2. 在右上方面板设置查询条件：
- **工序结束时间**：选择时间范围，系统以所选最后一个工序的完成时间作为过滤条件
- **托盘**：可选，按托盘号精确过滤
3. 点击【查询】按钮
4. 系统生成多级表头并加载数据
**查询条件说明：**
| 查询条件 | 说明 | 必填 |
|---------|------|------|
| 工序结束时间 | 以所选最后一个工序的完成时间（finish_time）作为时间范围条件 | 是 |
| 托盘 | 输入托盘号进行精确过滤 | 否 |
> **工序结束时间规则：**
> - 如果选择了工序，则以所选工序中**最后一个**的完成时间作为过滤条件
> - 如果未选择工序（使用全部工序），则以工艺流程中**最后一个工序**的完成时间作为过滤条件
**功能对应截图** ：
![图片：查询条件与结果截图](/public/image/battery_detail_report/图片：查询条件与结果截图.png)
#### 3.3.2 表格表头结构
表格采用**多级嵌套表头**结构，分为三层：
**第一层 — 工序层：**
以每个工序名称为一级列头，如"OCV1"、"分容"、"DCIR"等。
**第二层 — 工步层（仅化成/分容类工序）：**
对于化成（FORMATION/HC）、分容（FR）、预化成（FORMATION_SS）等多工步工序，在工序下按工步展开二级列头，如"第1工步：搁置"、"第2工步：恒流恒压充电"。
**第三层 — 参数层：**
每个工序（或工步）下的具体结果参数，如电压、电流、容量、内阻等。
**基础信息列（固定显示）：**
| 列名 | 说明 |
|------|------|
| 电池编码 | 电池在系统中的唯一标识 |
| 批次号 | 电池所属的生产批次 |
| 电池型号 | 产品的型号代码 |
| 工艺流程 | 该批次关联的工艺流程名称 |
| 托盘号 | 电池所在托盘的编号 |
| 流水号 | 托盘在批次内的流水编号 |
| 激活状态 | 电池当前状态：激活 / 未激活 |
| 档位类别 | 电池的容量档位分类 |
| 档位 | 电池的具体档位等级（如 K1、K2、F1 等） |
**化成/分容类工序特殊说明：**
化成和分容工序包含多个工步（搁置、恒流恒压充电、恒流恒压放电、恒流放电、恒流充电、循环），每个工步独立记录结果参数。系统会根据工序设定值（setting）中的工步配置自动生成对应的列。
例如，分容工序有 5 个工步，每个工步记录电压（VOL）、电流（CUR）、容量（CAP），则动态生成：
| 第1工步：搁置 | | | 第2工步：恒流恒压充电 | | | ... |
|:---:|:---:|:---:|:---:|:---:|:---:|
| VOL01 | CUR01 | CAP01 | VOL02 | CUR02 | CAP02 | ... |
**单工步结果参数：**
部分结果参数不随工步变化（is_only = 1），如进站时间（START_TIME）、出站时间（FINISH_TIME）、设备编码（DEVICE_CODE），这些参数在工序层级直接展示，不归属到具体工步下。
#### 3.3.3 数据来源说明
查询结果的数据来自以下数据表：
| 数据表 | 说明 |
|-------|------|
| 电池工序聚合日志表 | 记录每个电池在每道工序的完成状态、完成时间、档位等信息 |
| 电池结果数据分表 | 按 subbatch 分表存储电池的详细结果参数值（如电压、电流等） |
| 生产批次表 | 提供批次的工艺流程和产品型号关联信息 |
系统先查询聚合日志表获取电池列表，再根据每条电池的 subbatch 路由到对应的结果数据分表获取各工序参数值。
### 3.4 数据导出
#### 3.4.1 导出说明
系统采用**异步任务导出**机制，先将导出请求创建为后台任务，用户可在系统顶部的"系统下载任务"中查看任务进度并下载生成的文件。导出格式为 CSV。
**功能对应截图** ：
![图片：导出确认截图](/public/image/battery_detail_report/图片：导出确认截图.png)
#### 3.4.2 导出操作步骤
1. 设置好筛选条件（流程、批次、工序、时间范围和工序参数）
2. 点击【导出】按钮
3. 系统弹出确认提示："数据导出需要先创建下载任务，是否继续？"
4. 点击【确定】，系统创建后台导出任务
5. 在系统顶部菜单进入【系统下载任务】，查看任务进度
6. 任务完成后，点击下载获取 CSV 文件
**【注意】** 导出前必须选择批次，否则无法导出。
#### 3.4.3 导出文件格式
导出 CSV 文件的表头同样采用多级结构：
| 层级 | 说明 | 示例 |
|------|------|------|
| 第 1 行（一级标题） | 工序名称 | OCV1, , , 分容, , , , , , |
| 第 2 行（二级标题） | 工步名称（仅多工步工序） | , , , 第1工步：搁置, , , 第2工步：恒流恒压充电 |
| 第 3 行（三级标题） | 具体结果参数名称 | 电池编码, 批次号, ..., 电压, 电流, 电压, 电流 |
**【重要】** 数据量较大的批次，系统会自动将数据拆分为多个 CSV 文件分别生成，最后合并为一个完整的 CSV 文件供下载。
### 3.5 分页浏览
查询结果支持分页浏览，系统默认每页显示 10 条记录。用户可以在表格底部切换页码和每页条数。
**分页操作：**
- 点击页码切换页面
- 修改每页显示条数
- 系统自动重新加载对应页的数据
**【注意】** 切换分页时无需重新点击查询按钮，系统会自动根据当前筛选条件加载对应页码的数据。
---
## 4. 常见问题
### 4.1 为什么选择工艺流程后没有批次可选？
请确认该工艺流程下是否已创建了生产批次。批次需要在【生产批次管理】中创建并与工艺流程关联。
### 4.2 为什么工序参数树为空？
请先在筛选条件中勾选目标工序，工序参数树会根据选中的工序动态加载对应的结果参数。如果已勾选工序但参数树仍为空，请确认该工序是否已在【工艺模型】中配置了结果参数。
### 4.3 为什么化成/分容工序查询报错"设定值为空"？
化成和分容工序需要在【工艺模型】→【工艺详情】中配置工序设定值（工步信息），否则系统无法确定工步数量和类型，报表无法生成。请联系系统管理员配置。
### 4.4 为什么导出的 CSV 文件与页面展示的列不同？
导出时会导出所选工序的**全部结果参数**（不再受页面工序参数树的勾选影响），而页面展示仅显示勾选的参数列。导出以完整数据为准。
### 4.5 导出任务创建后在哪里下载？
在系统顶部菜单栏找到【系统下载任务】，进入后可查看所有导出任务的状态和进度，任务完成后即可下载。

221
data_middleground/battery_traceability.md Normal file
View File

@@ -0,0 +1,221 @@
# 电池追溯
## 1. 功能概述
电池追溯属于 MES 系统数据中台的基础追溯模块，用于根据**电池编码**查询电池的登录批次、所在托盘、激活状态、良品/NG 判定等信息，并可进入电池详情页面查看该电池在各工序中的工艺设定值和结果参数数据。
**核心功能：**
- 电池信息查询：按电池编码查询电池的基本信息和生产状态
- 工艺树形展示：以组织树形图直观展示电池的 BOM 物料组成结构
- 电池详情查看：查看电池在每个工序中的详细工艺数据（设定值和结果参数）
- 组装详情查看：查看电池在当前工序的投料（In）和产出（Out）物料信息
- 取消激活：将已激活的电池取消激活，取消后电池无法继续生产
- 复投激活：将 NG 电池重新激活，使其可从下一工序继续生产
**功能对应截图** ：
![图片：电池追溯功能截图](/public/image/battery_traceability/图片：电池追溯功能截图.png)
## 2. 术语说明
| 术语 | 定义 | 说明 |
|------|------|------|
| 电池追溯 | Battery Traceability，查询电池的生产状态和工序详情 | 从电池编码出发，查看电池在各工序中的完整工艺数据 |
| 电池编码 | Battery ID，电池在系统中的唯一标识 | 查询入口条件 |
| 登录批次 | 电池首次登录到系统的批次号 | 电池所属的原始生产批次 |
| 托盘号 | Tray ID，承载电池的托盘编号 | 电池在产线上流转时所在的托盘 |
| 流水号 | Lot Number，批次内的流水编号 | 托盘在批次内的顺序号 |
| 激活 | Active，电池是否处于可生产状态 | 激活（可生产）/ 停止（不可生产） |
| 良品/NG | 电池的品质判定结果 | GOOD（良品）/ NG（不良品） |
| 等级 | 电池的容量等级 | 如 K1、K2、F1 等 |
| 工序标签 | Process Tab，电池详情中左侧的工序导航按钮列表 | 点击可切换查看不同工序的数据 |
## 3. 电池追溯查询
### 3.1 查询说明
通过输入电池编码，查询电池的基本信息，包括登录批次、所在托盘、流水号、激活状态、良品/NG 判定、等级和当前所在工序。
**查询条件：**
| 查询条件 | 说明 | 必填 |
|---------|------|------|
| 电池编码 | 输入需要追溯的电池编码 | 是 |
**【注意】** 也可以从其他页面通过路由参数携带电池编码跳转到本页面，系统会自动执行查询。
### 3.2 查询操作步骤
1. 进入【数据中台】→【基础追溯】→【电池追溯】
2. 在搜索框中输入电池编码
3. 点击【查询】按钮，系统展示电池信息列表
**功能对应截图** ：
![图片：电池追溯查询条件截图](/public/image/battery_traceability/图片：电池追溯查询条件截图.png)
### 3.3 查询结果字段说明
| 字段 | 说明 |
|------|------|
| 电池编码 | 电池在系统中的唯一标识 |
| 登录批次 | 电池首次登录的生产批次号 |
| 托盘号 | 电池所在托盘的编号 |
| 流水号 | 托盘在批次内的流水编号 |
| 是否激活 | 电池当前状态：激活（绿色标签）或 停止（橙色标签） |
| 良品/NG | 电池品质判定：GOOD（绿色标签）或 NG（橙色标签） |
| 等级 | 电池的容量等级 |
| NG信息 | 不良品的具体不良原因说明 |
| 当前工序编码 | 电池当前所在工序的编码 |
**功能对应截图** ：
![图片：电池追溯结果列表截图](/public/image/battery_traceability/图片：电池追溯结果列表截图.png)
### 3.4 工艺树形展示
查询结果表格的每行支持展开，展开后以组织树形图的形式展示该电池的 BOM 物料组成结构。
**操作步骤：**
1. 在查询结果列表中，点击行首的展开按钮（>）
2. 展开区域展示该电池的 BOM 物料树形结构
3. 点击树中的某个节点，弹出该物料的详细信息
**树节点信息：**
| 信息项 | 说明 |
|-------|------|
| BOM结构名称 | 该物料节点在 BOM 中的名称 |
| BOM结构编码 | 该物料节点在 BOM 中的编码 |
| BOM结构类型 | 物料类型（以绿色标签展示） |
| 物料批次 | 该物料的批次号（如有） |
| 物料投料设备 | 该物料的投料设备编码（如有） |
**功能对应截图** ：
![图片：电池追溯工艺树形截图](/public/image/battery_traceability/图片：电池追溯工艺树形截图.png)
## 4. 电池详情
### 4.1 详情说明
点击操作列的【电池详情】按钮，进入全屏详情页面。页面分为左右两个区域：
- **左侧-工序标签**：显示该电池所经历的全部工序，以按钮形式排列
- **右侧-工序数据**：显示当前选中工序的详细工艺数据
### 4.2 操作步骤
1. 在查询结果列表中，点击目标电池行的【电池详情】按钮
2. 系统进入全屏详情页面，左侧显示工序标签列表
3. 默认自动选中第一个工序标签，右侧展示该工序的数据
4. 点击左侧其他工序标签，可切换查看不同工序的数据
5. 点击页面左上角返回箭头，退出详情页面
**功能对应截图** ：
![图片：电池追溯详情页面截图](/public/image/battery_traceability/图片：电池追溯详情页面截图.png)
### 4.3 工序数据字段说明
工序数据以表格形式展示，包含序号、项目名、内容三列。不同类型的工序展示的数据项目有所差异。
**通用数据项：**
| 项目名 | 说明 |
|-------|------|
| 批次 | 电池所属的生产批次 |
**充放电工序（分容）数据项：**
| 项目名 | 说明 |
|-------|------|
| 通道号 | 电池在设备中的通道编号 |
| 设备编号 | 执行该工序的设备编号 |
| 容量等级 | 电池的容量等级 |
| 档位 | 电池的容量档位 |
| 充电结束电压 | 最后一次恒流恒压充电后的开路电压 |
| 充电容量 | 多次恒流恒压充电结束容量的累加值 |
| 原始放电容量 | 恒流放电的原始容量累加值 |
| 放电容量 | 多次恒流放电结束容量的累加值 |
| 充电开始时间 | 充电工序的开始时间 |
| 充电完了时间 | 充电工序的结束时间 |
| 放电开始时间 | 放电工序的开始时间 |
| 放电完了时间 | 放电工序的结束时间 |
| 定电压充电时间 | 恒压充电累计时长（分钟） |
| 定电流充电时间 | 恒流充电累计时长（分钟） |
| 总放电时间 | 恒流放电累计时长（分钟） |
| 充电开始温度 | 充电开始时的温度（℃） |
| 放电结束温度 | 放电结束时的温度（℃） |
**出荷充放电工序数据项：**
| 项目名 | 说明 |
|-------|------|
| 通道号 | 电池在设备中的通道编号 |
| 设备编号 | 执行该工序的设备编号 |
| 容量等级 | 电池的容量等级 |
| 档位 | 电池的容量档位 |
| 测定后电压 | 充电结束后的电压值 |
| 充电容量 | 恒流充电结束容量的累加值 |
| 充电开始时间 | 充电工序的开始时间 |
| 充电完了时间 | 充电工序的结束时间 |
| 定电压充电时间 | 恒压充电累计时长（分钟） |
| 定电流充电时间 | 恒流充电累计时长（分钟） |
| 充电开始温度 | 充电开始时的温度（℃） |
| 放电结束温度 | 放电结束时的温度（℃） |
**其他常规工序数据项：**
显示该工序在工艺模型中配置的**结果参数**，每个结果参数的名称和实际采集值一一对应展示。当结果参数为"不良"或"不良编码"时，系统会自动将不良编码转换为对应的不良原因说明。
**【注意】** 装盘工序（DENGLU）不展示容量等级和档位信息。
### 4.4 工序数据搜索
在工序数据表格的"项目名"列表头中，点击放大镜图标可展开搜索输入框，输入关键词可快速筛选目标数据项。点击【关闭】按钮收起搜索框。
## 5. 取消激活
### 5.1 功能说明
取消激活用于将已激活的电池设置为停止状态。取消激活后，该电池无法再继续进行生产，需谨慎操作。
### 5.2 操作步骤
1. 在查询结果列表中，找到目标电池行（激活状态为"激活"）
2. 点击操作列的【取消激活】按钮
3. 系统弹出确认对话框，提示"确认后电池将取消，取消激活后电池则无法再继续进行生产"
4. 点击【确定】执行取消激活操作
5. 操作成功后，该电池的激活状态变为"停止"
**【注意】** 只有激活状态为"激活"的电池才显示【取消激活】按钮。
**【注意】** 如果取消激活后该托盘下没有其他激活的电池，托盘也会同步停止激活。
**功能对应截图** ：
![图片：电池追溯取消激活截图](/public/image/battery_traceability/图片：电池追溯取消激活截图.png)
## 6. 复投激活
### 6.1 功能说明
复投激活用于将已停止且判定为 NG 的电池重新激活，使其可从下一工序继续生产。激活后电池只能从下一工序开始，不能重新执行当前工序。
### 6.2 操作步骤
1. 在查询结果列表中，找到目标电池行（激活状态为"停止"且良品/NG 为"NG"）
2. 点击操作列的【复投激活】按钮
3. 系统弹出确认对话框，提示"激活后只能从下一工序开始生产，不能重新做当前工序"
4. 点击【确定】执行复投激活操作
5. 操作成功后，页面自动刷新查询结果
**【注意】** 只有激活状态为"停止"且判定为"NG"的电池才显示【复投激活】按钮。
**功能对应截图** ：
![图片：电池追溯复投激活截图](/public/image/battery_traceability/图片：电池追溯复投激活截图.png)
## 7. 相关功能
| 功能 | 关系 | 说明 |
|------|------|------|
| 电池曲线 | 互补功能 | 电池追溯查看工序的设定值和结果参数，电池曲线查看充放电的曲线数据 |
| 托盘追溯 | 数据关联 | 可通过托盘追溯找到托盘下的电池编码，再跳转到电池追溯查看详情 |
| 生产批次管理 | 数据来源 | 电池的批次信息来源于生产批次管理模块 |
| 电池复投管理 | 功能关联 | 复投激活操作与电池复投管理模块的复投流程相关联 |

168
data_middleground/eagle_eyes.md Normal file
View File

@@ -0,0 +1,168 @@
# 鹰眼
## 1. 功能概述
鹰眼（Hawkeye）属于 MES 系统数据中台的高级分析模块，用于对生产批次中出现的 NG（不良品）与各工序的工艺结果参数进行统计学相关性分析。系统通过皮尔逊相关系数（PCC）和卡方检验（X²）两种统计学方法，自动识别哪些工艺参数与 NG 的产生存在显著关联，帮助工艺工程师快速定位导致不良品的根本原因，为工艺优化提供数据支撑。
**核心功能：**
- NG 关联分析：选择生产批次和 NG 代码，自动分析该 NG 与所有工序结果参数的统计学相关性
- 皮尔逊相关性分析（PCC）：以火山图形式展示相关系数与 p 值，直观区分显著相关与不相关的参数
- 卡方独立性检验（X²）：对分类型数据进行卡方检验，判断 NG 与各参数分布的独立性
**功能对应截图** ：
![图片：鹰眼功能截图](/public/image/eagle_eyes/图片：鹰眼功能截图.png)
## 2. 术语说明
| 术语 | 定义 | 说明 |
|------|------|------|
| 鹰眼 | Hawkeye，MES 系统中的 NG 相关性分析模块 | 属于数据中台的高级分析功能 |
| 生产批次 | Production Batch，一次完整的生产任务批次 | 分析的基本范围，所有分析数据均来自同一批次 |
| NG 代码 | NG Code，不良品分类编码 | 如"荷电保持率不合格"、"容量不合格"等，是分析的目标变量 |
| 工序 | Process，生产过程中的一个作业单元 | 如化成、分容、OCV 等，每个工序有多个结果参数 |
| 皮尔逊相关系数 | Pearson Correlation Coefficient (PCC)，衡量两个连续变量之间线性相关程度的指标 | 取值范围 -1 到 1，正值表示正相关，负值表示负相关，绝对值越大相关性越强 |
| p 值 | P-Value，统计学显著性检验的概率值 | p > 0.05 表示显著相关性 |
| 卡方检验 | Chi-Square Test (X²)，用于检验分类变量之间独立性的统计方法 | 检验 NG 与各参数分类分布是否存在关联 |
| 样本量 | Sample Size，参与分析的有效数据条数 | 样本量越大分析结果越可靠 |
| 相关/不相关 | Correlated/Not Correlated，基于 p 值的相关性判定结论 | p > 0.05 判定为存在显著相关性（蓝色），p ≤ 0.05 判定为无显著相关性（红色） |
| 火山图 | Volcano Plot，以散点图形式展示相关系数与 p 值关系的可视化图表 | X 轴为相关系数，Y 轴为 p 值 |
**相关性判定规则：**
| 判定结果 | p 值条件 | 颜色标识 | 含义 |
|---------|---------|---------|------|
| 存在显著相关性 | p > 0.05 | 蓝色 | NG 与该工艺参数存在统计学上的显著关联 |
| 无显著相关性 | p ≤ 0.05 | 红色 | NG 与该工艺参数之间不存在统计学上的显著关联 |
## 3. 鹰眼分析流程
### 3.1 分析流程说明
鹰眼的分析流程分为三步：选择生产批次 → 选择分析目标（工序 + NG 代码）→ 执行分析并查看结果。
```mermaid
flowchart LR
A[选择生产批次] --> B[选择NG工序]
B --> C[选择NG代码]
C --> D[点击分析]
D --> E[PCC皮尔逊相关性分析]
D --> F[X²卡方检验分析]
E --> G[火山图可视化]
F --> H[检验结果表格]
```
### 3.2 选择生产批次
**操作步骤：**
1. 进入【数据中台】→【鹰眼】
2. 在左侧【分析条件】面板中，从"生产批次"下拉列表选择需要分析的目标批次
3. 系统自动加载该批次的生产工艺信息
**字段说明：**
| 字段 | 说明 | 必填 |
|------|------|------|
| 生产批次 | 选择需要进行 NG 分析的批次号 | 是 |
**功能对应截图** ：
![图片：选择生产批次截图](/public/image/eagle_eyes/图片：选择生产批次截图.png)
### 3.3 选择 NG 工序与 NG 代码
选择批次后，系统会自动加载该批次工艺流程中所有可记录 NG 的工序及其对应的 NG 代码。
**操作步骤：**
1. 选择生产批次后，在"工序"下拉列表中选择需要分析的工序
2. 系统自动加载该工序下所有可记录的 NG 代码
3. 在"NG 代码"下拉列表中选择具体的 NG 类型
**字段说明：**
| 字段 | 说明 | 必填 |
|------|------|------|
| 工序 | 需要分析的工序，如化成、分容、OCV 等 | 是 |
| NG 代码 | 该工序下需要分析的具体 NG 类型，如"荷电保持率不合格"等 | 是 |
**功能对应截图** ：
![图片：选择工序与NG代码截图](/public/image/eagle_eyes/图片：选择工序与NG代码截图.png)
### 3.4 执行分析
选择完毕后，点击【分析】按钮，系统执行以下分析：
1. 从该批次的 BKV 临时数据表中提取 NG 列和目标工序的结果参数数据
2. 对每个连续型结果参数计算皮尔逊相关系数（PCC）及 p 值
3. 对每个分类型结果参数进行卡方独立性检验（X²）
4. 汇总分析结果以图表和表格形式展示
**【注意】** 分析需要一定时间，数据量越大分析时间越长。如果分析区域无 NG 数据，系统会提示"没找到分析表格"。
## 4. 分析结果解读
分析结果分为上下两个区域，分别展示皮尔逊相关性分析（PCC）和卡方检验（X²）的结果。
**功能对应截图** ：
![图片：分析结果总览截图](/public/image/eagle_eyes/图片：分析结果总览截图.png)
### 4.1 皮尔逊相关性分析（PCC）
皮尔逊相关性分析用于检验连续型的工艺结果参数（如电压、电流、温度等）与 NG 发生之间的线性相关程度。
**火山图展示：**
系统以火山图形式展示所有工艺参数与目标 NG 的皮尔逊相关系数（X 轴）和 p 值（Y 轴）。每个点代表一个工艺参数：
- 蓝色点：p > 0.05，该工艺参数与 NG 存在显著相关性
- 红色点：p ≤ 0.05，该工艺参数与 NG 无显著相关性
鼠标悬停在点上可查看该参数的详细信息（参数名称、相关系数、p 值）。
**右侧表格字段：**
| 字段 | 说明 |
|------|------|
| 工艺参数 | 参与分析的工艺结果参数名称，格式为"工序名称.参数名称" |
| 样本量 | 参与计算的有效数据条数 |
| 相关系数 | 皮尔逊相关系数 r 值 |
| p 值 | 显著性检验 p 值 |
| 相关性 | 判定结论，蓝色"显著"或红色"不显著" |
**功能对应截图** ：
![图片：PCC火山图截图](/public/image/eagle_eyes/图片：PCC火山图截图.png)
### 4.2 卡方独立性检验（X²）
卡方检验用于分析分类型结果参数与 NG 发生之间是否存在统计关联。
**表格字段：**
| 字段 | 说明 |
|------|------|
| 工艺参数 | 参与分析的工艺结果参数名称 |
| 样本量 | 参与计算的有效数据条数 |
| 卡方值 | 卡方统计量 X² 值 |
| p 值 | 显著性检验 p 值（支持科学计数法显示） |
| 相关性 | 判定结论，蓝色"显著"或红色"不显著" |
**【提示】** 卡方检验的 p 值列支持科学计数法展示，鼠标悬停在"p 值"表头上可查看说明。
**功能对应截图** ：
![图片：卡方检验结果截图](/public/image/eagle_eyes/图片：卡方检验结果截图.png)
### 4.3 无分析数据提示
如果某些工艺参数列中的数据完全相同或完全不相同（如全部为 0 或全部为同一值），系统无法对该列进行统计学分析，会在分析结果上方折叠面板中列出这些无法分析的参数名称。
## 6. 相关功能
| 功能 | 关系 | 说明 |
|------|------|------|
| 工艺模型 | 上游数据 | 工序单元、预设结果参数在工艺模型中配置，鹰眼分析基于这些参数定义进行 |
| 批次管理 | 上游数据 | 生产批次在批次管理模块中创建，鹰眼从批次中选择分析目标 |
| NG 管理 | 上游数据 | NG 代码类型在系统中统一维护，鹰眼加载可用的 NG 代码供分析选择 |
| 电池追溯 | 下游追溯 | 鹰眼发现显著相关的参数后，可通过电池追溯查看具体电池的工艺数据，进一步验证分析结论 |

130
data_middleground/equipment_history_report.md Normal file
View File

@@ -0,0 +1,130 @@
# 设备履历报表
## 1. 功能概述
设备履历报表属于 MES 系统生产配置模块下的设备模型子模块，用于集中查看和管理所有设备的运行状态历史记录。系统会实时记录每台设备的状态变更（如工作中、异常中、空闲中、离线中等）及其持续时间，形成完整的设备运行履历，为设备管理、故障分析和生产排程提供数据支撑。
**核心功能：**
- 设备状态履历查询：按设备编码、设备类别、设备状态、时间范围等条件查询设备的状态变更记录
- 设备状态追踪：实时反映每台设备的状态变化，包括状态类型、异常代码、状态信息及状态持续时长
- 数据导出：支持将设备履历数据导出为 CSV 文件，通过系统下载任务进行下载
**功能对应截图** ：
![图片：设备履历报表功能截图](/public/image/equipment_history_report/图片：设备履历报表功能截图.png)
## 2. 术语说明
| 术语 | 定义 | 说明 |
|------|------|------|
| 设备履历报表 | Equipment History Report，记录设备状态变更历史的报表 | 属于生产配置→设备模型下的子模块 |
| 设备类别 | Device Category，对设备进行分类管理的单元 | 如SMT、分容、化成、OCV等设备类别 |
| 设备编码 | Device Code，设备在系统中的唯一标识 | 作为查询的筛选条件之一 |
| 设备状态 | Device Status，设备当前所处的运行状态 | 包括工作中、异常中、空闲中、手动中、已完成、离线中等 |
| 异常代码 | Error Code，设备发生异常时对应的错误编码 | 用于快速定位设备故障类型 |
| 设备状态信息 | Device Status Message，设备状态或异常的详细描述信息 | 展示设备当前状态的具体说明 |
| 设备其他信息 | Device Other Info，设备状态相关的补充信息 | 可能包含设备点位、通道等附加数据 |
| 状态时长 | Duration，设备在当前状态下持续的时间 | 单位为秒 |
| 状态解除时间 | Release Time，设备从当前状态解除的时间 | 当设备状态变更时记录新状态并解除旧状态 |
**设备状态说明：**
| 状态 | 英文标识 | 说明 |
|------|---------|------|
| 工作中 | RUN | 设备正在执行生产任务 |
| 异常中 | TROUBLE | 设备发生异常，需要人工介入处理 |
| 已完成 | FINISH | 设备已完成当前生产任务 |
| 空闲中 | IDLE | 设备处于空闲待机状态，等待生产任务 |
| 手动中 | PAUSE | 设备被手动暂停或人工接管操作 |
| 离线中 | OFFLINE | 设备与MES系统断开连接，无法通讯 |
## 3. 设备履历查询
### 3.1 查询条件说明
设备履历报表支持多条件组合查询，可按设备编码、设备类别、设备状态以及时间范围进行筛选。
**查询条件：**
| 查询条件 | 说明 | 必填 |
|---------|------|------|
| 设备编码 | 输入设备编码，精确匹配查询 | 否 |
| 设备类别 | 从下拉列表选择设备类别进行筛选 | 否 |
| 设备状态 | 选择设备状态进行筛选（空闲中/工作中/已完成/异常中/手动中/离线中） | 否 |
| 创建时间 | 选择日期时间范围，筛选状态记录的创建时间 | 否 |
| 状态解除时间 | 选择日期时间范围，筛选状态解除的时间 | 否 |
**【注意】** 所有查询条件均可选填，系统默认展示全部设备的最新状态记录。如需精确查询，建议至少填写一个条件。
**功能对应截图** ：
![图片：设备履历查询条件截图](/public/image/equipment_history_report/图片：设备履历查询条件截图.png)
### 3.2 查询结果字段说明
查询结果以设备状态记录为粒度展示，每条记录表示设备在某个时间段内的状态信息。
| 字段 | 说明 |
|------|------|
| ID | 设备履历记录的唯一标识 |
| 设备类别 | 设备所属的类别名称，如"SMT"、"分容"等 |
| 设备编码 | 设备的唯一标识编码 |
| 设备状态 | 设备当前所处的运行状态 |
| 异常代码 | 设备发生异常时对应的错误编码，正常状态时可能为空 |
| 设备状态信息 | 设备状态或异常的详细描述信息 |
| 设备其他信息 | 设备状态相关的补充数据 |
| 创建时间 | 该状态记录产生的时间 |
| 状态解除时间 | 该状态被解除的时间，即设备切换到新状态的时间 |
| 状态时长(秒) | 设备在该状态下持续的时长，单位为秒 |
**功能对应截图** ：
![图片：设备履历结果列表截图](/public/image/equipment_history_report/图片：设备履历结果列表截图.png)
### 3.3 查询操作步骤
1. 进入【生产配置】→【设备模型】→【设备履历报表】
2. 根据需要填写查询条件（设备编码、设备类别、设备状态、创建时间、状态解除时间）
3. 点击【查询】按钮，系统展示符合条件的设备履历记录
4. 如需清空所有查询条件，点击【重置】按钮
5. 查询结果支持分页浏览，可通过底部分页栏切换页码或调整每页显示条数
## 4. 数据导出
### 4.1 功能说明
设备履历报表支持将查询结果导出为 CSV 文件。导出操作采用异步任务机制——系统先创建导出任务，用户可在系统顶部的【系统下载任务】中查看任务进度并下载生成的文件。
**导出字段说明：**
| 导出字段 | 说明 |
|---------|------|
| 设备类别 | 设备所属的类别名称 |
| 设备名称 | 设备的编码 |
| 设备状态 | 设备所处的运行状态 |
| 异常代码 | 异常发生时对应的错误代码 |
| 设备状态信息 | 状态或异常的详细说明 |
| 设备其他信息 | 设备状态的补充数据 |
| 创建时间 | 状态记录的产生时间 |
| 状态解除时间 | 状态被解除的时间 |
| 状态时长(秒) | 状态持续的时长 |
### 4.2 操作步骤
1. 在设备履历报表页面，根据需要填写查询条件（导出范围与当前查询条件一致）
2. 点击表格上方的【导出】按钮
3. 系统弹出确认提示："数据导出需要先创建下载任务(可在系统顶部系统下载任务中查看下载进度并下载文件)，是否继续？"
4. 点击【确定】，系统创建导出任务
5. 创建成功后，系统提示"创建下载任务成功"并自动跳转到【系统下载任务】页面
6. 在下载任务页面等待任务完成，点击下载即可获取 CSV 文件
**【注意】** 如果当前查询条件范围内没有数据，系统会提示"没有下载数据，无法创建下载任务！"，请调整查询条件后重试。
**功能对应截图** ：
![图片：设备履历导出确认截图](/public/image/equipment_history_report/图片：设备履历导出确认截图.png)
## 5. 相关功能
| 功能 | 关系 | 说明 |
|------|------|------|
| 设备管理 | 上游数据 | 设备的基本信息（编码、类别等）在设备管理模块中维护，设备履历报表展示这些设备的运行状态历史 |
| 设备类别管理 | 上游数据 | 设备类别在设备类别管理模块中定义，用于设备履历报表中的分类筛选 |
| 系统下载任务 | 下游功能 | 设备履历报表的导出任务创建后，在系统下载任务中跟踪进度并下载文件 |

127
data_middleground/positive_direction_traceability.md Normal file
View File

@@ -0,0 +1,127 @@
# 正向追溯
## 1. 功能概述
正向追溯属于 MES 系统数据中台的基础追溯模块，用于根据**物料编码 + 物料批次**或**半成品码**为入口，追踪物料在哪些电池上被使用，以及经过哪些工序和设备，实现从物料到电池的正向追溯链路。
**核心功能：**
- 正向追溯查询：支持按物料编码+物料批次、半成品码查询追溯数据
- 反向追溯跳转：支持从追溯结果中的电池条码直接跳转到反向追溯页面
- 数据导出：支持将追溯结果导出为 CSV 文件
**功能对应截图** ：
![图片：正向追溯功能截图](/public/image/positive_direction_traceability/图片：正向追溯功能截图.png)
## 2. 术语说明
| 术语 | 定义 | 说明 |
|------|------|------|
| 正向追溯 | Positive Direction Traceability，从物料出发追踪其被使用的电池范围 | 与反向追溯（从电池出发追踪物料）互为逆向关系 |
| 物料编码 | Item Code，物料的唯一标识编码 | 系统中的物料主数据编码 |
| 物料批次 | Item Batch，物料的生产批次号 | 同一物料编码 + 批次号唯一确定一批物料 |
| 半成品码 | Semi-finished Product ID，半成品的唯一标识 | 可替代物料编码+物料批次作为追溯入口 |
| 电池条码 | Battery ID，单个电池的唯一标识 | 追溯结果的粒度，表示该物料被用于哪个电池 |
## 3. 正向追溯查询
### 3.1 查询条件说明
正向追溯支持两种查询入口：
- **物料编码 + 物料批次**：通过物料编码和物料批次号精确匹配
- **半成品码**：通过半成品的唯一标识进行匹配
**【注意】** 如果填写了物料编码，则物料批次为必填项，两者需组合使用。
**查询条件：**
| 查询条件 | 说明 | 必填 |
|---------|------|------|
| 物料编码 | 按物料编码精确查询 | 否 |
| 物料批次 | 按物料批次号精确查询 | 当物料编码不为空时必填 |
| 半成品码 | 按半成品码精确查询 | 否 |
**功能对应截图** ：
![图片：正向追溯查询条件截图](/public/image/positive_direction_traceability/图片：正向追溯查询条件截图.png)
### 3.2 查询结果字段说明
查询结果以电池为粒度展示，每条记录表示该物料在某个电池上的使用情况。
| 字段 | 说明 |
|------|------|
| 电池条码 | 使用该物料的电池唯一标识 |
| 生产批次 | 电池所属的生产批次号 |
| 物料名称 | 物料的名称 |
| 物料编码 | 物料的编码 |
| 物料批次 | 物料的批次号 |
| 设备编码 | 加工该电池所用设备的编码 |
| 工序单元 | 加工该电池的工序单元名称 |
| 工序编码 | 工序的编码 |
| 完成时间 | 该工序的完成时间 |
**功能对应截图** ：
![图片：正向追溯结果列表截图](/public/image/positive_direction_traceability/图片：正向追溯结果列表截图.png)
### 3.3 查询操作步骤
1. 进入【数据中台】→【基础追溯】→【正向追溯】
2. 在查询区域输入查询条件：
- **方式一**：输入【物料编码】和【物料批次】
- **方式二**：输入【半成品码】
3. 点击【查询】按钮，系统展示正向追溯结果列表
## 4. 反向追溯跳转
在正向追溯结果列表中，每条电池数据都支持跳转到该电池的反向追溯页面，查看电池从原材料到成品的完整生产过程。
**操作步骤：**
1. 在正向追溯结果列表中，找到目标电池行
2. 点击操作列的【反向追溯】按钮
3. 系统携带电池条码信息，跳转到反向追溯页面
**功能对应截图** ：
![图片：正向追溯跳转反向追溯截图](/public/image/positive_direction_traceability/图片：正向追溯跳转反向追溯截图.png)
## 5. 数据导出
### 5.1 导出说明
正向追溯支持将查询结果导出为 CSV 文件。导出采用异步任务机制，用户创建导出任务后，可在系统顶部的【系统下载任务】中查看进度并下载文件。
**导出字段：**
| 序号 | 导出字段 | 说明 |
|------|---------|------|
| 1 | 电池条码 | 电池唯一标识 |
| 2 | 生产批次 | 电池所属的生产批次号 |
| 3 | 物料名称 | 物料名称 |
| 4 | 物料编码 | 物料编码 |
| 5 | 物料批次 | 物料批次号 |
| 6 | 设备编码 | 设备编码 |
| 7 | 工序单元 | 工序单元名称 |
| 8 | 工序编码 | 工序编码 |
| 9 | 完成时间 | 工序完成时间 |
### 5.2 导出操作步骤
1. 在正向追溯页面，先通过查询条件筛选出需要导出的数据
2. 点击表格上方的【导出】按钮
3. 系统弹出确认对话框，提示"数据导出需要先创建下载任务"
4. 点击【确定】确认创建下载任务
5. 系统提示"创建下载任务成功"，并自动跳转到【系统下载任务】页面
6. 在下载任务页面等待任务完成，点击下载即可获取 CSV 文件
**【注意】** 如果当前没有查询到任何数据，导出时会提示"没有下载数据，无法创建下载任务"。
**功能对应截图** ：
![图片：正向追溯导出确认截图](/public/image/positive_direction_traceability/图片：正向追溯导出确认截图.png)
## 6. 相关功能
| 功能 | 关系 | 说明 |
|------|------|------|
| 反向追溯 | 互为逆向 | 从电池条码出发追踪使用的物料，与正向追溯形成完整的双向追溯链路 |
| 系统下载任务 | 导出依赖 | 正向追溯的导出结果通过系统下载任务统一管理和下载 |

156
data_middleground/reverse_traceability.md Normal file
View File

@@ -0,0 +1,156 @@
# 反向追溯
## 1. 功能概述
反向追溯属于 MES 系统数据中台的基础追溯模块，用于从**电池条码**或**半成品条码**出发，反向追溯该电池所使用的全部原材料信息，以树形关系图谱的形式直观展示从制成品到原材料的完整物料组成链路。
**核心功能：**
- 反向追溯查询：输入电池条码或半成品条码，反向追溯其物料组成
- 关系图谱展示：以横向/纵向树形图谱展示物料之间的层级关系
- 节点定位：支持按物料编码、物料批次、工序单元快速定位图谱中的节点
- 数据导出：支持将追溯树结构导出为 Excel 文件
**功能对应截图** ：
![图片：反向追溯功能截图](/public/image/reverse_direction_traceability/图片：反向追溯功能截图.png)
## 2. 术语说明
| 术语 | 定义 | 说明 |
|------|------|------|
| 反向追溯 | Reverse Direction Traceability，从成品/半成品出发逆向追溯原材料的过程 | 与正向追溯（从原材料追溯成品去向）相对 |
| 关系图谱 | Relation Graph，以节点和连线展示物料父子关系的可视化图形 | 支持横向和纵向两种展示形态 |
| 电池条码 | Battery ID，电池在系统中的唯一标识 | 查询的入口条件 |
| 制成品 | 经过加工后产生的中间品或成品 | 图谱中以绿色节点标识 |
| 原材料 | 用于制造制成品的原始物料 | 图谱中以青色节点标识 |
| 工序单元 | Process Unit，标准化工序模块 | 每个物料节点在加工时关联的工序单元 |
## 3. 反向追溯查询
### 3.1 查询说明
反向追溯通过输入电池条码或半成品条码，系统自动回溯该电池在生产过程中各个工序的投料记录，构建从成品到原材料的完整物料树形关系图。
**查询条件：**
| 查询条件 | 说明 | 必填 |
|---------|------|------|
| 电池条码/半成品条码 | 输入需要追溯的电池或半成品条码 | 是 |
**【注意】** 也可从正向追溯页面点击操作列的【反向追溯】按钮跳转过来，系统会自动带入电池条码并执行查询。
### 3.2 查询操作步骤
1. 进入【数据中台】→【基础追溯】→【反向追溯】
2. 在搜索框中输入电池条码或半成品条码
3. 点击【查询】按钮
4. 系统展示物料关系图谱
**功能对应截图** ：
![图片：反向追溯查询条件截图](/public/image/reverse_direction_traceability/图片：反向追溯查询条件截图.png)
## 4. 关系图谱展示
### 4.1 图谱说明
关系图谱以树形结构展示从制成品到原材料的完整层级关系。每个节点代表一个物料（制成品或原材料），连线代表物料之间的投料组成关系。
**图谱节点信息：**
| 节点信息 | 说明 |
|---------|------|
| 节点标识 | 电池条码/半成品条码 |
| 物料名称 | 原材料的名称 |
| 物料编码 | 物料的唯一标识代码 |
| 物料批次 | 物料的批次号 |
| 工序单元 | 物料所经历工序单元的编码 |
| 工序单元名称 | 工序单元的中文名称 |
| 工序编码 | 物料所经历的具体工序编码 |
| 卸料人 | 该工序的卸料操作人员 |
| 投料时间 | 物料投入的开始时间 |
| 完成时间 | 物料加工完成的时间 |
| 类型标签 | 制成品（绿色标签）或 原材料（青色标签） |
**功能对应截图** ：
![图片：反向追溯图谱节点截图](/public/image/reverse_direction_traceability/图片：反向追溯图谱节点截图.png)
### 4.2 图谱形态切换
图谱支持两种展示形态，可通过页面上方的切换按钮进行切换：
| 图谱形态 | 说明 |
|---------|------|
| 横向图谱 | 节点从左至右展开，适合层级较深的树结构 |
| 纵向图谱 | 节点从上至下展开，适合层级较宽的树结构 |
**操作步骤：**
1. 在关系图谱上部找到图谱形态切换区域
2. 点击【横向图谱】或【纵向图谱】切换按钮
3. 图谱自动按选中形态重新渲染
**功能对应截图** ：
![图片：反向追溯图谱形态切换截图](/public/image/reverse_direction_traceability/图片：反向追溯图谱形态切换截图.png)
### 4.3 节点定位
当图谱中节点较多时，可通过节点定位功能快速定位到目标节点。
**定位方式：**
| 定位方式 | 说明 |
|---------|------|
| 物料编码定位 | 输入物料编码，在图谱中定位并居中显示对应节点 |
| 物料批次定位 | 输入物料批次，在图谱中定位并居中显示对应节点 |
| 工序单元定位 | 输入工序单元编码，定位对应节点 |
**操作步骤：**
1. 在关系图谱左侧操作面板中找到"定位"区域
2. 在对应的定位输入框中输入物料编码 / 物料批次 / 工序单元
3. 点击对应的【定位确认】按钮
4. 图谱自动放大并将对应节点居中显示
**功能对应截图** ：
![图片：反向追溯节点定位截图](/public/image/reverse_direction_traceability/图片：反向追溯节点定位截图.png)
## 5. 数据导出
### 5.1 导出说明
反向追溯支持将当前查询的物料树结构导出为 Excel 文件（.xlsx 格式），便于离线分析和归档。
**导出字段：**
| 序号 | 导出字段 | 说明 |
|------|---------|------|
| 1 | 层级 | 物料在树结构中的层级深度 |
| 2 | 电池条码 | 电池/半成品条码，带缩进表示层级关系 |
| 3 | 物料名称 | 原材料的名称 |
| 4 | 物料编码 | 物料的唯一标识代码 |
| 5 | 物料批次 | 物料的批次号 |
| 6 | 工序单元 | 工序单元编码 |
| 7 | 工序单元名称 | 工序单元的中文名称 |
| 8 | 工序编码 | 工序编码 |
| 9 | 投料时间 | 投料开始时间 |
| 10 | 完成时间 | 投料完成时间 |
| 11 | 类别 | 制成品 或 原材料 |
### 5.2 导出操作步骤
1. 在反向追溯页面，先输入电池条码执行查询
2. 确认图谱数据已加载完成
3. 点击【导出】按钮
4. 系统生成 Excel 文件并自动下载到本地
**【注意】** 导出前必须先执行查询，否则会提示"请输入电池条码"。
**功能对应截图** ：
![图片：反向追溯导出截图](/public/image/reverse_direction_traceability/图片：反向追溯导出截图.png)
## 6. 相关功能
| 功能 | 关系 | 说明 |
|------|------|------|
| 正向追溯 | 互为逆向 | 从物料编码+物料批次出发追踪物料被哪些电池使用，可跳转到反向追溯 |
| 产线管理 | 数据来源 | 工序数据来源于产线的生产投料记录 |

168
data_middleground/tray_traceability.md Normal file
View File

@@ -0,0 +1,168 @@
# 托盘追溯
## 1. 功能概述
托盘追溯属于 MES 系统数据中台的基础追溯模块，用于以**托盘编码**为入口，查询托盘在各生产批次中的流转记录，以及托盘内所有电池的明细信息和工序流转时间线，实现从托盘到电池的完整追溯链路。
**核心功能：**
- 托盘追溯查询：按托盘编码查询该托盘关联的所有生产批次记录
- 电池明细查看：在托盘详情中以抽屉面板展示托盘内全部电池的明细数据
- 工序时间线：以时间线形式展示托盘在各工序间的流转记录
- 取消激活电池：支持在托盘详情中批量取消电池的激活状态
- 追溯跳转：支持从托盘详情中的电池条码直接跳转到电池追溯页面
**功能对应截图** ：
![图片：托盘追溯功能截图](/public/image/tray_traceability/图片：托盘追溯功能截图.png)
## 2. 术语说明
| 术语 | 定义 | 说明 |
|------|------|------|
| 托盘追溯 | Tray Traceability，以托盘为入口追踪其批次流转和电池明细 | 属于数据中台的基础追溯模块 |
| 托盘编码 | Tray ID，托盘在系统中的唯一标识 | 作为追溯查询的入口条件 |
| 登录批次 | 生产批次号，托盘当前关联的生产批次 | 一个托盘可在多个批次中被使用 |
| 流水号 | Lot Number，托盘在批次内的流水号 | 与批次配合使用，区分同批次内不同托盘 |
| 激活状态 | Active Status，标识托盘/电池是否处于激活中 | 激活表示当前可继续生产操作，取消激活后不可操作 |
| 载入电池 | Input Battery Count，该托盘实际装载的电池数量 | 区别于计划载入数量 |
| 工序时间线 | Process Timeline，托盘在各工序间的流转时间记录 | 记录每道工序的开始时间、结束时间和处理设备 |
| 类别/档位 | 电池经过分选工序后确定的等级分类 | 如 A 品、B 品等 |
| 电池条码 | Battery ID，单个电池在系统中的唯一标识 | 可点击跳转到电池追溯页面查看该电池的完整追溯信息 |
## 3. 托盘追溯查询
### 3.1 查询条件说明
托盘追溯以托盘编码作为唯一查询条件，支持精确匹配查询。
**查询条件：**
| 查询条件 | 说明 | 必填 |
|---------|------|------|
| 托盘编码 | 输入需要追溯的托盘编码 | 是 |
**【注意】** 可通过其他页面（如托盘管理页面）携带托盘编码参数跳转至本页面，系统会自动填充编码并执行查询。
**功能对应截图** ：
![图片：托盘追溯查询条件截图](/public/image/tray_traceability/图片：托盘追溯查询条件截图.png)
### 3.2 查询结果字段说明
查询结果以托盘为粒度展示，每条记录表示该托盘在某个生产批次中的流转情况。
| 字段 | 说明 |
|------|------|
| ID | 托盘流转记录的唯一标识 |
| 托盘 | 托盘编码 |
| 登录批次 | 托盘关联的生产批次号 |
| 流水号 | 托盘在该批次内的流水号 |
| 是否激活 | 托盘当前的激活状态（"激活" 或 "停止"） |
| 载入电池 | 该托盘实际载入的电池数量 |
| 登录时间 | 托盘登录至该批次的时间 |
| 取消激活时间 | 托盘被取消激活的时间（若已取消） |
**功能对应截图** ：
![图片：托盘追溯结果列表截图](/public/image/tray_traceability/图片：托盘追溯结果列表截图.png)
### 3.3 查询操作步骤
1. 进入【数据中台】→【基础追溯】→【托盘追溯】
2. 在搜索框中输入托盘编码
3. 点击【查询】按钮，系统展示该托盘关联的所有批次记录
4. 如需清空查询结果，点击【重置】按钮
## 4. 电池明细查看
### 4.1 功能说明
通过托盘追溯查询到目标托盘后，可查看该托盘内所有电池的详细信息。系统以全宽抽屉面板打开，左侧展示工序时间线，右侧展示电池明细表格。
**功能对应截图** ：
![图片：电池明细抽屉面板截图](/public/image/tray_traceability/图片：电池明细抽屉面板截图.png)
### 4.2 电池明细表格字段
| 字段 | 说明 |
|------|------|
| 序号 | 电池在该托盘内的排列序号 |
| 电池条码 | 电池的唯一标识，点击可跳转到电池追溯页面 |
| 生产批次 | 电池所属的生产批次号 |
| 型号 | 电池的产品型号 |
| 工艺流程名称 | 该批次关联的工艺流程名称 |
| 托盘号 | 托盘编码 |
| 流水号 | 托盘在批次内的流水号 |
| 激活状态 | 电池当前的激活状态（"激活" 或 "未激活"） |
| 类别 | 电池的分选类别 |
| 档位 | 电池的分选档位等级 |
**功能对应截图** ：
![图片：电池明细表格截图](/public/image/tray_traceability/图片：电池明细表格截图.png)
### 4.3 工序时间线
在电池明细抽屉的左侧，以时间线形式展示该托盘在各工序间的流转记录，直观反映托盘的生产进度。
**时间线字段：**
| 字段 | 说明 |
|------|------|
| 工序名称 | 该流转记录的工序名称 |
| 开始时间 | 进入该工序的时间 |
| 结束时间 | 离开该工序的时间 |
| 设备编码 | 处理该工序的设备编码 |
**功能对应截图** ：
![图片：工序时间线截图](/public/image/tray_traceability/图片：工序时间线截图.png)
### 4.4 电池条码搜索
在电池明细面板中，支持通过电池条码进行前端过滤，快速定位到目标电池。
**操作步骤：**
1. 打开电池明细抽屉
2. 在电池明细表格上方的搜索框中输入电池条码
3. 系统自动过滤并展示匹配的电池记录
### 4.5 操作步骤
1. 在托盘追溯结果列表中，找到目标托盘行
2. 点击操作列的【电池详情】按钮
3. 系统打开全宽抽屉面板，左侧展示工序时间线，右侧展示电池明细表格
## 5. 取消激活电池
### 5.1 功能说明
在托盘详情中，支持批量选择电池并取消其激活状态。取消激活后，电池将不可再进行生产操作。当托盘内所有电池都被取消激活后，托盘本身也会被级联取消激活。
### 5.2 操作步骤
1. 在电池明细抽屉中，勾选需要取消激活的电池（支持多选）
2. 点击表格上方的【取消激活电池】按钮
3. 系统批量将选中电池的激活状态更新为"未激活"
4. 若该托盘下所有电池均已取消激活，托盘激活状态自动变更为"停止"
**【注意】** 取消激活操作不可撤销，请谨慎操作。
**功能对应截图** ：
![图片：取消激活电池截图](/public/image/tray_traceability/图片：取消激活电池截图.png)
## 6. 追溯跳转
在电池明细面板中，点击任意电池条码可跳转至该电池的电池追溯页面，查看该电池从原材料到成品的完整生产过程。
**操作步骤：**
1. 在电池明细表格中，点击目标电池的电池条码
2. 系统携带电池条码信息，跳转到电池追溯页面
## 7. 相关功能
| 功能 | 关系 | 说明 |
|------|------|------|
| 电池追溯 | 下游追溯 | 从托盘追溯中的电池条码可跳转到电池追溯，查看单个电池的完整生产追溯信息 |
| 正向追溯 | 互补 | 从物料出发追踪被哪些电池使用，与托盘追溯形成"物料→电池→托盘"的追溯链路 |
| 反向追溯 | 互补 | 从电池条码出发追溯物料组成，可与托盘追溯配合定位问题批次 |
| 电池曲线 | 数据关联 | 通过电池追溯查询到电池后，可进一步查看该电池的充放电曲线数据 |
| 托盘管理 | 上游数据 | 托盘的登录、激活等操作在托盘管理模块中完成 |

344
planning_production/alert_center.md Normal file
View File

@@ -0,0 +1,344 @@
# 预警中心
## 1. 功能概述
预警中心属于 MES 系统数据中台的监控预警模块，用于实时监控生产设备的通道异常状态，帮助生产管理人员及时发现并处理设备点位问题。系统以设备类别（工作站）为组织维度，分别统计**连续异常**（同一通道连续 3 次及以上报错）和**累计异常**（同一通道累计 10 次及以上报错）两类预警数据，并提供详情查看和异常清除功能。
**核心功能：**
- 工作站总览：按设备类别（工作站）展示各工作站下的异常设备数量概览，包括连续异常设备数和累计异常设备数
- 设备异常明细：查看某个工作站下所有异常设备的详细数据，区分连续异常和累计异常两类
- 通道异常详情：查看每个异常通道的具体错误信息，包括错误代码、错误描述、发生时间
- 异常清除：支持设备级清除和单通道级清除，分为清零（重置计数）和标记已处理两种方式
- 条件筛选：按时间范围和具体设备进行筛选，支持导出异常数据
**功能对应截图** ：
![图片：预警中心功能截图](/public/image/alert_center/图片：预警中心功能截图.png)
## 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 次的设备数量
用户可通过筛选条件按时间范围和具体设备进行过滤。
**功能对应截图** ：
![图片：工作站总览截图](/public/image/alert_center/图片：工作站总览截图.png)
#### 3.1.2 查询条件
**查询条件：**
| 查询条件 | 说明 |
|---------|------|
| 时间范围 | 选择起始时间和结束时间，精确到秒 |
| 工作站 | 从下拉列表选择设备类别（工作站），如化成、分容、OCV等 |
| 设备 | 选择工作站后，进一步选择具体设备进行筛选（可选） |
**操作步骤：**
1. 进入【数据中台】→【预警中心】
2. 设置时间范围（必选）
3. 选择工作站（可选，默认展示全部工作站）
4. 如需查看特定设备，选择工作站后再选择设备
5. 点击【查询】按钮，系统展示符合条件的预警数据
**功能对应截图** ：
![图片：查询条件截图](/public/image/alert_center/图片：查询条件截图.png)
#### 3.1.3 工作站卡片信息
每个工作站卡片包含以下信息：
| 显示字段 | 说明 |
|---------|------|
| 工作站名称 | 设备类别的名称，如"化成"、"分容" |
| 连续异常设备数 | 该工作站下存在连续异常通道（≥3次）的设备总数，以蓝色角标显示 |
| 累计异常设备数 | 该工作站下存在累计异常通道（≥10次）的设备总数，以橙色角标显示 |
| 查看数据 | 当连续异常设备数或累计异常设备数大于 0 时，可点击查看详情 |
**功能对应截图** ：
![图片：工作站卡片截图](/public/image/alert_center/图片：工作站卡片截图.png)
### 3.2 设备异常明细
#### 3.2.1 设备异常明细说明
点击工作站卡片上的【查看数据】按钮，会打开全屏对话框，分为左右两栏：
- **左侧：连续异常列表** — 展示该工作站下存在连续异常的设备
- **右侧：累计异常列表** — 展示该工作站下存在累计异常的设备
**功能对应截图** ：
![图片：设备异常明细截图](/public/image/alert_center/图片：设备异常明细截图.png)
#### 3.2.2 连续异常列表
连续异常列表展示该工作站下所有存在通道连续异常次数 ≥ 3 次的设备。
**列表字段：**
| 字段 | 说明 |
|------|------|
| 设备名称 | 设备的显示名称 |
| 设备编码 | 设备的唯一标识代码 |
| 异常通道数 | 该设备中存在连续异常（≥3次）的通道总数 |
| 最后清零时间 | 最近一次清除连续异常计数的时间 |
| 更新时间 | 设备异常统计数据的最后更新时间 |
| 操作 | 包括【详情】和【清除】两个操作按钮 |
**展开行：** 点击行首展开按钮，可查看该设备每个通道的连续异常次数，每个通道以角标形式显示具体数值，支持点击单个通道进行单独清零。
#### 3.2.3 累计异常列表
累计异常列表展示该工作站下所有存在通道累计异常次数 ≥ 10 次的设备。
**列表字段：**
| 字段 | 说明 |
|------|------|
| 设备名称 | 设备的显示名称 |
| 设备编码 | 设备的唯一标识代码 |
| 异常通道数 | 该设备中存在累计异常（≥10次）的通道总数 |
| 最后清零时间 | 最近一次清除累计异常计数的时间 |
| 更新时间 | 设备异常统计数据的最后更新时间 |
| 操作 | 包括【详情】和【清除】两个操作按钮 |
**展开行：** 点击行首展开按钮，可查看该设备每个通道的累计异常次数，每个通道以角标形式显示具体数值，支持点击单个通道进行单独清零。
### 3.3 通道异常详情
#### 3.3.1 通道异常详情说明
在连续异常列表或累计异常列表中，点击某个设备行的【详情】按钮，弹出通道异常详情对话框，展示该设备所有异常通道的具体错误信息。
**功能对应截图** ：
![图片：通道异常详情截图](/public/image/alert_center/图片：通道异常详情截图.png)
#### 3.3.2 通道异常详情字段
**详情列表字段：**
| 字段 | 说明 |
|------|------|
| 设备名称 | 设备的显示名称 |
| 设备编码 | 设备的唯一标识代码 |
| 通道编号 | 发生异常的通道号 |
| 错误代码 | 异常的错误代码 |
| 错误描述 | 异常的具体描述信息 |
| 异常时间 | 异常发生的具体时间 |
**【注意】** 查看详情时，系统会根据连续异常或累计异常的类型，分别展示对应类型的异常记录。如果该设备在最近一次清零后有新的异常记录，详情中只会展示清零之后产生的异常。
### 3.4 异常清除
#### 3.4.1 异常清除说明
预警中心支持两种粒度的异常清除方式，用户可根据实际情况灵活选择。
**清除方式：**
| 清除方式 | 说明 | 适用场景 |
|---------|------|---------|
| 设备级清除 | 清除该设备的所有异常通道计数 | 设备整体已恢复正常，所有通道问题已解决 |
| 单通道清除 | 仅清除指定通道的异常计数 | 仅个别通道问题已解决，其他通道仍需关注 |
**清除效果：**
| 清除类型 | 效果 |
|---------|------|
| 连续异常清除 | 将设备的连续异常计数全部重置为零/清空，记录最后清零时间 |
| 累计异常清除 | 将设备的累计异常计数全部重置为零/清空，记录最后清零时间 |
#### 3.4.2 设备级清除
**操作步骤：**
1. 在设备异常明细页面，找到需要清除的设备行
2. 点击【清除】按钮
3. 系统弹出确认对话框，确认后执行清除操作
4. 清除成功后，页面数据自动刷新，工作站总览同步更新
**【注意】** 设备级清除会将该设备所有通道的异常计数一次性清零，请谨慎操作。
**【重要】** 清除后，相关的点位 NG 记录也会被标记为已处理，便于后续追溯。
**功能对应截图** ：
![图片：设备级清除确认截图](/public/image/alert_center/图片：设备级清除确认截图.png)
#### 3.4.3 单通道清除
**操作步骤：**
1. 在设备异常明细页面，点击设备行的展开按钮，显示各通道的异常次数
2. 点击需要清除的通道对应按钮
3. 系统弹出确认对话框，确认后执行单通道清除操作
4. 清除成功后，页面数据自动刷新
**【注意】** 单通道清除仅将该通道的异常计数置为零，不影响其他通道的异常计数。
**【注意】** 单通道清除不会标记点位 NG 记录为已处理，仅重置计数统计。
**功能对应截图** ：
![图片：单通道清除截图](/public/image/alert_center/图片：单通道清除截图.png)
### 3.5 数据导出
#### 3.5.1 数据导出说明
系统支持将预警数据通过异步任务导出为文件，适用于大批量数据分析和存档。
**操作步骤：**
1. 在预警中心页面，设置时间范围和筛选条件
2. 点击【导出】按钮
3. 系统弹出确认对话框，确认后创建导出任务
4. 系统自动跳转到"系统下载任务"页面，可在该页面查看导出进度并下载文件
**【注意】** 导出任务采用异步处理机制，大数据量导出可能需要一定时间，请耐心等待。
**【注意】** 导出前必须选择时间范围和工作站，否则无法导出。
**功能对应截图** ：
![图片：数据导出截图](/public/image/alert_center/图片：数据导出截图.png)
## 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. 可在【系统下载任务】页面查看任务状态和失败原因

28
后台Webman界面截图对照表.md
View File

@@ -13,8 +13,8 @@
| **生产配置 (Production Master Data)** | 工艺模型 (Process Model) | 工艺流程类别 (Process Category) | 工艺流程类别的增删改查 | | √| √ | √ |
| **生产配置 (Production Master Data)** | 工艺模型 (Process Model) | 工序单元 (Process Step) | 配置工序单元（节点），支持参数预设 | | √ | √| √ |
| **生产配置 (Production Master Data)** | 工艺模型 (Process Model) | 工艺流程 (Process Routing) | 设置生产工艺流程并管理流程卡 | | √ | √ | √|
| **生产配置 (Production Master Data)** | 产品管理 (Product Management) | 产品列表 (Product List) | 产品管理（增删改查） | | √ | √ | |
| **生产配置 (Production Master Data)** | 产品管理 (Product Management) | 不良管理 (Defect Management) | 不良代码及描述管理，支持批量导入 | | √ | √ | |
| **生产配置 (Production Master Data)** | 产品管理 (Product Management) | 产品列表 (Product List) | 产品管理（增删改查） | | √ | √ | √ |
| **生产配置 (Production Master Data)** | 产品管理 (Product Management) | 不良管理 (Defect Management) | 不良代码及描述管理，支持批量导入 | | √ | √ | √ |
| **生产配置 (Production Master Data)** | 物料模型 (Material Model) | 物料类别列表 (Material Category) | 区分原材料和半成品 | | √ | √| √ |
| **生产配置 (Production Master Data)** | 物料模型 (Material Model) | 物料信息管理 (Material Master) | 维护物料编码、名称、规格等属性 | | √ | √ | √|
| **生产配置 (Production Master Data)** | 物料模型 (Material Model) | BOM物料清单 (Bill of Materials) | 产品BOM管理 | | √ | √ | √|
@@ -40,7 +40,7 @@
| 计划与生产 (Planning & Production) | 生产批次管理 (Batch Management) | 批次列表 (Batch List) | 批次管理 | | √ | √ | |
| 计划与生产 (Planning & Production) | 生产批次管理 (Batch Management) | 批次托盘 (Tray Tracking) | 托盘跟踪与操作 | | √ |√ | |
| 计划与生产 (Planning & Production) | 生产批次管理 (Batch Management) | 生产批次不良报表 (Batch Defect Report) | 不良报表 | | √ | √ | |
| 计划与生产 (Planning & Production) | 预警中心 (Alert Center) | 预警中心 (Alert Center) | 预警中心 | | | | |
| 计划与生产 (Planning & Production) | 预警中心 (Alert Center) | 预警中心 (Alert Center) | 预警中心 | | √ | | |
| 计划与生产 (Planning & Production) | 生产监控 (Production Monitoring) | 物料监控 (Material Monitoring) | 物料监控 | | √ | √ | |
| 计划与生产 (Planning & Production) | 生产监控 (Production Monitoring) | 电池复投管理 (Rework Management) | 返工管理 | | √ | √ | |
| 计划与生产 (Planning & Production) | 生产监控 (Production Monitoring) | 托盘管理 (Tray Management) | 托盘管理 | | √ | √ | |
@@ -69,15 +69,15 @@
| 质量管理 (Quality Management) | SPC计量型报表 (SPC Variable Charts) | MAMS (Moving Average S Chart) | | | | | |
| 质量管理 (Quality Management) | SPC计量型报表 (SPC Variable Charts) | CPK (Process Capability Index) | | | | | |
| 质量管理 (Quality Management) | SPC计数型报表 (SPC Attribute Charts) | DPMO (DPMO) | | | | | |
| 质量管理 (Quality Management) | SPC计数型报表 (SPC Attribute Charts) | PChart (P Chart) | | | | | |
| 质量管理 (Quality Management) | SPC计数型报表 (SPC Attribute Charts) | PChart (P Chart) | | | | |
| 质量管理 (Quality Management) | SPC计数型报表 (SPC Attribute Charts) | NPChart (NP Chart) | | | | | |
| 质量管理 (Quality Management) | SPC计数型报表 (SPC Attribute Charts) | CChart (C Chart) | | | | | |
| 质量管理 (Quality Management) | SPC计数型报表 (SPC Attribute Charts) | UChart (U Chart) | | | | | |
| 数据中台 (Data Platform) | 基础追溯 (Traceability) | 反向追溯 (Backward Traceability) | | | | | |
| 数据中台 (Data Platform) | 基础追溯 (Traceability) | 正向追溯 (Forward Traceability) | | | | | |
| 数据中台 (Data Platform) | 基础追溯 (Traceability) | 电池曲线 (Battery Curve) | | | | | |
| 数据中台 (Data Platform) | 基础追溯 (Traceability) | 托盘追溯 (Tray Traceability) | | | | | |
| 数据中台 (Data Platform) | 基础追溯 (Traceability) | 电池追溯 (Battery Traceability) | | | | | |
| 数据中台 (Data Platform) | 生产报表 (Production Reports) | 设备履历报表 (Equipment History Report) | | | | | |
| 数据中台 (Data Platform) | 生产报表 (Production Reports) | 电池详情报表 (Battery Detail Report) | | | | | |
| 数据中台 (Data Platform) | 相关性分析 (Correlation Analysis) | 鹰眼 (Hawkeye) | | | | | |
| 质量管理 (Quality Management) | SPC计数型报表 (SPC Attribute Charts) | CChart (C Chart) | | | | |
| 质量管理 (Quality Management) | SPC计数型报表 (SPC Attribute Charts) | UChart (U Chart) | | | | |
| 数据中台 (Data Platform) | 基础追溯 (Traceability) | 反向追溯 (Backward Traceability) | | |√ | |
| 数据中台 (Data Platform) | 基础追溯 (Traceability) | 正向追溯 (Forward Traceability) | | |√ | |
| 数据中台 (Data Platform) | 基础追溯 (Traceability) | 电池曲线 (Battery Curve) | | | √| | |
| 数据中台 (Data Platform) | 基础追溯 (Traceability) | 托盘追溯 (Tray Traceability) | | | √ | | |
| 数据中台 (Data Platform) | 基础追溯 (Traceability) | 电池追溯 (Battery Traceability) | | | √ | | |
| 数据中台 (Data Platform) | 生产报表 (Production Reports) | 设备履历报表 (Equipment History Report) | | | √ | | |
| 数据中台 (Data Platform) | 生产报表 (Production Reports) | 电池详情报表 (Battery Detail Report) | | | √ | | |
| 数据中台 (Data Platform) | 相关性分析 (Correlation Analysis) | 鹰眼 (Hawkeye) | | | √| | |