Files
hzhub/docs/project/progress/weekly/2026-03-27-week2.md
大壮 30113c51b5 fix: 修复租户管理日期格式问题并更新项目进度
修复内容:
1. 租户管理日期格式问题
   - 问题:新增租户时过期时间字段报错 Cannot deserialize Date
   - 解决:SysTenantBo.expireTime 添加 @JsonFormat 和 @DateTimeFormat 注解
   - 影响:租户管理功能可正常保存带过期时间的数据

2. 更新项目进度文档
   - 记录本周完成的租户管理修复、局域网访问配置等关键成果
   - 更新已解决问题列表

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-02 09:41:35 +00:00

5.3 KiB
Raw Blame History

项目周报 - 第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仓库创建完成

  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配置

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服务配置 待申请

会议纪要

本周会议

无(集中开发阶段)


附录

项目文档索引

代码仓库

服务访问地址

服务 地址
管理后台 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