摸鱼看板文档

Appearance

v1.7.0 发布 - 跨项目管理与风险洞察 ​

发布日期：2026年7月16日

摸鱼看板 v1.7.0 正式发布。本次版本以“跨项目管理与风险洞察”为主题，从单项目执行进一步延伸到多项目管理，建立了从发现风险、定位项目、分析版本到处理任务的完整管理闭环。

与此同时，v1.7.0 对任务状态、版本生命周期、数据权限、通知可靠性和存量数据库升级方式进行了系统性整理，让团队在项目数量和成员规模增长后，依然能够保持清晰、可靠的协作过程。

🎯 版本亮点 ​

  1. 管理驾驶舱：集中查看权限范围内的项目健康度、版本交付风险和任务异常
  2. 多项目矩阵：在同一看板中聚合多个项目，识别跨项目负载和 WIP 风险
  3. 版本交付闭环：完善发布、收尾、归档和取消归档规则，避免版本与任务状态矛盾
  4. 任务导入导出：支持 Excel 导入、筛选结果导出、批量导出和版本任务导出
  5. 统一状态流程：明确待处理、进行中、已完成、已取消、暂停和已关闭的操作边界
  6. 权限与可靠性增强：集中项目数据权限，修复通知和待审批数据隔离问题

📊 管理驾驶舱 ​

管理驾驶舱为管理者提供跨项目统一入口，按照“项目 → 版本 → 任务”三级结构组织信息：

  • 汇总权限范围内的项目数量、风险项目、逾期任务、版本风险和整体完成率
  • 按正常、关注、预警、严重展示项目健康状态及触发原因
  • 展示近八周任务流入与交付趋势，以及跨项目在办负载
  • 支持按项目筛选，并同步作用于汇总、趋势和项目排行
  • 点击项目后在当前页面分析版本，继续下钻到任务列表和任务详情
  • 对未使用版本管理的项目提供“项目日常任务”模式
  • 对尚未纳入版本的任务提供独立任务池

驾驶舱会统计规划中、进行中和已发布版本，已归档版本退出当前风险统计。版本指标进一步区分活跃版本、已交付版本、已发布待收尾版本和风险版本。

🧩 多项目矩阵 ​

多项目矩阵适合同时推进多个项目的团队：

  • 在一个矩阵中聚合一个或多个项目的任务
  • 任务卡片明确展示所属项目
  • 支持按项目、负责人和优先级筛选
  • 提供全局 WIP 限制和超限提醒
  • 可从任务卡片进入任务详情及所属项目
  • 查询增加任务数量保护，数据量过大时提示缩小筛选范围

管理驾驶舱负责发现风险，多项目矩阵负责观察当前执行分布，两者共同构成跨项目管理入口。

📦 版本发布与归档 ​

v1.7.0 明确了版本的完整生命周期：

规划中 → 进行中 → 已发布 → 已归档

已发布版本 ​

  • 冻结任务主体、负责人、计划日期、附件和版本归属
  • 任务状态和任务阶段仍可继续收尾
  • 版本名称、描述、开始日期和计划发布日期仍可修改
  • 已发布但存在未关闭任务时，管理驾驶舱标记为“待收尾”或版本风险

已归档版本 ​

  • 普通归档要求关联任务全部为已关闭或已取消
  • 强制归档会关闭非终态任务，并统一结项未结束阶段
  • 任务关闭、阶段结项和版本归档在同一个数据库事务中执行
  • 归档操作记录原状态、操作人和原因，任一步失败则整体回滚
  • 归档后版本、任务、阶段和附件完全冻结
  • 支持取消归档并恢复为已发布，但不会自动重新打开任务或阶段

版本列表默认显示已归档版本，也可以通过开关隐藏历史版本。

📥 任务导入与导出 ​

Excel 导入 ​

  • 项目任务列表新增 Excel 导入入口和标准模板
  • 支持导入预览、逐行校验和二次确认
  • 负责人按用户名或昵称匹配项目成员，任务类型按名称匹配
  • 项目内同名任务会被拒绝，不覆盖已有数据
  • 导入文件不设置所属版本，导入后可批量加入版本
  • 导入结果展示成功数量、失败数量和逐行失败原因

多种导出方式 ​

  • 导出当前筛选结果
  • 导出任务列表中已选择的任务
  • 导出版本详情中的关联任务
  • 导出结果遵循当前项目、名称、类型和状态筛选
  • 修复 Excel 打开时工作表视图损坏的问题

下载安全提示

浏览器访问本地 HTTP 地址时，可能仍会将下载文件标记为“不安全”。该提示来自浏览器的 HTTP 下载策略，不影响 Excel 文件内容和结构。

🔄 任务状态流程统一 ​

v1.7.0 统一了任务主状态、合法操作和列表查询口径：

  • 待处理 → 进行中、已取消
  • 进行中 → 已完成、已取消、暂停
  • 已完成 → 已关闭、重新激活为进行中
  • 已取消 → 恢复为待处理
  • 暂停 → 继续为进行中、已取消
  • 已关闭 → 成功终态，不再继续流转

“已完成”表示工作已经完成但尚未关闭；在需要强调管理动作的界面中，会显示为“已完成，待关闭”。任务列表默认隐藏已关闭和已取消任务，用户仍可通过状态筛选查看历史数据。

🧭 项目统计导航整合 ​

项目详情不再平铺所有统计入口。点击“项目统计”后，可在二级导航中切换：

  • 项目统计
  • 累积流图
  • 控制图
  • 吞吐量
  • 瓶颈分析

原有导航参数保持兼容，已有链接和页面刷新逻辑不受影响。

🔒 权限与通知可靠性 ​

本次版本集中整理了项目、任务及关联资源的数据权限：

  • 项目、任务、阶段、版本、成员、评论、附件和报告接入统一权限策略
  • 系统管理员统一识别用户名为 admin 或拥有 admin 角色的用户
  • 修复新用户看到非本人消息提醒的问题
  • 修复“待我审批”混入其他人员数据的问题
  • 列表、导出和全局阶段任务均按当前用户可见项目过滤
  • 任务业务变更与审计日志在同一个事务中提交
  • 站内通知在任务事务内可靠写入
  • 邮件、企微、钉钉和飞书仅在启用后通过 Outbox 异步投递

⚙️ 技术与性能改进 ​

  • 优化 WIP 阶段查询中的主要 N+1 查询
  • 为高频查询补充组合索引
  • 拆分任务查询、状态策略和通知事件职责
  • 核心权限、任务事务和阶段事务支持数据库依赖注入
  • 管理驾驶舱采用聚合查询，减少逐项目重复统计
  • 统一每个版本只保留一个可重复执行的存量数据库升级脚本

🚀 升级指南 ​

升级前请注意

v1.7.0 不会在服务启动时自动修改存量数据库。升级已有环境时，必须先备份数据库，并手动执行统一升级脚本。

统一升级脚本：

text
deploy/database/migrations/v1.7.0_complete.sql

推荐升级顺序：

  1. 备份数据库、配置文件和上传目录
  2. 停止旧版本服务
  3. 在目标数据库执行 v1.7.0_complete.sql
  4. 更新后端程序和前端资源
  5. 保留原有配置文件，并按新版示例补充缺少的配置项
  6. 启动服务并检查版本号、License、通知配置和关键权限
  7. 清理浏览器缓存后重新登录

Docker Compose 用户 ​

bash
docker compose down
docker compose pull
docker compose up -d mysql
# 连接 MySQL，手动执行 v1.7.0_complete.sql
docker compose up -d
docker compose logs -f

✅ 升级后建议检查 ​

  • 管理员、项目经理和普通成员看到的项目范围是否正确
  • 管理驾驶舱数据是否与项目任务和版本数据一致
  • 多项目矩阵是否只展示有权访问的项目
  • 任务导入、筛选导出和版本任务导出是否正常
  • 已发布版本能否继续收尾，归档后是否完全冻结
  • 新用户通知和“待我审批”是否只包含本人数据
  • License 激活、功能权限和远程验证是否正常

相关链接：

Released under the License.

Copyright © 2025-2026 摸鱼看板