BJ_ZTEITS-Developers / parking-cloud-yudao

新增 RUNNING(运行中)/STOP(停机)/FAULT(故障) 三个状态枚举值，
并在 MesDvMachineryDO 的 status 字段上添加 @link 引用。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

新增班次管理(cal/shift)和排班计划(cal/plan)的前端实现，
包含 API 定义、列表页、表单弹窗、班组面板和班次面板，
以及 dict.ts 中 CAL 相关字典类型补充

迁移 ktg-mes 排班计划核心三表到 yudao-module-mes，实现创建计划→自动生成班次→分配班组→确认计划的完整业务流。

- 新增 cal_plan 排班计划 CRUD + 导出，含编码唯一校验、草稿/确认状态管理
- 新增 cal_shift 计划班次 CRUD + 导出，含按轮班方式自动生成默认班次、班次数量上限校验
- 新增 cal_plan_team 计划班组关联增删查，复用 plan 权限
- 新增 CalConstants 常量类、枚举类(ShiftType/ShiftMethod/PlanStatus)
- 新增错误码(shift 上限校验、plan 编码重复、状态校验、班组数量匹配)
- 删除计划时级联删除关联班次和班组

1. 新增独立枚举类 MesTmMaintenTypeEnum、MesTmToolStatusEnum（enums/tm 包）
2. DO Javadoc 从字典引用改为枚举引用
3. ServiceImpl 使用枚举常量替代魔法值
4. Controller 抽取 buildToolRespVOList() 私有方法，复用 page/export 拼接逻辑
5. ServiceImpl 校验方法使用 ObjUtil.notEqual() 替代 Objects.equals + null 判断

新增工具类型(mes_tm_tool_type)和工具台账(mes_tm_tool)的完整 CRUD，
包括 DO、Mapper、Service、Controller、VO，以及 ErrorCodeConstants
和 DictTypeConstants 的相关枚举补充。

1. type 从 String(varchar) 改为 Integer(tinyint)，1=工作日 2=节假日
2. 移除 startTime/endTime 字段，theDay 重命名为 day
3. 精简为 3 个接口：save(upsert)、get-by-day、list
4. 删除 update/delete/get/page/export-excel 及 PageReqVO
5. RespVO 移除 Excel 注解，createHoliday 重命名为 saveHoliday

从 ktg-mes 迁移 cal_holiday 到 yudao-module-mes，作为 CAL 日历排班模块首个实体。
支持将日期标记为假期(HOLIDAY)或工作日(WORKDAY)，创建时自动 upsert（同一天更新而非重复插入）。

新增文件：
- MesCalHolidayDO / Mapper / Service / Controller
- MesCalHolidaySaveReqVO / RespVO / PageReqVO
- mes_cal_holiday.sql（DDL + CAL根菜单5200 + 假期菜单5250~5255 + 字典 + 演示数据）

修改文件：
- ErrorCodeConstants：新增 CAL_HOLIDAY_NOT_EXISTS
- DictTypeConstants：新增 MES_CAL_HOLIDAY_TYPE

1. SIP/SOP 的 orderNumber 字段全局重命名为 sort，涉及 DO、VO、Mapper、Service、ErrorCode
2. BOM Service 的 hasCycle 方法重命名为 hasBomCycle，语义更清晰
3. ErrorCode 常量 ORDER_NUMBER_DUPLICATE 重命名为 SORT_DUPLICATE

修正 MES 工作站相关 4 张表的中文注释（DO/VO/Controller/Service/Mapper/ErrorCode）：
- 工位 → 工作站
- 工位设备 → 设备资源
- 工位工具 → 工装夹具资源
- 工位人员 → 人力资源

修正 MES 工作站相关 4 张表的中文注释，涵盖 DO/VO/Controller/Service/Mapper/ErrorCode：
- 工位 → 工作站
- 工位设备 → 设备资源
- 工位工具 → 工装夹具资源
- 工位人员 → 人力资源

新增 md_product_bom / md_product_sop / md_product_sip 三张子表的完整后端：
- DO / Mapper / VO / Service / Controller 共 24 个文件
- BOM 支持自引用校验和 DFS 闭环检测
- SOP / SIP 支持排序号唯一校验和图片管理
- 不冗余物料字段，仅存 ID，Controller 层 JOIN 组装展示
- ErrorCodeConstants 新增 6 个错误码
- MesMdItemServiceImpl 增加级联删除

新增车间（workshop）和工位（workstation）5 张表的完整后端：
- DDL 建表 + 菜单 SQL（5160-5175）+ 螺丝刀工厂演示数据 21 条
- 5 DO + 5 Mapper + 5 Service 接口 + 5 Service 实现 + 5 Controller
- 17 VO（含分页/保存/响应）
- 工位子资源（设备/工具/人员）支持级联删除
- 导出 Excel 已拼装车间名称、负责人名称等关联字段

新增车间（workshop）和工位（workstation）5 张表的完整后端实现：
- DDL 建表 + 菜单 SQL + 螺丝刀工厂演示数据 21 条
- DO/Mapper/Service/VO/Controller 共 37 个 Java 文件
- 工位支持设备、工具、人员三类子资源的 CRUD

1. 新增独立表 mes_md_item_batch_config，与 mes_md_item 保持 1:1 关系（UNIQUE KEY）
2. 新增 DO/Mapper/Service/Controller/VO，采用 upsert 模式（GET by itemId + POST save）
3. 复用物料权限 mes:md-item:query / mes:md-item:update，无需独立菜单
4. MesMdItemServiceImpl：级联删除批次配置 + 启用时校验至少一个 flag 为 true
5. 修复 simple-list 接口未返回 itemOrProduct 字段的 BUG
6. 代码规范：变量/方法名统一加 Item 前缀（itemBatchConfigService / getItemBatchConfigByItemId 等）

新增供应商管理的全套后端代码，参照客户(md_client)模块风格：
- DO/Mapper/Service/Controller 完整 CRUD
- 供应商导入功能（Excel 解析、逐行校验、创建或更新）
- 导入模板下载接口
- VO：SaveReqVO、RespVO、PageReqVO、ImportExcelVO、ImportRespVO
- 编码/名称/简称唯一性校验
- ErrorCodeConstants 新增供应商相关错误码（1_040_104_000~004）
- 权限：mes:md-vendor:{query,create,update,delete,export,import}

从 ktg-mes md_client 迁移到 yudao-module-mes，包含：
- 新增 MesMdClientDO、Mapper、Service、Controller 全链路
- 字段重命名对齐 yudao 规范（client_code→code, client_name→name 等）
- client_type 由 varchar 改为 tinyint 字典（mes_client_type）
- enable_flag 由 char(Y/N) 改为 status tinyint（CommonStatusEnum）
- 创建/更新时校验 code、name、nickname 唯一性
- Excel 导入支持创建/更新模式，含逐行校验与错误汇总
- 新增 ErrorCodeConstants（1_040_103_000~004）和 DictTypeConstants

1. 迁移计量单位：新增 MesMdUnitMeasure 全套 CRUD（Controller/Service/Mapper/VO）
2. 物料单位外键改造：unitOfMeasure(String) → unitMeasureId(Long)，
   Controller 拼接 unitMeasureName，表单改为下拉选择
3. 物料导入：新增 ImportExcelVO/ImportRespVO，Service 实现 importItemList，
   支持按编码匹配计量单位、物料分类校验
4. 删除引用校验：计量单位删除前检查是否被物料引用
5. 字段重命名：attr1~attr4 → attribute1~attribute4（Item/ItemType/UnitMeasure 全部 DO+VO）
6. 权限标识：物料导入接口独立 mes:md-item:import 权限
7. 迁移客户管理：新增 MesMdClient 全套 CRUD

1. Service 层重构：接口只返回 DO，VO 拼接移至 Controller
2. Mapper 合并两个 selectPage 为一个方法（inIfPresent 兼容空集合）
3. 新增物料批量导入功能（ImportExcelVO + ImportRespVO + Controller 端点）
4. 分类查询支持子分类递归（getItemTypeChildrenList）
5. 物料分页查询自动包含选中分类的所有子分类
6. 分类删除移除 export-excel 端点
7. 校验逻辑简化：ObjUtil.notEqual 替代双 if 判断
8. collectChildren 重命名为 collectItemTypeChildren

迁移 ktg-mes 的 md_item_type 和 md_item 两张表到 yudao-module-mes，
包含完整的 CRUD、树形分类、物料分页查询、enrichment 等功能。

后端新增 17 个文件（1337 行）：
- DO: MesMdItemTypeDO（树形分类）、MesMdItemDO（物料产品）
- VO: 分类 3 个（List/Save/Resp）、物料 3 个（Page/Save/Resp）
- Mapper: 2 个（BaseMapperX，纯 Java，无 XML）
- Service: 4 个（接口 + 实现）
- Controller: 2 个（/mes/md/item-type、/mes/md/item）
- ErrorCodeConstants 追加 9 个错误码

关键业务逻辑：
- 分类：父分类递归环路检测、同级名称/编码唯一性、删除保护（子分类+物料）
- 物料：编码/名称全局唯一、分类存在校验、安全库存联动清零
- enrichment：物料 RespVO 通过 Service 关联填充 itemTypeName、itemOrProduct
- 循环依赖：MesMdItemTypeServiceImpl 用 @Lazy 注入 MesMdItemService

plan: plans/swirling-stirring-metcalfe.md