工装管理员-工装配置SOP

文档编号: BayesMES-SOP-TOOLING-002-V1.0
文档版本: V1.0
适用系统: BayesMES 制造执行系统
适用角色: 工装管理员、工装主管
适用终端: Web端
角色类型: 管理员/工程师
最后更新: 2026-04-29
下次评审: 2026-05-31
文档状态: 评审中
编制人: BayesMES团队
审核人: ysfl
批准人: ysfl

真实性核对说明

本文档按《SOP编制标准》V2.2.0 编写，并已核对以下真实依据：

BayesMES 工装模块 Web 路由、列表页、表单组件、审批弹窗、预警处理弹窗
BayesMES 后端工装控制器、服务、资源、模型状态和路由
@bayes-mes/shared 工装类型、请求、响应定义
TM-09《工装管理培训手册》

⚠️ 重要差异说明
培训手册中存在“扫码领用/扫码归还/模具维护”等理想流程描述，但当前真实源码能力并不完全一致。本文档仅将已在 Web 端确认的能力写为标准操作；未完成或存在实现缺口的能力统一放入“待确认问题清单”。

1. 名词术语表

术语	英文/缩写	解释
工装看板	Tooling Dashboard	工装模块统计看板，显示总体数量、可用、使用中、需维护等信息
台账	Ledger	工装基础档案，包括编码、名称、类型、寿命、库存、位置等
预警阈值	Warning Threshold	用于触发寿命预警或维护关注的阈值
审批开关	Approval Required	控制工装申请是否必须走审批流的系统配置
待我审批	Pending Approval	当前登录人需要处理的工装申请列表
预警处理	Alert Handling	对寿命、维护、校准等预警做记录、关闭或忽略
批量导入	Batch Import	通过 Excel 一次导入多条工装档案

2. 配置概述

2.1 配置目标

工装管理员在当前版本需要完成三类核心工作：

工装建档：维护刀具、检具、夹具、模具基础资料
审批协同：处理操作员提交的工装使用申请
预警闭环：查看和处理寿命、维护、校准相关预警

2.2 推荐工作顺序

2.3 当前版本能力边界

已确认可作为正式培训内容的 Web 能力：

工装管理总览
工装看板
刀具管理
检具管理
夹具管理
模具管理
待我审批
工装预警

存在实现缺口、不建议按正式流程培训的部分：

Web 端“新增申请”弹窗中的工装选择尚未完成
Web 端申请列表“撤销”仍显示为开发中
Web 端审批列表“查看”仍显示为开发中
模具使用、归还、维护接口在路由中仍为注释状态

3. 配置前准备

3.1 进入方式

菜单路径：

Web端 -> 工装管理

系统会进入：

工装管理总览
工装管理看板
刀具管理
检具管理
夹具管理
模具管理
工装使用申请
待我审批
工装预警

3.2 前置数据

建议先确认以下基础数据已准备完成：

数据	用途
设备档案	工装与设备绑定、上机、关联设备选择
供应商档案	采购价格和供应来源维护
操作员/审批人	工装申请和审批流使用
工装编码规则	确保批量导入和日常建档不重复

3.3 配置前检查

开始配置前，请确认：

当前账号可进入工装 Web 模块
需要维护的工装类型已明确
如需使用审批流，审批人和审批规则已由系统管理员准备

4. 功能入口与真实范围

页面	路径/入口	已确认能力	备注
工装管理总览	`/tooling/index`	模块导航	用于快速进入各子页
工装管理看板	`/tooling/dashboard`	统计查看、点击进入分类页	正式可用
刀具管理	`/tooling/tools`	查询、新增、编辑、删除、导入、更换记录查看	正式可用
检具管理	`/tooling/gauges`	查询、新增、编辑、删除、导入	正式可用
夹具管理	`/tooling/fixtures`	查询、新增、编辑、删除、导入、开始使用、归还	正式可用
模具管理	`/tooling/molds`	查询、新增、编辑、删除、导入	正式可用
工装使用申请	`/tooling/applications`	查看列表	新增/撤销流程未完全落地
待我审批	`/tooling/approvals`	批准、拒绝申请	查看详情未完成
工装预警	`/tooling/alerts`	检查预警、处理、忽略	正式可用

工装管理总览

工装管理看板

5. 工装台账配置

5.1 通用操作规则

四类工装列表页都已确认支持以下通用动作：

关键字搜索
按状态筛选
刷新
字段设置
新增
编辑
删除
批量导入

通用培训口径：

先在列表页搜索是否已存在同编码工装
不存在再点击 [新增]
新增后立即用关键字回查
批量导入前先检查模板字段与编码重复

5.2 刀具台账配置

操作路径：

Web端 -> 工装管理 -> 刀具管理

新增/编辑时已确认的关键字段：

字段	必填	说明
刀具编码	✅	必须唯一
刀具名称	✅	建议使用现场通用名称
刀具类型	✅	如车刀、铣刀、钻头等
刀具分类	❌	用于细分管理
型号	❌	型号信息
规格	❌	规格信息
制造商	❌	厂商名称
最大寿命	✅	创建时用于初始化剩余寿命
寿命单位	✅	`COUNT` 或 `HOUR`
预警阈值	❌	页面默认 20
库存数量	❌	用于库存参考
最小库存	❌	低库存提示参考
仓库位置	❌	存放位置
备注	❌	说明信息

真实规则：

创建时若未指定状态，系统默认设为“正常”
创建时若未传剩余寿命，系统自动把剩余寿命设为最大寿命
创建时若未传二维码，系统自动生成 QR_TOOL_刀具编码
刀具列表支持按“需更换”筛选

刀具新增表单

5.3 检具台账配置

操作路径：

Web端 -> 工装管理 -> 检具管理

新增/编辑时已确认的关键字段：

字段	必填	说明
检具编码	✅	必须唯一
检具名称	✅	检具名称
检具类型	✅	检具类型
检具分类	❌	细分类别
型号	❌	型号信息
规格	❌	规格信息
制造商	❌	厂商
序列号	❌	资产序列号
精度	❌	精度等级
测量范围	❌	检测范围
校准周期(天)	✅	页面默认 365
校准机构	❌	校准单位
存放位置	❌	当前放置位置

真实规则：

创建时默认状态为“正常”
创建时若未传二维码，系统自动生成 QR_GAUGE_检具编码
列表支持按“校准到期”查询

检具新增表单

5.4 夹具台账配置

操作路径：

Web端 -> 工装管理 -> 夹具管理

新增/编辑时已确认的关键字段：

字段	必填	说明
夹具编码	✅	必须唯一
夹具名称	✅	夹具名称
夹具类型	✅	夹具类型
夹具分类	❌	分类信息
型号	❌	型号
规格	❌	规格
制造商	❌	厂商
最大寿命	✅	创建时同步初始化剩余寿命
预警阈值(%)	❌	页面默认 20
维护周期(天)	❌	页面默认 365
库存数量	❌	当前数量
最小库存	❌	安全库存参考
仓库位置	❌	存放位置

真实规则：

创建时默认状态为“正常”
创建时若未传剩余寿命，系统自动设置为最大寿命
创建时若未传二维码，系统自动生成 QR_FIXTURE_夹具编码

夹具新增表单

5.5 模具台账配置

操作路径：

Web端 -> 工装管理 -> 模具管理

新增/编辑时已确认的关键字段：

字段	必填	说明
模具编码	✅	必须唯一
模具名称	✅	模具名称
模具类型	✅	模具类型
模具分类	❌	分类信息
型号	❌	型号
规格	❌	规格
制造商	❌	厂商
穴数	✅	模具穴数
最大寿命	✅	最大使用寿命
预警阈值(%)	❌	页面默认 20
维护周期(天)	❌	页面默认 365
存放位置	❌	存放位置

真实规则：

创建时默认状态为“正常”
创建时若未传剩余寿命，系统自动设置为最大寿命
创建时若未传二维码，系统自动生成 QR_MOLD_模具编码

模具新增表单

5.6 批量导入要求

四类工装的批量导入都已确认采用“全量回滚”策略：

任意一行校验失败，则整批不导入
常见失败原因：
- 编码为空
- 编码与数据库重复
- 同一批次内编码重复

导入前建议：

先导出或整理好编码清单
先在系统中搜索同类编码
小批量试导入后再做大批量导入

6. 审批与预警联动

6.1 工装申请审批的真实规则

后端已确认：

是否需要审批，取决于系统配置
审批人按工装类型分别配置
如需要审批但未配置审批人，申请会报错
申请状态流转为：
- 待审批
- 审批中
- 已批准
- 已拒绝
- 已取消

培训口径：

工装管理员负责处理“待我审批”中的申请
是否启用审批开关和审批人名单，不在当前工装 Web 页面维护；如需修改，应联系系统管理员

6.2 待我审批操作

操作路径：

Web端 -> 工装管理 -> 待我审批

页面已确认操作：

刷新
批准
拒绝

操作说明：

打开待我审批列表
根据申请编号、工装类型、工装名称、申请人、申请时间判断是否批准
点击 [批准]：
- 可填写审批备注
- 若当前还有下一审批人，系统状态会变为“审批中”
- 若当前已是最后一位审批人，系统状态会变为“已批准”
点击 [拒绝]：
- 必须填写拒绝原因
- 系统状态更新为“已拒绝”

当前截图环境下“待我审批”列表为空，已保留真实空列表页面作为发布前占位。

待我审批列表

6.3 工装预警处理

操作路径：

Web端 -> 工装管理 -> 工装预警

页面已确认操作：

检查预警
处理
忽略

操作说明：

点击 [检查预警] 手动触发一次预警扫描
在列表中查看：
- 预警类型
- 工装类型
- 工装编码
- 预警消息
- 预警级别
- 状态
对未处理预警，可执行：
- 处理：填写处理结果并提交
- 忽略：直接标记为已忽略

真实规则：

处理后状态改为“已处理”
忽略后状态改为“已忽略”
预警类型已确认包括：寿命预警、维护到期、异常状态

当前截图环境下“工装预警”列表无未处理记录，已保留真实列表页面截图。发布前如需体现“处理弹窗”，建议补采存在未处理预警的数据场景。

工装预警页面

6.4 夹具使用与归还验证

当前 Web 端只有夹具页明确落地了“开始使用 / 归还夹具”操作，可用于配置验证。

开始使用夹具：

入口：夹具列表行操作中的 开始使用
已确认字段：
- 工单号（必填）
- 设备ID（可选）
- 操作员ID（可选）
- 备注（可选）

归还夹具：

入口：夹具列表行操作中的归还
已确认字段：
- 是否有异常
- 异常原因（勾选异常后必填）
- 备注

真实规则：

夹具使用中、需维护、已报废状态下不能再次开始使用
归还后系统会更新使用记录和工装状态
若归还异常或寿命达到阈值，会进入需维护，并可能生成预警

夹具归还弹窗

7. 配置验证

7.1 台账验证

新增或编辑后，请立即核对：

列表中能搜索到对应编码
名称、类型、型号、规格显示正确
状态默认为“正常”
寿命类工装已生成剩余寿命

7.2 审批验证

如本期上线包含审批流，请验证：

App 端能正常提交一张测试申请
Web 端“待我审批”能看到该申请
批准或拒绝后，申请状态正确更新

7.3 预警验证

建议至少验证一次：

点击 检查预警
确认列表中新增或更新预警记录
对一条未处理预警执行“处理”或“忽略”
状态变化应能正确显示

7.4 夹具验证

如本次有夹具配置：

选一条正常状态夹具执行“开始使用”
再执行“归还夹具”
核对状态是否回写正确

8. 异常处理与应急措施

异常情况	现象	处理方式
新增失败	保存时报编码重复或校验失败	先检查编码唯一性和必填项
导入失败	整批未写入	检查失败行编码和必填字段，修正后重新导入
审批时报“未配置审批人”	申请无法提交或流转	联系系统管理员补审批配置
预警处理失败	提交处理结果后报错	刷新后重试，保留预警编号反馈
夹具无法开始使用	状态提示使用中/需维护/已报废	先处理工装状态，再重新验证
模具无法做使用归还培训	页面无对应按钮	当前版本不纳入正式培训内容

9. 常见问题解答（FAQ）

Q1：工装配置完成后，为什么 App 端还看不到？

先确认是否保存成功，再确认 App 端是否按正确工装类型查看；如仍看不到，检查是否需要刷新或是否存在权限限制。

Q2：为什么同一类工装的状态不完全一样？

不同工装类型的状态枚举不同。例如刀具有“需更换”，检具有“需校准”，夹具和模具有“需维护”。

Q3：审批一定会经过多人吗？

不一定。审批人数取决于系统配置；如果当前工装类型只有一位审批人，第一位审批完成后就会直接变成“已批准”。

Q4：工装申请列表页面为什么不建议作为正式培训入口？

因为 Web 端“新增申请”的工装选择仍有未完成部分，“撤销”也还是开发中，培训应优先使用已确认完成的 App 端申请流程。

Q5：模具能不能像夹具一样做使用和归还？

当前路由中相关接口仍处于注释状态，不能作为已上线能力培训。

10. 源码与依据清单

类型	文件/路径	已核对内容	结论
后端路由	`bayes-mes-base-core-php/backend/routes/tooling.php`	看板、申请、预警、四类工装路由	与SOP一致
后端控制器	`.../ToolController.php`	刀具查询、新增、更新、删除、更换、导入	与SOP一致
后端控制器	`.../GaugeController.php`	检具查询、新增、更新、删除、借用、归还、上下机	已核对，存在返回状态待确认
后端控制器	`.../FixtureController.php`	夹具查询、新增、更新、删除、使用、归还、维护	与SOP一致
后端控制器	`.../MoldController.php`	模具查询、新增、更新、删除、导入	与SOP一致
后端控制器	`.../ToolingController.php`	看板、申请、待审批、预警、手动检查预警	与SOP一致
后端服务	`.../ApprovalService.php`	审批开关、审批人、状态流转	与SOP一致
后端服务	`.../AlertService.php`	预警处理、忽略逻辑	与SOP一致
后端服务	`.../ToolService.php`	默认状态、剩余寿命、二维码、批量导入回滚	与SOP一致
后端服务	`.../GaugeService.php`	默认状态、二维码、批量导入回滚	与SOP一致
后端服务	`.../FixtureService.php`	默认状态、使用归还逻辑、预警创建	与SOP一致
后端服务	`.../MoldService.php`	默认状态、二维码、批量导入回滚	与SOP一致
Shared类型	`bayes-mes-shared/types/tooling/requests.ts`	表单字段	与SOP一致
Shared类型	`bayes-mes-shared/types/tooling/responses.ts`	看板、申请、预警、四类工装响应字段	与SOP一致
Web源码	`bayes-mes-base-web/apps/mes/src/modules/mes/tooling/routes.ts`	页面入口和子路由	与SOP一致
Web源码	`.../views/ToolingDashboard.vue`	看板统计与跳转	与SOP一致
Web源码	`.../views/ToolList.vue` 等4类列表页	列表字段、筛选、导入、行操作	与SOP一致
Web源码	`.../components/ToolForm.vue` 等4类表单	新增/编辑字段和必填校验	与SOP一致
Web源码	`.../views/ToolingApprovalList.vue` / `ToolingApprovalModal.vue`	批准、拒绝流程	与SOP一致
Web源码	`.../views/ToolingAlertList.vue` / `ToolingAlertHandleModal.vue`	检查、处理、忽略预警	与SOP一致
模块文档	`培训文档/模块/09-工装管理/培训手册/TM-09_工装管理培训手册.md`	业务背景与原始流程口径	已按源码修正差异

10.1 三段一致性检查记录

检查项	后端规则	前端界面	SOP表达	结果
台账配置	CRUD与导入已存在	4类列表与表单已存在	写入正式步骤	一致
审批处理	待审批、批准、拒绝存在	Web待我审批已存在	写入正式步骤	一致
预警处理	检查、处理、忽略存在	Web预警页已存在	写入正式步骤	一致
模具使用归还	路由未放开	Web无按钮	不写为既成功能	一致
Web申请新增/撤销	部分功能未完成	页面有TODO/开发中	不写为正式培训流程	一致

11. 待确认问题清单

编号	待确认项	当前处理口径	责任人
T-ADM-01	Web申请列表的“新增申请”工装选择尚未完成	不作为正式培训入口	前端
T-ADM-02	Web申请列表“撤销”仍为开发中	不写入正式操作步骤	前端
T-ADM-03	Web审批列表“查看”仍为开发中	培训仅覆盖批准/拒绝	前端
T-ADM-04	模具使用、归还、维护路由仍为注释状态	当前不作为已上线能力	后端/产品
T-ADM-05	`GaugeController` 中归还/下机使用 `STATUS_AVAILABLE`，与模型常量命名需再确认	当前不将检具归还/下机写入 Web 管理员步骤	后端
T-ADM-06	App 待审批页拒绝动作提交字段与后端校验字段不一致	不将 App 拒绝审批作为正式口径	前端/后端

12. 关联文档

文档	用途
TM-09_工装管理培训手册	查看工装模块业务背景
操作员-工装领用归还SOP	培训操作员提交领用申请和查看审批结果

13. 截图清单

截图统一放置于 模块/09-工装管理/SOP/images/。发布版必须补充脱敏后的真实系统截图。

当前版本 01-09 号截图已全部完成采集。

序号	截图内容	关键标注点	文件名建议
01	工装管理总览	①模块导航卡片 ②申请与审批入口	tooling-admin-01-index.png
02	工装看板	①总体统计 ②分类统计卡片	tooling-admin-02-dashboard.png
03	刀具新增表单	①编码名称 ②寿命单位 ③库存位置	tooling-admin-03-tool-form.png
04	检具新增表单	①校准周期 ②精度 ③存放位置	tooling-admin-04-gauge-form.png
05	夹具新增表单	①最大寿命 ②维护周期 ③库存数量	tooling-admin-05-fixture-form.png
06	模具新增表单	①穴数 ②最大寿命 ③存放位置	tooling-admin-06-mold-form.png
07	待我审批	①申请信息 ②批准 ③拒绝	tooling-admin-07-approval-list.png
08	预警管理页面（当前环境无未处理预警）	①检查预警 ②列表字段 ③状态列	tooling-admin-08-alert-handle.png
09	夹具归还弹窗	①异常勾选 ②异常原因 ③备注	tooling-admin-09-fixture-return.png

14. 版本记录

版本	日期	编制人	修订内容
V1.0	2026-04-29	BayesMES团队	首次创建，按《SOP编制标准》V2.2.0 基于真实 Web/后端源码整理工装配置、审批与预警处理流程，并将未完成能力移入待确认清单
V1.1	2026-04-29	BayesMES团队	回填本地 Web 真实截图，补充总览、看板、四类表单、待我审批和预警页面截图，并标注夹具归还弹窗待补
V1.2	2026-04-29	BayesMES团队	补充夹具“归还夹具”真实弹窗截图，完成管理员SOP截图闭环

工装管理员-工装配置SOP ​

真实性核对说明 ​

目录 ​

1. 名词术语表 ​

2. 配置概述 ​

2.1 配置目标 ​

2.2 推荐工作顺序 ​

2.3 当前版本能力边界 ​

3. 配置前准备 ​

3.1 进入方式 ​

3.2 前置数据 ​

3.3 配置前检查 ​

4. 功能入口与真实范围 ​

5. 工装台账配置 ​

5.1 通用操作规则 ​

5.2 刀具台账配置 ​

5.3 检具台账配置 ​

5.4 夹具台账配置 ​

5.5 模具台账配置 ​

5.6 批量导入要求 ​

6. 审批与预警联动 ​

6.1 工装申请审批的真实规则 ​

6.2 待我审批操作 ​

6.3 工装预警处理 ​

6.4 夹具使用与归还验证 ​

7. 配置验证 ​

7.1 台账验证 ​

7.2 审批验证 ​

7.3 预警验证 ​

7.4 夹具验证 ​

8. 异常处理与应急措施 ​

9. 常见问题解答（FAQ） ​

Q1：工装配置完成后，为什么 App 端还看不到？ ​

Q2：为什么同一类工装的状态不完全一样？ ​

Q3：审批一定会经过多人吗？ ​

Q4：工装申请列表页面为什么不建议作为正式培训入口？ ​

Q5：模具能不能像夹具一样做使用和归还？ ​

10. 源码与依据清单 ​

10.1 三段一致性检查记录 ​

11. 待确认问题清单 ​

12. 关联文档 ​

13. 截图清单 ​

14. 版本记录 ​

工装管理员-工装配置SOP

真实性核对说明

目录

1. 名词术语表

2. 配置概述

2.1 配置目标

2.2 推荐工作顺序

2.3 当前版本能力边界

3. 配置前准备

3.1 进入方式

3.2 前置数据

3.3 配置前检查

4. 功能入口与真实范围

5. 工装台账配置

5.1 通用操作规则

5.2 刀具台账配置

5.3 检具台账配置

5.4 夹具台账配置

5.5 模具台账配置

5.6 批量导入要求

6. 审批与预警联动

6.1 工装申请审批的真实规则

6.2 待我审批操作

6.3 工装预警处理

6.4 夹具使用与归还验证

7. 配置验证

7.1 台账验证

7.2 审批验证

7.3 预警验证

7.4 夹具验证

8. 异常处理与应急措施

9. 常见问题解答（FAQ）

Q1：工装配置完成后，为什么 App 端还看不到？

Q2：为什么同一类工装的状态不完全一样？

Q3：审批一定会经过多人吗？

Q4：工装申请列表页面为什么不建议作为正式培训入口？

Q5：模具能不能像夹具一样做使用和归还？

10. 源码与依据清单

10.1 三段一致性检查记录

11. 待确认问题清单

12. 关联文档

13. 截图清单

14. 版本记录