optilude/jira-agile-metrics

optilude/jira-agile-metrics 镜像说明

镜像概述

本镜像封装了jira-agile-metrics工具，用于从JIRA项目和Trello看板中提取Agile项目指标，生成结构化数据文件和可视化图表，帮助团队分析项目流程、识别瓶颈并优化工作效率。

核心功能

• 多源数据提取: 支持从JIRA（通过JQL查询）和Trello看板获取项目数据。
• 多样化输出:
  • 生成CSV、JSON、XLSX格式的数据文件（如周期时间、累计流图数据）。
  • 生成PNG格式的可视化图表（如累计流图、周期时间散点图、吞吐量趋势图、燃速预测图）。
• 灵活运行模式:
  • 单配置文件运行模式。
  • 批量处理模式（支持多个配置文件）。
  • 网页服务器模式（通过浏览器上传配置文件并下载结果压缩包）。

使用场景

• Agile团队分析项目流程，优化工作流（如调整WIP限制）。
• 项目管理者获取数据驱动的团队绩效洞察（如周期时间分布、吞吐量趋势）。
• 自动化JIRA/Trello项目指标报告生成。

配置说明

需通过YAML配置文件指定以下内容：

1. Connection: JIRA/Trello的连接信息（如JIRA域名、API令牌；Trello的API密钥/令牌）。
2. Query: JIRA的JQL查询语句或Trello看板名称。
3. Workflow: 项目工作流阶段映射（如Backlog → Committed → Done）。
4. Output: 需要生成的数据文件和图表（如CSV数据、PNG图表）。

Docker部署示例

基本运行（单配置文件）

bash
docker run -it --rm -v $PWD:/data optilude/jira-agile-metrics:latest config.yml

说明：将当前目录（含config.yml）挂载到容器/data目录，生成的结果将保存在当前目录。

批量处理模式

bash
docker run --rm -v /path/to/config:/config -v /path/to/output:/data optilude/jira-agile-metrics:batch-latest

说明：处理/path/to/config目录下的所有YAML配置文件，结果保存到/path/to/output。

网页服务器模式

bash
docker run -d --rm -p 8080:80 --name jira_metrics optilude/jira-agile-metrics:server-latest

说明：启动网页服务器，通过http://localhost:8080访问，上传配置文件并下载结果。 ===FULL_DESC===