Skip to content

后端文档 ​

砚考后端 exam-back 基于 RuoYi-Cloud-Plus 2.6.2 构建,在其通用权限与基础设施之上,叠加了 10 个考试业务微服务。

阅读建议

本文默认是给「要把它跑起来」和「要在上面写业务」的人看的。如果你是第一次接触,建议按左侧顺序从 环境准备 读起。

一图看清后端 ​

text
                        ┌──────────────┐
   浏览器 / 考试端  ──▶  │   Nginx :80   │
                        └──────┬───────┘
                               │ /prod-api
                        ┌──────▼────────┐
                        │  Gateway:8080 │   统一入口:鉴权 / 路由 / 限流 / 日志
                        └──────┬────────┘
        ┌───────────┬──────────┼──────────┬───────────┐
        │           │          │          │           │
   ┌────▼───┐  ┌────▼───┐ ┌────▼───┐ ┌────▼────┐ ┌────▼────┐
   │ auth   │  │ system │ │ exam-* │ │  mark   │ │  stat   │  ...
   │ :9210  │  │ :9201  │ │ 9211+  │ │ :9215   │ │ :9216   │
   └────────┘  └────────┘ └────────┘ └─────────┘ └─────────┘
        └──────────  Nacos(注册/配置) + Dubbo RPC  ──────────┘
                    MySQL 多库   Redis   MinIO    SnailJob

技术底座 ​

类别选型版本
JDKOpenJDK17(21 亦可)
基础框架Spring Boot3.5.16
微服务Spring Cloud / Spring Cloud Alibaba2025.0.3 / 2025.0.0.0
注册配置中心Nacos2.5.1(客户端)
RPCApache Dubbo3.3.6
网关Spring Cloud Gateway(WebFlux)—
认证Sa-Token + JWT1.45.0
ORMMyBatis-Plus3.5.16
动态数据源dynamic-datasource4.3.1
缓存 / 分布式锁Redis + Redisson3.52.0
任务调度SnailJob1.10.0
分布式事务Seata2.6.0(默认关闭)
工作流warm-flow1.8.9
接口文档SpringDoc2.8.17
ExcelFastExcel1.3.0
构建Maven(+ flatten-maven-plugin)3.8+

内核零侵入

ruoyi-gateway、ruoyi-auth、ruoyi-common 等框架核心源码未做任何修改,考试能力全部以新增模块方式实现。 这意味着后续跟进 RuoYi-Cloud-Plus 上游版本时,冲突面很小。

文档分区 ​

分区适用人群说明
服务清单与端口所有人所有微服务的端口、职责与依赖方向
快速开始部署人员从装中间件到跑完整套环境的完整链路
考试微服务后端开发10 个考试服务的领域划分、数据表与调用关系
AI 能力后端开发 / 部署AI 子系统:Java 网关 + Python Agent、Skill、Tool、模型网关
框架能力后端开发继承的通用能力:代码生成、权限、多租户、RPC、缓存…
扩展功能运维ELK、SkyWalking、消息队列等可选中间件搭建

后端源码范围 ​

text
exam-back/
├── ruoyi-gateway/          网关(WebFlux,端口 8080)
├── ruoyi-gateway-mvc/      网关(Servlet MVC 版,与上面二选一)
├── ruoyi-auth/             认证中心 9210
├── ruoyi-api/              Dubbo API 契约模块(含 10 个 ruoyi-api-exam-*)
├── ruoyi-common/           公共组件(30+ 子模块)
├── ruoyi-modules/
│   ├── ruoyi-system/       用户/角色/菜单/字典/租户… 9201
│   ├── ruoyi-gen/          代码生成 9202
│   ├── ruoyi-job/          定时任务客户端 9203
│   ├── ruoyi-resource/     文件/OSS/短信/邮件/SSE 9204
│   ├── ruoyi-workflow/     工作流 9205
│   └── ruoyi-exam-*/       考试业务 10 个服务 9211~9220
├── ruoyi-visual/           monitor / snailjob-server / seata-server / nacos
├── ruoyi-agent/
│   └── ruoyi-exam-agent/   Python AI Agent 9221
├── script/
│   ├── config/nacos/       Nacos 配置文件(含 10 个 exam 配置)
│   ├── docker/             docker-compose 与中间件配置
│   └── sql/                数据库脚本
└── pom.xml

相关链接 ​

砚考 · 让每一次考试都经得起检验