CASE 01 · 已生产运行

采购 / 物流对账系统

阶段:生产运行 · 规模:5 个海外站点 / 70+ 家供应商 · 技术:Python FastAPI + MySQL

本文中的客户、供应商、站点与内部编号均已脱敏。

01场景

多个海外站点的销售数据,要对上不同供应商和货代的账单。原来靠 Excel 人肉对账——口径不统一,更正不留痕,同一个问题每次重算都可能得到不同答案。

02我重新定义的问题

真正的问题不是「算得慢」,是算错了没人能追溯、口径靠人记。
所以设计目标不是提速,而是让每一个数字都可解释、可核对、可追责。

03我做的

  • 三层架构:原始层保真 → 分析层可解释 → 结果层只出结论。原始层不做任何清洗动作,保证追溯时能拿回最初的东西。
  • 更正不覆盖原值:更正写在「xx-更正后」列,派生列自动重算并标黄,原始值永不被改写。这条是我给这套系统的地基。
  • 唯一推进入口:把「上传原始文件」定为任务状态机的唯一入口,防止有人跳状态提交半套数据。
  • 导出表头按供应商记忆成配置:不用每次手工调表头,改一次配置就生效。
  • 结果永久落库:对账结果永久留库,操作留痕到人。

04结果

30%
相对此前的本地 Excel 程序,实际提效
5 分钟 → 1 分钟
单张采购单的差异定位时间
5 个 / 70+
覆盖的站点数与供应商数

05技术

Python FastAPIMySQL 8.412 张表pytestGit生产 / 测试双环境定时备份

06边界与诚实说明

这套系统的价值在于「让错误变得可见」,不在于「让人不用看」。
它要求上传方的原始文件本身是准的——如果源头录错,系统只能更早地暴露它,不能替它修正。
另外它是我在上一段工作里交付并上线运行的系统,我把它写在这里是因为它代表了我对「可追溯」这件事的标准。