KPI 报告包工作流

目标与适用范围

把 API 与表格数据整理成 KPI 仪表盘、多标签 Excel 报告包、品牌化工作表、图表、迷你趋势图，以及高管可读的 PDF 或 Markdown 报告。
本指南将当前任务范围转化为可复核的交付结果。请保留源文件、中间产物和关键判断，让后续协作者能够理解检查了什么以及为什么这样处理。

准备证据并作出选择

• 收集 KPI 定义、报告周期、源 API 负载或工作簿导出文件，以及必要的 Excel 模板。

• 先决定最终交付物是可编辑 XLSX、董事会 PDF、财务报表 PDF、销售仪表盘 PDF，还是基于 Markdown 的报告合集。

• 决策点: 输入是原始 API 数据，还是已整理的工作簿？. JSON 或 API 响应需要落表时使用 XLSX API to Sheet；如果工作簿结构已经明确，则从模板填充或动态报表构建开始。

• 决策点: 读者更需要分析深度，还是高管汇报观感？. 总览、明细、异常和字典表用多标签报告包承载；需要快速理解 KPI 时，再加入仪表盘、主题、图表和迷你趋势图。

• 决策点: 最终要批准哪种格式？. 需要继续编辑就保留 XLSX；固定分发就转 PDF；销售、财务或带文字说明的材料则使用对应 PDF 与 Markdown 打包工具。

按步骤完成工作流

1. 把源指标加载为工作簿表格

将 API 或 JSON 响应转换为规范工作表，或填充已批准模板，让报告包从可追溯的指标输入开始。 使用 xlsx-api-to-sheet, xlsx-template-filler.

2. 搭建报告工作簿结构

创建动态表头、分组区块、KPI 卡片、总览页、明细页、异常页和字典页，形成可供分析复核的完整工作簿。 使用 xlsx-dynamic-report-builder, xlsx-kpi-dashboard-generator, xlsx-multi-tab-report-pack.

3. 加入可视化汇报线索

统一字体、配色、边框和标题样式，再嵌入图表与迷你趋势图，让趋势、差异和阈值变化无需手工排版即可看清。 使用 xlsx-sheet-theme-pack, xlsx-chart-embedder, xlsx-sparkline-injector.

4. 发布给利益相关方的交付物

把工作簿报表导出为固定 PDF，生成专门的销售或财务报告 PDF，或把 Markdown 叙事章节打包成最终报告。 使用 libreoffice-xlsx-to-pdf-report, pdf-sales-dashboard-pdf, pdf-financial-report, markdown-report-bundler.

交付前验收结果

• 报告包中的每个 KPI 都能追溯到源字段、公式或模板占位符。
• 工作簿包含必要的汇总、明细、异常和展示页，并且样式与图表证据保持一致。
• 最终 PDF 或 Markdown 报告写明报告周期、数据假设、指标定义和可审批结论。

常见问题

• 这个工作流会替代 BI 仪表盘吗？ 不会。它基于给定数据和工作簿生成可审阅的报告包；实时数仓建模、权限管理和持续刷新不在此工作流内。
• 同一流程能同时产出 Excel 和 PDF 吗？ 可以。先构建可编辑、可审计的工作簿，再导出或生成固定 PDF 版本用于高管分发。
• 什么时候需要 Markdown？ 当报告需要文字点评、方法说明、附录或发布说明，并且要和工作簿中的 KPI 证据一起交付时使用 Markdown。