Skip to content

系统架构 ​

砚考采用微服务架构,基于 RuoYi-Cloud-Plus 2.6.2 构建,对框架内核零侵入——考试能力全部以新增模块实现。

全景图 ​

text
┌─────────────────────────────────────────────────────────────┐
│  用户侧                                                       │
│  管理后台 / 教师工作台 / 考生答题端(PC + 移动端浏览器)          │
└───────────────────────────┬─────────────────────────────────┘
                            │ HTTPS
┌───────────────────────────▼─────────────────────────────────┐
│  接入层                                                       │
│  Nginx 80/443  静态托管 + API 反代 + SSE 长连接               │
└───────────────────────────┬─────────────────────────────────┘
                            │ /prod-api
┌───────────────────────────▼─────────────────────────────────┐
│  网关层  Gateway :8080                                        │
│  鉴权 · 路由 · 限流 · 请求响应日志 · 跨域                       │
└───────────────────────────┬─────────────────────────────────┘
                            │ lb://服务名
┌───────────────────────────▼─────────────────────────────────┐
│  业务服务层                                                    │
│  ┌──────────┬───────────┬──────────────────────────────┐    │
│  │ auth     │ system    │ gen  job  resource  workflow │    │
│  │ :9210    │ :9201     │ 9202 9203 9204     9205      │    │
│  ├──────────┴───────────┴──────────────────────────────┤    │
│  │ 考试域 9211~9220                                      │    │
│  │ question paper manage answer mark                    │    │
│  │ stat     practice cert   proctor ai                  │    │
│  └──────────────────────────────────────────────────────┘    │
│        └──── Nacos 注册发现 + Dubbo RPC ────┘                 │
└───────────────────────────┬─────────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────────┐
│  数据层                                                       │
│  MySQL(ry-cloud / ry-exam / ry-exam-answer / ry-job / …)    │
│  Redis 7 · MinIO · Elasticsearch(可选)                      │
└─────────────────────────────────────────────────────────────┘

核心组件 ​

组件选型作用
注册 / 配置中心Nacos 2.5.1服务注册发现;22 个配置文件集中管理
网关Spring Cloud Gateway统一入口,WebFlux 版(另提供 MVC 版)
RPCApache Dubbo 3.3.6服务间调用,端口从 20880 自增
认证Sa-Token + JWTToken 签发与校验,支持二级认证
ORMMyBatis-Plus分页、多租户、数据权限、乐观锁插件
多数据源dynamic-datasource异构数据库、spel 动态切换
缓存 / 锁Redis + Redisson分布式缓存、分布式锁、限流队列
任务调度SnailJob超时自动交卷、统计定时重算
对象存储MinIO(S3 协议)试题附件、证书图、监考抓拍
事务Seata 2.6.0默认关闭,按需启用
工作流warm-flow国产工作流引擎

请求链路 ​

以「考生交卷」为例:

text
浏览器
  │ POST /prod-api/answer/record/{id}/submit
  ▼
Nginx ── 剥掉 /prod-api 前缀 ──▶ Gateway :8080
                                  │ ① Sa-Token 校验
                                  │ ② 路由匹配 /answer/**,StripPrefix=1
                                  │ ③ 转发 lb://ruoyi-exam-answer/record/{id}/submit
                                  ▼
                          exam-answer :9214
                            │ ④ 幂等校验(是否重复提交)
                            │ ⑤ 客观题自动判分
                            │ ⑥ ─Dubbo─▶ exam-mark     同步主观题阅卷任务
                            │ ⑦ ─Dubbo─▶ exam-practice 错题入错题本
                            │ ⑧ ─Dubbo─▶ exam-proctor  结束监考会话
                            │ ⑨ ─Dubbo─▶ exam-cert     及格则颁发证书
                            ▼
                          写入 ry-exam-answer 库

为什么这么拆 ​

拆分决策理由
exam-answer 独立成库唯一高并发写场景;将来可单独按 exam_id 分库分表
exam-stat 独立服务重查询会拖垮 OLTP;用预聚合表隔离负载
exam-proctor 独立服务写多读多(事件流水 + 抓拍),与主流程解耦,挂了不影响答题
exam-cert 独立服务发证要等阅卷完成,异步触发,天然适合独立
其余按领域边界拆每个服务对应考试全链路的一个环节

依赖方向严格单向

question ← paper ← manage ← answer ← mark,stat 旁路只读。 禁止反向调用,这是这套微服务能单独扩容的前提。 详见 服务间调用。

服务端口全景 ​

完整清单见 服务清单与端口,这里只给概览:

text
8080  gateway          网关
9210  auth             认证中心
9201  system           系统管理
9202  gen              代码生成
9203  job              定时任务
9204  resource         文件/OSS/短信
9205  workflow         工作流

9211  exam-question    题库
9212  exam-paper       试卷
9213  exam-manage      考试管理
9214  exam-answer      答题(独立库)
9215  exam-mark        阅卷
9216  exam-stat        统计
9217  exam-practice    错题本
9218  exam-cert        证书
9219  exam-proctor     防作弊
9220  exam-ai          AI 网关
9221  exam-agent       Python AI(不经网关)

9100  monitor          监控中心
8800  snailjob-server  调度中心
8848  nacos            注册配置中心

高可用建议 ​

组件生产建议
Gateway≥ 2 实例 + Nginx 负载均衡
exam-answer≥ 2 实例(考试期唯一高并发写服务)
exam-stat≥ 2 实例(重查询隔离)
Nacos集群部署,见 Nacos 集群搭建
Redis哨兵或集群模式
MySQL主从;ry-exam-answer 量大后可上 ShardingSphere
MinIO多机多盘,配抓拍生命周期策略

下一步 ​

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