第4章 交接与餐桌（1/2）

请关闭浏览器的阅读/畅读/小说模式并且关闭广告屏蔽过滤功能，避免出现内容无法显示或者段落错乱。

周一早上，孙姐在群里发了份文档，把联合开发的项目安排说清楚了。对方是一家叫华信软件的传统企业服务公司，做政务系统出身，最近接了智慧园区项目，把其中的用户移动端分包给了蔚蓝科技。华信负责后端接口和部分核心业务逻辑，蔚蓝负责前端和用户体验。两边需要在两周内完成接口联调和技术方案的统一。

沈瑶看了文档之后给吉彤发了一条私信：下午两点去华信开第一次对接会，咱俩一起去。带个本子就行。

吉彤回了个，然后翻出华信那边发来的接口文档预览。他扫了几页，眉头渐渐皱起来。

文档是Word格式，排版粗糙，没有数据字典，没有异常码定义，每个接口的返回字段返回用户当前状态，没列状态码清单。另一个涉及权限的接口，返回值类型标注为object，具体结构什么样完全没有说明。

他给沈瑶发消息：他们的文档有点粗糙啊，很多字段没有明确定义。

沈瑶回了个无奈的表情：看到了吧。孙姐上周说的习惯就好，指的就是这个。华信那边做开发的大概率全是男的，技术老员工居多，文档习惯就这样。咱们下午去主要是把接口契约对齐，每一字段当场问清楚，回来我们自己补文档。

下午一点四十五分，吉彤和沈瑶打车去了华信软件的办公楼。那是一栋九十年代风格的老写字楼，电梯间铺着米黄色瓷砖，楼层指示灯是红色的LED数字。九楼走廊的灯管有一根在闪，像某种不稳定的信号。

会议室的门虚掩着，里面传来男人的说话声。沈瑶敲了两下门推门进去，吉彤跟在她身后。

会议室里坐了四个人，全是男性。最靠近投影幕的是一个头发微秃的中年男人，穿着皱巴巴的深蓝Polo衫，面前的笔记本电脑边缘贴着两枚褪色的企业贴纸。他旁边坐了两个年轻些的，一个戴黑框眼镜，一个低头刷手机。靠门口还坐着一个西装革履的，看起来像是项目经理，面前摊着一份打印好的议程表。

蔚蓝科技的沈瑶是吧？穿Polo衫的站起来伸手，我姓刘，华信技术部负责后端架构的。这位是小张和小王，接口开发的。那边是陈经理，项目统筹。

沈瑶一一握了手，然后侧身介绍吉彤：这是我们前端开发吉彤，负责这次联调的主要对接。

吉彤跟几个人依次握了手。刘师傅的手掌很厚，握得用力，嘴里说了句年轻小伙子啊，不错。西装陈经理则只是点了点头，目光在吉彤身上停了一下，又落回议程表上。

会议开始的前二十分钟还算顺利。刘师傅打开一份PPT，大致讲了后端的整体设计和各模块的职责划分。他的语速很快，偶尔夹杂一些缩写词——B端这边咱们用RBAC控权，统一走JWT，refresh机制你们前端配合一下。吉彤一边记一边在心里补全这些术语的含义。

沈瑶坐在吉彤旁边，偶尔在笔记本上画几笔，没有打断刘师傅的讲述。

转折出现在接口细节讨论环节。沈瑶翻开自己打印的接口清单，指着一个用户信息查询的接口问：刘师傅，这个接口的返回字段里，角色列表这一项的具体结构是什么样的？文档里只写了，没有说明每个对象的键名和类型。

刘师傅愣了一下，转头看向旁边的小张：这个接口谁写的？

小张推了推黑框眼镜：我写的。角色列表那边就是个普通的对象数组，键名就id和na。

有嵌套吗？角色如果有子权限呢？

没有，暂时没做那么复杂。

沈瑶记下来，又问：那错误码这边呢？文档里没有列出各个错误码对应的含义，前端这边需要根据错误码给用户做提示，缺了这个到时候联调的时候可能要来回确认。

刘师傅表情微微僵了一下。他旁边刷手机的小王抬起头来，语气有点不耐烦：错误码到时候接口调试阶段自然会调通的，前端自己看日志不就行了？

沈瑶不慌不忙：因为移动端用户场景不一样，如果接口返回错误码，我们需要把用户能看懂的中文提示映射上去。比如token过期权限不足在界面上的反馈是两种完全不同的呈现方式，提前定好可以省掉后面的返工。

小王张了张嘴，似乎想说什么，被刘师傅抬手拦住了：行，回头我把错误码表补充一版给你们。

吉彤坐在旁边没有说话，但他注意到刘师傅补充完回头补之后，并没有在电脑上做任何标记。他想起孙姐之前说过的那句沟通清楚再动手，返工反而少，又看了看华信这边桌面上那份只写了接口路径和字段名的Word文档，忽然觉得这句话的分量不只是说说而已。

会议进行到后半程时，吉彤开口了。他问的是验证码发送接口的限流策略——如果同一手机号短时间内多次请求验证码，后端怎么处理。刘师傅说限流我们做了，每分钟三次，吉彤追问超过限流之后接口返回什么状态码，前端好做防抖提示，刘师傅迟疑了两秒，说这个我们再看一下。

沈瑶侧头看了吉彤一眼，嘴角微微向上弯了一下。

会议最终在两个半小时后结束。刘师傅合上电脑时用力搓了把脸：行，今天就到这儿。接口清单上的疑问你们整理一下发邮件给小张，我们逐条回复。

走出华信办公楼的时候，沈瑶长长舒了一口气：每次来都这样。

什么？

本章未完，点击下一页继续阅读。