moul/depviz

Depviz

镜像概述和主要用途

Depviz是一个问题依赖可视化工具（又称“自动路线图”），能够聚合多个项目的任务并生成依赖关系的可视化图表。其核心目标是促进技术与非技术人员的无缝协作，通过链接不同工具（如Jira、GitHub、GitLab等）中的任务，创建多样化的信息展示方式，帮助团队清晰理解项目整体视图和任务依赖关系。

核心功能和特性

多源任务聚合

• 支持从多种工具聚合任务，当前已支持GitHub（任务包括Issue、Pull Request、Milestone），计划支持GitLab、Jira、Trello
• 识别不同工具中任务的关联关系，例如将Jira用户故事与GitHub上的技术任务关联

依赖关系可视化

• 生成任务依赖关系图，直观展示任务间的先后顺序和依赖链条
• 支持多种布局和图表类型，未来计划实现基于PERT方法（计划评审技术）的图表，用于分析最短路径等关键路径信息

通用实体模型

定义三种核心实体，统一不同工具中的任务和资源：

• Task（任务）：具有明确生命周期（打开→关闭），如Issue、Pull Request、Milestone等，包含ID、标题、状态、依赖关系等属性
• Owner（所有者）：用于包含其他实体，如用户、组织、仓库等，包含ID、类型、元数据等属性
• Topic（主题）：用于分类或标记其他实体，如标签，包含ID、颜色、描述等属性

使用场景和适用范围

团队协作场景

• 非技术项目经理：通过Jira等工具管理用户故事和优先级，无需关注技术细节
• 开发人员：使用GitHub/GitLab等工具处理具体技术任务，自行估计工作量，专注于开发
• 跨团队协作：帮助不同角色（项目经理、开发、测试等）共享项目整体视图，减少沟通成本

项目管理场景

• 大型项目任务依赖分析，识别关键路径和潜在瓶颈
• 多项目整合管理，统一展示不同项目的任务进度和依赖关系

使用方法和配置说明

安装方式

下载发布版本

访问 https://github.com/moul/depviz/releases 下载对应平台的二进制文件

使用Golang安装

bash
go get moul.io/depviz/cmd/depviz/v3

使用Homebrew安装

bash
brew install moul/moul/depviz

Docker部署示例

基本运行命令

bash
docker run -d -p 8080:8080 --name depviz docker.xuanyuan.run/moul/depviz

环境变量配置

docker-compose配置示例

yaml
version: '3'
services:
  depviz:
    image: docker.xuanyuan.run/moul/depviz
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - GITHUB_TOKEN=your_github_token_here
      - LOG_LEVEL=info
    restart: unless-stopped

访问和使用

启动服务后，通过浏览器访问 http://localhost:8080 即可查看依赖关系可视化界面。Demo示例可参考 [***]

许可证

Depviz 采用 Apache-2.0 和 MIT 双许可证，详细信息参见 https://github.com/moul/depviz/blob/master/COPYRIGHT 文件。

SPDX-License-Identifier: (Apache-2.0 OR MIT)