159 lines
5.8 KiB
Markdown
159 lines
5.8 KiB
Markdown
# HZHub 汇智中台
|
||
|
||
> 基于 RuoYi-AI 构建的企业级业务中台系统
|
||
|
||
## 项目简介
|
||
|
||
HZHub（汇智中台）是面向企业级市场的业务中台系统，集成 AI 能力与 ERP 数据适配，支持多门户接入。
|
||
|
||
## 系统架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────────────┐
|
||
│ 前端接入层 │
|
||
├─────────────────┬─────────────────┬─────────────────────────────────────┤
|
||
│ 管理后台 │ 公司门户 │ 经销商门户 │
|
||
│ (hzhub-admin) │ (hzhub-portal- │ (hzhub-portal-dealer) │
|
||
│ · 模型管理 │ company) │ · 企业微信H5 │
|
||
│ · 知识库配置 │ · 企业微信H5 │ · 自助开单 │
|
||
│ · 智能体编排 │ · 审批流程 │ · 自助对账/发货 │
|
||
│ · 系统管理 │ · 经销商管理 │ · 进销存 │
|
||
│ │ · 销售CRM │ · 营销素材库 │
|
||
│ │ · BI报表 │ · AI素材生成 │
|
||
│ │ · AI应用集成 │ │
|
||
└────────┬────────┴────────┬────────┴──────────────────┬──────────────────┘
|
||
│ │ │
|
||
└─────────────────┴──────────────────────────┘
|
||
│
|
||
┌─────────┴─────────┐
|
||
│ API网关层 │
|
||
│ (HZHub-Gateway) │
|
||
│ · 统一鉴权 │
|
||
│ · 路由转发 │
|
||
│ · 限流熔断 │
|
||
└─────────┬─────────┘
|
||
│
|
||
┌────────────────────┼────────────────────┐
|
||
│ │ │
|
||
┌────┴────┐ ┌────┴────┐ ┌────┴────┐
|
||
│ HZHub │ │ HZHub │ │ n8n │
|
||
│ -AI │ │ -ERP │ │ (工作流) │
|
||
│ (AI服务) │ │ (ERP服务)│ │ │
|
||
├─────────┤ ├─────────┤ └─────────┘
|
||
│·Spring │ │·Spring │
|
||
│ Boot 3.x│ │ Boot 3.x│
|
||
│·Spring │ │·JDBC │
|
||
│ AI 2.0 │ │·SQL Svr │
|
||
│·LangChain│ │ 2008 R2 │
|
||
│ 4j │ │·双数据源│
|
||
│·MySQL │ │ 预留 │
|
||
│·Milvus │ │ │
|
||
│·RAG/智能体│ │ │
|
||
└─────────┘ └─────────┘
|
||
```
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
hzhub/
|
||
├── hzhub-ai/ # AI服务（复用ruoyi-ai）
|
||
├── hzhub-erp/ # ERP服务（新建）
|
||
├── hzhub-gateway/ # API网关（新建）
|
||
├── hzhub-admin/ # 管理后台（复用ruoyi-admin）
|
||
├── hzhub-portal-company/ # 公司门户（复用ruoyi-web）
|
||
├── hzhub-portal-dealer/ # 经销商门户（复用ruoyi-web）
|
||
├── hzhub-deploy/ # 部署配置
|
||
│ └── docker-compose.yml
|
||
└── docs/ # 项目文档
|
||
├── README.md
|
||
├── architecture/
|
||
│ ├── README.md
|
||
│ ├── hzhub-architecture.png
|
||
│ └── hzhub-architecture-cn.png
|
||
└── learnings/
|
||
├── 01-ruoyi-ai-backend-review.md
|
||
├── 02-ruoyi-admin-frontend-review.md
|
||
├── 03-ruoyi-web-user-frontend-review.md
|
||
└── 04-summary-analysis.md
|
||
```
|
||
|
||
## 技术栈
|
||
|
||
| 层级 | 技术选型 |
|
||
|------|---------|
|
||
| 前端 | Vue 3 + TypeScript |
|
||
| 管理后台UI | Ant Design Vue (Vben Admin) |
|
||
| 门户UI | Element Plus X |
|
||
| 网关 | Spring Cloud Gateway |
|
||
| AI服务 | Spring Boot 3.x + Spring AI + LangChain4j |
|
||
| ERP服务 | Spring Boot 3.x + JDBC |
|
||
| 向量数据库 | Milvus |
|
||
| 关系数据库 | MySQL 8.0 + SQL Server 2008 R2 |
|
||
| 工作流 | n8n |
|
||
| 部署 | Docker Compose |
|
||
|
||
## 快速开始
|
||
|
||
### 环境准备
|
||
|
||
- JDK 17+
|
||
- Node.js 20+
|
||
- pnpm 9+
|
||
- Maven 3.8+
|
||
- Docker & Docker Compose
|
||
|
||
### 启动基础设施
|
||
|
||
```bash
|
||
cd hzhub-deploy
|
||
docker-compose up -d
|
||
```
|
||
|
||
### 启动后端服务
|
||
|
||
```bash
|
||
# AI服务
|
||
cd hzhub-ai/ruoyi-admin
|
||
mvn spring-boot:run
|
||
|
||
# ERP服务
|
||
cd hzhub-erp
|
||
mvn spring-boot:run
|
||
|
||
# 网关服务
|
||
cd hzhub-gateway
|
||
mvn spring-boot:run
|
||
```
|
||
|
||
### 启动前端
|
||
|
||
```bash
|
||
# 管理后台
|
||
cd hzhub-admin
|
||
pnpm install
|
||
pnpm dev
|
||
|
||
# 公司门户
|
||
cd hzhub-portal-company
|
||
pnpm install
|
||
pnpm dev
|
||
|
||
# 经销商门户
|
||
cd hzhub-portal-dealer
|
||
pnpm install
|
||
pnpm dev
|
||
```
|
||
|
||
## 文档
|
||
|
||
- [架构设计](./docs/architecture/README.md)
|
||
- [学习报告](./docs/learnings/)
|
||
|
||
## 开源协议
|
||
|
||
MIT License
|
||
|
||
## 创建时间
|
||
|
||
2026-03-26
|