编辑 | blame | 历史 | 原始文档

一袋一码管理模块独立(批次/赋码/托盘去关联) - 前端联调方案

⚠️ 本文档部分过时:批次已恢复品种(MDM 物料)关联,并新增产线维护模块,
批次产线由手填改为下拉选择,最新接口以 mes_pro_line_and_item_restore.md 为准。
本文档中关于赋码管理、托盘码管理、菜单结构、批次号规则以外的内容仍然有效。

本文档为变更说明,取代 mes_pro_batch_bag_code_integration.md 中涉及品种、设备、工单关联的部分。

变更背景

将**批次生产管理、赋码管理、托盘码管理**从「生产管控 → 生产管理」中提取为独立的顶级模块菜单,
模块内**除生产人员(责任人 + 生产人员配置)外,不再与其他模块(品种物料、生产设备、生产工单)产生任何关联**。

涉及页面

  • 一袋一码管理(新增顶级菜单) → 批次生产管理
  • 一袋一码管理 → 赋码管理
  • 一袋一码管理 → 托盘码管理

菜单位置变化:三个页面由「生产管控 → 生产管理」迁移至顶级目录「一袋一码管理」(路由 /bagcode/batch/bagcode/bag-code/bagcode/pallet),组件路径与权限标识均不变。

后端移除的字段

生产批次(/mes/pro/batch/*)

位置 移除字段
创建/更新请求(SaveReqVO) itemId、machineryId、workOrderId
响应(RespVO) itemId、itemCode、itemName、itemSpecification、machineryId、machineryCode、machineryName、workOrderId、workOrderCode
分页查询参数(PageReqVO) itemId、machineryId、workOrderId

保留字段:code、lineCode、lineName、produceDate、planQuantity、ownerUserId(+ ownerUserName)、bagQuantity、palletQuantity、status、remark、workers。

袋码(/mes/pro/bag-code/*)

位置 移除字段
袋码响应(RespVO) itemId、itemCode、itemName、itemSpecification
扫码追溯响应(TraceRespVO) itemId、itemCode、itemName、itemSpecification

托盘码(/mes/pro/pallet/*)

无字段变化(原本仅关联批次)。

批次号生成规则调整

项目 变更前 变更后
编码结构 前缀 PC + 日期 + 产线编码+品种编码 + 流水号 前缀 PC + 日期 + 产线编码 + 流水号
输入字符来源 lineCode + itemCode 拼接 仅 lineCode
重新生成触发条件 产线或品种变化 仅产线编码变化

批次示例:PC20260818L01001;对应袋码示例:PC20260818L01001-0001

业务规则说明

场景 规则
新增批次 手填产线编码/名称 → 选生产日期、责任人 → 配置生产人员(至少 1 人),保存后自动生成批次号
批次下拉选项 袋码/托盘生成弹窗中批次下拉仅显示批次号(不再拼接品种名称)
扫码追溯 展示袋码、批次、产线、责任人、托盘信息,不再展示品种信息
数据权限 责任人与生产人员均关联 system_users,沿用原有用户体系

注意事项

  • 数据库已删除 mes_pro_batch.item_id / machinery_id / work_order_idmes_pro_bag_code.item_id 列,旧数据无(表为空),无需迁移。
  • 前端表单、列表、搜索、详情中的品种/设备/工单字段已全部移除,批次号输入字符长度约束由「产线+品种」缩减为「产线」(建议产线编码长度 ≤ 8)。
  • 权限标识不变:mes:pro-batch:*mes:pro-bag-code:*mes:pro-pallet:*
  • 接口路径不变,仅请求/响应字段缩减,前端已完成同步改造并通过类型检查。