连锁门店的月底对账一直是个纯体力活。总部要看各门店的销售汇总，但报表是各店自己填的：列名有的写「门店名称」有的写「店铺」，日期有的写 2026-11-01 有的写 2026 年 11 月 1 日，金额有的按元有的按万元上报，同一张单据被重复上报、关键字段整行留空也很常见。
财务拿到几十份表只能一份份打开、手工合并，一整天做下来还容易漏算或重复算，出了问题也很难回溯是哪张表的第几行。这个工具把这一环交给程序：格式不统一的部分用配置适配，脏数据逐条列进异常表交给人判断，剩下的合并汇总全自动。
功能模块分五层。读取层自动定位表头行、兼容 xls 与 xlsx；映射层把各店不同写法的列名对应到标准字段；清洗层统一日期格式与金额单位、按「门店 + 单据号 + 金额」判重并保留首条、空值整行转异常；汇总层按门店和月份算合计与环比；导出层生成一张工作簿。
主要功能：输入一批格式混乱的 Excel，输出一张可直接交付的工作簿，含四张表 —— 运行摘要（文件数、明细行数、异常分类计数、金额合计、涉及门店、耗时）、明细、汇总（带环比与门店金额柱状图）、异常（带处置建议与类型分布图）。打不开或表头不符的文件单独记录，不中断整批处理。另附免安装 exe，客户电脑不装 Python 也能跑。
角色：独立完成全部环节 —— 需求拆解、五层架构设计、六个模块编码、单元测试与四份交付文档（使用说明、配置说明、测试记录、验收清单）。
技术栈与亮点：Python 3.12 + pandas 做数据处理，openpyxl 生成带图表的 xlsx，xlrd 兼容旧版 xls，PyInstaller 打包单文件 exe。核心设计是配置驱动，列名映射、门店别名、金额单位系数、判重键全部写在 config.json，换一家客户只改配置不改代码；配置写错时一次列出全部问题并以退出码 1 结束，不会跑到一半崩。配 42 个单元测试。实测 50 个文件 1 万行 2.47 秒完成，10 个文件混 3 个坏文件 1.17 秒且其余照常出数。
评论