# simple-admin-mini

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

## Basic Information

- **Project Name**: simple-admin-mini
- **Description**: 是项目simple-admin的单体版本
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-11-07
- **Last Updated**: 2026-02-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Simple Admin Mini

## 项目介绍

Simple Admin Mini 是 [Simple Admin](https://gitee.com/gu-beichen-starlight/simple-admin) 的**单体版本**，保留了原项目的核心功能与技术栈，但将原本的微服务架构整合为单一应用，便于快速部署和学习使用。

该系统基于 Spring Boot 3 + Spring Cloud Alibaba + Vue3 (vue-next-admin) + DJL（Deep Java Library）构建，具备如下核心功能：

- 多租户权限管理系统（RBAC）
- 基于深度学习的图像识别功能
- 完整的用户、角色、菜单、权限管理
- 系统操作日志记录
- 验证码生成与验证
- 统一响应封装
- 支持模型热加载与在线更新
- 集成 MinIO 文件存储

> ✅ 本项目是作者初入职场时所写，欢迎提出 issue 或贡献代码！

---

## 功能特性

- ✅ 支持多种 AI 图像识别任务
- ✅ RBAC 权限控制 + 多租户支持
- ✅ 使用 pgvector + MyBatis Plus 进行向量数据存储
- ✅ Redis 缓存支持
- ✅ MinIO 文件存储集成
- ✅ 模型加载
- ✅ 提供统一的 RESTful API 接口
- ✅ 前后端分离架构（Vue3 + Element Plus）

---

## 技术选型

| 类别    | 技术栈                                     |
|-------|-----------------------------------------|
| 后端框架  | Spring Boot 3 + Sa-Token + MyBatis Plus |
| 微服务组件 | Spring Cloud Alibaba（简化为单体结构）           |
| AI框架  | Deep Java Library (DJL) + Amazon Models |
| 数据库   | pgvector + PostgreSQL                   |
| 缓存    | Redis                                   |
| 文件存储  | MinIO                                   |
| 前端框架  | Vue3 + Element Plus                     |
| 构建工具  | Maven                                   |
| 部署方式  | Docker / Jar 包运行                        |

---

## 目录结构

```
simple-admin-mini/
├── src/main/java
│   └── com.sam
│       ├── config          # 配置类
│       ├── tool          # 公共工具类
│       ├── api         # Controller接口
│       ├── mapper          # 数据交互层
│       ├── service         # 业务逻辑层
│       ├── domain           # 实体映射关系
│       └── Application.java # 启动类
├── src/main/resources
│   ├── application.yml     # 主配置文件
├── simple-ui               # 前端代码（Vue3）
├── pom.xml                 # Maven 配置
└── README.md
```

---

## 安装部署

### 环境要求

- JDK 17+
- PostgreSQL 14+ with pgvector 插件
- Redis 6.0+
- MinIO Server
- Node.js 16.x+

### 快速启动

#### 1. 克隆项目

```bash
git clone https://gitee.com/gu-beichen-starlight/simple-admin-mini.git
cd simple-admin-mini
```

#### 2. 初始化数据库

确保已安装 `pgvector` 并启用插件：

```sql
CREATE EXTENSION IF NOT EXISTS vector;
```

导入初始 SQL 脚本（位于 `resources/sql/`）。

#### 3. 修改配置文件

编辑 `src/main/resources/application.yml`，配置数据库、Redis、MinIO 等信息。

#### 4. 启动后端服务

```bash
mvn spring-boot:run
```

或打包运行：

```bash
mvn clean package
java -jar target/simple-admin-mini-1.0.jar
```

#### 5. 启动前端界面

```bash
cd simple-ui
npm install
npm run dev
```

访问地址：[http://localhost:5173](http://localhost:5173) (前端) / [http://localhost:8080](http://localhost:8080) (后端)

---

## 使用说明

1. 登录系统：
   - 默认账号：`admin`
   - 默认密码：`123456`

2. 使用 AI 功能：
   - 在“图像识别”模块上传图片进行检测
   - 查看识别结果和置信度

3. 系统管理：
   - 用户管理、角色管理、菜单管理、权限分配
   - 查看操作日志

---

## 界面截图

> 示例界面如下：

- ![模型](./doc/system.png)
- ![模型](./doc/detection.png)
- ![模型](./doc/classification.png)
- ![模型](./doc/segmentation.png)
- ![模型](./doc/face.png)

---

## 与微服务版的区别

| 特性       | Simple Admin（微服务版） | Simple Admin Mini（单体版） |
|----------|--------------------|------------------------|
| 架构       | 微服务架构（网关 + 多服务）    | 单体架构                   |
| 模块数量     | 多个独立模块             | 一个模块                   |
| 部署复杂度    | 较高                 | 简单                     |
| 适用场景     | 生产环境、团队协作          | 学习、演示、快速上手             |
| 配置中心     | Nacos              | 本地配置文件                 |
| 网关       | Gateway            | 无                      |
| AI服务独立部署 | 可选                 | 集成在主应用中                |
| 云端模型支持   | 有限                 | 支持Amazon AWS预训练模型      |

---


## 常见问题

1. **pgvector 插件未生效？**
   - 确保插件已安装并在对应 schema 启用。
   ```sql
   CREATE EXTENSION IF NOT EXISTS vector;
   ```

2. **模型加载失败？**
   - 确保模型路径正确，且资源文件存在。
   - 检查是否使用了支持的AI模型（DJL支持多种引擎包括Amazon SageMaker模型）。

3. **Amazon AWS模型使用？**
   - 本项目支持使用Amazon AWS提供的预训练模型。
   - 可以通过DJL框架加载和部署Amazon SageMaker模型。
   - 确保AWS凭证配置正确，并具有相应的模型访问权限。

3. **MinIO 无法上传文件？**
   - 检查 MinIO 配置是否正确，权限是否开放。

---

## 贡献指南

欢迎提交 PR 和 Issue！

1. Fork 项目
2. 创建功能分支
3. 提交代码
4. 发起 Pull Request

---

## 许可证

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

---

如需了解更多，请访问原项目地址：[https://gitee.com/gu-beichen-starlight/simple-admin](https://gitee.com/gu-beichen-starlight/simple-admin)

---