跳转到内容
WPF API图书馆WPF API图书馆WPF API图书馆

整体架构

🔐
此页面需要密码访问
请输入访问密码以查看 WPF 整体架构文档

WPF 智能 IoT 生态系统 · 整体架构

Section titled “WPF 智能 IoT 生态系统 · 整体架构”

WPF智能IoT生态矩阵系统，整体架构打造为高度内聚、跨模态协同的复合型数字基建平台。在整体架构哲学上，本系统深度践行「数据同源与控制解耦」的核心理念。 系统打破传统IT架构中业务线数据壁垒，以单一事实数据源（Single Source of Truth）为中枢，通过统一的身份认证总线与数据持久化基座，将云端复杂业务逻辑、高频低延迟的IoT设备遥操作、AI驱动的数字化企业助理，以及基于空间计算的沉浸式多端协同无缝衔接。

在整体拓扑结构上，WPF矩阵划分为五层拓扑：展现交互层、核心业务层、高频通信层、数据持久层、边缘执行层。 多层解耦的设计，既保证中心业务的高可用与数据一致性，又赋予各个子系统在特定运行环境下的极致性能，实现从顶层数字指令到底层各型IoT物理驱动的高效闭环。

WPF智能IoT生态系统 - 项目列表(索引编号全局一致)：

# 项目 技术栈 所属层级 数据库归属 运行环境
① wpf_api PHP Laravel 核心业务层 wpf_db 主库 Linux 服务端
② wpf_plus_server Node.js Express 实时通信层 wpf_db 主库 Linux 服务端
③ wpf_admin Vue3 Element Plus 展现交互层 wpf_db（经 wpf_api） 浏览器
④ wpf_frontend UniApp Vue3 展现交互层 wpf_db（经 wpf_api） H5 / App
⑤ wpf_lot Python asyncio 边缘执行层 wpf_db（经 wpf_api） 广谱智能硬件
⑥ ModernFactory C# .NET 展现交互层 wpf_db（经 wpf_api） Windows
⑦ vr_server Unity NetCode 实时通信层 wpf_db 主库 Windows Server
⑧ vr_client Unity3D OpenXR 展现交互层 wpf_db（经 wpf_api） Pico 4 (Android)
⑨ zn_server Node.js Express 核心业务层 wpf_db + zn_db Linux 服务端
⑩ zn_admin Vue3 Element Plus 展现交互层 双db（经 zn_server） 浏览器

一、架构总纲：数据同源与控制解耦

Section titled “一、架构总纲：数据同源与控制解耦”

整个架构体系矩阵，设立四项架构原则。建立递进式因果链：统一身份认证是前提，数据持久同源是基础，跨模态业务联动是生态模式，分域解耦则是在「统一底座」与「异构负载」保留弹性边界。

统一系统数据源

全部项目统一归集于 wpf_db 主库与同一套账号体系。身份、组织、设备、场景数据一处持久化、全域可见，从根源上建立多数据源之间状态一致性。

统一身份认证总线

全矩阵共享同一用户主体标识。任一终端完成注册，Web、移动、桌面、VR 各端身份即时对齐——这是跨模态协同得以成立的前提规范。

跨模态业务联动

数字孪生大屏、沉浸式 VR、移动遥操作、AI 智能助理围绕同一份上下文彼此感知。联动并非事后集成，而是数据同源的自然涌现。

分域解耦弹性

高频遥测、多人状态同步、AI 特化存储被剥离至专用运行时，各自运行于最契合其负载特征的技术栈之上，在统一之下保留架构弹性。

二、矩阵系统五层拓扑

Section titled “二、矩阵系统五层拓扑”

整体系统架构视角，WPF 矩阵被划分为五个逻辑层次。层次划分遵循「上层贴近人与业务、下层贴近物与实时、数据层横贯其间作为共享地基」的分层原则。 注：“展现交互层”承载终端呈现职责，“边缘执行层”承担物理执行职责。桌面数字孪生客户端与 VR 沉浸式客户端本质为展现层富客户端，通过增强交互效果实现多模态体验。

  1. 展现交互层（Presentation Layer）

    • 包含 ③ wpf_admin、④ wpf_frontend、⑥ ModernFactory、⑧ vr_client、⑩ zn_admin。
    • 职责：面向用户的多模态交互入口，从交互界面延伸至三维数字孪生与空间沉浸式体验。
    • 架构约束：本层所有客户端均不直连数据库，一律通过后端接口获取数据，以此保证身份与组织信息的同源一致。

  2. 核心业务层（Business Logic Layer）

    • 包含 ① wpf_api、⑨ zn_server。
    • 职责：常规业务数据、静态数据、权限管理与 AI 智能服务的中枢，以安全稳定为首要设计目标。
    • 架构定位：所有展现层请求最终在此完成鉴权、业务编排与数据持久化决策。

  3. 实时通信 / 同步层（Real-time / Sync Layer）

    • 包含 ② wpf_plus_server、⑦ vr_server。
    • 职责：负责高频、低延迟、有状态的长连接负载——IoT 设备遥操作与 VR 多人状态同步。
    • 架构定位：独立于请求-响应模型，从设计理念上规避高频数据直写主库的并发压力。

  4. 数据持久层（Data Layer）

    • 包含 wpf_db 主库、zn_db 解耦子库(配套向量数据库)。
    • 职责：统一数据源底座 + 解耦子库，建立多模态向量存储之间的解耦桥梁。
    • 架构定位：全生态跨模态联动的物理基础。

  5. 边缘执行层（Edge Execution Layer）

    • 包含 ⑤ wpf_lot 及其驱动的广谱泛 IoT 节点。
    • 职责：将顶层数字指令转为驱动底层物理动作，并向上回传实时遥测与视频流。
    • 架构定位：兼具极高硬件包容度与完善物理兜底机制的执行末端。

WPF 智能 IoT 生态系统 五层拓扑架构

三、展现交互层：多模态终端矩阵

Section titled “三、展现交互层：多模态终端矩阵”

展现交互层是生态与人交互的全部端，覆盖从界面管理后台到三维沉浸式空间的完整交互谱系。本层五款终端形态各异，共享遵守同一条架构红线——所有前端/客户端均通过后端接口访问数据，不存在任何直连数据库的旁路。这一约束正是账号、公司/部门/成员组织等基础信息在全域保持同步一致。

③ wpf_admin · Web 管理后台

Vue3 Element Plus 展现交互层
架构角色：生态运营管控后台。经 wpf_api 完成全部数据读写，覆盖看板、用户、组织、RBAC 权限、设备与操作审计。

④ wpf_frontend · 跨平台移动端

UniApp Vue3 展现交互层
架构角色：面向移动终端用户的入口。可运行于 H5 / 小程序 / Android / iOS，属遥操作、视频流、IM、通话等入口的跨平台载体。

⑥ ModernFactory · 数字孪生大屏客户端

C# .NET 展现交互层
架构角色：独立运行的智慧大屏数字孪生客户端。经 wpf_api 后端接口同步账号与组织信息，业务场景垂类功能支持独立运算。

⑧ vr_client · 沉浸式 VR 客户端

Unity3D OpenXR 展现交互层
架构角色：沉浸式空间计算交互客户端。经 wpf_api 同步用户基础信息，与 wpf_frontend 联动通讯，同时具备VR专属交互功能。

⑩ zn_admin · AI 智能交互前端

Vue3 Element Plus 展现交互层
架构角色：AI 能力的双模式呈现层。在 zn_server 建立高内聚低耦合智能交互， AI / Agent 对话前端与知识库管理后台。

【技术】：Vue 3 / Vite / Element Plus / Pinia / Axios，以 Playwright 覆盖 15 条核心链路 E2E 回归。Axios 统一请求拦截层集中处理 Token 挂载与错误归一。

【职责】：WPF主管理后台，数据读写全程经由 wpf_api，本身不持有任何数据库连接。功能覆盖多维数据看板、用户与设备权限分配、公司/部门组织树、RBAC 可视化配置、设备类型/设备组/指令集管理、审批模板与全量操作审计。

四、核心业务层：稳态数据中枢

Section titled “四、核心业务层：稳态数据中枢”

核心业务层是全生态的数据大脑，由 ① wpf_api 与 ⑨ zn_server 双引擎构成。二者遵循同一设计哲学，安全稳定为最高优先级，常规业务数据请求都需鉴权进行读取/存储，需高频/易失/含状态的实时负载服务隔离至实时通信层。

【职责】：全矩阵的统一业务数据源底座。wpf_api 负责常规业务数据、静态数据与权限管理，所有展现层终端请求的数据中枢。

【技术】：PHP Laravel 的 ORM、中间件管道、队列系统与生态包，为复杂业务逻辑的持续迭代提供稳态支撑。认证采用 Laravel Sanctum (Token) + JWT 双模式，架构遵循 MVC + Service + Repository 分层，权责划分清晰。

开放 API 覆盖 21 个主功能模块 (收录至 AI图书馆 )：

模块 职责
认证 注册 / 登录 / Token 刷新 / 修改密码 / 当前用户
用户 个人信息 / 修改资料 / 头像上传 / 注销
组织架构 组织树 / 搜索 / 同事列表
设备管理 列表 / 详情 / 指令 / 授权 / 设备分组
设备上报 设备状态数据上报接入
IoT 事件 边缘设备事件采集与处理
实时通信 服务端推送通道管理
好友 好友列表 / 搜索 / 添加 / 请求处理 / 备注
群组 创建群组 / 成员管理 / 群设置
IM 会话列表 / 消息收发 / 消息记录 / 撤回
音视频通话 发起通话 / 通话控制 / 状态同步 / Token 签发（集成声网 Agora）
VR 场景 房间 Seed 副本创建与查询 / 场景快照保存与恢复
审批 审批模板 / 提交申请 / 处理审批 / 我的申请 / 待审批列表
通知 系统消息推送
文件 统一文件上传服务

另外，管理后台 API 覆盖(专供后台)：数据看板、用户管理、组织管理、设备管理、RBAC 权限、审批管理、会话管理与操作审计等。

五、实时通信 / 同步层：低延迟长连接

Section titled “五、实时通信 / 同步层：低延迟长连接”

实时通信层，负责 WPF生态 中一切高频、低延迟、有状态的负载。由 ② wpf_plus_server 实现高性能连接与通讯，由 ⑦ vr_server 提供沉浸式多人实时交互，构成双服务通道。 本层核心设计，建立稳定 WebSocket长连接 实现智能硬件遥操作；建立高效 WebRTC网络传输 实现流媒体传输。实时状态在长连接通道内以内存态流转，仅在必要业务节点落库固化。

【职责】：IoT 设备遥操作的实时控制引擎。基于 WebSocket Map 维护 IoT 设备与移动端之间的双向长连接注册表，「云端一次指令 → 物理世界一步动作」的中转枢纽。

遥操作双通道设计——WPF 将遥操作解构为「手」与「眼」两条并行感知回路：

  1. 控制回路（手） 移动端 ④ wpf_frontend 经 WebSocket 下发运动指令（前进 / 后退 / 转向 / 速度 / 站立 / 趴下），指令经本服务的连接 Map 精准路由至目标边缘节点，实现遥操作之「手」。

  2. 感知回路（眼） 边缘节点回传的 WebRTC 视频流经 wpf_frontend 实时呈现，操作者得以「亲眼」观测现场，实现遥操作之「眼」。手眼协同，构成完整的闭环遥操作体验。

  3. 无高频直写原则 系统在设计理念上摒弃了高频遥测数据直写 MySQL 的方案，不通过高频填充处理数据，从根源上规避并发写入压力。

【技术】：Node.js 事件驱动模型天然契合海量并发 WebSocket 连接。认证使用 JWT (jsonwebtoken + bcryptjs)，实时通道基于 ws 库。设备控制施加双重前置校验——设备须同时满足「在线」与「空闲」两个条件方接受指令；控制前强制站立、退出时自动趴下的姿态保护；会话超时自动释放连接。

通信与集成链路

Section titled “通信与集成链路”

四条通信链路，统一数据底座，各自独立运行。实现协同接力而非各管一段。HTTP 完成鉴权即可成功激活各链路的服务。 操作者：移动端遥操作下发指令（WebSocket），观测机器人回传画面（WebRTC），协同 VR 端语音通讯（Agora）。

链路 协议特征 承载职责 典型端点
请求-响应 HTTP REST 稳态业务读写、鉴权、静态数据 展现层 → 核心业务层 → 数据层
实时控制 WebSocket 遥操作指令下发、设备长连接 wpf_frontend → wpf_plus_server → wpf_lot
视频回传 WebRTC 现场画面实时推拉流 边缘节点 → 移动端「眼」
人际通话 Agora RTM 跨端音视频协作 wpf_frontend ⇄ vr_client

视频回传设计：内网环境下，边缘节点经轻量媒体服务实现 WebRTC 视频推送，支持标准 WHIP（推流）/ WHEP（拉流）协议，可低延迟传输。外网访问场景引入信令服务器 + STUN/TURN 进行 NAT 穿透与连接协商，架构上预留了与标准 WebRTC SFU 方案对接的扩展点。

WPF 四链路通信全景

六、数据持久层：单一事实源与解耦桥梁

Section titled “六、数据持久层：单一事实源与解耦桥梁”

数据持久层是「数据同源」理念的架构底座。WPF 采用“一主多辅”的多库拓扑：wpf_db 作为单一事实数据源承载全部核心业务，zn_db 作为解耦桥梁负责 AI 数据映射。

wpf_db · 主数据库

项目 ①–⑩ 共用


承载统一用户、组织、设备、IM、通话、VR 场景等全部核心业务数据，是生态跨模态联动的物理基础底座。所有展现层终端经后端接口在此完成权威读写。

zn_db · 解耦桥梁

项目 ⑨–⑩ 使用


zn_db 是 wpf_db 连接 AI / Agent 会话与记忆框架所需的多模态向量存储之间核心解耦桥梁。用户数据继承自 wpf_db，统一映射主库的数据关系。

zn_db 的架构定位辨析

Section titled “zn_db 的架构定位辨析”

关于 zn_db 的定位及设计意图，在于隔离 AI 负载与 OLTP 业务负载的技术栈差异，同时保持与主库的身份一致性。

  1. 身份校验仍以主库为主 高频用户的 AI 身份校验依然锚定于主库 wpf_db。zn_db 的用户数据继承并映射 wpf_db 的组织关系，不构成独立的身份权威。

  2. AI 数据隔离存储 zn_db 对每个用户的 AI Chat 与 Agent 数据进行隔离存储，专注处理 AI 与 Agent 的数据映射，与业务主数据在物理上分域。

  3. 记忆框架按需组合 根据 SaaS 化业务场景，zn_db 支持各记忆框架向量数据库（如 Qdrant / Milvus）联动。「AI 智脑」按业务场景装配不同的向量数据库实例。

  4. 解耦桥梁本质 综上，zn_db 是 wpf_db 与向量数据库之间的重要解耦桥梁。既借主库保证身份同源，又为特化存储引擎保留独立演进空间。

wpf_db 主库核心表结构（概要）

Section titled “wpf_db 主库核心表结构（概要）”
  • 文件夹wpf_db (MySQL)
    • users 统一用户表（项目 ①–⑧ 共用）
    • companies 公司信息
    • departments 部门组织树
    • devices IoT 设备注册与状态
    • device_groups 设备逻辑分组
    • device_types 设备类型定义（四足机器人 / 具身机器人 / 摄像头 / 算力主机…）
    • commands 设备控制指令集模板
    • friends 好友关系
    • groups 群组及成员
    • conversations IM 会话
    • messages 聊天消息
    • calls 音视频通话记录
    • call_sessions 通话会话状态
    • seeds VR 房间副本数据
    • snapshots VR 场景快照
    • approvals 审批工作流
    • notifications 系统通知
    • roles RBAC 角色定义
    • permissions RBAC 权限节点
    • operation_logs 全量操作审计日志
    • …

七、边缘执行层：广谱泛 IoT 生态

Section titled “七、边缘执行层：广谱泛 IoT 生态”

边缘执行层，是数字指令落地为物理动作的执行阶段，由 ⑤ wpf_lot 及其驱动的广谱泛 IoT 节点构成。边缘端绝非仅涵盖树莓派。 WPF 具备极高的 IoT 设备包容度，边缘生态横跨「直连终端设备」与「边缘算力桥梁」两大形态，向下驱动兼容日益丰富的智能硬件生态。

广谱设备包容度

Section titled “广谱设备包容度”

直连终端设备

包括四足机器人（如云深处 Lite3、宇树 B2 机器狗）、具身智能机器人、传统摄像头等物理执行与感知终端，承接运动指令/视频采集。

边缘计算算力桥梁

各类智能 AI 算力主机——树莓派、Jetson、RK3588 等。作为算力桥梁承上启下，向上保持长连接，向下驱动更丰富 IoT 智能生态硬件。

⑤ wpf_lot 运行时职责

Section titled “⑤ wpf_lot 运行时职责”

【技术】：Python 3 / asyncio，运行于边缘算力节点，以 UDP 直连运动主机、标准 WebRTC（WHIP / WHEP）推送视频、向上以 WebSocket 保持长连接。asyncio 单线程异步模型将长连接、运动指令、视频推流、心跳上报统一调度于同一事件循环，规避多线程竞态。

模块 职责
启动引导 首次启动自动注册配置 → 按配置选择驱动 → 建立 WebSocket 长连接
硬件抽象 BaseDevice 定义统一接口，具体驱动继承实现
运动驱动 UDP 直连运动主机，按二进制协议编码 / 解码运动指令
模拟设备 虚拟设备实现，用于离线联调与 CI 测试
设备工厂 支持各类智能设备，按配置键动态实例化对应驱动
WS 客户端 建立实时通信层与通讯层后端保持长连接，收发控制指令
看门狗 异步心跳监控、遥操安全控制、断链检测与物理兜底
视频推流 轻量媒体服务，支持 WHIP / WHEP 标准 WebRTC 协议

看门狗（Watchdog）物理兜底机制

Section titled “看门狗（Watchdog）物理兜底机制”

边缘端设计的重中之重，是完善的物理兜底机制。在任何异常工况下，防止设备失控——看门狗确保物理世界的安全性始终优先于业务连续性。

  1. 断网即刻制动 一旦检测到网络中断，设备立即停止一切运动，并自动尝试重连，绝不在失联状态下保持运动惯性。

  2. 主动退出优雅回收 若移动端主动退出控制，设备执行优雅姿态回收（如四足机器人趴下），进入安全待机状态。

  3. 超时断联兜底 若断联持续超过阈值（如 10 分钟），看门狗判定会话失效，自动触发姿态回收与待机。

  4. 电力不足保护 当 Lite3 机器狗等硬件电力不足时，设备主动执行优雅姿态回收（趴下），防止在低电量下突然失稳跌倒造成硬件损伤。

八、跨模态联动与架构闭环

Section titled “八、跨模态联动与架构闭环”

统一账号与数据同源的目的，让原本异构孤立的终端彼此「看得见、连得上、能协作」。 如下列举展现层两类典型终端，访问统一主库数据的协同能力。

VR客户端 / 移动端App/H5 联动矩阵

Section titled “VR客户端 / 移动端App/H5 联动矩阵”
能力 ⑧ vr_client (Pico 4) ④ wpf_frontend (App/H5)
账号登录 ✅ 注册/登录 ✅ 注册/登录
好友 / IM ✅ VR⇄App ✅ App⇄VR
音视频通话 ✅ 与App互通 ✅ 与VR互通
设备视频流 ✅ 实时查看 ✅ 实时查看
设备遥操作 ✅ 实时控制 ✅ 实时控制

联动背后的架构原理

Section titled “联动背后的架构原理”

  1. 身份同源贯通 项目 ①–⑩ 共用 wpf_db.users，任一端注册即在全域生效。VR 端与 App 端得以互加好友，本质是二者查询同一张用户主表——身份同源是一切社交联动的前提。

  2. 遥操作全链贯通 移动端下发的控制指令经实时通信层的 WebSocket 连接 Map，直达 ⑤ wpf_lot 边缘节点，最终转化为运动主机的 UDP 指令，完成「云端点击 → 物理执行」的手眼闭环。

  3. 通话频道打通 核心业务层统一签发 Agora Token，使 VR 端（Pico 4）与移动端（App）进入同一音视频频道，跨越设备形态实现实时语音协作。

总结

Section titled “总结”

综上所述，WPF智能IoT系统 通过结构化分层设计与清晰的边界划分，构建了一套具备高韧性、高并发与泛化接入能力的全景式IoT生态架构。整体架构不仅在技术实现上优雅规避了跨模态协同的耦合问题，更在业务形态上彻底打通「人-机-端-云-AI」的全链路交互通道。

面向未来，整体架构凭借底层数据同源特性与极高的IoT硬件设备包容度，将持续为更复杂的智慧型业务场景、智能多模态控制场景、前沿的泛边缘算力场景赋能，提供稳固的技术基座。