BJ_ZTEITS-Developers / parking-cloud-yudao

新增物料在工单 BOM 中的校验逻辑，确保领料单行的物料有效性，避免错误领料。

新增生产领料出库单的状态管理、行验证及明细查询功能，优化了相关数据模型和接口，提升了系统的可用性和用户体验。

新增领料出库单行和明细的创建、更新、删除及查询接口，优化了数据模型和请求响应结构，提升了系统的可维护性和扩展性。

新增生产领料出库单的相关数据模型、接口及前端组件，支持领料单的创建、编辑和完成操作。优化了数据校验逻辑，并添加了物料、库存和工单选择器，提升用户体验。

- 实现领料单的基本 CRUD 操作
- 增加物料和库存选择功能
- 优化前端表单布局与交互

新增 MES 领料出库单及其行的响应和请求 VO，包含必要的字段和注释。
同时实现了相关的控制器和服务接口，支持创建、更新、删除和查询领料出库单的功能。

此功能将提升领料出库单的管理效率，便于后续的业务逻辑实现。

重构采购入库单和领料申请单状态枚举，统一使用 MesOrderStatusConstants 中的常量，提升代码可维护性和一致性。

将质检相关的状态枚举从 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：删除库位时校验库存记录