存货报告

这个技能解决什么问题

企业每月的进销存报表，通常靠财务人员手工翻阅发票清单，把进项、销项分别录入台账，再逐项核对数量、金额与税率，最后汇总期末库存。这个过程重复且容易出错：服务类、费用类发票混在采购数据里，需要人工判断哪些应纳入库存核算；红字发票（退货、折让）的负向冲销也常被遗漏或方向搞反。

技能如何工作

数据读取与过滤：通过 --jin（进项发票）和 --xiao（销项发票）传入 Excel，要求 Sheet 名为「信息汇总表」，列结构固定。load_invoice_data() 负责读取并过滤服务、费用类非库存商品；是否正数发票 = "否" 的行按红字发票处理，数量与金额取负后直接参与计算。

进销存计算：calculate_inventory() 按公式逐项核算——期末库存 = 期初 + 本期进货 − 本期销售，数量与金额分开计算，且不含增值税。提供了 --begin 期初库存文件则从该余额起算，否则默认从 0 开始。

多维度分析与双报表输出：analyze_inventory() 按商品品类、时间、供应商、客户四个维度汇总，并计算库存周转率与毛利率；generate_detail_report() 输出库存明细账（含变动明细、品类汇总），generate_analysis_report() 输出分析报表（含结构分析、毛利分析、库存预警台账）。两张报表均为 Excel，命名带上 --company 与 --period。

适用边界与注意点

• 成本计算目前只实现一套公式，加权平均、先进先出等方法在规划中，尚未提供。
• 核心脚本 generate_inventory_report.py 仍处规划阶段，需先开发才能跑通命令行路径。
• 非库存商品的过滤关键词列表要按企业实际品类维护，否则服务类发票会混入库存。
• 未提供期初库存时默认从 0 起算，首期报表的期初数会失真。