iot-dc3

README

<p align="right">
  <a href="https://gitee.com/pnoker/iot-dc3/blob/main/README.md">English</a> | <a href="https://gitee.com/pnoker/iot-dc3/blob/main/README.zh.md">中文</a> | <a href="https://gitee.com/pnoker/iot-dc3/blob/main/README.ja.md">日本語</a> | <a href="https://gitee.com/pnoker/iot-dc3/blob/main/README.vi.md">Tiếng Việt</a> | <a href="https://gitee.com/pnoker/iot-dc3/blob/main/README.ko.md">한국어</a> | <a href="https://gitee.com/pnoker/iot-dc3/blob/main/README.es.md">Español</a> | <a href="https://gitee.com/pnoker/iot-dc3/blob/main/README.ru.md">Русский</a>
</p>

> **AI 助手：** 请先阅读 [README.ai.md](https://gitee.com/pnoker/iot-dc3/blob/main/README.ai.md) 获取 IoT DC3 的 AI 友好概述。

<p align="center">
  <img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/044c4324ab03f8c285cc1f4f.png" alt="IoT DC3 — 连接物理世界与 AI，面向 Physical AI 的开源工业物联网 Runtime">
</p>

<p align="center">
  <a href="https://github.com/pnoker/iot-dc3/stargazers">
    <img src="https://img.shields.io/github/stars/pnoker/iot-dc3?style=flat&logo=github&color=green" alt="GitHub Stars">
  </a>
  <a href="https://gitee.com/pnoker/iot-dc3/stargazers">
    <img src="https://gitee.com/pnoker/iot-dc3/badge/star.svg?theme=gvp" alt="Gitee Star">
  </a>
  <a href="https://gitee.com/pnoker/iot-dc3/members">
    <img src="https://gitee.com/pnoker/iot-dc3/badge/fork.svg?theme=gvp" alt="Gitee Fork">
  </a>
  <a href="https://github.com/pnoker/iot-dc3/graphs/contributors">
    <img src="https://img.shields.io/github/contributors/pnoker/iot-dc3?label=contributors&color=orange" alt="Contributors">
  </a>
  <img src="https://img.shields.io/badge/License-AGPL%203.0-blue" alt="License">
  <img src="https://img.shields.io/badge/Java-21-orange?logo=openjdk" alt="Java 21">
  <img src="https://img.shields.io/badge/Spring%20Boot-4.1-6DB33F?logo=springboot" alt="Spring Boot 4.1">
</p>

<p align="center">
  <strong>
    IoT DC3 — 连接物理世界与 AI<br>
    面向 Physical AI 的开源工业物联网 Runtime
  </strong>
</p>

<p align="center">
  <a href="https://dc3.site">https://dc3.site</a>
</p>

<p align="center">
  🔌 <strong>多协议接入</strong> &nbsp;·&nbsp;
  🤖 <strong>MCP 工具网关</strong> &nbsp;·&nbsp;
  ☁️ <strong>云原生微服务</strong>
</p>

<p align="center">
  <em>
    IoT DC3 将<strong>设备</strong>与<strong>应用</strong>解耦：驱动把标准化后的点位数据推入消息总线，应用通过统一 API
    消费数据——换设备无需改动应用，加应用无需触碰设备。
  </em>
</p>

---

## 📸 产品预览

<table>
  <tr>
    <th width="33%">📸 平台概览</th>
    <th width="33%">📸 设备管理</th>
    <th width="33%">📸 智能体</th>
  </tr>
  <tr>
    <td align="center">
      <img src="https://docs.dc3.site/images/screenshot-overview.png" alt="平台首页仪表盘" width="100%">
      <br>
      <strong>平台首页 / 仪表盘</strong><br>
      <em>系统概览 · 设备在线统计 · 数据趋势图表</em>
    </td>
    <td align="center">
      <img src="https://docs.dc3.site/images/screenshot-device.png" alt="设备管理页面" width="100%">
      <br>
      <strong>设备管理页面</strong><br>
      <em>设备列表 · 在线状态指示 · 搜索筛选</em>
    </td>
    <td align="center">
      <img src="https://docs.dc3.site/images/screenshot-ai.png" alt="智能体助手页面" width="100%">
      <br>
      <strong>智能体助手</strong><br>
      <em>自然语言查询设备 · 数据洞察 · 受控执行</em>
    </td>
  </tr>
</table>

## 🏗️ 架构概览

### 产品架构全景

![IoT DC3 产品架构全景](https://docs.dc3.site/images/architecture-panorama-zh.png)

六层微服务架构一览：客户端 → 网关 → 四个中心服务 → 消息总线 → 36 协议驱动 → 现场设备。PostgreSQL（TimescaleDB + pgvector +
AGE）持久层与可选运维栈（ELK + Prometheus + Grafana）一并铺开。

🧱 **设计原则** — 跨服务调用统一经 Facade 接口；DO/BO/VO 三层模型严格分离持久化、业务与接口形态；租户隔离贯穿数据库、缓存到
API 全链路。边界清晰，易于规模化扩展与多团队协作。

> 📖 完整架构文档请参阅 [系统架构总览](https://docs.dc3.site/zh/architecture/)。

## ✨ 核心特性

### 🔌 多协议设备接入

内置 **36 个接入驱动模块**，覆盖工业自动化、物联网通信、数据桥接、基础通信与仿真调试场景，降低常见设备与数据源的接入成本：

| 分类                        | 驱动模块                                                                                                                                                                                     |
|-----------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 🏭 **工业协议**             | Modbus TCP · Modbus RTU · OPC UA · OPC DA · Siemens S7 · BACnet/IP · EtherNet/IP · Omron FINS · Mitsubishi MELSEC · IEC 60870-5-104 · IEC 61850 · DNP3 · DLMS · DLT645 · KNX · M-Bus · SL651 |
| 📡 **物联网协议**           | MQTT · CoAP · LwM2M · HTTP · BLE · Zigbee · LoRaWAN                                                                                                                                          |
| 🗄️ **数据桥接**             | MySQL · PostgreSQL · Oracle · SQL Server · Redis                                                                                                                                             |
| 🔧 **基础通信、消息与管理** | TCP/UDP · Serial · SNMP · CAN · Kafka                                                                                                                                                        |
| 🧪 **仿真与调试**           | Virtual · Listening Virtual                                                                                                                                                                  |

提供完整的 **Driver SDK**，支持快速开发自定义协议驱动，热插拔注册到运行平台。

### 🤖 从设备数据到 Physical AI

智能体中心基于 **Spring AI** 构建，平台通过 MCP 工具网关向 AI 智能体开放设备能力，让智能体在**安全、可控、可追溯**的闭环中作用于物理世界：

- **MCP 工具网关** — 外部 AI 智能体通过 Model Context Protocol 接入：OAuth 客户端注册、按工具授权、每次工具调用全程审计
- **自然语言辅助运维** — LLM 通过 Tool-Calling 机制，在权限受控下查询设备、读写数据点、辅助执行命令
- **智能告警分析** — AI 辅助分析告警原因，提供处置建议
- **数据洞察** — 自然语言查询设备数据，自动生成可视化图表
- **多模型支持** — 兼容 OpenAI API 标准，可接入 GPT、Claude、DeepSeek、通义千问等主流模型
- **对话记忆** — 支持多轮对话与上下文记忆，持久化到数据库

### 🏗️ 云原生微服务

基于 **Spring Boot 4 + Spring Cloud 2025** 构建的分布式微服务架构：

- **服务治理** — Spring Cloud Gateway 统一入口，静态路由 + 环境变量灵活配置
- **高效通信** — gRPC 服务间调用，Protobuf 序列化
- **横向扩展** — 无状态设计，支持按业务负载独立扩缩容
- **容错韧性** — 可替换服务节点，故障自动隔离

### 📊 实时数据引擎

- **数据采集** — 驱动层实时采集设备遥测数据，通过内部消息队列异步传输——可按部署插拔选择：RabbitMQ（默认）、Kafka、Pulsar 或任意 MQTT 5 broker
- **时序存储** — 支持实时与历史数据的高效查询
- **规则