# admin3

**Repository Path**: common_user_sys/admin3

## Basic Information

- **Project Name**: admin3
- **Description**: 一个轻巧的后台管理框架，项目后端基于Java17、SpringBoot3.0，前端基于TypeScript、Vite3、Vue3、Element Plus，只提供登录会话、用户管理、角色管理、权限资源管理、事件日志等基础功能的最佳实践方案，不做过多的封装，适合二次定制开发、接私活、源码学习等场景 https://github.com/cjbi/admin3
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: main
- **Homepage**: http://metacode.wetech.tech:8082/admin3
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 217
- **Created**: 2023-04-26
- **Last Updated**: 2023-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Admin3

## 项目说明

项目使用最新的技术栈（后端Java17、SpringBoot3.0，前端TypeScript、Vite3、Vue3、Element Plus），只提供了用户和权限管理的核心功能最佳实践方案，适合作为基础工程二次定制开发、接私活、源码学习等场景

## 主要特性

* 未使用任何安全框架，优雅地实现了会话管理+权限控制功能，支持请求URL权限拦截，菜单、按钮级别权限控制
* 会话通过数据库作为二级缓存，即使重启也不会丢失登录状态
* 支持AOT编译Native镜像，相较于传统JVM形式节省了至少50%的内存
* 前端资源支持独立部署+webjars嵌入到后端应用两种形式
* 持久层使用SpringData JPA进行开发，能够支持多种数据库适配
* 所有的接口都有端到端的测试用例覆盖，有代码变动都会全量跑一遍测试用例，保证功能绝对可用

## 在线体验

- admin / 123456 (拥有所有权限)
- employee / employee (拥有部分权限)
- guest / guest (拥有查看权限)

演示地址： http://metacode.wetech.tech:8082/admin3

在线部署： https://gitpod.io/#https://github.com/cjbi/admin3

## 项目预览

<table>
    <tr>
        <td><img src="doc/image/login.jpg"/></td>
        <td><img src="doc/image/user.png"/></td>
    </tr>
    <tr>
        <td><img src="doc/image/role-auth.png"/></td>
        <td><img src="doc/image/role-member.png"/></td>
    </tr>
    <tr>
       <td><img src="doc/image/permission.png"/></td>
       <td><img src="doc/image/log-list.png"/></td>
    </tr>
</table>

## 技术文档

- [权限管理](doc/authority-management.md)

- [目录结构](doc/struct.md)

- [API 参考](doc/api-reference.md)

- [常用命令](doc/command.md)

## 软件需求
- JDK 17
- MySQL 8.0
- Maven 3.6.0+

## 本地部署

- 通过git下载源码
- 创建数据库admin3，数据库编码为UTF-8
- 修改application.yml文件，更改MySQL账号和密码
- 启动服务，访问管理后台地址：http://localhost:8080/admin3
- Swagger地址：http://localhost:8080/admin3/swagger-ui/index.html

## 待办列表

- [x] 操作日志

- [ ] 文件上传（常用第三方对象存储服务统一封装），支持修改用户头像

- [ ] 首页数据统计

- [ ] 国际化

- [ ] 更多功能请 [Issues](https://github.com/cjbi/admin3/issues) 留言

欢迎参与项目贡献！

## 许可证

[MIT](LICENSE)