# 工序工价开发说明

## 一、需求来源

本文档根据桌面需求文件 `工序工价需求文档.docx` 整理，用于指导 JY1.0 工序工价、工时金额和整修补助相关开发。

## 二、需求范围

本需求包含三个目标：

1. 给工序增加 9 个工价相关字段，并支持录入、维护和历史定价查看。
2. 工时统计组件增加工价、金额字段，并在汇总栏展示金额合计。
3. 整修记录模块增加按报备人查询，并增加单时补助、总金额和汇总。

## 三、现有入口

| 功能点 | 现有入口 | 现有接口/过程 |
| --- | --- | --- |
| 工时统计 | `src/views/SeikoWorkshop/WorkingHoursStatistics/index.vue` | `车间生产管理_工人工时统计_查询数据`、`精工车间_员工工时统计_详情_查询数据`、`车间生产管理_设备工时统计_查询数据`、`精工车间_设备工时统计_详情_查询数据` |
| 工艺/工序基础维护 | `src/views/BasicData/WorkshopProcessMaintenance/index.vue` | `工艺名称_查询`、`车间生产管理工艺_基础表_工艺名称_增加数据`、`车间生产管理工艺_基础表_工艺名称_修改名称及简称` |
| 整修记录 | `src/views/DeviceManagement/RepairRecord/index.vue` | `设备管理_整修记录_查询` |

## 四、工序工价维护设计

### 4.1 页面方案

需求原文提到现场希望把 9 个字段加入已有车间查看工艺组件。考虑现有查看工艺组件偏现场查看，字段多且属于价格管理，建议新增独立页面。

建议新增页面：

```text
src/views/SeikoWorkshop/ProcessPrice/index.vue
```

建议新增接口文件：

```text
src/api/ManufacturingCenter/ProcessPrice.js
```

页面结构：

1. 搜索栏：工艺名称、工序名称、零件名称、图号、启用状态。
2. 数据表格：展示工序工价记录。
3. 操作列：新增、编辑、停用、历史定价。
4. 弹窗：维护 9 个工价字段和备注。

### 4.2 字段设计

需求文档未列出 9 个字段的准确名称，开发前需现场补充确认。建议先按以下字段作为设计草案：

| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| 工价流水号 | int | 主键 |
| 工序流水号 | int | 关联工序 |
| 工艺计划流水号 | int | 可选，关联生产任务工艺计划 |
| 工序名称 | nvarchar | 页面显示 |
| 计价方式 | nvarchar | 按件、按时、固定金额 |
| 单件工价 | decimal | 按件计价 |
| 单时工价 | decimal | 按工时计价 |
| 准结工价 | decimal | 准结补偿 |
| 难度系数 | decimal | 价格修正 |
| 质量系数 | decimal | 质量修正 |
| 设备系数 | decimal | 设备修正 |
| 生效日期 | datetime | 价格生效时间 |
| 失效日期 | datetime | 价格失效时间 |
| 是否启用 | int | 1 启用，0 停用 |
| 备注 | nvarchar | 说明 |
| 创建人 | nvarchar | 当前用户 |
| 创建时间 | datetime | 写入时间 |
| 修改人 | nvarchar | 最后修改人 |
| 修改时间 | datetime | 最后修改时间 |

### 4.3 历史定价

新增历史记录表：

```text
车间生产管理工艺_工序工价历史记录
```

历史表记录工价新增、编辑、停用前后的关键数据，支持按工序查看历次定价变化。

## 五、接口设计

新增过程：

| 接口名称 | type | 用途 |
| --- | --- | --- |
| `车间生产管理工艺_工序工价_查询数据` | `11` | 分页查询工序工价 |
| `车间生产管理工艺_工序工价_增加数据` | `12` | 新增工价 |
| `车间生产管理工艺_工序工价_编辑数据` | `12` | 编辑工价 |
| `车间生产管理工艺_工序工价_删除数据` | `12` | 停用或删除 |
| `车间生产管理工艺_工序工价_历史_查询数据` | `11` | 查询历史定价 |

前端继续使用项目统一请求方式：

```js
var Data = this.CreateData('11', '车间生产管理工艺_工序工价_查询数据', param, this.pageSize, this.pageCurrent)
this.ExecDatabase(Data).then(response => {
  this.tableData = response.data.rows
  this.total = response.data.total
})
```

## 六、工时统计金额设计

修改页面：

```text
src/views/SeikoWorkshop/WorkingHoursStatistics/index.vue
```

员工工时统计汇总表新增：

| 字段 | 说明 |
| --- | --- |
| 工价 | 当前统计周期匹配的工价信息 |
| 总金额 | 查询条件下人员金额合计 |

员工工时明细表新增：

| 字段 | 说明 |
| --- | --- |
| 工价 | 当前工序有效工价 |
| 金额 | 按工价规则计算 |

建议后端返回金额，前端只展示和汇总，避免分页和多页面计算规则不一致。

金额规则建议：

| 计价方式 | 金额计算 |
| --- | --- |
| 按件 | `完成数 * 单件工价 * 难度系数 * 质量系数 * 设备系数` |
| 按时 | `加工时长 / 60 * 单时工价 * 难度系数 * 质量系数 * 设备系数` |
| 固定金额 | `固定工价` |

## 七、工时修正设计

需求补充提到工时记录与实际不符时可修改。建议在员工工时明细行增加“修正工时”入口。

新增字段：

| 字段名 | 说明 |
| --- | --- |
| 原加工时长 | 系统扫码原始工时 |
| 调整后工时 | 用于金额结算的工时 |
| 工时调整原因 | 必填 |
| 工时调整人 | 当前用户 |
| 工时调整时间 | 当前时间 |

新增接口：

| 接口名称 | type | 用途 |
| --- | --- | --- |
| `车间生产管理工艺_工时统计_工时修正_编辑数据` | `12` | 修改工时 |
| `车间生产管理工艺_工时统计_工时修正记录_查询数据` | `11` | 查询修正历史 |

## 八、整修记录补助设计

修改页面：

```text
src/views/DeviceManagement/RepairRecord/index.vue
```

搜索栏新增：

| 控件 | 字段 |
| --- | --- |
| `el-input` 或 `el-select` | 报备人 |

表格新增：

| 字段 | 说明 |
| --- | --- |
| 单时补助 | 可编辑，记录每小时补助金额 |
| 总金额 | 自动计算，`工时 * 单时补助` |

规则：

1. 单时补助必须大于等于 0。
2. 总金额不允许手工编辑。
3. 修改单时补助时写入修改记录。
4. 导出 Excel 同步包含单时补助和总金额。

调整现有查询过程：

```text
设备管理_整修记录_查询
```

新增入参：

```text
报备人
```

新增返回字段：

```text
单时补助
总金额
```

新增接口：

| 接口名称 | type | 用途 |
| --- | --- | --- |
| `设备管理_整修记录_单时补助_编辑数据` | `12` | 更新单时补助 |
| `设备管理_整修记录_补助修改记录_查询数据` | `11` | 查询补助修改历史 |

## 九、开发步骤

1. 与现场确认工序工价 9 个字段的准确名称、类型、必填规则。
2. 创建工序工价主表和历史表。
3. 新增工序工价查询、新增、编辑、删除、历史查询过程。
4. 新增 `ProcessPrice` 页面并配置菜单。
5. 改造工时统计查询过程，返回工价、金额、总金额。
6. 修改 `WorkingHoursStatistics` 页面，增加工价、金额展示和汇总。
7. 新增工时修正过程和修正记录查询。
8. 改造整修记录查询过程，支持报备人筛选，返回单时补助和总金额。
9. 修改 `RepairRecord` 页面，增加报备人筛选、补助编辑、金额汇总。
10. 联调导出、分页、汇总和权限控制。

## 十、验收清单

| 验收项 | 预期结果 |
| --- | --- |
| 工序工价新增 | 保存成功，列表可查询 |
| 工序工价编辑 | 修改后历史记录可追溯 |
| 历史定价查询 | 能查看同一工序多次价格变更 |
| 工时统计金额 | 明细金额和汇总金额正确 |
| 工时修正 | 调整后工时参与金额计算，并保留原始工时 |
| 整修记录按报备人查询 | 能按报备人过滤数据 |
| 整修补助编辑 | 单时补助保存成功，总金额自动变化 |
| 整修记录导出 | 导出包含单时补助和总金额 |
| 权限控制 | 未授权用户不能编辑工价、工时和补助 |

## 十一、风险与待确认项

1. 工序工价 9 个字段的具体名称未在需求文档中列明。
2. 工时金额计算需要确认按件、按时还是混合计价。
3. 准结工时是否参与金额计算需要确认。
4. 已有历史工时是否需要补算金额需要确认。
5. 整修补助是否按所有工时计算，还是按有效整修时间计算，需要确认。

修改人:Ld 修改时间:2026-07-02 13:05:56;