任务分阶段推进 · 工作自动流转 · 报告自动生成
## 📖 项目简介 摸鱼看板是一款基于 **Go + Vue3** 开发的现代化项目管理平台，采用**看板方法（Kanban Method）**为核心理念。系统提供 WIP 限制看板、任务阶段管理、专业甘特图、自动化周报等核心功能，帮助团队提升协作效率，简化项目管理工作流。 ### ✨ 核心价值 - **🎯 聚焦价值交付**：通过 WIP 限制减少任务切换损耗，加速价值交付周期 - **🔄 任务阶段管理**：将复杂任务拆解为可管理的阶段，清晰追踪每个阶段的执行状态 - **⚡ 工作自动流转**：拖拽即可完成操作，新用户5分钟即可上手 - **📊 智能报表生成**：自动周报月报，多维度分析项目进展 ## 🚀 核心功能特性 ### 1. 📊 可视化看板 #### WIP 限制看板 - 为项目设置最大在办任务数（WIP Limit） - 超限时自动预警，引导团队聚焦当前任务 - 直观的卡片式布局，支持拖拽流转 - 实时显示各列任务数量  #### 阶段（Stage）看板 - 左侧任务列表 + 顶部阶段列的矩阵布局 - 每个单元格显示任务在对应阶段的状态（未开始/进行中/待验收/已验收） - 支持快捷操作：开始、完成、验收、阻塞、恢复 - 实时显示阶段完成计数（如 2/5），直观掌握进度  ### 2. 🎯 任务阶段管理模式 将复杂任务拆解为多个可管理的阶段，实现精细化管控： - **多阶段定义**：自定义项目阶段（如需求、设计、开发、测试、验收等） - **状态流转**：每个阶段支持未开始/进行中/待验收/已验收四种状态 - **依赖管理**：清晰的阶段依赖关系，确保任务有序推进 - **进度追踪**：实时统计各阶段完成情况，一目了然  ### 3. 📈 专业甘特图 - 直观展示项目时间线和任务依赖关系 - 支持任务拖拽调整时间和顺序 - 关键路径标识，快速定位影响进度的任务 - 多种视图切换（日/周/月）  ### 4. 👥 智能待办中心 集中管理个人待办事项，提升工作效率： - **统一待办视图**：聚合所有分配给我的任务 - **优先级排序**：按优先级和截止时间智能排序 - **快速操作**：一键开始、完成任务 - **工作模式**：专注当前正在处理的任务  ### 5. 📝 自动化报表 #### 周报自动生成 - 自动汇总本周完成的任务 - 统计各类型任务数量和耗时 - 支持下周计划填写 - 一键导出分享  #### 月报统计分析 - 月度任务完成情况统计 - 多维度数据分析（按类型、按成员、按阶段） - 趋势图表展示 - 问题和建议记录  ### 6. 🗂️ 项目矩阵管理 - **多项目并行**：同时管理多个项目，快速切换 - **角色权限**：拥有者/管理者/成员三级权限体系 - **成员协作**：项目成员管理和任务分配 - **进度总览**：项目列表展示整体进度和状态  ### 7. 💬 任务评论与协作 任务详情页新增评论功能，方便团队围绕任务进行讨论： - **评论与回复** - 支持对任务发表评论，并可回复其他成员的评论 - **@提及成员** - 在评论中 @团队成员，快速通知相关人员 - **评论倒序显示** - 最新评论优先展示，方便查看最新讨论 - **Markdown 支持** - 评论支持 Markdown 格式，可以插入代码、链接等  ### 8. 📎 任务附件管理 任务详情新增附件管理功能，支持文件上传与下载： - **文件上传** - 支持拖拽上传和点击上传，单个文件不超过 50MB - **文件下载** - 一键下载任务相关附件 - **附件删除** - 支持删除不需要的附件 - **文件预览** - 图片附件支持点击放大查看 - **多类型支持** - 支持文档、压缩包、代码文件等多种类型  ### 9. 🔔 通知管理系统 - 任务分配通知 - 阶段状态变更提醒 - 截止日期预警 - 实时消息推送 ### 10. 🛠️ 系统管理功能 - **用户管理**：系统用户配置和管理 - **部门管理**：组织机构树结构管理，支持数据权限 - **角色管理**：角色菜单权限分配和数据范围权限 - **菜单管理**：系统菜单和操作权限配置 - **字典管理**：系统固定数据维护 - **操作日志**：系统操作和异常日志记录 - **在线用户**：活跃用户状态监控 ## 💻 技术栈 ### 前端 - **框架**：Vue 3.4 + Vite 5 - **UI组件库**：Element Plus 2.7 - **状态管理**：Pinia 2.1 - **路由**：Vue Router 4.4 - **图表**：ECharts 5.5 - **甘特图**：dhtmlx-gantt / vue-ganttastic - **富文本编辑器**：@vueup/vue-quill / md-editor-v3 - **拖拽**：vuedraggable 4.1 ### 后端 - **语言**：Go - **架构**：前后端分离 ## 🏗️ 项目结构 ``` moyu-kanban/ ├── doc/ # 项目文档和截图 ├── server/ # 后端服务 │ ├── cmd/ # 入口文件 │ │ └── server/ │ │ └── main.go # 主程序入口 │ ├── config/ # 配置管理 │ │ ├── config.go │ │ └── config.yaml # 配置文件 │ ├── internal/ # 内部包 │ │ ├── model/ # 数据模型 │ │ ├── handler/ # 请求处理器 │ │ ├── service/ # 业务逻辑层 │ │ ├── repository/ # 数据访问层 │ │ └── middleware/ # 中间件 │ ├── pkg/ # 公共包 │ │ ├── database/ # 数据库连接 │ │ ├── redis/ # Redis客户端 │ │ ├── logger/ # 日志组件 │ │ └── utils/ # 工具函数 │ ├── migrations/ # 数据库迁移 │ ├── go.mod │ └── go.sum ├── web/ # 前端项目 │ ├── src/ │ │ ├── api/ # API接口定义 │ │ ├── assets/ # 静态资源 │ │ ├── components/ # 公共组件 │ │ ├── composables/ # 组合式函数 │ │ ├── layouts/ # 布局组件 │ │ ├── router/ # 路由配置 │ │ ├── stores/ # 状态管理 │ │ ├── utils/ # 工具函数 │ │ ├── views/ # 页面视图 │ │ ├── App.vue │ │ └── main.ts │ ├── .env # 环境变量 │ ├── .env.development │ ├── .env.production │ ├── index.html │ ├── package.json │ ├── tsconfig.json │ ├── vite.config.ts │ └── README.md └── README.md ``` ## 🔧 项目配置 ### 前端环境变量 ```bash # 创建前端环境配置文件 cp web/.env.example web/.env ``` ### 后端配置文件 ```bash # 复制配置文件 cp server/config/config.yaml.example server/config/config.yaml # 编辑配置文件，修改数据库和Redis连接信息 ``` ## 🚀 快速开始 ### 环境要求 #### 前端环境 - **Node.js**: >= 16.0.0 - **npm**: >= 8.0.0 或 **pnpm**: >= 8.0.0 #### 后端环境 - **Go**: >= 1.21 - **MySQL**: >= 8.0 - **Redis**: >= 6.0 ### 📦 安装依赖 #### 前端安装 ```bash # 进入前端目录 cd web # 使用 npm 安装 npm install # 或使用 pnpm（推荐） pnpm install ``` #### 后端安装 ```bash # 进入后端目录 cd server # 下载Go依赖 go mod download # 或同步更新依赖 go mod tidy ``` ### 🗄️ 数据库初始化 ```bash # 创建数据库 mysql -u root -p -e "CREATE DATABASE moyu_kanban CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;" # 后端会自动执行数据库迁移 # 首次启动时会自动创建所需的表结构 ``` ### ▶️ 运行项目 #### 开发模式 ```bash # 终端1：启动后端服务 cd server go run cmd/server/main.go # 终端2：启动前端服务 cd web npm run dev ``` #### 访问项目 - 前端地址：http://localhost:5173 - 后端API：http://localhost:8080/api - 默认管理员账号：admin / admin123 ### 🐳 Docker部署 #### 使用Docker Compose一键启动 ```bash # 克隆项目 git clone https://gitee.com/wy-soft/moyu-board.git cd moyu-board # 启动所有服务 docker-compose up -d ``` #### Docker Compose配置文件 ```yaml # docker-compose.yml version: '3.8' services: app: build: ../.. ports: - "8080:8080" environment: - DB_HOST=mysql - DB_PORT=3306 - DB_USER=root - DB_PASSWORD=your_password - DB_NAME=moyu_kanban - REDIS_HOST=redis - REDIS_PORT=6379 depends_on: - mysql - redis restart: unless-stopped mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: your_password MYSQL_DATABASE: moyu_kanban volumes: - mysql_data:/var/lib/mysql ports: - "3306:3306" restart: unless-stopped redis: image: redis:7-alpine ports: - "6379:6379" restart: unless-stopped volumes: mysql_data: ``` ### ☁️ 生产环境部署 #### 后端部署 ```bash # 1. 编译后端程序 cd server go build -o moyu-kanban-server cmd/server/main.go # 2. 配置环境变量或修改config.yaml # 3. 运行服务 nohup ./moyu-kanban-server > app.log 2>&1 & # 4. 配置systemd服务（可选） sudo vim /etc/systemd/system/moyu-kanban.service ``` #### 前端部署 ```bash # 1. 构建生产版本 cd web npm run build # 2. 构建产物在 dist 目录 # 3. 配置Nginx ``` #### Nginx配置示例 ```nginx server { listen 80; server_name your-domain.com; root /path/to/moyu-board/web/dist; index index.html; # 前端路由 location / { try_files $uri $uri/ /index.html; } # API代理 location /api { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } # 静态资源缓存 location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ { expires 30d; add_header Cache-Control "public, immutable"; } } ``` ## 📸 功能演示 | 功能模块 | 截图 | |----------|------| | 主页 |  | | 项目列表 |  | | WIP看板 |  | | 阶段看板 |  | | 任务详情 |  | | 项目统计 |  | | 周报 |  | | 生成周报 |  | ## 🎯 适用场景 - ✅ **软件开发团队**：迭代开发、敏捷项目管理 - ✅ **产品设计团队**：需求管理、设计评审流程 - ✅ **运营团队**：活动策划、内容发布管理 - ✅ **个人任务管理**：目标拆解、进度追踪 - ✅ **跨部门协作**：多团队协作、项目进度同步 ## 演示环境 http://demo.moyukanban.com 密码，添加公众 wuyusoft 获取。 ## 🌟 产品理念 我们相信，好的项目管理工具应该**简化工作，而非增加负担**。 ### 核心理念 1. **WIP 限制原则**：限制每个阶段在办任务数，减少任务切换损耗，加速价值交付周期 2. **任务阶段管理**：将复杂任务拆解为可管理的阶段，降低认知负荷 3. **极简交互设计**：拖拽点击即可完成操作，新用户5分钟即可上手 ## 🔗 相关链接 - **Gitee仓库**：[https://gitee.com/wy-soft/moyu-board](https://gitee.com/wy-soft/moyu-board) - **官方网站**：[https://www.moyukanban.com](https://www.moyukanban.com) - **产品文档**：[https://doc.moyukanban.com](https://doc.moyukanban.com) ## 📝 更新日志 ### 版本路线图 | 版本 | 主题 | 核心功能 | |------|------|----------| | v1.3.0 | 任务协作增强 | 任务评论、任务附件、通用文件上传 | | v1.4.0 | 日历视图 | 月/周视图切换，任务按计划时间展示 | | v1.5.0 | 任务分类与检索 | 任务标签、子任务/检查清单、全局搜索 | | v1.6.0 | 工时与效率分析 | 工时估算与记录、成员工作量视图、任务导出 | | v1.7.0 | 可视化增强 | 燃尽图、任务依赖关系 | | v1.8.0 | 智能里程碑 | 基于已完成任务自动标记、项目模板、任务收藏 | | v2.0.0 | 平台级升级 | 项目归档、数据导入、跨项目仪表盘 | --- ### v1.3.0 (2026-06-02) #### ✨ 新功能 - **任务评论系统** - 任务详情页面支持评论功能，方便团队成员围绕任务进行讨论 - **任务附件管理** - 支持文件上传与下载，单个文件不超过 50MB，支持多种文件类型 - **通用文件上传接口** - 扩展文件上传能力，支持文档、压缩包、代码文件等多种类型 #### 🎨 功能优化 - **阶段详情布局优化** - 采用左侧主内容 + 右侧属性面板的双栏设计，信息展示更清晰 - **完成报告条件显示** - 只有“待验收”或“已完成”状态的阶段才显示完成报告 - **甘特图错误提示优化** - 系统未激活时弹出友好的警告对话框，明确指引用户 - **消息通知功能开放** - 解除系统激活限制，所有版本均可使用消息通知功能 #### 🐛 Bug 修复 - 修复阶段详情空指针异常，添加 stageInfo 空值安全检查 - 修复阶段描述无法编辑问题，在 kb_task_stage 表增加 description 字段 - 修复上传附件时 fileData 为空导致的错误 #### ⚡ 代码优化 - 前端空值安全访问规范，所有可能为 null 的对象访问都添加安全检查 - 后端 description 字段更新逻辑优化，支持清空操作 - 优化组件状态管理，弹窗关闭时正确清理状态 --- ### v1.2.0 (2026-05-23) #### ✨ 新功能 - **周报编辑器** - 支持在生成周报前补充和调整总结内容，支持富文本编辑 - **周报导出功能** - 支持将周报导出为 PDF 和 Word 格式，便于存档分享 - **多渠道通知系统** - 支持邮件、企业微信、钉钉、飞书等多种通知渠道 - **用户通知设置** - 个人中心支持配置各渠道通知开关和绑定账号 #### ⚡ 代码优化 - 周报预览页面增加导出下拉菜单 - 通知配置页面支持查看各渠道启用状态 --- ### v1.1.0 (2026-05-09) #### ✨ 新功能 - **项目阶段颜色支持** - 为阶段管理增加颜色配置，提供默认配色方案（规划-#FDB022、执行-#4285F4、测试-#34A853、发布-#9C6CFF） - **阶段看板视觉优化** - 表头采用彩色徽章样式，任务卡片标题应用阶段颜色，增强视觉关联 - **视图切换功能** - 左侧面板支持任务列表/进度追踪视图切换，显示总任务数和各阶段计数 - **任务搜索增强** - 任务列表接口支持按项目名称搜索，返回数据增加 projectName 字段 - **富文本支持** - 任务详情描述支持富文本格式渲染，图片点击放大查看 #### 🐛 Bug 修复 - 修复 TaskDetail 弹窗无法打开问题，添加 watch 监听器同步状态 - 修复 WangEditor 图片路径问题，编辑器预览自动拼接完整 URL - 修复阶段颜色更新校验错误，更新时同时传入原有 stageName - 修复阶段看板卡片样式混乱，统一使用 .task-card-mini 样式类 - 修复进度追踪面板样式丢失，重新添加统计卡片样式 - 修复阶段详情操作按钮换行，实现横向滚动布局 - 修复 showAcceptedStage 参数无效问题，正确应用过滤逻辑 - 修复项目 WIP 配置查询返回 null，改为返回默认值 #### ⚡ 代码优化 - 清理冗余类型转换，提升代码可读性 - TaskDetail 组件增加垂直滚动，优化长内容展示 - TaskSearch 页面增加固定高度和滚动容器 --- ### v1.0.0 (2024-04-29) #### ✨ 新功能 - 🎯 WIP限制看板：支持设置在办任务上限，优化工作流效率 - 📊 阶段看板：矩阵式任务阶段管理，清晰追踪任务进度 - 📈 专业甘特图：可视化项目时间线，任务依赖一目了然 - ✅ 智能待办中心：统一管理个人待办，优先级智能排序 - 📝 自动化报表：周报月报自动生成，多维度数据分析 - 🔔 通知管理系统：实时推送任务变更提醒 #### 🐛 问题修复 - 修复看板拖拽在部分浏览器中的兼容性问题 - 优化移动端视图显示效果 - 修复甘特图任务时间计算误差 #### ⚡ 性能优化 - 优化大数据量下的看板渲染性能 - 改进数据库查询效率 - 前端资源懒加载优化 --- ## 💬 联系我们 - **QQ群**：7834330 - **Email**：support@moyukanban.com - **官网**：[https://moyukanban.com](https://moyukanban.com) ---Made with ❤️ by 摸鱼看板团队