# 生产任务审核开发说明

## 一、需求来源

本文档根据桌面需求文件 `生产任务审核.docx` 整理，用于指导 JY1.0 生产任务审核功能开发。

## 二、需求范围

本需求目标：

车间工况机端填报完成数量，或进行异常报备时，需要先提交计划员审核。审核通过后，系统才进入原有后续流程。

现场讨论结果：

1. 取消“不通过打回”功能。
2. 如果提报数据不准确，由审核员直接修改完成数量、完成时间等数据。
3. 审核员修正后审核通过，再进入系统后续流程。

## 三、现有入口

| 功能点 | 现有入口 | 现有接口/过程 |
| --- | --- | --- |
| 生产任务查询 | `src/views/SeikoWorkshop/ProductionTaskQuery/index.vue` | `精工车间_生成任务_查询数据` |
| 零件追溯 | `src/views/SeikoWorkshop/ProductionTaskQuery/index.vue` | `车间生产管理工艺_追溯加工_查询工序` |
| 车间派工 | `src/views/SeikoWorkshop/WorkshopAssignment/index.vue` | 派工、取消派工、已派工查询相关过程 |
| 工时统计 | `src/views/SeikoWorkshop/WorkingHoursStatistics/index.vue` | 工人工时、设备工时统计过程 |

## 四、业务流程

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

## 五、新增审核页面

建议新增页面：

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

页面结构：

1. 搜索栏：提交时间、订单号、零件名称、图号、操作者、审核状态。
2. 数据表格：待审核和已审核任务。
3. 操作列：查看、编辑、审核通过。
4. 编辑弹窗：允许审核员修正完成数量、完成时间、异常信息和审核备注。

## 六、页面字段

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

## 七、数据表设计

建议新增表：

```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 | 软删除 |

## 八、接口设计

新增过程：

| 接口名称 | type | 用途 |
| --- | --- | --- |
| `精工车间_生产任务审核_查询数据` | `11` | 审核单分页查询 |
| `精工车间_生产任务审核_编辑数据` | `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
BEGIN TRAN
  锁定审核单
  校验审核状态 = 待审核
  更新审核完成数量、审核完成时间、审核人、审核时间
  按来源类型执行原完工提报或异常报备后续逻辑
  更新生产任务、工序、工时、异常记录
COMMIT TRAN
```

失败时：

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

## 十、前端交互规则

1. 待审核状态允许编辑和审核通过。
2. 已审核状态只允许查看，不允许再次编辑和审核。
3. 审核完成数量必须大于等于 0。
4. 审核完成时间不能为空。
5. 异常报备类型为异常时，异常类型或异常说明按业务要求校验。
6. 审核通过前需要二次确认。
7. 审核成功后刷新列表。

## 十一、权限与菜单

建议新增菜单：

| 菜单名称 | 路由 |
| --- | --- |
| 生产任务审核 | `/SeikoWorkshop/ProductionTaskAudit` |

建议权限：

1. 计划员可审核。
2. 车间操作员不可审核自己的提报。
3. 未授权用户只能查看或不可进入页面。
4. 审核通过后如需修改，必须走管理员修正或数据库审计流程。

## 十二、开发步骤

1. 定位工况机完成提报和异常报备现有后端逻辑。
2. 新增生产任务审核单表。
3. 改造工况机提报逻辑，提交后先生成待审核单，不直接进入后续流程。
4. 新增审核查询、编辑、通过、详情过程。
5. 新增 `ProductionTaskAudit` 页面。
6. 配置菜单和角色权限。
7. 联调完工提报生成审核单。
8. 联调异常报备生成审核单。
9. 联调审核员修改完成数量、完成时间。
10. 联调审核通过后生产任务、工时、追溯数据更新。

## 十三、验收清单

| 验收项 | 预期结果 |
| --- | --- |
| 完工提报审核单 | 工况机提交后生成待审核单 |
| 异常报备审核单 | 异常报备后生成待审核单 |
| 审核列表查询 | 可按时间、订单、人员、状态查询 |
| 审核数据修改 | 审核员可修改完成数量、完成时间 |
| 审核通过 | 通过后进入原生产任务后续流程 |
| 重复审核控制 | 已审核单据不能再次审核 |
| 状态同步 | 生产任务、工序、工时、追溯数据一致 |
| 权限控制 | 未授权用户不能审核 |

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

1. 工况机端完工和异常报备的现有后续逻辑需要在数据库中定位后再改造。
2. 审核员修改完成数量后，是否同步影响质检数、不良数、入库可用数，需要业务确认。
3. 异常报备审核通过后是否立即触发停机、维修、质量等后续流程，需要确认。
4. 历史已提报数据是否需要补生成审核单，需要确认。
5. 审核权限是否按角色、人员或菜单按钮控制，需要确认。

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