关于前端开发项目合作问题

工作交流是工作中很重要的一环,写这篇文章,一方面希望更多的小伙伴看到后改正自己不认真的态度,另一方面也希望自己在工作中,认真将工作做到极致。

其实在项目合作中,肯定会遇到各种各样的问题,这是无法避免的,当然也有很多问题是可以避免的。

很多公司对于前端的看法就是不入流,没有后端重要,其实我是不认同的,特别是在前后端分离后,前端承受的工作变得重要起来,一个项目想做好,用的的前端技术其实是很多的。当然,在我理解中,前端更多负责体验,后端更多负责安全。

前后端交互,接口文档问题

接口文档:在开发中,前端和后端对接,最重要的东西就是接口文档。有了接口文档,前端甚至可以随时接手另一个前端的工作。但现实中:

A:前端 B:后端 C: 前端

场景模拟一:
  • A:接口文档怎么样了?
  • B:我这边写完了。
  • A:那接口文档写好了吗,
  • B:字段一看就明白了。不用接口文档
  • A:。。。
场景模拟二:
  • A:你这个list字段没有数据返回的都是空,请你告诉我下你要返回啥类型和什么数据
  • B:我帮你查查
  • A: 半个小时候。。还没查好吗?
  • B:稍等手头有事,现在查。。
  • A:一个小时后。。
  • B:返回的是。。。type:1,2,3
  • A: ...
  • B: 1,2,3 代表的是啥意思呢?文档写一下吧
  • A: 我给你一说你就知道了,不用写了
  • B: 1,2,3..

上线后,有了问题

  • C: 这个1,2,3是什么意思啊?
  • B:忘了,我去查查
  • C:默默补全文档
场景模拟三:
  • A:我们上线的代码报了一个错误,是因为返回的数据格式不对造成的
  • B:我去查下数据库,我记得当时只返回字符串的呀
  • A:现在返回了null,接口文档没有声明
  • B: 我不记得了。
场景模拟四:
  • B: 你要的starttime时间字段已经加过了,调用接口就能看到
  • A: (打开接口文档,看下字段名和类型,什么都没有。。调用一下接口,还真有了,返回的啥一看null...)请问下,starttime返回的时间格式是啥,或是哪个账号有不是null的数据?(一看时间周五下班了。。。一脸懵逼,我们之前返回的时间有字符串格式,时间格式,时间戳格式。。)
场景模拟五:
  • A:接口怎样了?
  • B:很简单啊,pc的不是都好了吗?移动的粘贴复制就好了
  • A: 三天后。。。文档空白
    (这个项目两个接口整整开发了一个月。。)

当然,以上场景都是异地办公的比较多

我表示,上面的对话很真实。
站在前端实际调用接口的角度

  • 1、我要连接哪个接口地址(公司有很多台开发服务器,我哪知道你用的是哪个?)。
  • 2、我要知道调用方法(get\post等),当然不难猜
  • 3、你开发的账号是否有数据,可以调用
  • 4、要传递的参数是啥?
  • 5、你返回的数据类型是啥,你的type=1,2,3是毛线意思
  • 6、我本地开发需要跨域,你加了吗?
  • 7、当我问你是不是少starttime这个字段,你可能告诉我,稍等我去查查,有时候字段类型和我要的不一致,你可能会说稍等,我去查查,然后我一等就是一个小时。。。
  • 8、上线后,突然发现线上报了一个错误,一查发现时因为你返回了null,我没有做判断,一看接口文档,你就没写,我判断了undefined...

针对以上问题,作为一个刚刚开始前后端分离模式开发的项目来说,一部分是正常的现象。这也恰恰的说明了接口文档的重要性,希望看到这篇吐槽的小伙伴们对于接口文档认真一点,当前最后一个问题可能是个人问题,这种情况我想每个人都遇到过,告诉你这个简单,五分钟就好了,然后就五分钟循环。。我比较讨厌这种,如果简单的话你就给我拿出来,没有结果,那就不叫完成,再简单的东西,请你拿出来,我不要马上,我只要结果。

针对以上问题:我这边给了解决办法:

  • 一、前端在接到需求的时候,先阅读文档,去确定接口数量,需要调用的数据结构,写好接口文档
  • 二、接口文档由后端去将他开发的东西做进一步补充
  • 三、合作过程中,前端去补充沟通的确认的问题

当然前端开发中出现的问题:

我和另一个小伙伴一起负责网站的开发,我比他早一点进入公司,所以初期开发完后我会去看下。相互学习,也检查下防止有什么遗漏。这不我就发现了很多问题。

D:老前端 E:新前端

案例一:
  • D:开发完了,可以测试不?
  • E:嗯,应该没问题
  • D:(打开测试站,点击入口。。。)截图,进度怎么不对?
  • E:没有放入链接,稍等。。加好了
  • D:这两个标题怎么反了,这个图标怎么在灰色的底色,不是透明的?(一看就知道没有进行基本的冒烟测试)
  • E:那个图片,ui给的就是白色的,没有透明的;
  • D:。。。(心里:这个问题都不能解决。。)为啥不问ui要或是自己处理下呢?
  • E:好
  • D:移动,pc看过后,移动web站为啥没有处理?
  • E:没看到要处理啊
  • D:截图,同级目录下,下面的图标有微小的变化
  • E:没看见
案例二:

上周一的项目,上线时间比较紧急,D请假了两天。

  • D:今天周二,这个项目周五要测试,你那边处理的怎么样了?
  • E:pc差不多了,就剩调接口了。
  • D:那移动和移动web站呢?
  • E:还没有,那个比较简单,直接将逻辑复制过去就行了,周五应该可以
  • D:尽量往前赶。。

很多时候我们都会想当然,认为东西很简单,一会就搞定了,但工作只能提前出结果,不能往后拖,这样会出现意想不到的问题,你必须先完成。简单,简单你倒是先给我成品那。

给小伙伴的建议:

做前端你要站在用户的角度想问题,冒烟测试的时候请把自己变成一个客户,那样的话你就知道自己的作品在哪里有不足,才能进步。

很多时候,细心一点不仅是对别人负责,更是对自己负责。在合作中会有各种各样的问题,但是我们不能逃避,摆好态度去沟通。

猜你喜欢

转载自www.cnblogs.com/rich23/p/9031867.html