前后端分离模式,后端说开发完才能给接口文档,合理吗

266 阅读2分钟

背景

汇总了下老王在其他平台的原创回复,欢迎关注老王原创公众号【软件老王】,关注不迷路。


一、后端开发完接口才给出接口文档,合理吗?

本人所在的项目组做项目过程中,后端不会先给出接口文档,而是要等他开发完接口才给出 swagger 文档。

作为前端,我的想法是先有文档,就可以确定后端给到的参数,数据结构,对比和我预想的是否一致(我希望能更早发现接口是否满足需求、是否少参数等问题),我并不指望定了文档就不改。相反,我希望早点发现早点改,防止到后面了大家再返工。

某次动工前,问后端要接口文档,但后端貌似不理解,反问“你都开发完了吗?”

想问下,大家的团队都是什么流程?后端开发完接口才给出接口文档,合理吗?

如果不合理,我应该怎么说服后端?

老王观点

首先说下观点吧, 个人认为你做事和流程是没大的问题,但是在沟通上是有点小问题的。

1、目前软件开发中,比较流行的就是前后端分离模式,前端和后端由不同的开发人员完成,前后端都完成后,联调,测试,然后上线。

2、一般任务安排后,后端一般是要有个1-2天的技术选型、设计、及基础代码测试开发的,你动工前就跟后端要接口文档,后端自己还没设计与验证呢,他是提供不了的,不怼起来才怪呢啊!

3、举个老王实战项目的栗子吧,比如一项任务预估是2周,10个工作日完成,比如1号-10号吧。

大概安排是这样的:

​ (1)1号-3号,前后端各自技术选型、设计及开发;

​ (2)3号-5号,后端提供初步swagger文档,你说的正式接口文档,有时候也会提供,但是对小的开发任务,一般就是用swagger在线文档或者导出接口文档;

​ (3)6-7号,前后端联调;

​ (4)8-10号,测试正式进入测试阶段,根据测试情况,前后端修复bug等问题。

大家都是一个团队的,建议与后端或者可以喊上项目经理,一起沟通下,为了项目任务,看怎么能早点提供接口文档,以便任务早日完成。

二、AI核心代码,估值1个亿?


更多信息请关注公众号:「软件老王」,关注不迷路,软件老王和他的IT朋友们,分享一些他们的技术见解和生活故事。