Initial commit: HZHub project setup with RuoYi-AI base

2026-03-26 09:47:46 +00:00
commit 3584e491cc
5005 changed files with 318595 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,158 @@
+# 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