BJ_ZTEITS-Developers / parking-cloud-yudao

新增产品收货单及行的相关数据对象、请求和响应 VO，以及对应的服务和控制器接口。实现了产品收货单的创建、更新、删除和查询功能，支持与物料、仓库等模块的关联，提升了系统的可扩展性和可维护性。

重构生产退料单的提交功能，合并确认与提交操作，简化状态流转逻辑。新增状态校验，确保只有草稿状态的退料单可提交，并根据物料质检状态自动决定目标状态（待检验或待上架）。

新增确认生产退料单的接口，更新相关字段为必填项并添加数量校验逻辑。此变更旨在提升退料单的管理效率和数据准确性。

refactor(mes): 同步供应商退货字段变更

新增生产退料单、退料单行及退料明细的请求和响应对象，完善相关的服务和映射接口，支持生产退料单的创建、更新和查询功能。

新增供应商退货单、退货单行及退货明细的数据对象和 API 接口，支持供应商退货管理功能。

新增生产入库单的相关数据结构、API 接口和服务实现，包括入库单、入库明细及其 CRUD 操作。此功能支持生产入库管理，提升仓库管理效率。

- 添加生产入库单相关的请求和响应 VO
- 实现生产入库单的服务接口
- 增加生产入库单行的 CRUD 操作
- 更新相关的数据库映射和查询逻辑

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

新增校验领料出库单数量的接口，确保每行明细数量之和等于行领料数量。此功能提升了数据一致性检查，避免了潜在的数量不匹配问题。

重命名领料出库单和明细相关的 API 方法，增强代码可读性。新增领料出库明细表单组件，支持拣货明细的添加与编辑功能。同时，调整相关组件的逻辑以适应新的 API 结构。

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

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

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

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

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

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

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

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

refactor(framework): 优化 ObjectUtils 工具类

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

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

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

- 移除用户不应填写的字段（qualifiedQuantity、iqcId 由 IQC 回调设置）
- 添加必填验证（通知单名称、是否检验）
- 添加到货数量必须大于 0 的验证

  主要变更：
  - RQC 主表添加缺陷统计字段（致命/严重/轻微缺陷数量和缺陷率）
  - 实现主表缺陷统计逻辑，对齐 IQC 实现方式
  - 删除 sourceDocCode 字段，rqcType 重命名为 type
  - RQC Line 表 tool 字段改为 String 类型（冗余存储）
  - 删除 MesQcTemplateDetailService 中未使用的方法
  - 修复 OQC Mapper 查询条件错误

  - 删除 minCheckQuantity、maxUnqualifiedQuantity、templateId(VO) 字段
  - 新增客户、物料、检测人员存在性校验
  - 新增数量关系校验：checkQuantity = qualifiedQuantity + unqualifiedQuantity
  - 模板改为后端自动匹配（产品 + 检验类型）
  - OQC 行新增 tool 字段（冗余存储）
  - MesMdClientService 新增 validateClientExists 公开方法
  - 删除分页查询中的出货日期、检测日期搜索字段

  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. 拆分 MesQcTemplateService → MesQcTemplateDetailService
   - 检测指标项、产品关联 CRUD 迁移至 DetailService
   - 新增 getRequiredTemplateByItemIdAndType 方法
2. MesQcIqcSaveReqVO 字段清理
   - 删除 templateId/minCheckQuantity/maxUnqualifiedQuantity/checkQuantity/inspectorUserId
   - 增加 qualifiedQuantity/unqualifiedQuantity @NotNull + @DecimalMin 校验
   - 增加 receiveDate/inspectDate @NotNull 校验
3. MesQcIqcServiceImpl 业务逻辑调整
   - createIqc/updateIqc 增加 inspectorUserId 参数，由 Controller 传入 getLoginUserId()
   - templateId 不再由前端传递，后端根据 itemId + IQC 类型自动查找模板
   - checkQuantity 由后端计算（= qualifiedQuantity + unqualifiedQuantity）
   - updateIqc 禁止修改 sourceDocType/sourceDocId/sourceLineId/templateId
4. MesQcIqcDO/RespVO 删除 minCheckQuantity、maxUnqualifiedQuantity 字段
5. 更新调用方：IndicatorController、ItemController、IQC/OQC/IPQC ServiceImpl

将质量管理相关的包路径从 `lqc` 更改为 `iqc`，以更好地反映其功能和结构。

将质量管理相关的包路径从 `lqc` 更改为 `iqc`，以更好地反映其功能和结构。

- 新增 MesQcPendingInspectController 待检任务分页查询接口
- 新增 MesQcPendingInspectService/Impl 聚合 IQC 待检数据（到货通知单来源）
- 新增 MesQcPendingInspectRespVO / PageReqVO
- MesWmArrivalNoticeLineMapper 新增 selectListByIqcPending 查询方法
- 搜索支持来源单据编号（模糊）、物料 ID（精确）、检验类型筛选
- 内存分页，预留 IPQC/OQC/RQC 来源扩展点

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() 复用创建/更新逻辑

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

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

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