Java后台管理开源项目

企业级、可扩展、零门槛部署的Java后台管理系统源码,支持微服务架构与单体部署,内置RBAC权限模型、多租户支持、审计日志、工作流引擎等核心能力,助力开发者快速构建高可用、高扩展性系统。

查看功能 在线体验

核心功能模块

覆盖企业级后台管理全场景,模块解耦、可插拔,支持按需启用

⚡ 权限管理系统

基于RBAC(Role-Based Access Control)模型实现的权限框架,支持角色-权限-菜单三级联动控制。提供细粒度按钮级权限校验能力,支持数据权限动态过滤(如部门级、个人级、自定义SQL条件)。内置权限审计功能,可追溯权限变更历史。

典型应用场景:多角色协同办公系统、SaaS平台租户权限隔离、跨部门数据安全管控。

⚙️ 多租户架构支持

提供两种租户隔离方案:数据库级隔离(独立Schema)与数据级隔离(共享库+tenant_id字段)。支持动态租户注册、租户配额管理、租户定制化主题配置。内置租户生命周期管理,支持试用期转正式、自动停服等策略。

技术实现:Spring AOP租户上下文注入、MyBatis插件动态SQL改写、Redis缓存隔离。

📋 审计日志中心

自动记录用户操作行为(增删改查)、登录登出、异常堆栈等关键事件。支持按操作人、操作时间、操作模块多维检索。日志数据可导出为CSV/PDF,满足ISO 27001合规要求。支持自定义日志模板与敏感字段脱敏规则。

日志字段示例:操作IP(支持GeoIP定位)、设备指纹、请求参数快照、响应耗时、业务主键值。

📊 数据可视化平台

集成ECharts/Chart.js实现数据大屏与管理看板。提供拖拽式看板设计器,支持自定义KPI指标、趋势图、热力图等12种图表类型。支持定时数据刷新与数据源直连(JDBC/REST API)。

示例模块:用户增长趋势、系统资源占用、API调用热力、操作异常分布。

🔄 工作流引擎

基于Activiti7封装的轻量级流程引擎,支持BPMN 2.0标准流程定义。提供可视化流程设计器,支持会签、或签、条件分支、子流程嵌套。集成消息通知(站内信/邮件/企业微信)与超时自动处理机制。

典型流程:请假审批(支持多级审批+加签)、采购申请(含预算校验)、合同用印(电子签章集成)。

📱 响应式前端框架

采用Vue3 + Vite + Pinia构建的PWA应用,支持离线访问与热更新。提供暗黑模式、响应式布局(支持PC/平板/手机)、无障碍访问(ARIA标签)。内置主题定制系统,支持CSS变量动态切换。

组件库:封装200+高频业务组件(表格筛选、表单联动、富文本编辑、拖拽排序等)。

技术架构全景

前后端分离、模块化设计,适配云原生与传统部署场景

〈后端技术栈〉

  • • Spring Boot 3.x:核心框架,提供自动配置与Starter机制
  • • Spring Security:安全认证模块,支持JWT/OAuth2.0/OpenID Connect
  • • MyBatis-Plus:ORM框架,提供代码生成器与条件构造器
  • • Redis:缓存与分布式锁,支持Redisson客户端
  • • RabbitMQ/Kafka:异步消息处理,用于日志异步写入与事件通知
  • • Quartz:定时任务调度,支持分布式任务集群部署
  • • MinIO/S3:对象存储,支持文件分片上传与CDN加速
  • • Dynamic Datasource:多数据源动态切换,支持读写分离

〈前端技术栈〉

  • • Vue 3.4+:响应式框架,采用Composition API
  • • Vite 5:构建工具,支持ESM热更新与按需编译
  • • Pinia:状态管理,替代Vuex提供更轻量API
  • • Element Plus:UI组件库,支持主题定制与TypeScript
  • • Vue Router:路由管理,支持动态路由与权限守卫
  • • axios:HTTP客户端,支持请求拦截与重试机制
  • • Mermaid:流程图渲染库,支持BPMN流程可视化

〈部署架构方案〉

部署模式 适用场景 资源要求 扩展性
单体部署(Standalone) 中小企业/内部系统 1台服务器(8C16G+) 水平扩展需集群化
微服务集群(Cloud) 大型平台/SaaS系统 K8s集群 + 分布式存储 高(支持动态扩缩容)
Docker容器化 快速交付/CI/CD 支持任意云平台 中(需编排工具)

功能演示中心

真实场景功能演示,支持在线体验与源码本地部署

登录认证
权限控制
工作流
数据看板

〔登录认证模块〕

采用JWT令牌机制实现无状态认证,支持账号密码、短信验证码、扫码登录三种方式。登录失败5次锁定账户30分钟,防止暴力破解。会话管理支持多端登录控制(PC/移动端/小程序),可强制下线指定会话。

典型登录流程:

  1. 用户提交凭证 → 服务端验证(密码哈希比对)
  2. 生成JWT(含用户ID/角色/权限集合) → 设置HttpOnly Cookie
  3. 前端存储Refresh Token → 实现自动续期(15分钟内有效)
  4. 后续请求携带Access Token → 网关校验 → 放行/拒绝

安全加固措施:

  • • 密码强度策略(大小写+数字+特殊字符,8位起)
  • • 登录IP白名单(支持租户级配置)
  • • 设备指纹绑定(防止Token盗用)
  • • 敏感操作二次验证(如修改密码需短信确认)

〔权限控制模块〕

实现四层权限体系:菜单权限(URL路径)、按钮权限(前端UI控件)、接口权限(后端API)、数据权限(行级数据过滤)。

数据权限示例:

〈销售部经理视角〉

可查看:本部门所有销售订单 + 下属销售员的订单

不可查看:其他部门订单(如市场部、客服部)

实现方式:在MyBatis SQL中动态注入WHERE条件 → AND department_id IN (SELECT child_dept_ids(#{deptId}))

权限变更流程:

  1. 管理员在后台修改角色权限 → 保存至数据库
  2. 触发权限变更事件 → 通过RabbitMQ广播通知
  3. 各服务节点监听事件 → 清除用户权限缓存(Redis)
  4. 下次请求时重新加载权限 → 实时生效(TTL=5秒)

〔工作流引擎模块〕

支持BPMN标准流程定义,提供可视化设计器与流程模拟器。典型流程:采购申请(含预算校验)→ 部门审批 → 财务复核 → 采购执行 → 入库验收。

关键特性:

  • • 条件分支:当申请金额>5万 → 自动触发财务审批
  • • 会签规则:需3人以上同意(支持按角色/人员配置)
  • • 超时处理:审批超24小时 → 自动转交上级审批
  • • 加签/减签:审批人可主动添加其他人员参与

流程引擎配置示例:

【采购申请流程】
节点1:发起人 → 自动跳转
节点2:部门经理审批
    条件:金额≤1万 → 通过
    条件:金额>1万 → 转财务部
节点3:财务复核(会签)
    规则:2人同意 + 预算充足 → 通过
节点4:采购执行 → 自动创建采购单

〔数据看板模块〕

提供拖拽式看板设计器,支持自定义指标与图表组合。内置10+模板(用户增长、系统监控、销售分析、运营日报)。

看板配置示例:

〈运营日报模板〉

  • • 用户增长(折线图):新增/活跃/留存
  • • 操作热力图(饼图):各模块点击分布
  • • API性能(折线图):平均响应时间/错误率
  • • 实时告警(列表):异常登录/权限越界

数据刷新策略:

  • • 实时数据:WebSocket推送(如告警、在线人数)
  • • 准实时数据:每5分钟轮询(如业务指标)
  • • 离线数据:定时任务生成(如月报)

快速上手指南

3步部署,10分钟启动开发环境

① 环境准备

• JDK 17+、Maven 3.8+、Node.js 18+、MySQL 8.0+、Redis 6.2+

• 推荐配置:8核16G内存、200GB SSD存储(开发环境可降至4C8G)

② 项目部署

• 克隆源码:git clone https://github.com/xservx/java-admin.git

• 修改配置文件:application-dev.yml(数据库/Redis/MinIO连接信息)

• 启动后端:mvn spring-boot:run -Dspring.profiles.active=dev

• 启动前端:npm install && npm run dev

• 访问地址:http://localhost:8080(默认账号:admin / 密码:admin123)

③ 开发指南

• 新增菜单:后台管理 → 系统管理 → 菜单管理 → 点击“新增” → 填写路径/图标/权限标识

• 添加API:在对应模块Controller添加接口,注解@RequiresPermissions("xxx:edit")即可启用权限校验

• 扩展表单:在Vue页面使用<el-form :model="formData">绑定数据,后端使用@RequestBody接收JSON参数

• 自定义数据权限:在Mapper XML中使用<if test="deptId != null">动态拼接条件

社区与生态

共建共享,持续迭代

〔开发者支持计划〕

• 贡献指南:提交PR前请阅读《Contributing.md》,确保代码通过CI/CD检查

• 问题反馈:通过GitHub Issues提交Bug,需包含复现步骤与环境信息

• 文档贡献:欢迎补充技术文档,特别是中文注释与示例代码

• 插件生态:支持扩展插件开发(如短信服务、支付接口),提供插件API文档

〔企业用户服务〕

• 定制开发:提供私有化部署、功能定制、安全加固等服务

• 培训支持:免费提供技术培训材料(含视频教程与PPT)

• 技术支持:企业用户可加入专属技术群(7×24小时响应)

〔版本演进路线图〕

2024Q2:v3.2.0

• 新增AI辅助编码(基于代码生成的SQL注释)

• 支持WebAssembly模块化加载

• 优化大数据量表格渲染性能(虚拟滚动)

2024Q3:v3.3.0

• 集成低代码平台(拖拽生成表单/报表)

• 实现跨租户数据同步(ETL工具)

• 支持Serverless部署(阿里云FC/腾讯云SCF)

2024Q4:v4.0.0

• 全面拥抱TypeScript(前端/后端)

• 集成AI智能运维(异常检测/自动扩容)

• 实现云原生架构(Service Mesh支持)

常见问题解答

高频问题集中解答,助您快速解决问题

Q1:开源协议是什么?商业使用是否受限?

A:采用Apache-2.0协议,允许免费商用、修改源码、分发,但需保留原始版权声明。不包含专利授权,禁止以项目名义推广衍生品。

Q2:如何处理数据库升级?

A:使用Flyway进行数据库版本管理。每次升级时添加db/migration/V3.2.0__xxx.sql脚本,系统启动时自动执行。支持回滚脚本(V3.2.0__xxx__rollback.sql)。

Q3:支持国产数据库吗?

A:已适配达梦DM8、人大金仓KingbaseES、OceanBase。需在配置中指定方言:mybatis-plus.configuration.database-dialect=dm。

Q4:如何集成第三方登录?

A:通过Spring Security OAuth2扩展实现。参考SecurityConfig中的addOAuth2Client方法,配置微信/钉钉/企业微信的AppID与Secret即可。

Q5:性能瓶颈如何排查?

A:启用Actuator监控:/actuator/metrics查看API耗时、/actuator/threaddump分析线程状态、/actuator/heapdump生成内存快照。推荐使用Prometheus + Grafana构建监控体系。