销售明细多表合并与自动汇总工具产品系统Vibe Coding

零售与批发类企业每月从 ERP 或进销存系统导出销售明细，按月份、按门店拆成多个 Excel 文件。财务与运营需要先把这些文件合并、去重、核对金额，再做汇总，纯手工操作一份报表两小时起步，且容易出现漏行、重复计数、日期格式不统一等问题。本工具面向这类企业的月度对账与经营分析场景，把多文件合并、数据清洗、分类汇总固化成一条可重复执行的流程，保证每次取数口径一致，减少人工核对成本。

工具由四个模块组成：一、批量读取，扫描指定目录下全部 xlsx 文件，自动跳过 Excel 临时文件；二、数据清洗，文本去首尾空格、日期统一为 yyyy-mm-dd、数量与单价转为数值、异常行自动剔除；三、自动去重，按订单号保留首次记录，并写入来源文件字段便于追溯；四、报表生成，输出清洗后明细、按地区、按品类、按月趋势、按业务员五张工作表，内置柱状图，表头冻结、列宽自适应、金额千分位显示。全程一条命令完成，也可配合 Windows 计划任务每日自动运行。

我负责任务拆解、脚本编写与测试，技术栈为 Python + pandas + openpyxl。pandas 负责多文件合并、类型转换与分组聚合，openpyxl 负责工作表样式、数字格式、冻结窗格与原生图表。实现上有两个设计要点：一是把“清洗规则”和“业务口径”解耦，清洗函数只做格式规范化，汇总函数只做聚合，客户想换统计口径时不必改动清洗逻辑；二是提供 --demo 参数自动生成模拟数据，在没有真实数据的情况下也能演示和回归测试。