一袋一码生产逻辑改造 - 前端联调方案

配套需求方案：docs/mes_bag_code_package_refactor_requirements.md。本方案覆盖接口变更与页面数据带入，前端主体改动已随本次改造同步完成，供联调回归使用。

涉及页面

• 赋码管理（袋码）：生成数据包弹窗、生成原始袋码弹窗、袋码列表、录入批次、绑定托盘、追溯弹窗
• 生产批次：新增/编辑/补录表单（新增「绑定托盘」多选）、列表、搜索区
• 托盘管理：预生成弹窗、列表、绑定批次弹窗
• 公共 H5 溯源页、扫码追溯弹窗（回归）

业务流程与数据带入

1. 生成数据包：选品种 → 前端按品种主计量单位类型联动（查 /mdm/item/get 取 unitMeasureId，再查 /mdm/unit/get?id= 取 type）：

• 48千克/100千克 → 输入**托盘数**，预览「每托 N 袋 × 托盘数 = 袋码数」
• 吨 → 输入**袋码数**（无托盘）
• 类型未配置 → 提示前往「计量单位」维护，提交时后端也会兜底报错

1. 生成结果：同一 uuid 袋码组 + 自动生成的临时托盘（PL-序号），袋码已带品种、已绑托盘。
2. 录入批次：勾选袋码 → 选生产批次。后端级联：临时托盘升正式码（批次号-P序号）并绑批次、回写袋码冗余托盘码。混品种会被拦截。
3. 批次不再录入/展示品种；品种信息全部由袋码数据包携带。
4. 新增/补录/编辑批次时均可选「绑定托盘」（多选、非必填，数据源 GET /mes/pro/pallet/unbound-list，展示临时托盘码+已装袋数）：勾选后批次状态直接为**生产中**，后端同事务复用托盘绑定批次逻辑（托盘升正式码、托盘下袋码级联录入），任一校验失败整体回滚；编辑时仅需勾选本次新增的托盘（已绑定托盘不在下拉中、不可解绑）。

API

生成数据包请求参数：

生成数据包响应示例：

{
  "code": 0,
  "data": {
    "uuid": "生成组UUID",
    "type": "48千克",
    "perPallet": 48,
    "totalCount": 96,
    "palletIds": [101, 102]
  }
}

字段展示规则

业务规则说明

注意事项

• generate 旧参数 count 已废弃，只传 palletCount 或 bagCount（按品种类型二选一）。
• 批次 itemId 相关字段已从接口移除，勿再引用（批次追溯视图 get-by-code 的品种字段保留，可能为空=新批次）。
• 托盘追溯视图（PalletTrace/qr-trace-modal）仍返回 capacity 供历史数据展示，新托盘为空。
• 老数据（历史空白袋码）品种为空属正常，追溯走批次回退。
• palletIds 在 create/update/fill-info 均生效；下拉每次打开弹窗重新拉取 unbound-list，若提交时所选托盘已被他人绑定，后端整体报错回滚（本次批次操作不生效），提示用户刷新重试。
• 袋码分页（/page）后端已改为**创建时间倒序**（同秒内按编号倒序），前端无需再传排序参数；导出 Excel 同口径。
• 原始袋码与数据包袋码同表同规则（uuid 成组、可整组删除），列表页通过生成组 UUID 区分来源。
• 列表搜索区新增「品种」条件（复用 MdmItemSelect，可清空），传 itemId 等值过滤；导出 Excel 携带同一查询条件同口径生效。历史空白袋码品种为空，按品种筛选不会命中。