aps-agent/docs/product/master-data-and-plan-chain.md

主数据与计划追溯链（对齐聚制云操作手册 V1.1）

来源：demand/聚制云工业软件-生产运营管理平台-操作手册 V1.1_20250708.pdf
抽取文本：demand/_extracted/juzhiyun_key_chapters.txt
目的：纠正当前智能体「主数据混乱、排产结果找不到依据」的结构性问题。

---

1. 聚制云怎么维护主数据（必须按依赖顺序）

手册 §4.4 主数据管理 明确：

录入数据时，需按照菜单结构依次录入，部分主数据之间存在关联关系。

标准分层（本系统应对齐）：

层	模块（手册）	内容	CRUD
A 生产模型	工厂→车间→工段→产线→工位	资源树；左侧树状图	新建/修改/删除
B 设备模型	设备、备件、设备类型	挂产线/工位	新建/修改/删除 + 树状
C 工艺模型	物料 → 产品BOM → 工序 → 工艺路线	排产真正吃的工艺输入	全量 CRUD；BOM 树展开增删改；路线「去配置」拖拽工序
D 人力资源	班次等	日历约束	CRUD

工艺模型关键点（手册 §4.4.5）：

1. 物料管理：成品 / 半成品 / 原材料 全量列表，支持新建、修改、删除、一键复制
2. 产品 BOM：树形展开；行级修改/新增/删除；一键复制整棵 BOM
3. 工序管理：独立工序库，路线从中取用
4. 工艺路线：新建后「去配置」——把工序拖成流程图，再填每步明细；可审核、查看、删除

录入顺序铁律：先工厂/产线 → 再物料 → 再 BOM → 再工序 → 再工艺路线 → 再产线-产品绑定。缺一环，后面排产必然失败或结果“找不到依据”。

---

2. 聚制云计划链（订单怎么排、负荷/库存在哪）

手册 §4.9 计划管理：

销售订单(SO)
   ├─→ 生产订单(PO)  ──→ 生产工单(WO) ──→ 备料 / 执行 / 报工入库
   ├─→ 采购订单       ──→ 采购执行 / 入库 → 库存台账
   └─→ 外协订单       ──→ 外协执行

关键规则（手册原文要点）：

1. 排产前：必须先做「产线产品配置」（产品↔产线多对多绑定），否则不能排。
2. 订单排产：选中订单点「排产」；成功则进生产订单管理看排产日历 + 工单；失败则提示失败环节和缺失项。
3. 工单可追溯：双击工单可看关联的销售订单、生产订单、产品要求；可「查看产品 BOM」。
4. 生产订单可下钻：工单列表、排产日历。
5. 库存：仓库「库存台账 / 库存查询」独立维护；备料、齐套开工依赖库存。

即：排产不是甩一张甘特图，而是写出具名单据链，每张单都能回指上游主数据（BOM/路线/库存/产线负荷）。

---

3. 当前智能体的缺口（为什么“混乱、找不到依据”）

维度	现状	手册要求	后果
主数据分层	一个「主数据」面板塞资源+物料库存编辑+步骤工时改，不能新建物料/工序/整条路线	工艺模型独立全 CRUD	看起来有主数据，实际养不活排产
工艺路线	只能改已有步骤的工时/外协标记	新建路线 + 去配置拖工序 + 审核	工艺依据残缺
订单链	SO / MRP 建议 / 排产版本 / 工单分散在聊天块与固定甘特	SO→PO→WO→采购/外协可点开关联	排完找不到“凭什么这么排”
库存	物料表有 stock 字段，齐套只在引擎内算冲突	库存台账可查；排产/备料显式引用	用户不知道有没有扣库存、缺什么料
负荷	负荷热力只看固定产线占用	排产结果应对应到产线/设备占用	柔性结果与主数据面板脱节
双轨	固定产线 RuleEngine vs 柔性 PoolEngine 两套种子	手册是一套单据链	商务订单分解与柔性排产对不上

---

4. 本系统目标追溯模型（固定产线主链）

对任一销售订单 orderNo，plan.trace 必须一次给出：

1. 订单本体：客户、交期、产品、数量、状态
2. 主数据依据：默认 BOM 版本 + 明细（用量、关键料、当前库存/在途、净缺口）；默认工艺路线 + 步骤（准备/单件/是否外协）
3. 分解结果：自制说明、采购建议（含建议下单日）、委外建议及其状态（DRAFT/RELEASED）
4. 排产结果（若已有最新版本）：关联生产订单 PO、工单 WO（工序、产线、工位、起止）、该订单对产线负荷贡献（分钟）、齐套/缺料冲突
5. 缺失项：无 BOM / 无路线 / 未绑定产线 / 库存不足 —— 对齐手册“排产失败提示缺失项”

柔性轨（康尼场景）另走 flex* 追溯：FO → flexBom/flexRouting → flexVirtualLine → flexWorkOrders → 设备负荷；与固定轨并存，但界面上必须标明当前走哪条链，禁止混谈。

---

5. 落地优先级

1. P0：plan.trace API + 订单面板「追溯」页 + 分解/试排后聊天块挂证据
2. P0：知识库补种「主数据录入顺序」「工艺路线配置」「订单排产与齐套/负荷」
3. P1：工艺模型 UI 按手册拆页签（物料 / BOM / 工序 / 工艺路线），补齐新建删除
4. P1：产线-产品绑定校验（排产前检查，失败给缺失项）
5. P2：库存台账视图；批量导入模板对齐手册导入导出

核心算法（RuleEngine / PoolEngine）暂不动；先把外围主数据与追溯链对齐手册，再调算法。