药品库存盘点分析专业工具
概述
本技能专注于医院药品库存盘点分析，将盘点数据转化为专业级管理决策报告。内置 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 交叉矩阵，体现管理思维深度
