PIVAS 季度盘点数据分析

Overview

将 PIVAS 季度药品盘点汇总表（xlsx）转化为格式规范的季度盘点分析报告（docx）。核心能力：稳健读取含数十万幻影空行的大 xlsx、自动识别金额列、统计盘亏盘盈分布与 Top 品种、生成含 4 张数据表格的完整分析报告。

触发条件（满足任一即用）：

不触发：仅查询某药品库存、仅做单品种流水账核对等非季度盘点总结性任务。

Python 环境，已安装 openpyxl 与 python-docx
受控 Python 解释器路径示例（Windows）：C:\Users\86137\.workbuddy\binaries\python\envs\default\Scripts\python.exe
若环境无依赖，先安装：pip install openpyxl python-docx

向用户确认或从文件识别：

读取 xlsx 时的关键陷阱：

运行分析脚本，输出 JSON 摘要：

<python> scripts/analyze_inventory.py "<xlsx路径>" --output "<输出json路径>"

脚本自动完成：

读取 JSON 输出，结合 PIVAS 实际业务，审视：

若数据有明显异常（如某品种差异量异常大），在原因分析中针对性说明。

运行报告生成脚本：

<python> scripts/generate_report.py "<json路径>" "<输出docx路径>" --quarter "<季度名称>" --date "<盘点日期>"

用 present_files 工具将生成的 docx 呈现给用户预览。报告保存至当前项目工作区根目录。

报告固定结构（详见 references/report_structure.md）：

标题 + 前言（盘点依据、时间、方式、人员）
一、盘点基本情况（覆盖区域、药品类别、盘点方式、4项要点）
二、盘点结果汇总（汇总表 8行×4列）
三、差异情况分析
- （一）差异金额分布情况（6档分布表）
- （二）盘亏金额较大的品规分析（Top10表 + 特点归纳）
- （三）盘盈金额较大的品规分析（Top5表 + 原因归纳）
四、原因分析（6条编号列表）
五、改进措施（六小节）
落款（静脉用药调配中心 + 日期）

| 指标 | 计算 | |------|------| | 差异数 | 盘点数 − 结存数 | | 差异金额 | 盘点金额 − 结存金额 | | 盘亏率 | |盘亏金额| ÷ 账面结存金额 | | 净差异率 | 净差异金额 ÷ 账面结存金额 |