aps-agent/docs/product/features.md

# 功能清单与实现状态

> 验收以本表「现状」列为准。  
> ✅ 已落地可演示 ｜ 🔶 半落地（引擎/模型有、无管理页或能力残缺）｜ 🔜 未做（标里程碑）  
> 原型参照来自 `aps-frontend/`，用于对照业务覆盖面，**不是**本产品必须 1:1 复刻页面。
> 每个功能点的落地规格见 [implementation-spec.md](./implementation-spec.md)。  
> 业界完整度对标见 [aps-benchmark-siemens.md](./aps-benchmark-siemens.md)（西门子 Opcenter APS 功能流程逐项覆盖度）。

---

## 0. 当前可演示能力（M0–M4 首切片）

| 能力 | 怎么用 | 代码锚点 | 落地规格 |
| --- | --- | --- | --- |
| 自然语言试排 | 「试排一版交期优先」 | `intent` → `schedule.run` → `RuleEngine` | AG-01 / SC-01 |
| 多策略沙盒对比 | 「对比几种策略」→ 选卡采用 | `scenario.compare` | SC-05 |
| 发布 / 重置 / 回滚 | 出 P2 确认卡 | `harness` + `workflow` | EX-01 / AG-02 / AG-09 |
| 三视图 | 甘特 / 负荷 / 交期 | `views` + `ViewportPanel` | EX-02 |
| 检查点时间线 | 「存个档」/ 点时间线回滚 | `checkpoints` | AG-09 |
| 知识问答 | 「换线有什么规定」/ `@知识:` | `knowledge.*` | AG-04 |
| 日报 / 版本对比 | 「生成日报」 | `reports` | AG-05 |
| 治理台 | 设置 → 门禁 / 重生 / 测试看板 | `GovConsole` | AG-02 / AG-03 |
| 项目制壳 | 项目→任务→文件（本地） | `apps/web/src/projects` | AG-08 |
| 订单管理 | 左侧轨道「订单」→ 新增/编辑/取消/完成 → P2 确认 | `domain-orders` + `OrderPanel` | OR-01 |
| 主数据维护 | 侧栏「主数据」→ 资源/物料BOM/日历维保 三页签 → P2 确认 | `domain-masterdata` + `MasterPanel` | MD-01/02/03 |
| 订单分解 MRP | 订单面板「分解建议」/「分解此单」或说「分解订单 SOxxx」 | `domain-mrp` + `OrderPanel` | OR-07 |

---

## 1. 主数据

| 功能 | 说明 | 现状 | 落地规格 |
| --- | --- | --- | --- |
| 工厂→车间→产线→工位→设备 | 通用资源树 | ✅ 首切片：树形展示 + 产线编辑/停启用（P2）；停用产线不进新排产；工位/设备维护 🔜 | MD-01 |
| 物料 / BOM / 工艺路线 | 齐套与拆单依赖 | ✅ 增强切片：物料库存编辑 + **BOM 明细用量/关键料编辑 + 工艺步骤工时/外协标记编辑**（均 P2）；版本发布 🔜 | MD-02 |
| 班次 / 日历 / 维保 | 占槽与避让 | ✅ 首切片：班次/日历只读 + 维保新增/取消（P2）联动设备避让；周模板 🔜 | MD-03 |
| Excel/CSV 导入管线 | 表头映射→校验→P2 落库 | 🔜 M4 | MD-04 |
| ERP/MES 双向集成 | 订单/物料/状态同步（对标西门子集成） | 🔜 M4/M5 | MD-05 |
| 换型矩阵主数据 | 产品族×产品族 setup 时间矩阵 | 🔜 M5（引擎仅标量 setupTime） | MD-06 |
| 二级约束资源 | 工装/模具/人员技能主数据 | 🔜 M5 | MD-07 |

---

## 2. 订单

| 功能 | 说明 | 现状 | 落地规格 |
| --- | --- | --- | --- |
| 销售订单 / 明细 | 状态过滤后进排产 | ✅ 首切片：列表+单明细新建/编辑/取消/完成；P2 确认；批量/附件后置 | OR-01 |
| 优先级进排序 | 策略键用 `priority`/`deliveryDate` | 🔶 已进引擎；权重配置 UI 🔜 M4 | OR-02 |
| 订单池 / 审核 / 变更 | 业务台账 | 🔜 M4 | OR-03 |
| 紧急插单 + 交期议定 | 快评+局部修复；due-date negotiation | 🔶 可用沙盒对比代替；专用管线 🔜 M4 | OR-04 |
| 预测 / 长周期订单 | 计划层需求输入（forecast） | 🔜 M5 | OR-05 |
| 订单钉扎溯源 | 订单-工单-物料关联（order pegging） | 🔜 M5 | OR-06 |
| **订单分解（MRP）** | 订单按 BOM/工艺展开 → 自制（排产）/ 采购建议（净需求+前置期倒排）/ 委外建议（外协工序） | ✅ 首切片：`order.decompose` P1 产 DRAFT 建议单，页面+对话双入口；建议下达转正式单 🔜 | OR-07 |

---

## 2b. 计划层（Advanced Planning，对标西门子 Opcenter Planning）

> 我方最大缺口：中长期计划层基本空白，当前只有排产参数雏形。详见 [aps-benchmark-siemens.md](./aps-benchmark-siemens.md) §3 G3。

| 功能 | 说明 | 现状 | 落地规格 |
| --- | --- | --- | --- |
| 时间分桶计划 | 日/周/月混合时段建模 | 🔜 M5 | PL-01 |
| 有限/无限产能粗评估 | 粗能力规划双模式 | 🔜 M5 | PL-02 |
| 可行性分析 | 能否按期、缺口定位（前置于排产） | 🔶 排产后可见延期，无计划层前置 | PL-03 |
| 库存投影 | make-to-stock 随时间库存曲线 | 🔜 M5 | PL-04 |
| 产能平衡/削峰 | capacity leveling | 🔶 有均衡策略，无计划层平衡视图 | PL-05 |
| 产供方向决策 | 加班/扩线/外协建议（结构化） | 🔜 M6 | PL-06 |

---

## 3. 排产引擎

| 功能 | 说明 | 现状 | 落地规格 |
| --- | --- | --- | --- |
| 规则引擎 RULE | 策略排序→选线→逐工序占槽→冲突 | ✅ M1 | SC-01 |
| 策略模板 | DELIVERY_FIRST / FIFO / CAPACITY_BALANCE / COST_FIRST / COMPREHENSIVE | ✅ | SC-02 |
| CP / GA / HYBRID | 可传类型 | 🔶 **均由 RULE 代跑并留 `engineType` 痕**；真求解 🔜 M5 | SC-03 |
| 约束注册表 + 配置中心 | plan §9.2a | 🔜 M4（引擎内嵌检测 ≠ 可配置约束库） | SC-04 |
| 多方案对比 | 沙盒并行多策略 | ✅ M2 | SC-05 |
| 主控参数 / 敏感性 | plan §9.2b / §9.9 | 🔜 M5 | SC-06 |
| 顺序相关换型优化 | sequence-dependent setup / 换型最小化 | 🔜 M5 | SC-07 |
| 批次/战役合并 | campaign / batch 合并排产 | 🔜 M5 | SC-08 |
| 物料齐套约束 | 库存/在途三态齐套 | 🔶 引擎已做 | SC-09 |
| 工装/模具约束 | 二级资源占用 | 🔜 M5 | SC-10 |
| 人员技能/班组约束 | 班组资格进排产 | 🔜 M5（已建模未进约束） | SC-11 |

**纠偏**：不要写「C1–C9 已完整产品化」。当前是规则引擎内嵌的冲突检测（缺线/缺工位/缺料/延期/产能/维保），**没有**独立约束配置 UI 与 ConstraintDef 注册表。

---

## 4. 结果与执行

| 功能 | 说明 | 现状 | 落地规格 |
| --- | --- | --- | --- |
| 草稿版本 + 发布 | DRAFT→PUBLISHED，发布 P2 | ✅ | EX-01 |
| 甘特 / 负荷 / 交期看板 | 只读投影 | ✅ | EX-02 |
| 冲突解决工作流 | 建议一键应用 | 🔜 M4 | EX-03 |
| 工单拖拽调程 | POC 有；正式版边拖边校验 | 🔜 M4 | EX-04 |
| MES 下发 | 计划下发车间 | 🔜 M4（MCP） | EX-05 |
| 资源利用率分析视图 | 利用率/负荷增强指标 | 🔶 负荷热力已有 | EX-06 |
| 方案对比表 | KPI 逐项 diff（对标 schedule comparison tables） | 🔶 有方案卡，无逐项表 | EX-07 |
| KPI 仪表盘 | 利用率/准时率/在制/延误汇总 | 🔶 视口有 KPI 卡，无独立仪表盘 | EX-08 |
| 报工回流与进度追踪 | 执行反馈闭环 | 🔜 M4 | EX-09 |

---

## 5. 对话与治理

| 功能 | 说明 | 现状 | 落地规格 |
| --- | --- | --- | --- |
| 意图两级管线 | 正则快路 → LLM JSON；可降级 | ✅ | AG-01 |
| 门禁 P0–P2 | 写主干必确认卡 | ✅（P3 外部副作用未开放） | AG-02 |
| 审计哈希链 | 可校验 | ✅ | AG-03 |
| 知识检索 | bigram + 出处；非向量 RAG | ✅ M3（向量 🔜） | AG-04 |
| 报告 | 快照模板；数字不经 LLM 改写 | ✅ | AG-05 |
| 偏好缺省策略 | 采用/试排计分 | ✅ | AG-06 |
| 主动引导 / 多模态 | — | 🔜 M4 / M6 | AG-07 |
| 项目 / 会话服务端化 | localStorage → Gateway API | 🔜 M4 | AG-08 |
| 检查点与时间线 | 成对快照 + 回滚导轨 | ✅ M2 | AG-09 |

---

## 6. 行业特化（对标西门子 Opcenter Scheduling SMT）

| 功能 | 说明 | 现状 | 落地规格 |
| --- | --- | --- | --- |
| SMT 电子特化 | 资源分配/批次/交期议定 SMT 场景 | 🔜 M6（通用模型可承载） | IND-01 |
| 行业规则包 | SOP→排产约束转译沉淀 | 🔶 知识库可存 SOP，未转约束 | IND-02 |

---

## 7. 差距清单（对标西门子后重排，按「缺口 × 频率」）

1. **计划层 AP 从零搭建**（PL-01~PL-06）——与西门子差距最大，决定中长期计划+排产全链路（M5）  
2. 多约束体系产品化（SC-04 配置中心 + SC-10 工装 / SC-11 人员 / MD-07 二级资源）（M4→M5）  
3. 换型矩阵与顺序相关优化（MD-06 + SC-07 + SC-08）（M5）  
4. 发布执行闭环（EX-05 下发 / EX-09 报工 / MD-05 ERP-MES 集成）（M4）  
5. 分析增强（EX-07 对比表 / EX-08 KPI 仪表盘 / OR-06 pegging）（M4）  
6. 需求侧（OR-05 预测 / OR-03 订单池审核）（M4→M5）  
7. 订单审核/批量/附件、主数据管理页、导入管线、拖拽调程、项目服务端化（M4）  
8. 行业特化（IND-01 SMT / IND-02 规则包）（M6）  

完整逐项对标见 [aps-benchmark-siemens.md](./aps-benchmark-siemens.md)。

维护：状态变更必须同轮改本表 + [`../CHANGELOG.md`](../CHANGELOG.md)。