Initial commit: HZHub project setup with RuoYi-AI base
This commit is contained in:
129
docs/architecture/README.md
Normal file
129
docs/architecture/README.md
Normal file
@@ -0,0 +1,129 @@
|
||||
# HZHub 架构设计文档
|
||||
|
||||
## 1. 系统概述
|
||||
|
||||
### 1.1 项目背景
|
||||
|
||||
HZHub（汇智中台）是基于 RuoYi-AI 构建的企业级业务中台系统，旨在：
|
||||
- 对内包装对接 ERP 系统
|
||||
- 对外打通企业微信
|
||||
- 提供 AI 能力赋能业务
|
||||
|
||||
### 1.2 核心目标
|
||||
|
||||
1. **业务中台系统建设**：三大门户（后台管理、公司门户、经销商门户）
|
||||
2. **ERP 智能开发助手**：通过 AI 方式开发和维护 ERP 系统
|
||||
3. **产品供应链管理优化**：智能库存、供应商绩效等
|
||||
|
||||
## 2. 系统架构
|
||||
|
||||
### 2.1 整体架构
|
||||
|
||||
```
|
||||
前端层 → 网关层 → 服务层 → 数据层
|
||||
```
|
||||
|
||||
### 2.2 服务划分
|
||||
|
||||
| 服务 | 职责 | 技术栈 |
|
||||
|------|------|--------|
|
||||
| hzhub-gateway | 统一入口、鉴权、路由 | Spring Cloud Gateway |
|
||||
| hzhub-ai | AI 核心能力 | Spring Boot 4.0 + Spring AI 2.0 |
|
||||
| hzhub-erp | ERP 数据适配 | Spring Boot 4.0 + JDBC |
|
||||
| hzhub-admin | 管理后台前端 | Vue 3 |
|
||||
| hzhub-portal-company | 公司门户前端 | Vue 3 |
|
||||
| hzhub-portal-dealer | 经销商门户前端 | Vue 3 |
|
||||
|
||||
### 2.3 数据存储
|
||||
|
||||
| 存储 | 用途 | 说明 |
|
||||
|------|------|------|
|
||||
| MySQL | 业务数据 | 用户信息、权限、配置 |
|
||||
| Milvus | 向量数据 | 知识库文档向量、语义检索 |
|
||||
| SQL Server 2008 R2 | ERP 数据 | 直连 ERP 数据库 |
|
||||
|
||||
## 3. 关键设计决策
|
||||
|
||||
### 3.1 ERP 服务独立部署
|
||||
|
||||
**决策**：ERP 服务独立为一个微服务
|
||||
|
||||
**理由**：
|
||||
- 数据源完全隔离，避免双数据源复杂性
|
||||
- SQL Server 2008 R2 驱动兼容性风险隔离
|
||||
- 未来 ERP 升级或替换不影响 AI 服务
|
||||
|
||||
### 3.2 AI 能力以组件形式集成
|
||||
|
||||
**决策**：AI 用户端不独立部署，以组件形式嵌入两个门户
|
||||
|
||||
**理由**：
|
||||
- 减少独立系统维护成本
|
||||
- 用户体验更统一
|
||||
- 权限管理更简单
|
||||
|
||||
### 3.3 企业微信多实体分别对接
|
||||
|
||||
**决策**：四个企业微信实体（集团/汇亚/恒福/玛缇）分别对接
|
||||
|
||||
**实现**：门户层通过 `corpId` 区分实体，共用一套代码
|
||||
|
||||
## 4. 接口契约（预留）
|
||||
|
||||
### 4.1 ERP 服务接口
|
||||
|
||||
```java
|
||||
@RestController
|
||||
@RequestMapping("/erp/v1")
|
||||
public interface ErpApi {
|
||||
|
||||
@PostMapping("/query")
|
||||
Result<PageResult> query(@RequestBody ErpQueryRequest request);
|
||||
|
||||
@PostMapping("/execute")
|
||||
Result<Void> execute(@RequestBody ErpExecuteRequest request);
|
||||
|
||||
@GetMapping("/schema/{tableName}")
|
||||
Result<TableSchema> getSchema(@PathVariable String tableName);
|
||||
}
|
||||
```
|
||||
|
||||
### 4.2 AI 服务接口
|
||||
|
||||
复用 ruoyi-ai 提供的接口，通过网关暴露。
|
||||
|
||||
## 5. 部署架构
|
||||
|
||||
### 5.1 网络分区
|
||||
|
||||
| 服务 | 部署位置 | 访问方式 |
|
||||
|------|---------|---------|
|
||||
| 管理后台 | 内网 | 内网访问 |
|
||||
| 公司门户 | 内网 | 内网 + 企业微信 H5 |
|
||||
| 经销商门户 | 外网（DMZ） | 公网 + 企业微信 H5 |
|
||||
| 网关/AI/ERP/n8n | 内网 | 网关统一入口 |
|
||||
|
||||
### 5.2 安全边界
|
||||
|
||||
- 外网入口：Nginx SSL + WAF + IP 白名单
|
||||
- 网关层：JWT 鉴权 + 接口权限 + 限流
|
||||
- 服务间：内网隔离，Feign 调用 + Token 传递
|
||||
|
||||
## 6. 技术风险
|
||||
|
||||
| 风险 | 影响 | 应对措施 |
|
||||
|------|------|---------|
|
||||
| SQL Server 2008 R2 驱动兼容性 | ERP 服务无法启动 | 预留双数据源，可切换 |
|
||||
| Spring Boot 4.0 较新 | 第三方库适配问题 | 优先使用官方 starter |
|
||||
| ruoyi-ai 早期阶段 | API 可能变化 | 复制代码而非 fork，自主可控 |
|
||||
|
||||
## 7. 后续待办
|
||||
|
||||
1. ERP 数据架构专项调研
|
||||
2. SQL Server JDBC 驱动兼容性验证
|
||||
3. Milvus Docker 部署测试
|
||||
4. 企业微信多实体对接方案细化
|
||||
|
||||
---
|
||||
|
||||
创建时间：2026-03-26
|
||||
Reference in New Issue
Block a user