目前我们部门的全部项目都是前后端完全分离的，在享受前后端分离低耦合的好处的同时，也引入了种种新的问题，其中 API 联调效率问题是我们当前想着重优化的点。通过跟云计算，云盘，猫眼，外卖等项目组的沟通我们打造了现在的 Vane 系统。通过 Vane 系统开发者只需要用 markdown 定义一次 API 即可自动生成 API 文档， mock 假数据，单元测试 API，以及流程控制。和传统的联调平台不同之处在于 Vane 的架构是完全分布式的，开发者可以在不联网的情况下持续使用它。 分享者：吕伟，美团点评技术工程部高级工程师，目前负责基础库建设，工程自动化方面的工作。是整个团队 Node 方向的顾问之一。去年负责了美团考试，近期主要负责公司内部联调平台等基础设施的架构设计和开发。

1. 吕伟@美团点评技术工程部高级工程师
https://github.com/ysmood

2. Vane 舵
http://vane.sankuai.com (仅内内⺴)

3. 你是否碰到过下⾯这些情况
API
API
API
wiki

4. 从解耦说起
• 不论前端还是后端都会有依赖
• 依赖的开发速度难以协调
• 让开发环境接近完美沙盒

5. Vane 想做的事
API 定义
⽣成 API ⽂档
API mock API 单元测试
流程控制
API API mock
API

6. API 定义
adoc (api documentation)
markdown

7. Type 和 模糊匹配
json schema

8. ⽀持 js ⽣成数据
browser web worker
node subprocess vm

9. 更多

10. 沙盒 => 客户端
• 类似于 github 和 git，vane 是 CS 架构的
• 即使离线状态 vane 也能正常使⽤
• 将运算压⼒转移到了各个⽤户端

11. ⼀般的 mock 开发模式
开发⽤服务浏览器
8080

12. ⽆痛 mock 接⼊
开发⽤服务浏览器
8080
vane 客户端
vane 平台
8000
API
API
vane

13. ⼀般的开发服务 API 测试
开发⽤服务
8080
⾃⼰写测试器
mock

14. API 测试接⼊
开发⽤服务
8080
vane 客户端
vane 平台
API
mock

15. ⺴⻚端已实现的功能
• 项⺫管理
• API 编辑
• 项⺫ Token
• API 变更历史
• API 搜索
• 成员管理
• API 变更通知

16. 客户已实现的功能
• 实时获取 API 定义的变更
• 离线使⽤ API 定义
• 假数据代理
• 单元测试后端服务
• 作为库来使⽤

17. 技术栈
• 纯 JS 技术栈，从⾃动化⼯具，到数据库操作，
到后端逻辑，再到客户端实现
• 前端 React ＋ Babel ＋ Webpack
• 后端 Nodes + Rethinkdb

18. 模块基本构成
vane client vane server
vane api
vane web
junit
rethinkdb
adoc noflow nokitnisp
nofs yaku mx-fe-bone ……

19. nisp
• ⼀个⾮图灵完备的 lisp-0 语⾔
• 较 RPC 更为抽象灵活的⼀种思路
• 基于权限的语⾔，初始不含任何功能
• 项⺫地址：github.com/ysmood/noflow

20. yaku
项⺫地址：github.com/ysmood/yaku

21. noflow
• 贯穿于项⺫各个部分的 http composer
• 基于 Promise，主动⽀持 ES7 async/await
• 轻量可控，⽆功能型依赖
• 项⺫地址：github.com/ysmood/noflow

22. junit
• 贯穿于项⺫各个部分的异步并发单测库
• 并发测试极⼤的减少了测试 API 的时间
• 项⺫地址：github.com/ysmood/junit

23. 问答

24. 谢谢