门店回款明细生成工具

解决的问题

生鲜配送或商超订单处理场景中，一份《果蔬鲜订单》Excel 往往混杂着多家门店、多个商品、多天日期的数据。财务或运营人员需要从中拆出每家门店的回款情况：预付款是多少、实际货款多少、超发要补款还是少发要退款，还要按门店分别出表并套用统一的格式与公式。手工复制粘贴、逐店调格式不仅容易出错，而且一旦源数据更新就得重来。

技能如何工作

这个技能把上述流程脚本化。触发条件很简单：用户引用一个《果蔬鲜订单地区X月X日.xlsx》文件并要求生成回款明细。技能内部执行以下步骤：

• 读取源文件的绝对路径；
• 调用 scripts/gen_store_detail.py，通过命令行参数传入源路径与可选输出目录；
• 校验输出文件的关键结构，包括 Sheet 数量、指定门店差异化、公式与格式是否正确写入；
• 将生成好的《门店回款明细地区X月X日.xlsx》呈现给用户。

输出文件遵循一套固定规则：

• 每门店一个 Sheet，Sheet 名即门店名称，按门店名开头数字升序排列；
• 前 3 行固定为标题、合计与表头，冻结 A4；
• 第 1 行合并 A1:O1 显示门店名，第 2 行在 I2/J2/K2/L2/M2/O2 写入 SUM 公式，第 3 行为 15 列蓝底白字表头；
• 第 4 行起按日期→商品名排序写入数据，公式列覆盖预付款 =E*F、实际货款 =F*G、货款差异 =(G-E)*F 等逻辑；
• 11 家指定门店有差异化处理：隐藏 H/J/K/L 四列，I2 使用 INT(SUM()) 抹零，数字格式为 0。

适用边界与注意点

• 源文件命名需符合《果蔬鲜订单地区X月X日.xlsx》约定，日期取数据中占比最高的日期，地区取源文件名标识；
• 依赖 openpyxl 和 pandas，需提前装到当前 Python 环境；
• G 列可能为空表示未发货，此时 I=F*0=0；
• 源值超过 2 位小数时，写入单元格前先四舍五入；
• 指定门店名单变更时，需要同步更新脚本中的 DESIGNATED_STORES 列表与 SKILL.md。