79 lines
4.6 KiB
Markdown
79 lines
4.6 KiB
Markdown
# Part 1: 项目概述
|
||
|
||
> **文档定位**：本章节旨在为新加入团队的开发人员、架构师及运维人员提供项目的宏观视图，快速理解项目的业务背景、核心价值及技术底座。
|
||
|
||
## 1.1 项目背景与业务价值
|
||
|
||
### 1.1.1 项目背景
|
||
在企业数字化转型的浪潮下，**AIoT Platform (ViewSh)** 应运而生。该平台旨在解决传统园区、楼宇管理中“设备孤岛”、“数据割裂”和“人工效率低”的三大痛点。通过构建统一的物联网接入层和业务中台，实现对海量智能设备的集中管控，并基于设备数据驱动上层业务流程（如安保、保洁、工程），打造全场景的智慧空间解决方案。
|
||
|
||
### 1.1.2 核心业务价值
|
||
1. **设备全生命周期管理**：提供跨协议（TCP/MQTT/HTTP）、跨厂商设备的统一接入能力，实现设备状态实时监控与远程指令下发。
|
||
2. **业务流程数字化**：将线下的巡检、维修、保洁等作业流程线上化，结合 IoT 告警自动触发工单，实现“人机协同”。
|
||
3. **数据驱动决策**：汇聚设备运行数据与业务运营数据，为管理层提供能耗分析、人员效能评估等决策依据。
|
||
|
||
---
|
||
|
||
## 1.2 核心业务场景
|
||
|
||
平台核心业务覆盖**智慧物业**的四大核心条线，形成了“IoT感知 + Ops运营”的业务闭环。
|
||
|
||
### 1.2.1 智能 Ops 运营体系
|
||
* **保洁条线 (Cleaning)**
|
||
* **场景**：智能排班、耗材管理、巡检打卡。
|
||
* **联动**：公厕异味传感器自动触发保洁工单。
|
||
* **安保条线 (Security)**
|
||
* **场景**：电子巡更、岗位管理、应急报警。
|
||
* **联动**：门禁异常或视频分析（AI）自动触发安保报警事件。
|
||
* **工程条线 (Engineering)**
|
||
* **场景**：设施维保、巡检计划、备件库存管理。
|
||
* **联动**：设备故障信号（如电梯故障）自动生成维修工单。
|
||
* **客服条线 (Service)**
|
||
* **场景**：投诉建议处理、客户满意度调查、报事报修。
|
||
|
||
### 1.2.2 IoT 物联网连接
|
||
* **设备接入**：支持海量异构设备接入，包括摄像头、门禁、道闸、环境传感器、楼宇BA系统等。
|
||
* **规则引擎**：基于设备上报属性或事件，配置灵活的规则（如：温度 > 30℃ -> 触发报警）。
|
||
|
||
---
|
||
|
||
## 1.3 技术栈总览
|
||
|
||
本项目采用当前主流的 **Spring Cloud Alibaba** 微服务架构，结合 **IoT** 特性引入了时序数据库和高性能网络框架。
|
||
|
||
| 分层 | 关键技术 | 版本 (当前) | 说明 |
|
||
| :--- | :--- | :--- | :--- |
|
||
| **应用层** | **Spring Boot** | 3.5.9 | 基础应用框架 |
|
||
| **微服务** | **Spring Cloud Alibaba** | 2023.0.3.3 | 服务治理 (Nacos, Sentinel, Seata) |
|
||
| | **Spring Cloud** | 2025.0.0 | 微服务标准实现 |
|
||
| **IoT 接入** | **Netty / Vert.x** | 4.2.9 / 4.5.22 | 高性能网络通信，支持 TCP/MQTT |
|
||
| **数据存储** | **MySQL** / Domestic DBs | 8.x / DM8 | 关系型业务数据存储 |
|
||
| | **TDengine** | 3.7.9 | 时序数据库，存储设备遥测数据 |
|
||
| | **Redis** | 7.x (Redisson 3.52) | 缓存与分布式锁 |
|
||
| **消息中间件** | **RocketMQ** | 5.x (Starter 2.3.5) | 高吞吐消息削峰填谷，事件解耦 |
|
||
| **工作流** | **Flowable** | 7.2.0 | 复杂业务流程引擎 (工单、审批) |
|
||
| **运维监控** | **SkyWalking** | 9.5.0 | 分布式链路追踪与 APM |
|
||
| | **XXL-JOB** | 2.4.0 | 分布式任务调度 |
|
||
|
||
> **💡 架构特点**：
|
||
> * **读写分离**：业务数据走 MySQL，海量设备日志走 TDengine。
|
||
> * **事件驱动**：核心业务解耦，基于 RocketMQ 实现“设备 -> 消息 -> 业务”的异步处理。
|
||
> * **多租户**：支持 SaaS 模式，数据层面做租户隔离。
|
||
|
||
---
|
||
|
||
## 1.4 版本演进历史
|
||
|
||
| 版本号 | 发布日期 | 里程碑内容 | 状态 |
|
||
| :--- | :--- | :--- | :--- |
|
||
| **v0.1.0** | 2026-01-14 | **MVP 验证阶段**。<br>1. 验证核心业务逻辑闭环（设备接入 -> 数据上报 -> 工单触发）。<br>2. 确立微服务基础架构与技术选型。<br>3. 完成系统服务、网关及保洁条线基础功能。 | 🔄 In Progress |
|
||
|
||
---
|
||
|
||
## 1.5 快速上手建议
|
||
|
||
对于初次接触本项目的开发人员，建议按以下顺序进行深入：
|
||
1. **环境准备**：参考 [Part 8: 开发指南](../08-开发指南.md) 完成本地 JDK 17、Maven、Docker 环境搭建。
|
||
2. **架构理解**：阅读 [Part 2: 系统架构](../02-系统架构.md) 理解服务分层。
|
||
3. **代码运行**：优先启动 `Gateway` 和 `System` 服务，体验基础的用户登录与菜单功能。
|