# music-ticket

**Repository Path**: kingnatural/music-ticket

## Basic Information

- **Project Name**: music-ticket
- **Description**: 音乐会售票系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-22
- **Last Updated**: 2026-05-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 音乐会票务系统 (Music Ticket System)

基于 Spring Boot 3 + Vue 3 构建的现代化音乐会票务预定平台。

## 项目简介

这是一个全栈音乐会票务管理系统，包含管理端和用户端两个前端应用，以及一个统一的后端服务。系统支持演出活动管理、座位选座、优惠券发放、订单处理等完整业务流程。

## 技术栈

### 后端
- **框架**: Spring Boot 3.2.0
- **ORM**: MyBatis-Plus 3.5.5
- **数据库**: PostgreSQL 14+
- **缓存**: Redis 7+
- **认证**: JWT (jjwt 0.12.3)
- **安全**: Spring Security Crypto (BCrypt)
- **XSS防护**: Jsoup 1.17.2

### 管理端 (frontend-admin)
- **框架**: Vue 3 + Vite
- **UI库**: Ant Design Vue
- **图表**: ECharts
- **状态管理**: Pinia

### 用户端 (frontend-user)
- **框架**: Vue 3 + Vite
- **UI库**: Vant UI
- **状态管理**: Pinia

## 项目结构

```
music-ticket/
├── backend/              # 后端服务 (Spring Boot)
│   ├── src/main/java/com/musicticket/
│   │   ├── controller/   # REST API控制器
│   │   ├── service/      # 业务逻辑层
│   │   ├── mapper/       # 数据访问层
│   │   ├── entity/       # 实体类
│   │   ├── dto/          # 数据传输对象
│   │   ├── config/       # 配置类
│   │   ├── interceptor/  # 拦截器
│   │   └── util/         # 工具类
│   ├── pom.xml
│   └── README.md
├── frontend-admin/       # 管理端前端 (Ant Design Vue)
│   ├── src/
│   ├── package.json
│   └── vite.config.js
└── frontend-user/        # 用户端前端 (Vant UI)
    ├── src/
    ├── package.json
    └── vite.config.js
```

## 核心功能

### 管理端
- 用户管理（登录/注册/权限控制）
- 演出活动管理（增删改查）
- 座位库存管理
- 优惠券管理（发布/校验/统计）
- 订单管理（分页查询/筛选）
- 数据看板（销售趋势可视化）

### 用户端
- 用户注册/登录
- 浏览演出活动
- 在线选座购票
- 优惠券领取与使用
- 订单查看与管理

## 快速开始

### 环境要求

- Java 17+
- Node.js 18+
- PostgreSQL 14+
- Redis 7+

### 后端启动

```bash
cd backend
mvn clean install
mvn spring-boot:run
```

详细配置请参考 [后端文档](backend/README.md)

### 管理端启动

```bash
cd frontend-admin
npm install
npm run dev
```

### 用户端启动

```bash
cd frontend-user
npm install
npm run dev
```

## 数据库初始化

1. 创建数据库：
```sql
CREATE DATABASE music_ticket;
```

2. 执行建表脚本（参考 [backend/README.md](backend/README.md)）

3. 插入初始数据（包含默认管理员账号）

## 安全特性

- JWT身份认证与授权
- BCrypt密码加密存储
- 输入参数校验 (@Valid)
- XSS攻击防护 (Jsoup白名单过滤)
- SQL注入防护 (MyBatis-Plus占位符)
- Redis原子锁防止超卖

## API文档

后端API文档详见 [backend/README.md](backend/README.md#api接口文档)

## 开发规范

- 后端遵循RESTful API设计规范
- 前端采用组件化开发模式
- 所有敏感信息（密码等）必须加密存储
- 禁止字符串拼接SQL，防止SQL注入

## 许可证

MIT License

## 联系方式

如有问题或建议，请提交Issue。