采购报表看板生成器

将 SAP 导出的零部件采购计划表一键转换为交互式数据看板，聚焦预留缺件、采购组分析、到货进度三大核心。

适用场景

采购员每日从 SAP 导出报表后，快速整理成可视化分析
采购团队日常缺件巡检和进度追踪
管理者查看采购汇总仪表盘
缺件物料快速定位与优先级排序
到货进度填写情况检查
按采购组、流量分类多维度筛选分析

工作流程

SAP导出报表 → 数据清洗 → 指标计算 → 生成看板
  (Excel)        ↓         ↓        (HTML)
             自动表头检测  缺件统计
             字段映射    采购组汇总
             格式统一    流量分类

使用方法

第一步：清洗数据

python3 scripts/clean_data.py <sap_report.xlsx> --output <cleaned.json>

自动处理：

自动检测表头行位置（支持多行表头、标题行）
自动跳过左侧空列
30+ 字段自动映射（中文列名 → 标准字段名）
数值格式统一（去除空格、统一数值类型）
可用库存总量自动计算

完整字段映射表见 references/fields.md。

第二步：生成看板

python3 scripts/generate_dashboard.py <cleaned.json> --output <dashboard.html>

看板内容：

KPI 卡片（6个）

物料总数
缺件物料数 + 缺件率
总缺件数量
拖欠订单数
到货进度填写率
采购组数量

图表（4个）

到货进度填写率 · 按采购组 — 横向柱状图，按填写率高低着色
物料数 · 按流量分类 — 环形饼图
物料数 · 按采购组 — 横向柱状图
缺件 TOP10 物料 — 横向柱状图

明细表

按预留欠缺降序排列
12 列关键信息：物料号、物料描述、采购组、零部件类别、业务板块、流量分类、预留数、预留欠缺、拖欠订单、分厂库存、采购库存、待检数
缺件数量高亮显示

交互筛选

按采购组筛选
按流量分类筛选
一键重置
所有 KPI、图表、表格实时联动

完整示例

# 1. 清洗 SAP 导出的零部件采购计划表
python3 scripts/clean_data.py ~/Downloads/零部件采购计划表.xlsx -o ~/Desktop/procurement_data.json

# 2. 生成看板
python3 scripts/generate_dashboard.py ~/Desktop/procurement_data.json -o ~/Desktop/缺件分析看板.html

# 3. 用浏览器打开查看

支持的字段

清洗脚本内置 30+ 种 SAP 采购报表字段识别，包括：

| 类别 | 字段 | |------|------| | 基础信息 | 采购组、物料号、物料描述、单位 | | 库存 | 分厂库存、厂内在途库存、采购库存、待检数、冻结库存、130F库存 | | 缺件 | 预留数、预留欠缺、拖欠订单 | | 领料消耗 | 上月领料数、当月领料数、平均领料数、当月消耗数、上月消耗数、前三个月消耗数 | | 分类属性 | 仓储类型、排放标识、零部件类别、流量分类、业务板块、产品子系列 | | 其他 | 到货进度、供应商说明、通机零件标记 |

完整列表见 references/fields.md。

业务规则

详细业务定义和计算规则见 references/business_rules.md。

核心指标速览：

缺件率 = 缺件物料数 / 物料总数 × 100%
到货进度填写率 = 已填写到货进度的物料数 / 物料总数 × 100%
可用库存总量 = 分厂库存 + 厂内在途库存 + 采购库存 + 待检数

注意事项

报表格式：支持 SAP 导出的标准零部件采购计划表（Excel 格式），其他格式报表可能需要调整字段映射
表头检测：脚本自动检测表头位置，如检测不准确可使用 --header-row <行号> 手动指定（从0开始）
数据质量：确保 SAP 导出的报表数据完整、无合并单元格的数据行
大文件：超过 1 万行的报表处理速度会稍慢，但仍可正常生成看板
浏览器兼容：看板使用 ECharts 5.x，支持主流现代浏览器（Chrome、Edge、Firefox、Safari）
离线使用：看板通过 CDN 加载 ECharts，首次打开需要联网；如需完全离线，可将 echarts.min.js 下载到本地并修改引用路径