ACH 月度交易量估算器

工作流程

1. 获取 ACH KPI 邮件：

   gog gmail messages search "subject:ACH KPIs" --account glaser.dave@gmail.com --max 1 --json
   

2. 下载 PDF 附件（包含全部图表与数据）：

   # 获取含附件 ID 的邮件详情
   gog gmail get  --account glaser.dave@gmail.com --json
   # 查找名为 "ACH KPIs.pdf" 的附件（mimeType: application/pdf）
   # 下载该附件：
   gog gmail attachment   --account glaser.dave@gmail.com --out ~/clawd/work/ach-kpis-latest.pdf
   

3. 从 PDF 中提取数据。该 PDF 包含 Tableau 仪表板导出内容，具体包括：

   • ACH 交易量图表：按月环比（MoM）柱状图，含每月总量、每位 BD 平均值，以及 5/20/60 日对比数据
   • 客户增长图表（按 10K 和 5K 门槛划分）
   • 前 60 名客户表格（含 60 日与 20 日对比）

   需提取的关键数值：

   • 当月交易总量（部分值，来自 MoM 柱状图）
   • 已过营业日天数（可从“近 20 日”行中的日期范围推导，或从当月首日至报告日期计数得出）
   • 年初至今（YTD）日均交易量（按营业日计算）
   • 上一财年同期（SPLY）月度总量（用于对比）

4. 运行估算器：

   python3 ~/clawd/skills/ach-volume-estimator/scripts/estimate.py 
     --transactions  --bds-elapsed  [--month YYYY-MM]
   

   若已知单日营业日均值，可直接使用：

   python3 ~/clawd/skills/ach-volume-estimator/scripts/estimate.py 
     --per-bd  [--month YYYY-MM]
   

   添加 --json 参数可输出结构化 JSON 格式结果。

5. 与基准值对比：

   • 2026 年 1 月实际值：6.12M（20 个营业日，305K/BD）
   • 2025 年 12 月实际值：6.41M（22 个营业日，291K/BD）
   • PDF 中 MoM 图表所列的 SPLY 值

6. 生成可视化仪表板：

   ~/clawd/scripts/ach-dashboard-gen
   

   该脚本读取 ~/clawd/work/ach-reports/latest-ach-data.json（若不存在则回退至最新 Markdown 报告），并生成 ~/clawd/work/ach-reports/dashboard.html。
   查看地址：http://192.168.1.60:3013/html/work/ach-reports/dashboard.html
   TV 模式地址：http://192.168.1.60:3013/html/work/ach-reports/dashboard.html?tv=1

7. 交付：将估算结果纳入发送给 Dave 的 ACH KPI 汇总报告中，并附上上述仪表板 URL。

输出格式

单行摘要格式：2026-02 估算值：5.81M 笔交易 |（共 19 个营业日，已过 12 日，剩余 7 日）| 306,000 笔/营业日 |（截至目前累计 3,672,000 笔）

营业日日历

脚本内置美国联邦储备银行节假日日历（2025–2027 年硬编码）。排除周末及全部美联储法定假日（新年、马丁·路德·金纪念日、总统日、阵亡将士纪念日、六月节、独立日、劳动节、哥伦布日、退伍军人节、感恩节、圣诞节）。

集成方式

接入现有 cron 任务：“每日 ACH KPI 汇总发送至 Dave”（工作日东部时间上午 9:30 执行）。在完成邮件数据提取后，自动运行估算器，并将月度预测结果追加至 Dave 的汇总报告中。