一种面向信号智能运维的API全链路自动化处理系统的制作方法

本发明涉及轨道交通及接口文档管理，特别是涉及一种面向信号智能运维的api全链路自动化处理系统。

背景技术：

1、随着城市轨道交通规模扩大，信号智能运维系统多采用“前端可视化运维+后端微服务”架构，涉及实时数据监测、历史数据管理、故障智能诊断等多个功能模块，模块间依赖api接口实现数据交互与指令传输。当前主流api文档管理工具如apidoc、postman，存在注解驱动缺失、文档更新依赖人工、自动化能力不足等问题；同类通用api方案仅解决基础文档生成与调试，未适配信号运维场景的特殊需求。

技术实现思路

1、鉴于上述问题，提出了本发明以便提供一种克服上述问题或者至少部分地解决上述问题的一种面向信号智能运维的api全链路自动化处理系统。

2、本发明提供了一种面向信号智能运维的api全链路自动化处理系统，包括：

3、接入层，用于提供api文档访问入口，并进行权限校验与请求转发；

4、核心处理层，用于解析接口代码中的标准注解和自定义注解，生成api文档并提取接口元数据，根据所述接口元数据自动生成测试用例，并将生成的api文档同步至数据存储层；

5、数据存储层，用于存储api文档、权限配置信息以及自动化测试执行日志；

6、系统适配层，用于基于所述核心处理层产生的指令或数据，与外部信号智能运维系统进行数据交互和消息推送。

7、可选地，所述接入层包括nginx网关组件和权限认证模块，

8、所述nginx网关组件，用于提供api文档访问入口并转发访问请求；

9、所述权限认证模块，用于对访问用户实施分级权限校验。

10、可选地，所述核心处理层包括注解解析模块、标准化校验引擎、自动化测试用例生成模块和文档同步中心，

11、所述注解解析模块，用于解析接口代码中的swagger标准注解和自定义注解，生成标准化的openapi文档并提取接口元数据；

12、所述标准化校验引擎，用于对生成的api文档进行restful路径、参数分类和返回结构规范性的合规性校验；

13、所述自动化测试用例生成模块，用于根据解析得到的接口类型和参数，自动生成包括请求方法和预期响应的测试用例；

14、所述文档同步中心，用于将生成的api文档同步存储至所述数据存储层，以及聚合多个微服务生成的api文档并进行版本管理。

15、可选地，所述系统适配层包括接口适配模块和数据推送组件，

16、所述接口适配模块，用于基于所述核心处理层产生的指令或数据，与外部信号智能运维系统进行数据交互，获取设备状态和业务数据；

17、所述数据推送组件，用于根据预设的推送规则，将故障信息或告警信息定向推送至对应责任人。

18、可选地，所述自动化测试用例生成模块，用于：

19、针对查询类接口，自动生成包括必填参数合法值、可选参数组合、不合法参数的测试用例；

20、针对创建或更新类接口，自动生成包括请求url、方法、参数值和预期响应的基础测试用例。

21、可选地，

22、所述核心处理层的注解解析模块，用于解析@apidevice注解，获得接口所绑定的信号设备及依赖的设备状态字段；

23、所述系统适配层的接口适配模块，用于在接口调用异常时获取所述信号设备的设备状态；

24、所述核心处理层的自动化测试用例生成模块，用于结合设备状态与接口测试结果，自动区分故障类型，并生成包括故障根源、设备信息和接口日志的详细报告；故障类型包括接口故障、设备故障；

25、所述系统适配层的数据推送组件，用于根据预先配置的故障类型与责任人及推送渠道的映射规则，将故障信息实时定向推送至对应责任人，并在推送后跟踪状态，对超时未读的故障进行二次提醒。

26、可选地，

27、所述核心处理层的注解解析模块，用于解析@apidatadependency注解，构建接口间的数据依赖链；

28、所述核心处理层的自动化测试用例生成模块，用于在自动化测试过程中，按所述数据依赖链的顺序执行前序接口，自动提取依赖数据并填充至当前测试用例，并执行当前接口测试；若任一前序接口执行失败，则终止当前接口测试，并触发所述系统适配层的数据推送组件发送提醒。

29、可选地，

30、所述核心处理层还包括规则引擎，用于配置信号监测数据的阈值规则，所述阈值规则包括上限、下限、区间和变化率类型；

31、所述系统适配层的接口适配模块，用于实时采集接口返回的业务数据并发送至所述规则引擎；

32、所述规则引擎，用于将业务数据与所述阈值规则进行持续比对，当数据超出阈值时生成告警信息，并触发所述系统适配层的数据推送组件将告警信息按预设推送规则推送给对应运维人员，所述告警信息包括告警等级。

33、可选地，所述接入层还包括共享门户，所述共享门户提供故障中心，用于汇总展示系统产生的故障信息，支持按照故障类型、信号设备和时间范围进行筛选，查看包括故障根源、设备状态和接口日志的故障详情，并接收责任人录入的故障处理结果及状态更新。

34、本发明包括以下优点：

35、本发明的面向信号智能运维的api全链路自动化处理系统，采用分层架构设计，包括接入层、核心处理层、数据存储层和系统适配层。系统基于swagger框架，通过解析标准注解和自定义注解，实现api文档自动生成与同步、自动化测试用例生成、接口与设备故障根源自动区分、运维故障定向推送、跨接口数据依赖关联以及规则引擎阈值告警推送等核心功能。该系统解决了现有api管理工具在信号运维场景中注解驱动缺失、文档更新依赖人工、自动化能力不足等问题，实现了文档维护接近零人工干预、测试效率显著提升、故障定位更精准、运维响应更前置、权限管控更精细、故障处理更高效的技术效果，完全适配城市轨道交通信号运维业务需求。

1.一种面向信号智能运维的api全链路自动化处理系统，其特征在于，所述系统包括：

2.根据权利要求1所述的系统，其特征在于，所述接入层包括nginx网关组件和权限认证模块，

3.根据权利要求1所述的系统，其特征在于，所述核心处理层包括注解解析模块、标准化校验引擎、自动化测试用例生成模块和文档同步中心，

4.根据权利要求1所述的系统，其特征在于，所述系统适配层包括接口适配模块和数据推送组件，

5.根据权利要求3所述的系统，其特征在于，所述自动化测试用例生成模块，用于：

6.根据权利要求3或4所述的系统，其特征在于，

7.根据权利要求3或4所述的系统，其特征在于，

8.根据权利要求1所述的系统，其特征在于，

9.根据权利要求1所述的系统，其特征在于，所述接入层还包括共享门户，所述共享门户提供故障中心，用于汇总展示系统产生的故障信息，支持按照故障类型、信号设备和时间范围进行筛选，查看包括故障根源、设备状态和接口日志的故障详情，并接收责任人录入的故障处理结果及状态更新。