reload/harvestdata

HarvestData镜像说明

镜像概述

HarvestData是一个控制台应用，用于从Harvest时间跟踪系统获取数据，并将其存储为Geckoboard自定义小部件支持的格式。该工具由Reload开发，源代码托管于GitHub，可帮助用户生成财务仪表盘、时间分析图表等数据可视化内容。

核心功能

1. 从Harvest系统获取时间跟踪数据（支持员工及承包商数据筛选）
2. 输出多种Geckoboard兼容的图表类型（如numberstatbudget、piechart、columnspline等）
3. 自定义时间范围（支持相对日期如"yesterday"或绝对日期格式）
4. 指定输出文件及图表周期（日/周/月分组）
5. 提供四类命令：entries（获取最新条目）、billable（可计费工时）、data（详细数据）、compare（时段对比）

使用场景

• 构建Geckoboard财务仪表盘展示团队工时数据
• 分析不同时段的可计费与非可计费工时占比
• 跟踪团队最新工作条目状态
• 对比预算与实际工时完成情况

配置说明

1. 复制项目中的config.sample.yml为config.yml，填写Harvest账户凭证及相关配置
2. 若配置文件不在默认路径，可通过--config参数指定路径（如--config ./my-config.yml）
3. 支持配置默认时间范围、是否排除承包商数据等参数

部署与使用示例

Docker运行示例

假设已准备好config.yml文件，挂载到容器内使用：

bash
docker run -v $(pwd)/config.yml:/app/config.yml reload/harvestdata data --date-from="-8 days" --date-to="yesterday" --chart-type=columnspline --output-file=columnspline3.js

常用命令示例

1. 获取最近8天数据并生成列线图：

bash
./harvestdata data --date-from="-8 days" --date-to="yesterday" --chart-type=columnspline --output-file=columnspline3.js

2. 比较昨天与前天的可计费工时：

bash
./harvestdata compare --date-from="yesterday" --date-to="yesterday"

3. 获取包含承包商的最新30条Harvest条目：

bash
./harvestdata entries --exclude-contractors=false --output-file=today.xml

4. 按月份统计过去6个月的堆叠柱状图：

bash
./harvestdata data --date-from="first day of 6 months ago" --date-to="last day of last month" --chart-type=stackedcolumn --chart-period=month --output-file=stackedcolumn-sixmonths.js