# 选号管理系统

**Repository Path**: sun_zhengxun/number-system

## Basic Information

- **Project Name**: 选号管理系统
- **Description**: 选号管理系统
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-03
- **Last Updated**: 2026-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 开源框架

## README



# 选号管理系统 (Number System)

本项目是基于 `renren-framework` 二次开发的前后端分离快速开发平台。系统包含功能完善的后台管理模块、移动端 API 接口以及独特的**选号业务模块**。后端采用 Spring Boot + Shiro + Mybatis Plus，前端采用 Vue + Element UI。

## 主要特性

*   **完善的后台管理**：用户管理、角色管理、菜单管理、系统日志。
*   **移动端支持**：独立的 APP 登录、注册接口，基于 JWT 令牌认证。
*   **多数据源支持**：集成了动态数据源切换功能，支持主从数据库配置。
*   **定时任务**：基于 Quartz 的分布式定时任务管理。
*   **云存储集成**：支持阿里云 OSS、七牛云、腾讯云 COS 等云存储服务。
*   **核心业务模块**：包含随机选号、选号记录管理等核心业务逻辑。

## 技术栈

| 层级 | 技术选型 |
| :--- | :--- |
| **后端框架** | Spring Boot 2.x |
| **安全框架** | Apache Shiro + JWT |
| **ORM 框架** | Mybatis Plus |
| **数据库连接池** | Druid |
| **缓存中间件** | Redis |
| **任务调度** | Quartz |
| **前端框架** | Vue.js 2.x |
| **UI 组件库** | Element UI |
| **构建工具** | Webpack |

## 环境要求

*   **JDK**：1.8 或更高版本
*   **Maven**：3.0+
*   **Node.js**：8.0+
*   **Redis**：3.0+
*   **MySQL**：5.7+

## 快速开始

### 1. 数据库配置
在 MySQL 中创建数据库，并执行提供的 SQL 脚本（通常位于 `db/` 目录下）初始化表结构和数据。

### 2. 后端配置
修改 `number-system-boot/src/main/resources/application-dev.yml` 中的数据库连接信息（用户名、密码、URL）和 Redis 连接配置。

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_database
    username: your_username
    password: your_password
  redis:
    host: localhost
    port: 6379
```

### 3. 启动后端
进入 `number-system-boot` 目录，执行 Maven 命令启动：
```bash
mvn spring-boot:run
```
服务默认运行在 `http://localhost:8080`。

### 4. 前端配置与启动
进入 `number-system-ui` 目录，安装依赖：
```bash
npm install
```
启动开发服务器：
```bash
npm run dev
```
访问 `http://localhost:8000` 进入管理后台。

## 项目结构概览

### 后端 (`number-system-boot`)
*   `io.renren.modules.app`: 移动端接口（登录、注册、用户信息）。
*   `io.renren.modules.sys`: 后台核心管理模块（用户、角色、菜单）。
*   `io.renren.modules.randomNumber`: **选号业务核心模块**。
*   `io.renren.modules.job`: 定时任务管理。
*   `io.renren.modules.oss`: 第三方云存储服务封装。
*   `io.renren.common`: 全局通用工具类、异常处理、切面配置。

### 前端 (`number-system-ui`)
*   `src/views`: 页面视图组件。
*   `src/api`: API 接口封装。
*   `src/utils`: 工具函数。
*   `src/assets`: 静态资源文件。

## API 文档

项目集成了 Swagger UI，部署后可通过以下地址访问接口文档：
`http://localhost:8080/swagger.html`

## License

本项目遵循开源协议。