首页 / Java 平台（cloud-java） / infra 基础设施
infra 基础设施
配置文件、文件存储、API 日志、代码生成与定时任务基础设施。
职责概览
基础设施模块 独立端口 48091，提供平台级通用能力：配置文件、文件存储、API 访问/错误日志、Redis 管理、代码生成、数据源配置、前端组件与图标管理。
接口前缀 /admin-api/infra/...，多数为后台运维能力。
接口清单
| 分组 | Controller | 说明 |
|---|---|---|
| 配置 | ConfigController | 后台配置项 CRUD（infra_config） |
| 文件 | FileController、FileConfigController | 文件上传/下载与存储配置（MinIO/OSS） |
| 日志 | ApiAccessLogController、ApiErrorLogController | API 访问日志与错误日志查询 |
| Redis | RedisController | Redis 监控与键管理（运维） |
| 代码生成 | CodegenController | 表结构 → CRUD 代码生成 |
| 数据源 | DataSourceConfigController | 动态数据源配置 |
| 前端组件 | FrontendComponentController、IconController | 前端组件注册与图标库 |
| 健康检查 | StatusController | 状态探针 |
| App 端 | AppFileController、AppIconController | App 文件上传与图标 |
关键实现
- 定时任务清理：
accessLogCleanJob（@XxlJob）定期清理过期 API 日志。 - 文件存储：文件配置支持多存储后端，上传凭证与访问地址由
infra_file统一管理。 - 代码生成：基于数据源元数据生成模块骨架，生成代码需人工审阅后再合入。
数据与维护注意
核心表：infra_*（13 张）及任务表，包括配置、文件、访问日志、错误日志、数据源、代码生成等。
- 配置文件内容可能含环境差异，敏感值通过部署密钥注入，不落仓库明文。
- API 日志量大，需关注保留周期与清理任务是否正常执行。
- 文件删除需同步清理存储后端，避免只删库记录遗留孤儿文件。