# 生产日结与材料闭环设计 ## 背景 真实生产不是一次领料后必须按参考生产数量一次性全部做完。常见场景是：今天领料生产一部分，下班前把已完成成品入成品库，把剩余原材料还回原材料库，第二天再次领料或继续生产。现有逻辑偏向“参考生产数量未做完则生产出库任务未结束”，会让 DAG 看起来像领料一直悬挂，无法表达阶段性生产和阶段性结算。 本设计目标是把生产出库从“一次性完工工单”改造为“可多次日结的生产任务”，用材料去向闭环替代计划数量闭环。 ## 核心业务原则 1. 生产出库代表一次领料任务，不代表必须一次性完成全部参考生产数量。 2. 每次生产结束可以做一次“生产日结”，记录本次报工、成品入库、余料归还、废料/报废和差异原因。 3. 任务是否结束，不再只看 `完工数 >= 参考生产数量`，而是看领出的材料是否已经有明确去向。 4. 成品入库、生产余料入库、生产废料入库都要能挂到同一次生产日结下。 5. DAG 要展示“领料任务 -> 多次生产日结 -> 各类入库/报废 -> 任务结清”的真实链路。 ## 新增概念 ### 生产出库任务 沿用现有生产出库/工单主体，语义调整为“领料任务”。它记录： - 生产跟踪号 - 产品 - 领用原材料库存批次 - 领用重量 - 参考生产数量 - 当前材料闭环状态 参考生产数量仍保留，但只作为参考值，不再是唯一闭环标准。 ### 生产日结单 新增一个业务对象，建议表名为 `pp_production_settlement`，用于记录某个生产出库任务的一次阶段性结算。 建议字段： - `settlement_no`：日结单号 - `work_order_id`：生产出库任务 ID - `settlement_date`：结算日期 - `reported_qty`：本次报工数量 - `finished_qty`：本次合格成品数量 - `scrap_qty`：本次报废数量 - `standard_consumed_weight_kg`：标准消耗重量 - `expected_surplus_weight_kg`：标准应归还余料重量 - `actual_surplus_weight_kg`：实际余料归还重量 - `site_carryover_weight_kg`：现场留存重量，用于记录当天不还仓、继续留在生产现场的材料重量 - `scrap_weight_kg`：废料或报废折算重量 - `variance_weight_kg`：差异重量 - `variance_rate`：差异率 - `variance_reason`：偏差原因 - `status`：草稿、已确认、异常确认、已撤销 标准消耗公式： ```text 标准消耗重量 = 本次报工数量 × 产品毛重 ``` 标准应归还余料： ```text 标准应归还余料 = 结算前未闭环现场余额 - 标准消耗重量 - 废料/报废折算重量 - 现场留存重量 ``` 偏差率： ```text 偏差率 = abs(实际余料归还重量 - 标准应归还余料) / 标准应归还余料 ``` 当标准应归还余料为 0 时，使用差异重量是否为 0 判断；如存在差异，要求填写原因。 ## 状态规则 生产出库任务建议状态： - `已领料`：已经完成生产出库，还没有日结。 - `生产中`：已有小程序报工或工序进度，但尚未结算。 - `部分结算`：至少存在一张已确认生产日结单，但材料尚未全部闭环。 - `待结清`：理论上仍有未处理材料、未入库成品或未解释差异。 - `已结清`：领料重量已经通过成品、余料、废料、允许损耗和差异原因完成闭环。 - `异常结清`：偏差超过阈值，用户填写原因后确认结清。 偏差阈值默认使用 10%。超过 10% 时，必须填写偏差原因才能确认日结。 ## 材料闭环判断 一个生产出库任务的材料闭环按重量判断： ```text 领料总重量 = 已结算标准消耗重量 + 已归还余料重量 + 已入废料/报废重量 + 允许损耗重量 + 已解释差异重量 + 未结清现场余额 ``` 系统展示时要明确区分： - 已生产消耗 - 已余料归还 - 已报废/废料入库 - 已解释差异 - 未结清现场余额 只有未结清现场余额为 0，且所有超过阈值的差异都有原因时，任务才能进入已结清或异常结清。 如果用户当天不把剩余材料全部还仓，而是留在现场第二天继续生产，则在生产日结中填写“现场留存重量”。这部分重量不会形成余料入库流水，也不会让任务结清；它会作为下一次生产日结的结算前未闭环现场余额。 ## 出入库联动 ### 成品入库 成品入库从生产日结单发起或关联生产日结单。每张生产日结单可以对应一张或多张成品入库记录，但推荐前端默认合并为一次成品入库操作。 成品批次要记录： - 生产出库任务 - 生产日结单 - 原材料库存批次来源 - 入库数量 - 入库重量 - 入库材料成本 ### 生产余料入库 生产余料入库必须关联生产日结单和来源库存批次。归还逻辑仍然是回到原库存批次，不新建库存批次。 页面展示： - 来源库存批次号，多选 - 每个来源库存批次的归还重量 - 标准应归还重量 - 实际归还重量 - 现场留存重量 - 偏差率 - 超过 10% 时填写原因 ### 生产废料入库 生产废料入库可以关联生产日结单。用于记录边角料、废料和报废折算进入废料库。 如果废料入库重量来自报废数量折算，系统应显示计算依据；如果用户直接称重录入，则以称重为准。 ## DAG 展示设计 DAG 从当前“生产出库后直接挂工序、报工、成品入库”调整为分层展示： ```mermaid flowchart LR A["原材料库存批次"] --> B["生产出库任务"] B --> C1["生产日结 2026-06-02"] B --> C2["生产日结 2026-06-03"] C1 --> D1["成品入库"] C1 --> E1["生产余料入库"] C1 --> F1["生产废料入库"] C2 --> D2["成品入库"] C2 --> E2["生产余料入库"] C2 --> F2["生产废料入库"] B --> G["任务结清状态"] ``` 节点层级： - Level 0：原材料库存批次 - Level 1：生产出库任务 - Level 2：生产日结单 - Level 3：工序报工汇总、成品入库、余料入库、废料入库 - Level 4：销售出库或后续追溯节点 DAG 节点指标： - 生产出库任务节点：领料重量、参考生产数量、累计日结数量、未结清现场余额、状态。 - 生产日结节点：本次报工、合格品、报废、标准消耗、标准余料、实际余料、偏差率。 - 未结清现场余额节点或指标：展示仍留在现场、尚未还仓或尚未解释去向的材料重量。 - 成品入库节点：入库数量、来源库存批次、材料成本。 - 余料入库节点：归还库存批次、归还重量、偏差说明。 - 废料入库节点：废料重量、来源日结、处理状态。 DAG 视觉规则： - 未结清任务用黄色状态。 - 偏差超过阈值且未写原因用红色状态。 - 已结清任务用绿色状态。 - 生产日结节点按日期从上到下排列。 - 点击生产出库任务时，高亮所有关联日结和出入库链路。 - 点击某个生产日结时，只高亮该日结对应的成品、余料和废料链路。 ## 前端交互 ### 生产出库列表 新增或调整列： - 生产跟踪号 - 产品 - 领料重量 - 参考生产数量 - 累计报工数量 - 累计成品入库 - 累计余料归还 - 未结清现场余额 - 状态 操作： - 查看 DAG - 新增生产日结 - 查看日结记录 - 结清任务 ### 新增生产日结抽屉 用户选择生产出库任务后，系统自动带出： - 产品 - 产品毛重 - 领料来源库存批次 - 当前未结清重量 - 小程序报工汇总 - 可入库成品数量 用户填写或确认： - 本次报工数量 - 本次成品入库数量 - 本次报废数量 - 本次余料归还重量 - 本次现场留存重量 - 本次废料入库重量 - 偏差原因 系统实时计算： - 标准消耗重量 - 标准应归还重量 - 结算后未结清现场余额 - 实际归还偏差 - 偏差率 - 是否必须填写原因 ## 后端接口 建议新增接口： - `GET /production/work-orders/{id}/settlement-preview` - `POST /production/work-orders/{id}/settlements` - `GET /production/work-orders/{id}/settlements` - `POST /production/settlements/{id}/confirm` - `POST /production/work-orders/{id}/close` 现有接口调整： - 成品入库接口支持传入 `settlement_id`。 - 生产余料入库接口支持传入 `settlement_id`。 - 生产废料入库接口支持传入 `settlement_id`。 - DAG 生命周期接口返回生产日结节点和日结关联的入库/报废节点。 ## 数据迁移 已有历史生产出库可以不强制补日结单。迁移策略： - 已完工且已有成品入库的生产出库，DAG 可继续按旧链路展示。 - 新增生产日结功能上线后，新生产出库默认走日结链路。 - 对历史未完成生产出库，可允许用户手工创建一张“历史补录日结单”进行结清。 ## 测试要点 后端测试： - 领料 200kg，报工 200 件，毛重 0.6kg，标准应归还 80kg。 - 偏差不超过 10% 时允许确认日结。 - 偏差超过 10% 且无原因时禁止确认。 - 多次日结累计后，未结清现场余额正确减少。 - 成品入库、余料入库、废料入库均能关联同一日结单。 - 任务结清不再依赖 `完工数 >= 参考生产数量`。 前端测试： - 生产日结抽屉实时计算标准余料和偏差率。 - 超过 10% 时偏差原因必填。 - DAG 展示生产日结节点和多条出入库链路。 - 点击生产出库任务和点击日结节点的高亮范围不同。 ## 非目标 本次设计不引入复杂 APS 排产，不管理员工排班，不强制要求每道工序都每日结算。小程序报工仍作为生产数量和报废数量来源，ERP 负责生产日结和库存闭环。