PIVAS 季度盘点数据分析
Overview
将 PIVAS 季度药品盘点汇总表（xlsx）转化为格式规范的季度盘点分析报告（docx）。核心能力：稳健读取含数十万幻影空行的大 xlsx、自动识别金额列、统计盘亏盘盈分布与 Top 品种、生成含 4 张数据表格的完整分析报告。
When to Use
触发条件（满足任一即用）：
- 用户提供 PIVAS 季度盘点汇总表 xlsx，要求写盘点分析报告 / 盘点总结 / 差异分析
- 用户提及"盘点分析""季度盘点""盘亏盘盈""账实差异"并附盘点表文件
- 用户要求参照往期盘点分析报告格式撰写新一期报告
不触发：仅查询某药品库存、仅做单品种流水账核对等非季度盘点总结性任务。
Prerequisites
- Python 环境，已安装
openpyxl与python-docx - 受控 Python 解释器路径示例（Windows）：
C:\Users\86137\.workbuddy\binaries\python\envs\default\Scripts\python.exe - 若环境无依赖，先安装：
pip install openpyxl python-docx
Workflow
Step 1 — 读取并理解数据源
向用户确认或从文件识别：
1. 盘点汇总表 xlsx 路径（必填）：含"盘点汇总表"等工作表的主文件
2. 往期示例报告 docx（可选）：若用户提供，读取其结构作为格式参照；无则用本 skill 内置结构
读取 xlsx 时的关键陷阱：
- xlsx 常含数十万幻影空行（openpyxl 报 max_row=91万+），必须用 read_only=True 模式，否则内存爆炸
- "盘点汇总表"工作表通常有约 25 列，远超首次目测所见；必须读取全部列以获取"单价/结存金额/盘点金额/差异金额"等金额列
- 用连续空行（≥15行）判定实际数据区结束
Step 2 — 数据分析
运行分析脚本，输出 JSON 摘要：
<python> scripts/analyze_inventory.py "<xlsx路径>" --output "<输出json路径>"
脚本自动完成：
- 定位含"差异数"列的盘点汇总表工作表
- 按表头名称自动识别列索引（药品名称/规格/差异数/差异金额/结存金额/盘点金额/单价），适配不同季度列顺序
- 统计：总品规数、账面/实盘/差异金额、盘亏盘盈品种数与金额、盘亏率、净差异率
- 计算差异金额分布（6档）、盘亏Top15、盘盈Top10
- 统计各分区盘点表行数、财务报表总成本金额
Step 3 — 审阅分析结果，补充业务判断
读取 JSON 输出，结合 PIVAS 实际业务，审视：
- 盘亏 Top 品种是否集中在某类药（抗菌药/抗肿瘤/生物制剂）——据实归纳特点
- 盘盈是否与拆半使用、国谈药集中入库相关——据实归因
- 10000元以上差异品种数 —— 作为重点管控论述依据
若数据有明显异常（如某品种差异量异常大），在原因分析中针对性说明。
Step 4 — 生成报告
运行报告生成脚本：
<python> scripts/generate_report.py "<json路径>" "<输出docx路径>" --quarter "<季度名称>" --date "<盘点日期>"
--quarter：如"2026年第二季度"--date：如"2026年6月30日"（季度末日期）
Step 5 — 呈现与交付
用 present_files 工具将生成的 docx 呈现给用户预览。报告保存至当前项目工作区根目录。
Report Structure
报告固定结构（详见 references/report_structure.md）：
- 标题 + 前言（盘点依据、时间、方式、人员）
- 一、盘点基本情况（覆盖区域、药品类别、盘点方式、4项要点）
- 二、盘点结果汇总（汇总表 8行×4列）
- 三、差异情况分析
- （一）差异金额分布情况（6档分布表）
- （二）盘亏金额较大的品规分析（Top10表 + 特点归纳）
- （三）盘盈金额较大的品规分析（Top5表 + 原因归纳） - 四、原因分析（6条编号列表）
- 五、改进措施（六小节）
- 落款（静脉用药调配中心 + 日期）
Key Indicators
| 指标 | 计算 |
|---|---|
| 差异数 | 盘点数 − 结存数 |
| 差异金额 | 盘点金额 − 结存金额 |
| 盘亏率 | |盘亏金额| ÷ 账面结存金额 |
| 净差异率 | 净差异金额 ÷ 账面结存金额 |
Notes
- 报告以 PIVAS 科室主任视角撰写，行文符合医院药品盘点管理制度与《静脉用药集中调配质量管理规范》
- 若汇总表无往期对比数据（领入/消耗/应结存等流转金额），则以"本季度差异深度分析"替代环比对比表，差异追溯更细
- 若用户提供往期盘点汇总表，可扩展脚本增加环比/同比对比表
- 脚本按表头名称定位列，兼容不同季度列顺序变化；但若表头命名差异较大，需人工核对
columns_detected字段
