278e507e8a
- 新增 hzhub-portal-employee 员工门户前端项目（基于 Vue3 + Element Plus） - 后端登录接口增加返回 nickName 字段 - 移除 KnowledgeInfoController 的 @SaCheckPermission 注解 - 删除 hzhub-portal-company 旧门户项目 - 更新项目文档和架构说明 - 添加后台运行管理脚本（start-all.sh / status-all.sh / stop-all.sh） - 更新 docker-compose 配置 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
222 lines
6.9 KiB
Markdown
222 lines
6.9 KiB
Markdown
# 第一阶段计划：基础框架搭建
|
||
|
||
> 时间：2026-03-26 ~ 2026-04-09（2周）
|
||
> 状态：进行中（已提前完成核心任务）
|
||
|
||
---
|
||
|
||
## 阶段目标
|
||
|
||
搭建可运行的基础框架，包括：
|
||
- [x] AI服务可用（hzhub-ai）
|
||
- [x] 管理后台可用（hzhub-admin）
|
||
- [x] 公司门户可用（hzhub-portal-employee）
|
||
- [x] 经销商门户可用（hzhub-portal-dealer）
|
||
- [x] 基础设施就绪（MySQL、Redis、Weaviate、n8n、MinIO）
|
||
- [ ] 开发环境配置完成
|
||
- [ ] 文档编写完成
|
||
|
||
---
|
||
|
||
## 任务分解
|
||
|
||
### Week 1（2026-03-26 ~ 2026-04-02）
|
||
|
||
#### Day 1-2（3.26-3.27）：项目初始化 ✅
|
||
|
||
| 任务 | 负责人 | 状态 | 备注 |
|
||
|------|--------|------|------|
|
||
| 创建Gitea仓库 | 大壮 | ✅ 已完成 | http://192.168.120.110:4000/AI_Team/hzhub |
|
||
| 配置项目权限 | 大壮 | ✅ 已完成 | 已设置访问权限 |
|
||
| 初始化代码提交 | 大壮 | ✅ 已完成 | 6次提交 |
|
||
| RuoYi→HZHub重命名 | 大壮 | ✅ 已完成 | 全面替换完成 |
|
||
|
||
#### Day 3-4（3.28-3.29）：基础设施 ✅
|
||
|
||
| 任务 | 负责人 | 状态 | 备注 |
|
||
|------|--------|------|------|
|
||
| 部署MySQL | 大壮 | ✅ 已完成 | 端口3306 |
|
||
| 部署Redis | 大壮 | ✅ 已完成 | 端口6379 |
|
||
| 部署Weaviate | 大壮 | ✅ 已完成 | 端口28080 |
|
||
| 部署n8n | 大壮 | ✅ 已完成 | 端口5678 |
|
||
| 部署MinIO | 大壮 | ✅ 已完成 | 端口9000 |
|
||
| 验证基础设施 | 大壮 | ✅ 已完成 | 全部健康运行 |
|
||
|
||
#### Day 5-7（3.30-4.1）：后端配置 ✅
|
||
|
||
| 任务 | 负责人 | 状态 | 备注 |
|
||
|------|--------|------|------|
|
||
| 配置hzhub-ai数据库 | 大壮 | ✅ 已完成 | 执行初始化SQL |
|
||
| 配置hzhub-ai运行 | 大壮 | ✅ 已完成 | 端口6039 |
|
||
| 验证AI服务API | 大壮 | ✅ 已完成 | 服务响应正常 |
|
||
| 配置hzhub-gateway | 大壮 | ⏳ 待开始 | 端口待定 |
|
||
|
||
### Week 2（2026-04-03 ~ 2026-04-09）
|
||
|
||
#### Day 8-10（4.3-4.5）：前端配置 ✅
|
||
|
||
| 任务 | 负责人 | 状态 | 备注 |
|
||
|------|--------|------|------|
|
||
| 配置hzhub-admin | 大壮 | ✅ 已完成 | 端口5666，Nginx |
|
||
| 配置hzhub-portal-employee | 大壮 | ✅ 已完成 | 端口5137，Nginx |
|
||
| 配置hzhub-portal-dealer | 大壮 | ✅ 已完成 | 端口5138，Nginx |
|
||
| 验证前端服务 | 大壮 | ✅ 已完成 | 全部可访问 |
|
||
|
||
#### Day 11-12（4.6-4.7）：集成测试
|
||
|
||
| 任务 | 负责人 | 状态 | 备注 |
|
||
|------|--------|------|------|
|
||
| 测试前端登录功能 | 大壮 | ⏳ 待开始 | 管理后台登录 |
|
||
| 测试AI对话功能 | 大壮 | ⏳ 待开始 | 配置模型提供商 |
|
||
| 配置模型提供商 | 大壮 | ⏳ 待开始 | OpenAI/阿里云百炼 |
|
||
| 问题修复 | 开发 | ⏳ 待开始 | 修复发现的问题 |
|
||
|
||
#### Day 13-14（4.8-4.9）：文档和验收
|
||
|
||
| 任务 | 负责人 | 状态 | 备注 |
|
||
|------|--------|------|------|
|
||
| 编写开发文档 | 大壮 | ⏳ 待开始 | 环境搭建指南 |
|
||
| 编写API文档 | 后端 | ⏳ 待开始 | 关键接口说明 |
|
||
| 阶段验收 | 全员 | ⏳ 待开始 | 里程碑M1 |
|
||
| 阶段总结 | 大壮 | ⏳ 待开始 | 更新项目文档 |
|
||
|
||
---
|
||
|
||
## 关键依赖
|
||
|
||
```
|
||
Day 1-2: 项目初始化 ✅
|
||
│
|
||
▼
|
||
Day 3-4: 基础设施部署 ✅
|
||
│
|
||
▼
|
||
Day 5-7: 后端配置 ✅（依赖基础设施）
|
||
│
|
||
▼
|
||
Day 8-10: 前端配置 ✅（依赖后端）
|
||
│
|
||
▼
|
||
Day 11-14: 测试和文档（依赖前端）
|
||
```
|
||
|
||
---
|
||
|
||
## 交付物清单
|
||
|
||
- [x] Gitea代码仓库
|
||
- [x] 可运行的AI服务（http://192.168.120.60:6039）
|
||
- [x] 可运行的管理后台（http://192.168.120.60:5666）
|
||
- [x] 可运行的公司门户（http://192.168.120.60:5137）
|
||
- [x] 可运行的经销商门户（http://192.168.120.60:5138）
|
||
- [ ] 可运行的API网关
|
||
- [x] 基础设施（MySQL、Redis、Weaviate、n8n、MinIO）
|
||
- [ ] 开发环境搭建文档
|
||
- [ ] API接口文档
|
||
|
||
---
|
||
|
||
## 服务访问地址
|
||
|
||
| 服务 | 地址 | 状态 |
|
||
|------|------|------|
|
||
| 管理后台 | http://192.168.120.60:5666/ | ✅ 运行中 |
|
||
| 公司门户 | http://192.168.120.60:5137/ | ✅ 运行中 |
|
||
| 经销商门户 | http://192.168.120.60:5138/ | ✅ 运行中 |
|
||
| AI服务 | http://192.168.120.60:6039/ | ✅ 运行中 |
|
||
| n8n工作流 | http://192.168.120.60:5678/ | ✅ 运行中 |
|
||
|
||
---
|
||
|
||
## 风险和对策
|
||
|
||
| 风险 | 可能性 | 影响 | 对策 | 状态 |
|
||
|------|--------|------|------|------|
|
||
| Milvus部署失败 | 中 | 高 | 使用Weaviate替代 | ✅ 已解决 |
|
||
| hzhub-ai启动失败 | 中 | 高 | 检查依赖版本，查看日志 | ✅ 已解决 |
|
||
| Lombok编译问题 | 中 | 高 | 确保注解处理器配置正确 | ✅ 已解决 |
|
||
| 端口冲突 | 高 | 中 | 提前规划端口，准备备用端口 | ✅ 已解决 |
|
||
| 网络问题 | 中 | 中 | 使用华为云Maven镜像 | ✅ 已解决 |
|
||
|
||
---
|
||
|
||
## 进度跟踪
|
||
|
||
### 本周进度（2026-03-27）
|
||
|
||
| 任务 | 计划 | 实际 | 状态 |
|
||
|------|------|------|------|
|
||
| 代码初始化 | 3.26 | 3.26 | ✅ 已完成 |
|
||
| 创建项目计划 | 3.26 | 3.26 | ✅ 已完成 |
|
||
| 部署基础设施 | 3.28 | 3.27 | ✅ 提前完成 |
|
||
| 配置后端服务 | 3.30 | 3.27 | ✅ 提前完成 |
|
||
| 配置前端服务 | 4.02 | 3.27 | ✅ 提前完成 |
|
||
| RuoYi重命名 | - | 3.27 | ✅ 已完成 |
|
||
|
||
### 总体进度
|
||
|
||
```
|
||
第一阶段进度: [████████░░] 80%
|
||
|
||
基础设施: [██████████] 100% ✅
|
||
后端服务: [██████████] 100% ✅
|
||
前端服务: [██████████] 100% ✅
|
||
集成测试: [░░░░░░░░░░] 0% ⏳
|
||
文档编写: [░░░░░░░░░░] 0% ⏳
|
||
```
|
||
|
||
---
|
||
|
||
## 关键成果
|
||
|
||
### 1. 基础设施（全部Docker化）
|
||
|
||
```yaml
|
||
services:
|
||
hzhub-mysql: # MySQL 8.0 - 端口3306
|
||
hzhub-redis: # Redis 7 - 端口6379
|
||
hzhub-weaviate: # Weaviate 1.25.0 - 端口28080
|
||
hzhub-n8n: # n8n latest - 端口5678
|
||
hzhub-minio: # MinIO latest - 端口9000
|
||
hzhub-etcd: # etcd 3.5.5 - 端口2379
|
||
```
|
||
|
||
### 2. 应用服务（全部Docker化）
|
||
|
||
```yaml
|
||
services:
|
||
hzhub-ai: # Spring Boot - 端口6039
|
||
hzhub-admin: # Nginx + Vue - 端口5666
|
||
hzhub-portal-employee: # Nginx + Vue - 端口5137
|
||
hzhub-portal-dealer: # Nginx + Vue - 端口5138
|
||
```
|
||
|
||
### 3. 代码提交记录
|
||
|
||
```
|
||
commit a078d07 - fix: 更新 Spring Boot AutoConfiguration imports
|
||
commit 5dcae25 - fix: 重命名 RuoYiAIApplication 文件
|
||
commit f8f805d - fix: 更新 Dockerfile 和 pom.xml 路径
|
||
commit ff0ec6d - refactor: 重命名 ruoyi 目录和文件
|
||
commit f115a79 - refactor: 将 RuoYi 标记替换为 HZHub
|
||
commit bc96a58 - feat: Docker化部署完成
|
||
```
|
||
|
||
---
|
||
|
||
## 变更记录
|
||
|
||
| 日期 | 变更内容 | 变更原因 | 决策人 |
|
||
|------|---------|---------|--------|
|
||
| 2026-03-26 | 创建第一阶段计划 | 项目启动 | 大壮 |
|
||
| 2026-03-27 | 更新第一阶段进度 | 提前完成核心任务 | 大壮 |
|
||
| 2026-03-27 | 添加门户服务任务 | 提前部署 | 大壮 |
|
||
| 2026-03-27 | 添加RuoYi重命名任务 | 品牌统一 | 大壮 |
|
||
|
||
---
|
||
|
||
**计划版本**：v1.1
|
||
**创建时间**：2026-03-26
|
||
**更新时间**：2026-03-27
|
||
**文档管理员**：大壮
|