aps-agent/docs/spec/platform-vs-business.md

2.7 KiB
Raw Blame History

平台基础能力与 APS 业务能力边界

用途:拆分判据。判断一段代码该放平台、放 APS,还是单独做成 Provider,看它落进哪一类;有争议时先改本文,再动代码。

判据(三个问题)

  1. 与具体业务系统无关吗? 换掉 APS 换成别的业务系统,这段逻辑还要不要?要 → 平台基础。
  2. 它是业务事实的承载者吗? 是不是「这家工厂的订单、工艺、排产结果」这类事实?是 → 业务系统。
  3. 它是与第三个系统的对接吗? 是不是在跟 ERP / EMS / MES 打交道?是 → 独立 Provider。

三分类

分类 内容
平台基础 会话、消息、工作区、项目、附件与产物(数据管理);能力目录与 Provider 契约;策略、确认卡、执行授权;审计;身份与租户映射;凭据代理;引擎适配与进程管理;协议 v1(HTTP / SSE);客户端壳与桌面壳;Provider 套件管理与可视化宿主;跨系统顺序流程;文件导入骨架(profile 机制)
APS 业务 求解引擎(CP-SAT / GA / NSGA2 / 池 / 规则)与求解进程隔离;柔性排产、能力池、交期承诺;订单、主数据、MRP;工厂日历与换型字典;工艺路线模板;排产执行与结果;世界状态、检查点、分支、数据包;排产校验器;SAGA 与闭环运行时;APS 自己的治理与审计;排产类报告内容
独立 Provider 与 ERP / EMS / MES / WMS / SAP 的对接。现在这些代码混在 aps_domain 里(mes.py、sap_sync.py、wms_events.py),B 线拆分时搬成各自的 Provider

已确认的边界项

项 归属 说明
图纸与多模态 展示、上传、预览 → 平台基础;图纸解析成工艺信息 → APS 2026-09-24 确认
知识库与 RAG 检索能力 → 平台基础;工艺模板库 → APS 工艺模板归 APS 见 D8 相关结论
报告 导出机制 → 平台基础;排产报告内容 → APS 2026-09-24 确认
网格面板(MeshPanel) 待查 需确认是开发调试用还是业务视图

与决策的对应

决策 对本文的影响
D8 平台 TS 从零重写;APS 保持 Python 搬迁适配
D9 权限与协作归业务系统;平台不做转派、委托、多人计数、角色策略
D12 APS 不内置对话智能体:只保留「智能体接入点」契约,需要对话时由平台驱动
D13 / ADR-0008 库各自私有:平台库归平台,APS 库归 APS,平台禁止直连 APS 库
D14 / ADR-0009 交付形态:首版只交付纯平台包,APS 单独部署,平台按 Provider 配置指向它