# HZHub 项目总体计划

> 汇智中台建设项目总体规划

---

## 项目信息

| 属性 | 内容 |
|------|------|
| 项目名称 | HZHub 汇智中台 |
| 项目周期 | 8周（2026-03-26 ~ 2026-05-21）|
| 技术负责人 | 大壮 |
| 项目目标 | 构建企业级业务中台，集成AI能力与ERP数据适配 |

---

## 里程碑

```
2026-03-26  项目启动
    │
    ▼
2026-04-09  [M1] 基础框架完成
    │        - AI服务可用
    │        - 管理后台可用
    │        - ERP服务基础API
    │
    ▼
2026-04-23  [M2] ERP服务完成
    │        - SQL Server连接稳定
    │        - 核心数据查询API
    │        - SQL Agent可用
    │
    ▼
2026-05-07  [M3] 门户完成
    │        - 公司门户可用
    │        - 经销商门户可用
    │        - 企业微信对接
    │
    ▼
2026-05-21  [M4] 项目交付
             - 流程编排ERP节点
             - 性能优化完成
             - 文档完善
```

---

## 阶段划分

### 第一阶段：基础框架（2周）

**时间**：2026-03-26 ~ 2026-04-09

**目标**：搭建可运行的基础框架

**任务清单**：
- [x] 创建Gitea仓库
- [x] 初始化hzhub-ai（复用hzhub-ai）
- [x] 初始化hzhub-admin（复用hzhub-admin）
- [x] 配置开发环境
- [x] 启动基础设施（MySQL、Redis、Weaviate、n8n、MinIO）
- [x] 验证AI服务运行
- [x] 验证管理后台运行
- [x] 配置hzhub-portal-company
- [x] 配置hzhub-portal-dealer
- [x] RuoYi→HZHub重命名
- [ ] 测试前端登录功能
- [ ] 测试AI对话功能
- [ ] 配置模型提供商
- [ ] 编写开发文档

**交付物**：
- [x] 可运行的AI服务
- [x] 可运行的管理后台
- [x] 可运行的公司门户
- [x] 可运行的经销商门户
- [ ] 开发环境搭建文档

---

### 第二阶段：ERP服务（2周）

**时间**：2026-04-10 ~ 2026-04-23

**目标**：完成ERP数据适配服务

**任务清单**：
- [ ] 配置SQL Server连接
- [ ] 实现基础数据查询API
- [ ] 实现数据转换层
- [ ] 开发SQL Agent（SQL Server版）
- [ ] 集成到网关
- [ ] 编写ERP服务文档

**交付物**：
- ERP服务可用
- 基础查询API文档
- SQL Agent演示

---

### 第三阶段：门户开发（2周）

**时间**：2026-04-24 ~ 2026-05-07

**目标**：完成公司门户和经销商门户

**任务清单**：
- [ ] 初始化hzhub-portal-company
- [ ] 初始化hzhub-portal-dealer
- [ ] 开发公司门户页面
- [ ] 开发经销商门户页面
- [ ] 集成AI组件
- [ ] 企业微信对接
- [ ] 编写门户文档

**交付物**：
- 公司门户可用
- 经销商门户可用
- 企业微信H5可用

---

### 第四阶段：流程编排与优化（2周）

**时间**：2026-05-08 ~ 2026-05-21

**目标**：完成业务流程编排和系统优化

**任务清单**：
- [ ] 扩展流程编排ERP节点
- [ ] 性能测试与优化
- [ ] 安全加固
- [ ] 完善项目文档
- [ ] 用户培训材料
- [ ] 项目验收

**交付物**：
- 完整业务流程
- 性能测试报告
- 用户手册
- 运维文档

---

## 资源需求

### 人力资源

| 角色 | 人数 | 职责 |
|------|------|------|
| 技术负责人 | 1 | 架构设计、技术决策、代码审查 |
| 后端开发 | 2 | hzhub-ai、hzhub-erp、hzhub-gateway开发 |
| 前端开发 | 2 | hzhub-admin、hzhub-portal开发 |
| 测试 | 1 | 功能测试、性能测试 |

### 服务器资源

| 环境 | 配置 | 用途 |
|------|------|------|
| 开发环境 | 4C8G | 开发调试 |
| 测试环境 | 4C8G | 功能测试 |
| 生产环境 | 8C16G | 正式运行 |

---

## 风险管理

### 高风险

| 风险 | 影响 | 缓解措施 |
|------|------|----------|
| SQL Server 2008 R2兼容性 | 高 | 预留双数据源，可切换 |
| ERP数据结构不明 | 高 | 先做数据架构调研 |

### 中风险

| 风险 | 影响 | 缓解措施 |
|------|------|----------|
| 工期估算不准 | 中 | 分阶段交付，每阶段验收 |
| 团队学习成本 | 中 | 文档+培训 |

---

## 变更记录

| 日期 | 变更内容 | 变更原因 | 决策人 |
|------|---------|---------|--------|
| 2026-03-26 | 创建总体计划 | 项目启动 | 大壮 |
| 2026-03-27 | 更新第一阶段进度 | 提前完成基础设施部署 | 大壮 |

---

**计划版本**：v1.1  
**创建时间**：2026-03-26  
**更新时间**：2026-03-27  
**文档管理员**：大壮