一、项目简介

AgileBoot 是一个基于 Spring Boot 与 Vue3 技术栈构建全栈开发解决方案,专注于为独立开发者及企业团队提供轻量化、高可维护性的项目模板。该框架以模块化架构设计为核心,通过标准化的代码规范和清晰的工程结构,帮助开发者快速搭建符合现代开发标准的小型应用系统。其适用场景覆盖个人创意项目孵化、企业内部工具开发以及编程入门教学实践,特别适合需要兼顾开发效率与代码质量的中小型项目需求。

二、功能特性

  • 前后端分离:前端采用 Vue3、Element Plus、TypeScript、Pinia,后端采用 Spring Boot、Spring Security & Jwt、Redis & MySql、Mybatis Plus,实现前后端完全分离,提高开发效率。
  • 权限认证:使用 Jwt 进行权限认证,支持多终端认证系统,确保系统安全。
  • 注解式开发:支持注解式主从数据库切换、请求限流、重复请求拦截、菜单权限拦截、数据权限拦截等,提高开发效率。
  • 动态权限菜单:支持加载动态权限菜单,实现实时权限控制。
  • 单元测试与集成测试:大量的单元测试与集成测试覆盖,确保业务逻辑正确。
  • 多缓存策略:提供三个层级的缓存供使用者调用(Map, Guava, Redis),可根据情况选择使用哪个缓存类。
  • i18n 支持:支持国际化,方便不同语言环境的用户使用。

三、技术栈

技术
版本
springboot
2.7
druid
1.2.8
springdoc
3.0.0
mybatis-plus
3.5.2
hutool
3.5.2
mockito
1.10.19
guava
31.0.1-jre
junit
1.10.19
h2
1.10.19
jackson
follow springboot
knife4j
3.0.3
Spring Task
follow springboot

四、内置功能

功能
描述
用户管理
用户是系统操作者,该功能主要完成系统用户配置
部门管理
配置系统组织机构(公司、部门、小组),树结构展现支持数据权限
岗位管理
配置系统用户所属担任职务
菜单管理
配置系统菜单、操作权限、按钮权限标识等,本地缓存提供性能
角色管理
角色菜单权限分配、设置角色按机构进行数据范围权限划分
参数管理
对系统动态配置常用参数
通知公告
系统通知公告信息发布维护
操作日志
系统正常操作日志记录和查询;系统异常信息日志记录和查询
登录日志
系统登录日志记录查询包含登录异常
在线用户
当前系统中活跃用户状态监控
系统接口
根据业务代码自动生成相关的api接口文档
服务监控
监视当前系统CPU、内存、磁盘、堆栈等相关信息
缓存监控
对系统的缓存信息查询,命令统计等
连接池监视
监视当前系统数据库连接池状态,可进行分析SQL找出系统性能瓶颈

五、安装部署

前置准备: 下载前后端代码

安装好Mysql和Redis

后端启动

1. 生成所需的数据库表
找到后端项目根目录下的sql目录中的agileboot_xxxxx.sql脚本文件(取最新的sql文件)。 导入到你新建的数据库中。

2. 在admin模块底下,找到resource目录下的application-dev.yml文件
配置数据库以及Redis的 地址、端口、账号密码

3. 在根目录执行mvn install

4. 找到agileboot-admin模块中的AgileBootAdminApplication启动类,直接启动即可

前端启动

详细步骤请查看对应前端部分

1. pnpm install

2. pnpm run dev

3. 当出现以下字样时即为启动成功

vite v2.6.14 dev server running at:

> Local: http://127.0.0.1:80/

ready in 4376ms.

对于想要尝试全栈项目的前端人员,这边提供更简便的后端启动方式,无需配置Mysql和Redis直接启动

无Mysql/Redis 后端启动

1. 找到agilboot-admin模块下的resource文件中的application.yml文件

2. 配置以下两个值
spring.profiles.active: basic,dev
改为
spring.profiles.active: basic,test

agileboot.embedded.mysql: false
agileboot.embedded.redis: false
改为
agileboot.embedded.mysql: true
agileboot.embedded.redis: true

请注意:高版本的MacOS系统,无法启动内置的Redis


3. 找到agileboot-admin模块中的AgileBootAdminApplication启动类,直接启动即可

六、UI展示

版权声明:
1、本网站名称:帝企吧
2、本站永久网址:https://www.diqiba.com
3、本网站的文章部分内容可能来源于网络及作者投稿,仅供大家学习与参考,如有侵权,请联系站长进行删除处理。
4、本站一切资源不代表本站立场,并不代表本站赞同其观点和对其真实性负责。
5、本站一律禁止以任何方式发布或转载任何违法的相关信息,访客发现请向站长举报。
6、本站资源大多存储在云盘,如发现链接失效,请联系我们我们会第一时间更新。
7、本站所有资源来源于互联网,仅用于学习及参考使用,切勿用于商业用途,如产生法律纠纷本站概不负责! 8、资源除标明原创外均来自网络转载,版权归原作者所有,若侵犯到您权益请联系我们删除,我们将及时处理! 9、若您需使用非免费的软件或服务,请购买正版授权并合法使用!