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

35 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 平台基础能力与 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 库 |