# 主数据与计划追溯链（对齐聚制云操作手册 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）暂不动；先把**外围主数据与追溯链**对齐手册，再调算法。