跳到正文
全部文章

工程3 分钟

走一步看十步

One step, ten steps ahead

第一版销售小工具的数据格式是随手定的。三个月后做数据迁移,我在电脑前坐了两个晚上,才明白这句话到底什么意思。

10 月 25 号晚上,我在改自己那个销售小工具。

这个工具最开始是个玩具。一个 CSV 文件存客户主数据,一个脚本按地区把名单拉出来,再加一个定时任务去抓公开的线索。数据量小的时候,什么都能凑合。

后来往上加的东西越来越多:AI 线索收集、自动跟进、通话记录归档。加着加着复杂度就上来了,原来的结构撑不住。这个月我决定做第一轮重构。

重构怎么分

分四层。

最外面是 CLI 接口层,命令行里敲什么,参数怎么传,输出成什么格式。

底下是工作流层,把“找线索—筛客户—写跟进—记录”这几步串起来,每一步可以单独跑,也可以连起来跑。

再底下是数据层,客户主数据从 CSV 迁到 SQLite,同时保留一份 CSV 镜像,方便我用 Excel 看。

最后是调度层,什么时候跑、失败了重试几次、日志写在哪。

顺手还留了一个 Interface 层,准备以后接 TUI 或者网页界面。现在还没写,只是把口子留出来。

分层这件事本身不难,难的是分完之后每一层的数据怎么对上。分层的代价是多写很多接口定义,一开始觉得啰嗦,真到改存储的时候才觉得值。

真正卡住的地方

不是分层,是数据。

第一版是随手写的,几份 CSV 里的字段不统一。同一个东西,这张表里叫 customer,那张表里叫 client;日期有的写 2026/9/1,有的写 2026-09-01;电话号码带不带区号混着来。

我当时觉得无所谓,反正就几十条数据,写个脚本转一下完事。

真到迁移的时候,看着几百条脏数据,我坐在电脑前两个晚上没动。让 AI 写迁移脚本,脚本能生成,但每张表都要单独看一遍,字段对不上还得改。星期四晚上迁到一半,发现主键重复,同一条客户记录导进去了两次,只能全部回滚重来。

回滚的时候我盯着屏幕想,这活儿要是第一版就规范,大概一个小时能搞完。

走一步看十步

这件事让我重新理解了“走一步看十步”。

以前我以为这句话的意思是,一开始就把未来十步规划清楚。做不到。我根本不知道三个月后的需求是什么。当时连“客户主数据”这个概念都没想清楚,只觉得是个 CSV。

现在我的理解是:不用把路全规划好,但要尽量让当下做的事规范、有条理,提前准备将来可能要复用的东西。

具体到那个玩具模型,就是一开始把字段名定死,日期统一用 ISO 格式,电话统一带区号,再加一列主键。多花半天,后面省两个晚上。

短期看效率甚至更低——定字段、写 schema 的时间,本来可以直接拿去加功能。长期看不一定,得等真的需要复用的那天才知道。

我忘了在哪看过张一鸣说过延迟满足,说他很年轻的时候就想明白了这件事。我看完没什么感觉,直到自己坐那两个晚上。

现在做的事怎么“看十步”

我现在会做三件很小的事。

写新脚本之前,先花十分钟想一遍数据从哪里来、到哪里去、中间会不会被别人用。想不完全正常,但想一遍和不想,差别很大。

字段命名先统一。中文名、拼音、英文混着用,短期看着都懂,长期一定出事。

给每个模块留一个出口。比如数据层只暴露几个函数,别的地方不能直接读 CSV。这样以后换存储,只改一个地方。

听起来像软件工程课本上的话。但我是被自己的数据坑了才真的当回事。

迁移其实分五步

现在回头看,数据迁移大概分五步:导出旧数据、清洗字段、写映射表、导入新库、抽样核对。

前两步最花时间。清洗不是写个脚本就完了,很多字段要看一眼才知道该怎么归。映射表是我手动写的,二十几个字段对了两小时。

导入反而快。抽样核对也快,抽二十条,能对上就过。

耗时最多的是我一开始没想到的“造测试数据”。为了验证迁移脚本,我造了三十条假客户,覆盖各种脏格式。这三十条让后面省了很多事。

会不会是过度设计

有时候我也怀疑,一个自己用的小工具,搞四层结构是不是有病。

后来想了一下,这次重构不是为了“架构好看”,是因为我要加的东西已经加不进去了。再加一个客户端,原来的结构就要崩。

如果这个工具一直只有我一个人用、永远不加新功能,那确实没必要分层。但它现在要接第二个客户端、要给别人用,分层才变得划算。

工具的价值取决于它要扛多少东西,不是取决于它有多少层。

还没做完的部分

重构本身也没做完。智联客户端还没补,网页界面没写,接口层只留了个空壳。

数据迁完了,跑通了一次全流程,勉强能算第一阶段完成。

第一版的数据格式现在回头看,很蠢。但让我回到三个月前,我大概还是会那么写——那时候不知道后面要接什么。

能做的只是下一次写玩具模型的时候,先花半小时把字段定下来。

也可能过一阵子又忘了。忘了就再来一次。说到底这些习惯不是一次想明白的,是被自己的数据坑一次,长一点记性。