修复内容: 1. 租户管理日期格式问题 - 问题:新增租户时过期时间字段报错 Cannot deserialize Date - 解决:SysTenantBo.expireTime 添加 @JsonFormat 和 @DateTimeFormat 注解 - 影响:租户管理功能可正常保存带过期时间的数据 2. 更新项目进度文档 - 记录本周完成的租户管理修复、局域网访问配置等关键成果 - 更新已解决问题列表 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
179 lines
5.3 KiB
Markdown
179 lines
5.3 KiB
Markdown
# 项目周报 - 第2周
|
||
|
||
> 报告周期:2026-03-27 ~ 2026-04-02
|
||
> 报告时间:2026-03-27(周五)
|
||
|
||
---
|
||
|
||
## 本周总结
|
||
|
||
### 完成情况
|
||
|
||
| 任务 | 计划 | 实际 | 状态 |
|
||
|------|------|------|------|
|
||
| 创建Gitea仓库 | 3.27 | 3.27 | ✅ 已完成 |
|
||
| 部署基础设施 | 3.28 | 3.27 | ✅ 已完成 |
|
||
| 配置hzhub-ai数据库 | 3.30 | 3.27 | ✅ 已完成 |
|
||
| 验证AI服务运行 | 4.1 | 3.27 | ✅ 已完成 |
|
||
| 配置hzhub-admin | 4.2 | 3.27 | ✅ 已完成 |
|
||
| 配置hzhub-portal-company | - | 3.27 | ✅ 已完成 |
|
||
| 配置hzhub-portal-dealer | - | 3.27 | ✅ 已完成 |
|
||
| RuoYi→HZHub重命名 | - | 3.27 | ✅ 已完成 |
|
||
| 修复租户管理日期格式问题 | - | 4.02 | ✅ 已完成 |
|
||
| 配置局域网访问支持 | - | 4.02 | ✅ 已完成 |
|
||
| 解决前端启动路径问题 | - | 4.02 | ✅ 已完成 |
|
||
|
||
### 关键成果
|
||
|
||
1. **Gitea仓库创建完成**
|
||
- 地址:http://192.168.120.110:4000/AI_Team/hzhub
|
||
- 已完成6次提交
|
||
|
||
2. **基础设施全部部署完成**
|
||
- MySQL 8.0 (端口3306) ✅
|
||
- Redis 7 (端口6379) ✅
|
||
- Weaviate 向量数据库 (端口28080) ✅
|
||
- n8n 工作流引擎 (端口5678) ✅
|
||
- MinIO 对象存储 (端口9000) ✅
|
||
- etcd 服务发现 (端口2379) ✅
|
||
|
||
3. **hzhub-ai服务部署完成**
|
||
- Docker镜像构建成功
|
||
- 服务运行在端口6039
|
||
- 数据库连接配置完成
|
||
|
||
4. **前端服务全部Docker化**
|
||
- hzhub-admin (管理后台) - 端口5666
|
||
- hzhub-portal-company (公司门户) - 端口5137
|
||
- hzhub-portal-dealer (经销商门户) - 端口5138
|
||
|
||
5. **RuoYi到HZHub全面重命名**
|
||
- 替换所有文本标记
|
||
- 替换包名 org.ruoyi → org.hzhub
|
||
- 重命名所有目录和文件
|
||
- 更新pom.xml、Dockerfile、配置文件
|
||
|
||
6. **租户管理日期格式修复**(4.02)
|
||
- 问题:新增租户时过期时间字段报错 "Cannot deserialize value of type `java.util.Date`"
|
||
- 原因:前端发送格式 `yyyy-MM-dd HH:mm:ss`,后端未正确配置
|
||
- 解决:在 `SysTenantBo.expireTime` 添加 `@JsonFormat` 和 `@DateTimeFormat` 注解
|
||
- 文件:`hzhub-ai/hzhub-modules/hzhub-system/src/main/java/org/hzhub/system/domain/bo/SysTenantBo.java`
|
||
|
||
7. **局域网访问配置**(4.02)
|
||
- 问题:前端服务默认只监听 127.0.0.1,局域网无法访问
|
||
- 解决:前端 Vite 服务添加 `--host 0.0.0.0` 参数
|
||
- 效果:局域网可通过 http://192.168.120.60:5666 访问管理后台
|
||
|
||
8. **前端启动路径修复**(4.02)
|
||
- 问题:hzhub-admin 启动返回 404
|
||
- 原因:monorepo 结构,必须在 `apps/web-antd` 目录启动
|
||
- 解决:在正确目录执行 vite 命令,使用根目录的 node_modules
|
||
|
||
### 技术实现
|
||
|
||
**Docker Compose配置**
|
||
```yaml
|
||
services:
|
||
hzhub-ai: 端口6039
|
||
hzhub-admin: 端口5666
|
||
hzhub-portal-company: 端口5137
|
||
hzhub-portal-dealer: 端口5138
|
||
hzhub-mysql: 端口3306
|
||
hzhub-redis: 端口6379
|
||
hzhub-weaviate: 端口28080
|
||
hzhub-n8n: 端口5678
|
||
```
|
||
|
||
**关键修复**
|
||
- Lombok @Slf4j编译问题:确保父pom.xml注解处理器配置正确
|
||
- Spring Boot自动配置类找不到:更新.imports文件包名
|
||
- 类名与文件名不匹配:重命名RuoYiAIApplication→HZHubAIApplication
|
||
|
||
---
|
||
|
||
## 下周计划(2026-03-30 ~ 2026-04-02)
|
||
|
||
### 重点任务
|
||
|
||
| 任务 | 负责人 | 截止日期 | 优先级 |
|
||
|------|--------|---------|--------|
|
||
| 测试前端登录功能 | 大壮 | 3.30 | P0 |
|
||
| 测试AI对话功能 | 大壮 | 3.31 | P0 |
|
||
| 配置模型提供商 | 大壮 | 4.1 | P0 |
|
||
| 创建知识库 | 大壮 | 4.2 | P1 |
|
||
| 配置API网关统一入口 | 大壮 | 4.2 | P1 |
|
||
|
||
### 里程碑
|
||
|
||
- [ ] 管理后台可正常登录使用
|
||
- [ ] AI对话功能可用
|
||
- [ ] 至少配置一个模型提供商
|
||
|
||
---
|
||
|
||
## 风险与问题
|
||
|
||
### 当前风险
|
||
|
||
| 风险 | 等级 | 状态 | 应对措施 |
|
||
|------|------|------|----------|
|
||
| SQL Server连接信息 | 高 | 待确认 | 需要ERP数据库连接信息 |
|
||
| 模型提供商API Key | 中 | 待配置 | 需要申请或购买 |
|
||
|
||
### 已解决问题
|
||
|
||
1. **Gitea访问权限** ✅ - 已获得管理员权限,成功创建仓库
|
||
2. **Docker构建问题** ✅ - 已解决Lombok编译和类名不匹配问题
|
||
3. **租户管理日期格式错误** ✅ - 已添加@JsonFormat注解解决日期反序列化问题
|
||
4. **局域网访问问题** ✅ - 前端服务添加--host 0.0.0.0参数
|
||
5. **hzhub-admin启动404** ✅ - 在正确的apps/web-antd目录启动vite
|
||
|
||
---
|
||
|
||
## 资源需求
|
||
|
||
| 资源 | 用途 | 紧急程度 | 状态 |
|
||
|------|------|---------|------|
|
||
| SQL Server连接信息 | ERP服务开发 | 高 | 待提供 |
|
||
| 模型API Key | AI服务配置 | 中 | 待申请 |
|
||
|
||
---
|
||
|
||
## 会议纪要
|
||
|
||
### 本周会议
|
||
|
||
无(集中开发阶段)
|
||
|
||
---
|
||
|
||
## 附录
|
||
|
||
### 项目文档索引
|
||
|
||
- [架构设计](../../architecture/README.md)
|
||
- [学习报告](../../learnings/)
|
||
- [总体计划](../master-plan.md)
|
||
- [第一阶段计划](../phase-1.md)
|
||
|
||
### 代码仓库
|
||
|
||
- Gitea:http://192.168.120.110:4000/AI_Team/hzhub
|
||
- 本地路径:`/data/hzhub/`
|
||
|
||
### 服务访问地址
|
||
|
||
| 服务 | 地址 |
|
||
|------|------|
|
||
| 管理后台 | 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/ |
|
||
|
||
---
|
||
|
||
**报告人**:大壮
|
||
**审核人**:待审核
|
||
**报告时间**:2026-03-27
|