249 lines
8.2 KiB
Markdown
249 lines
8.2 KiB
Markdown
# 工序工价开发说明
|
||
|
||
## 一、需求来源
|
||
|
||
本文档根据桌面需求文件 `工序工价需求文档.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;
|