# HZHub 汇智中台

> 基于 HZHub-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 4.0│         │ Boot 4.0│
    │·Spring  │         │·JDBC    │
    │ AI 2.0  │         │·SQL Svr │
    │·LangChain│        │ 2008 R2 │
    │ 4j      │         │·双数据源│
    │·MySQL   │         │ 预留    │
    │·Milvus  │         │         │
    │·RAG/智能体│        │         │
    └─────────┘         └─────────┘
```

## 项目结构

```
foshanhuiya/hzhub/
├── hzhub-ai/              # AI服务（基于hzhub-ai，Spring Boot 4.0）
├── hzhub-erp/             # ERP服务（Spring Boot 4.0）
├── hzhub-gateway/         # API网关（Spring Boot 4.0）
├── hzhub-admin/           # 管理后台前端
├── hzhub-portal-employee/  # 公司门户前端
├── hzhub-portal-dealer/   # 经销商门户前端
└── hzhub-deploy/          # 部署脚本与配置
```

## 技术栈

| 层级 | 技术选型 |
|------|---------|
| 前端 | Vue 3 + Element Plus |
| 网关 | Spring Cloud Gateway |
| AI服务 | Spring Boot 4.0 + Spring AI 2.0 + LangChain4j |
| ERP服务 | Spring Boot 4.0 + JDBC |
| 向量数据库 | Milvus |
| 关系数据库 | MySQL 8.0 + SQL Server 2008 R2 |
| 工作流 | n8n |
| 部署 | Docker Compose |

## 文档索引

- [架构设计](./architecture/README.md)
- [开发规范](./development/README.md)
- [部署指南](./deployment/README.md)

## 创建时间

2026-03-26