网站建设文章,电子商务网站模块,电子商务网站开发开发背景,郑州网站改版公司在工作中#xff0c;有时会有对接其他部门系统的需求#xff0c;这种需求虽然不复杂#xff0c;但是跨部门协作#xff0c;往往会出现各种难以沟通、协调的情况。 踩的坑多了#xff0c;就记录下来。
注意#xff1a;在本文中#xff0c;A系统调用B系统#xff0c;A依…在工作中有时会有对接其他部门系统的需求这种需求虽然不复杂但是跨部门协作往往会出现各种难以沟通、协调的情况。 踩的坑多了就记录下来。
注意在本文中A系统调用B系统A依赖B称B系统为下游系统A系统为上游系统。 不同团队有不同的叫法可能上下游还是相反的叫法。没有绝对的正确。
一、系统之间不要盲目对接
系统之间对接时最好不要盲目从中间系统接数据。 上游系统最好从生成数据的最下游系统去接数据不要从中间系统去拿这些数据。 中间系统往往会对数据进行加工如果上游系统出现问题要排查非常困难很难弄清到底是下游系统出问题还是中间系统出问题。
明确数据中心
核心数据最好只存在一个系统其他系统去查询/调用。 如果数据分散在多个系统数据同步/数据一致性数据会很混乱很容易出问题。
二、提前商量好系统对接的环境
不一定所有的系统都会有灰度环境也不是所有的系统都能在测试环境模拟真实数据。 有些比较奇葩的系统甚至测试环境是没数据的直接在灰度环境测试。 因此提前商量好对接的环境挺重要的。
三、商量好系统对接的方式
是http接口还是MQ消息队列还是通过大数据平台的Hive、ETL对接等。
四、必须排期 什么时候开始排期? 开完需求会议之后的一两天。 排期包括 下游系统什么时候给上游系统接口文档、参数定义或者MQ集群、消息主题或者表结构、数据类型等设计细节。 上下游系统什么时候在测试环境进行对接联调。 下游系统什么时候上线功能。上游系统什么时候上线功能。 上游系统的后端什么时候给前端接口文档。什么时候前后端联调。 上下游系统什么时候在灰度/生产环境进行对接。 排期最好宽松些。留一些buffer。往往沟通、开会、验收都会浪费很多时间。
总的流程如下(具体流程根据项目情况灵活调整)
日期\流程下游出接口文档上游后端出接口文档下游转测上下游后端联调下游上线上游前后端对接上游转测上游发布评审上游上线日期1日期2……………………
五、下游系统要注意什么
下游有变动及时通知上游
作为下游系统不能直接变更系统对接的接口url、参数、字段类型或者是集群ip消息主题等信息。 在变更之前必须及时通知上游系统并商议好是否变更如果确定变更给出变更日期。
下游系统最好能提供普通性适用性强的数据
一个下游系统可能对接五六个上游系统。 如果针对每个上游系统都做定制化那开发成本和维护成本会很高。
六、上游系统要注意什么
上游系统最好直接拿最终的结果
透传最好。数据从下游系统传输给上游系统上游系统最好能直接拿到最终的结果。 如果上游系统还需要对数据进行加工会增加出错的概率。
上游系统得做兜底
作为上游系统永远都不知道下游系统会传什么样的数据过来。 可能之前约定好了某个字段是数字类型下游系统莫名奇妙就发个英文字母或者日期过来。 因此上游系统得兜底做好异常处理处理掉异常数据、脏数据。
可以让下游系统给demo示例
曾经对接过某个系统给出的接口调不通明明都是按照文档上的来怎么都调不通。 最后要求下游系统给出相关的demo示例。才发现文档是旧的跟实际不相符。
推进测试及时介入
如果下游系统的测试同事没有及时界入那么上游的开发就会变成下游的测试。就会非常痛苦。 可以及时询问下游系统是否转测是否开始测试测试进度如何。
上游验收要及时
验收的时候不要私聊要在群里反馈问题让领导们看到验收的结果避免反复验收。
上游必须让下游研发参与发版
上游系统在发版当天必须做发布评审准备好下游同事的联系方式。 提前通知下游同事让下游同事当天一起参与发版 否则发版当天出现下游问题没法解决。
七、其他
信息要全员同步
最好拉一个群把所有相关人员都拉上。不要只通知其他一人忽略了其他人。
记录对接的系统及联系人
如果一个系统对接了多个系统最好记录下对接的系统及联系人。 如果系统的数据比较复杂也最好把各个功能模块的数据源记录下来防止人员变动后无法接手。
及时跟进
如果系统对接方没有在对应日期给出设计或者是功能没有在承诺的日期上线。 要及时去跟进去了解原因看到底是在哪个环节阻塞了。 先发消息紧急的就打电话电话打不通就直接现场找人当面沟通。
重要的功能必须打日志
打印日志出现问题方便排查。 哪怕不是己方系统的问题也能把日志相关的参数、时间等重要信息发给系统对接方查看问题。
工作要留痕
对接其他系统最好双方都发邮件留痕。后续出现问题才能弄清楚到底是哪个系统在哪些环节出现问题。 对接的系统甩锅时我方系统还能留有证据。
汇报进度
如果是特别特别重要的功能可以每天/每周进行汇报。 跟上级领导汇报系统对接的进度。 跟对接系统的负责人沟通进度。
系统调用出错
对接第三方系统。如果有问题找人解决要提供问题的环境、url 接口、参数等等。
对方不回复怎么办
直接大群 人再不回就 负责人和领导再不行就直接岗位找人不要阻塞着。
解决问题
系统对接方出现问题如果对方迟迟解决不了那就得升级问题。 可以让对方系统的高级开发去帮忙解决。 实在没有人力也可以自己去解决。 曾经在对接一个系统时对方有个bug一直解决不了直接让他共享屏幕两个人一起定位解决了。 再不行就跟双方领导汇报让领导找人给资源。
系统对接不顺利怎么办
平复情绪好好谈好好复盘不要生气气坏了身子没人替。
