# ry-mon

**Repository Path**: atp2p/ry-mon

## Basic Information

- **Project Name**: ry-mon
- **Description**: test test 测试
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-30
- **Last Updated**: 2026-07-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 嘉云运维系统 - 后端项目说明

本文件是嘉云运维系统后端项目`ry-mon`的说明文档。该系统是一个完整的机房监控和运维管理平台，采用前后端分离架构，本项目为后端部分，提供丰富的API接口。前端项目位于`r-monui`目录下。

## 项目概述

嘉云运维系统是一个综合智能运维管理平台，主要用于机房设备监控、环境监测、视频监控和运维巡检管理等功能。该系统采用前后端分离架构，后端提供丰富的API接口，前端提供直观的用户界面。

## 技术栈

### 后端（ry-mon）
- **框架**：Spring Boot 2.5.15、Spring Security
- **数据库**：MySQL
- **缓存**：Redis
- **认证**：JWT
- **构建工具**：Maven
- **Java版本**：1.8
- **监控工具**：自定义ry-monitor模块

## 项目结构

```
ry-mon/
├── ruoyi-admin/        # 后台管理模块，系统入口
├── ruoyi-common/       # 通用工具类模块
├── ruoyi-framework/    # 框架核心模块
├── ruoyi-generator/    # 代码生成器模块
├── ruoyi-quartz/       # 定时任务模块
├── ruoyi-system/       # 系统管理模块
├── ry-monitor/         # 机房监控模块
├── doc/                # 文档目录
├── pub/                # 发布相关文件
├── sql/                # 数据库脚本
└── pom.xml             # Maven项目配置文件
```

## 功能模块

### 后端主要功能

1. **系统管理**：用户管理、角色管理、菜单管理、部门管理、字典管理等
2. **权限认证**：基于JWT的多终端认证系统，支持细粒度权限控制
3. **机房监控**：设备监控、环境监测、告警管理
4. **视频监控**：支持RTSP协议的视频流接入和管理
5. **定时任务**：基于Quartz的定时任务调度
6. **数据采集**：通过API接口采集各种设备数据
7. **数据分析**：对采集的数据进行处理和分析

## 部署说明

### 后端部署

1. **准备环境**
   - JDK 1.8
   - MySQL 5.7+
   - Redis 5.0+

2. **数据库初始化**
   - 导入`ry-mon/sql/`目录下的SQL脚本

3. **配置修改**
   - 修改`ruoyi-admin/src/main/resources/application.yml`中的数据库和Redis连接信息

4. **打包部署**
   - 使用Maven打包：`mvn clean package`
   - 运行：`java -jar ruoyi-admin.jar`
   - 或使用提供的脚本：`./ry.sh start`（Linux）或`ry.bat`（Windows）

## API接口说明

系统提供了丰富的API接口，主要包括：

1. **设备监控接口**：获取设备状态、配置设备参数等
2. **环境监测接口**：获取温湿度、电压电流等环境数据
3. **视频监控接口**：RTSP流接入和控制
4. **告警管理接口**：获取告警信息、处理告警等
5. **系统管理接口**：用户、角色、权限管理等
6. **第三方系统接口**：与软派、华三、华为等外部系统的集成接口

详细接口说明请参考`ry-mon/doc/readme_api.txt`文件。

### 第三方系统集成接口

#### 1. 软派动环系统接口
软派动环系统主要用于机房动力环境监控，系统集成了其告警信息采集功能。

- **访问地址**：http://10.1.2.55:3000
- **登录信息**：admin/admin
- **主要功能**：采集动环设备告警信息、环境监测数据等
- **相关文档**：`ry-mon/doc/动环-软派/动环系统--软云接口文档 v1.2(1)(1)(1).docx`

#### 2. 华三系统接口
华三系统提供网络设备监控和告警管理功能，系统通过API调用获取华三设备的告警信息。

- **访问地址**：http://192.168.5.77:8080/imc/login.jsf
- **登录信息**：admin/Ocn@1234
- **告警接口**：通过`H3ClientTask`定时任务获取华三设备告警信息
- **告警级别**：支持二级阈值（较严重）、三级阈值（轻微）、四级阈值（重要/高危）等多级别告警

#### 3. 华为系统接口
华为系统提供网络设备管理和监控功能，系统通过REST API调用获取华为设备的告警信息。

- **后台地址**：https://192.168.3.77:31943
- **登录信息**：admin/BS@yyl#Mar04
- **认证接口**：`/unisso/v2/validateUser.action`
- **会话接口**：`/unisess/v1/auth/session`
- **数据接口**：`/restconf/v2/data/huawei-nce-customer-inventory:customers`
- **证书配置**：需要导入华为系统证书到JDK信任库中

### 告警信息处理
系统对各厂商的告警信息进行统一处理，主要包括：

- 告警信息标准化：将不同厂商格式的告警信息转换为系统统一格式
- 告警级别映射：将厂商自定义告警级别映射到系统标准级别（INFO、WARN、ERROR、FATAL）
- 告警推送：支持短信、邮件等多种告警通知方式
- 告警记录：所有告警信息均记录到数据库，支持历史查询和统计分析

## 开发指南

### 后端开发
1. 克隆项目：`git clone <项目地址>`
2. 导入IDE（如IntelliJ IDEA）
3. 配置数据库和Redis连接
4. 启动开发环境：运行`RuoyiApplication`类

## 注意事项

1. **安全配置**：生产环境中请修改默认的用户名和密码
2. **配置文件**：根据实际环境修改配置文件中的各项参数
3. **端口占用**：确保所需端口（如8080、6379等）未被占用
4. **VPN访问**：部分功能可能需要通过VPN访问，具体配置请参考`ry-mon/doc/readme_vpn.txt`

## 在线体验

- 账号：admin
- 密码：admin123

## 版权信息

本项目由嘉云团队开发，版权所有。

---

更新日期：2024年