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
> 分析对象:ruoyi-ai后端ruoyi-admin管理后台ruoyi-web(用户前端)
> 分析对象:hzhub-ai后端hzhub-admin管理后台hzhub-portal(用户前端)
---
@@ -11,9 +11,9 @@
```
┌─────────────────────────────────────────────────────────────────┐
RuoYi-AI 生态系统 │
HZHub-AI 生态系统 │
├─────────────────┬─────────────────┬─────────────────────────────┤
ruoyi-webruoyi-admin │ ruoyi-ai │
hzhub-portalhzhub-admin │ hzhub-ai │
│ (用户前端) │ (管理后台) │ (后端服务) │
├─────────────────┼─────────────────┼─────────────────────────────┤
│ · AI对话界面 │ · 系统管理 │ · 多模型接入 │
@@ -34,7 +34,7 @@
### 1.2 技术栈对比
| 层级 | ruoyi-web | ruoyi-admin | ruoyi-ai |
| 层级 | hzhub-portal | hzhub-admin | hzhub-ai |
|------|-----------|-------------|----------|
| **框架** | Vue 3 | Vue 3 | Spring Boot 3.5.8 |
| **UI库** | Element Plus X | Ant Design Vue | - |
@@ -49,7 +49,7 @@
## 二、各项目深度分析
### 2.1 ruoyi-ai后端- 核心引擎
### 2.1 hzhub-ai后端- 核心引擎
**架构评分**⭐⭐⭐⭐⭐5/5
@@ -68,11 +68,11 @@
| 模块 | 价值 | HZHub复用度 |
|------|------|-------------|
| ruoyi-chat | AI聊天、知识库、MCP | 90% |
| ruoyi-aiflow | 流程编排引擎 | 90% |
| hzhub-aiflow | 流程编排引擎 | 90% |
| ruoyi-system | 系统管理 | 80% |
| ruoyi-common | 公共组件库 | 85% |
| hzhub-common | 公共组件库 | 85% |
### 2.2 ruoyi-admin管理后台- 配置中心
### 2.2 hzhub-admin管理后台- 配置中心
**架构评分**⭐⭐⭐⭐⭐5/5
@@ -95,7 +95,7 @@
| 知识库管理 | 文档、片段管理 | 85% |
| MCP工具管理 | 工具、市场 | 80% |
### 2.3 ruoyi-web(用户前端)- 交互界面
### 2.3 hzhub-portal(用户前端)- 交互界面
**架构评分**⭐⭐⭐⭐4/5
@@ -124,13 +124,13 @@
### 3.1 复用矩阵
| RuoYi资产 | HZHub目标 | 复用策略 | 工作量 |
| HZHub资产 | HZHub目标 | 复用策略 | 工作量 |
|-----------|-----------|----------|--------|
| ruoyi-chat模块 | hzhub-ai | 直接复用 | 低 |
| ruoyi-aiflow模块 | hzhub-ai | 直接复用 | 低 |
| hzhub-aiflow模块 | hzhub-ai | 直接复用 | 低 |
| ruoyi-system模块 | hzhub-admin | 直接复用 | 低 |
| ruoyi-admin整体 | hzhub-admin | 改造AI模块为ERP模块 | 中 |
| ruoyi-web组件 | hzhub-portal-* | 复用组件,改造业务 | 中 |
| hzhub-admin整体 | hzhub-admin | 改造AI模块为ERP模块 | 中 |
| hzhub-portal组件 | hzhub-portal-* | 复用组件,改造业务 | 中 |
| SQL Agent | hzhub-erp | 改造为SQL Server版 | 高 |
### 3.2 推荐技术路线
@@ -139,25 +139,25 @@
HZHub 技术栈决策:
后端 (hzhub-ai / hzhub-erp / hzhub-gateway)
├── Spring Boot 3.5.8(与ruoyi-ai一致暂不用4.0
├── Spring Boot 3.5.8(与hzhub-ai一致暂不用4.0
├── LangChain4j 1.11.0
├── MyBatis Plus 3.5.14
├── Sa-Token 1.44.0
└── 复用ruoyi-ai的common模块
└── 复用hzhub-ai的common模块
管理后台 (hzhub-admin)
├── Vue 3 + TypeScript
├── Vben Admin复用ruoyi-admin架构
├── Vben Admin复用hzhub-admin架构
├── Ant Design Vue
├── pnpm workspace + Turbo
└── 复用ruoyi-admin的packages
└── 复用hzhub-admin的packages
门户前端 (hzhub-portal-company / hzhub-portal-dealer)
├── Vue 3 + TypeScript
├── Element Plus X复用ruoyi-web组件)
├── Element Plus X复用hzhub-portal组件)
├── UnoCSS
├── Pinia
└── 复用ruoyi-web的组件模式
└── 复用hzhub-portal的组件模式
```
### 3.3 开发优先级
@@ -165,7 +165,7 @@ HZHub 技术栈决策:
| 优先级 | 模块 | 依赖 | 预计工期 |
|--------|------|------|----------|
| P0 | hzhub-ai | 复用ruoyi-chat | 1周 |
| P0 | hzhub-admin | 复用ruoyi-admin | 1周 |
| P0 | hzhub-admin | 复用hzhub-admin | 1周 |
| P1 | hzhub-erp | 自研SQL Server适配 | 2-3周 |
| P1 | hzhub-portal-company | 复用+改造 | 2周 |
| P2 | hzhub-portal-dealer | 复用+改造 | 2周 |
@@ -178,7 +178,7 @@ HZHub 技术栈决策:
### 4.1 后端架构决策
**决策1Spring Boot版本**
- 选择3.5.8(与ruoyi-ai一致
- 选择3.5.8(与hzhub-ai一致
- 理由稳定性优先4.0升级成本未知
**决策2ERP服务独立**
@@ -197,7 +197,7 @@ HZHub 技术栈决策:
**决策2门户前端框架**
- 选择Element Plus X
- 理由:ruoyi-web组件可直接复用
- 理由:hzhub-portal组件可直接复用
**决策3样式方案**
- 选择Admin用Tailwind门户用UnoCSS
@@ -207,7 +207,7 @@ HZHub 技术栈决策:
**决策1向量数据库**
- 选择Milvus
- 理由:ruoyi-ai原生支持性能优秀
- 理由:hzhub-ai原生支持性能优秀
**决策2ERP数据源**
- 选择直连SQL Server 2008 R2
@@ -244,8 +244,8 @@ HZHub 技术栈决策:
**任务**
1. 创建Gitea仓库初始化项目结构
2. 复制ruoyi-ai代码到hzhub-ai
3. 复制ruoyi-admin代码到hzhub-admin
2. 复制hzhub-ai代码到hzhub-ai
3. 复制hzhub-admin代码到hzhub-admin
4. 验证基础功能运行
**产出**
@@ -298,7 +298,7 @@ HZHub 技术栈决策:
## 七、总结
### 7.1 RuoYi-AI价值评估
### 7.1 HZHub-AI价值评估
| 维度 | 评分 | 说明 |
|------|------|------|
@@ -308,17 +308,17 @@ HZHub 技术栈决策:
| 可复用性 | ⭐⭐⭐⭐⭐ | 模块化设计,易于复用 |
| 社区活跃度 | ⭐⭐⭐⭐ | 较新项目,发展迅速 |
**总体评价**RuoYi-AI是构建HZHub的**理想基础**可以大幅缩短开发周期估计节省3-4个月
**总体评价**HZHub-AI是构建HZHub的**理想基础**可以大幅缩短开发周期估计节省3-4个月
### 7.2 HZHub建设路径
```
基于RuoYi-AI构建HZHub的核心策略
基于HZHub-AI构建HZHub的核心策略
1. 复用为主70%
- 直接复用ruoyi-chat、ruoyi-aiflow
- 直接复用ruoyi-admin系统管理
- 复用ruoyi-web组件
- 直接复用ruoyi-chat、hzhub-aiflow
- 直接复用hzhub-admin系统管理
- 复用hzhub-portal组件
2. 改造为辅20%
- 改造AI模块为ERP模块
@@ -334,7 +334,7 @@ HZHub 技术栈决策:
### 7.3 下一步行动
1. **立即执行**创建Gitea仓库初始化项目
2. **本周完成**:复制ruoyi-ai和ruoyi-admin代码
2. **本周完成**:复制hzhub-ai和hzhub-admin代码
3. **下周开始**ERP服务开发
4. **持续进行**:文档更新和团队培训