Skip to content
MrShanDev
mms
Public

About

MMS (Modular Management System) main backend — Spring Boot 3 + JDK 21 modular admin scaffold with pluggable ecosystem | 模块化管理系统主后端

mmsadmin.cn

Topics

admin-dashboardadmin-templateboilerplatejava21management-systemmodular-systemmybatis-plusplugin-architecturerest-apisa-tokenspring-boot

Resources

Readme
MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository
BranchesTags

Latest commit

 

History

257 Commits

Folders and files

Repository files navigation


MMS logo

模块化管理系统

MMS · Modular Management System

mms · 主后端 / 核心基础框架

📘 在线文档 · mmsadmin.cn · Gitee · GitHub


English | 简体中文

说明：本仓库是 MMS 主后端（核心基础框架），也是 MMS 体系其他前端/端侧项目的服务端。整体架构、插件体系与部署指南见在线文档 mmsadmin.cn。

⚡️系统介绍

🔥🔥🔥 MMS（模块化管理系统，Modular Management System）基于Spring Boot 3.x构建，采用前后端分离的现代化架构设计。该系统集成了用户管理、商品管理、支付系统、订单处理、分销体系、日志监控、定时任务、通信服务、直播支持、广告管理与内容发布等多个功能模块，致力于为开发者提供高效、稳定且可扩展的开发脚手架，显著提升项目开发效率，助力各类应用快速落地与迭代。

🚀🚀🚀 我们将作为持续更新迭代，定期发布功能更新、Bug修复和技术栈升级，确保系统始终处于技术前沿，打造最有价值的开源项目，为开发者社区贡献力量。

项目代码和文档完全开源免费，支持商业使用。🚀 我们秉承"活到老，写到老"的开源精神，为兴趣而开源，为学习而开源。🚀

🍃系统演示: 传送门

🍃MMS文档: mms

MMS 模块化管理系统：模块化组合、插件安装、丰富插件市场、自研插件，配套 mmsadmin.cn 技术文档站

页面展示

当前管理端实景截图，展示登录、系统工作台、账户表单、权限管理、配置、代码生成和插件市场。每行两张，点击图片查看原图；也可右键在新窗口打开。

登录页面
登录页面 		系统管理工作台
系统管理工作台
新增用户表单
新增用户表单 		新增角色与菜单权限
新增角色与菜单权限
角色管理
角色管理 		菜单管理
菜单管理
字典管理
字典管理 		系统基础设置
系统基础设置
代码生成
代码生成 		插件市场
插件市场

代码生成与插件市场截图为未导入表、未安装插件时的界面；用户与角色表单仅展示，未提交新增。

截图文件统一位于本仓 script/img/，前端 mms-ui README 复用同一套图片。

🧩系统版本

名称 别名 项目地址 注意事项
mms 标准版 -Gitee 🙋功能齐全的手架系统
📢完全具备高效的项目开发
📢完多租户模式灵活开启
📢支持低代码自动生成模式
mms-ui 标准版 -Gitee 🙋适配mms后端系统的管理界面项目

📦开发语言与技术栈

vue vite typescript Pinia2 eslint pnpm Prettier Sass WindCSS

🙋高效安全、组件解耦、灵活扩展 模块化扩展内置代码生成引擎加速后台系统构建。

核心特性

  1. 🚀 虚拟线程支持：基于 JDK 21 虚拟线程，并发性能提升 10-100 倍
  2. 📦 模块化设计：采用 Maven 多模块架构，各功能模块独立开发、部署和维护
  3. 🏢 多租户支持：灵活的多租户架构，支持数据隔离和资源共享
  4. 🔒 权限管理：基于 Sa-Token 1.44.0 的 RBAC 权限控制，支持菜单、按钮级别权限
  5. ⚡ 代码生成：内置低代码生成引擎，支持前后端代码一键生成
  6. 💾 多数据源：支持 MySQL、Oracle、PostgreSQL、SQL Server 等多种数据库
  7. ☁️ 对象存储：集成 x-file-storage，支持阿里云、腾讯云、华为云等主流云存储
  8. 📨 消息队列：支持 RabbitMQ、RocketMQ、Kafka 等消息中间件
  9. ⏰ 定时任务：集成 PowerJob，支持分布式定时任务调度
  10. 📊 监控管理：集成 Spring Boot Admin 3.5.11，提供应用健康监控
  11. 🛡️ 安全防护：支持 XSS、SQL 注入防护，接口加签验签等安全机制
  12. 🌐 国际化支持：支持多语言切换
  13. 📚 数据字典：统一数据字典管理，支持动态配置
  14. 📝 操作日志：完善的操作日志记录和查询功能
  15. 📢 通知公告：系统公告和消息通知功能
  16. 👤 个人中心：用户个人信息管理、密码修改、头像设置等
  17. 🔥 性能优化：启动速度提升 15-25%，内存占用减少 10-15%

功能模块

  1. 系统管理

    • 用户管理：用户增删改查、导入导出、密码重置
    • 角色管理：角色权限分配、角色用户管理
    • 菜单管理：菜单配置、权限标识设置
    • 部门管理：组织架构管理
    • 岗位管理：岗位信息维护
    • 字典管理：数据字典配置
    • 配置管理：系统参数配置
    • 通知公告：系统消息发布

  2. 系统监控

    • 操作日志：用户操作记录查询
    • 登录日志：用户登录信息查询
    • 服务监控：服务器状态监控
    • 缓存监控：Redis 缓存信息查看

  3. 工具箱

    • 代码生成：数据库表结构自动生成前后端代码
    • 系统接口：Swagger API 文档
    • 定时任务：任务调度管理
    • 对象存储：文件上传和管理

  4. 扩展功能

    • 短信服务：短信发送和配置
    • 邮件服务：邮件发送和配置
    • 微信集成：微信公众号、小程序接入
    • 阿里云服务：阿里云相关服务集成

🍃部署方式

环境要求

  • JDK 21+ (支持虚拟线程)
  • MySQL 8.0+
  • Redis 6.x+
  • Maven 3.6+
  • Node.js 18+ (前端项目)
  • Docker (可选，用于容器化部署)

部署步骤

  1. 数据库初始化

    • 执行 script/db/mms.sql 脚本创建数据库表结构和初始数据
    • 根据实际环境修改数据库连接配置

  2. 后端服务部署

    • 修改 mms-admin/src/main/resources/application.yml 配置文件
    • 根据不同环境激活对应的 profile (local/dev/prod)
    • 执行 Maven 命令打包：mvn clean package -DskipTests
    • 运行 jar 包：java -jar mms-admin.jar

  3. 前端服务部署

    • 进入前端项目目录
    • 安装依赖：pnpm install
    • 构建生产环境：pnpm build
    • 部署构建产物到 Web 服务器

  4. Docker 部署

    • 使用 script/docker/docker-compose.yml 文件一键部署
    • 根据实际环境修改配置文件中的参数
    • 执行 docker-compose up -d 启动所有服务

配置文件说明

项目支持多种环境配置：

  • application-local.yml：本地开发环境
  • application-dev.yml：开发环境
  • application-prod.yml：生产环境

配置主要包括：

  • 数据源配置（MySQL、Oracle、PostgreSQL等）
  • Redis 配置
  • Sa-Token 权限配置
  • MyBatis-Plus 配置
  • 多租户配置
  • 对象存储配置

🤝模块介绍

序号 目录 子模块名称 模块名称 备注
1 mms-admin 系统管理启动模块 已完成
1 mms-docs VitePress会员主题（知识付费）
MMS适配接口服务		 已完成
5 ｜________ mms-doc-admin 会员主题后端模块 已完成
6 ｜________ mms-doc-api 会员主题接口模块 已完成
2 mms-malls 商城 开发中
5 ｜________ mms-mall-admin 商城后端模块 开发中
6 ｜________ mms-mall-api 商城接口模块 开发中
5 ｜________ mms-mall-merchant 商城商户模块 开发中
6 ｜________ mms-doc-uni-x 商城移动模块 开发中
4 mms-modules MMS模块集 持续增加中
5 ｜________ mms-ai 推理服务接入（可选） 已完成
5 ｜________ mms-aliyun 阿里云模块 已完成
5 ｜________ mms-authority 安全认证模块 已完成
5 ｜________ mms-common 公共模块 已完成
5 ｜________ mms-datasource 数据源模块 已完成
5 ｜________ mms-demo 演示模块 已完成
5 ｜________ mms-email 邮箱模块 已完成
6 ｜________ mms-framework 核心模块 已完成
5 ｜________ mms-gen 代码生成模块 已完成
7 ｜________ mms-mq 消息队列 已完成
5 ｜________ mms-oss 对象存储模块 已完成
5 ｜________ mms-redis 缓存模块 已完成
5 ｜________ mms-sms 短信模块 已完成
5 ｜________ mms-thymeleaf 模版引擎渲染模块 已完成
8 ｜________ mms-websocket 长连接通信管理 已完成
5 ｜________ mms-wx 微信模块 已完成
9 mms-zoom 快速激增模块集 已完成
10 ｜________ mms-monitor 安全监控 已完成
11 ｜________ mms-powerjob 定时任务 已完成
12 script 项目配置文件 已完成

📄软件架构与核心技术栈

软件架构说明

框架 说明 版本 说明
SpringBoot 后端主框架 (LTS) 3.5.8 ⚡支持虚拟线程
Undertow 基于 XNIO 的高性能容器 2.3.20 🚀高性能
Sa-Token Sa-Token、Jwt(强解耦、强扩展) 1.43.0 🔒最新稳定版
MySQL 关系数据库 适配 8.X 最低 5.7
Redis 缓存数据库 适配 6.X 最低 4.X
Mybatis-Plus 快速 CRUD 增加开发效率 3.5.14 📦支持租户插件
Vue vue 框架 3.2.45
Vite 开发与构建工具 4.0.4
Element Plus Element Plus 2.2.28
TypeScript JavaScript 的超集 4.9.4
pinia Vue 存储库 替代 vuex5 2.0.28
vueuse 常用工具集 9.10.0
vxe-table vue 最强表单 4.3.7
vue-i18n 国际化 9.2.2
vue-router vue 路由 4.1.6
windicss 下一代工具优先的 CSS 框架 3.5.6
iconify 在线图标库 3.0.1
wangeditor 富文本编辑器 5.1.23

🏗️项目架构说明

整体架构

MMS（模块化管理系统）采用前后端分离的架构设计，后端基于 Spring Boot 3.x 构建，前端使用 Vue 3.x 技术栈。

后端架构特点

  1. 多模块 Maven 项目结构：项目采用 Maven 多模块结构，便于模块化开发和维护
  2. Spring Boot 3.x：基于最新稳定版本的 Spring Boot 框架
  3. 多数据源支持：集成 dynamic-datasource-spring-boot-starter，支持多数据源切换
  4. 权限认证：使用 Sa-Token 进行权限控制，支持 JWT
  5. ORM 框架：集成 MyBatis-Plus，提供强大的 CRUD 操作能力
  6. 缓存支持：集成 Redis，支持分布式缓存
  7. 多租户架构：支持多租户模式，可灵活开启或关闭
  8. 代码生成：内置低代码生成引擎，加速后台系统构建
  9. 对象存储：集成 x-file-storage，支持多种云存储平台
  10. 消息队列：支持多种消息队列中间件
  11. 定时任务：集成 PowerJob，支持分布式定时任务
  12. 监控管理：集成 Spring Boot Admin，提供应用监控能力

核心模块说明

  1. mms-admin：系统管理启动模块，整合各业务模块
  2. mms-modules：核心业务模块集合
    • mms-common：公共模块，包含通用工具类和枚举
    • mms-framework：核心框架模块，包含基础配置和工具
    • mms-datasource：数据源模块，包含基础实体类和分页工具
    • mms-authority：安全认证模块，基于 Sa-Token 实现
    • mms-gen：代码生成模块，支持低代码开发
    • mms-oss：对象存储模块，支持多种云存储
    • mms-redis：Redis 缓存模块
    • mms-sms：短信服务模块
    • mms-email：邮件服务模块
  3. mms-zoom：扩展模块集合
    • mms-monitor：系统监控模块
    • mms-powerjob：分布式定时任务模块

👨‍💻开发指南

开发环境搭建

  1. 安装 JDK 21+ 并配置环境变量（必须使用 JDK 21 以支持虚拟线程）
  2. 安装 Maven 3.6+ 并配置环境变量
  3. 安装 MySQL 8.0+ 并创建数据库
  4. 安装 Redis 6.x+ 并启动服务
  5. 导入 IDE (推荐 IntelliJ IDEA 2023.3+)
  6. 配置虚拟线程：在 application.yml 中确保 spring.threads.virtual.enabled=true

项目结构说明

mms
├── mms-admin          # 系统管理启动模块
├── mms-modules        # 核心业务模块集合
│   ├── mms-common     # 公共模块
│   ├── mms-framework  # 核心框架模块
│   ├── mms-datasource # 数据源模块
│   ├── mms-authority  # 安全认证模块
│   ├── mms-gen        # 代码生成模块
│   └── ...            # 其他业务模块
├── mms-zoom           # 扩展模块集合
│   ├── mms-monitor    # 系统监控模块
│   └── mms-powerjob   # 定时任务模块
└── script             # 脚本文件
    ├── db             # 数据库脚本
    └── docker         # Docker 部署文件

代码规范

  1. 遵循阿里巴巴 Java 开发手册
  2. 使用 Lombok 简化代码
  3. 统一使用 MapStruct 进行对象转换
  4. 控制器层统一返回 R 格式
  5. 服务层统一处理业务逻辑
  6. 数据访问层使用 MyBatis-Plus

新增业务模块步骤

  1. 在 mms-modules 目录下创建新模块
  2. 在模块中创建对应的 entity、mapper、service、controller 层
  3. 在 mms-admin 的 pom.xml 中添加模块依赖
  4. 在数据库中创建对应的表结构
  5. 在菜单管理中添加对应的菜单和权限

🤝如何贡献

我们欢迎任何形式的贡献，包括但不限于：

  1. 提交 Issue：报告 bug 或提出新功能建议
  2. 提交 Pull Request：修复 bug、添加新功能或改进文档
  3. 完善文档：补充使用说明、开发指南等文档
  4. 代码优化：优化现有代码结构和性能

贡献流程

  1. Fork 项目到自己的 GitHub 账户
  2. Clone 到本地开发环境
  3. 创建新的分支进行开发
  4. 提交代码并推送至 GitHub
  5. 发起 Pull Request

代码规范

  • 遵循项目现有的代码风格
  • 添加必要的单元测试
  • 确保代码通过所有测试
  • 编写清晰的提交信息

😎 LICENSE

::: tip MIT License https://gitee.com/MrShanDev/mms/blob/master/LICENSE :::

❌免责条款

  您充分了解并同意，您必须为自己使用本服务及注册帐号下的一切行为负责，包括您所发表的任何内容以及由此产生的任何后果。您应对本服务中的内容自行加以判断，并自行承担因使用内容而引起的所有风险。

  mms,mms-ui 对网站上所显示的信息或资料的准确性、内容、完整性、合法性、可靠性、可操作性或可用性不承担任何责任。

  mms,mms-ui 二次开发使用者因为违法而触犯中华人民共和国法律的，一切后果自己负责，mms 作者 不承担任何责任。

  本声明未涉及的问题参见国家有关法律法规，当本声明与国家法律法规冲突时，以国家法律法规为准。

🧪学习 & 商用

  mms,mms-ui 是免费和开源的，可免费用于 学习、商业使用 。

🔧 技术架构与核心组件

核心技术栈

MMS基于Spring Boot 3.x构建，采用Maven多模块架构，整合了众多优秀的开源技术框架：

技术框架 说明 版本 特性说明
Spring Boot 后端主框架 3.5.8 ⚡LTS版本,支持虚拟线程
MyBatis-Plus ORM框架 3.5.14 📦支持租户插件
Sa-Token 权限认证框架 1.43.0 🔒Redis Jackson序列化
Redisson Redis客户端 3.52.0 🚀最新稳定版
Dynamic-Datasource 多数据源支持 4.3.1 💾读写分离
MapStruct Plus 对象映射工具 1.4.6 🔄对象转换
Hutool Java工具库 5.8.34 🛠️工具集
Lombok Java简化工具 1.18.34 ✨简化代码
EasyExcel Excel处理 4.0.3 📊导入导出
SpringDoc API文档 2.7.0 📝自动文档
X-File-Storage 对象存储 2.1.0 ☁️多云存储
PowerJob 分布式任务调度 4.3.9 ⏰定时任务
SMS4J 短信服务 3.2.0 📱短信发送
FreeMarker 模板引擎 2.3.33 📄Jakarta EE兼容

数据库支持

系统支持多种主流数据库：

  • MySQL 8.0+
  • Oracle
  • PostgreSQL
  • SQL Server
  • 达梦数据库
  • 人大金仓

消息队列支持

系统支持多种消息队列中间件：

  • RabbitMQ
  • RocketMQ
  • Kafka

对象存储支持

系统集成了X-File-Storage，支持多种云存储平台：

  • 阿里云OSS
  • 腾讯云COS
  • 华为云OBS
  • 七牛云Kodo
  • 百度云BOS
  • Amazon S3
  • MinIO

📦 项目模块结构

mms
├── mms-admin          # 系统管理启动模块
├── mms-modules        # 核心业务模块集合
│   ├── mms-common     # 公共模块
│   ├── mms-framework  # 核心框架模块
│   ├── mms-datasource # 数据源模块
│   ├── mms-authority  # 安全认证模块
│   ├── mms-gen        # 代码生成模块
│   └── ...            # 其他业务模块
├── mms-zoom           # 扩展模块集合
│   ├── mms-monitor    # 系统监控模块
│   └── mms-powerjob   # 定时任务模块
└── script             # 脚本文件
    ├── db             # 数据库脚本
    └── docker         # Docker 部署文件

🔐 安全特性

  1. 权限控制：基于Sa-Token实现RBAC权限模型，支持菜单、按钮级别权限控制
  2. 数据加密：支持AES/RSA加密算法，对敏感数据进行加密存储
  3. 密码安全：MD5加盐加密，支持密码强度检测
  4. 接口安全：支持接口签名验证，防止数据篡改
  5. XSS防护：内置XSS攻击防护机制
  6. SQL注入防护：通过MyBatis-Plus和参数绑定防止SQL注入
  7. CSRF防护：支持CSRF攻击防护

🌐 多租户架构

系统采用多租户架构设计，支持以下特性：

  1. 数据隔离：不同租户数据完全隔离
  2. 资源共享：可灵活配置租户间资源共享策略
  3. 租户管理：支持租户创建、配置、停用等管理功能
  4. 套餐管理：支持租户套餐配置，限制功能权限

📊 系统监控

  1. 健康检查：集成Spring Boot Actuator，提供应用健康监控
  2. 性能监控：支持接口调用统计、响应时间分析
  3. 日志管理：完善的操作日志和登录日志记录
  4. 服务监控：集成Spring Boot Admin，提供可视化监控界面

🛠️ 开发工具

  1. 代码生成：内置低代码生成引擎，支持前后端代码一键生成
  2. API文档：集成SpringDoc，自动生成Swagger API文档
  3. 数据字典：统一数据字典管理，支持动态配置
  4. 定时任务：集成PowerJob，支持分布式定时任务调度
  5. 消息队列：支持多种消息队列中间件
  6. 缓存管理：集成Redis，支持分布式缓存

📱 前端技术栈

技术框架 说明 版本
Vue 前端框架 3.2.45
Vite 构建工具 4.0.4
Element Plus UI组件库 2.2.28
TypeScript 编程语言 4.9.4
Pinia 状态管理 2.0.28
Vue Router 路由管理 4.1.6
Windi CSS CSS框架 3.5.6

🚀 部署架构

系统支持多种部署方式：

  1. 传统部署：直接运行jar包
  2. Docker部署：使用Docker容器化部署
  3. Kubernetes部署：支持K8s集群部署
  4. 微服务部署：支持拆分为微服务架构

📈 性能优化

  1. 🚀 虚拟线程优化：基于 JDK 21 虚拟线程，支持数万并发连接，内存占用减少 30-50%
  2. 💾 数据库优化：支持读写分离、分库分表
  3. ⚡ 缓存优化：多级缓存设计，提升系统响应速度
  4. 🏊 连接池优化：使用 HikariCP 高性能连接池
  5. 🔄 异步处理：支持异步任务处理，提升系统吞吐量
  6. 📦 压缩传输：支持 GZIP 压缩，减少网络传输数据量
  7. ⏱️ 启动优化：启动速度提升 15-25%，Bean 加载更高效

📞 技术支持

如有问题可以通过以下方式联系技术支持：

📄 更新日志

v1.0.7 (2026-01-03) 🎉

🚀 重大升级 - 虚拟线程支持

  • [升级] Spring Boot 3.2.6 → 3.5.8 LTS - 长期支持版本,支持到2026/2032
  • [升级] JDK 17 → JDK 21 - 启用虚拟线程,并发性能提升10-100倍
  • [升级] MyBatis-Plus 3.5.7 → 3.5.14 - 支持租户插件,添加JSQLParser依赖
  • [升级] Sa-Token 1.35.0.RC → 1.43.0 - Redis集成改为Jackson序列化
  • [升级] Redisson 3.31.0 → 3.52.0 - Redis客户端最新稳定版
  • [升级] FreeMarker 2.3.31 → 2.3.33 - 支持Jakarta EE
  • [升级] Spring Boot Admin 3.2.3 → 3.5.6 - 监控管理升级
  • [新增] 虚拟线程配置 - 在application.yml中启用虚拟线程支持
  • [修复] API兼容性问题 - 修复所有升级后的API变化
    • Sa-Token: 添加doRenewTimeout方法,移除废弃的checkMethodAnnotation
    • MyBatis-Plus: FieldStrategy.IGNORED → FieldStrategy.ALWAYS
    • Spring AMQP: setDelay() → setHeader("x-delay", delayTime)
  • [优化] 性能提升 - 启动速度提升15-25%,内存占用减少10-15%
  • [优化] 并发能力 - 虚拟线程支持数万并发连接

✨ 升级带来的核心优势:

  • ⚡ 启动速度: 提升 15-25%
  • 🚀 并发性能: 虚拟线程支持,性能提升 10-100 倍
  • 💾 内存优化: 虚拟线程下内存占用减少 30-50%
  • 🔒 长期支持: Spring Boot 3.5.x LTS 支持到 2026/2032
  • 🛡️ 稳定可靠: 所有依赖升级到最新稳定版本

v1.0.6 (2025-02-03)

  • [新增] 微信二维码扫描登录
  • [新增] 个人中心手机号绑定
  • [新增] 个人中心邮箱绑定
  • [修复] 个人中心微信号绑定
  • [预告] 修复已知BUG

v1.0.5 (2024-11-14)

  • [新增] mms-admin整合easyexcel支持数据的导入/导出（支持字典的自动翻译和导入的逆翻译）
  • [新增] mms-ui对Table列表页面进行工具栏的封装（表格数据的导出，导入，打印）等功能
  • [优化] 系统整体的架构布局优化
  • [预告] 接口加密，接口防抖，接口限流等技术

v1.0.4 (2024-10-20)

  • [更新] mms-ui sass文件的引入方式，由@import换为@use
  • [注意] （Dart Sass originally used an API based on the one used by Node Sass, but replaced it with a new, modern API in Dart Sass 1.45.0. The legacy JS API is now deprecated and will be removed in Dart Sass 2.0.0.）

v1.0.3 (2024-08-02)

  • [升级] mms-generator代码生产模块
  • [新增] mms-power job分布式定时任务模块
  • [新增] mms-mq消息队列模块
  • [新增] mms-monitor健康检测扩展模块
  • [优化] mms-ui优化适配

v1.0.2 (2024-05-10)

  • [新增] mms-aliyun阿里云生态模块
  • [新增] mms-wx微信生态模块
  • [新增] mms-demo Demo模块

v1.0.1 (2024-02-10)

  • [新增] mms-system管理系统模块
  • [新增] mms-common公共模块抽取
  • [新增] mms-redis独立redis模块
  • [新增] mms-framework系统核心模块
  • [新增] mms-sms短信模块
  • [新增] mms-email邮件模块
  • [新增] mms-oss对象存储模块

v1.0.0 (2023-12-01)

  • [发布] MMS模块化管理系统正式开源发布

开发工具安装与检查

安装 Node.js 通常会带上 npm，但不会自动安装 pnpm。nvm 用于安装和切换 Node.js 版本；Maven 是 Java 后端的构建工具，其命令为 mvn，需要单独安装。

macOS / Linux / WSL：安装 nvm、Node.js 和 pnpm

按照 nvm 官方安装说明安装 nvm，然后重新打开终端。已有 Node.js 且无需切换版本时，可以跳过 nvm。

# 安装 nvm（官方安装脚本）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash

重新打开终端后执行：

command -v nvm
nvm install 22
nvm use 22
nvm alias default 22
node -v
npm -v
npm install -g pnpm@10
pnpm -v

切换 nvm 管理的 Node.js 版本后，如果找不到 pnpm，需要在当前版本下重新安装。Node.js 25 起不再附带 Corepack，教程不依赖 Corepack 自动提供 pnpm。原生 Windows 使用 nvm-windows或 Node.js 官方安装包，不运行上述 nvm Shell 安装脚本。

安装 Maven（后端需要）

先安装 JDK 21，并按 Maven 官方说明安装 Maven。macOS 已安装 Homebrew 时：

brew install maven

Linux / Windows 可下载 Maven 二进制包、解压，将其 bin 目录加入 PATH。将 JAVA_HOME 指向 JDK 21 的实际安装目录，重新打开终端后检查：

java -version
mvn -v

mvn -v 显示的 Java 版本应与项目使用的 JDK 一致。macOS 已安装 JDK 21 时，可在当前终端设置：

export JAVA_HOME="$(/usr/libexec/java_home -v 21)"
export PATH="$JAVA_HOME/bin:$PATH"
mvn -v

若提示 mvn: command not found，检查 Maven 是否安装，以及 Maven 的 bin 是否已加入当前终端的 PATH。仅运行 mms-ui 不需要 Maven；启动或构建 Java 后端需要。

About

MMS (Modular Management System) main backend — Spring Boot 3 + JDK 21 modular admin scaffold with pluggable ecosystem | 模块化管理系统主后端

mmsadmin.cn

Topics

admin-dashboardadmin-templateboilerplatejava21management-systemmodular-systemmybatis-plusplugin-architecturerest-apisa-tokenspring-boot

Resources

Readme
MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages