无鱼软件文档中心

Appearance

发布记录 ​

版本说明 ​

沐霖工时管理系统采用语义化版本号：主版本号.次版本号.修订号

  • 主版本号: 不兼容的 API 修改
  • 次版本号: 向下兼容的功能性新增
  • 修订号: 向下兼容的问题修正

v4.3.0 (2026-07-12) 🎉 ​

✨ 新功能 ​

风险管理 ​

  • 新增风险洞察页面，支持按截至日期查看风险清单、风险等级、指标分布和历史趋势。
  • 新增风险类型配置，可启用/停用分析类型、设置优先级、阈值和站内通知策略。
  • 风险分类和分析类型采用系统内置定义，配置页提供说明，避免误配置。
  • 支持手动风险核算及每日自动结算；非企业版不启动风险结算定时任务。

排期与数据导出 ​

  • 新增人员排期日历和项目排期日历，支持项目、部门、开始日期和结束日期筛选。
  • 新增人员排期和项目排期 Excel 导出，补齐无数据项目、人员和日期的展示。

v4.2.0 (2026-06-12) 🎉 ​

✨ 新功能 ​

工时统计分析 ​

  • 📊 计划 vs 实际对比分析：新增预估工时与实际工时的对比图表，支持偏差率计算，帮助评估项目估算准确性
  • 📈 项目工时核算：新增项目级工时统计视图，展示总工时、任务数、参与人数、平均工时等维度
  • 📊 项目工时对比图表：新增柱状图可视化，支持前 20 个项目的工时与任务数量对比
  • 📋 工时统计概览卡片：新增项目总数、总工时、总任务数、总参与人数 4 个统计卡片，快速掌握全局

项目管理增强 ​

  • 👥 项目卡片成员数显示：项目管理页卡片新增成员数量，一眼看出项目团队规模
  • 📝 项目描述展示：首页和项目管理页卡片新增项目简介/描述展示

工时填写提醒 ​

  • ⏰ 工时提醒配置：支持配置每日工时填报提醒，按星期和时间自动发送站内通知

🔧 优化改进 ​

  • 🎨 首页项目卡片改版：采用现代化卡片布局，新增项目首字母头像、进行/归档状态标签
  • 🧭 导航栏用户信息调整：右上角用户名前置、头像后置，更直观识别当前登录人
  • 🔍 项目列表搜索优化：支持按项目名称模糊搜索，输入防抖 300ms，操作更流畅
  • 🔐 系统默认密码调整：初始密码统一改为 1234567
  • 🎨 UI 风格统一：移除项目卡片彩色边框和悬浮动画，保持简洁一致的视觉风格

v4.1.0 (2026-06-05) 🎉 ​

✨ 新功能 ​

通知系统 ​

  • 🔔 全新通知中心：支持站内消息通知，实时推送系统消息
  • 📧 多渠道配置：支持邮件、企业微信、钉钉、飞书等多渠道通知推送
  • 📋 通知类型丰富：阶段分配、阶段验收、阶段驳回、待验收、工时审核等 10 种通知类型
  • ✅ 通知管理：支持标记已读、批量标记、删除通知、按类型筛选
  • 🔔 通知铃铛：顶部导航栏新增通知铃铛，实时显示未读数量
  • 📱 通知列表页面：完整的消息管理中心，支持分页、筛选、批量操作
  • 👤 个人通知设置：用户可在个人中心配置个人接收账号和开关

工时提醒 ​

  • ⏰ 工时填写提醒：支持定时提醒员工填写工时
  • 📅 灵活配置：可设置提醒时间、提醒日期（工作日/自定义）
  • 🔧 启用/禁用控制：按需开启或关闭提醒功能
  • 🎯 精准推送：仅提醒当天未填写工时的员工
  • ⚙️ 提醒配置页面：管理员可配置提醒时间、星期、通知渠道

批量导入工时 ​

  • 📊 Excel 批量导入：支持通过 Excel 文件批量导入工时记录
  • 📝 智能解析：支持标准日期、Excel 序列号日期等多种格式
  • ✅ 数据验证：自动验证项目 ID、日期、工时等必填字段
  • 📈 错误统计：导入完成后显示成功、失败数量和详细错误信息
  • 🔀 按日期分组：自动将同一天的多条记录合并处理
  • 📋 导入模板：提供标准 Excel 模板，包含项目ID、任务ID、日期、工作内容、工时、是否完成等字段
  • 🔍 逐日校验：重复填报检测、工时上限校验

🔬 测试体系建设 ​

Service 层测试 ​

  • 🧪 完整测试覆盖：建立 Service 层单元测试体系，测试覆盖率 97%
  • 📦 通知服务测试：通知 CRUD、标记已读、删除、工时相关通知等 5 个测试函数
  • ⚙️ 配置服务测试：通知配置、工时提醒配置的获取、更新、切换等 2 个测试函数
  • 📥 批量导入测试：Excel 解析、数据验证、日期处理、布尔值解析、空行处理等 7 个测试函数
  • 🎯 真实数据库测试：使用 initTestDB() 复用数据库连接，测试真实业务逻辑

API 层集成测试 ​

  • 🔌 通知管理接口：通知列表、未读数量、标记已读、删除等接口测试
  • ⚙️ 通知配置接口：配置获取、更新等接口测试
  • 📊 批量导入接口：文件上传、Excel 解析、导入结果等接口测试

🐛 问题修复 ​

  • ✅ 修复通知服务异步发送时的并发安全问题
  • ✅ 修复 Excel 日期解析时的时区问题
  • ✅ 修复批量导入时的重复提交检测
  • ✅ 修复通知配置首次加载时的空指针问题
  • ✅ 修复工时审核通知逻辑：项目经理提交工时也给自己发送待审核通知
  • ✅ 修复 ReviewDayHour 方法缺少通知触发的问题
  • ✅ 修复 ApproveProjectHour 和 RejectProjectHour 缺少通知的问题
  • ✅ 兼容 -1 和 2 两种驳回状态码

🔧 优化改进 ​

  • ⚡ 通知发送采用异步 Goroutine，不阻塞主流程
  • 📝 批量导入增加详细的日志输出，便于问题排查
  • 🎨 通知配置界面优化，支持实时预览
  • 📊 导入结果统计更详细，包含成功、失败、错误详情
  • 🔍 数据验证更严格，提前发现数据问题
  • 🖱️ 通知交互优化：点击通知仅标记已读，不跳转页面（避免打断用户操作）
  • 🎯 已读通知自动从列表移除（只显示未读）
  • 🎨 通知卡片增加间距和圆角，视觉分离
  • 🔢 未读角标显示优化（位置、样式、数字显示）
  • 📋 菜单配置完善：新增“通知配置”和“工时提醒配置”菜单（系统管理下）
  • 🔗 通知列表通过前端路由注册，不依赖数据库菜单
  • 📑 个人通知设置集成到个人中心第三个Tab
  • 🌐 文档站导航菜单增加“动态”和“文档”入口

v4.0.0 (2026-05-30) 🎉 ​

✨ 重大更新 ​

前端全面升级 ​

  • 🎨 升级至 Vue 3.5 + Vite 6.3，构建速度和运行性能大幅提升
  • 🎯 支持三种部署模式：独立部署、生产环境、嵌入式部署
  • 📊 工时类型分区块展示：普通工时和任务工时分别展示，信息更清晰
  • 📅 周报支持工时类型筛选：可按全部/普通工时/任务工时筛选查看
  • 📈 数据统计图表优化：ECharts 5.6，图表渲染更流畅
  • 🎭 审核状态标签可点击交互：提升用户体验

Go 后端重构 ​

  • 🚀 基于 Gin 1.10 高性能框架，API 响应速度提升
  • 💾 GORM 1.25 数据库操作优化，查询性能提升
  • 🔐 JWT 认证机制完善，安全性增强
  • 📝 工时判重机制增强，避免重复填报
  • 🔄 双审核接口支持：项目工时和普通工时并行审核

部署方式多样化 ​

  • 🐳 Docker Compose 一键部署：简化部署流程
  • 📦 单程序嵌入式部署：Go 二进制 + 嵌入式前端资源
  • 🌐 Nginx 反向代理配置：生产环境最佳实践

🐛 问题修复 ​

  • ✅ 修复普通工时 fillDate 和 diary 字段为空问题
  • ✅ 修复 GORM Count 与 Find 状态污染导致分页为空
  • ✅ 修复 taskInfoHour 页面审核状态缺失
  • ✅ 修复审核列表任务工时详情加载失败
  • ✅ 修复 /taskHour/list 接口按日期分组逻辑
  • ✅ 修复 GORM DTO 中非数据库字段映射错误
  • ✅ 修复子页面重复 min-height 导致高度异常
  • ✅ 修复 task_service 表名不一致与函数重复声明
  • ✅ 修复任务状态接口参数绑定与状态名称映射

🔧 优化改进 ​

  • ⚡ 前端路由懒加载优化，首屏加载速度提升
  • 📱 响应式布局改进，移动端体验优化
  • 🎨 卡片式 UI 统一，视觉风格一致
  • 📊 审核列表全量返回由前端判断，减少接口调用
  • 🔍 工时表格列宽与对齐优化，信息展示更清晰

v3.9.1 (2026-01-29) ​

🐛 问题修复 ​

  • ✅ 修复了工时模块编辑时报错的问题

🔧 优化改进 ​

  • ⚡ 数据统计中数据看板的统计数据跟随查询条件
  • 📝 任务工时填报时，项目没有任务的提示优化
  • 🎨 项目任务的界面呈现纳入框架中

v3.9.0 (2026-01-15) ​

✨ 新功能 ​

  • ✨ 新增了项目任务模块
  • ✨ 新增了项目任务工时填报
  • ✨ 新增了项目任务的日报统计

🐛 问题修复 ​

  • ✅ 其他一些bug修改

v3.8.3 (2026-01-15) ​

🔧 优化改进 ​

  • ⚡ 优化了项目启用禁用的控制状态

🐛 问题修复 ​

  • ✅ 项目管理中，工时记录的翻页问题
  • ✅ 其他一些bug修改

✨ 新功能 ​

  • ✨ 赞助版本的解锁

v3.8.2 (2025-12-10) ​

🐛 问题修复 ​

  • ✅ 工时审核中的某些条件搜索无效的问题
  • ✅ 工时审核的列表翻页问题
  • ✅ 数据统计下填报记录的翻页问题
  • ✅ 人员统计中，详情页码中的记录翻页问题
  • ✅ 修复了项目管理中，非管理员修改项目信息提示无权限的问题
  • ✅ 其他一些bug修改

v3.8.1 (2025-11-15) ​

🐛 问题修复 ​

  • ✅ 修复在某些系统环境中，启动时无法找到资源文件的问题

v3.8.0 (2025-11-15) ​

✨ 新功能 ​

  • ✨ 数据统计中，增加项目统计模块
  • ✨ 工时审核、项目看板等模块中增加权限范围控制

🐛 问题修复 ​

  • ✅ 项目看板中，数据概览中统计中统计不到数据
  • ✅ 其他一些bug修改

v3.7.0 (2025-10-12) ​

✨ 新功能 ​

  • ✨ 数据统计中，增加人员统计模块

🐛 问题修复 ​

  • ✅ 数据统计中，数据概览中统计图不到新审核的工时数据
  • ✅ 数据统计中，数据查询中工时详情中不需要的字段

🔧 优化改进 ​

  • 🎨 工时详情中，项目数据和普通普通的展示优化
  • ✅ 其他一些bug修改

v3.6.1 (2025-10-12) ​

🐛 问题修复 ​

  • ✅ 编辑项目时，选择项目经理的下拉问题

✨ 新功能 ​

  • ✨ 部门管理中，增加部门ID显示

🔧 优化改进 ​

  • ✅ 其他一些bug修改

v3.6.0 (2025-09-27) ​

✨ 新功能 ​

  • ✨ 增加工时导入功能，可通过excel方式导入工时
  • ✨ 增加系统名称修改功能，可进行登录名称修改

🔧 优化改进 ​

  • ✅ 其他一些bug修改

v3.5.0 (2025-09-15) ​

✨ 重大更新 ​

  • 🔄 审核机制升级：重构审核功能，支持按项目筛选工时并单独审核，提升审核效率与精准度
  • 🎨 工时详情界面重设计：突出 "项目工时 + 普通工时 = 总工时" 逻辑，优化信息布局，核心数据更直观

🐛 问题修复 ​

  • ✅ 修复工时统计延迟
  • ✅ 优化审核弹窗交互

🔧 优化改进 ​

  • ✨ 增加项目编辑，支持更换项目经理
  • ✅ 其他一些bug修改

v3.4.0 (2025-09-04) ​

🔧 优化改进 ​

  • 🎨 修改填报工时的样式，改为选择项目后添加工时
  • ✨ 填报工时时增加是否完成的选项
  • ✅ 其他一些bug修改

v3.3.1 (2025-08-20) ​

🔧 优化改进 ​

  • ⚡ 将redis驱动改为jedis，提高连接池效率
  • 🎨 优化掉前端vue3的不兼容api
  • 📝 优化前端工程的日志输出
  • 🐳 修改dockercompose 容器为openjdk
  • ✅ 其他一些bug修改

v3.3.0 (2025-08-14) 🎉 ​

✨ 重大更新 ​

框架全面升级 ​

  • 🚀 SpringBoot 升级至 3 版本，提升系统性能和稳定性
  • 🎨 Vue 升级至 Vue3 版本，使用 Composition API 优化代码结构
  • ☕ JDK 升级至 17 版本，提供更好的性能和新特性支持

组件库升级 ​

  • 🎯 更新 Element-UI 组件库至最新版本，修复已知兼容性问题

功能优化 ​

  • 📦 优化项目构建流程，提升开发效率和部署速度
  • 📊 重构工时统计模块，提高统计准确性和响应速度
  • 🎨 优化首页项目卡片布局，减少不必要的间距和元素
  • 📋 优化项目列表页面卡片展示，统一宽度和间距
  • ✅ 其他细节优化和用户体验改进

v3.2.0 (2025-07-30) ​

✨ 新功能 ​

  • 🆕 新增管理员用户只能查看自己管理的项目
  • 🆕 新增用户可以设置为管理员，以方便管理所有项目

🔧 优化改进 ​

  • 🎨 优化首页项目卡片布局，修复换行对齐问题
  • 📋 优化项目列表页面卡片展示，统一宽度和间距
  • 📐 调整项目详情页面元素间距，提升视觉效果
  • 📝 修复首页卡片header区域左边距问题
  • 📊 优化项目列表页面布局，确保每行项目整齐对齐
  • ✅ 修复项目列表显示不全的问题
  • ✅ 其他细节优化

v3.1.0 (2025-06-05) ​

🐛 问题修复 ​

  • ✅ 修复项目成员显示不全的问题

🔧 优化改进 ​

  • 🆕 增加回车提交工时
  • ✅ 其他细节优化

v3.0.0 (2025-04-15) 🎉 ​

✨ 重大更新 ​

  • 🎯 改名为沐霖工时系统
  • 🆕 新增了十余项功能

v2.3.0 (2025-04-02) ​

✨ 新功能 ​

  • ✨ 增加了工时审核功能，可通过系统设置进行控制工时是否需要审核

🐛 问题修复 ​

  • ✅ 修复了项目添加成员的权限报错

🔧 优化改进 ​

  • 📊 优化了数据报表界面，数据为0时展示萧索
  • 🐳 优化了容器里nginx的配置
  • 🎨 优化了其他一些界面显示问题

v2.2.0 (2025-03-26) ​

🐛 问题修复 ​

  • ✅ 修复了项目经理加入人员时，提示querySelect问题
  • ✅ 修复了数据查询界面数据为0时的显示问题

🔧 优化改进 ​

  • 🎨 优化了首页的页面风格
  • 🎨 优化了填报工时\编辑工时\查看工时的页面,以及部分描述
  • ✅ 其他细节优化

v2.1.1 (2025-01-16) ​

🐛 问题修复 ​

  • ✅ 修复了项目经理加入人员时，权限不足时的无法添加人员的问题
  • ✅ 修复首页人员头像的显示问题
  • ✅ 修复了部分页面的提示权限不足的问题
  • ✅ 修复了刷新时，有时出现404的问题

v2.1.0 (2024-12-05) ​

✨ 重大更新 ​

  • 🔄 整体架构升级重构

✨ 新功能 ​

  • ✨ 重构了人员加入工时的约束规则
  • ✨ 重构了人员填报项目工时的约束规则
  • ✨ 重构了工时模块的整体规则
  • ✨ 增加的项目整体查看模块
  • ✨ 增加了工时统计的模块
  • ✨ 增加了其他工时统计模块

🔧 优化改进 ​

  • ✅ 其他细节优化

v2.0.0 (2024-07-26) ​

✨ 新功能 ​

  • ✨ 整体架构升级,增加了周报模块，可以按周进行工时填报
  • ✨ 增加了周报模块，可以按周进行工时填报
  • ✨ 项目工时中，可查看日、周等工时填报记录

🐛 问题修复 ​

  • ✅ 修复了一些其他bug

升级指南 ​

从 v3.x 升级到 v4.0 ​

1. 备份数据 ​

bash
# 备份数据库
mysqldump -u root -p mulin_cost > backup_v3.sql

# 备份 Redis
redis-cli
> SAVE

2. 更新前端 ​

bash
cd mulin-ui
npm install
npm run build:prod

3. 更新后端 ​

bash
cd mulin-go
go mod tidy
go build -o mulin.exe

4. 数据库迁移 ​

bash
# 执行迁移脚本（如有）
mysql -u root -p mulin_cost < migration_v4.sql

5. 重启服务 ​

bash
# Docker Compose 方式
docker-compose down
docker-compose up -d

# 或独立部署
./mulin.exe

版本计划 ​

v4.1.0 (计划中) ​

新功能 ​

  • 📱 移动端优化
  • 📊 高级报表功能
  • 🔔 实时通知
  • 🌐 多语言支持

优化 ​

  • ⚡ 性能优化
  • 🎨 UI 改进
  • 📝 文档完善

v5.0.0 (规划中) ​

重大更新 ​

  • 🤖 AI 工时分析
  • 📈 智能预测
  • 🔗 第三方集成
  • 🎯 项目管理增强

最后更新: 2026-06-05

Released under the MIT License.

Copyright © 2026 无鱼软件