335 lines
11 KiB
Markdown
335 lines
11 KiB
Markdown
# 酒店服务管理系统项目分析报告
|
||
|
||
## 1. 项目概览
|
||
|
||
### 1.1 项目简介
|
||
本项目是一个基于 .NET 5.0 开发的酒店服务管理系统，主要用于酒店客房控制单元（RCU）的集中管理、监控和配置。系统提供了完整的酒店设备管理、数据监控、固件升级等功能，支持多酒店集团的统一管理。
|
||
|
||
### 1.2 主要功能
|
||
- RCU设备管理和状态监控
|
||
- 酒店和房间信息管理
|
||
- 固件和配置文件下发
|
||
- 实时数据统计和图表分析
|
||
- UDP通信日志管理
|
||
- 系统状态监控和服务管理
|
||
|
||
### 1.3 技术栈
|
||
| 类别 | 技术/框架 | 版本 |
|
||
|------|----------|------|
|
||
| 后端 | .NET Core | 5.0 |
|
||
| 前端 | ASP.NET Core MVC | 5.0 |
|
||
| 前端 | jQuery, Bootstrap | - |
|
||
| 前端 | AdminLTE | - |
|
||
| 数据库 | SQL Server | - |
|
||
| 缓存 | Redis | - |
|
||
| 日志 | log4net | - |
|
||
| 日志 | Aliyun Api LogService | - |
|
||
| 任务调度 | Quartz | 3.4.0 |
|
||
| 认证 | JWT | 5.0.15 |
|
||
|
||
## 2. 项目结构
|
||
|
||
### 2.1 目录结构
|
||
```
|
||
Web_HotelServices_Prod/
|
||
├── Aliyun.Api.LogService/ # 阿里云日志服务SDK
|
||
├── COMMON/ # 通用工具类库
|
||
├── DB_Server/ # 数据库操作类库
|
||
├── Models/ # 数据模型
|
||
├── SERVER/ # 核心服务逻辑
|
||
├── ServerHelp/ # 服务辅助工具
|
||
├── TcpServer/ # TCP服务器
|
||
├── WebUI/ # Web前端和API
|
||
├── .gitignore
|
||
├── HotelServices.sln
|
||
├── README.md
|
||
└── 项目分析报告.md
|
||
```
|
||
|
||
### 2.2 核心模块说明
|
||
|
||
#### 2.2.1 SERVER模块
|
||
- **RCUServer.cs**：RCU设备管理核心逻辑，负责设备状态查询和管理
|
||
- **Send_Cmd.cs**：命令下发模块，用于向RCU设备发送控制命令
|
||
- **SYNC_DATA.cs**：数据同步模块
|
||
- **CacheData.cs**：缓存数据管理
|
||
- **ModelFile.cs**：模型文件管理
|
||
|
||
#### 2.2.2 WebUI模块
|
||
- **Controllers/**：API控制器，处理前端请求
|
||
- **Views/**：MVC视图文件
|
||
- **wwwroot/**：静态资源文件
|
||
- **Startup.cs**：应用启动配置
|
||
|
||
#### 2.2.3 Models模块
|
||
- **Models/**：数据实体模型
|
||
- **Data/**：数据库初始化
|
||
|
||
#### 2.2.4 COMMON模块
|
||
- **XC_Redis.cs**：Redis缓存操作
|
||
- **LogHelp.cs**：日志帮助类
|
||
- **ASLS.cs**：阿里云日志服务操作
|
||
|
||
## 3. 技术架构
|
||
|
||
### 3.1 系统架构
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
subgraph 前端层
|
||
A[Web浏览器] -->|HTTP请求| B[ASP.NET Core MVC]
|
||
B -->|返回视图| A
|
||
end
|
||
|
||
subgraph 应用层
|
||
B -->|调用| C[API控制器]
|
||
C -->|业务逻辑| D[核心服务模块]
|
||
D -->|数据操作| E[数据访问层]
|
||
end
|
||
|
||
subgraph 数据层
|
||
E -->|读写| F[SQL Server]
|
||
E -->|缓存| G[Redis]
|
||
D -->|日志| H[阿里云日志服务]
|
||
end
|
||
|
||
subgraph 服务层
|
||
I[TCP服务器] -->|数据| D
|
||
J[定时任务] -->|触发| D
|
||
end
|
||
```
|
||
|
||
### 3.2 核心流程图
|
||
|
||
#### RCU设备状态查询流程
|
||
|
||
```mermaid
|
||
sequenceDiagram
|
||
participant Client as 前端
|
||
participant API as ApiController
|
||
participant RcuServer as RcuServer
|
||
participant DB as 数据库
|
||
participant Redis as Redis缓存
|
||
|
||
Client->>API: 请求RCU设备列表
|
||
API->>RcuServer: 调用SetRucServer方法
|
||
RcuServer->>DB: 查询在线RCU设备
|
||
RcuServer->>DB: 关联查询房间和酒店信息
|
||
RcuServer->>Redis: 获取缓存数据
|
||
RcuServer-->>API: 返回设备列表
|
||
API-->>Client: 响应JSON数据
|
||
```
|
||
|
||
#### 固件下发流程
|
||
|
||
```mermaid
|
||
sequenceDiagram
|
||
participant Client as 前端
|
||
participant API as ApiController
|
||
participant SendCmd as Send_Cmd
|
||
participant Redis as Redis缓存
|
||
participant RCU as RCU设备
|
||
|
||
Client->>API: 发送固件升级请求
|
||
API->>Redis: 清除旧的缓存状态
|
||
API->>SendCmd: 调用Send_File方法
|
||
SendCmd->>RCU: 下发固件文件
|
||
SendCmd->>Redis: 更新进度状态
|
||
Client->>API: 查询升级进度
|
||
API->>Redis: 获取进度数据
|
||
API-->>Client: 返回进度信息
|
||
```
|
||
|
||
## 4. 核心功能模块
|
||
|
||
### 4.1 RCU设备管理
|
||
- **设备状态监控**：实时监控RCU设备的在线状态
|
||
- **设备信息管理**：管理RCU设备的基本信息、配置和固件版本
|
||
- **设备分组**：支持按酒店、房间类型等维度分组管理
|
||
|
||
### 4.2 酒店和房间管理
|
||
- **酒店集团管理**：支持多酒店集团的层级管理
|
||
- **房间信息管理**：管理房间基本信息、类型和状态
|
||
- **房间与RCU关联**：建立房间与RCU设备的对应关系
|
||
|
||
### 4.3 固件和配置管理
|
||
- **固件文件管理**：上传、删除和管理固件文件
|
||
- **配置文件管理**：管理设备配置文件
|
||
- **远程升级**：支持远程下发固件和配置到RCU设备
|
||
- **升级进度监控**：实时监控升级进度
|
||
|
||
### 4.4 数据统计和分析
|
||
- **通信数据统计**：统计UDP通信包数量和字节流量
|
||
- **设备状态分析**：分析设备在线率和运行状态
|
||
- **图表可视化**：通过ECharts展示各类统计数据
|
||
- **历史数据分析**：分析历史数据趋势
|
||
|
||
### 4.5 系统监控和管理
|
||
- **服务状态监控**：监控系统各服务的运行状态
|
||
- **日志管理**：收集和管理系统日志
|
||
- **定时任务**：通过Quartz实现定时任务调度
|
||
- **系统配置**：管理系统基本配置
|
||
|
||
## 5. API设计
|
||
|
||
### 5.1 主要API端点
|
||
|
||
#### 5.1.1 设备管理API
|
||
- **GetRCU**：获取RCU设备列表，支持分页和筛选
|
||
- **SendCmd**：下发固件或配置到RCU设备
|
||
- **Send_Schedule**：查询固件下发进度
|
||
|
||
#### 5.1.2 酒店管理API
|
||
- **HOTELINFO**：获取酒店信息列表
|
||
- **ROOMINFO**：获取房间信息列表
|
||
- **Sel**：切换当前管理的酒店
|
||
|
||
#### 5.1.3 文件管理API
|
||
- **SelModelFile**：获取模型文件列表
|
||
- **AddModelFile**：上传模型文件
|
||
- **DelModelFile**：删除模型文件
|
||
|
||
#### 5.1.4 数据统计API
|
||
- **GetCHARTS**：获取通信数据统计图表
|
||
- **GetErrorSucess**：获取错误和成功统计
|
||
- **GetProt**：获取端口数据使用情况
|
||
- **GetPROCESSINGTIME**：获取处理耗时统计
|
||
|
||
#### 5.1.5 系统管理API
|
||
- **Token**：刷新令牌并返回服务状态
|
||
- **Changerserver**：更改服务状态
|
||
|
||
### 5.2 API设计特点
|
||
- **基于MVC控制器**：使用ASP.NET Core MVC控制器处理请求
|
||
- **REST风格**：采用RESTful API设计理念
|
||
- **JSON响应**：统一返回JSON格式数据
|
||
- **错误处理**：完善的异常捕获和日志记录
|
||
- **Redis缓存**：使用Redis缓存提升性能
|
||
|
||
## 6. 技术亮点
|
||
|
||
### 6.1 完整的RCU设备管理体系
|
||
- 建立了完整的RCU设备生命周期管理
|
||
- 支持设备状态实时监控和历史数据分析
|
||
- 提供了丰富的设备管理和配置功能
|
||
|
||
### 6.2 实时数据监控和统计分析
|
||
- 实时监控RCU设备状态和通信数据
|
||
- 提供多维度的数据统计和图表分析
|
||
- 支持自定义时间范围的数据查询
|
||
|
||
### 6.3 多酒店集团管理
|
||
- 支持多酒店集团的层级管理
|
||
- 实现了酒店和房间的树形结构管理
|
||
- 提供了灵活的权限控制机制
|
||
|
||
### 6.4 定时任务调度系统
|
||
- 使用Quartz实现定时任务调度
|
||
- 支持多种任务类型和调度策略
|
||
- 实现了系统状态检测和数据同步
|
||
|
||
### 6.5 完善的日志管理
|
||
- 集成了log4net和阿里云日志服务
|
||
- 实现了多级别、多目标的日志记录
|
||
- 提供了日志查询和分析功能
|
||
|
||
## 7. 优化空间
|
||
|
||
### 7.1 代码结构优化
|
||
- **模块化重构**：进一步优化代码结构，提高模块独立性
|
||
- **代码规范**：统一代码风格和命名规范
|
||
- **注释完善**：增加代码注释，提高可维护性
|
||
|
||
### 7.2 性能优化
|
||
- **数据库优化**：优化数据库查询，添加适当索引
|
||
- **缓存策略**：优化Redis缓存策略，减少数据库访问
|
||
- **并发处理**：优化并发处理逻辑，提高系统吞吐量
|
||
|
||
### 7.3 安全性增强
|
||
- **身份认证**：加强身份认证和授权机制
|
||
- **数据加密**：对敏感数据进行加密存储
|
||
- **输入验证**：加强输入验证，防止注入攻击
|
||
- **安全审计**：增加安全审计日志
|
||
|
||
### 7.4 前端技术栈更新
|
||
- **前端框架**：考虑使用现代前端框架如Vue.js或React
|
||
- **响应式设计**：优化移动端适配
|
||
- **性能优化**：减少前端加载时间，优化用户体验
|
||
|
||
### 7.5 文档完善
|
||
- **技术文档**：完善系统架构和技术文档
|
||
- **API文档**：生成API接口文档
|
||
- **使用手册**：编写用户使用手册
|
||
|
||
### 7.6 部署优化
|
||
- **容器化**：考虑使用Docker容器化部署
|
||
- **CI/CD**：建立持续集成和持续部署流程
|
||
- **监控告警**：增加系统监控和告警机制
|
||
|
||
## 8. 总结
|
||
|
||
### 8.1 项目价值
|
||
- **提升管理效率**：实现了RCU设备的集中管理，提高了管理效率
|
||
- **降低运营成本**：通过远程管理和监控，减少了现场维护成本
|
||
- **提高服务质量**：实时监控设备状态，及时发现和解决问题
|
||
- **数据驱动决策**：通过数据分析，为管理决策提供依据
|
||
|
||
### 8.2 技术价值
|
||
- **完整的.NET生态**：展示了.NET Core在企业级应用中的完整实践
|
||
- **模块化设计**：体现了良好的模块化设计思想
|
||
- **多技术整合**：整合了多种技术栈，形成完整的解决方案
|
||
- **可扩展性**：系统设计具有良好的可扩展性和可维护性
|
||
|
||
### 8.3 未来展望
|
||
- **技术升级**：持续跟进.NET技术发展，进行技术栈升级
|
||
- **功能扩展**：根据业务需求，不断扩展系统功能
|
||
- **智能化**：引入人工智能技术，实现设备故障预测和智能运维
|
||
- **云原生**：向云原生架构演进，提高系统弹性和可靠性
|
||
|
||
## 9. 附录
|
||
|
||
### 9.1 关键文件列表
|
||
|
||
| 文件路径 | 功能描述 |
|
||
|---------|---------|
|
||
| SERVER/RcuServer.cs | RCU设备管理核心逻辑 |
|
||
| SERVER/Send_Cmd.cs | 命令下发模块 |
|
||
| WebUI/Controllers/ApiController.cs | API控制器 |
|
||
| WebUI/Startup.cs | 应用启动配置 |
|
||
| COMMON/XC_Redis.cs | Redis缓存操作 |
|
||
| Models/Models/TBL_RCU_BASIC_INFO.cs | RCU设备基础信息模型 |
|
||
| Models/Models/TBL_HOTEL_BASIC_INFO.cs | 酒店基础信息模型 |
|
||
|
||
### 9.2 核心API列表
|
||
|
||
| API端点 | HTTP方法 | 功能描述 |
|
||
|---------|---------|---------|
|
||
| /Api/GetRCU | POST | 获取RCU设备列表 |
|
||
| /Api/SendCmd | POST | 下发固件或配置 |
|
||
| /Api/Send_Schedule | POST | 查询下发进度 |
|
||
| /Api/HOTELINFO | POST | 获取酒店信息 |
|
||
| /Api/ROOMINFO | POST | 获取房间信息 |
|
||
| /Api/SelModelFile | POST | 获取模型文件列表 |
|
||
| /Api/AddModelFile | POST | 上传模型文件 |
|
||
| /Api/DelModelFile | POST | 删除模型文件 |
|
||
| /Api/GetCHARTS | POST | 获取通信数据统计 |
|
||
| /Api/Token | POST | 刷新令牌和服务状态 |
|
||
|
||
### 9.3 技术依赖
|
||
|
||
| 依赖项 | 版本 | 用途 |
|
||
|-------|------|------|
|
||
| Microsoft.AspNetCore.Authentication.JwtBearer | 5.0.15 | JWT认证 |
|
||
| Microsoft.EntityFrameworkCore | 5.0.15 | 数据库访问 |
|
||
| Microsoft.EntityFrameworkCore.SqlServer | 5.0.15 | SQL Server驱动 |
|
||
| Quartz | 3.4.0 | 定时任务调度 |
|
||
| UtilsSharp | 2.5.0 | 工具类库 |
|
||
| log4net | - | 日志记录 |
|
||
| Redis | - | 缓存管理 |
|
||
| Aliyun.Api.LogService | - | 阿里云日志服务 |
|
||
|
||
---
|
||
|
||
**报告生成时间**：2026-01-21
|
||
**项目版本**：基于当前代码库分析
|
||
**分析工具**：手动代码分析 + 项目结构扫描 |