HZHub 汇智中台

基于 HZHub-AI 构建的企业级业务中台系统

项目简介

HZHub（汇智中台）是面向企业级市场的业务中台系统，集成 AI 能力与 ERP 数据适配，支持多门户接入。

系统架构

┌─────────────────────────────────────────────────────────────────────────┐
│                           前端接入层                                      │
├─────────────────┬─────────────────┬─────────────────────────────────────┤
│   管理后台        │   员工门户        │           经销商门户                  │
│  (hzhub-admin)   │ (hzhub-portal-  │       (hzhub-portal-dealer)         │
│   · 模型管理      │   employee)     │          · 企业微信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服务（复用hzhub-ai）
├── hzhub-erp/                  # ERP服务（新建）
├── hzhub-gateway/              # API网关（新建）
├── hzhub-admin/                # 管理后台（复用hzhub-admin）
├── hzhub-portal-employee/      # 员工门户（复用hzhub-portal）
├── hzhub-portal-dealer/        # 经销商门户（复用hzhub-portal）
├── hzhub-deploy/               # 部署配置
│   └── docker-compose.yml
└── docs/                       # 项目文档
    ├── README.md
    ├── architecture/
    │   ├── README.md
    │   ├── hzhub-architecture.png
    │   └── hzhub-architecture-cn.png
    └── learnings/
        ├── 01-hzhub-ai-backend-review.md
        ├── 02-hzhub-admin-frontend-review.md
        ├── 03-hzhub-portal-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.5.8 + LangChain4j 1.11.0
ERP服务	Spring Boot 3.x + JDBC
向量数据库	Weaviate 1.25.0
关系数据库	MySQL 8.0
缓存	Redis 7
工作流	n8n
对象存储	MinIO
部署	Docker Compose

项目状态

• ✅ 基础设施 Docker 化 (MySQL, Redis, Weaviate, n8n, MinIO)
• ✅ AI服务 Docker 化 (hzhub-ai)
• ✅ 前端管理后台 Docker 化 (hzhub-admin)
• ⏳ ERP服务 (开发中)
• ⏳ API网关 (开发中)
• ⏳ 员工门户 (待配置)
• ⏳ 经销商门户 (待配置)

快速开始

环境准备

• Docker & Docker Compose
• JDK 17+ (本地开发)
• Node.js 22+ (本地开发)
• pnpm 10+ (本地开发)
• Maven 3.9+ (本地开发)

一键启动（Docker Compose）

cd hzhub-deploy
docker-compose up -d

启动完成后访问：

• 🌐 管理后台: http://localhost:5666
• 🚀 员工门户: http://localhost:5137
• 🔧 AI服务API: http://localhost:6039
• 🔄 n8n工作流: http://localhost:5678

本地开发启动（后台运行）

项目提供了便捷的后台运行管理脚本：

# 一键启动所有服务
cd /data/hzhub
./start-all.sh

# 查看所有服务状态
./status-all.sh

# 一键停止所有服务
./stop-all.sh

或分别启动各服务：

# 启动后端服务
cd hzhub-ai
./start.sh     # 启动
./status.sh    # 查看状态
./logs.sh      # 查看日志
./stop.sh      # 停止

# 启动管理后台
cd hzhub-admin
./start.sh

# 启动员工门户
cd hzhub-portal-employee
./start.sh

📖 详细说明请查看 服务管理文档

服务清单

服务名	容器名	端口	说明
hzhub-admin	hzhub-deploy-hzhub-admin	5666	管理后台前端(Nginx)
hzhub-ai	hzhub-deploy-hzhub-ai	6039	AI后端服务(Spring Boot)
mysql	hzhub-mysql	3306	MySQL 8.0数据库
redis	hzhub-redis	6379	Redis 7缓存
weaviate	hzhub-weaviate	28080	Weaviate向量数据库
n8n	hzhub-n8n	5678	n8n工作流引擎
minio	hzhub-deploy-minio-1	9000	MinIO对象存储
etcd	hzhub-deploy-etcd-1	2379	etcd服务发现

本地开发启动

后端服务

# AI服务
cd hzhub-ai/hzhub-admin
mvn spring-boot:run -Dspring-boot.run.profiles=dev

前端开发

# 管理后台
cd hzhub-admin
pnpm install
pnpm dev

前端生产构建

cd hzhub-admin
# 先构建依赖包
pnpm build
# 再构建前端
pnpm --filter=@vben/web-antd build:prod

常用命令

# 查看所有服务状态
docker-compose ps

# 查看服务日志
docker-compose logs -f hzhub-ai
docker-compose logs -f hzhub-admin

# 重启服务
docker-compose restart hzhub-ai

# 停止所有服务
docker-compose down

# 停止并删除数据卷（谨慎使用）
docker-compose down -v

文档

• 架构设计
• 学习报告

开源协议

MIT License

创建时间

2026-03-26