覆盖企业级后台管理全场景,模块解耦、可插拔,支持按需启用
基于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+高频业务组件(表格筛选、表单联动、富文本编辑、拖拽排序等)。
前后端分离、模块化设计,适配云原生与传统部署场景
| 部署模式 | 适用场景 | 资源要求 | 扩展性 |
|---|---|---|---|
| 单体部署(Standalone) | 中小企业/内部系统 | 1台服务器(8C16G+) | 水平扩展需集群化 |
| 微服务集群(Cloud) | 大型平台/SaaS系统 | K8s集群 + 分布式存储 | 高(支持动态扩缩容) |
| Docker容器化 | 快速交付/CI/CD | 支持任意云平台 | 中(需编排工具) |
真实场景功能演示,支持在线体验与源码本地部署
采用JWT令牌机制实现无状态认证,支持账号密码、短信验证码、扫码登录三种方式。登录失败5次锁定账户30分钟,防止暴力破解。会话管理支持多端登录控制(PC/移动端/小程序),可强制下线指定会话。
典型登录流程:
安全加固措施:
实现四层权限体系:菜单权限(URL路径)、按钮权限(前端UI控件)、接口权限(后端API)、数据权限(行级数据过滤)。
数据权限示例:
可查看:本部门所有销售订单 + 下属销售员的订单
不可查看:其他部门订单(如市场部、客服部)
实现方式:在MyBatis SQL中动态注入WHERE条件 → AND department_id IN (SELECT child_dept_ids(#{deptId}))
权限变更流程:
支持BPMN标准流程定义,提供可视化设计器与流程模拟器。典型流程:采购申请(含预算校验)→ 部门审批 → 财务复核 → 采购执行 → 入库验收。
关键特性:
流程引擎配置示例:
【采购申请流程】
节点1:发起人 → 自动跳转
节点2:部门经理审批
条件:金额≤1万 → 通过
条件:金额>1万 → 转财务部
节点3:财务复核(会签)
规则:2人同意 + 预算充足 → 通过
节点4:采购执行 → 自动创建采购单
提供拖拽式看板设计器,支持自定义指标与图表组合。内置10+模板(用户增长、系统监控、销售分析、运营日报)。
看板配置示例:
数据刷新策略:
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小时响应)
• 新增AI辅助编码(基于代码生成的SQL注释)
• 支持WebAssembly模块化加载
• 优化大数据量表格渲染性能(虚拟滚动)
• 集成低代码平台(拖拽生成表单/报表)
• 实现跨租户数据同步(ETL工具)
• 支持Serverless部署(阿里云FC/腾讯云SCF)
• 全面拥抱TypeScript(前端/后端)
• 集成AI智能运维(异常检测/自动扩容)
• 实现云原生架构(Service Mesh支持)
高频问题集中解答,助您快速解决问题
A:采用Apache-2.0协议,允许免费商用、修改源码、分发,但需保留原始版权声明。不包含专利授权,禁止以项目名义推广衍生品。
A:使用Flyway进行数据库版本管理。每次升级时添加db/migration/V3.2.0__xxx.sql脚本,系统启动时自动执行。支持回滚脚本(V3.2.0__xxx__rollback.sql)。
A:已适配达梦DM8、人大金仓KingbaseES、OceanBase。需在配置中指定方言:mybatis-plus.configuration.database-dialect=dm。
A:通过Spring Security OAuth2扩展实现。参考SecurityConfig中的addOAuth2Client方法,配置微信/钉钉/企业微信的AppID与Secret即可。
A:启用Actuator监控:/actuator/metrics查看API耗时、/actuator/threaddump分析线程状态、/actuator/heapdump生成内存快照。推荐使用Prometheus + Grafana构建监控体系。