# 工序工价与生产任务审核开发说明

## 一、需求来源

本文档根据桌面需求文件 `工序工价需求文档.docx`、`生产任务审核.docx` 整理，用于指导 JY1.0 前端、接口和数据库开发。

## 二、需求范围

本次需求分为两组功能：

1. 工序工价与工时金额：新增工序定价录入、工时统计金额显示、整修记录补助金额。
2. 生产任务审核：车间工况机完成数量提报或异常报备后，先生成计划员审核单，审核通过后进入原系统后续流程。

## 三、现状入口

| 功能点 | 现有入口 | 现有接口/过程 |
| --- | --- | --- |
| 工时统计 | `src/views/SeikoWorkshop/WorkingHoursStatistics/index.vue` | `车间生产管理_工人工时统计_查询数据`、`精工车间_员工工时统计_详情_查询数据`、`车间生产管理_设备工时统计_查询数据`、`精工车间_设备工时统计_详情_查询数据` |
| 工艺/工序基础维护 | `src/views/BasicData/WorkshopProcessMaintenance/index.vue` | `工艺名称_查询`、`车间生产管理工艺_基础表_工艺名称_增加数据`、`车间生产管理工艺_基础表_工艺名称_修改名称及简称` |
| 生产任务查询 | `src/views/SeikoWorkshop/ProductionTaskQuery/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. 操作：查询、新增、编辑、删除、查看历史定价。

建议字段：

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

> 需求原文提到“9 个字段数据”，实际字段名称需要现场确认。上表先按定价业务补全为可落库方案，开发前应与业务确认 9 个必填字段。

### 4.2 工序历史定价

新增历史查询能力，用于查看工序价格变更轨迹。

建议数据表：

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

记录内容：

| 字段名 | 说明 |
| --- | --- |
| 历史流水号 | 主键 |
| 工价流水号 | 对应当前工价记录 |
| 工序流水号 | 对应工序 |
| 修改前数据 | 可按字段拆列或保存摘要 |
| 修改后数据 | 可按字段拆列或保存摘要 |
| 操作类型 | 新增、编辑、停用 |
| 操作者 | 当前用户 |
| 操作时间 | 当前时间 |

### 4.3 接口设计

新增过程建议：

| 接口名称 | 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
})
```

## 五、工时统计金额功能设计

### 5.1 页面改造

修改页面：

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

员工工时统计左侧汇总表增加：

| 新增列 | 说明 |
| --- | --- |
| 工价 | 按所选人员统计周期内匹配工序工价后的平均或汇总工价 |
| 总金额 | 汇总加工金额 |

员工工时明细表增加：

| 新增列 | 说明 |
| --- | --- |
| 工价 | 当前工序匹配的有效工价 |
| 金额 | 按 `完成数`、`加工时长` 和计价方式计算 |

设备工时统计如业务需要同步增加金额列，字段逻辑与员工工时一致，但汇总维度为设备。

### 5.2 汇总规则

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

计价规则：

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

表格最后一栏金额汇总可使用 Element UI `show-summary`，也可由后端返回汇总行。为保证分页情况下金额准确，建议后端返回总金额字段，前端展示分页明细和总计。

### 5.3 工时修正

需求中提到“工时记录与现实不同时可以修改”。建议新增明细行编辑入口，仅允许有权限人员调整。

新增字段：

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

新增接口：

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

## 六、整修记录补助金额功能设计

### 6.1 页面改造

修改页面：

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

搜索栏新增：

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

表格新增：

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

页面新增汇总：

1. 当前查询条件下的整修工时合计。
2. 当前查询条件下的补助金额合计。

### 6.2 编辑规则

1. `单时补助` 必须大于等于 0。
2. `总金额` 不允许手工编辑，由后端或前端按工时自动计算。
3. 修改单时补助后写入操作日志。
4. 导出 Excel 时同步输出 `单时补助` 和 `总金额`。

### 6.3 接口设计

调整现有查询过程：

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

新增入参：

```text
报备人
```

新增返回字段：

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

新增编辑过程：

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

## 七、生产任务审核功能设计

### 7.1 业务流程

车间工况机端提报加工完成或异常报备时，先生成审核单。计划员审核通过后，再进入原有后续流程。

经现场讨论，取消“不通过打回”功能。如数据不准确，由审核员在审核页面直接修改完成数量、完成时间、异常信息等数据后审核通过。

```mermaid
flowchart TD
  A["工况机提报完成数量或异常报备"] --> B["生成生产任务审核单"]
  B --> C["计划员进入审核页面"]
  C --> D{"数据是否准确"}
  D -- "准确" --> E["审核通过"]
  D -- "不准确" --> F["审核员修改完成数量/完成时间/异常信息"]
  F --> E
  E --> G["写入原生产任务后续流程"]
  G --> H["刷新生产任务/工时/追溯数据"]
```

### 7.2 新增审核页面

建议新增页面：

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

页面结构：

1. 搜索栏：提交时间、订单号、零件名称、图号、操作者、审核状态。
2. 表格：待审核/已审核任务。
3. 操作：查看、编辑、审核通过。

表格字段：

| 字段名 | 说明 |
| --- | --- |
| 审核流水号 | 主键 |
| 来源类型 | 完工提报、异常报备 |
| 工艺计划流水号 | 关联生产任务 |
| 工序流水号 | 关联工序 |
| 订单号 | 显示 |
| 零件名称 | 显示 |
| 图号 | 显示 |
| 工序 | 显示 |
| 提报完成数量 | 工况机提报数量 |
| 审核完成数量 | 审核员可修改 |
| 提报完成时间 | 工况机提报时间 |
| 审核完成时间 | 审核员可修改 |
| 异常类型 | 异常报备使用 |
| 异常说明 | 异常报备使用 |
| 提报人 | 工况机操作者 |
| 提报时间 | 创建审核单时间 |
| 审核状态 | 待审核、已审核 |
| 审核人 | 当前用户 |
| 审核时间 | 审核通过时间 |
| 审核备注 | 说明 |

### 7.3 数据表设计

建议新增：

```text
车间生产管理_生产任务审核单
```

关键字段：

| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| 审核流水号 | int identity | 主键 |
| 来源类型 | nvarchar(20) | 完工提报/异常报备 |
| 业务流水号 | int | 原工况机记录或异常记录 |
| 工艺计划流水号 | int | 生产任务 |
| 工序流水号 | int | 工序 |
| 提报完成数量 | decimal(18, 4) | 原始数量 |
| 审核完成数量 | decimal(18, 4) | 审核后数量 |
| 提报完成时间 | datetime | 原始时间 |
| 审核完成时间 | datetime | 审核后时间 |
| 异常类型 | nvarchar(100) | 异常报备 |
| 异常说明 | nvarchar(500) | 异常报备 |
| 提报人 | nvarchar(50) | 工况机人员 |
| 提报时间 | datetime | 创建时间 |
| 审核状态 | int | 0 待审核，1 已审核 |
| 审核人 | nvarchar(50) | 计划员 |
| 审核时间 | datetime | 审核时间 |
| 审核备注 | nvarchar(500) | 备注 |
| 是否删除 | int | 软删除 |

### 7.4 接口设计

新增过程：

| 接口名称 | type | 用途 |
| --- | --- | --- |
| `精工车间_生产任务审核_查询数据` | `11` | 审核单分页查询 |
| `精工车间_生产任务审核_编辑数据` | `12` | 审核前修改提报数据 |
| `精工车间_生产任务审核_通过` | `12` | 审核通过并推进原流程 |
| `精工车间_生产任务审核_详情_查询数据` | `11` | 查看单据详情 |

审核通过过程必须使用事务：

```text
BEGIN TRAN
  锁定审核单
  校验审核状态 = 待审核
  更新审核单审核数量、审核时间、审核人
  按来源类型调用或复刻原完工/异常报备后续逻辑
  更新生产任务、工序、工时、异常记录
COMMIT TRAN
```

失败时：

```text
ROLLBACK TRAN
返回 result = 0 和 msg
```

## 八、权限与菜单

建议新增菜单：

| 菜单名称 | 路由 |
| --- | --- |
| 工序工价维护 | `/SeikoWorkshop/ProcessPrice` |
| 生产任务审核 | `/SeikoWorkshop/ProductionTaskAudit` |

建议权限：

1. 工序工价维护：仅工艺、财务、车间管理人员可编辑。
2. 工时修正：仅车间主管或授权计划员可编辑。
3. 生产任务审核：计划员可审核，车间操作员不可审核自己的提报。
4. 整修补助编辑：设备管理或车间主管可编辑。

## 九、开发步骤

1. 与现场确认工序工价 9 个字段的准确名称、类型和必填规则。
2. 创建工序工价主表、历史表、生产任务审核单表。
3. 新增工序工价查询、新增、编辑、删除、历史查询存储过程。
4. 改造工时统计查询过程，返回工价、金额、总金额。
5. 改造整修记录查询过程，支持报备人筛选，返回单时补助和总金额。
6. 新增整修记录单时补助编辑过程。
7. 改造工况机完成提报、异常报备后端逻辑，改为先生成审核单。
8. 新增生产任务审核查询、编辑、通过过程。
9. 新增 `ProcessPrice` 页面。
10. 新增 `ProductionTaskAudit` 页面。
11. 修改 `WorkingHoursStatistics` 页面，增加工价、金额展示和汇总。
12. 修改 `RepairRecord` 页面，增加报备人筛选、补助编辑、金额汇总。
13. 配置菜单和角色权限。
14. 联调工况机提报、审核通过、生产任务流转、工时统计、整修补助导出。

## 十、验收清单

| 验收项 | 预期结果 |
| --- | --- |
| 工序工价新增 | 保存成功，列表可查询 |
| 工序工价编辑 | 修改后历史记录可追溯 |
| 历史定价查询 | 能查看同一工序多次价格变更 |
| 工时统计金额 | 明细金额和汇总金额正确 |
| 工时修正 | 调整后工时参与金额计算，并保留原始工时 |
| 整修记录按报备人查询 | 能按报备人过滤数据 |
| 整修补助编辑 | 单时补助保存成功，总金额自动变化 |
| 整修记录导出 | 导出包含单时补助和总金额 |
| 完工提报审核单 | 工况机提交后生成待审核单 |
| 异常报备审核单 | 异常报备后生成待审核单 |
| 审核数据修改 | 审核员可修改完成数量、完成时间 |
| 审核通过 | 通过后进入原生产任务后续流程 |
| 重复审核控制 | 已审核单据不能再次审核 |
| 权限控制 | 未授权用户不能编辑工价、补助或审核 |

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

1. 工序工价“9 个字段”的具体字段名未在需求文档中列明，需要业务补充。
2. 工时金额计算需要确认按件、按时还是混合计价，以及是否区分准结工时。
3. 工况机端完工和异常报备的现有后续逻辑需要在数据库中定位后再改造，避免绕过原有工时、质检、追溯更新。
4. 审核员修改完成数量后，是否需要同步影响质检数、不良数、入库可用数，需要业务确认。
5. 已有历史工时是否需要补算金额，需要确认补算范围。

修改人:Ld 修改时间:2026-07-02 13:01:57;