外派驻场,第一周我们一般不安排改需求。急着写点什么证明自己在干活,反而是最没用的。先做五件小事。
1. 把系统在本地跑起来
不是看文档,是照着 clone、装依赖、配环境、连测试库,真跑一遍。跑不通的地方就是文档缺的地方,当天补进 README。这一步还能顺带摸清:用的什么语言版本、几个服务、有没有定时任务。
2. 找到日志在哪
应用日志、Nginx access log、慢查询日志、定时任务的输出,各在哪台机器、哪个目录、保留几天。出事时第一件事就是翻日志,找不到日志文件,后面全靠猜。
3. 列一张账号清单
代码仓库、数据库、服务器、域名、证书、第三方接口,各有哪些账号、谁是管理员、有没有共享账号。那次列出来 3 个共享账号,两边都以为对方在管,其实没人改过密码。清单交出去当天就改了。
4. 照着部署步骤走一遍
不发版,只在预发环境把流程走通:拉哪个分支、配置在哪、怎么回滚、谁有权限。走完记下哪一步卡了、卡了多久。这比读十页部署文档管用。
5. 问清出事找谁
不是要一张通讯录,是把「哪类问题找哪个人」写清楚。数据库慢找谁、页面打不开找谁、对方接口不通找谁、客户那边谁拍板。最好连「几点以后别打电话,发消息」也问一句。
那份清单
五件事做完,通常是一份 2 页的文档加一张表。不漂亮,没架构图,也没写任何规划。
有回客户看完整份东西说,你们第一周就写了这个?是。第二周他们自己把派活方式改了,原来需求都从三个人嘴里分别来,改成统一进一个表。这变化跟我们没直接关系,是那张账号清单和「谁拍板」那一栏逼出来的。
驻场最难的不是技术,是接手一套没人说得清、但又天天在跑的东西。第一周就该用来把它说清。

