Skip to content

技术栈 ​

后端 ​

类别选型版本
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
对象存储MinIO(AWS S3 SDK)SDK 2.28.22
短信sms4j3.3.5
第三方登录JustAuth1.16.7
工具库Hutool5.8.43
连接池HikariCP—
数据库连接监控p6spy3.9.1
Web 容器Undertow—
构建Maven + flatten-maven-plugin3.8+

前端 ​

类别选型版本
框架Vue3.5.30
语言TypeScript~5.9.3
UI 组件库Element Plus2.13.5
构建Vite7.3.2
状态管理Pinia3.0.4
路由Vue Router5.0.3
HTTPAxios1.13.6
CSSUnoCSS(非 Tailwind)66.6.6
富文本@vueup/vue-quill1.2.0
图表ECharts6.0.0
复杂表格vxe-table4.18.1
组合式工具@vueuse/core14.2.1
国际化vue-i18n11.3.0
加密jsencrypt / crypto-js3.5.4 / 4.2.0
文件下载file-saver2.0.5
全屏screenfull—
代码高亮highlight.js—
单元测试Vitest4.0.18
Node≥ 20.19—
npm≥ 8.19—

UnoCSS 不是 Tailwind

改样式前先确认这一点。项目用 uno.config.ts 配置,预设了 presetUno、presetAttributify、presetIcons、presetTypography。 业务侧大量使用原子类(class="p-[16px]" flex items-center gap-2),习惯了传统 SCSS 的同学会有点不适应。

基础设施 ​

组件版本用途
MySQL8.0.42主数据库(5 个库)
Redis7.2.8缓存、分布式锁、会话
Nacos2.6.2注册 + 配置中心
MinIORELEASE.2026-02-14对象存储
Nginx1.22.1静态托管 + 反代
Seata2.6.2分布式事务(可选)
Elasticsearch7.17.6日志检索(可选)
SkyWalking9.7.0链路追踪(可选)
Prometheus + Grafanav2.40.1 / 9.2.4指标监控(可选)
ShardingSphere-Proxy5.4.0分库分表(可选)
Kafka / RocketMQ / RabbitMQ3.9.1 / 5.2.0 / 3.13.3消息队列(可选)

AI 侧 ​

Python Agent 独立部署,不进 Maven 构建。

组件说明
FastAPIHTTP 服务框架
LangChainLLM 编排
Nacos SDK注册到 Nacos,供 Java 侧发现

环境变量:

bash
AGENT_PORT=9221
AGENT_NACOS_SERVER=127.0.0.1:8848
AGENT_NACOS_NAMESPACE=dev
AGENT_LLM_BASE_URL=<大模型地址>
AGENT_LLM_API_KEY=<密钥>
AGENT_LLM_MODEL=qwen-plus

AI 尚未与 Java 接线

四类能力(出题 / 阅卷 / 推荐 / 试卷分析)已在 Python 侧实现,但 Java 网关还没接上, 当前 AI 阅卷返回「未接入」。

数据库拆分 ​

text
ry-cloud          系统基础(用户/角色/菜单/字典/租户/AI 模型配置)
ry-exam           考试主库(29 张表)
ry-exam-answer    答卷成绩库(2 张表,高并发大表)
ry-config         Nacos 配置库
ry-job            SnailJob 任务库
ry-workflow       工作流库

详见 数据库初始化。

与旧版对比 ​

项旧版 old-exam新版 exam-platform
架构单体 Spring Boot 2.x微服务 RuoYi-Cloud-Plus
后端Spring Boot 2.x + MyBatis-Plus + Druid + Fastjson + EasyExcelSpring Boot 3.5 + MyBatis-Plus + HikariCP + Jackson + FastExcel
RPC无Apache Dubbo 3.3.6
前端Vue 2Vue 3 + TypeScript + Element Plus + Vite
状态已上线🚧 开发中

下一步 ​

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