Initial commit: HZHub project setup with RuoYi-AI base

docs/project/plan/master-plan.md

@@ -0,0 +1,190 @@
+# 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（复用ruoyi-ai）
+- [x] 初始化hzhub-admin（复用ruoyi-admin）
+- [ ] 配置开发环境
+- [ ] 启动基础设施（MySQL、Redis、Milvus）
+- [ ] 验证AI服务运行
+- [ ] 验证管理后台运行
+- [ ] 编写开发文档
+
+**交付物**：
+- 可运行的AI服务
+- 可运行的管理后台
+- 开发环境搭建文档
+
+---
+
+### 第二阶段：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 | 创建总体计划 | 项目启动 | 大壮 |
+
+---
+
+**计划版本**：v1.0  
+**创建时间**：2026-03-26  
+**更新时间**：2026-03-26  
+**文档管理员**：大壮

docs/project/plan/phase-1.md

@@ -0,0 +1,152 @@
+# 第一阶段计划：基础框架搭建
+
+> 时间：2026-03-26 ~ 2026-04-09（2周）
+
+---
+
+## 阶段目标
+
+搭建可运行的基础框架，包括：
+- AI服务可用（hzhub-ai）
+- 管理后台可用（hzhub-admin）
+- 基础设施就绪（MySQL、Redis、Milvus、n8n）
+- 开发环境配置完成
+
+---
+
+## 任务分解
+
+### Week 1（2026-03-26 ~ 2026-04-02）
+
+#### Day 1-2（3.26-3.27）：项目初始化
+
+| 任务 | 负责人 | 状态 | 备注 |
+|------|--------|------|------|
+| 创建Gitea仓库 | 大壮 | ⏳ 待开始 | 需要Gitea管理员权限 |
+| 配置项目权限 | 大壮 | ⏳ 待开始 | 设置团队成员访问权限 |
+| 初始化代码提交 | 大壮 | ⏳ 待开始 | 提交到Gitea |
+
+#### Day 3-4（3.28-3.29）：基础设施
+
+| 任务 | 负责人 | 状态 | 备注 |
+|------|--------|------|------|
+| 部署MySQL | 大壮 | ⏳ 待开始 | 端口3306 |
+| 部署Redis | 大壮 | ⏳ 待开始 | 端口6379 |
+| 部署Milvus | 大壮 | ⏳ 待开始 | 端口19530 |
+| 部署n8n | 大壮 | ⏳ 待开始 | 端口5678 |
+| 验证基础设施 | 大壮 | ⏳ 待开始 | 连接测试 |
+
+#### Day 5-7（3.30-4.1）：后端配置
+
+| 任务 | 负责人 | 状态 | 备注 |
+|------|--------|------|------|
+| 配置hzhub-ai数据库 | 后端 | ⏳ 待开始 | 执行初始化SQL |
+| 配置hzhub-ai运行 | 后端 | ⏳ 待开始 | 端口8081 |
+| 验证AI服务API | 后端 | ⏳ 待开始 | 测试关键接口 |
+| 配置hzhub-gateway | 后端 | ⏳ 待开始 | 端口8080 |
+
+### Week 2（2026-04-03 ~ 2026-04-09）
+
+#### Day 8-10（4.3-4.5）：前端配置
+
+| 任务 | 负责人 | 状态 | 备注 |
+|------|--------|------|------|
+| 安装hzhub-admin依赖 | 前端 | ⏳ 待开始 | pnpm install |
+| 配置hzhub-admin代理 | 前端 | ⏳ 待开始 | 指向网关8080 |
+| 启动hzhub-admin | 前端 | ⏳ 待开始 | 端口5666 |
+| 验证管理后台 | 前端 | ⏳ 待开始 | 登录测试 |
+
+#### Day 11-12（4.6-4.7）：集成测试
+
+| 任务 | 负责人 | 状态 | 备注 |
+|------|--------|------|------|
+| 端到端测试 | 测试 | ⏳ 待开始 | 完整流程测试 |
+| 问题修复 | 开发 | ⏳ 待开始 | 修复发现的问题 |
+| 性能基线测试 | 测试 | ⏳ 待开始 | 记录基准数据 |
+
+#### Day 13-14（4.8-4.9）：文档和验收
+
+| 任务 | 负责人 | 状态 | 备注 |
+|------|--------|------|------|
+| 编写开发文档 | 大壮 | ⏳ 待开始 | 环境搭建指南 |
+| 编写API文档 | 后端 | ⏳ 待开始 | 关键接口说明 |
+| 阶段验收 | 全员 | ⏳ 待开始 | 里程碑M1 |
+| 阶段总结 | 大壮 | ⏳ 待开始 | 更新项目文档 |
+
+---
+
+## 关键依赖
+
+```
+Day 1-2: 项目初始化
+    │
+    ▼
+Day 3-4: 基础设施部署
+    │
+    ▼
+Day 5-7: 后端配置（依赖基础设施）
+    │
+    ▼
+Day 8-10: 前端配置（依赖后端）
+    │
+    ▼
+Day 11-14: 测试和文档（依赖前端）
+```
+
+---
+
+## 交付物清单
+
+- [ ] Gitea代码仓库
+- [ ] 可运行的AI服务（http://localhost:8081）
+- [ ] 可运行的管理后台（http://localhost:5666）
+- [ ] 可运行的API网关（http://localhost:8080）
+- [ ] 基础设施（MySQL、Redis、Milvus、n8n）
+- [ ] 开发环境搭建文档
+- [ ] API接口文档
+
+---
+
+## 风险和对策
+
+| 风险 | 可能性 | 影响 | 对策 |
+|------|--------|------|------|
+| Milvus部署失败 | 中 | 高 | 使用Docker Compose简化部署 |
+| ruoyi-ai启动失败 | 中 | 高 | 检查依赖版本，查看日志 |
+| 端口冲突 | 高 | 中 | 提前规划端口，准备备用端口 |
+| 网络问题 | 中 | 中 | 准备离线安装包 |
+
+---
+
+## 进度跟踪
+
+### 本周进度（2026-03-26）
+
+| 任务 | 计划 | 实际 | 状态 |
+|------|------|------|------|
+| 代码初始化 | 3.26 | 3.26 | ✅ 已完成 |
+| 创建项目计划 | 3.26 | 3.26 | ✅ 已完成 |
+
+### 总体进度
+
+```
+第一阶段进度: [█░░░░░░░░░] 10%
+
+Week 1: [████░░░░░░] 40%
+Week 2: [░░░░░░░░░░] 0%
+```
+
+---
+
+## 变更记录
+
+| 日期 | 变更内容 | 变更原因 | 决策人 |
+|------|---------|---------|--------|
+| 2026-03-26 | 创建第一阶段计划 | 项目启动 | 大壮 |
+
+---
+
+**计划版本**：v1.0  
+**创建时间**：2026-03-26  
+**更新时间**：2026-03-26  
+**文档管理员**：大壮