# 开源管理系统

**Repository Path**: dashu-03/open-sys

## Basic Information

- **Project Name**: 开源管理系统
- **Description**: 🎉🎉🎉一套开源、轻量级，基于SpringBoot & Vue 3 前后端分离管理系统。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 8
- **Forks**: 2
- **Created**: 2025-01-28
- **Last Updated**: 2026-02-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 开源, 管理系统

## README

# Open-Sys 企业级后台管理系统

<div align="center">

[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-2.7.16-brightgreen.svg)](https://spring.io/projects/spring-boot)
[![Vue](https://img.shields.io/badge/Vue.js-3.3.4-4fc08d.svg)](https://vuejs.org/)
[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Java](https://img.shields.io/badge/Java-8+-orange.svg)](https://www.oracle.com/java/)

</div>

## 📋 项目简介

Open-Sys 是一个基于 **Spring Boot 2.7** + **Vue 3** 开发的现代化企业级后台管理系统。采用前后端分离架构，提供完整的RBAC权限管理、用户管理、菜单管理、代码生成器等核心功能。

### ✨ 核心特性

- 🎯 **前后端分离**: Spring Boot RESTful API + Vue3 SPA
- 🔐 **安全认证**: JWT Token + Redis 缓存 + 权限拦截器
- 👥 **RBAC权限**: 用户-角色-菜单多级权限控制
- 🔧 **代码生成器**: 数据库表一键生成全套CRUD代码
- 📊 **系统监控**: 在线用户、操作日志、服务器日志
- 🎨 **现代UI**: Element Plus + 响应式设计
- 📱 **移动适配**: 自适应多端显示

## 🏗️ 项目架构

```
open-sys/
├── pom.xml                    # 父模块，统一管理所有子模块依赖和版本
├── open-server/               # 应用启动模块，整合所有业务模块并提供系统主入口
├── open-base/                 # 基础模块，提供配置管理、字典数据和接口增强功能
├── open-common/               # 公共模块，提供通用工具类、异常处理和响应封装
├── open-system/               # 系统管理模块，提供用户、角色、菜单、字典和日志管理功能
├── open-tool/                 # 系统工具模块，提供代码生成、定时任务和日志管理功能
├── open-framework/            # 技术组件父模块，统一管理所有技术组件子模块
│   ├── open-generate/         # 代码生成器模块，提供根据数据库表自动生成代码功能
│   ├── open-job/              # 定时任务模块，提供基于Quartz的任务调度功能
│   ├── open-mybatis/          # MyBatis增强模块，提供分页和字段加解密功能
│   ├── open-redis/            # Redis模块，提供Redis配置、序列化和操作工具
│   ├── open-security/         # 安全认证模块，提供JWT认证、权限控制和用户会话管理
│   ├── open-websocket/        # WebSocket模块，提供WebSocket配置和消息通信功能
│   └── open-excel/            # Excel模块，提供Excel读写和导入导出功能
├── open-vue/                  # 前端模块 (Vue3 + Vite)
└── sql/                       # 数据库脚本
```

### 核心模块职责

| 模块 | 职责 | 主要技术 |
|------|------|----------|
| **open-server** | 应用启动入口，整合所有业务模块并提供系统主入口 | Spring Boot Web |
| **open-base** | 提供配置管理、字典数据和接口增强功能 | Spring AOP |
| **open-common** | 提供通用工具类、异常处理和响应封装 | 工具类、全局异常处理 |
| **open-system** | 提供用户、角色、菜单、字典和日志管理功能 | MyBatis、业务逻辑 |
| **open-tool** | 提供代码生成、定时任务和日志管理功能 | Velocity、Quartz |
| **open-generate** | 提供根据数据库表自动生成代码功能 | 数据库连接、模板处理 |
| **open-job** | 提供基于Quartz的任务调度功能 | Quartz定时任务 |
| **open-mybatis** | 提供分页和字段加解密功能 | MyBatis拦截器 |
| **open-redis** | 提供Redis配置、序列化和操作工具 | RedisTemplate |
| **open-security** | 提供JWT认证、权限控制和用户会话管理 | JWT、拦截器 |
| **open-websocket** | 提供WebSocket配置和消息通信功能 | WebSocket |
| **open-excel** | 提供Excel读写和导入导出功能 | EasyExcel |
| **open-vue** | 前端界面、交互逻辑 | Vue3、Element Plus、Pinia |

## 🛠️ 技术栈

### 后端技术栈
- **框架**: Spring Boot 2.7.16
- **安全**: JWT + 自定义权限拦截器
- **数据库**: MySQL 8.0 + MyBatis 2.1.4
- **缓存**: Redis
- **连接池**: Druid 1.2.20
- **模板引擎**: Velocity 1.7 (代码生成)
- **JSON**: FastJSON2 2.0.53
- **日志**: Log4j2 + Disruptor (异步日志)
- **定时任务**: Quartz
- **Excel**: EasyExcel 3.3.2

### 前端技术栈
- **框架**: Vue 3.3.4
- **构建工具**: Vite 4.4.5
- **UI组件**: Element Plus 2.3.14
- **状态管理**: Pinia 2.1.6
- **路由**: Vue Router 4.2.5
- **HTTP客户端**: Axios 1.5.1
- **样式**: SCSS + 响应式设计

## 🚀 快速开始

### 环境要求

- **JDK**: 8+
- **Node.js**: 16+
- **MySQL**: 8.0+
- **Redis**: 6.0+
- **Maven**: 3.6+

### 后端部署

1. **克隆项目**
   ```bash
   git clone https://gitee.com/dashu-03/open-sys.git
   cd open-sys
   ```

2. **数据库初始化**
   ```bash
   # 创建数据库
   mysql -u root -p
   CREATE DATABASE open_sys CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   
   # 导入数据
   mysql -u root -p open_sys < sql/open_sys.sql
   ```

3. **配置修改**
   ```yaml
   # 编辑 open-server/src/main/resources/application.yml
   spring:
     datasource:
       url: jdbc:mysql://127.0.0.1:3306/open_sys?allowMultiQueries=true
       username: root
       password: 123456
     redis:
       host: localhost
       port: 6379
   ```

4. **启动服务**
   ```bash
   mvn clean install
   cd open-server
   mvn spring-boot:run
   ```
   
   启动成功后访问: http://localhost:9090

### 前端部署

1. **安装依赖**
   ```bash
   cd open-vue
   npm install
   ```

2. **开发模式**
   ```bash
   npm run dev
   ```
   
3. **生产构建**
   ```bash
   npm run build
   ```

## 👨‍💻 使用指南

### 默认账号
- **超级管理员**: admin / admin123
- **普通用户**: dashu / dashu123

---

## 🎯 功能模块详细介绍

### 🔐 1. 用户认证与安全模块

#### 🔑 登录认证功能
- **多重验证机制**
  - 用户名/密码登录
  - 图形验证码验证（可系统配置开关）
  - 记住密码功能
  
- **JWT Token 安全**
  - JWT Token 生成与验证
  - Redis 缓存Token信息
  - Token 自动续期机制

- **用户注册功能**
  - 新用户注册
  - 密码强度校验

#### 🚪 会话管理
- **安全退出**
  - 清除Token缓存
  - 记录退出日志

- **多端登录控制**
  - 强制踢下线功能

### 👥 2. 用户管理模块

#### 👤 用户信息管理
- **基础信息维护**
  - 用户名、昵称、邮箱、手机号
  - 头像上传与管理
  - 个人资料编辑
  - 密码修改功能

- **用户状态管理**
  - 用户启用/禁用
  - 用户信息导入导出

#### 🔍 用户查询与搜索
- **多条件搜索**
  - 用户名模糊查询
  - 状态筛选
  - 角色筛选

- **分页展示**
  - 自定义分页大小
  - 总数统计显示

### 🎭 3. 角色权限管理模块

#### 🏷️ 角色管理
- **角色CRUD操作**
  - 角色创建、编辑、删除
  - 角色状态管理
  - 超级管理员角色保护机制

- **权限分配**
  - 角色与菜单权限绑定
  - 权限树形结构展示

#### 👑 RBAC权限模型
- **用户-角色-权限**
  - 用户多角色支持
  - 角色多权限分配
  - 权限动态加载

- **权限控制粒度**
  - 菜单级权限控制
  - 按钮级权限控制
  - 接口级权限验证

### 📋 4. 菜单管理模块

#### 🌳 菜单结构管理
- **树形菜单**
  - 无限级菜单树
  - 父子菜单关联

- **菜单类型**
  - **目录**: 菜单组织结构
  - **菜单**: 具体页面入口
  - **按钮**: 操作权限控制

#### ⚙️ 菜单配置
- **基础配置**
  - 菜单名称、图标、路径
  - 显示顺序控制
  - 权限字符串配置

### 📊 5. 系统监控模块

#### 👥 在线用户管理
- **实时监控**
  - 当前在线用户列表
  - 在线用户数量统计

- **管理操作**
  - 强制用户下线
  - 用户搜索过滤

#### 📋 操作日志管理
- **日志记录**
  - 用户登录日志
  - 操作行为记录
  - 系统异常日志

- **日志查询**
  - 多维度日志搜索
  - 时间范围查询

### 📢 6. 通知公告模块

#### 📨 通知管理
- **通知类型**
  - **公告**: 系统公告发布
  - **私信**: 点对点消息

- **通知操作**
  - 通知创建、编辑、删除
  - 通知状态管理

#### 📤 消息推送
- **发送机制**
  - 立即发送
  - 指定用户发送

- **接收管理**
  - 消息已读/未读状态
  - 消息搜索查询

### ⚙️ 7. 系统配置模块

#### 🔧 通用配置
- **系统参数**
  - 验证码开关控制
  - 系统标题设置

- **配置管理**
  - 配置项增删改查
  - 配置分类管理

#### 🎨 个人设置
- **个人信息**
  - 个人资料维护
  - 头像上传更换
  - 密码修改功能

### 🛠️ 8. 代码生成器模块

#### 🏭 代码生成功能
- **数据库连接**
  - 支持任意MySQL数据库连接
  - 数据库连接测试功能

- **表结构解析**
  - 自动读取数据库表结构
  - 字段类型智能映射

#### 📝 模板代码生成
- **生成内容**
  - **后端代码**: Entity、Mapper、Service、Controller
  - **前端代码**: Vue页面、API接口

- **模板定制**
  - Velocity模板引擎
  - 自定义代码模板

### 🛠️ 9. 系统工具模块

#### 📜 服务器日志管理
- **日志操作**
  - 服务器日志预览
  - 日志文件下载
  - 日志清空功能

#### ⏰ 定时任务管理
- **任务配置**
  - CRON表达式配置
  - 任务启停控制
  - 任务执行日志

---

## 🎨 前端功能特性

### 💫 用户体验
- **响应式设计**: 适配各种屏幕尺寸
- **主题定制**: 支持浅色/深色主题切换
- **懒加载**: 路由和组件按需加载

### 核心页面
- **登录/注册**: 用户认证入口
- **首页**: 数据概览和快捷操作
- **用户管理**: 用户CRUD和角色分配
- **角色管理**: 角色权限分配
- **菜单管理**: 动态菜单配置
- **字典管理**: 数据字典维护
- **系统日志**: 操作日志查询
- **代码生成器**: 一键生成代码
- **定时任务**: 任务调度和监控

---

## 🔒 安全特性

### 🛡️ 安全防护
- **XSS 防护**: 输入内容转义处理
- **SQL 注入防护**: MyBatis 参数化查询
- **敏感信息加密**: 密码加密存储

### 📊 权限安全
- **接口权限**: 基于注解的方法级权限控制
- **前端权限**: 指令式权限控制
- **菜单权限**: 动态菜单权限分配

---

## 🔧 开发指南

### 权限控制
```java
@RestController
@RequestMapping("/api/users")
public class UserController {
    
    @PostMapping("/create")
    @PreAuthorize("system:user:add")
    public Result<Boolean> createUser(@RequestBody User user) {
        return Result.success(userService.save(user));
    }
}
```

### 全局异常处理
```java
@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(ServiceException.class)
    public Result<Void> handleServiceException(ServiceException e) {
        return Result.error(e.getCode(), e.getMessage());
    }
}
```

### 前端权限指令
```vue
<template>
  <el-button v-hasPermi="['system:user:edit']" type="primary">
    编辑用户
  </el-button>
</template>
```

---

## 📁 数据库设计

### 核心表结构
- **sys_user**: 用户表
- **sys_role**: 角色表  
- **sys_menu**: 菜单表
- **sys_user_role**: 用户角色关联表
- **sys_role_menu**: 角色菜单关联表
- **sys_log**: 操作日志表
- **sys_config**: 系统配置表
- **sys_job_config**: 定时任务配置表
- **sys_job_log**: 定时任务执行日志表

### RBAC权限模型
```
用户(User) ←→ 用户角色(UserRole) ←→ 角色(Role) ←→ 角色菜单(RoleMenu) ←→ 菜单(Menu)
```

---

## 🛣️ 功能对照表

| 模块分类 | 功能名称 | 实现状态 | 技术栈 |
|---------|---------|---------|--------|
| **认证安全** | JWT认证 | ✅ 已实现 | JWT + Redis |
| **认证安全** | 权限控制 | ✅ 已实现 | 自定义拦截器 |
| **认证安全** | 登录验证码 | ✅ 已实现 | 图形验证码 |
| **用户管理** | 用户CRUD | ✅ 已实现 | Spring Boot |
| **用户管理** | 角色分配 | ✅ 已实现 | 多对多关系 |
| **角色权限** | 角色管理 | ✅ 已实现 | RBAC模型 |
| **菜单管理** | 动态菜单 | ✅ 已实现 | Vue Router |
| **系统监控** | 在线用户 | ✅ 已实现 | Redis扫描 |
| **系统监控** | 操作日志 | ✅ 已实现 | MyBatis |
| **通知公告** | 消息推送 | ✅ 已实现 | 数据库通知 |
| **系统配置** | 参数配置 | ✅ 已实现 | 配置管理 |
| **代码生成** | 代码生成器 | ✅ 已实现 | Velocity |
| **工具模块** | 服务器日志 | ✅ 已实现 | 文件操作 |
| **工具模块** | 定时任务 | ✅ 已实现 | Quartz |
| **界面功能** | 响应式设计 | ✅ 已实现 | Element Plus |

---

## 📄 许可证

本项目采用 [MIT](LICENSE) 许可证。

## 🤝 贡献指南

欢迎贡献代码和提出建议！

1. **Fork 项目**
2. **创建功能分支**: `git checkout -b feature/amazing-feature`
3. **提交更改**: `git commit -m 'Add some amazing feature'`
4. **推送分支**: `git push origin feature/amazing-feature`
5. **创建 Pull Request**

---

<div align="center">

### 🌟 如果这个项目对你有帮助，请给一个 Star！

**Made with ❤️ by Open-Sys Team**

**📞 联系我们 | 🤝 参与贡献 | 📚 查看文档 | ⭐ 给个Star**

</div>