基于 Spring Boot 2.7 + Vben Admin 5 + UniApp 的全栈快速开发框架
面向一人公司和小团队，结合 AI 能力，开箱即用
|
## 开源版与会员版对比⭐
| 能力 | 开源版 | 会员版 |
|------|:------:|:------:|
| Spring Boot 2.7 + Vben Admin 5 基础框架 | ✅ | ✅ |
| 系统管理（用户/角色/菜单/部门/字典/日志） | ✅ | ✅ |
| 对象存储 OSS V2 | ✅ | ✅ |
| 代码生成器 | ✅ | ✅ |
| 等保安全体系（基于等保二级要求改造） | ✅ | ✅ |
| AI Skills 开发规范 | ✅ | ✅ |
| 高级的AI以及基于实战的开发规范Skills 或者文档 | - | ✅ |
| 通知模块（站内信/邮件）基于websocket实现 | ✅ | ✅ |
| 基础组件 | ✅ | ✅ |
| 商业组件（电子围栏等高德组件） | - | ✅ |
| 基于菜单的可配置的高级数据权限 | - | ✅ |
| 推送模块（APP 推送/短信） | - | ✅ |
| 移动端（UniApp + H5 / 微信小程序 / App） | - | ✅ |
| 支付模块（微信支付/支付宝） | - | ✅ |
| 移动多端登录管理模块（微信、邮箱、短信） | - | ✅ |
| 基于数据库隔离的多租户功能 | - | ✅ |
| 动态表单 | - | 集成中（已有） |
| 工作流 | - | 集成中（已有） |
| 技术支持 | 社区 | 专属 |
| 更新频率 | 缓慢 | 快 |
## 官方演示地址⭐
可在官方地址 https://angryant.vip/ 查看系统在线演示
## 核心特性
- **前端**：Vue 3 + Vite + TypeScript，基于 Vben Admin 5 的 Monorepo 架构，Element Plus（主开发），多主题、国际化、按钮级权限控制
- **移动端**：UniApp + Vue 3 + Pinia + uView Plus，一套代码适配 H5 / 微信小程序 / App
- **后端**：Spring Boot 2.7 + MyBatis-Plus + Spring Security + JWT + Redis + Druid，模块化可插拔
- **对象存储 OSS V2**：支持本地、MinIO、阿里云、腾讯云、AWS S3 多存储后端，集成文件夹管理、分片上传、引用关系管理
- **代码生成器**：根据数据库表结构自动生成前后端 CRUD 代码
- **等保安全体系**：支持国密算法、密码策略管控、多模式登录、IP 安全管控，满足等保合规要求
- **AI Skills 体系**：内置开发规范 Skills，驱动 AI 按标准交付，减少 Token 浪费，杜绝重复建设
## 功能模块
| 模块 | 说明 |
|------|------|
| **概览** | 分析页、工作台 |
| **系统管理** | 用户管理、角色管理、部门管理、菜单管理、岗位管理、字典管理、参数设置、日志管理（操作日志 / 登录日志）、区域管理 |
| **系统监控** | 在线用户、定时任务、数据监控（Druid）、服务监控、缓存监控、IP 黑名单管理、IP 安全预警记录 |
| **系统工具** | 代码生成、系统接口（Swagger） |
| **文件库管理** | OSS V2 文件库（文件夹管理 / 分片上传 / 引用关系）、OSS 设置（多存储后端配置） |
| **通知公告** | 我的通知、通知公告管理 |
| **开放应用管理** | 第三方开放应用、开放 API 资源权限、开放接口调用日志 |
| **组件演示** | 用户选择抽屉、组织架构组件、地址库组件、富文本编辑器、日历组件、日期范围组件、字典组件（select / radio / checkbox / view）、高德地图系列（点标记 / 轨迹回放 / 多边形编辑 / 折线编辑 / 多边形展示 / 折线展示）、文件库选择、OSS 上传、通用 select、通用 data-view、二维码、经典 CRUD 示例 |
### 安全能力
| 能力 | 说明 |
|------|------|
| 国密算法 | 支持 SM2 / SM3 / SM4 国密算法，满足等保密码合规要求 |
| 密码加密存储 | 密码采用加密算法存储，禁止明文（等保要求） |
| 密码过期策略 | 支持密码有效期配置，到期强制修改（等保要求） |
| 密码错误锁定 | 连续输错密码自动锁定账户，支持配置锁定次数和解锁时间（等保要求） |
| 多模式登录 | 支持账号密码、手机验证码、邮箱验证码等多种登录方式 |
| IP 安全管控 | IP 黑名单管理、IP 异常登录预警记录 |
| XSS 防护 | 内置 XSS 过滤，可配置过滤规则和开关 |
| 操作审计 | 完整的操作日志和登录日志记录（等保要求） |
| JWT 认证 | 基于 JWT 的无状态认证，支持 Token 续期和单点登录控制 |
### 可插拔业务模块（逐步开放）
| 模块 | 说明 | 状态 |
|------|------|------|
| angryant-notice | 通知模块（站内信、邮件等） | 已开源 |
| angryant-push | 推送模块（APP 推送、短信推送等） | 已开源 |
| angryant-flow | 流程审批、表单设计 | 规划中 |
| angryant-doc | 在线文档管理 | 规划中 |
### 基于框架的项目案例（逐步开放）
| 项目 | 说明 | 状态 |
|------|------|------|
| 小程序点餐系统 | 餐饮行业完整解决方案 | 规划中 |
| 充值管理系统 | 会员充值、消费、账务 | 规划中 |
| 心理学管理系统 | 心理测评、档案管理 | 规划中 |
| CRM系统 | | |
## 技术栈
### 前端
- **Vue 3** + **Vite** + **TypeScript**
- **Pinia** + **Vue Router**
- **Element Plus**（主开发）、Ant Design Vue、Naive UI 多 UI 库支持
- **Pnpm Monorepo** + **TurboRepo** + **ESLint** + **Prettier**
### 移动端
- **UniApp** + **Vue 3** + **Pinia** + **uView Plus**
- 一套代码适配 H5、微信小程序、App
### 后端
- **Spring Boot 2.7**（3.x版本规划中） + **Spring Security** + **JWT**
- **MyBatis-Plus**（分页插件、逻辑删除、雪花算法主键）
- **Redis**（缓存加速）+ **Druid**（数据库连接池监控）
- **Swagger**（API 文档）
- **Quartz**（定时任务调度）
### 基础设施
- **MySQL** >= 5.7
- **Redis** >= 5.0
- **对象存储**：本地 / MinIO / 阿里云 OSS / 腾讯云 COS / AWS S3
## 项目结构
```
aant-boot-open/
├── aant-vben-admin/ # 管理后台前端（Vue 3 + Vite + TypeScript）
├── angryant-platform/ # 后端父级聚合模块（框架核心）
├── angryant-biz-blank/ # 空白业务模块（开发脚手架）
├── angryant-oss/ # 对象存储模块（OSS V2）
└── docs/ # 文档与数据库脚本
```
## 快速开始
### 环境要求
| 工具 | 版本要求 |
|------|---------|
| Java | 1.8 |
| Maven | >= 3.5 |
| MySQL | >= 5.7 |
| Redis | >= 5.0 |
| Node.js | >= 20.10.0 |
| pnpm | >= 9.12.0 |
| HBuilderX | >= 5.06（移动端开发） |
### 后端启动
```bash
# 1. 克隆仓库
git clone https://github.com/your-username/aant-boot.git
cd aant-boot
# 2. 进入后端父级目录，安装依赖
cd angryant-platform
mvn -U clean install -DskipTests
# 3. 配置数据库和 Redis
# 编辑 application.yml 中的 MySQL 和 Redis 连接信息
# 4. 初始化数据库
# 执行 docs/ 下的数据库脚本
# 5. 启动后端服务
# 运行主应用启动类
```
### 管理后台前端启动
```bash
# 1. 进入前端目录
cd aant-vben-admin
# 2. 安装依赖
pnpm install
# 3. 启动开发服务器
pnpm dev
# 4. 构建生产版本
pnpm build
```
### 移动端启动
```bash
# 1. 进入移动端目录
cd aant-uniapp-base
# 2. 安装依赖
npm install
# 3. 开发调试（H5 模式）
npm run dev
# 4. 构建 H5
npm run build:h5
# 5. 构建微信小程序
npm run build:mp-weixin
```
> 推荐使用 **HBuilderX** 打开 `aant-uniapp-base` 项目进行开发调试，可直接运行到浏览器、微信小程序和 App。
### 数据库初始化
| 模块 | 脚本 | 说明 |
|------|------|------|
| angryant-biz-blank | `check_config.sql` | 校验 sys_config 中的 oss_v2_local 配置 |
| angryant-oss | `create.sql` | OSS 建表脚本 |
| 平台公共脚本 | `angryant-framework/doc/sql/` | 按需执行 |
## 内置 AI Skills
ANGRY ANT 内置了 AI 编码技能约束体系，通过 Claude Code 的 Skills 机制，将项目架构约定与编码规范固化为可自动触发的规则，确保 AI 辅助生成的代码始终符合项目规范。
| Skill | 说明 |
|-------|------|
| **dev-guidelines** | 后端 Java / 前端 TypeScript 开发规范，覆盖分层架构约束（Controller → Service → Mapper）、前后端 API 命名一致性、建表 SQL 公共字段等强制规则 |
| **aa-components** | 管理后台业务组件库使用手册，涵盖字典选择器、部门树、用户选择抽屉、OSS 上传、地图、远程数据下拉等开箱即用组件 |
| **uniapp-guidelines** | 移动端 UniApp 开发规范，约束页面目录结构、API 层封装、Pinia Store 模块划分、组件命名等 |
## 浏览器支持
| IE | Edge | Firefox | Chrome | Safari |
| :-: | :-: | :-: | :-: | :-: |
| 不支持 | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
- 本地开发推荐使用 **Chrome 最新版**
- 生产环境支持现代浏览器，不支持 IE
## 致谢
特别感谢以下开源项目的贡献：
- [RuoYi](https://gitee.com/y_project/RuoYi) - 后端框架基础
- [Vben Admin](https://www.vben.pro/) - 前端管理后台框架
**Aant作者之一**
- https://gitee.com/ohaha123 阿庆同学
## 开源协议
[MIT License](LICENSE)
Copyright (c) 2026-广州好掌信息科技有限公司 ANGRY ANT
本项目采用 MIT 协议开源，支持任何商用和学习用途。