2026/11/14 2:17:36

接手一套跑了五年的政务门户,先做了三张交接表

接手一套跑了五年的政务门户,先做了三张交接表
11 月 13 日,两条新闻刷在一起:一条讲腾讯二十八岁这一年的组织调整,一条讲英伟达员工请愿让创始人复职。人事上的事我们管不着,但作为做外包和维护的人,我对“人一走、代码没人接”这件事特别敏感。 上个月我们刚接了一套跑了五年的政务门户,原团队解散,甲方手上只剩一个压缩包和三句口头说明。这篇记一下我们是怎么接的,以及那三张交接表。 ![接手一套跑了五年的政务门户,先做了三张交接表](/uploads/agent/out/2/img-20261114021724.png) ## 一、刚接手时的状态 具体一点: - 代码库只有一个分支,最后一次提交是八个月前; - 服务器上的配置文件与仓库里的对不上,生产库连接串是直接改在机器上的; - 有七个定时任务,其中三个的代码在仓库里根本找不到; - 域名证书还有三十一天到期,没人知道续期账号是谁的; - 数据库备份每天在跑,但从来没人做过恢复验证。 最后一条最让我不安。备份能跑不代表能恢复,这是两件事。 ## 二、第一张表:系统资产表 不是写文档,是先把“东西在哪”弄清楚。每一行一个资源,字段就六个:类型、地址、用途、账号归属、责任人、到期时间。 扫下来发现: - 四个域名,其中一个指向的服务器已经下线半年; - 两个云账号,一个用个人手机号注册,验证码在离职同事手里; - 一个短信通道的密钥写在代码里,每月还在扣费; - 一个对外接口的授权码早过期,但因为没人调用,一直没发现。 这张表总共四十二行,花了两天。价值在后面两个月里不断体现:证书到期前一周自动提醒、停掉了一个每月白花钱的短信套餐、把云账号主体变更成了单位。 ## 三、第二张表:数据与任务表 这张表回答的是“什么东西在自动跑”。 我们把服务器上所有 cron、计划任务、消息队列消费者列出来,逐个对应到代码。一共十九个,对上了十二个,剩下七个: - 三个是从仓库里删掉但机器上没清理的旧任务; - 两个是运维手写的脚本,存在某个人的家目录里; - 一个是从正式库往报表库同步数据的作业; - 最后一个最离谱:每天凌晨两点把某个目录的文件传到另一台机器,没人知道是干什么的。 我们先全部改成只记录不执行,观察一周。结果那个“不知道干什么的”任务停掉后,第四天有市民反馈查不到办件进度。原来它负责同步一个结果文件。 这就是交接里最难的部分:没人知道的东西,往往是最关键的。 ## 四、第三张表:运维口径表 这张表写的是“出事时怎么办”,而不是“系统怎么设计的”。 内容包括: - 部署步骤(其实是手动传文件 + 重启服务,我把它写成脚本并备份了旧版本); - 回滚方式(原来没有,现在保留最近三个版本的包); - 备份策略和一次真实的恢复演练记录; - 常见故障的处理办法,比如磁盘满了、证书过期、任务卡死; - 告警联系人,以及甲方内部谁知道业务规则。 恢复演练是甲方最在意的一项。我们拿测试环境完整恢复了一次生产备份,发现备份文件里漏了两个表,原因是备份脚本写了排除参数。如果不演练,这个问题要到真出事那天才会暴露。 ## 五、两周之后的收获 摸清系统花了两周,交付了四十多页文档。真正的回报在后面: - 上线第三周,证书到期告警自动发出,提前续了; - 第五周报表库同步任务挂了,我们看日志十分钟定位到磁盘满,而不是像以前那样重启了事; - 甲方后续要做等保整改,直接拿这三张表当底稿,省了一大块调研时间。 ## 六、代价与建议 说点实话: - 交接期间基本不产生新功能,甲方会觉得“你们什么都没做”,需要提前沟通好预期; - 有些东西靠看代码是摸不出来的,必须找到原来对接的业务人员聊,这比读代码慢得多; - 文档写完没人维护会迅速过期,我们把三张表放进了每月的运维例会议程。 如果你也要接手一套老系统,我的建议很简单:先别急着改代码,先把“东西在哪、什么在跑、出事怎么办”这三件事写下来。写不出来的部分,就是风险所在。 ## 最后 系统交接的验收标准,不是双方签了字,而是新人能不能在凌晨两点被叫起来、看着文档把问题处理完。 我们后来在合同里加了一条:交接完成后,原团队必须配合一次真实的故障演练。签得再漂亮,不如跑一次。