基建功能设计
这篇解决什么
基础设施怎么分层:代码生成和文件配置是管理端功能,定时任务 / 接口文档 / 监控是运维入口,消息队列和微服务是启动配置。读完先对模块边界和表,再进各功能篇。
默认端口 48080,前缀 /admin-api。工程启动见 快速开始。系统主数据见 系统功能设计。
业务流程及架构
基建自己不算流程引擎,也没有 FlowBillService。yudao-module-infra 管生成器、文件、配置、API 日志。XXL-Job 运维接口在 yudao-server 的 JobOpsController,不在 infra 包。
示意图:左管理端。生成器和文件走 infra 模块;定时任务运维扫 @XxlJob。
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 代码生成 | 导入表、出 CRUD zip | 代码生成 |
| 定时任务 | 现行菜单是运维页,不是已删的 110 | 定时任务 XXL-Job |
| 接口文档 | Knife4j iframe /doc.html | 接口文档 |
| 单元测试 | 无独立菜单,跟生成开关和测试类 | 单元测试 |
| Webhook | 无独立菜单,走短信调试钉钉 | Webhook |
| 消息队列 | 无菜单,改 Starter 与 yaml | 消息队列 |
| 技术架构 | 无菜单,单体或微服务两种部署方式 | 技术架构 |
| 新建服务 | 纯开发说明,无 Controller | 新建服务 |
| 监控 | iframe / Redis 页,SBA 默认未开 | 服务监控 |
不要写已删的定时任务菜单
菜单 110(/infra/job)已删除。现行入口是 5260 定时任务运维(/infra/operation/job-ops)。前端旧 API /infra/job/* 没有对应 Controller。
数据表 ER
主干表按本仓库 DO 画出。监控和 Knife4j 没有业务表。
示意图:按本仓库生成的 ER。infra_job 表还在 schema 里,当前 Java 不再提供 Job CRUD。
前后端代码
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 模块 | api 枚举 + server 实现 | ruoyi-office/yudao-module-infra/ |
| 单体引入 | yudao-module-infra-server | ruoyi-office/yudao-server/pom.xml |
| 生成器 | @RequestMapping("/infra/codegen") | .../controller/admin/codegen/CodegenController.java |
| 任务运维 | @RequestMapping("/infra/job-ops") | yudao-server/.../JobOpsController.java |
| 管理端 | 基建目录 | ruoyi-office-vben/apps/web-antd/src/views/infra/ |
官方菜单:2 基础设施(/infra)。代码生成 115(/infra/codegen),文件目录 1243,API 日志目录 1083,接口文档 116(/infra/swagger),运维目录 5259,定时任务运维 5260。

本系统截图:基础设施 → 代码生成。导入表之后才能预览和下载。

本系统截图:基础设施 → 系统运维 → 定时任务运维。卡片来自 @XxlJob 扫描,不是旧 infra_job 表。
功能开启
单体 -P boot 时已经依赖基建实现,没有单独的「基建开关」页。启动 YudaoServerApplication 即可。
客户默认包 ruoyi-office-db/dump/latest/:先 schema_*.sql 再 static_data_*.sql,带 infra_* 表和菜单。以后改表走 ruoyi-office-db/update/。
本地 xxl.job.enabled 默认 false,运维页仍能列出并手动触发已扫描的 Handler。生产再打开执行器并连调度中心。
示意图:先库和菜单,再生成器和文件,最后才开调度与监控。
旧文 基建功能开启 已并入本页,请收藏本篇。
