Industry
/
aps-agent
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
aps-agent/docs/architecture/overview.md

67 lines
2.2 KiB
Markdown
Raw Permalink Normal View History

first commit
2026-07-21 11:05:57 +08:00
# 架构总览（落地态）
---
## 1. 仓库分层
```
apps/web/ 表现层 React：对话 / 视口 / 项目壳 / 治理台
server/gateway/ HTTP + SSE 接入
server/agent_core/ 意图、门禁、审计、Provider、模块扫描
server/aps_domain/ 工作流编排、视图投影、沙盒、报告
feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） - 智能体核心：Harness 门禁/_POWER_MAP、P2/P3 确认卡、证据链、Plan 运行时 L0-L3、统一工具运行时、自动化 G0-G4 - 领域层：Rule/CP-SAT/GA/NSGA-II/LNS 引擎、13 类约束目录、IIS 冲突归因、敏感性/蒙特卡洛、插单重排、MRP 分解 - 状态层：世界/对话成对快照、分支树、检查点、Saga 补偿、审批文件/DB 双后端 - 集成层：MCP 插件总线、MES/WMS 适配器（stub+HTTP）、异步任务 - 前端：左说右动工作台（聊天+甘特/负荷/交期）、主数据、订单、治理台、分支树、时间线、审计统计 - 桌面端：Electron 壳 + Python Sidecar + NSIS 打包 + 许可证 - 文档：plan.md 蓝图、完成矩阵（50 Done/10 Partial/0 Missing）、CHANGELOG 全量账本、各轮次计划/状态 - 验证基线：黄金测试 1000+ 项、Node 60 项、Web build 通过（详见 docs/CHANGELOG.md）
2026-08-20 11:39:21 +08:00
server/engines/ 排产引擎（RULE / CP-SAT / HYBRID / GA）
first commit
2026-07-21 11:05:57 +08:00
server/knowledge/ 资产 / 检索 / 偏好
server/state/ 世界状态 + 检查点 + 种子
shared/schemas/ 跨语言 JSON Schema 契约
tests/golden/ 黄金回归
```
feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） - 智能体核心：Harness 门禁/_POWER_MAP、P2/P3 确认卡、证据链、Plan 运行时 L0-L3、统一工具运行时、自动化 G0-G4 - 领域层：Rule/CP-SAT/GA/NSGA-II/LNS 引擎、13 类约束目录、IIS 冲突归因、敏感性/蒙特卡洛、插单重排、MRP 分解 - 状态层：世界/对话成对快照、分支树、检查点、Saga 补偿、审批文件/DB 双后端 - 集成层：MCP 插件总线、MES/WMS 适配器（stub+HTTP）、异步任务 - 前端：左说右动工作台（聊天+甘特/负荷/交期）、主数据、订单、治理台、分支树、时间线、审计统计 - 桌面端：Electron 壳 + Python Sidecar + NSIS 打包 + 许可证 - 文档：plan.md 蓝图、完成矩阵（50 Done/10 Partial/0 Missing）、CHANGELOG 全量账本、各轮次计划/状态 - 验证基线：黄金测试 1000+ 项、Node 60 项、Web build 通过（详见 docs/CHANGELOG.md）
2026-08-20 11:39:21 +08:00
跨层 UI 块、视口命令和意图载荷统一携带 `interfaceVersion=1.0`。JSON Schema
是枚举与版本的基准，Python Pydantic 与 TypeScript 为运行时镜像；
`tests/golden/test_contract_sync.py` 在发版测试中阻断意图枚举或版本漂移。
公共 `/api/health` 返回同一接口版本；Web `InterfaceGate` 在认证和业务界面挂载前
执行严格相等校验，不兼容或健康检查失败时显式阻断。
first commit
2026-07-21 11:05:57 +08:00
---
## 2. 请求主链路
```mermaid
flowchart TB
UI[Web Shell] --> GW[Gateway]
GW --> INT[Intent 两级管线]
INT --> WF[Workflow]
WF --> H[Harness 权力判定]
H -->|P0/P1| EXE[执行器]
H -->|P2| CARD[确认卡暂存]
CARD -->|用户批准| EXE
EXE --> ENG[Engines / Knowledge / State]
EXE --> AUD[Audit 哈希链]
ENG --> VIEW[Views 投影]
VIEW --> UI
```
---
## 3. 关键不变量
1. **写主干必过 Harness**；P2 唯一确认通道。
2. **Explore 沙盒**不得写主干（`scenario.compare`）。
3. **报告数字**只允许来自冻结快照字段。
4. **可重生模块**带 `moduleId` 头声明，重生中心可扫描。
5. **文档与代码同轮**：见 [../README.md](../README.md) 铁律。
---
## 4. 技术选型（已锁定）
| 项 | 选择 |
| --- | --- |
| 后端 | Python FastAPI |
| 前端 | React 18 + Vite + TS |
feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） - 智能体核心：Harness 门禁/_POWER_MAP、P2/P3 确认卡、证据链、Plan 运行时 L0-L3、统一工具运行时、自动化 G0-G4 - 领域层：Rule/CP-SAT/GA/NSGA-II/LNS 引擎、13 类约束目录、IIS 冲突归因、敏感性/蒙特卡洛、插单重排、MRP 分解 - 状态层：世界/对话成对快照、分支树、检查点、Saga 补偿、审批文件/DB 双后端 - 集成层：MCP 插件总线、MES/WMS 适配器（stub+HTTP）、异步任务 - 前端：左说右动工作台（聊天+甘特/负荷/交期）、主数据、订单、治理台、分支树、时间线、审计统计 - 桌面端：Electron 壳 + Python Sidecar + NSIS 打包 + 许可证 - 文档：plan.md 蓝图、完成矩阵（50 Done/10 Partial/0 Missing）、CHANGELOG 全量账本、各轮次计划/状态 - 验证基线：黄金测试 1000+ 项、Node 60 项、Web build 通过（详见 docs/CHANGELOG.md）
2026-08-20 11:39:21 +08:00
| 求解 | RULE + CP-SAT + **HYBRID（RULE→CP）** + 固定种子 GA |
first commit
2026-07-21 11:05:57 +08:00
| LLM | DeepSeek / KIMI（OpenAI 兼容），可降级 |
feat: APS 智能排产智能体全量实现（M-POC~M6 + 跨阶段治理 + round-1~66） - 智能体核心：Harness 门禁/_POWER_MAP、P2/P3 确认卡、证据链、Plan 运行时 L0-L3、统一工具运行时、自动化 G0-G4 - 领域层：Rule/CP-SAT/GA/NSGA-II/LNS 引擎、13 类约束目录、IIS 冲突归因、敏感性/蒙特卡洛、插单重排、MRP 分解 - 状态层：世界/对话成对快照、分支树、检查点、Saga 补偿、审批文件/DB 双后端 - 集成层：MCP 插件总线、MES/WMS 适配器（stub+HTTP）、异步任务 - 前端：左说右动工作台（聊天+甘特/负荷/交期）、主数据、订单、治理台、分支树、时间线、审计统计 - 桌面端：Electron 壳 + Python Sidecar + NSIS 打包 + 许可证 - 文档：plan.md 蓝图、完成矩阵（50 Done/10 Partial/0 Missing）、CHANGELOG 全量账本、各轮次计划/状态 - 验证基线：黄金测试 1000+ 项、Node 60 项、Web build 通过（详见 docs/CHANGELOG.md）
2026-08-20 11:39:21 +08:00
| 桌面 | Electron（当前实现，`apps/desktop`；Tauri 目标态待产品/架构决策） |
first commit
2026-07-21 11:05:57 +08:00
细节与里程碑叙事见 `plan.md`；接口清单见 [harness.md](./harness.md)。