数据看板汇报（Excel 数据表 → 可查数看板）
> 四件交付物的分工（别拿错，形态完全不同）
>
> | 技能 | 读者拿到后做什么 | 关键词 |
> |---|---|---|
> | 数据看板汇报（本技能） | 自己查数：切年度、点表头排序、搜索某一行 | KPI、图表、可排序明细 |
> | 交互汇报网页 | 被带着看完：一屏一屏翻，配微信分享卡片 | 翻页、演示、转发 |
> | 打印长图交付件 | 打印/归档/发群：A4 一纸一页、长图 | PDF、A4、长图 |
> | 合同批注汇报 | 逐条核修订：意见卡 + 条款原文 + 跳转 Word | 批注、划改对比 |
Overview
将含有数字、账龄、类别、客户/项目等明细的 Excel 表格，转化为可分享的交互式 HTML 汇报。输出包含桌面版、手机 H5 预览版、打印 PDF，所有资源自包含（无外部 CDN），适配微信转发与会议投屏。
When to Use
- 用户引用
.xlsx/.xls表格，要求"直观汇报"、"可视化"、"做成汇报文件"。 - 表格内容涉及：欠费明细、账龄结构、关联方、诉讼状态、经营指标、项目汇总等。
- 用户需要：KPI 卡片、图表、可排序/筛选的明细表、手机预览、PDF、在线分享链接。
Workflow
-
解析 Excel
- 使用openpyxl读取所有工作表，列出表名、行列数。
- 定位权威汇总表（通常是列头含"汇总"、"金额"、"合计"的表），忽略含#REF!或明显陈旧的表。
- 读取明细表时跳过空项目、0 值、负数（预收款/冲抵），避免合计与汇总口径冲突。 -
计算核心指标
- 总额、业务类别分布、账龄（1-3月 / 4-6月 / 7月+）、关联方占比、诉讼占比、TOP 风险项。
- 将计算结果与明细行一起序列化为 JSON，嵌入 HTML。 -
生成交互式 HTML
- 配色：深蓝 (#0B2545) + 金 (#C9A24B)，商务/物业风格。
- 组件：KPI 卡片、SVG 环形图/横向条形图、项目卡片、风险提示横幅、可排序/筛选/搜索明细表。
- 自包含：CSS/JS/数据全部内联，无外部 CDN。
- 数字直接渲染最终值（不要在打印/PDF 中依赖 count-up 动画，否则无头浏览器易截到中间值）。
- 必须把assets/present-mode.html整段粘贴到</body>之前（见下方「演示模式」）。已生成的旧页面用scripts/inject_present.py补。 -
生成手机 H5
- 在桌面版基础上做 mobile-first 适配：viewport-fit=cover、卡片堆叠、表格横向滚动、触控友好。 -
导出 PDF
- 用 Edge 无头--print-to-pdf。
- 在 CSS@media print中隐藏导航/顶栏、冻结 reveal 动画、避免图表卡片被分页截断。 -
部署分享
- 桌面版与手机版分别复制到独立目录（如deploy_report_arrears/、deploy_mobile_arrears/），使用workbuddy_cloudstudio_deploy获取公开链接。
- 每次使用唯一目录名，避免覆盖旧链接。
演示模式（全屏翻页）
看板除了「让读者自己查数」，还要能会议投屏逐屏讲。生成 HTML 时把
assets/present-mode.html 整段粘到 </body> 之前即可获得一层「翻页遥控器」；
已生成的旧页面用 scripts/inject_present.py 补，默认另存 .present.html，不覆盖原件。
- 快捷键（仅演示模式内生效，正常阅读时按键不受影响）：
↓ → PgDn 空格下一页 /↑ ← PgUp上一页 /Home End首末屏 /F全屏 /Esc退出 - 链接直达演示：地址后加
#pm - 自动切屏优先级：
[data-screen]>section>article/.card/.item/.layer>h2所在块 > 按视口等分 - 长屏会步进：明细表那屏常比视口高一倍，按 ↓ 先在本屏内滚动一屏，到屏底才跳下一屏 —— 不会卡在屏顶导致下半张表永远翻不到
- 不劫持输入框：搜索框、筛选框里按 ↓ 正常移动光标，不翻页
- 屏太挤时（如折叠卡高度 79px）自动退回按视口等分，页面不报错、能翻完
- 页面已自带翻屏骨架（
progress/dots/slide）时脚本会警告并拒绝注入，避免两套导航并存
实测基线（某项目收支看板，1440×900）：4 屏、连按 ↓ 走完 327 → 909 → 1354 → 2139 → 2924 → 3087（页底），Home 回 0，搜索框内按键零劫持。
Customization Guide
- 源文件路径、表名、列索引、业务类别映射需要在脚本中按实际表格调整。
- 图表类型可替换：账龄用环形图、业务分布用横向条形图、性质构成用堆叠/环形图。
- 若表格无"账龄"列，可改为"完成率/进度/同比"等维度。
Resources
assets/present-mode.html：演示模式（翻页遥控器）片段，粘到</body>前即生效。与合同批注汇报共用同一份，改动需两边同步。scripts/inject_present.py：给已有 HTML 注入 / 移除演示模式。默认另存.present.html；--inplace才覆盖（自动备份）；已注入则幂等跳过；检测到自有翻屏骨架会警告。scripts/build_report_template.py：以欠费明细为例的完整生成脚本，可直接改编。references/workflow.md：详细的字段映射、图表选择、打印与部署注意事项。
