药品库存盘点分析专业工具

概述

本技能专注于医院药品库存盘点分析，将盘点数据转化为专业级管理决策报告。内置 ABC/VEN 交叉分类、周转率分析、效期三级预警、缺货风险评估、账物差异分析、金额结构分析、储存条件分析、智能补货建议八大分析维度，一键生成仪表盘式 HTML 报告。

触发条件

当用户提到以下关键词时触发：

盘点类：药品盘点、库存盘点、盘点分析、盘点报告
分类类：ABC分类、VEN分类、药品分类管理
效期类：药品效期、近效期、效期预警、效期管理
缺货类：药品缺货、缺货分析、补货建议、安全库存
周转类：库存周转、周转率、周转天数、滞销药品
差异类：账物差异、账物相符率、盘点差异
金额类：库存金额、库存结构、药品金额分析

工作流程

确定数据源——询问用户提供盘点数据CSV，或直接使用内置脱敏模拟数据
运行分析——执行 scripts/inventory_pro.py 生成 HTML 仪表盘报告
呈现报告——使用 present_files 展示生成的 HTML 报告
解读结果——根据报告中的8大分析维度，为用户解读关键发现
行动建议——结合智能建议模块，给出补货清单和近效期处置方案
深入分析——如用户需要，加载 references/inventory-analysis-guide.md 获取行业标准与管理规范

脚本调用

一键生成分析报告（使用内置模拟数据）

python scripts/inventory_pro.py --hospital "XX市人民医院"

使用用户自有数据

python scripts/inventory_pro.py --data <盘点CSV路径> --output <输出HTML路径> --hospital "XX市人民医院"

重新生成模拟数据

python scripts/generate_mock_data.py

数据格式要求

用户提供的CSV文件须包含以下字段（详见 references/inventory-analysis-guide.md）：

必需字段（缺一不可）：drug_name, specification, drug_category, unit_price, begin_qty, in_qty, out_qty, end_qty, system_qty, end_amount

增强字段（有则分析更丰富）：abc_class, ven_class, storage_condition, turnover_days, monthly_consumption, expiry_date, days_to_expiry, supplier, is_shortage, shortage_days, diff_qty

内置模拟数据

assets/mock-data/inventory_sample.csv 包含190条脱敏记录，覆盖15个药品类别：

抗菌药、心血管、消化系统、神经系统、抗肿瘤、中成药、生物制品、呼吸系统、内分泌、血液系统、解热镇痛、营养类、液体类、麻醉精神、透析类
含ABC/VEN分类、效期、缺货、差异等多维度标注
总库存金额约604万元，含20个A类品种、53个V类品种

报告输出标准

生成的 HTML 报告包含8大模块：

KPI 看板——6个核心指标卡片（品种数/总金额/缺货数/近效期数/周转天数/相符率）
ABC-VEN 分类分析——双环形图 + ABC×VEN交叉矩阵（含风险高亮）
库存周转分析——仪表盘 + 周转分布柱状图 + 滞销品种表
效期预警分析——红绿灯时间线 + 近效期明细表（按紧急度排序）
缺货风险评估——缺货品种清单 + VEN分类影响评估
账物差异分析——相符率仪表盘 + 差异明细表
金额结构分析——类别金额条形图 + 帕累托图 + TOP10品种表
智能建议——应急补货清单 + 近效期处置方案 + 综合管理建议

报告特点：纯HTML+CSS+SVG，零依赖，离线可用，打印友好，响应式布局。

参考文档

references/inventory-analysis-guide.md：ABC分类标准、VEN分类体系、周转率行业参考、效期三级预警制度、缺货安全管理、账物差异容差、盘点操作规范、数据字段说明

比赛演示建议

先用内置数据一键生成报告，展示8大分析维度的可视化效果
重点展示"智能建议"模块——补货清单和近效期处置方案是最大亮点
切换到真实数据演示，展示即开即用的实战能力
展示 ABC×VEN 交叉矩阵，体现管理思维深度