# simple-admin

**Repository Path**: gu-beichen-starlight/simple-admin

## Basic Information

- **Project Name**: simple-admin
- **Description**: simple-admin一个简单的前后端分离管理系统,包括基本的权限管理，多租户，视觉模型推理等功能。
后端：Java、springboot、mybatis-plus、sa-token、opencv、djl
前端：JavaScript、vue2、avue
中间件：pgvector、redis、minio、nacos

- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2025-07-21
- **Last Updated**: 2025-11-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Simple Admin

## 项目介绍
Simple Admin 是一个基于 Spring Cloud Alibaba 和 DJL 的智能管理后台系统，包含以下核心功能模块：

- 多租户权限管理系统
- 基于深度学习的图像识别功能
- 完整的用户权限控制
- 系统日志管理

系统采用微服务架构，包含以下主要模块：
- 网关服务 (simple-gateway)
- 系统管理服务 (simple-system)
- 图像识别服务 (simple-predict)
- 公共组件 (simple-common)
- 配置中心 (simple-config)
- 前端UI (simple-ui)

是基于现有优质开源项目：
- https://gitee.com/agricultureiot/yolo-onnx-java
- https://gitee.com/javpower/java-vision

进行了改造，对里面的模型进行了全新的转换和推理，并且整个过程的解释文档都已给出，请详细关注每个模块下面的resources下的内容。

## 功能特性
- 支持人脸检测、火焰烟雾检测、安全帽检测等AI识别功能
- 提供多租户支持和RBAC权限模型
- 集成MinIO文件存储
- 支持模型热加载和在线更新
- 提供完整的用户、角色、菜单、权限管理
- 包含详细的系统操作日志
- 支持验证码生成和验证
- 提供统一的响应结果封装

## 技术选型
- 后端：Spring Boot3 + Spring Cloud Alibaba
- 前端：Vue2 + Element UI
- 数据库：pgvector + MyBatis Plus
- 缓存：Redis
- 文件存储：MinIO
- AI框架：Deep Java Library (DJL)
- 构建工具：Maven
- 部署：Docker/Nacos

## 安装部署

### 环境要求
- JDK 17+
- pgvector 14+
- Redis 6.0+
- MinIO
- Node.js 14.x+
- Docker（可选）

### 快速启动
1. 克隆项目：
```bash
git clone https://gitee.com/gu-beichen-starlight/simple-admin.git
```

2. 启动后端服务：
```bash
# 依次启动以下模块
mvn spring-boot:run -f simple-gateway
mvn spring-boot:run -f simple-system
mvn spring-boot:run -f simple-predict
```

3. 启动前端：
```bash
cd simple-ui
npm install
npm run dev
```

4.注意事项：

请确保pgvector安装了vector插件并且插件在对应模式启用.
```sql
--查看向量插件指定的模式
SELECT extname, extversion, nspname FROM pg_extension LEFT JOIN pg_namespace ON pg_namespace.oid = pg_extension.extnamespace WHERE extname = 'vector';

--切换模式
alter extension vector set schema test;
```

## 使用说明
1. 访问前端页面：http://localhost:8080
2. 登录系统：
   - 默认账号：admin
   - 默认密码：123456
3. 使用AI识别功能：
   - 上传图片进行人脸检测、火焰烟雾检测等
   - 查看识别结果和置信度
4. 管理系统设置：
   - 用户管理：添加/编辑/删除用户
   - 角色管理：创建角色并分配权限
   - 菜单管理：配置系统菜单
   - 日志查看：查看系统操作日志

## 交流群（扫码加好友进群交流）
- 🍉是GVP项目yolo-onnx-java，java-vision作者。
- ![xgc](./doc/xgc.png)

## 界面介绍
   - ![后端](./doc/00.png)
   - ![模型](./doc/01.png)
   - ![模型](./doc/02.png)
   - ![模型](./doc/03.png)
   - ![模型](./doc/04.png)
   - ![模型](./doc/05.png)

## 目录结构
```
simple-admin/
├── simple-common/       # 公共工具类和常量
├── simple-config/       # 配置中心
├── simple-gateway/      # API网关
├── simple-system/       # 系统管理服务
├── simple-predict/      # 图像识别服务
├── simple-ui/           # 前端管理界面
└── pom.xml              # Maven父项目配置
```

## 常见问题
1.本系统作为一个初入职场的新人手写并开源，存在一些问题，请大家提issue，我会及时处理。

2.很多问题可能我也不会处理，欢迎大家贡献解决方法。

## 贡献指南
欢迎贡献代码！请遵循以下步骤：
1. Fork项目
2. 创建功能分支
3. 提交代码
4. 创建Pull Request

## 许可证
本项目采用 Apache-2.0 许可证。详情请查看 LICENSE 文件。