# 一道工序多产出(联产品)设计与改造方案 > 状态:待确认,确认后再实施 > 日期:2026-11-07 ## 1. 背景 一键排产预览时,工单 `WO_202611070001` 在工序「铁芯叠装」被拦截: ``` 工序铁芯叠装对应多个产出,请手工排产确认各产出数量 ``` 来源:`MesProBatchScheduleService.java:252-260`。当前排产模型是「一道工序 = 一个任务 = 一个产出物料」,检测到工序产出多于一个时直接抛错。 但工艺路线本身允许一道工序配置多个产出(`mes_pro_route_process_output`),工单工序快照也保存了多个产出(`mes_pro_work_order_process.output_item_id`,逗号分隔)。下游的任务、报工、生产产出单又都是单物料模型,因此多产出目前处于「能配、不能排、不能正确流转」的状态。 同时排查发现几个关联问题: | 位置 | 现状问题 | |------|----------| | `MesProBatchScheduleService` | 多产出直接拒绝,无法批量排产 | | `schedule-form.vue:128` | 排产时把 `outputItemId`(逗号串)直接当 `itemId` 传给任务,多产出时会传非法值 | | `MesProTaskServiceImpl.resolveTaskItemId` | 取第一个产出,顺序不确定 | | `MesWmProductProduceServiceImpl` | 一个报工只生成一个物料的产出行 | | `MesProWorkOrderBomController.buildWorkOrderItems` | 产出→工序投料映射只取 CSV 第一个产出 | | `mes_pro_route_process_output` | 存量存在重复行(route_process 126/127/128/129 共 4 组) | ## 2. 业务定义(已确认) 1. **同一次加工同时产出多个物料**(联产品/副产品),不是同一工序分别生产。 2. 各产出数量由**工艺路线工序产出配置中的固定配比**决定,以主产出为基准 `1`: - 主产出:每加工 1 个主产出; - 其它产出:每加工 1 个主产出附带的数量(如 `2` 表示 1 个主产出同时产出 2 个单位)。 3. 排产、报工、工单进度、报工扣料都以**主产出数量**为准;其它产出按配比自动换算。 4. 一个工序仍然**只生成一个生产任务、只报一次工**,产出单按产出物料拆成多行。 ## 3. 总体方案 ``` 工艺路线工序 └── 产出配置(itemId, 配比 quantity, 主产出 mainFlag) │ ▼ 工单工序快照(output_item_id 逗号串,主产出排第一位) │ ▼ 生产任务(一条,itemId = 主产出,quantity = 主产出数量) │ ▼ 报工(一次,feedback.itemId = 主产出) │ ▼ 生产产出单(一个单头,每个产出一行 line + 一条 detail) │ ▼ 产品入库单(一个单头,每行一个产出) ``` 核心原则:**不新增任务维度、不改报工模型**,只在产出单生成时按配比展开多行。这样排产工时、报工扣料、工单已生产数量的计算都不受影响。 ## 4. 数据模型 ### 4.1 `mes_pro_route_process_output` 增加字段 ```sql ALTER TABLE mes_pro_route_process_output ADD COLUMN quantity DECIMAL(18,6) NOT NULL DEFAULT 1.000000 COMMENT '配比:每1个主产出的附带数量,主产出固定为1' AFTER item_id; ALTER TABLE mes_pro_route_process_output ADD COLUMN main_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否主产出:1是 0否' AFTER quantity; ``` 说明: - 主产出的 `quantity` 固定为 1,由服务端强制;其它产出必须 > 0。 - 同一道工序(同一归属产品分组内)最多一个 `main_flag = 1`;服务层校验,不做数据库唯一索引(`product_id` 允许为 NULL,唯一索引无法约束)。 - 工序产出候选集仍按 `product_id IS NULL OR product_id = 当前产品` 过滤;若过滤后没有主产出,运行时回退取排序第一条。 ### 4.2 工单工序快照 `mes_pro_work_order_process.output_item_id` 继续使用逗号串,**只调整顺序:主产出排第一位**,其余按 sort 排序。 原因:现有任务创建、BOM 展开、前端展示都有取「第一个」的兜底逻辑,保持第一位是主产出可以最小化改动。 配比不快照到工单,生成产出单时按 `(routeId, processId, productId, itemId)` 回查路线配置;查不到时默认 1。 > 边界:路线启用后不允许编辑;停用→修改→再启用时,历史工单的配比会跟随路线变化。如需冻结,后续可增加工单工序产出快照表,本方案暂不引入。 ### 4.3 存量数据清理 ```sql -- 1) 删除重复产出归属行,保留每组最小 id DELETE o1 FROM mes_pro_route_process_output o1 JOIN mes_pro_route_process_output o2 ON o1.route_process_id = o2.route_process_id AND o1.item_id = o2.item_id AND (o1.product_id = o2.product_id OR (o1.product_id IS NULL AND o2.product_id IS NULL)) AND o1.id > o2.id; -- 2) 每道工序回填一个主产出(排序最小、同序取 id 最小) UPDATE mes_pro_route_process_output o JOIN ( SELECT route_process_id, MIN(id) AS keep_id FROM ( SELECT route_process_id, id, ROW_NUMBER() OVER (PARTITION BY route_process_id ORDER BY sort IS NULL, sort, id) AS rn FROM mes_pro_route_process_output ) t WHERE rn = 1 GROUP BY route_process_id ) m ON m.keep_id = o.id SET o.main_flag = 1; ``` > 注:如果某道工序按不同归属产品配置了不同产出,主产出按全局取一条;运行时若当前产品过滤后不含该行,回退取排序第一条。 ## 5. 后端改造清单 | 文件 | 改动 | |------|------| | `MesProRouteProcessOutputDO` | 增加 `quantity`、`mainFlag` 字段 | | `MesProRouteProcessSaveReqVO.OutputItem` | 增加 `quantity`、`mainFlag`;保存时校验主产出唯一、配比 > 0 | | `MesProRouteProcessOutputVO` / `RespVO` | 响应增加 `quantity`、`mainFlag` | | `MesProRouteProcessServiceImpl` | 保存配比/主产出;`resolveOutputItemId` 按「主产出优先 + sort」拼接;`getOutputItemIdsByRouteProcessId` 返回顺序主产出优先;新增 `getProcessOutputs(routeProcessId, productId)` 返回 `itemId + ratio + mainFlag` | | `MesProWorkOrderProcessServiceImpl.getProcessListByProductId` | 已走 `getRouteProcessListByProductId`,保证 CSV 主产出在首位 | | `MesProBatchScheduleService` | 删除「多个产出」抛错;任务物料取主产出;预览增加 warning「工序 X 含 N 个联产出,按主产出排产」 | | `MesProTaskServiceImpl.resolveTaskItemId` | 取主产出(依赖上面的排序保证取第一个即主产出) | | `MesWmProductProduceServiceImpl.generateProductProduce` | 按产出列表生成多行:每行 `itemId` = 产出物料,`quantity` = 报工数量 × 配比;批次按各自物料生成 | | `MesWmProductProduceServiceImpl.splitPendingAndFinishProduce` | IPQC 完成时,除源行外按同一合格率拆分同产出单内其它待检行 | | `MesProWorkOrderBomController.buildWorkOrderItems` | 产出→工序投料映射覆盖全部产出;联产出按「轮次 = max(需求量 / 每轮产出量)」只展开一次,避免重复计算 | | `MesProFeedbackServiceImpl` | 不变(报工物料仍为主产出);如需在报工单展示联产出,仅做只读展示 | | `MesWmItemConsumeServiceImpl` | 不变(一次报工按工序 BOM × 报工数量扣一次料,天然正确) | | `MesWmProductReceiptServiceImpl` | 不变(产出单多行 → 入库单多行,现有逻辑已支持) | | `ErrorCodeConstants` | 新增:`PRO_ROUTE_PROCESS_OUTPUT_MAIN_REQUIRED`(1_040_501_104)、`PRO_ROUTE_PROCESS_OUTPUT_RATIO_INVALID`(_105)、`PRO_ROUTE_PROCESS_OUTPUT_MAIN_DUPLICATE`(_106) | ## 6. 核心算法 ### 6.1 数量换算 ``` 主产出:qty_main = feedbackQuantity 其它产出 i:qty_i = feedbackQuantity × ratio_i ``` - 配比允许小数(如 0.5 kg / 1 个),保留 6 位。 - 不做强制取整;如需按物料计量单位取整,后续在产出生成处补充。 ### 6.2 批量排产 1. 工序目标数量 `targetQuantity` 仍按收率倒推(主产出口径)。 2. 解析该工序主产出物料:优先取 `main_flag = 1` 且归属当前产品的产出;没有则取排序第一条。 3. 任务数量 = `targetQuantity - 已排任务数量`,任务物料 = 主产出。 4. 不再因为存在其它产出而报错;其它产出不生成任务。 5. 预览结果对多产出工序追加一条非阻断 warning 提示。 ### 6.3 报工 → 产出单 `generateProductProduce` 内: 1. 解析产出列表:工单工序快照的 `output_item_id`(顺序即主产出优先)∩ 路线配比配置;缺失配比按 1。 2. 无检验:每个产出按「合格数 / 不合格数」各生成一行(沿用现有拆分规则),数量各自乘配比。 3. 需要检验:每个产出生成一条「待检验」行,等待 IPQC。 4. 批次号按各产出物料分别生成(沿用 `getOrGenerateBatchCode`)。 5. 明细行的仓库沿用 `resolveOutputTarget(workOrderId, processId, itemId, feedbackId)`: - 工单工序配置了仓库 → 所有产出行都用该仓库; - 否则按产出物料查路线产品仓库; - 末道工序仍要求实际仓库,中间工序仍可落虚拟线边库。 ### 6.4 IPQC - 检验仍以主产出待检行为源行(IPQC 单与报工单一一对应)。 - 检验完成时,按主产出行的 `合格数 / 待检数量` 得到合格率 `r`,对同产出单内其它待检行执行: - `合格_i = 行数量 × r`(保留 6 位); - `不合格_i = 行数量 - 合格_i`。 - 行数量为 0 的产出不生成产出单行。 ### 6.5 物料需求展开 `buildWorkOrderItems` 调整: 1. 每个产出物料都建立「产出 → 本工序投料配方」映射(不再只取第一个)。 2. 逐层展开时,对属于同一工序的多个产出先按轮次归并: ``` runs = max(各产出需求量 / 该产出每轮产出量) 每轮产出量:主产出 = 1,其它产出 = ratio ``` 用 `runs` 展开一次该工序投料,避免同工序产出分别展开导致物料重复。 3. 只有一个产出的工序保持现有逻辑不变。 ## 7. 前端改造清单 | 页面 / 文件 | 改动 | |-------------|------| | `pro/route/components/output-attribution.vue` | 每行增加「配比」InputNumber(默认 1、最小 0.000001)、「主产出」Radio;切换主产出时自动把上一行主产出取消 | | `pro/route/data.ts` 工序列表 | 「本工序产出」列展示 `名称 × 配比`,主产出加标记 | | 工单创建/编辑 → 工序与产出 | 展示联产出及配比(只读) | | `pro/task/modules/schedule-form.vue` | 修复 `item-id` 传入:取工单工序输出的第一个 id(主产出),不要直接传逗号串 | | 排产预览弹窗 | 多产出工序显示提示文案(非阻断) | | 生产产出单 / 产品入库单 | 现有列表按行展示,无需新页面;确认多行正常显示,来源列仍按产出单展示 | ## 8. 兼容性与边界 | 场景 | 处理 | |------|------| | 存量工单缺少主产出标记 | 运行时取排序第一条作为主产出 | | 存量工单快照 CSV 顺序与路线不一致 | 以快照 CSV 第一条为主产出,配比按物料回查路线 | | 副产出在路线产品上没有仓库配置 | 优先用工单工序仓库;中间工序回退虚拟线边库;末道工序仍要求实际仓库(与现有校验一致) | | 报工只报主产出数量 | 副产出数量由配比推导,不允许单独修改(避免与主产出脱节) | | 工序只有一个产出 | 全部逻辑退化为现有行为 | | 同一工序已有历史任务(多任务) | 不自动合并;新排产仍按「已有任务数量合计」计算剩余量 | | 产出归属重复行 | 由迁移脚本清理;服务层保存时按 `productId + itemId` 去重(已有逻辑) | ## 9. 迁移脚本 目录:`scripts/process-multi-output-20261107/` - `01_ddl.sql`:加 `quantity`、`main_flag` 列 - `02_cleanup.sql`:清理重复产出行 + 回填主产出 脚本不包含 `tenant_id`(本项目不使用多租户)。 ## 10. 验收清单 1. 工艺路线「铁芯叠装」配置 2 个产出,其中 1 个主产出、配比分别为 1 / 2,保存成功;配置两个主产出时被拦截。 2. 新建工单并生成工序,快照 `output_item_id` 主产出在第一位。 3. 一键排产预览通过,生成 1 个任务,物料为主产出,数量 = 工单数量。 4. 报工 100,产出单生成 2 行:主产出 100、副产出 200(配比 2)。 5. 产品入库单生成 2 行,数量和仓库正确。 6. 开启 IPQC:检验主产出合格 90/100,产出单两行按 90% 拆分(90/10、180/20)。 7. 工单已生产数量只增加 100,不重复累加。 8. 报工自动扣料:按工序 BOM × 100 扣一次,不因多产出重复扣料。 9. 物料需求展开不重复计算该工序投料。 10. 存量单产出工序功能回归正常。 ## 11. 实施顺序 1. DDL + DO/VO + 路线保存/读取(含主产出、配比、排序) 2. 数据清理脚本 + 存量回填 3. 排产解锁(`MesProBatchScheduleService`、前端 schedule-form 修复) 4. 报工产出单多行 + IPQC 拆分 5. 入库回归 6. 物料需求展开联产出归并 7. 前端产出配置、列表展示、提示 ## 12. 待确认 1. 联产出的质检是否全部跟随主产出合格率(本方案默认跟随)。 2. 报工界面是否需要展示联产出明细(本方案默认只展示主产出,产出单里体现)。 3. 配比是否允许按工单覆盖(本方案默认只在工艺路线维护,工单只读)。