一袋一码模块：新增产线维护 + 批次恢复品种关联 - 前端联调方案

本文档为变更说明，取代 mes_bag_code_module_decouple.md 中"移除品种、产线手填"的部分。
袋码赋码、托盘码管理两个页面本次**无任何变化**。

功能概述

产线维护（新增页面）：维护产线主数据（编码、名称、状态、备注），供生产批次下拉选择。
批次恢复品种关联：批次重新关联 MDM 物料（品种），表单用物料选择器选择。
批次产线改为下拉选择：批次表单不再手填产线编码/名称，改为从产线维护数据中选择。
批次号规则恢复：前缀(PC) + 日期(yyyyMMdd) + 产线编码 + 品种编码 + 流水号。

涉及页面

一袋一码管理 → 产线维护（新增页面：列表 + 新增/编辑/详情弹窗）
一袋一码管理 → 批次生产管理（表单与列表改造）

菜单已初始化：产线维护菜单挂在「一袋一码管理」下第一位（路由 /bagcode/line，组件 mes/pro/line/index），按钮权限 mes:pro-line:query/create/update/delete/export。

API：产线维护（权限前缀 `mes:pro-line`）

方法	路径	说明	权限
POST	/mes/pro/line/create	创建产线	mes:pro-line:create
PUT	/mes/pro/line/update	更新产线	mes:pro-line:update
DELETE	/mes/pro/line/delete	删除产线	mes:pro-line:delete
GET	/mes/pro/line/get	产线详情	mes:pro-line:query
GET	/mes/pro/line/page	产线分页	mes:pro-line:query
GET	/mes/pro/line/simple-list	产线精简列表（仅启用，供下拉）	无（登录即可）
GET	/mes/pro/line/export-excel	导出产线 Excel	mes:pro-line:export

创建/更新请求参数（POST /create、PUT /update）

参数	类型	必填	说明
id	Long	更新时必填	编号
code	String	是	产线编码（参与批次号生成，建议 ≤ 8 位）
name	String	是	产线名称
status	Integer	是	状态（字典 common_status：0 启用/1 停用）
remark	String	否	备注

分页查询参数（GET /page）

code（模糊）、name（模糊）、status、createTime[]（创建时间范围）、pageNo/pageSize。

响应字段

字段	类型	说明
id	Long	编号
code	String	产线编码
name	String	产线名称
status	Integer	状态（字典 common_status）
remark	String	备注
createTime	String	创建时间

simple-list 返回相同结构（仅 id/code/name/remark 有值），且只包含启用状态的产线。

批次接口变更（/mes/pro/batch/*）

接口路径与权限均不变，仅请求/响应字段调整。

创建/更新请求参数变化

变化	参数	类型	必填	说明
新增	itemId	Long	是	品种（产品物料）编号，选 MDM 物料
新增	lineId	Long	是	产线编号，选产线维护数据
移除	lineCode / lineName	—	—	不再接收，由后端按 lineId 自动回填

其余参数不变：produceDate（必填）、planQuantity、ownerUserId（必填）、remark、workers（必填，至少 1 条）。

响应字段新增

字段	类型	说明
itemId	Long	品种编号
itemCode / itemName / itemSpecification	String	品种编码/名称/规格（后端拼接，展示最新主数据）
lineId	Long	产线编号

lineCode / lineName 仍返回（冗余快照，历史批次不受产线改名影响）。

分页查询参数新增

itemId（品种编号，精确）、lineId（产线编号，精确）；原 code/lineCode/lineName/ownerUserId/status/produceDate/createTime 不变。

业务流程与数据带入

先维护产线：一袋一码管理 → 产线维护 → 新增产线（编码 + 名称 + 状态启用）。
新增批次：选品种（物料选择器）→ 选产线（仅展示启用的产线）→ 选生产日期、责任人 → 配置生产人员（至少 1 人）。保存后批次号自动生成 = PC + 日期 + 产线编码 + 品种编码 + 流水号。
编辑批次：变更品种或产线会**自动重新生成批次号**；产线未变更时，即使该产线已被停用，仍可编辑其他字段。
生成袋码/托盘码：流程不变（选批次 + 数量），批次下拉仅展示批次号。

接口调用时序

时机	调用	说明
批次表单打开	GET /mes/pro/line/simple-list	产线下拉选项（仅启用）
批次表单打开	物料选择器内部查询	品种选择（现有 MdItemSelect 组件）
批次列表/详情渲染	无需额外调用	品种编码/名称/规格由后端拼接返回
产线维护页	/mes/pro/line/page、create、update、delete	常规 CRUD

字段展示规则

字段	展示位置	说明
产线编码/名称/状态/备注	产线维护列表、表单	状态用字典 common_status
品种（编码+名称）	批次列表	后端拼接字段 itemCode/itemName
品种 itemId	批次表单（物料选择器）	必填
产线 lineId	批次表单（产线下拉）	必填，仅启用产线可选
产线编码/名称	批次列表、详情	冗余快照列，只读

业务规则说明

场景	规则
产线编码/名称唯一	创建、更新时校验，重复报错
产线删除	已被生产批次引用的产线不允许删除
产线停用	停用后新批次不可选（下拉不展示），已生成的历史批次不受影响
批次号生成	前缀 PC + 日期(yyyyMMdd) + 产线编码 + 品种编码 + 流水号(3位按日循环)
批次号重新生成	编辑批次时品种或产线变化即重新生成
袋码/托盘码	规则不变（袋码 = 批次号 + "-" + 4位序号；托盘码 = 批次号 + "-P" + 2位序号）

注意事项

产线维护页面已在数据库初始化菜单，前端需新增页面文件（组件路径 mes/pro/line/index，组件名 MesProLine）。
批次表单提交体变为 { itemId, lineId, produceDate, planQuantity, ownerUserId, remark, workers }，**不要再传 lineCode/lineName**。
产线下拉务必调用 simple-list（仅启用产线），不要调用 page 接口。
品种的编码/名称/规格**不要**存入批次表单，仅传 itemId，展示以批次列表/详情接口返回的拼接字段为准。
袋码列表、托盘码列表、扫码追溯页面**不展示品种信息**（品种只关联到批次层）。
状态字典统一为 common_status（0 启用/1 停用），无需新增字典。