一种理想化的前端原型设计与后端接口文档融合应用

搞过多人协作的软件开发的朋友应该很熟悉这样的场景：产品经理指挥UI设计人员绘制页面原型图，前端根据原型图实现真实可用的页面效果，后端提供数据接口给前端调用，测试再根据原型图检验页面实现情况。每个人都有自己熟悉的事情可以做，大家按部就班，配合得天衣无缝。

然而，实际情况往往没有这么顺利。首先，产品经理对很多功能并没有想得太清楚，导致UI需要根据产品经理的最新想法进行修改，一旦UI特别忙修改得不及时，原型图就会跟预期的效果产生不少的偏差，前端、后端再根据这样的效果实现出来的也只能是半成品，而测试也只能拿着不断修改的原型图磕磕绊绊地进行反复测试。除了原型图，产品经理还需要写需求文档、概要设计文档、详细设计文档，后端需要写接口文档等等。文档一多，出现了多个数据源，数据就难以一致，进而每个角色的工作就会出现混乱，导致加班、返工、延期、出现生产事故，甚至转岗跑路等等。青春就消耗在这些无谓的折腾上，魔鬼就隐藏在这样的细节里。

问题已经发现了，该怎么解决？

于是，本文提出一种理想化的前端原型设计与后端接口文档融合应用：将面向前端的原型设计中的标注功能重度使用起来，取消概要设计与原型设计，画出来的就是最终设计。不仅产品经理可以在上面标注需求逻辑，后端也可以在上面标注接口，接口可以变成链接跳转到应用内的接口文档功能。应用可以实现各种格式的导出文件，可以快速导出设计文档和接口文档。源头只有一个，不会出现描述不一致的情况，多人协作沟通成本很低，同时也能应付领导的检查。效果如下图：

上面的功能相当于Figma+ApiFox，貌似用Notion就已经能实现这样的效果。所以我们会发现，其实世界上的大部分需求都已经被实现过了，后面在这个领域想实现爆发式的创新越来越难。

之所以说理想化，在于要实现上面的效果，条件非常苛刻。

首先就是要有相对自由的氛围，像国企那种限制多多的地方肯定就无法使用了。

然后就是形式主义要少，做给领导看的东西太多，也会影响工作效率，这样又一堆公司推广不了。

于是，我们会发现，上面的应用的受众面变得很窄，基本上只有条条框框少的、激进的互联网公司，或者远程开发团队，甚至是独立开发者，才有奢望实现这种高效的工作方式。

就聊这么多吧，本文仅作为抛砖引玉的作用，欢迎大家批评指正。