v1.3.0 版本发布总结

📅 发布信息

• 版本号： v1.3.0
• 发布日期： 2026-06-02
• 版本主题： 任务协作与用户体验增强

🎯 版本目标

本次版本聚焦于两个核心目标：

1. 增强任务协作能力 - 通过评论和附件功能，让团队成员围绕任务高效协作
2. 优化用户体验 - 改进错误提示和界面展示，让系统更加友好

✨ 核心功能

1. 任务评论系统

功能亮点：

• 支持评论、回复
• 评论倒序显示，最新评论优先
• 支持 Markdown 格式
• 实时显示评论数量

技术实现：

• 新增 TaskComment 组件
• 后端新增评论相关 API（增删改查）
• 数据库新增 kb_task_comment 表
• 支持评论计数 badge 显示

相关文件：

• kanban_ui/src/views/components/TaskComment.vue - 评论组件
• kanban_server/internal/kanban/handler/task_comment.go - 评论处理器
• kanban_server/internal/kanban/service/task_comment.go - 评论服务
• kanban_ui/src/api/kbtask/taskComment.js - 评论 API

2. 任务附件管理

功能亮点：

• 支持拖拽上传和点击上传
• 文件下载和删除
• 图片附件点击放大预览
• 附件数量统计显示

技术实现：

• 新增 TaskAttachment 组件
• 扩展文件上传接口，支持多种文件类型
• 后端新增附件管理 API
• 数据库新增 kb_task_attachment 表
• 文件按日期分类存储

相关文件：

• kanban_ui/src/views/components/TaskAttachment.vue - 附件组件
• kanban_server/internal/kanban/handler/task_attachment.go - 附件处理器
• kanban_server/internal/kanban/service/task_attachment.go - 附件服务
• kanban_ui/src/api/kbtask/taskAttachment.js - 附件 API

3. 通用文件上传接口

功能亮点：

• 突破图片限制，支持多种文件类型
• 文件大小和类型安全校验
• 统一的上传接口和存储机制

技术实现：

• 扩展 common/upload 模块
• 支持文件类型白名单校验
• 文件大小限制配置

🎨 功能优化

1. 阶段详情完成报告优化

优化内容：

• 完成报告仅对"待验收"（status=2）或"已完成"（status=3）的阶段显示
• 未开始或进行中的阶段不再显示空的完成报告区域
• 界面更加清爽，减少视觉干扰

修改文件：

• kanban_ui/src/views/components/StageDetail.vue
  • 第 59 行：添加 v-if="stageInfo.status === 3 || stageInfo.status === 2" 条件

🐛 Bug 修复

1. 阶段详情完成报告无条件显示 - 通过添加状态条件判断修复
2. 甘特图加载失败仅控制台报错 - 通过弹出框提示修复
3. 评论组件状态未正确重置 - 优化弹窗关闭时的状态清理

📊 代码变更统计

前端（kanban_ui）

• 新增文件：2 个（TaskComment.vue, TaskAttachment.vue）
• 修改文件：3 个（StageDetail.vue, ProjectGantt.vue, TaskDetail.vue）
• 新增 API：2 个（taskComment.js, taskAttachment.js）

后端（kanban_server）

• 新增文件：4 个（handler 和 service 各 2 个）
• 修改文件：1 个（upload 模块扩展）
• 数据库表：2 个（kb_task_comment, kb_task_attachment）

🚀 部署说明

Docker 部署

docker-compose down
docker-compose pull
docker-compose up -d

独立部署

1. 下载最新版本安装包
2. 备份现有数据库
3. 解压并替换文件
4. 重启服务

🎯 后续计划

v1.4.0 - 日历视图

• 月/周视图切换
• 任务按计划时间展示
• 日历任务接口

v1.5.0 - 任务分类与检索

• 任务标签
• 子任务/检查清单
• 全局搜索

💡 经验总结

成功经验

1. 组件化开发 - 评论和附件功能采用独立组件，便于维护和复用
2. 倒序显示决策 - 评论默认倒序，符合用户使用习惯
3. 错误提示优化 - 从控制台报错改为友好弹出框，用户体验明显提升

改进建议

1. 可以考虑增加评论的编辑功能
2. 附件上传可以增加进度条显示
3. 考虑增加评论的富文本编辑器支持