HF-MES-manual/data_middleground/battery_curve.md

# 电池曲线

## 1. 功能概述

电池曲线属于 MES 系统数据中台的基础追溯模块，用于查询电池在各个工序中的充放电曲线数据，以可视化图表形式展示电压、电流、容量随时间的变化趋势，帮助工艺和品质人员分析电池性能。

**核心功能：**

- 电池工序查询：按电池编码查询该电池经历的所有工序记录
- 曲线图表展示：以多轴折线图/柱状图展示电压、电流、容量变化曲线
- 图表交互操作：支持区域缩放、图表保存为图片等交互功能
- 整盘曲线查看：支持跳转到外部曲线查看器查看整盘托盘的曲线数据
- 数据导出：支持将当前工序的全部曲线数据文件导出为 ZIP 压缩包

**功能对应截图** ：

<div align="center">
    <img style="margin-top:18px;" src="/public/image/data_middleground/battery_curve/电池曲线页面截图.png" alt="电池曲线页面截图">
    <div style="font-size:12px; font-weight:bold;">图1 电池曲线页面</div>
</div>

## 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. 点击左侧某条工序记录，右侧展示对应的充放电曲线图表

**功能对应截图** ：

<div align="center">
    <img style="margin-top:18px;" src="/public/image/data_middleground/battery_curve/电池曲线页面查询展示截图.png" alt="电池曲线页面查询展示截图">
    <div style="font-size:12px; font-weight:bold;">图1 电池曲线页面查询展示</div>
</div>

### 3.3 工序记录列表

查询成功后，左侧以菜单列表形式展示该电池经历的所有工序记录。

**列表字段：**

| 字段 | 说明 |
|------|------|
| 批次名称 | 该电池所属的生产批次 |
| 工序名称 | 该条记录对应的工序名称 |
| 上传时间 | 该工序数据的上传时间 |

**功能对应截图** ：

<div align="center">
    <img style="margin-top:18px;" src="/public/image/data_middleground/battery_curve/电池曲线页面工序列表截图.png" alt="电池曲线页面工序列表截图">
    <div style="font-size:12px; font-weight:bold;">图1 电池曲线页面工序列表</div>
</div>


## 4. 曲线图表展示

### 4.1 图表说明

点击左侧某条工序记录后，右侧展示该工序的充放电曲线图表。图表上方显示该记录的基本信息。

**基本信息：**

| 字段 | 说明 |
|------|------|
| 设备编码 | 执行该工序的设备编码 |
| 电池序号 | 电池在该设备通道中的序号 |

### 4.2 曲线数据说明

曲线图表同时展示三条数据曲线，每条曲线使用独立的纵轴刻度：

| 曲线 | 展示形式 | 纵轴单位 | 说明 |
|------|---------|---------|------|
| 电流曲线 | 折线图，绿色 | mA（毫安） | 左侧第一纵轴，反映充放电电流的变化 |
| 电压曲线 | 折线图，蓝色 | mV（毫伏） | 左侧第二纵轴，反映电池电压的变化 |
| 容量曲线 | 柱状图，橙色 | mAH（毫安时） | 右侧纵轴，反映容量累积过程 |

**功能对应截图** ：

<div align="center">
    <img style="margin-top:18px;" src="/public/image/data_middleground/battery_curve/电池曲线页面曲线数据截图.png" alt="电池曲线页面曲线数据截图">
    <div style="font-size:12px; font-weight:bold;">图1 电池曲线页面曲线数据</div>
</div>


### 4.3 图表交互操作

| 操作 | 说明 |
|------|------|
| 图例切换 | 点击图例可显示/隐藏对应的曲线（容量曲线默认隐藏） |
| 区域缩放 | 在图表上鼠标滚轮缩放或拖拽选择区域放大查看细节 |
| 数据悬停 | 鼠标悬停在曲线上可查看具体数值 |
| 保存图片 | 点击右上角工具箱的保存按钮，将当前图表保存为图片 |

## 5. 整盘托盘曲线

### 5.1 功能说明

除了查看单个电池的曲线数据，还支持查看同一工序中整盘托盘所有电池的曲线数据，通过调用外部曲线查看器程序打开。

### 5.2 操作步骤

1. 在左侧工序列表中，点击选择需要查看的工序记录
2. 点击右侧上方的【查看整盘托盘曲线】按钮
3. 系统调用外部曲线查看器（Curve Viewer），展示整盘托盘的完整曲线数据

**【注意】** 此功能需要本地安装曲线查看器程序。

**功能对应截图** ：

<div align="center">
    <img style="margin-top:18px;" src="/public/image/data_middleground/battery_curve/电池曲线界面查看组曲线截图1.png" alt="电池曲线界面查看组曲线截图1">
    <div style="font-size:12px; font-weight:bold;">图1 电池曲线界面查看组曲线1</div>
</div>

<div align="center">
    <img style="margin-top:18px;" src="/public/image/data_middleground/battery_curve/电池曲线界面查看组曲线截图2.png" alt="电池曲线界面查看组曲线截图2">
    <div style="font-size:12px; font-weight:bold;">图2 电池曲线界面查看组曲线2</div>
</div>


## 6. 数据导出

### 6.1 导出说明

支持将当前选中工序的全部曲线原始数据文件导出为 ZIP 压缩包，包含该工序下所有设备的 `.dat` 和 `.kdat` 数据文件，便于离线分析。

### 6.2 导出操作步骤

1. 在左侧工序列表中，点击选择需要导出数据的工序记录
2. 点击右侧上方的【导出全部数据】按钮
3. 系统自动打包并下载 ZIP 文件

**【注意】** 导出前必须先在左侧列表中选中一条工序记录，否则会提示"请先查询电池信息"。

**功能对应截图** ：

<div align="center">
    <img style="margin-top:18px;" src="/public/image/data_middleground/battery_curve/电池曲线界面导出组曲线数据截图.png" alt="电池曲线界面导出组曲线数据截图">
    <div style="font-size:12px; font-weight:bold;">图1 电池曲线界面导出组曲线数据</div>
</div>