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

> ⚠️ **本文档部分过时**：批次已恢复品种（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_id`、`mes_pro_bag_code.item_id` 列，旧数据无（表为空），无需迁移。
- 前端表单、列表、搜索、详情中的品种/设备/工单字段已全部移除，批次号输入字符长度约束由「产线+品种」缩减为「产线」（建议产线编码长度 ≤ 8）。
- 权限标识不变：`mes:pro-batch:*`、`mes:pro-bag-code:*`、`mes:pro-pallet:*`。
- 接口路径不变，仅请求/响应字段缩减，前端已完成同步改造并通过类型检查。