aps-agent/docs/product/features.md

23 KiB
Raw Permalink Blame History

功能清单与实现状态

验收以本表「现状」列为准。
✅ 已落地可演示 | 🔶 半落地(引擎/模型有、无管理页或能力残缺)| 🔜 未做(标里程碑)
原型参照来自 aps-frontend/,用于对照业务覆盖面,不是本产品必须 1:1 复刻页面。 每个功能点的落地规格见 implementation-spec.md。
业界完整度对标见 aps-benchmark-siemens.md(西门子 Opcenter APS 功能流程逐项覆盖度)。
真实客户需求吸收见 demand-kangni-wuhu.md(demand/ 康尼芜湖柔性排产案 + 排产逻辑 PPT)。


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
柔性排产(能力池+虚拟产线) POST /api/flex/schedule(ASC/DESC/BOTTLENECK);GET /api/flex/world 看虚拟产线 engines-pool + domain-flex MD-08/09 · SC-13/14 · PL-07/08

1. 主数据

功能 说明 现状 落地规格
工厂→车间→产线→工位→设备 通用资源树 ✅ 首切片:树形展示 + 产线编辑/停启用(P2);停用产线不进新排产;工位/设备维护 🔜 MD-01
物料 / BOM / 工艺路线 齐套与拆单依赖 ✅ 增强切片:物料库存编辑 + BOM 明细用量/关键料编辑 + 工艺步骤工时/外协标记编辑(均 P2);版本发布 🔜 MD-02
班次 / 日历 / 维保 占槽与避让 ✅ 首切片:班次/日历只读 + 维保新增/取消(P2)联动设备避让;周模板 🔜 MD-03
Excel/CSV 导入管线 表头映射→校验→P2 落库 ✅ 首切片:POST /api/import/preview + import.commit P2;支持订单/物料/BOM/路线/设备/模具/工序/区域;主数据与订单面板入口 MD-04
ERP/MES 双向集成 订单/物料/状态同步(对标西门子集成) ✅ 首切片:Mock SAP 入站拉单+库存、出站开完工幂等回写;P2 确认;真实 RFC/OData 🔜 MD-05
换型矩阵主数据 产品族×产品族 setup 时间矩阵 ✅ 首切片:changeoverMatrix + 物料 productFamily;RuleEngine 同线跨族叠加;主数据「换型」;口令「查看换型矩阵」 MD-06
二级约束资源 工装/模具/人员技能主数据 ✅ 模具寿命/锁定 + 班组 flexTeams 进排产并发(SC-11);工装矩阵增强 🔜 MD-07
设备虚拟档案 能力集合、可移动/移动耗时、当前位置、工装适配清单 ✅ 管理页:主数据「柔性资源」只读 + Excel 导入写 flexEquipment;PoolEngine 已用 MD-08
工序能力产能池 按工序能力归池,排产从池取设备(非固定产线) ✅ 能力池摘要在柔性资源页;capability_pools + PoolEngine 选池已落地 MD-09

2. 订单

功能 说明 现状 落地规格
销售订单 / 明细 状态过滤后进排产 ✅ 首切片:列表+单明细新建/编辑/取消/完成;P2 确认;批量/附件后置 OR-01
优先级进排序 策略键用 priority/deliveryDate ✅ 首切片:客户等级权重进 RuleEngine + 设置页滑杆(P2);口令「提高VIP权重到10」 OR-02
订单池 / 审核 / 变更 业务台账 ✅ 首切片:状态机 + 仅 APPROVED 进排产;泳道看板/提交/批准/驳回/批量批准;口令「订单池」「提交审核」「批量批准」 OR-03
紧急插单 + 交期议定 快评+局部修复;due-date negotiation ✅ 首切片:固定轨 rush.evaluate/rush.apply;订单面板插单向导;口令「插单快评」「采用插单」(柔性轨仍走 flex.rush) OR-04
预测 / 长周期订单 计划层需求输入(forecast) ✅ 首切片:forecastOrders 台账;默认不进正式排产;includeForecast 试排;转正为 APPROVED 销售单;口令「查看预测」「新建预测」「预测纳入试排」「预测转正」 OR-05
订单钉扎溯源 订单-工单-物料关联(order pegging) ✅ 首切片:固定 SO 链 + 柔性 FO→BOM/VL/WO/设备负荷;双入口(订单追溯 / 柔性钉扎) OR-06
订单分解(MRP) 订单按 BOM/工艺展开 → 自制(排产)/ 采购建议(净需求+前置期倒排)/ 委外建议(外协工序) ✅ 分解 P1 + 下达 P2(DRAFT→RELEASED) OR-07

2b. 计划层(Advanced Planning,对标西门子 Opcenter Planning)

我方最大缺口:中长期计划层基本空白,当前只有排产参数雏形。详见 aps-benchmark-siemens.md §3 G3。

功能 说明 现状 落地规格
时间分桶计划 日/周/月混合时段建模 ✅ 首切片:plan.buckets P0;混合近7日/中4周/远月;确定+预测粗能力;视口「分桶计划」;口令「时间分桶」「分桶计划」「混合分桶」 PL-01
有限/无限产能粗评估 粗能力规划双模式 ✅ 首切片:capacityMode=FINITE/INFINITE;plan.rccp 对照;视口有限/无限切换;口令「有限产能粗评」「无限产能粗评」「粗能力对比」 PL-02
可行性分析 能否按期、缺口定位(前置于排产) ✅ 首切片:累计粗能力 vs 交期排序需求;plan.feasibility;缺口桶+订单 slack;口令「可行性分析」「能否按期」 PL-03
库存投影 make-to-stock 随时间库存曲线 ✅ 首切片:期初+在途+BOM 毛需求+采购到货;日/周投影;断料/安全库存告警;口令「库存投影」「库存投影 CTRL-A」 PL-04
产能平衡/削峰 capacity leveling ✅ 首切片:超载桶→空档挪动建议(先提前后延后);前后负荷对照;口令「削峰」「产能平衡」 PL-05
产供方向决策 加班/扩线/外协建议(结构化) ✅ 首切片:削峰后残留缺口→加班→扩线→外协;口令「产供决策」「加班建议」 PL-06
瓶颈产能评估 产能=瓶颈工序可用工时÷单件工时;设备调配后实时重算 ✅ 能力池日产能+限制性瓶颈;设备停机/调区后即时重算 PL-07
交期承诺模拟 询单插入 → 乐观/中值/悲观区间 + 资源缺口提示 ✅ 乐观/预计/悲观三区间 + gaps;对话块与柔性工作台询价 PL-08

3. 排产引擎

功能 说明 现状 落地规格
规则引擎 RULE 策略排序→选线→逐工序占槽→冲突 ✅ M1 SC-01
策略模板 DELIVERY_FIRST / FIFO / CAPACITY_BALANCE / CHANGEOVER_MIN / COST_FIRST / COMPREHENSIVE / KITTING_FIRST / SKILL_FIRST ✅ SC-02
CP / GA / HYBRID 多引擎真实求解 ✅ CP + GA + HYBRID;GA 首切片联合搜索订单顺序与产线分配 SC-03
约束注册表 + 配置中心 plan §9.2a ✅ 首切片:约束目录 + 设置页启停/硬软;齐套默认软;硬约束拦发布 SC-04
多方案对比 沙盒并行多策略 ✅ M2 SC-05
主控参数 / 敏感性 plan §9.2b / §9.9 ✅ M5 首切片 SC-06
顺序相关换型优化 sequence-dependent setup / 换型最小化 ✅ 首切片:策略 CHANGEOVER_MIN 贪心最近邻 + 同族选线;方案对比含换型卡;口令「换型最小化试排」 SC-07
批次/战役合并 campaign / batch 合并排产 ✅ 首切片:同产品交期窗合并;策略 CAMPAIGN;预览 campaign.preview;口令「战役合并试排」 SC-08
物料齐套约束 库存/在途三态齐套 ✅ 引擎 + SC-04 可关/软硬配置 SC-09
工装/模具约束 二级资源占用 ✅ 选模具+寿命消耗到限锁定;无模具 NO_MOLD SC-10
人员技能/班组约束 班组资格进排产 ✅ 首切片:flexTeams 工序人力并发上限 + 工单挂 teamCode SC-11
滚动时域排产 周/日/2h/实时多级窗口,窗内重优化 ✅ realtime60m(1min) / short2h / mid2d / long7d;窗外延期/截断 SC-12
正排/倒排/瓶颈锚 班组工时消耗正排、交期倒排、瓶颈工序锚定混合排;柔性轨另支持 KITTING_FIRST/SKILL_FIRST 派工排序 ✅ PoolEngine 三模式 + 齐套/技能排序 + 柔性工作台/对话「三模式对比」 SC-13
虚拟产线组装 按订单从能力池动态组线、预占、用完释放;含设备移动耗时 ✅ PoolEngine 组 flexVirtualLines(模具换型+移动耗时)+ 柔性甘特 SC-14

纠偏:C1–C9 已进约束注册表与配置中心首切片(可配项启停/硬软 + 发布硬约束门禁);内建硬约束(工艺先后/独占/日历/资格)仍不可关闭。C10 换型:矩阵主数据已入库并由 RuleEngine 叠加耗时;SC-07 换型最小化与 SC-08 战役合并已落地。C13 / IND-02:SOP→约束编译首切片已落地。 纠偏(柔性需求):固定轨仍是「产线选线 + 工位占槽」;柔性轨已是「能力池 + 虚拟产线」,见 demand-kangni-wuhu.md。


3b. 动态调度(异常分级重排)

功能 说明 现状 落地规格
分级重排 L1–L4 局部换机 → 窗内重排 → 日重排 → 全局重排+P2确认 ✅ L1 池内备机换机(故障优先 L1)/ L2短窗 / L3日窗 / L4全局;L2–L4 均 P2 确认卡 DY-01

4. 结果与执行

功能 说明 现状 落地规格
草稿版本 + 发布 DRAFT→PUBLISHED,发布 P2 ✅ EX-01
甘特 / 负荷 / 交期看板 只读投影 ✅ EX-02
冲突解决工作流 建议一键应用 ✅ 冲突中心 + 按类型建议;P1 安全修复 / P2 重排确认卡 EX-03
工单拖拽调程 POC 有;正式版边拖边校验 ✅ 柔性+固定甘特均可拖;15min 吸附、校验、P2 新版本 EX-04
MES 下发 计划下发车间 ✅ 首切片:Mock MES 幂等下发(P3)+ 柔性工作台「MES 执行」;真实 MCP 🔜 EX-05
资源利用率分析视图 利用率/负荷增强指标 ✅ 首切片:柔性设备 7 日热力 + 班组并发触顶;视口「利用率」 EX-06
方案对比表 KPI 逐项 diff(对标 schedule comparison tables) ✅ 首切片:固定策略+柔性三模式矩阵,最优格高亮与相对 delta;视口「对比表」 EX-07
KPI 仪表盘 利用率/准时率/在制/延误汇总 ✅ 首切片:独立 KPI 视口聚合双轨+MES+冲突;口令「打开仪表盘」 EX-08
报工回流与进度追踪 执行反馈闭环 ✅ 首切片:mes.report P1 进度/完工;订单整单完工联动 EX-09
产能池仪表盘 池负载率、短中长期预测、瓶颈色标、设备调配 What-if ✅ 视口产能池含 4h/1d/1w 预测与 85/95 预警;设备停机/调区即时重算 EX-10

5. 对话与治理

功能 说明 现状 落地规格
意图两级管线 正则快路 → LLM JSON;可降级 ✅ AG-01
门禁 P0–P3 P2 单确认;P3 外部副作用二次确认;审批角色可按 action/P2/P3 分级 ✅(确定性优先级、非法配置失败关闭;P3 当前用于 MES Mock 下发) AG-02
L0-L3 Plan 可重生运行时 不可变版本、输入指纹、历史回看、默认 3 次熔断 ✅ 服务端首切片:/api/plans,尚未接入完整 Agent 自动编排/时间线 UI plan.md §3.1
审计哈希链 可校验 ✅ AG-03
知识检索 bigram + 出处;非向量 RAG ✅ M3(向量 🔜) AG-04
报告 快照模板;数字不经 LLM 改写 ✅ AG-05
偏好缺省策略 采用/试排计分 ✅ AG-06
主动引导 / 多模态 — ✅ 首切片:空态/冲突/知识未命中建议块 + 排产数据缺口步骤引导(缺什么/怎么补/一键口令)+ Web 渲染向导/澄清/齐备度块;多模态 🔜 M6 AG-07
项目 / 会话服务端化 localStorage → Gateway API ✅ 首切片:/api/workspace + 消息同步;启动迁移;删项目不碰世界 AG-08
检查点与时间线 成对快照 + 回滚导轨 ✅ M2 AG-09

6. 行业特化(对标西门子 Opcenter Scheduling SMT)

功能 说明 现状 落地规格
SMT 电子特化 资源分配/批次/交期议定 SMT 场景 🔜 M6(通用模型可承载) IND-01
行业规则包 SOP→排产约束转译沉淀 ✅ 首切片:编译预览 + P2 应用(换线/齐套/插单) IND-02
柔性布局行业包 能力池+虚拟产线+可移动设备+模具约束(多品种小批量) ✅ 柔性工作台覆盖验收剧本(含 SAP Mock 集成) IND-03


6.5 最近交付能力(round-36~44,多智能体并行十批)

与 docs/product/plan-completion-matrix.md 同步;验收以矩阵为准,本表为能力速览。

能力 现状 代码锚点 落地轮次
LNS 插单局部修复 + 升级全量重排 ✅ 固定窗口最小扰动,超阈值 ESCALATE 走 P2 server/aps_domain/lns.py round-36
IIS 最小冲突集与中文归因 ✅ 不可行问题产出最小冲突集 + 归因文案 server/aps_domain/attribution.py round-36
检查点世界侧投影 / 两世界并排 diff / 逐步回放 ✅ /api/checkpoints/{pairId} + WorldDiffView + AlgoReplayPanel checkpoints.world_projection + 前端 viewport round-36/37
@知识 结构化引用(RAG 强制命中不编造) ✅ 对话链路自动解析 + 证据链 session_ref.py + workflow round-37
滚动摘要 LLM 压缩 + 越权上下文 fail closed ✅ summarizer + gateway 预算门控钩子 server/agent_core/summarizer.py round-37
偏好多特征规则归纳 ✅ 订单结构/客户等级/约束压力 → 策略 preferences.py extract_features/induced_rules round-37
WMS 缺料事件 + 缺料→重排端到端闭环(Mock) ✅ 事件幂等/库存版本进证据链 → 方案卡 → 确认 → MES 下发 → 回执 wms_events.py + wms_stub.py round-38
Saga/补偿框架 ✅ 恢复队列/重试/补偿链/人工接管/审计 server/aps_domain/saga.py round-39
13 类约束目录 + 引擎硬约束语义一致 + 关闭拒绝审计 ✅ constraint_catalog() + ConstraintProfileDenied constraints.py round-39
trace 断链可视化 + EXTERNAL HTTP 端到端 ✅ verify_audit_trace + /api/gov/trace/verify + GovConsole ⚠断链徽标 evidence.py + algo_skill_stub round-39
自动化 G0-G4 网关驱动 + 业务动作接线 + 调度器持久化 ✅ /api/automation/tick + lifespan 后台 tick + 动作注册表 automation.py + run_automation_intent round-40
NSGA-II 多目标求解器 ✅ 非支配排序+拥挤度+精英保留 + 3 目标 Pareto + 参数模板 server/engines/nsga2_engine.py round-40
可重生算法流水线 ✅ 隔离构建→黄金→安全扫描→灰度→失败自动回滚 rebuild_orchestrator.py + /api/rebuild/* round-40
CP Cumulative 班组/工装聚合容量 + 性能基线 ✅ AddCumulative + gap/时限元数据 + <30s 基线 cp_engine.py round-41
参数优化 P2 门禁 + 线上观测回滚 ✅ promote 确认卡 + 连续劣化自动回滚 param_opt.py + /api/params/* round-41
完整前端 E2E(preview+dev)+ CI 5-job 矩阵 ✅ Playwright 3 passed + ci.yml(lint/build/golden/E2E/SBOM) apps/web/e2e + .github/workflows/ci.yml round-41
审批文件→DB 存量迁移 ✅ 幂等迁移 + dry_run + fail-closed approval_migrate.py round-41
多模态低置信确认框架 ✅ Extractor 注册表 + stub 提取器 + 低置信 P2 确认门禁 multimodal.py + /api/multimodal/* round-42
WORM 归档模拟 + 篡改检测 + 归档加密 ✅ 归档密封 manifest + verify_archive + AES-256-GCM 双层哈希 audit_ledger.py round-42/43
前端 StrictMode 缺陷修复(dev E2E 可用) ✅ alive ref 复位 + 捕获移出更新器 apps/web/src/App.tsx round-42
桌面离线升级 + 失败自动回滚 ✅ 校验→备份→NSIS→健康检查→回滚 + 审计 apps/desktop/updater.cjs + packaging/upgrade-manifest.* round-43
Defender 静态扫描 + 离线安装包完整性校验 ✅ MpCmdRun 4/4 clean + SHA-256 清单 scripts/defender-scan.mjs + scripts/offline-install-check.mjs round-43
测试门禁:test_guidance 知识库隔离修复 ✅ 全量回归 858 passed 无既有失败 tests/golden/test_guidance.py round-43

7. 差距清单(西门子对标 × 真实需求重排)

  1. 柔性资源模型(MD-08/09 + MD-07/SC-10 + SC-14)——真实需求 P0:设备不固定则产能失真
  2. 正倒排/瓶颈锚 + 滚动窗口(SC-13/SC-12)——吸收既有排产逻辑 PPT
  3. 计划层 AP + 瓶颈产能/交期承诺(PL-01~08、EX-10)——对标西门子 + 客户交期询价场景
  4. 多约束配置中心(SC-04)与换型矩阵(MD-06 + SC-07/08)(M4→M5)
  5. 分级重排与插单(DY-01 + OR-04 + EX-03)(M4)
  6. 发布执行闭环(EX-05/09 + MD-05)(M4)
  7. 分析增强(EX-07/08、OR-06)(M4)
  8. 需求侧与导入(OR-03/05、MD-04)——✅ 订单池/预测/导入首切片已落地;附件与预测消耗冲减后置
  9. 行业包(IND-01 SMT / IND-02 规则 / IND-03 柔性布局)(M5/M6)

完整对标:aps-benchmark-siemens.md。需求原文分析:demand-kangni-wuhu.md。

维护:状态变更必须同轮改本表 + ../CHANGELOG.md。

Round 65:闭环 APS 业务阶段

  • 订单分解产物区分为商务订单、制造需求、采购建议、委外建议、排产草案、已发布版本与 MES 对象,不再混用“订单”语义。

  • 硬阻断会显示聚合计数、具体对象、证据和修复入口;不显示绿色“排产完成”。

  • 完整 DRAFT 只允许进入 P2 发布;已发布且证据一致的版本才允许进入 P3 MES。

  • 订单页阶段状态来自持久化 closedLoopProblems、精确排产版本、publishReady/dispatchReady 和 MES 事实,刷新后不退回静态“待确认”。

  • 活动可同时占用设备、班组、模具和组织层级容量;任何缺失分配或证据漂移均阻断发布/下发。

Round 71:未完成功能补齐(本地切片)

  • 图纸:浏览器可上传/选择/批量解析 DXF,图纸候选独立变更集,P2 确认后生成 drawingLink 证据,标题栏/BOM 区域识别与版本 diff。
  • 图纸格式:新增 PDF 图纸解析与首页 PNG 预览,上传/项目内选择/批量解析支持 DXF+PDF;扫描件/图片型 PDF 需 R71.6 真实 OCR。
  • 图纸体验:预览支持全屏查看整图;比例文本不会被误识别为螺纹规格。
  • 工艺/工序:从图纸文本与零件明细识别工艺与细节候选(车削/铣削/钻孔/螺纹/装配/表面/公差/粗糙度等),带证据并保持 PENDING_REVIEW。
  • 图纸管理:支持删除单张图纸与清空项目图纸,操作留审计。
  • AI 精确解析:可配置 LLM 后对图纸文本/字段做结构化精确提取;未配置时明确返回确定性结果,不编造。
  • 中文工艺文档:可把分段建造说明解析为分段/组立/工序/场地/装配顺序候选;图纸详情页新增“工艺关键信息”页签。
  • 主数据维护:工位/设备 CRUD(停用不进排产)、BOM/工艺版本发布与回滚、班次日历周模板,写动作 P2 审计。
  • 计划层:MPS 草稿(DAY/WEEK/MONTH/HYBRID)、有限产能粗评估、计划→排产→发布→执行反馈信封与 gap 对比;Web「分桶计划」新增「MPS 草稿」页签接入 /api/mps/draft|persist|traces|trace/{id}|gap,可保存草稿、查看追踪链与 gap 对比。
  • 康尼导入增强:工时.xlsx 按订单 sheet 读取 标准工时/分钟 真实值,工艺路线标准工时空值优先回填(stdTimeSource=工时表),无值才走推断;新增「设备能力映射模板」「模具适配映射模板」读取,有表时用真实设备/模具排产,缺表回退合成共享工位。
  • 排产结果导出:新增工单角度/设备角度调度方案 xlsx(/api/reports/schedule-order、/api/reports/schedule-equipment)。
  • 柔性方案对比:compare_sort_modes 扩展为五模式(正排/倒排/瓶颈锚/齐套优先/技能优先),对话与矩阵文案同步。
  • 治理:规则 CRUD/启停/审计轨迹、审计统计聚合端点与面板。
  • 外部阻断:真实 MES/WMS/SAP、真实多模态/OCR、信创与签名/CI 验收仍按 external-acceptance.md 单独登记,不翻 Done。

Round 76:康尼真实数据 Web 全流程试排

  • 浏览器可创建项目并上传康尼 9 份标准 XLSX;“根据这些数据排产”通过冻结 source bytes + P2 信封进入候选世界 trial,不读取服务器本地客户路径。
  • Sheet2-Sheet9 工艺按 工时.xlsx 订单规范序列匹配,BOM 按结构化工单编号跨 sheet 归集;当前实测 10 订单、72 工序记录、26 工序种、965 源 BOM / 823 投影 BOM。
  • 康尼 P2 卡明确 productionReady=false、共享占位、仅试排、不得发布或下发 MES;批准后生成 10 VL / 72 WO,销售订单与柔性订单均保持 10 条。
  • 五策略比较排除 DEGRADED/PARTIAL 推荐,数据未补齐时只给 TRIAL_ONLY 参考;柔性工作台展示订单/设备两个显式版本导出入口。
  • MPS 草稿支持浏览器 JSON 数字往返稳定哈希、trace 保存、本地版本 ADOPT 关联和 gap 复算;自动发布/反馈仍保留为外部闭环边界。
  • 操作步骤见 ../development/kangni-real-data-browser-runbook.md。