上下游系统对接的沟通与协作

2023-11-08 05:44

本文主要是介绍上下游系统对接的沟通与协作,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

在工作中,有时会有对接其他部门系统的需求,这种需求虽然不复杂,但是跨部门协作,往往会出现各种难以沟通、协调的情况。
踩的坑多了,就记录下来。

注意:在本文中,A系统调用B系统,A依赖B,称B系统为下游系统,A系统为上游系统。
不同团队有不同的叫法,可能上下游还是相反的叫法。没有绝对的正确。

一、系统之间不要盲目对接

系统之间对接时,最好不要盲目从中间系统接数据。
上游系统,最好从生成数据的最下游系统去接数据,不要从中间系统去拿这些数据。
中间系统往往会对数据进行加工,如果上游系统出现问题要排查非常困难,很难弄清到底是下游系统出问题,还是中间系统出问题。

明确数据中心

核心数据最好只存在一个系统,其他系统去查询/调用。
如果数据分散在多个系统,数据同步/数据一致性,数据会很混乱,很容易出问题。

二、提前商量好系统对接的环境

不一定所有的系统都会有灰度环境,也不是所有的系统都能在测试环境模拟真实数据。
有些比较奇葩的系统,甚至测试环境是没数据的,直接在灰度环境测试。
因此,提前商量好对接的环境挺重要的。

三、商量好系统对接的方式

是http接口,还是MQ消息队列,还是通过大数据平台的Hive、ETL对接等。

四、必须排期

  • 什么时候开始排期?
    开完需求会议之后的一两天。

  • 排期包括:
    下游系统什么时候给上游系统,接口文档、参数定义,或者MQ集群、消息主题,或者表结构、数据类型等设计细节。
    上下游系统什么时候在测试环境进行对接,联调。
    下游系统什么时候上线功能。上游系统什么时候上线功能。
    上游系统的后端什么时候给前端接口文档。什么时候前后端联调。
    上下游系统什么时候在灰度/生产环境进行对接。
    排期最好宽松些。留一些buffer。往往沟通、开会、验收,都会浪费很多时间。

总的流程如下(具体流程根据项目情况灵活调整):

日期\流程下游出接口文档上游后端出接口文档下游转测上下游后端联调下游上线上游前后端对接上游转测上游发布评审上游上线
日期1日期2

五、下游系统要注意什么?

下游有变动,及时通知上游

作为下游系统,不能直接变更系统对接的接口url、参数、字段类型,或者是集群ip,消息主题等信息。
在变更之前,必须及时通知上游系统,并商议好是否变更,如果确定变更,给出变更日期。

下游系统,最好能提供普通性适用性强的数据

一个下游系统,可能对接五六个上游系统。
如果针对每个上游系统,都做定制化,那开发成本和维护成本会很高。

六、上游系统要注意什么?

上游系统最好直接拿最终的结果

透传最好。数据从下游系统传输给上游系统,上游系统最好能直接拿到最终的结果。
如果上游系统,还需要对数据进行加工,会增加出错的概率。

上游系统得做兜底

作为上游系统,永远都不知道下游系统会传什么样的数据过来。
可能之前约定好了某个字段是数字类型,下游系统莫名奇妙就发个英文字母或者日期过来。
因此,上游系统得兜底,做好异常处理,处理掉异常数据、脏数据。

可以让下游系统给demo示例

曾经对接过某个系统,给出的接口调不通,明明都是按照文档上的来,怎么都调不通。
最后要求下游系统给出相关的demo示例。才发现文档是旧的,跟实际不相符。

推进测试及时介入

如果下游系统的测试同事没有及时界入,那么上游的开发就会变成下游的测试。就会非常痛苦。
可以及时询问下游系统是否转测,是否开始测试,测试进度如何。

上游验收要及时

验收的时候,不要私聊,要在群里反馈问题,让领导们看到验收的结果,避免反复验收。

上游必须让下游研发参与发版

上游系统在发版当天,必须做发布评审,准备好下游同事的联系方式。
提前通知下游同事,让下游同事当天一起参与发版!!
否则发版当天,出现下游问题,没法解决。

七、其他

信息要全员同步

最好拉一个群,把所有相关人员都拉上。不要只通知其他一人,忽略了其他人。

记录对接的系统及联系人

如果一个系统对接了多个系统,最好记录下对接的系统及联系人。
如果系统的数据比较复杂,也最好把各个功能模块的数据源记录下来,防止人员变动后无法接手。

及时跟进

如果系统对接方没有在对应日期给出设计,或者是功能没有在承诺的日期上线。
要及时去跟进,去了解原因,看到底是在哪个环节阻塞了。
先发消息,紧急的就打电话,电话打不通就直接现场找人,当面沟通。

重要的功能必须打日志

打印日志,出现问题,方便排查。
哪怕不是己方系统的问题,也能把日志相关的参数、时间等重要信息发给系统对接方查看问题。

工作要留痕

对接其他系统,最好双方都发邮件留痕。后续出现问题,才能弄清楚到底是哪个系统,在哪些环节出现问题。
对接的系统甩锅时,我方系统还能留有证据。

汇报进度

如果是特别特别重要的功能,可以每天/每周进行汇报。
跟上级领导汇报系统对接的进度。
跟对接系统的负责人沟通进度。

系统调用出错

对接第三方系统。如果有问题,找人解决,要提供问题的环境、url 接口、参数等等。

对方不回复,怎么办?

直接大群 @人,再不回就 @ 负责人和领导,再不行就直接岗位找人,不要阻塞着。

解决问题

系统对接方出现问题,如果对方迟迟解决不了,那就得升级问题。
可以让对方系统的高级开发去帮忙解决。
实在没有人力,也可以自己去解决。
曾经在对接一个系统时,对方有个bug一直解决不了,直接让他共享屏幕,两个人一起定位解决了。
再不行就跟双方领导汇报,让领导找人,给资源。

系统对接,不顺利怎么办?

平复情绪,好好谈,好好复盘,不要生气,气坏了身子没人替。

这篇关于上下游系统对接的沟通与协作的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/368127

相关文章

Python FastAPI+Celery+RabbitMQ实现分布式图片水印处理系统

《PythonFastAPI+Celery+RabbitMQ实现分布式图片水印处理系统》这篇文章主要为大家详细介绍了PythonFastAPI如何结合Celery以及RabbitMQ实现简单的分布式... 实现思路FastAPI 服务器Celery 任务队列RabbitMQ 作为消息代理定时任务处理完整

Linux系统中卸载与安装JDK的详细教程

《Linux系统中卸载与安装JDK的详细教程》本文详细介绍了如何在Linux系统中通过Xshell和Xftp工具连接与传输文件,然后进行JDK的安装与卸载,安装步骤包括连接Linux、传输JDK安装包... 目录1、卸载1.1 linux删除自带的JDK1.2 Linux上卸载自己安装的JDK2、安装2.1

Linux系统之主机网络配置方式

《Linux系统之主机网络配置方式》:本文主要介绍Linux系统之主机网络配置方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、查看主机的网络参数1、查看主机名2、查看IP地址3、查看网关4、查看DNS二、配置网卡1、修改网卡配置文件2、nmcli工具【通用

Linux系统之dns域名解析全过程

《Linux系统之dns域名解析全过程》:本文主要介绍Linux系统之dns域名解析全过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、dns域名解析介绍1、DNS核心概念1.1 区域 zone1.2 记录 record二、DNS服务的配置1、正向解析的配置

Linux系统中配置静态IP地址的详细步骤

《Linux系统中配置静态IP地址的详细步骤》本文详细介绍了在Linux系统中配置静态IP地址的五个步骤,包括打开终端、编辑网络配置文件、配置IP地址、保存并重启网络服务,这对于系统管理员和新手都极具... 目录步骤一:打开终端步骤二:编辑网络配置文件步骤三:配置静态IP地址步骤四:保存并关闭文件步骤五:重

Windows系统下如何查找JDK的安装路径

《Windows系统下如何查找JDK的安装路径》:本文主要介绍Windows系统下如何查找JDK的安装路径,文中介绍了三种方法,分别是通过命令行检查、使用verbose选项查找jre目录、以及查看... 目录一、确认是否安装了JDK二、查找路径三、另外一种方式如果很久之前安装了JDK,或者在别人的电脑上,想

如何用java对接微信小程序下单后的发货接口

《如何用java对接微信小程序下单后的发货接口》:本文主要介绍在微信小程序后台实现发货通知的步骤,包括获取Access_token、使用RestTemplate调用发货接口、处理AccessTok... 目录配置参数 调用代码获取Access_token调用发货的接口类注意点总结配置参数 首先需要获取Ac

Linux系统之authconfig命令的使用解读

《Linux系统之authconfig命令的使用解读》authconfig是一个用于配置Linux系统身份验证和账户管理设置的命令行工具,主要用于RedHat系列的Linux发行版,它提供了一系列选项... 目录linux authconfig命令的使用基本语法常用选项示例总结Linux authconfi

Nginx配置系统服务&设置环境变量方式

《Nginx配置系统服务&设置环境变量方式》本文介绍了如何将Nginx配置为系统服务并设置环境变量,以便更方便地对Nginx进行操作,通过配置系统服务,可以使用系统命令来启动、停止或重新加载Nginx... 目录1.Nginx操作问题2.配置系统服android务3.设置环境变量总结1.Nginx操作问题

CSS3 最强二维布局系统之Grid 网格布局

《CSS3最强二维布局系统之Grid网格布局》CS3的Grid网格布局是目前最强的二维布局系统,可以同时对列和行进行处理,将网页划分成一个个网格,可以任意组合不同的网格,做出各种各样的布局,本文介... 深入学习 css3 目前最强大的布局系统 Grid 网格布局Grid 网格布局的基本认识Grid 网