1. API 文档: 代码定义接口层，自动生成上传到 YApi, 配合 mock，满足前后端同时开发
2. 数据库文档: 简单直接维护 sql 逆向生成，或者一开始就用 pmd 类似工具维护表结构
3.测试文档，不知道，毕竟是开发，逃

API 文档生成，可以用这个插件: github.com/jetplugins/yapix

用 Yapi X 插件，从 Javadoc 中一键生成文档: https://github.com/jetplugins/yapix

数据库用蛇形命名，不过感觉用小驼峰保持实体一致，挺好的

不支持集成到自动化，不过手动上传也就秒秒钟的事，如果你要自动化可以考虑 smart-doc 这个工具， 但是好像不支持 YApi, Rap2 之类

[烟花][烟花][烟花]
给大家推荐个 API 文档自动生成工具，可抛弃 swagger 了，已支持上传到 YApi, Rap2, Eolinker 平台。

亮点：
- [火] 零入侵、零成本： 自动解析 Javadoc 和 spring 等常见注解
- [火] 开箱即用、智能 mock 规则: 默认就能生成很好的 mock 数据
- [火] 多平台支持：目前支持 YApi, Rap2, Eolinker, Copy as cRUL

Github: https://github.com/jetplugins/yapix
IDEA 插件名称: Yapi X
QQ 交流群：860701800

牙医

@cxytz01 风控类，设备采集大量图像，主要对交易做一个风险判定。选择 mongo 主要是数据量，性能好，其次是对象存储比较灵活。说一个不喜欢的问题关联查询写起复杂没有 sql 直观，合理利用 mongodb 特性可以减少这类问题

整个系统都是用的 mongodb, 事务对我们来说不重要，程序写起还是很爽

@liaoberlin 有支持 swagger， 不过目前还没测试过，下个版本会支持

@NoUltimate Rap2 最新版本才 2.2.3, 可以用淘宝 rap2 官方的测试下，如果还有问题可以在 issues 上沟通下，控制台会打印完整的堆栈信息，另外可以确认下本机能否正常连接到内网 rap2

@NoUltimate 可以指定，如果未配置相关账户密码，点击上传时，会自动弹出提示输入相关信息

@egfegdfr 很棒的工具，个人偏向于 IDEA 插件，交互更友好些

@dbpe 正解，而且结合 spring 框架， 比 apidoc 这种完全使用注解生成的强

@iseki 非常好的建议，后续会增加导出 swagger.json， 目前来看各种平台也支持导出 swagger.json， 可以放心使用

@balabalaguguji 暂时没打算，目前会优先适配主流的文档平台和打磨文档生成，可考虑 pr 二次开发相对比较简单

@siteshen 最合适的就是最好的，对比 swagger 主要还是学习成本，代码洁癖问题

@MarioLuo Yapi X 的亮点，1. Java 写的易于二次开发，2.支持 Rap2 和 Eolinker，并支持账户密码登录， 为撒要造轮子主要还是因为 easy-yapi 感觉定制不方便, kotlin 写的

@cweijan 是的，easy-yapi 很强大可配置性非常，不过这个插件还是有不同的地方：

@fkdog swagger 主要是标准和生态，各种语言支持还是很完美