BJ_ZTEITS-Developers / parking-cloud-yudao

将质检相关的状态枚举从 MesOrderStatusEnum 更改为 MesQcStatusEnum，确保状态管理的一致性和可维护性。更新了相关的服务和前端逻辑，以反映新的状态枚举。

新增获取到货通知单行列表的接口，支持通过通知单编号查询。调整相关数据模型，更新字段名称以提高可读性，并移除冗余字段，优化数据结构。同时，更新前端组件以支持新接口的调用和展示。

BREAKING CHANGE: 修改了到货通知单行的字段名称和接口路径

  - 标记字段设计待优化项（batchCode、warehouseId 等）
  - 标记业务逻辑待完善项（库存更新、校验逻辑等）
  - 调整代码格式

  IPQC 优化：
  - 修复 TODO AI 项：模板检索方法、tool 字段重构、删除冗余字段
  - 新增废品数量字段（工废/料废/其他废品）及验证
  - 添加检测人员和物料的存在性验证

  IQC 优化：
  - 检测人员由后端自动设置改为前端传递
  - 添加检测人员存在性验证

- 新增 MesOrderStatusEnum（草稿 0/已确认 1/审批中 2/已审批 3/已完成 4/已取消 5）
- DictTypeConstants：MES_QC_IQC_STATUS → MES_ORDER_STATUS
- IQC/IPQC/RQC ServiceImpl：import 及枚举引用更新，PREPARE → DRAFT，FINISHED 值由 1 → 4
- IQC/IPQC/RQC DO：status 字段 JavaDoc 更新，注明当前使用状态（DRAFT/FINISHED）与预留状态
- 新增 mes_qc_order_status.sql：字典数据初始化 + 存量 status=1 迁移至 status=4

1. MesQcIqcSaveReqVO: 新增 @AssertTrue 校验 qualifiedQuantity + unqualifiedQuantity == receivedQuantity
2. MesQcIqcLineDO/ServiceImpl/RespVO/Controller: toolId(Long) 改为 tool(String)，从 MesQcIndicatorDO 冗余读取，移除 MesTmToolService 依赖
3. MesWmArrivalNoticeService/Impl: 新增 validateArrivalNoticeAndLineExists 方法，校验通知单+行存在且匹配
4. MesQcIqcServiceImpl: 抽取 validateSourceDoc 私有方法校验来源单据；completeIqc 增加 checkResult 必填校验并移除重复数量校验；writeBackSourceDoc 使用 ObjectUtil.hasNull 简化判断
5. ErrorCodeConstants: 新增 QC_IQC_SOURCE_DOC_PARAMS_MISSING、QC_IQC_CHECK_RESULT_EMPTY

1. 新增 MesBizTypeConstants 集中管理业务类型常量
2. IQC sourceDocType 从 String 改 Integer，删除冗余 sourceDocCode
3. IQC checkQuantity/qualifiedQuantity/unqualifiedQuantity 从 Integer 改 BigDecimal
4. IQC 完成后回写逻辑提取为 writeBackSourceDoc()，按 sourceDocType 分发
5. IQC 完成回调从 arrivalNoticeLineService 上移至 arrivalNoticeService.approveArrivalNoticeWhenIqcComplete()
6. 到货通知单行 updateByIqcComplete() 简化为纯更新 + 校验存在
7. 到货通知单新增 approveArrivalNoticeWhenIqcComplete()，含状态校验 + 全行检验完成判断
8. 删除到货通知单 PUT /approve 控制器端点
9. 提取 initQualifiedQuantityIfNoIqc() 复用创建/更新逻辑

重构入库单相关组件，优化用户操作体验。移除不必要的审批按钮，简化执行入库流程为直接确认并调用接口。更新状态判断逻辑，确保只有待上架和待入库状态可以取消操作。调整表单展示逻辑，确保在不同模式下的字段可读性。

此变更旨在提升用户操作的直观性与效率，减少误操作的可能性。

新增获取到货通知单的精简列表接口，支持按状态筛选。更新相关状态枚举和校验逻辑，优化采购入库单的审批和取消功能，确保系统在处理入库单时的状态管理更加清晰和高效。

新增物料接收单的状态枚举，包含草稿、待质检、已完成和待入库状态。
同时更新相关的请求和响应对象，确保在物料接收流程中能够正确处理状态变更。

新增 MES 到货通知单和入库单的状态枚举类，提供更清晰的状态管理。
同时在相关服务中添加了对父单据状态的校验，确保只有在草稿状态下才能进行修改和删除操作。

此变更提升了代码的可读性和维护性，减少了硬编码的状态值使用。

…te key selection for material stock

- 新增 IPQC 过程检验单全套后端：DO、Mapper、VO、Service、Controller
- MesQcIpqcService 新增 validateIpqcExists、recalculateDefectStats 方法
- MesQcIpqcLineService 新增 validateIpqcLineExists、recalculateLineDefectStats 方法
- MesQcDefectRecordServiceImpl 扩展 IPQC 分支（校验 + 缺陷统计重算）
- MesQcIndicatorResultServiceImpl 扩展 IPQC 分支（获取 itemId）
- MesQcTemplateService 新增 getTemplateByItemIdAndType 方法，支持按产品+类型自动匹配模板
- IPQC 删除时级联清理缺陷记录
- 新增错误码 1_040_604_xxx 系列

1. Controller：合并 get + detail-template 为 get-detail 接口（id 可选），
   移除 buildIndicatorResultRespVOList（分页无需关联查询），
   精简 buildDetailItemList 只查 indicator（name/valueType/valueSpecification），
   移除 iqcService、itemService、unitMeasureService、toolService 注入，
   不支持的 qcType 抛出异常
2. RespVO：移除前端未使用的关联字段（qcCode/qcName/itemCode 等主表字段，
   indicatorCode/toolName/checkMethod 等明细字段）
3. ServiceImpl：updateIndicatorResult 改用 insertOrUpdate，
   validateIqcExists 替代手动 getIqc + null 判断
4. ErrorCodeConstants：移除未使用的错误码和兼容别名
5. 新增 IPQC 模块（Controller/Service/Mapper/VO/DO）

…，result 包重命名为 indicatorresult

1. MesQcIndicatorDO：resultType 从 String 改为 Integer（对齐 MesQcResultValueTypeEnum 枚举值 1-5），
   resultSpec 重命名为 resultSpecification（对齐 MesQcResultDetailDO.valueSpecification）
2. 同步更新 SaveReqVO、PageReqVO、RespVO 的字段类型和命名
3. MesQcResultServiceImpl：移除 Integer.valueOf() 手动转换，直接使用 Integer 类型
4. qc/result 包整体重命名为 qc/indicatorresult（controller、dal、service 共 12 个文件）

将 mes_qc_iqc_defect 重构为通用 mes_qc_defect_record 表，通过 qcType 区分 IQC/IPQC/OQC/RQC，实现多质检模块缺陷记录复用。

主要变更：
1. 新增 MesQcDefectRecordDO、Mapper、Service、Controller 及 VO
2. 删除旧 IQC 独享的缺陷表相关代码（DO/Mapper/Service/Controller/VO 共 8 个文件）
3. 更新 MesQcIqcServiceImpl，替换为通用 MesQcDefectRecordService
4. 新增错误码 QC_DEFECT_RECORD_NOT_EXISTS/LEVEL_UNKNOWN/QC_TYPE_UNSUPPORTED
5. 新增 SQL 建表脚本 mes_qc_defect_record_migration.sql 及测试数据

1. 新增 MesDvMaintenRecordStatusEnum 保养记录状态枚举（草稿/已提交）
2. 各 Service 接口暴露 validateXxxExists 公共校验方法（Machinery、CheckPlan、Subject、MaintenRecord），
   消除跨 Service 手动 null 判断 + 抛异常的重复代码
3. CheckPlanServiceImpl 改用链式调用更新状态，validateCheckPlanCodeUnique 使用 ObjUtil.notEqual

从 ktg-mes 迁移库存台账功能，支持库存列表查看、按条件搜索、冻结/解冻、导出 Excel。
去除 16 个冗余字段，仅存储 ID 关联，由 Controller 层批量拼接名称。

新增：
- SQL DDL（mes_wm_material_stock 表 + 菜单权限）
- MesWmMaterialStockDO / PageReqVO / RespVO / SaveReqVO
- MesWmMaterialStockMapper（分页 + 计数）
- MesWmMaterialStockService / ServiceImpl
- MesWmMaterialStockController（get/page/update-frozen/export-excel）
- ErrorCodeConstants 新增 3 个错误码

修改：
- MesWmWarehouseServiceImpl：删除仓库时校验库存记录
- MesWmWarehouseLocationServiceImpl：删除库区时校验库存记录
- MesWmWarehouseAreaServiceImpl：删除库位时校验库存记录

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）

- 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 方法

- 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 注释