BJ_ZTEITS-Developers / parking-cloud-yudao

1. BomController：新增物料需求接口 /item-list-by-work-order-id，
   采用逐层 IN 查询展开 BOM 到叶子物料（替代递归），使用 convertMultiMap 统一风格；
   补充 BomRespVO 的 itemOrProduct 字段及 itemType 拼接
2. WorkOrderController：新增 confirmWorkOrder 确认接口，
   调整 confirm/finish/cancel 端点顺序；parentMap 改用 getWorkOrderMap
3. WorkOrderService/ServiceImpl：新增 getWorkOrderList 空判断、getWorkOrderMap、
   confirmWorkOrder 状态校验，finish/cancel 增加"已确认"状态前置校验，
   新增 PRO_WORK_ORDER_NOT_CONFIRMED 错误码
4. ProductBomMapper/Service：新增 selectByItemIds 批量查询方法
5. 仓库/库区/库位删除：补充库存记录占用校验（WM_WAREHOUSE_HAS_MATERIAL_STOCK 等）
6. 移除工单 batchCode 字段（DO/SaveReqVO/RespVO）

- MesCalCalendarListReqVO：新增 QUERY_TYPE_TYPE/TEAM/USER 静态常量，消除 switch 中的魔法字符串
- MesCalCalendarServiceImpl：switch 分支改用 ReqVO 常量引用；TeamShiftItem 构建移除 getOrDefault，改为 null 安全取值；补充待优化 TODO（参数校验前移、方法拆分、批量查询改走 Service）
- MesCalCalendarRespVO：shiftType 字段补充枚举说明注释

- RespVO 新增 clientCode、parentCode 字段
- Service 新增 getWorkOrderList(ids) 批量查询方法
- Controller buildWorkOrderRespVOList 拼接客户编码、父工单编码

- 工艺路线启用后禁止关闭/删除，前后端+关联表(工序/产品/BOM)均增加校验
- MesProLinkTypeEnum 枚举常量重命名为全称(START_START/FINISH_FINISH 等)
- 新增 MesTimeUnitTypeEnum 时间单位枚举(MINUTE/HOUR/DAY)
- DictTypeConstants 补充 MES_PRO_LINK_TYPE、MES_TIME_UNIT_TYPE
- MesProRouteProcessDO/MesProRouteProductDO 补充字典+枚举 Javadoc 链接
- MesProRouteProcessMapper 移除冗余的 findPreProcess/findNextProcess 方法

- DO 类补充 {@link} 外链注解（RouteProcess/Product/ProductBom）
- RouteService 提取 updateRouteStatus 独立接口，启用/禁用逻辑分离
- RouteService 将 mapper 直接调用改为 service 调用，解耦跨表操作
- RouteProcessService 拆分校验方法（sort/process/keyProcess 唯一性）
- RouteProductService 复用 validateRouteProductExists，mapper 改 service
- RouteProductBomService 新增按 routeId/productId 级联删除方法
- Controller 层 buildRespVOList 统一使用 CollUtil/MapUtils/convertSet 模式
- RouteController 新增 /update-status 端点
- 统一使用 ObjUtil.notEqual / CollUtil.isEmpty / BooleanUtil.isFalse

QC Template: enableFlag(Boolean) -> status(Integer)，使用 CommonStatusEnum
Warehouse Area: enabled(Boolean) -> status(Integer)，使用 CommonStatusEnum
Warehouse Location: areaEnabled(Boolean) -> areaStatus(Integer)，使用 CommonStatusEnum

涉及前端 API 定义、列表页、表单页的字段名和字典类型切换（INFRA_BOOLEAN_STRING -> COMMON_STATUS），
以及后端 DO、RespVO、SaveReqVO、PageReqVO、Mapper 的同步修改。

注意：语义反转，原 true(启用) 对应新 status=0(开启)，原 false(禁用) 对应新 status=1(关闭)。

从 ktg-mes 迁移工艺路线（pro-route）模块，包含：
- 4 个 DO：MesProRoute / RouteProcess / RouteProduct / RouteProductBom
- 4 个 Mapper 及 9 个 VO（含工序链 findPre/findNext 查询）
- 4 对 Service 接口+实现（链表重建、启用校验、级联删除）
- 4 个 Controller（路线 CRUD+导出，子资源复用父权限）

- MesQcTemplateIndicatorController：Mapper 注入改为 Service 注入（MesQcIndicatorService、MesMdUnitMeasureService），方法重命名为 buildIndicatorRespVOList，使用 findAndThen 链式设置冗余字段
- MesQcTemplateItemController：同上，MesMdItemService、MesMdUnitMeasureService，方法重命名为 buildItemRespVOList，嵌套 findAndThen 补充物料及单位名称
- MesQcTemplatePageReqVO：enableFlag 改为 Boolean，type 改为 Integer（单值查询）
- MesQcTemplateMapper：selectPage 改用 findInSet 匹配 types 字段，eqIfPresent 匹配 enableFlag

- MesQcTemplateController 拆分为三个独立 Controller：
  MesQcTemplateIndicatorController（/mes/qc/template/indicator）
  MesQcTemplateItemController（/mes/qc/template/item）
- Service 层 get 方法统一返回 DO，JOIN 逻辑移至各 Controller 的 convertXxxRespVO()
- MesQcTemplatePageReqVO：types(List) 改为 type(Integer)，支持单个检测种类筛选
- MesQcTemplateMapper：FIND_IN_SET 改用 MyBatisUtils.findInSet()
- MesQcTemplateItemSaveReqVO：清理 @Schema 描述中冗余括号说明
- 清理所有 TODO @AI 注释

- MesCalTeamMemberController：注入 AdminUserApi，合并 list-by-team 与
  list-by-team-ids 为单一接口（支持 teamId / teamIds 参数），新增
  buildMemberRespVOList 方法批量填充用户昵称和手机号
- MesCalTeamMemberServiceImpl：validateTeamMemberExists 改为 void 返回；
  validateUserUnique 去掉冗余的 excludeId 参数
- MesCalTeamMemberMapper：selectByUserIdExcludeId 简化为 selectByUserId

新增 mes_cal_team / mes_cal_team_member / mes_cal_team_shift 三张表的完整后端实现：
- SQL：三张表 DDL、菜单 INSERT（5220-5225）、测试数据
- DO / Mapper / VO / Service / Controller 全套分层实现
- MesCalTeamShiftServiceImpl 移植 genRecords 算法（单白班/两班倒/三班倒轮换），
  基于 Java 8 时间 API（LocalDate/ChronoUnit）替代原 Date/String 方案，@Async 异步执行
- ErrorCodeConstants 追加 5 个错误码（CAL_TEAM_CODE_DUPLICATE、CAL_TEAM_MEMBER_NOT_EXISTS 等）

设计说明：
- mes_cal_team_member 去除冗余字段（user_name/nickname/telephone），通过 userId 关联查询
- mes_cal_team_shift 去除冗余字段（team_name/shift_name/calendar_type/shift_type），通过外键关联查询
- 循环依赖通过 @Lazy 注入解决

修复已有 TODO：
- MesCalPlanTeamDO：补充 @link MesCalTeamDO 关联注释
- MesCalPlanServiceImpl.confirmPlan：接入 teamShiftService.genRecords(id)
- MesCalPlanTeamController.getPlanTeamListByPlan：拼装班组编码/名称
- MesCalPlanTeamRespVO：移除待办注释

- 后端新增 PUT /mes/cal/plan/confirm 接口，仅接收 id 参数
- Service 层新增 confirmPlan(Long id) 方法，含草稿状态校验和班组数量校验
- updatePlan 中强制忽略 status 字段，禁止通过 update 修改状态
- 前端 API 新增 confirmPlan(id: number) 方法
- CalPlanForm handleConfirm 改为调用专用 confirmPlan 接口

- 新增 mes_pro_workorder、mes_pro_workorder_bom 两张表（含菜单、字典数据）
- 新增 MesProWorkorderDO/BomDO 数据对象
- 新增工单状态/类型/来源类型 3 个枚举，ErrorCode 和 DictType 常量
- 新增 Workorder/Bom 的 VO、Mapper、Service、Controller 全套 CRUD
- 创建工单时自动根据产品 BOM 生成工单 BOM 行
- 支持工单完成/取消状态流转，仅草稿状态可删除
- 去除 ktg-mes 冗余字段，varchar 枚举改 tinyint

班次作为排班计划的子资源 tab，独立导出没有意义：
1. Controller 删除 exportPlanShiftExcel 方法及相关 import
2. RespVO 删除 @ExcelProperty / @ExcelIgnoreUnannotated 注解

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

MesCalPlanTeamServiceImpl 的 create/delete 方法调用
planService.validatePlanPrepare()，确认后的排班计划禁止修改班组

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

MesCalPlanShiftServiceImpl 的 create/update/delete 方法调用
planService.validatePlanPrepare()，确认后的排班计划禁止修改班次

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

1. MesCalPlanService 新增 validatePlanPrepare 接口方法
2. MesCalPlanServiceImpl 实现 validatePlanPrepare，供子资源 Service 调用
3. updatePlan 增加已确认状态校验，阻止修改已确认的计划
4. deletePlan 改用 validatePlanPrepare 替代内联校验
5. ErrorCodeConstants 调整 CAL_PLAN_NOT_PREPARE 消息

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

1. MesDvMachineryStatusEnum 枚举值从 RUNNING/STOP/FAULT 改为 STOP(1,停机)/PRODUCING(2,生产中)/MAINTENANCE(3,维护中)
2. MesDvMachinerySaveReqVO 新增 lastMaintenTime、lastCheckTime 字段，支持新增/修改时保存点检保养时间

将 getMachinery() 中手动拼接设备类型名/车间名的逻辑，
改为复用 buildMachineryRespVOList() 的批量 Map 查询方式，消除重复代码。

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

新增 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 判断