Admin3后台管理框架
Admin3 是一个灵活高效不臃肿的后台管理框架,项目后端基于Java17、SpringBoot3.0,前端基于TypeScript、Vite3、Vue3、Element Plus,只提供登录会话、用户管理、角色管理、权限资源管理、事件日志等基础功能的最佳实践方案,不做过多的封装,适合二次定制开发、接私活、源码学习等场景。
项目使用最新的技术栈(后端Java17、SpringBoot3.0,前端TypeScript、Vite3、Vue3、Element Plus),只提供了用户和权限管理的核心功能最佳实践方案,适合作为基础工程二次定制开发、接私活、源码学习等场景
体验地址:
http://metacode.wetech.tech:8082/admin3
在线部署:
https://gitpod.io/#https://github.com/cjbi/admin3
测试账号:
admin / 123456
拥有所有权限
employee / employee
拥有部分权限
guest / guest
拥有查看权限
主要特性
- 未使用任何安全框架,优雅地实现了会话管理+权限控制功能,支持请求URL权限拦截,菜单、按钮级别权限控制
- 会话通过数据库作为二级缓存,即使重启也不会丢失登录状态
- 支持AOT编译Native镜像,相较于传统JVM形式节省了至少50%的内存
- 前端资源支持独立部署+webjars嵌入到后端应用两种形式
- 持久层使用SpringData JPA进行开发,能够支持多种数据库适配
- 所有的接口都有端到端的测试用例覆盖,有代码变动都会全量跑一遍测试用例,保证功能绝对可用
项目预览
文档
软件需求
- JDK 17
- MySQL 8.0
- Maven 3.6.0+
本地部署
- 通过git下载源码
- 创建数据库admin3,数据库编码为UTF-8
- 修改application.yml文件,更改MySQL账号和密码
- 启动服务,账号密码:
admin/123456
或者guest/guest
- 管理后台地址:http://localhost:8080/admin3
- Swagger地址:http://localhost:8080/admin3/swagger-ui/index.html
常用命令
服务端命令
- 编译打包
mvn clean package
- 安装到本地仓库
mvn clean install
说明:如果服务端使用webjars管理前端资源,强烈建议将admin3-ui安装到本地仓库
- 运行部署
cd admin3-server/target nohup java -jar -Dspring.datasource.url=xxx -Dspring.datasource.username=xxx -Dspring.datasource.password=xxx admin3-server-0.0.1-SNAPSHOT.jar >/dev/null 2>&1 &
- 打包JVM镜像
mvn spring-boot:build-image -Dmaven.test.skip=true -Ddocker.image-name=xxx -Ddocker.username=xxx -Ddocker.password=xxx
- 打包native镜像
mvn -Pnative spring-boot:build-image -Dmaven.test.skip=true -Ddocker.image-name=xxx -Ddocker.username=xxx -Ddocker.password=xxx
前端命令
- 安装依赖
yarn install
- 开发模式运行
yarn dev
- 编译项目
yarn build
评论