# architecture.html · 整体系统架构

## 用途与角色

评审展示页：**平台中心架构**（multuex-engine 是架构中心与能力总线；tigo-loop 是第一个领域分支项目；工作台是统一人机入口）。给客户讲"现在建什么、以后怎么长"。非功能页，正式系统中对应运维/文档页。**随架构演进持续更新**。

## 心智模型（三句话，V1.3 修订）

- **平台管能力**：智能体、工具（企业能力注册中心）、记忆、设备接入（节点网关）长在 multuex-engine 上。
- **领域管规则**：tigo-loop 及未来领域项目各自持有状态机、闸门、数据库；领域能力注册为平台工具共享。
- **工作台管入口**：人（登录/壳/反代）与企微消息的统一出入口。
- 修正点：外部系统（ERP/PLM/客服/知识库）接入**平台工具代理层**而非 tigo-loop——全部领域项目共享。

## 区块

| 区块 | 内容 |
|---|---|
| SVG 全景图 | 企微 → 工作台 → 领域项目行（tigo-loop＋未来预留）→ 平台（中心）；外部系统→工具代理（虚线）；设备→节点网关（绿） |
| 领域与平台分工表 | 三层各自"管什么/不管什么（刻意隔离）" |
| 接入规划表 | 系统 / 交换内容 / 方向 / 集成方式 / 阶段（五行，含设备数采） |
| 设备数采详解 | 链路 + 四业务场景 + 安全边界 |
| 接入原则 | 四条红线（工具代理注册 / 领域互不直连 / 企微凭据 / 数据边界评估） |
| 演进里程碑 | M1 手工导入 → M2 ERP 读+知识导入+数采试点 → M3 全量+设备洞察智能体 |

## 外部接入契约草案（开发对齐用）

| 系统 | 方向 | 认证 | 频率/触发 |
|---|---|---|---|
| ERP | 双向 | API Key（存 var/platform.env） | 库存定时拉（每日）/ 请购写回事件触发 |
| PLM | 入 | API Key | 版本发布事件订阅 / 定时对账 |
| 客服 | 入 | Webhook HMAC | 工单创建事件 → 建单候选队列 |
| 外部知识库 | 入 | 导入凭证 | 一次性批量 + 增量定时 |
| 设备数采 | 入（出站） | X-Node-Token（设备身份，可吊销/绑设备） | 心跳 60s + 数据按窗口上报 |

## 设备洞察智能体（第八个，规划 M3+）

- 技能：时序异常检测、健康度评估、根因佐证报告生成
- 工具：读时序库、查设备档案、创建预警（联动跟踪哨兵）
- 记忆：每台设备工况基线模型
- 边界：分析结果不自动改单——预警给建议、建单候选由人确认（与其他智能体同一铁律）

## 验收要点

- 图上每个实线链路能对应到技术设计稿章节；每个虚线接入有阶段与集成方式。
- 接入原则四条作为新增集成的评审清单（checklist 使用）。