# 设备台账新增字段 - 前端联调方案

## 涉及页面

| 页面 | 路由路径 | 说明 |
|------|----------|------|
| 设备台账列表 | `/mes/dv-machinery` | 列表新增筛选条件、表格列 |
| 设备台账表单 | `/mes/dv-machinery` (弹窗) | 新增/编辑表单中增加 3 个字段 |
| 设备台账导入 | 同上（导入弹窗） | Excel 模板新增 3 列 |

---

## 新增字段说明

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `productionEfficiency` | BigDecimal | 否 | 生产效率，单位：每小时生产数量，用于下排产自动计算生产时间 |
| `conveyorBelt` | Integer | 否 | 传送履带数量，例：2 代表双倍效率 |
| `workstationId` | Long | 否 | 工作站编号，用于将设备绑定到指定工作站 |

---

## API

### 已有接口（无需新增）

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/mes/dv/machinery/create` | 创建设备 |
| PUT | `/mes/dv/machinery/update` | 更新设备 |
| GET | `/mes/dv/machinery/get?id={id}` | 获取详情 |
| GET | `/mes/dv/machinery/page` | 分页查询 |
| GET | `/mes/dv/machinery/simple-list` | 精简列表（下拉选项） |
| POST | `/mes/dv/machinery/import` | 导入设备 |
| GET | `/mes/dv/machinery/get-import-template` | 下载导入模板 |

### 请求参数 - 创建/更新（`MesDvMachinerySaveReqVO`）

**新增字段：**

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| productionEfficiency | BigDecimal | 否 | 生产效率（每分钟） |
| conveyorBelt | Integer | 否 | 传送履带数量 |
| workstationId | Long | 否 | 工作站编号 |

### 分页查询参数（`MesDvMachineryPageReqVO`）

**新增筛选字段：**

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| workstationId | Long | 否 | 按工作站筛选 |

### 响应（`MesDvMachineryRespVO`）

**新增字段：**

| 字段 | 类型 | 说明 |
|------|------|------|
| productionEfficiency | BigDecimal | 生产效率 |
| conveyorBelt | Integer | 传送履带 |
| workstationId | Long | 工作站编号 |
| workstationName | String | 工作站名称 |

**响应示例：**

```json
{
  "code": 0,
  "data": {
    "id": 1,
    "name": "CNC 加工中心",
    "code": "EQ-001",
    "productionEfficiency": 10.5,
    "conveyorBelt": 2,
    "workstationId": 300,
    "workstationName": "一号工作站",
    ...
  }
}
```

---

## 前端修改点

### 1. 列表页 - 筛选项

在列表搜索栏新增"工作站"下拉筛选框，调用 `/mes/md-workstation/simple-list` 获取选项。

### 2. 列表页 - 表格列

| 新增列 | 绑定字段 | 说明 |
|--------|----------|------|
| 生产效率 | `productionEfficiency` | 显示数值 |
| 传送履带 | `conveyorBelt` | 显示数值 |
| 工作站 | `workstationName` | 显示工作站名称 |

### 3. 表单页 - 新增/编辑

在表单中新增 3 个字段：

| 字段 | 组件 | 说明 |
|------|------|------|
| 生产效率 | `<el-input-number>` | 支持小数，单位提示"每小时" |
| 传送履带 | `<el-input-number>` | 正整数，提示"2=双倍效率" |
| 工作站 | `<el-select>` | 下拉选择，调用工作站精简列表接口 |

### 4. 导入模板

导入 Excel 模板新增 3 列（可选列）：

| 列名 | 说明 |
|------|------|
| 生产效率(每小时) | 数字，可选 |
| 传送履带 | 整数，可选 |
| 工作站编码 | 工作站编码，可选，填了则校验是否存在 |

---

## 业务规则说明

| 规则 | 说明 |
|------|------|
| 生产效率单位 | 固定为"每小时生产数量"，前端直接展示"每小时" |
| 传送履带含义 | 数值 2 代表双倍效率，排产时 `conveyorBelt × productionEfficiency` 得到最终产能 |
| 工作站绑定 | 一台设备可绑定一个工作站（非强制），下拉数据源为 `/mes/md-workstation/simple-list` |
| 导入时工作站 | 填入工作站编码（非 ID），系统自动转换，编码不存在则导入失败 |

---

## 注意事项

- 3 个新字段均为可选，不影响现有数据
- 生产效率输入建议限制最小值 0，保留 2 位小数
- 传送履带仅允许正整数
- 工作站下拉使用已有接口 `/mes/md-workstation/simple-list`，无需新增
- Excel 导入时工作站列填编码而非 ID
- 导入模板后端接口 `/mes/dv/machinery/get-import-template` 也会返回新列