Skip to content

Sz-Admin

v2.0.0

Sz-Admin 是一套面向中后台项目的开源工程底座,从本地启动到业务扩展都尽量少绕路。权限、菜单、字典、日志、代码生成、数据库迁移和部署等常见环节已经预置,团队可以更快进入业务开发。

当前主线基于 Spring Boot 4、JDK 21、Vue 3 和 Vite 7,后端以 sz-common / sz-module / sz-service 划分边界,前端通过 edition 与模块注册组合能力,支撑长期维护、存量升级和独立模块接入。

Spring Boot 4JDK 21Vue 3Vite 7MyBatis-FlexSa-Token
设计取向

在好上手的基础上,把扩展和维护边界理清楚

01

上手成本可控

保留 RBAC、在线预览、代码生成和常规后台操作,让新项目能先跑起来,再逐步接入业务。

02

模块边界清晰

公共能力、业务模块和启动服务各自归位,核心工程和业务扩展更容易分开维护。

03

升级路径清楚

Liquibase、数据权限和前端模块注册都有明确边界,存量项目演进时更容易评估影响。

能力地图

后台系统常用能力,按更清晰的维护边界组织

权限

RBAC 与动态路由

用户、角色、菜单、按钮权限与前端路由联动,覆盖基础授权流程。

审计

操作、性能与异常日志

记录操作人、接口、耗时、结果和异常堆栈,支持排查与追踪。

数据

系统角色数据权限

数据范围随系统角色维护,菜单开启后即可配置可见边界。

字典

字典来源治理

用 sys_dict_source / source_code 区分内置、业务和派生模块字典。

生成

代码生成器

表结构读取、字段配置、代码预览、菜单初始化和迁移脚本生成。

接口

API 前缀拆分

管理端与生成器调用分离,前端通过专用 HTTP 实例维护边界。

资源

上传与实时能力

上传资源按 sceneCode 管理,WebSocket 承载消息推送与连接状态。

导入导出

Excel 导入导出

基于 FastExcel,支持字典格式化、合并单元格、模板和失败记录。

稳定性

接口防抖与防重

全局配置结合注解,按用户与接口维度减少误触和重复提交。

为什么选择

让后台项目更容易启动、扩展和长期维护

边界

模块边界清晰

公共能力、业务模块和启动服务各自归位,业务扩展不必混入核心代码,后续升级时也更容易控制影响范围。

权限

权限模型完整统一

用户、角色、菜单、按钮权限与数据范围在同一授权链路中维护,功能权限和数据边界更容易保持一致。

迁移

数据库变更可追踪

Liquibase 按模块组织 changelog,并兼顾 MySQL 与 PostgreSQL,新项目初始化和存量升级都有清晰路径。

生成

生成器贴近落地

从表结构读取、字段配置到代码预览、菜单初始化和迁移脚本生成,减少重复工作,也保留手工调整空间。

部署与落地

从本地验证,到服务器部署都有对应支持

Sz-Admin 提供从开发环境到服务器运行的部署说明,覆盖外置配置、资源数据、日志目录、Docker Compose 编排和 GitHub Actions 自动发布等常见场景。Docker Compose 是新环境的推荐方式,传统 jar 部署作为基础模型保留。

生产配置隔离数据库、Redis、密钥等敏感配置外置管理,避免随应用包一起分发。
容器化快速部署Docker Compose 可编排数据库、Redis、后端、前端和代理服务。
自动化发布衔接GitHub Actions 可串联镜像构建、推送和远程发布流程。
界面预览

常用场景,一屏切换查看

覆盖工作台、账户配置、角色授权、字典维护、审计日志和代码生成等核心后台场景。

准备好体验 Sz-Admin 了吗?

四步走通:克隆仓库 → 配置数据库与 Redis → 启动后端 → 启动前端。

  • 后端克隆git clone https://github.com/feiyuchuixue/sz-boot-parent.git
  • 前端克隆git clone https://github.com/feiyuchuixue/sz-admin.git
  • 默认账号admin / sz123456 后端 :9991 · 前端 :9848