Boonlive_RD_Web/Web_CRICS_Server_VS2010_Prod
8
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
fe9a71d896f325b5c7a98e74d0afb24074e520c1
Web_CRICS_Server_VS2010_Prod/README.md

323 lines
11 KiB
Markdown
Raw Normal View History

初始化CRICS
2025-12-11 09:17:16 +08:00
# CRICS_V3 - 酒店客房智能控制系统
## 项目概述
CRICS（Customer Room Intelligent Control System）是一套酒店客房智能控制系统，用于管理酒店客房的智能设备控制、状态监控和数据统计等功能。
---
## 技术框架
### 开发环境
- **IDE**: Visual Studio 2010+
- **目标框架**: .NET Framework 4.0
- **解决方案格式**: VS 2010 Solution Format Version 11.00
### 核心技术栈
| 分类 | 技术/框架 | 版本 | 说明 |
|------|----------|------|------|
| **Web框架** | ASP.NET MVC | 2.0 | Web应用程序框架 |
| **IoC容器** | Spring.NET | 1.3.x | 依赖注入、AOP支持 |
| **ORM框架** | NHibernate | 3.0 | 对象关系映射 |
| **数据库** | SQL Server | - | 关系型数据库 |
| **缓存** | Redis (CSRedis) | - | 分布式缓存 |
| **缓存** | Memcached | - | 内存缓存 |
| **日志** | log4net | 1.2.10 | 日志记录框架 |
| **JSON处理** | Newtonsoft.Json | 6.0 | JSON序列化/反序列化 |
| **通信协议** | UDP | - | RCU主机通信 |
| **消息队列** | MQTT (M2Mqtt) | 4.3 | 消息传输 |
| **任务调度** | FluentScheduler | 4.1.2 | 定时任务调度 |
| **Excel处理** | NPOI | - | Excel文件读写 |
| **HTTP客户端** | RestSharp | 105.2.3 | REST API调用 |
| **JWT** | jose-jwt | - | JWT令牌处理 |
### 前端技术
- **UI框架**: EasyUI 1.4.2
- **JavaScript库**: jQuery
---
## 项目结构
```
CRICS_V3_1124/
├── CRICS_V3_1124.sln # 解决方案文件
├── README.md # 项目说明文档
├── Para.prom # 参数配置文件
├── Para_copy.yaml # YAML配置文件
│
├── WebSite/ # Web应用程序（主项目）
│ ├── Controllers/ # MVC控制器
│ ├── Views/ # 视图模板
│ ├── Models/ # 视图模型
│ ├── Config/ # Spring.NET配置
│ ├── api/ # API接口
│ ├── Core/ # 核心业务逻辑
│ ├── Job/ # 定时任务
│ ├── Scripts/ # JavaScript脚本
│ ├── Styles/ # CSS样式
│ ├── Images/ # 图片资源
│ └── easyui-1.4.2/ # EasyUI前端框架
│
├── RCUHost/ # RCU主机通信服务
│ ├── Implement/ # 接口实现
│ │ ├── HostServer.cs # UDP服务器核心
│ │ ├── *Receiver.cs # 各类命令接收器
│ │ └── ReceiverContext.cs # 接收器上下文
│ ├── Protocols/ # 通信协议定义
│ ├── Config/ # 配置文件
│ ├── RCUHostCommon/ # 通用工具类
│ ├── NewUDP/ # 新版UDP处理
│ └── TimingHelper/ # 定时辅助工具
│
├── Domain/ # 领域模型层
│ ├── *.cs # 实体类定义
│ └── *.hbm.xml # NHibernate映射文件
│
├── Dao/ # 数据访问层
│ ├── I*Repository.cs # 仓储接口
│ ├── Implement/ # 仓储实现
│ └── RepositoryBase`1.cs # 泛型仓储基类
│
├── Service/ # 业务逻辑层
│ ├── I*Manager.cs # 服务接口
│ ├── Implement/ # 服务实现
│ └── GenericManagerBase`1.cs # 泛型服务基类
│
├── Common/ # 公共工具库
│ ├── CSRedisCacheHelper.cs # Redis缓存帮助类
│ ├── MemoryCacheHelper.cs # 内存缓存帮助类
│ ├── AliyunSMSHelper.cs # 阿里云短信帮助类
│ ├── ExcelHelper.cs # Excel帮助类
│ ├── HttpWebRequestHelper.cs # HTTP请求帮助类
│ ├── Tools.cs # 通用工具类
│ ├── BLWMQTT.cs # MQTT客户端
│ ├── XiaoDuOperation.cs # 小度音箱操作
│ ├── TianMaoOperation.cs # 天猫精灵操作
│ ├── RokidOperation.cs # Rokid操作
│ └── ... # 其他工具类
│
├── CommonEntity/ # 公共实体层
│ ├── CacheDTO.cs # 缓存数据传输对象
│ ├── CacheKey.cs # 缓存键定义
│ ├── DataTongJi.cs # 数据统计实体
│ └── ... # 其他实体类
│
├── ConsoleApplication1/ # 控制台测试程序1
├── ConsoleApplication2/ # 控制台测试程序2
├── ConsoleApplication3/ # 控制台测试程序3
├── ConsoleApplication666/ # 控制台测试程序
├── test/ # 测试项目
├── MyIPY/ # Python互操作项目
│
├── DBSql/ # 数据库脚本
│ └── crics.sql # 数据库初始化脚本
│
├── lib/ # 第三方依赖库
│ ├── Spring.NET/ # Spring.NET程序集
│ ├── NHibernate/ # NHibernate程序集
│ ├── Redis/ # Redis客户端
│ ├── Memcached/ # Memcached客户端
│ ├── log4net/ # 日志组件
│ ├── NPOI/ # Excel处理组件
│ ├── RestSharp/ # REST客户端
│ ├── jwt/ # JWT组件
│ ├── M2Mqtt.Net/ # MQTT客户端
│ ├── taskschedule/ # 任务调度组件
│ └── ... # 其他依赖
│
└── CA/ # 证书/许可证文件
```
---
## 分层架构
```
┌─────────────────────────────────────────────────────────┐
│ 表现层 (WebSite) │
│ Controllers / Views / Scripts / Styles │
├─────────────────────────────────────────────────────────┤
│ 业务逻辑层 (Service) │
│ I*Manager / *Manager │
├─────────────────────────────────────────────────────────┤
│ 数据访问层 (Dao) │
│ I*Repository / *Repository │
├─────────────────────────────────────────────────────────┤
│ 领域模型层 (Domain) │
│ Entity Classes / HBM Mappings │
├─────────────────────────────────────────────────────────┤
│ 基础设施层 │
│ Common (工具类) / CommonEntity (公共实体) / RCUHost │
└─────────────────────────────────────────────────────────┘
```
---
## 核心模块说明
### 1. RCUHost - RCU主机通信服务
RCU（Room Control Unit）主机通信服务是系统的核心组件，负责与酒店客房内的智能控制主机进行UDP通信。
**主要功能：**
- UDP服务器监听和数据接收
- 协议解析和命令分发
- 设备状态实时同步
- 心跳检测和在线状态维护
- Redis消息发布/订阅
**核心类：**
- `HostServer.cs` - UDP服务器核心实现
- `*Receiver.cs` - 各类命令接收处理器
- `ReceiverContext.cs` - 请求上下文
**支持的命令类型：**
- 0x01 - 主机注册
- 0x02 - 心跳
- 0x0E - 状态上报
- 0x32-0x36 - 新版协议命令
- 更多命令参见 `CommandType` 枚举
### 2. 智能语音设备集成
系统支持多种智能语音设备：
- **小度音箱** - 百度小度
- **天猫精灵** - 阿里天猫
- **Rokid** - Rokid智能音箱
功能包括：欢迎词播放、离房提示、设备重置等。
### 3. 缓存策略
**多级缓存架构：**
- **L1**: MemoryCache (进程内缓存)
- **L2**: Redis (分布式缓存)
- **L3**: Memcached (可选)
**缓存应用场景：**
- 主机在线状态
- 设备状态数据
- 取电状态
- 配置信息
### 4. 消息队列
使用Redis Pub/Sub进行消息通信：
- `redis-takecard_change` - 取电状态变更
- `redis-serviceinfo_change` - 服务信息变更
- `redis-on_off_line` - 上下线状态
---
## 数据库设计
**数据库**: SQL Server
**数据库名**: CRICS
### 主要数据表
| 表名 | 说明 |
|------|------|
| tb_Host | 主机信息 |
| tb_HostModal | 主机回路模块 |
| tb_RoomType | 房间类型 |
| tb_RoomStatus | 房间状态 |
| tb_SysHotel | 酒店信息 |
| tb_SysUser | 系统用户 |
| tb_AlarmSetting | 告警设置 |
| tb_FaultRecord | 故障记录 |
| tb_HostModalEnergy | 能耗统计 |
| ... | 更多表参见DBSql |
---
## 配置文件说明
### Spring.NET 配置
配置文件位于各项目的 `Config` 目录下：
- `WebSite/Config/Controllers.xml` - 控制器依赖注入配置
- `Service/Config/*.xml` - 服务层配置
- `Dao/Config/*.xml` - 数据访问层配置
- `RCUHost/Config/*.xml` - RCU服务配置
### Web.config
主要配置项：
- 数据库连接字符串
- NHibernate配置
- log4net日志配置
- Spring.NET配置
- Redis连接配置
---
## 依赖注入
项目使用 **Spring.NET** 作为IoC容器，通过XML配置文件进行依赖注入。
**配置示例：**
```xml
<object type="WebSite.Controllers.HostController, WebSite" parent="BaseController" singleton="false">
<property name="HostManager" ref="Manager.Host" />
<property name="HostAirManager" ref="Manager.HostAir" />
...
</object>
```
---
## 开发指南
### 环境要求
- Visual Studio 2010 或更高版本
- .NET Framework 4.0
- SQL Server 2008 或更高版本
- Redis Server
- IIS (部署用)
### 项目构建
1. 使用Visual Studio打开 `CRICS_V3_1124.sln`
2. 还原NuGet包（如有）
3. 配置数据库连接字符串
4. 执行 `DBSql/crics.sql` 初始化数据库
5. 构建解决方案
### 调试运行
1. 设置 `WebSite` 为启动项目
2. 配置IIS Express或本地IIS
3. F5启动调试
---
## 主要功能模块
1. **设备控制** - 灯光、空调、窗帘、电视等
2. **状态监控** - 实时状态查看、告警通知
3. **场景管理** - 场景配置、一键控制
4. **能耗统计** - 用电量统计、能耗分析
5. **用户管理** - 权限控制、角色管理
6. **酒店管理** - 多酒店支持、分组管理
7. **API接口** - 第三方系统集成
8. **微信控制** - 微信公众号集成
9. **语音控制** - 智能音箱集成
---
## 版本信息
- **版本**: V3
- **最后更新**: 2024年12月
---
## 注意事项
1. RCU通信使用UDP协议，注意防火墙配置
2. Redis缓存需要正确配置连接信息
3. 数据库初始化脚本需要根据实际情况修改路径
4. 生产环境部署注意安全配置
Reference in New Issue Copy Permalink