# tourism

**Repository Path**: l0x0hhh/tourism

## Basic Information

- **Project Name**: tourism
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-18
- **Last Updated**: 2025-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🏞️ 一站式旅游管理平台

## 📋 项目简介

一站式旅游管理平台是一个基于 **Vue 3 + Spring Boot + MySQL** 的现代化旅游服务管理系统。该平台为用户、商家和管理员提供完整的旅游服务解决方案，包括景点管理、酒店预订、订单管理、评论系统等功能。

### ✨ 主要功能

- **用户端**：景点浏览、酒店预订、订单管理、评论分享、个人中心
- **商家端**：景点/酒店发布管理、订单处理、评论回复、数据统计
- **管理员端**：用户管理、内容审核、公告管理、系统监控

## 🛠️ 技术栈

### 后端技术
- **Spring Boot 2.7.18** - 主框架
- **MySQL 8.0+** - 数据库
- **MyBatis** - ORM框架
- **JWT** - 身份认证
- **Maven** - 依赖管理

### 前端技术
- **Vue 3.5.13** - 前端框架
- **Element Plus 2.8.8** - UI组件库
- **Vue Router 4.5.1** - 路由管理
- **Axios** - HTTP客户端
- **Vite** - 构建工具

## 🚀 快速开始

### 环境要求

- **Java**: JDK 8+
- **Node.js**: 16.0+
- **MySQL**: 8.0+
- **Maven**: 3.6+

### 1. 克隆项目

```bash
git clone https://gitee.com/l0x0hhh/tourism.git
cd tourism
```

### 2. 数据库配置

#### 创建数据库
```sql
CREATE DATABASE tourism DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

#### 导入数据
```bash
mysql -u root -p tourism < tourism.sql
```

#### 数据库连接配置
修改 `springboot/src/main/resources/application.yml` 中的数据库连接信息：
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/tourism?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8&allowPublicKeyRetrieval=true
    username: root
    password: root
```

### 3. 启动后端服务

```bash
# 进入后端目录
cd springboot

# 编译项目
mvn clean compile

# 启动服务
mvn spring-boot:run
```

**后端服务地址**: http://localhost:8811

### 4. 启动前端服务

```bash
# 进入前端目录
cd vue

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

**前端访问地址**: http://localhost:5173

## 👥 测试账号

### 管理员账号
- **用户名**: `admin`
- **密码**: `123456`
- **权限**: 系统管理员权限
- **功能**: 用户管理、内容审核、公告管理、数据统计

### 普通用户账号
- **用户名**: `Alex`
- **密码**: `234567`
- **权限**: 普通用户权限
- **功能**: 景点浏览、酒店预订、评论分享

- **用户名**: `Tom`
- **密码**: `223456`
- **权限**: 普通用户权限

### 景点商家账号
- **用户名**: `aaa`
- **密码**: `123456`
- **权限**: 景点商家权限
- **功能**: 景点管理、订单处理、评论回复

### 酒店商家账号
- **用户名**: `bbb`
- **密码**: `123456`
- **权限**: 酒店商家权限
- **功能**: 酒店管理、预订处理、评论回复

## 🌐 系统访问地址

### 前端页面
- **主页**: http://localhost:5173
- **用户登录**: http://localhost:5173/#/login
- **商家注册**: http://localhost:5173/#/merchant-register

### 后端API
- **API根地址**: http://localhost:8811/api
- **文件上传**: http://localhost:8811/file
- **健康检查**: http://localhost:8811/api/health

## 📁 项目结构

```
tourism/
├── springboot/                 # 后端Spring Boot项目
│   ├── src/main/java/com/example/
│   │   ├── controller/         # 控制器层
│   │   ├── service/           # 服务层
│   │   ├── mapper/            # 数据访问层
│   │   ├── entity/            # 实体类
│   │   └── common/            # 公共组件
│   └── src/main/resources/
│       └── application.yml    # 配置文件
├── vue/                       # 前端Vue项目
│   ├── src/
│   │   ├── views/            # 页面组件
│   │   ├── components/       # 公共组件
│   │   ├── router/           # 路由配置
│   │   └── utils/            # 工具类
│   └── package.json          # 前端依赖
├── tourism.sql               # 数据库脚本
└── README.md                 # 项目说明
```

## 🔧 配置说明

### 文件上传配置
- **上传目录**: `./files/`
- **访问URL**: `http://localhost:8811/file/download/`
- **最大文件大小**: 10MB

### JWT配置
- **密钥**: tourism-management-system-secret-key-2024
- **过期时间**: 24小时

## 🚨 常见问题

### 1. 数据库连接失败
- 检查MySQL服务是否启动
- 确认数据库用户名密码是否正确
- 验证数据库tourism是否存在

### 2. 前端跨域问题
- 后端已配置CORS，允许前端访问
- 确保前端API请求地址为 http://localhost:8811

### 3. 文件上传失败
- 检查files目录是否存在并有写入权限
- 确认文件大小是否超过限制

### 4. JWT Token过期
- 重新登录获取新的Token
- 检查系统时间是否正确

## 📞 联系方式

如果在使用过程中遇到问题，请通过以下方式联系：

- **邮箱**: admin@tourism.com
- **系统版本**: v1.0.0

## 📝 更新日志

### v1.0.0 (2025-12-25)
- ✅ 完成用户端功能开发
- ✅ 完成商家端功能开发  
- ✅ 完成管理员端功能开发
- ✅ 完成公告系统
- ✅ 完成评论系统
- ✅ 完成订单管理系统

---

**享受您的旅游管理体验！** 🎉