refactor: 将 RuoYi 标记替换为 HZHub

This commit is contained in:
2026-03-27 06:42:14 +00:00
parent 849adec937
commit f115a793a7
988 changed files with 4836 additions and 4590 deletions

View File

@@ -1,7 +1,7 @@
# RuoYi-AI 后端项目审查报告
# HZHub-AI 后端项目审查报告
> 审查时间2026-03-26
> 项目路径:/data/ruoyi-ai/ruoyi-ai/
> 项目路径:/data/hzhub-ai/hzhub-ai/
---
@@ -11,7 +11,7 @@
| 属性 | 内容 |
|------|------|
| 项目名称 | RuoYi-AI |
| 项目名称 | HZHub-AI |
| 定位 | 企业级AI助手平台 |
| 版本 | 3.0.0 |
| 技术栈 | Spring Boot 3.5.8 + Spring AI + LangChain4j |
@@ -33,20 +33,20 @@
### 2.1 整体架构
```
ruoyi-ai/
hzhub-ai/
├── pom.xml # 父POM版本统一管理
├── ruoyi-admin/ # 管理后台模块Spring Boot启动类
├── ruoyi-common/ # 公共组件库25个子模块
│ ├── ruoyi-common-core # 核心工具类
│ ├── ruoyi-common-chat # AI相关公共类
│ ├── ruoyi-common-satoken # Sa-Token认证
│ ├── ruoyi-common-redis # Redis封装
│ ├── ruoyi-common-mybatis # MyBatis Plus封装
├── hzhub-admin/ # 管理后台模块Spring Boot启动类
├── hzhub-common/ # 公共组件库25个子模块
│ ├── hzhub-common-core # 核心工具类
│ ├── hzhub-common-chat # AI相关公共类
│ ├── hzhub-common-satoken # Sa-Token认证
│ ├── hzhub-common-redis # Redis封装
│ ├── hzhub-common-mybatis # MyBatis Plus封装
│ └── ... # 其他公共模块
├── ruoyi-extend/ # 扩展模块
└── ruoyi-modules/ # 业务模块
├── hzhub-extend/ # 扩展模块
└── hzhub-modules/ # 业务模块
├── ruoyi-chat/ # AI核心模块聊天、知识库、MCP
├── ruoyi-aiflow/ # 流程编排模块
├── hzhub-aiflow/ # 流程编排模块
├── ruoyi-workflow/ # 工作流模块
├── ruoyi-system/ # 系统管理模块
└── ruoyi-generator/ # 代码生成器
@@ -55,9 +55,9 @@ ruoyi-ai/
### 2.2 模块依赖关系
```
ruoyi-admin (启动模块)
├── ruoyi-modules/* (业务模块)
│ └── ruoyi-common/* (公共组件)
hzhub-admin (启动模块)
├── hzhub-modules/* (业务模块)
│ └── hzhub-common/* (公共组件)
```
**设计特点**
@@ -149,7 +149,7 @@ public interface SqlAgent extends Agent {
2. **工具声明**:明确可用工具及其使用顺序
3. **类型安全**:通过接口定义输入输出
### 4.2 ruoyi-aiflow 模块(流程编排)
### 4.2 hzhub-aiflow 模块(流程编排)
#### 4.2.1 架构设计
@@ -256,7 +256,7 @@ MCP工具类型
```xml
<dependency>
<groupId>com.ruoyi</groupId>
<artifactId>ruoyi-common-tenant</artifactId>
<artifactId>hzhub-common-tenant</artifactId>
</dependency>
```
@@ -266,7 +266,7 @@ MCP工具类型
### 7.1 架构设计借鉴
| 方面 | RuoYi-AI实践 | HZHub应用 |
| 方面 | HZHub-AI实践 | HZHub应用 |
|------|-------------|-----------|
| 模块化 | 25个common子模块 | 提取ERP适配公共组件 |
| 多模块 | modules独立部署 | AI/ERP/Gateway分离 |
@@ -298,7 +298,7 @@ hzhub-ai/
├── modules/
│ ├── hzhub-chat/ # AI聊天复用ruoyi-chat
│ ├── hzhub-erp/ # ERP服务新增
│ └── hzhub-aiflow/ # 流程编排(复用ruoyi-aiflow
│ └── hzhub-aiflow/ # 流程编排(复用hzhub-aiflow
└── hzhub-admin/ # 启动模块
```
@@ -316,7 +316,7 @@ hzhub-ai/
### 8.2 升级建议
1. **保持RuoYi-AI版本**使用当前稳定版3.5.8
1. **保持HZHub-AI版本**使用当前稳定版3.5.8
2. **独立ERP服务**:避免双数据源复杂性
3. **逐步迁移**先复用chat模块再扩展ERP功能
@@ -334,7 +334,7 @@ hzhub-ai/
### 9.2 下一步行动
1. 复用 `ruoyi-chat` 模块作为 `hzhub-ai` 基础
2. 复用 `ruoyi-aiflow` 模块作为流程编排引擎
2. 复用 `hzhub-aiflow` 模块作为流程编排引擎
3. 开发 `hzhub-erp` 模块参考SQL Agent模式
4. 整合三个模块构建HZHub完整后端