Initial commit: HZHub project setup with RuoYi-AI base

docs/project/README.md

@@ -0,0 +1,65 @@
+# HZHub 项目管理文档
+
+> 项目计划、进度跟踪、变更记录和会议纪要
+
+## 目录结构
+
+```
+project/
+├── README.md           # 本文件
+├── plan/              # 项目计划
+│   ├── master-plan.md # 总体计划
+│   ├── phase-1.md     # 第一阶段计划
+│   ├── phase-2.md     # 第二阶段计划
+│   └── ...
+├── progress/          # 进度跟踪
+│   ├── weekly/        # 周报
+│   └── daily/         # 日报
+├── changes/           # 变更记录
+│   ├── architecture-changes.md  # 架构变更
+│   ├── schedule-changes.md      # 进度变更
+│   └── requirement-changes.md   # 需求变更
+└── meetings/          # 会议纪要
+    └── YYYY-MM-DD-topic.md
+```
+
+## 使用规范
+
+### 计划文档 (plan/)
+
+- **master-plan.md**: 项目总体计划，包含里程碑和关键节点
+- **phase-*.md**: 各阶段详细计划，包含任务分解和时间估算
+- 更新频率：阶段开始时创建，阶段结束时归档
+
+### 进度文档 (progress/)
+
+- **weekly/**: 每周进度报告，记录本周完成、下周计划、风险和问题
+- **daily/**: 每日进度简报（可选），记录当日完成和阻塞
+- 更新频率：周报每周五更新，日报每日下班前更新
+
+### 变更文档 (changes/)
+
+- 任何对原计划、架构、需求的变更都需要记录
+- 变更记录需包含：变更原因、变更内容、影响范围、决策人
+- 更新频率：变更发生时立即记录
+
+### 会议纪要 (meetings/)
+
+- 命名格式：`YYYY-MM-DD-主题.md`
+- 内容包含：参会人、会议主题、讨论内容、决议事项、待办事项
+- 更新频率：会议结束后24小时内完成
+
+---
+
+## 当前状态
+
+| 项目阶段 | 状态 | 更新时间 |
+|---------|------|---------|
+| 架构设计 | ✅ 已完成 | 2026-03-26 |
+| 代码初始化 | ✅ 已完成 | 2026-03-26 |
+| 第一阶段 | ⏳ 待启动 | - |
+
+---
+
+**文档管理员**：大壮  
+**最后更新**：2026-03-26

docs/project/changes/architecture-changes.md

@@ -0,0 +1,63 @@
+# 架构变更记录
+
+> 记录HZHub项目架构设计变更
+
+---
+
+## 变更记录表
+
+| 序号 | 日期 | 变更内容 | 变更原因 | 决策人 | 影响范围 |
+|------|------|---------|---------|--------|---------|
+| 001 | 2026-03-26 | 初始架构确定 | 项目启动 | 大壮 | 全部 |
+
+---
+
+## 变更详情
+
+### 变更 #001：初始架构确定
+
+**日期**：2026-03-26
+
+**变更内容**：
+确定HZHub系统架构为四层微服务架构：
+- 前端接入层（3个门户）
+- API网关层（统一入口）
+- 核心服务层（AI服务 + ERP服务 + n8n）
+- 数据存储层（MySQL + Milvus + SQL Server）
+
+**变更原因**：
+项目启动，基于RuoYi-AI三项目进行架构设计。
+
+**技术选型**：
+- 后端：Spring Boot 3.5.8 + LangChain4j 1.11.0
+- 管理后台：Vue 3 + Vben Admin + Ant Design Vue
+- 门户：Vue 3 + Element Plus X
+- 网关：Spring Cloud Gateway
+- 向量库：Milvus
+
+**决策人**：大壮
+
+**影响范围**：
+- 全部子系统
+- 开发技术栈
+- 部署架构
+
+**相关文档**：
+- [架构设计](../../architecture/README.md)
+- [系统架构图](../../architecture/hzhub-architecture-cn.png)
+
+---
+
+## 变更流程
+
+1. **识别变更**：发现需要变更架构的场景
+2. **影响分析**：分析变更对项目的影响
+3. **方案制定**：制定变更实施方案
+4. **决策审批**：技术负责人审批
+5. **实施变更**：执行变更并更新文档
+6. **通知相关方**：通知受影响的相关人员
+
+---
+
+**记录创建**：2026-03-26  
+**记录管理员**：大壮

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  
+**文档管理员**：大壮

docs/project/progress/weekly/2026-03-26-week1.md

@@ -0,0 +1,120 @@
+# 项目周报 - 第1周
+
+> 报告周期：2026-03-26 ~ 2026-04-02  
+> 报告时间：2026-03-26（周五）
+
+---
+
+## 本周总结
+
+### 完成情况
+
+| 任务 | 计划 | 实际 | 状态 |
+|------|------|------|------|
+| RuoYi-AI三项目审查 | 3.26 | 3.26 | ✅ 已完成 |
+| 架构设计文档 | 3.26 | 3.26 | ✅ 已完成 |
+| 系统架构图 | 3.26 | 3.26 | ✅ 已完成 |
+| 代码初始化 | 3.26 | 3.26 | ✅ 已完成 |
+| 项目计划文档 | 3.26 | 3.26 | ✅ 已完成 |
+
+### 关键成果
+
+1. **完成三项目深度审查**
+   - ruoyi-ai（后端）：Spring Boot + LangChain4j，AI能力完整
+   - ruoyi-admin（管理后台）：Vue 3 + Vben Admin，组件丰富
+   - ruoyi-web（用户前端）：Vue 3 + Element Plus X，流式处理成熟
+
+2. **确定技术路线**
+   - 复用70% + 改造20% + 自研10%
+   - Spring Boot 3.5.8（与ruoyi-ai一致）
+   - 管理后台：Vben Admin + Ant Design Vue
+   - 门户：Element Plus X
+
+3. **完成代码初始化**
+   - hzhub-ai（复用ruoyi-ai）
+   - hzhub-admin（复用ruoyi-admin）
+   - hzhub-erp（新建）
+   - hzhub-gateway（新建）
+   - hzhub-portal-company/dealer（复用ruoyi-web）
+
+4. **建立项目管理文档**
+   - 总体计划（8周，4个阶段）
+   - 第一阶段详细计划
+   - 文档管理规范
+
+---
+
+## 下周计划（2026-03-27 ~ 2026-04-02）
+
+### 重点任务
+
+| 任务 | 负责人 | 截止日期 | 优先级 |
+|------|--------|---------|--------|
+| 创建Gitea仓库 | 大壮 | 3.27 | P0 |
+| 部署基础设施 | 大壮 | 3.28 | P0 |
+| 配置hzhub-ai数据库 | 后端 | 3.30 | P0 |
+| 验证AI服务运行 | 后端 | 4.1 | P0 |
+| 配置hzhub-admin | 前端 | 4.2 | P0 |
+
+### 里程碑
+
+- [ ] 基础设施就绪（MySQL、Redis、Milvus、n8n）
+- [ ] AI服务可运行
+- [ ] 管理后台可运行
+
+---
+
+## 风险与问题
+
+### 当前风险
+
+| 风险 | 等级 | 状态 | 应对措施 |
+|------|------|------|----------|
+| Gitea访问权限 | 中 | 跟踪中 | 联系管理员获取权限 |
+| SQL Server连接信息 | 高 | 待确认 | 需要ERP数据库连接信息 |
+
+### 待解决问题
+
+1. **Gitea仓库创建**：需要管理员权限或协助
+2. **ERP数据库信息**：需要SQL Server的连接地址、账号密码
+3. **服务器资源**：需要确认开发/测试环境服务器
+
+---
+
+## 资源需求
+
+| 资源 | 用途 | 紧急程度 |
+|------|------|---------|
+| Gitea管理员权限 | 创建代码仓库 | 高 |
+| SQL Server连接信息 | ERP服务开发 | 高 |
+| 开发服务器 | 部署基础设施 | 中 |
+
+---
+
+## 会议纪要
+
+### 本周会议
+
+无（项目启动阶段）
+
+---
+
+## 附录
+
+### 项目文档索引
+
+- [架构设计](../../architecture/README.md)
+- [学习报告](../../learnings/)
+- [总体计划](../master-plan.md)
+- [第一阶段计划](../phase-1.md)
+
+### 代码仓库
+
+- 本地路径：`/data/hzhub/`
+- Gitea仓库：待创建
+
+---
+
+**报告人**：大壮  
+**审核人**：待审核  
+**报告时间**：2026-03-26