JY1.0/docs/工序工价与生产任务审核/工序工价开发说明.md

工序工价开发说明

一、需求来源

本文档根据桌面需求文件 工序工价需求文档.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 个字段加入已有车间查看工艺组件。考虑现有查看工艺组件偏现场查看，字段多且属于价格管理，建议新增独立页面。

建议新增页面：

src/views/SeikoWorkshop/ProcessPrice/index.vue

建议新增接口文件：

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 历史定价

新增历史记录表：

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

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

五、接口设计

新增过程：

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

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

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
})

六、工时统计金额设计

修改页面：

src/views/SeikoWorkshop/WorkingHoursStatistics/index.vue

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

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

员工工时明细表新增：

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

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

金额规则建议：

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

七、工时修正设计

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

新增字段：

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

新增接口：

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

八、整修记录补助设计

修改页面：

src/views/DeviceManagement/RepairRecord/index.vue

搜索栏新增：

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

表格新增：

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

规则：

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

调整现有查询过程：

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

新增入参：

报备人

新增返回字段：

单时补助
总金额

新增接口：

接口名称	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;