Part 1: 项目概述

文档定位：本章节旨在为新加入团队的开发人员、架构师及运维人员提供项目的宏观视图，快速理解项目的业务背景、核心价值及技术底座。

1.1 项目背景与业务价值

1.1.1 项目背景

在企业数字化转型的浪潮下，AIoT Platform (ViewSh) 应运而生。该平台旨在解决传统园区、楼宇管理中“设备孤岛”、“数据割裂”和“人工效率低”的三大痛点。通过构建统一的物联网接入层和业务中台，实现对海量智能设备的集中管控，并基于设备数据驱动上层业务流程（如安保、保洁、工程），打造全场景的智慧空间解决方案。

1.1.2 核心业务价值

设备全生命周期管理：提供跨协议（TCP/MQTT/HTTP）、跨厂商设备的统一接入能力，实现设备状态实时监控与远程指令下发。
业务流程数字化：将线下的巡检、维修、保洁等作业流程线上化，结合 IoT 告警自动触发工单，实现“人机协同”。
数据驱动决策：汇聚设备运行数据与业务运营数据，为管理层提供能耗分析、人员效能评估等决策依据。

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 验证阶段。 1. 验证核心业务逻辑闭环（设备接入 -> 数据上报 -> 工单触发）。 2. 确立微服务基础架构与技术选型。 3. 完成系统服务、网关及保洁条线基础功能。	🔄 In Progress

1.5 快速上手建议

对于初次接触本项目的开发人员，建议按以下顺序进行深入：

环境准备：参考 Part 8: 开发指南完成本地 JDK 17、Maven、Docker 环境搭建。
架构理解：阅读 Part 2: 系统架构理解服务分层。
代码运行：优先启动 Gateway 和 System 服务，体验基础的用户登录与菜单功能。

4.6 KiB Raw Blame History Unescape Escape