最近内部的创新项目,大家一起做的很不舒服,因为需求很多不明确,管理问题,作为前端,有洁癖,评审后端接口文档,还经常提了修改建议,感觉得罪人了。。。
1
MuscleOf2016 OP 包括一些文档格式建议。。。🤦
|
2
Rocketer 2022-03-19 00:15:02 +08:00 via iPhone 3
建议互怼,把动静闹大一点,不把问题暴露出来,上面是不会知道你们的经理不合格的
|
3
233373 2022-03-19 00:16:00 +08:00
如果可以说服我,会修改
|
4
MuscleOf2016 OP @Rocketer 前端,我说了算吧。后端 leader 太慢,评审不及时。
|
5
MuscleOf2016 OP @233373 主要增加了工作量。。
|
6
MuscleOf2016 OP @MuscleOf2016 太忙。。
|
7
bojackhorseman 2022-03-19 00:24:38 +08:00 via iPhone
我一般不会提格式问题,只会按照原型或者 ui 和后端沟通字段缺失问题🤔
|
8
pengtdyd 2022-03-19 00:29:21 +08:00
接口文档不都是自动生成的吗,哪来的格式问题?
|
9
sun5244725 2022-03-19 03:01:13 +08:00
@pengtdyd 先有文档再有代码 没法生成的
|
10
wheeler 2022-03-19 06:11:41 +08:00 via iPhone
为什么不呢?
|
11
MegrezZhu 2022-03-19 06:26:49 +08:00
看有没有空,有空就做,没空加 TODO
|
12
changdy 2022-03-19 08:05:22 +08:00
ennn 讲道理 后端也要稍微 为前端着想下...
erp 系统之类的 .部分设置如果嵌套层次比较多 .. 实际上不如后端直接保存 json |
13
Forest000 2022-03-19 08:12:51 +08:00
一般我们前端都是让我们和 Element UI 组件的的数据格式对齐...
|
14
gam2046 2022-03-19 08:13:16 +08:00
合理为啥不能改呢,单纯为了抬杠而抬杠就没意思了。大家都是出来赚钱的,可不是来抬杠的。
|
15
ericls 2022-03-19 08:17:24 +08:00 via iPhone
前后端不能分人
|
16
dayeye2006199 2022-03-19 08:30:35 +08:00
可以手写 openapi 的 spec ,然后自动生成文档。这样就不存在格式问题了。
还能自动生成 mock server ,SDK ,十分方便 |
17
huixia0010 2022-03-19 08:44:31 +08:00
合理,建议,无论是前端测试还是运维,我都会改。特别有价值的我还会请对方喝咖啡。
|
18
ALVC666 2022-03-19 09:18:00 +08:00
合理的肯定改了,你说没空改可以写个 todo 正如楼上所说,
大家都是打份工,彼此担待点搬砖搬的舒服点不好么。 |
19
7911364440 2022-03-19 09:27:04 +08:00
格式问题别提了吧,毕竟大家都还有功能要开发,你这样只会平白无故增加别人工作量,别人肯定不乐意啊。
|
20
paradoxs 2022-03-19 09:48:29 +08:00
晚上一起喝喝酒 谈谈心
第二天所有意见都不见了 |
21
darknoll 2022-03-19 10:36:30 +08:00
提的好的就改,还会赞扬他 /她
|
22
C603H6r18Q1mSP9N 2022-03-19 11:21:23 +08:00
前端只负责切图、布局,接口对接后端自己做;不就行了呗
|
23
vyronlee 2022-03-19 11:57:43 +08:00
按我这么多年接触到的,很多后端基本不会改,API 的设计压根就不考虑使用方的便利性,而且冠以各种“出于性能考虑”,“这样能省点流量”为借口,其实就是图省事懒得改。有时候调整下数据结构,多发一两个字段下来,客户端就能省下大量的接入功夫,维护起来方便,排错成本又低,但就是不愿意做。只要功能能实现就行,“又不是不能用”。客户端抱怨一下,还会被说“矫情”。我不是针对谁,国内不少的都认为“后端要高于客户端 /前端一等”,至少我接触到的都这样。
|
24
Bingchunmoli 2022-03-19 11:58:31 +08:00 via Android
@sun5244725 现在一般代码先行,文档生成
|
25
Bingchunmoli 2022-03-19 12:00:34 +08:00 via Android
@vyronlee 我们也要考虑增加字段的复杂度,和多平台接口的复用度,如果可以加就加了
|
26
retrocode 2022-03-19 12:05:46 +08:00
@vyronlee #23 这点我补充下
主要原因是大部分的后端,常年做的是各种管理系统, 最常用的场景是列表展示, 导致对前端特别是移动端的一些的接口交互是没有概念的, 图省事是重点, 一般在暴漏性能问题前,后端绝大部分业务代码都是以快速做完符合业务为导向的, 性能考虑省流量都是接口 所以我都是要求提权的,至少我有权能改一部分后端代码才可以=.= |
27
Archeb 2022-03-19 12:24:31 +08:00
你都觉得合理了,那证明你认同他的建议,那肯定是能改就改了
|
28
kingjpa 2022-03-19 12:26:18 +08:00
当然是要改的, 不过取决于手头忙不忙
|
29
wmwgijol28 2022-03-19 12:43:47 +08:00
后端返回结构现在一般都是统一的 不存在格式问题, 一般就是沟通字段缺失 缺啥补啥
|
30
EastLord 2022-03-19 12:51:53 +08:00
会
|
31
wolfie 2022-03-19 13:47:22 +08:00
会改
个人经历,前端 2/3 提的修改建议都不合理。 而且比较会甩问题或者工作量。 |
32
pkwenda 2022-03-19 17:04:39 +08:00
大家都觉得和理才行,你提的你当然认为合理
|
33
ZSeptember 2022-03-19 17:10:26 +08:00
合理肯定改,问题是你如何说明你的 API 设计更合理。
有公司 API 设计 Guideline 吗,有项目 API 设计 Guideline 吗 |
34
hingbong 2022-03-19 18:00:06 +08:00 via Android
会改,不过有没有前端提出直接上 graphql ,要什么前端都可以直接拿,会不会省事
|
35
kkbblzq 2022-03-19 22:43:53 +08:00
会改;但是关于前面前端同学说的点我也想补充一下,有些情况下,多加一些字段并不是所谓的"改下数据结构"就能达成的,很多时候多的字段需要额外的请求外部服务、额外的关联表查询等等,这块对于性能和复杂度是会有一定影响的,有时候甚至需要针对这部分做专门的优化,所以有时候所谓的性能问题有时候并不是都是"借口";就个人的观点来说,接口在满足业务需要的部分,额外所谓易用性的部分,是需要根据业务场景再来做取舍。再者就是前后端同学还是要更多的交流和互相理解吧,不然互相都会觉得对面在甩锅😂😂😂
|
36
leeraya 2022-03-19 22:49:25 +08:00
一切按文档来,文档没说清楚的,让前端找 leader 和 产品说清楚,最终落实文档版本更新,留到下个 story 排 task 。
|
37
EvaCcino 2022-03-19 23:06:01 +08:00
会,前端说怎么改就怎么改,最好让前端什么都不处理
|
38
aver4vex 2022-03-19 23:06:55 +08:00
一般会,除非是马上要上线,来不及改。
|
39
1611499758wuhao 2022-03-19 23:09:37 +08:00
建议如果是合适的,然后跟项目经理要时间,用来修改接口
|
40
ClericPy 2022-03-19 23:12:46 +08:00
最近在关注领域驱动的玩意, 不确定会不会解决 /避免标题里的问题
就之前的经验来说, 如果是很专业的开发团队, 这种问题就不会提出来; 如果连需求都不明确的团队情况, 搞好自己的事情吧, 规范或者优化改进在大领导眼里都是无法产生利润的额外工作量. 不管专业不专业, 一切以文档为准, 轻易修改不光违反开闭原则, 还可能导致从上到下信息不对称, 徒增烦恼 |
42
yoloMiss 2022-03-20 21:56:08 +08:00
🤣怼他,拿规范说事。
|
43
FrankAdler 2022-03-21 00:25:09 +08:00 1
看情况,比如我们公司很多前端都是妹子,水平差的不行,可能都没听说过 DELETE,PUT 你给个这样的接口人家说要 POST 才行,你需要各特殊的 Header ,人家说封装好的,加不上啥的,后端看第低一眼前端存在的情况大都是妹子导致的,或者很多前端连自己做的是啥都不知道,根本不去思考 业务逻辑
|