md-scan-starter

1. 模块定位

系统 API 扫描模块，坐标 top.mddata.base:md-scan-starter。服务启动时扫描全部 Controller 的 @RequestMapping，对外暴露一个匿名接口 GET /anyone/systemApiScan 返回接口清单。主要用于【控制台】-【菜单管理】配置接口权限。

2. 源码解读

top.mddata.base.scan
├── ScanAutoConfigure.java               # 自动配置：@ComponentScan + 注册 RequestMappingScanUtils
├── controller/SystemApiScanController.java  # GET /anyone/systemApiScan → R<Map<String, List<SystemApiVO>>>
├── utils/RequestMappingScanUtils.java   # 扫描 RequestMappingHandlerMapping，提取 path/method/参数
├── model/SystemApiVO.java               # 接口视图对象
└── properties/ScanProperties.java       # mdp.scan.* 配置

工作流程：ScanAutoConfigure 注册 RequestMappingScanUtils；请求 /anyone/systemApiScan 时遍历 Spring MVC 的 handler mapping，按 controller 分组输出接口路径、HTTP 方法、参数信息。

3. 可配置参数

ScanProperties（前缀 mdp.scan，ScanProperties.java:14-27）：

配置项	默认值	说明
mdp.scan.enabled	true	是否启用扫描接口
mdp.scan.base-package	—	扫描包路径（限定范围）

4. 扩展点

• 整体关闭：mdp.scan.enabled=false。
• 输出结构如需扩展（如带权限标识），改 SystemApiVO + RequestMappingScanUtils 的提取逻辑——上游消费方（网关/SOP）要同步适配。

5. 功能扩展建议

想做什么	推荐做法
接口清单落库做权限映射	在管理端消费该接口的返回，别改扫描逻辑
限定扫描范围	配 mdp.scan.base-package 排除无关 controller