演示使用 Swagger 生成 tms-koa（nodejs）框架 API 在文档

在代码中，根据规范（OAS3），编写说明文档。

使用tms-koa内置Swagger服务生成在线 API 文档。

基于在线文档生成jmeter测试计划。

执行jmeter测试计划。

输出 markdown 版本的 本地 API 文档。

推荐阅读：API 的开发、测试与输出文档

在config/app.js定义了 API 调用认证方法和账户信息，如果需要可以通过新建config/app.local.js进行本地化设置，具体设置参见tms-koa项目。

通过新建config/swagger.local.js进行本地化设置，具体设置参见tms-koa项目。

如果没有在配置文件中指定规范版本，tms-koa框架支持通过环境变量TMS_KOA_OAS_VERSION指定openapi规范的版本。

生成文件docker-compose.override.yml进行本地设置。

docker-compose up back

docker-compose down

执行命令gen-testplan.sh，将生成的测试计划输出到jmeter目录下。

每个标签会生成一个测试计划。

执行命令run-testplan.sh，将测试报告输出到jmeter/report目录下。

每个测试计划的报告在以测试计划名命名的子目录中。

执行命令gen-markdown.sh，将 Markdown 格式的文档输出到docs目录下。