工具管理模块，由 yudao-module-mes 后端模块的 tm.tool 包实现。管理生产过程中使用的工装夹具（如模具、治具、刀具等），跟踪工具的使用数量、可用数量和保养周期。

本文涉及两个子模块：

• 工具类型：对工装夹具进行分类管理，并定义该类工具的默认保养方式和保养周期。
• 工装夹具台账：记录每件工具的基本信息、库存数量、保养状态等。

本文涉及表如下图所示：

1. 工具类型

工具类型，由 MesTmToolTypeController 提供接口。

1.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `mes_tm_tool_type` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  `code` varchar(64) NOT NULL COMMENT '类型编码',
  `name` varchar(255) DEFAULT NULL COMMENT '类型名称',
    
  `code_flag` tinyint DEFAULT NULL COMMENT '是否启用编码',
    
  `mainten_type` tinyint DEFAULT NULL COMMENT '保养方式',
  `mainten_period` int DEFAULT NULL COMMENT '保养周期',

  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 工具类型';

① code_flag 标识该类型的工具是否编码管理（前端列头"是否编码管理"）。为 true 时，前端新增工具时编码字段自动生成且不可手动编辑；为 false 时，由用户手动填写编码。

② mainten_type 为默认保养方式，mainten_period 为默认保养周期（天数）。创建该类型的工具时，自动继承这两个默认值。

1.2 管理后台

对应 [MES 系统 -> 工具管理 -> 工装夹具台账] 菜单左侧的工具类型树，对应 yudao-ui-admin-vue3 项目的 @/views/mes/tm/tool 目录中的左侧树组件。当前工具类型没有独立菜单页面，作为工装夹具台账页面的左侧分类树联动展示。

支持新增、修改、删除操作。

2. 工装夹具台账

工装夹具台账，由 MesTmToolController 提供接口。

2.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

CREATE TABLE `mes_tm_tool` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
  `code` varchar(64) NOT NULL COMMENT '工具编码',
  `name` varchar(255) DEFAULT NULL COMMENT '工具名称',
  `brand` varchar(255) DEFAULT NULL COMMENT '品牌',
  `specification` varchar(255) DEFAULT NULL COMMENT '规格型号',
    
  `tool_type_id` bigint DEFAULT NULL COMMENT '工具类型ID',

  `quantity` int DEFAULT NULL COMMENT '数量',
  `available_quantity` int DEFAULT NULL COMMENT '可用数量',

  `mainten_type` tinyint DEFAULT NULL COMMENT '保养方式',
  `next_mainten_period` int DEFAULT NULL COMMENT '下次保养周期',
  `next_mainten_date` datetime DEFAULT NULL COMMENT '下次保养日期',

  `status` tinyint NOT NULL DEFAULT '1' COMMENT '状态',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 工装夹具台账';

① tool_type_id 关联 mes_tm_tool_type 表的 id 字段。

② quantity 为总数量，available_quantity 为当前可用数量（总数量 - 已领用数量）。

③ mainten_type 为保养方式，next_mainten_period 为下次保养的周期天数，next_mainten_date 为计算出的下次保养日期。创建时从工具类型继承默认值。

④ status 为工具生命周期状态，枚举 MesTmToolStatusEnum（1=在库，2=领用中，3=维修中，4=报废）。新建时默认为「在库」。

2.2 管理后台

对应 [MES 系统 -> 工具管理 -> 工装夹具台账] 菜单，对应 yudao-ui-admin-vue3 项目的 @/views/mes/tm/tool 目录。

列表

支持按工具编码、名称、类型、状态等条件搜索。

新增/修改

点击【新增】或【编辑】按钮，弹出工具信息表单。主要填写工具编码（可自动生成）、名称、品牌、规格型号、工具类型、数量、保养信息等。