前后端分离模式,后端说开发完才能给接口文档,合理吗
背景:
汇总了下老王在其他平台的原创回复,欢迎关注老王原创公众号【软件老王】,关注不迷路。
一、后端开发完接口才给出接口文档,合理吗?
本人所在的项目组做项目过程中,后端不会先给出接口文档,而是要等他开发完接口才给出 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朋友们,分享一些他们的技术见解和生活故事。